FS_UUID(1)

💖 FS_UUID(1) 💖

okay bestie, welcome to fs_uuid — that's a page straight out of the AFS Command Reference, section 1, and it's genuinely one of the shortest little baddies in the whole manual. we love a low-commitment icon. 💅

---

✨ NAME ✨

fs_uuid — prints the uuid of the client or generates a new one 🦋

---

✨ SYNOPSIS ✨

fs uuid [-generate] [-help]

---

✨ DESCRIPTION ✨

so fs uuid prints the current UUID of an OpenAFS client. that's it. that's the job. 💖

if you need it to, it can also force the generation of a new UUID. when would you need that? when the moment calls for it, babes. ✨

and why do we even care about the client UUID? because the fileserver uses it to differentiate clients with the same IP address. no cap, that's the whole reason it exists — two machines behind one IP and the fileserver needs to tell them apart. the UUID is the vibe check. 🔥

---

✨ CAUTIONS ✨

⚠️ okay pay attention, this one actually matters. fs uuid is only available in OpenAFS versions after 1.4.5 and 1.5.8, and the behavior differs slightly between versions. 👑

here's the breakdown, fr fr:

• in OpenAFS 1.4.5 and later, the -generate option is required and the UUID for the client machine is never printed. soz.
• OpenAFS versions 1.5.8 and later will print the UUID. slay. 🎀

---

✨ OPTIONS ✨

• -generate — generates a new UUID for the cache manager. super useful if two clients are out here sharing the same UUID (like, say, if systems were cloned incorrectly 🙈 — we've all been there). heads up tho: -generate is optional in OpenAFS versions 1.5.8 and later, but it is required in OpenAFS versions 1.4.5 and later.
• -help — prints the online help for this command. and the way that all other valid options are ignored when you do this? iconic. 💅

---

✨ OUTPUT ✨

fs uuid prints out the current UUID for the client 💖 — or the new UUID if the -generate option is passed to it. that's the tea. 🌸

---

✨ EXAMPLES ✨

there are literally only two ways to invoke fs uuid under 1.5.8 and later, bestie:

% fs uuid
UUID: 8ac66f9308a8e-47d7-80f7-50d0040cddc2

% fs uuid -generate
New UUID: 436bd660-1720-429508e470cff38f5c6fb0

and here is the only way to invoke fs uuid under OpenAFS 1.4.5 and later — just the one, no choices, main character energy only:

% fs uuid -generate
New uuid generated.

see how the second one doesn't even give you a UUID? yeah. that's the 1.4.5 life. 😭

---

✨ PRIVILEGE REQUIRED ✨

the issuer must be logged on as the local superuser "root". sorry babe, no regular-user shortcuts here. you gotta be root for this one. 👑

---

✨ SEE ALSO ✨

• fs(1)

---

✨ COPYRIGHT ✨

Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com> 🫶

This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Jason Edgecombe for OpenAFS.

---

and that's the whole page, bestie!! 🌈 this little cutie shipped as part of OpenAFS, dated 2026-07-27, and it lives at FS_UUID(1) in section 1 of the AFS Command Reference. go forth and UUID responsibly. 💜✨🦋