| 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 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
| `/build/plan9port/pkg/plan9port/usr/local/plan9port/src/cmd/9p.c`
SEE ALSO
| intro(4), intro(9p), 9pclient(3)