3 058b0118 2005-01-03 devnull 9p \- read and write files on a 9P server
4 058b0118 2005-01-03 devnull .SH SYNOPSIS
7 011090f0 2005-03-21 devnull .I options
14 011090f0 2005-03-21 devnull .I options
16 058b0118 2005-01-03 devnull .B readfd
21 011090f0 2005-03-21 devnull .I options
31 011090f0 2005-03-21 devnull .I options
33 058b0118 2005-01-03 devnull .B writefd
38 011090f0 2005-03-21 devnull .I options
45 011090f0 2005-03-21 devnull .I options
52 011090f0 2005-03-21 devnull .I options
58 011090f0 2005-03-21 devnull .I path...
59 058b0118 2005-01-03 devnull .SH DESCRIPTION
61 058b0118 2005-01-03 devnull is a trivial 9P client that can access a single file on a 9P server.
62 058b0118 2005-01-03 devnull It can be useful for manual interaction with a 9P server or for
63 058b0118 2005-01-03 devnull accessing simple 9P services from within shell scripts.
64 011090f0 2005-03-21 devnull The common options are:
66 011090f0 2005-03-21 devnull .B -a\fI addr
68 011090f0 2005-03-21 devnull the server at
71 011090f0 2005-03-21 devnull .B -A\fI aname
72 011090f0 2005-03-21 devnull attach to the file system named
75 058b0118 2005-01-03 devnull The first argument is a command, one of:
78 058b0118 2005-01-03 devnull print the contents of
80 058b0118 2005-01-03 devnull to standard output
83 058b0118 2005-01-03 devnull write data on standard input to
84 d93fca6a 2005-02-11 devnull .IR path ;
87 d93fca6a 2005-02-11 devnull option causes
89 d93fca6a 2005-02-11 devnull to write one line at a time
91 058b0118 2005-01-03 devnull .BR readfd ", " writefd
97 058b0118 2005-01-03 devnull .IR openfd (9p)
98 058b0118 2005-01-03 devnull instead of
99 058b0118 2005-01-03 devnull .IR open ;
100 058b0118 2005-01-03 devnull this masks errors and is mainly useful for debugging
101 058b0118 2005-01-03 devnull the implementation of
102 058b0118 2005-01-03 devnull .I openfd
106 058b0118 2005-01-03 devnull .I stat (9p)
109 058b0118 2005-01-03 devnull and print the result
114 30f6ae14 2005-02-13 devnull for reading and writing.
115 30f6ae14 2005-02-13 devnull Then repeat until end-of-file on standard input:
116 30f6ae14 2005-02-13 devnull copy a line from the file to standard output,
117 30f6ae14 2005-02-13 devnull copy a line from standard input to the file.
118 30f6ae14 2005-02-13 devnull Print errors, but don't give up.
120 30f6ae14 2005-02-13 devnull is useful for interacting with servers like
121 30f6ae14 2005-02-13 devnull .IR factotum (4).
124 011090f0 2005-03-21 devnull Print a directory listing in the format of
125 011090f0 2005-03-21 devnull .IR ls (1).
130 011090f0 2005-03-21 devnull flags have the same meaning as in
131 011090f0 2005-03-21 devnull .IR ls .
136 058b0118 2005-01-03 devnull .I address
137 058b0118 2005-01-03 devnull to connect to the 9P server.
140 058b0118 2005-01-03 devnull option is not given,
142 058b0118 2005-01-03 devnull requires the
144 058b0118 2005-01-03 devnull to be of the form
145 058b0118 2005-01-03 devnull .IB service / subpath \fR;
146 058b0118 2005-01-03 devnull it connects to the Unix domain socket
147 058b0118 2005-01-03 devnull .I service
148 058b0118 2005-01-03 devnull in the name space directory
150 058b0118 2005-01-03 devnull .IR intro (4))
151 058b0118 2005-01-03 devnull and then accesses
152 058b0118 2005-01-03 devnull .IR subpath .
153 058b0118 2005-01-03 devnull .SH EXAMPLE
154 058b0118 2005-01-03 devnull To update
155 058b0118 2005-01-03 devnull .IR plumber (4)'s
156 058b0118 2005-01-03 devnull copy of your plumbing rules after editing
157 058b0118 2005-01-03 devnull .BR $HOME/lib/plumbing :
160 058b0118 2005-01-03 devnull cat $HOME/lib/plumbing | 9p write plumb/rules
163 058b0118 2005-01-03 devnull To display the contents of the current
164 058b0118 2005-01-03 devnull .IR acme (4)
168 058b0118 2005-01-03 devnull 9p read acme/$winid/body
170 058b0118 2005-01-03 devnull .SH SOURCE
171 c3674de4 2005-01-11 devnull .B \*9/src/cmd/9p.c
172 058b0118 2005-01-03 devnull .SH SEE ALSO
173 058b0118 2005-01-03 devnull .IR intro (4),
174 058b0118 2005-01-03 devnull .IR intro (9p),
175 058b0118 2005-01-03 devnull .IR 9pclient (3)