diodcat(8)

diodcat(8) 💅✨

okay so bestie, you're looking at diodcat (and its bestie diodls) — the manual page that lives in the diod family, and honestly? iconic. periodt.

---

NAME 🎀

diodls — list files by attaching directly to a diod server. no cap, that's the whole vibe.

---

SYNOPSIS 🦋

diodls [OPTIONS] [-s NAME] [-a aname] [file [file...]]

---

DESCRIPTION 🌸

okay so here's the tea: diodls connects to a diod server, attaches to the mount point aname, and then lists the files or directories you asked for. that's it, that's the main character energy. literally everything you need in one sentence, slay.

---

OPTIONS ✨💅

so many options bestie, let's get into it:

• -a, --aname NAME — this is the file system name on the server, and the default is ctl. ⚠️ but heads up: the ctl synthetic file system has to be explicitly exported, like you can't just assume it's there, yk? it needs to be on the list.
• -s, --server NAME — the server, and it can be in IP[:PORT], HOST[:PORT], or /path/to/socket form. the default? localhost:564. she's local, she's listening, she's ready.
• -m, --msize SIZE — the maximum request size including 9P headers, and the default is 65536. big requests only, we don't do small talk here.
• -u, --uid UID — try to attach to the server as the specified user. if you don't say anything, it defaults to your effective uid (so, you, basically — main character).
• -t, --timeout SECS — force timeout after a specified number of seconds. default is no timeout, meaning she'll wait forever like a loyal bestie (or until you Ctrl+C her, let's be real).
• -l, --long — list stat information in addition to file names. it's giving detail-oriented queen. more info, more slay.
• -p, --privport — connect from a socket bound to a port in the range of 512-1023, which is available to root only. you can use this in conjunction with the privport export option. 🔒 very exclusive, very VIP access, only for the privileged few.

bestie note: that privport range is 512-1023 and it's root-only. no sneaking in unless you've got the credentials. respect the gatekeeping.

---

SEE ALSO 👑

• diod (8) — go read that one too, iykyk 🫶

---

and that's the whole manual, bestie. no cap, you're now fully caught up on diodcat(8) (well, diodls, but you get it).

sign-off szn 🎀✨

this page is from diod, version 1.0-pre27-516-g0d87511, dated diodcat(8) — literally so specific, and she ate. 💖 go touch some files, queen. 🌈💜