diodcli(8)

🦋 diodcli(8) — perform file operations by attaching directly to a diod server

okay bestie, this is the diodcli(8) page from the diod manual, and it's highkey giving “attach straight to the server and do file ops” energy. no cap. ✨

---

🌸 NAME 🌸

diodcli — perform file operations by attaching directly to a diod server. that's the whole name, and yes it ate.

✨ SYNOPSIS ✨

diodcli [OPTIONS] read PATH
diodcli [OPTIONS] write PATH
diodcli [OPTIONS] mkdir PATH
diodcli [OPTIONS] stat PATH
diodcli [OPTIONS] ls [--long] [PATH ...]
diodcli [OPTIONS] null
diodcli [OPTIONS] getxattr PATH NAME
diodcli [OPTIONS] setxattr [--create|--replace] PATH NAME VALUE
diodcli [OPTIONS] delxattr PATH NAME
diodcli [OPTIONS] showmount [--long]
diodcli [OPTIONS] date [--set-time]

💖 DESCRIPTION 💖

bestie, diodcli connects to a diod server, attaches to the mount point called aname, and performs a file operation. it's literally that simple — the rest is just picking your subcommand and flags. 🫶

🎀 OPTIONS 🎀

these are the options that apply to all subcommands, periodt:

• -a, --aname NAME — the file system name on the server (default "ctl"). lowkey note: the "ctl" synthetic file system must be explicitly exported. 👑
• -s, --server NAME — the server in IP[:PORT], HOST[:PORT], or /path/to/socket form (default localhost:564).
• -m, --msize SIZE — the maximum request size including 9P headers (default 65536).
• -u, --uid UID — try to attach to the server as the specified user (default your effective uid).
• -p, --privport — connect from a socket bound to a port in the range of 512-1023, available to root only. this can be used in conjunction with the privport export option. 🔥
• -t, --trace — show 9P protocol on stderr.

🧚 SUBCOMMANDS 🧚

okay, now the main-character moves. pick one: 💅

• read — read a file and write to stdout.
• write — read stdin to EOF and write to a file.
• mkdir — create a directory.
• stat — display file status. the compatible stat(1) format string is:

mode=%f owner=%u:%g size=%s blocks=%b blocksize=%o links=%h \
device=%t:%T mtime=%Y ctime=%Z atime=%X

• ls — list directory contents.
• null — once attached, do nothing. literally no thoughts, head empty. 🙈
• getxattr — get the value of an extended attribute.
• setxattr — set the value of an extended attribute.
• delxattr — remove an extended attribute.
• showmount — list the server's connected clients. by default, the client list is compressed into one line in hostlist form, with domain suffixes removed. with --long, the clients are listed one per line, without compression or abbreviation. 🌈
• date — show the server system time. if --set-time is specified, the local system time is updated to match the server's. this may be useful in a pre-boot environment prior to authenticating with MUNGE, to avoid running afoul of its replay attack prevention. ⭐

🦋 SEE ALSO 🦋

• diod (8) — go read the big one too, bestie. 💜

---

💖 cute sign-off: this iconic page is from diod version 1.1.0; the footer doesn't list a date, so we're not making one up — mwah 💋✨