KAFS-CHECK-CONFIG(1)

💅 KAFS-CHECK-CONFIG(1) — AFS Config Checker

okay bestie, so this is kafs-check-config from the AFS Config Checker corner of the manual universe, and it is exactly what it sounds like: the little tool that checks your AFS config before anything goes feral. let's get into it 💖

---

✨ NAME ✨

kafs-check-config — the AFS configuration check tool, your lil config bodyguard 🫶

---

🌸 SYNOPSIS 🌸

kafs-check-config [OPTION]... [<cellname>]*

Where options are:

       [-46PDvv] [-c <conffile>]* [-N <restriction>]

so yeah, you run it, you throw some options at it, you optionally throw some <cellname>s at it, and it does its thing. iconic behaviour fr fr.

---

🦋 DESCRIPTION 🦋

okay so what does this program actually do. this tool checks the configuration for the in-kernel AFS filesystem, aka kAFS. and why do we care, you ask? because this is the config that gets used when systemd mounts the filesystem — it's what loads up the cell database and creates the cell automounts inside the /afs directory. so like, if this config is messy, everything downstream is messy. no cap. 😭

the config is also used by the kernel name resolver upcall, which uses it to hand out static configuration for some cells and to specify overrides and limits on DNS lookups. multitasking queen honestly 👑

and here's a cute bonus: if you pass a list of <cellname> arguments, the listed cells get dumped — and that dump includes the sources of the Volume Location records and the address records. receipts included, periodt 💅

the available options are:

---

🎀 ARGUMENTS 🎀

• -4 — only show IPv4 addresses in the dump. v4 girlies only 💜
• -6 — only show IPv6 addresses in the dump. v6 supremacy, we love to see it ✨
• -P — dump the parse tree of the configuration file(s). like, the whole family tree of your config, exposed 🌳
• -D — dump the cell database extracted from the configuration. the cell database, in the flesh 💀
• -v — increase the verbosity of the output. and yes bestie, you may specify this multiple times — stack them like bracelets 🎀
• -c <conffile> — specify a configuration file to read instead of the system default. this one may be specified multiple times too, and the configuration files are read and applied in order — so order matters, don't play with it 🙈
• -N <restriction> — apply a restriction to the lookup performed for the listed cells (if any are — yes, only if there are any, we're being precise here 🌸). the restrictions include:
  • -N vl-srv — don't use SRV records to find Volume Location servers.
  • -N vl-afsdb — don't use AFSDB records to find Volume Location servers.
  • -N vl-all — don't use SRV or AFSDB records to find Volume Location servers. both, gone, blocked 🚫
  • -N vl-host — don't look the cell name up as a hostname to find a Volume Location server.
  • -N vl-dns — don't do any lookups to find Volume Location servers. use only the static configuration. offline mode, main character energy ✨

---

⭐ EXIT STATUS ⭐

• 0 — if check okay and any dumping succeeded. we love a clean run 🥳
• 1 — if an error occurs during processing. something went sideways bestie 😭
• 2 — if a command line error occurs. you typed something funky, it's giving typo 💀

---

🌈 SEE ALSO 🌈

kafs(7), kafs-client.conf(5)

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

---

lowkey reminder: the restrictions above are all about not doing things — no SRV, no AFSDB, no hostname lookup, no DNS at all. so if your lookups are acting weird, one of these is probably your girl. 💅

---

and that's the whole page, bestie — this one shipped as part of Linux and the page itself is dated 16 Apr 2019. yes, it's an older icon, but it ate and it's still serving 🫶✨ bye mwah 💖