AFP_VOLUUID.CONF(5)

📦
version 4.5.1 · 11 versions
, in ubuntu stonking

💖 afp_voluuid.conf — the Netatalk AFP Fileserver Manual page, bestie edition 💖

okay so this is afp_voluuid.conf(5), and it's genuinely such a specific little file, but it's carrying a LOT of weight, so let's get into it 🎀

✨ NAME ✨

afp_voluuid.conf — the configuration file that afpd uses to specify the UUID for AFP volumes 🦋

🌸 DESCRIPTION 🌸

afp_voluuid.conf is the configuration file used by afpd to store the UUID of all the AFP volumes. no cap. every single one. 💅

The configuration lines are put together like this:

"volume-name" "uuid-string"
  • First field = the volume name. Volume names must be quoted if they contain spaces, iykyk.
  • Second field = the 36 character hexadecimal ASCII string representation of a UUID. exactly 36 characters, bestie, don't try to freestyle it.

Now for the parsing rules, because this file is lowkey picky:

  • All leading spaces and tabs are ignored 🙈
  • Blank lines are ignored
  • Lines prefixed with # are ignored
  • Any illegal lines are ignored

This UUID is advertised by Zeroconf so that Time Machine volumes get robust disambiguation — iconic behaviour honestly ✨

It's also used by the MySQL and SQLite CNID backends as the name of the database table that stores the CNID information for the volume. so yeah, she's multi-talented 💜

⚠️ NOTE: This file should not be thoughtlessly edited or copied onto another server. like, put the scissors down, we're not doing that 🚨

If you want to set a particular UUID for your volume, use the option volume uuid = in afp.conf. In this case, afp_voluuid.conf is not used. periodt. 💅

🎀 EXAMPLES 🎀

⭐ Example: afp_voluuid.conf with three volumes ⭐

# This is a comment.
"Backup for John Smith" 1573974F-0ABD-69CC-C40A-8519B681A0E1
"bob" 39A487F4-55AA-8240-E584-69AA01800FE9
mary 6331E2D1-446C-B68C-3066-D685AADBE911

look at that formatting, chefs kiss 👑 note the quotes on "Backup for John Smith" because spaces, and mary just vibing unquoted because she's a single word and doesn't need the protection 🫶

💜 SEE ALSO 💜

go read those too, they're part of the lore 📚

🌈 AUTHOR 🌈

Contributors to the Netatalk Project (https://netatalk.io/contributors) — shoutout to the whole squad, they ate and left no crumbs 💖✨

and that's the whole page, bestie!! this was Netatalk 4.5.1, the AFP_VOLUUID.CONF(5) manual page, and you're officially smarter than you were five minutes ago. go set some UUIDs responsibly, mwah 🎀💅🦋

📦 where this page comes from