---
name: "wmiir"
section: "1"
platform: "linux"
package: "wmii"
version: "3.10~20120413+hg2813-11"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/wmiir"
---

# wmiir(1)

The wmii 9P filesystem client

## NAME

wmiir - The wmii 9P filesystem client

## 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 which ships with **wmii**, and connects to its virtual filesystem by default. **wmiir** is most often used to query and issue commands to **wmii**, both from the command line and from its **sh**-based configuration scripts.

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. When working with non-text data in a non-UTF-8 locale, the *-b* flag should be specified to disable this behavior.

## 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.

:

## COMMANDS

The following commands deal with 9P filesystems.

- 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.

- ls \[*-dlp*\] *\<path\>*

  Lists the contents of *\<path\>*.

  Flags:

  - \-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.

      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.

    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)](/setsid/2.md)). 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.

    - 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)](/wmii/1.md), libixp\[*2*\]

\[*1*\] http://www.suckless.org/wiki/wmii/tips/9p\_tips

\[*2*\] http://libs.suckless.org/libixp