3 058b0118 2005-01-03 devnull 9p \- read and write files on a 9P server
4 058b0118 2005-01-03 devnull .SH SYNOPSIS
18 058b0118 2005-01-03 devnull .B readfd
37 058b0118 2005-01-03 devnull .B writefd
51 058b0118 2005-01-03 devnull .SH DESCRIPTION
53 058b0118 2005-01-03 devnull is a trivial 9P client that can access a single file on a 9P server.
54 058b0118 2005-01-03 devnull It can be useful for manual interaction with a 9P server or for
55 058b0118 2005-01-03 devnull accessing simple 9P services from within shell scripts.
57 058b0118 2005-01-03 devnull The first argument is a command, one of:
60 058b0118 2005-01-03 devnull print the contents of
62 058b0118 2005-01-03 devnull to standard output
65 058b0118 2005-01-03 devnull write data on standard input to
66 d93fca6a 2005-02-11 devnull .IR path ;
69 d93fca6a 2005-02-11 devnull option causes
71 d93fca6a 2005-02-11 devnull to write one line at a time
73 058b0118 2005-01-03 devnull .BR readfd ", " writefd
79 058b0118 2005-01-03 devnull .IR openfd (9p)
80 058b0118 2005-01-03 devnull instead of
81 058b0118 2005-01-03 devnull .IR open ;
82 058b0118 2005-01-03 devnull this masks errors and is mainly useful for debugging
83 058b0118 2005-01-03 devnull the implementation of
84 058b0118 2005-01-03 devnull .I openfd
88 058b0118 2005-01-03 devnull .I stat (9p)
91 058b0118 2005-01-03 devnull and print the result
96 30f6ae14 2005-02-13 devnull for reading and writing.
97 30f6ae14 2005-02-13 devnull Then repeat until end-of-file on standard input:
98 30f6ae14 2005-02-13 devnull copy a line from the file to standard output,
99 30f6ae14 2005-02-13 devnull copy a line from standard input to the file.
100 30f6ae14 2005-02-13 devnull Print errors, but don't give up.
102 30f6ae14 2005-02-13 devnull is useful for interacting with servers like
103 30f6ae14 2005-02-13 devnull .IR factotum (4).
108 058b0118 2005-01-03 devnull .I address
109 058b0118 2005-01-03 devnull to connect to the 9P server.
112 058b0118 2005-01-03 devnull option is not given,
114 058b0118 2005-01-03 devnull requires the
116 058b0118 2005-01-03 devnull to be of the form
117 058b0118 2005-01-03 devnull .IB service / subpath \fR;
118 058b0118 2005-01-03 devnull it connects to the Unix domain socket
119 058b0118 2005-01-03 devnull .I service
120 058b0118 2005-01-03 devnull in the name space directory
122 058b0118 2005-01-03 devnull .IR intro (4))
123 058b0118 2005-01-03 devnull and then accesses
124 058b0118 2005-01-03 devnull .IR subpath .
125 058b0118 2005-01-03 devnull .SH EXAMPLE
126 058b0118 2005-01-03 devnull To update
127 058b0118 2005-01-03 devnull .IR plumber (4)'s
128 058b0118 2005-01-03 devnull copy of your plumbing rules after editing
129 058b0118 2005-01-03 devnull .BR $HOME/lib/plumbing :
132 058b0118 2005-01-03 devnull cat $HOME/lib/plumbing | 9p write plumb/rules
135 058b0118 2005-01-03 devnull To display the contents of the current
136 058b0118 2005-01-03 devnull .IR acme (4)
140 058b0118 2005-01-03 devnull 9p read acme/$winid/body
142 058b0118 2005-01-03 devnull .SH SOURCE
143 c3674de4 2005-01-11 devnull .B \*9/src/cmd/9p.c
144 058b0118 2005-01-03 devnull .SH SEE ALSO
145 058b0118 2005-01-03 devnull .IR intro (4),
146 058b0118 2005-01-03 devnull .IR intro (9p),
147 058b0118 2005-01-03 devnull .IR 9pclient (3)