9P(1)                                                       9P(1)

     NAME
          9p - read and write files on a 9P server

     SYNOPSIS
          9p [ options ] read path
          9p [ options ] readfd path

          9p [ options ] write [ -l ] path
          9p [ options ] writefd path

          9p [ options ] stat path

          9p [ options ] rdwr path

          9p [ options ] ls [ -dl ] path...

     DESCRIPTION
          9p is a trivial 9P client that can access a single file on a
          9P server.  It can be useful for manual interaction with a
          9P server or for accessing simple 9P services from within
          shell scripts.  The common options are:

          -a addr
               dial the server at addr

          -A aname
               attach to the file system named aname

          -n   mount without authentication

          The first argument is a command, one of:

          read print the contents of path to standard output

          write
               write data on standard input to path; the -l option
               causes write to write one line at a time

          readfd, writefd
               like read and write but use openfd(9p) instead of open;
               this masks errors and is mainly useful for debugging
               the implementation of openfd

          stat execute stat (9p) on path and print the result

          rdwr Open path for reading and writing.  Then repeat until
               end-of-file on standard input: copy a line from the
               file to standard output, copy a line from standard
               input to the file.  Print errors, but don't give up.
               Rdwr is useful for interacting with servers like

     9P(1)                                                       9P(1)

               factotum(4).

          ls   Print a directory listing in the format of ls(1). The
               -d and -l flags have the same meaning as in ls.

          9p dials address to connect to the 9P server.  If the -a
          option is not given, 9p requires the path to be of the form
          service/subpath; it connects to the Unix domain socket
          service in the name space directory (see intro(4)) and then
          accesses subpath.

     EXAMPLE
          To update plumber(4)'s copy of your plumbing rules after
          editing $HOME/lib/plumbing:

               cat $HOME/lib/plumbing | 9p write plumb/rules

          To display the contents of the current acme(4) window:

               9p read acme/$winid/body

     SOURCE
          /src/cmd/9p.c

     SEE ALSO
          intro(4), intro(9p), 9pclient(3)