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)). 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), libixp[2]

       [1] http://www.suckless.org/wiki/wmii/tips/9p_tips

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