KAMID(8)

📦 version 0.2, in nixos 26.05, nixpkgs unstable

💅 KAMID(8) — the 9p file server daemon, but make it a vibe

okay so bestie, buckle up, we're doing the System Manager's Manual thing but fun. this page is kamid, from the System Manager's Manual, and honestly? she's iconic. 🎀

✨ NAME ✨

kamid — a 9p file server daemon. yes, the 9p file server daemon. main character energy fr fr. 👑

🌸 SYNOPSIS 🌸

kamid [-dnv] [-D macro=value] [-f file] [-s socket]

that's the whole summoning ritual, no cap. look at her go. 🦋

💖 DESCRIPTION 💖

kamid is a 9p file server daemon. that's the whole bit, that's the thesis statement, and she ate.

The options are as follows — and yes, we're going through all of them, because every single one matters:

  • -D macro=value — sets a macro to a value. these macros can be referenced in the configuration files, so it's giving "define it once, use it everywhere" 💅
  • -d — do not daemonize. if you pass this one, kamid runs in the foreground and logs to stderr. very much the "i want to watch everything happen live" option. 🍓
  • -f file — specify an alternative configuration file. going somewhere other than the default, i see you. 👀
  • -n — configtest mode: only checks the configuration file for validity. it's a vibe check for your config, literally nothing else happens. ✅
  • -s socket — use an alternate location for the default control socket. relocating, slay. 🚚
  • -v — produce more verbose output. more words, more info, more everything. 🔥

🎀 FILES 🎀

  • /etc/kamid.conf — the default kamid configuration file. home base. 🏠
  • /var/run/kamid.sock — the UNIX-domain socket used for communication with kamictl(8). this is how the two of them talk, iykyk. 💬

🦋 SEE ALSO 🦋

kami.conf(5), kamictl(8)

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

👑 AUTHORS 👑

The kamid program was written by Omar Polo <op@omarpolo.com>. absolute legend behavior, we stan. 🫶

💀 CAVEATS 💀

okay listen, we have to be real for a sec:

  • kamid doesn't handle very well when a user directory is over multiple devices, since it uses the inode of files to build the QID path field. so like… multiple devices = rough, noted. 😭
  • Opening or creating a file with the OEXEC flag set results in an error. periodt. that's just how it is, don't come for her. 🙈

and that's the whole page, no skips, no summaries, every flag accounted for ✨

ngl this one's from Debian, dated January 31, 2022 — so like, vintage but make it fresh. bye bestie, go mount something 💜
📦 where this page comes from