wmiir(1)

💅 wmiir(1) — the wmii 9P filesystem client, bestie edition ✨

okay so picture this: wmiir is literally the little client that talks to wmii's virtual filesystem, and it's about to be your new best friend. this is the wmiir(1) page from the General Commands Manual, and yes we're getting into all of it, no skipping 🫶

---

🌸 NAME 🌸

wmiir — the wmii 9P filesystem client. that's her. that's the whole vibe.

---

✨ SYNOPSIS ✨

wmiir [-a <address>] [-b] {create | ls [-dlp] | read | remove | write}
<file>

wmiir [-a <address>] [-b] xwrite <file> <data> ...

wmiir -v

---

🦋 DESCRIPTION 🦋

wmiir is a simple 9P filesystem client that ships with wmii, and by default it connects straight to wmii's virtual filesystem — like, that's its home base 💖. you'll see it used most often to query wmii and to issue commands to it, both from the command line and from its sh-based configuration scripts. it's giving "quietly running everything behind the scenes" energy, honestly iconic 👑

here's the important bit though: since the default encoding of 9P filesystems is UTF-8, wmiir assumes that all data read and written is text data, and translates to or from your locale character encoding as necessary. so if you're working with non-text data in a non-UTF-8 locale, you should specify the -b flag to disable this behavior. no cap, that one matters 🙈

---

🎀 ARGUMENTS 🎀

• -a — the address at which to connect to wmii.
• -b — with the -b flag, data that you intend to read or write is treated as binary data. (that's your "i am not doing text today" flag 🫶)

---

💅 COMMANDS 💅

the following commands deal with 9P filesystems. periodt.

• create <file> — creates a new file or directory in the filesystem. permissions and file type are inferred by wmii. the contents of the standard input are written to the new file. stdin goes in, file comes out, slay ✨
• ls [-dlp] <path> — lists the contents of <path>.

flags, bestie:

• -d — don't list the contents of directories.
• -l — long output. for each file, list its permissions, owner, group, size (bytes), mtime, and name.
• -p — print the full path to each file.

• read <file> — reads the entire contents of a file from the filesystem. blocks until interrupted or EOF is received — so yeah, it will just sit there vibing until you say stop 😭

synonyms: cat

• remove <path> — removes <path> from the filesystem.

synonyms: rm

• write <file> — writes the contents of the standard input to <file>.
• xwrite <file> <data> ... — writes each argument after <file> to the latter. multi-arg energy, we love to see it 💜

additionally, wmiir provides the following utility commands relevant to scripting wmii:

• namespace — prints the current wmii namespace directory, usually equivalent to /tmp/ns.$USER.${DISPLAY%.0}, but possibly different depending on the value of $NAMESPACE and $WMII_NAMESPACE.

synonyms: ns

• setsid [-0 <argv0>] [-f] <command> — executes the given command after setting the session id (see setsid(2)). if -0 is given, the command is run with the given value as argv[0]. for instance, to run sh as a login shell, one might run:

wmiir setsid -0 -sh sh

if -f is given, wmiir will fork into the background before executing the command. background queen behavior 🌈

• proglist [--] <directory> ... — lists all executable commands in the given directories.

---

🌼 ENVIRONMENT 🌼

• $WMII_ADDRESS — the address at which to connect to wmii.
• $NAMESPACE — the namespace directory to use if no address is provided.

---

⭐ SEE ALSO ⭐

• wmii(1), libixp[2]
• [1] http://www.suckless.org/wiki/wmii/tips/9p_tips
• [2] http://libs.suckless.org/libixp

---

ngl, the manpage doesn't spell out an exit status section, so don't come for me — everything above is everything there is 💖

---

and that's the whole page, bestie 🎀 this one comes from wmii-, dated Oct, 2009, and it's wmiir(1) — go forth and talk to your filesystem, you absolute main character 👑💅