1 058b0118 2005-01-03 devnull .TH 9P 1
  2 058b0118 2005-01-03 devnull .SH NAME
  3 058b0118 2005-01-03 devnull 9p \- read and write files on a 9P server
  4 058b0118 2005-01-03 devnull .SH SYNOPSIS
  5 058b0118 2005-01-03 devnull .B 9p
  6 058b0118 2005-01-03 devnull [
  7 011090f0 2005-03-21 devnull .I options
  8 058b0118 2005-01-03 devnull ]
  9 058b0118 2005-01-03 devnull .B read
 10 058b0118 2005-01-03 devnull .I path
 11 058b0118 2005-01-03 devnull .br
 12 058b0118 2005-01-03 devnull .B 9p
 13 058b0118 2005-01-03 devnull [
 14 011090f0 2005-03-21 devnull .I options
 15 058b0118 2005-01-03 devnull ]
 16 058b0118 2005-01-03 devnull .B readfd
 17 058b0118 2005-01-03 devnull .I path
 18 058b0118 2005-01-03 devnull .PP
 19 058b0118 2005-01-03 devnull .B 9p
 20 058b0118 2005-01-03 devnull [
 21 011090f0 2005-03-21 devnull .I options
 22 058b0118 2005-01-03 devnull ]
 23 058b0118 2005-01-03 devnull .B write
 24 d93fca6a 2005-02-11 devnull [
 25 d93fca6a 2005-02-11 devnull .B -l
 26 d93fca6a 2005-02-11 devnull ]
 27 058b0118 2005-01-03 devnull .I path
 28 058b0118 2005-01-03 devnull .br
 29 058b0118 2005-01-03 devnull .B 9p
 30 058b0118 2005-01-03 devnull [
 31 011090f0 2005-03-21 devnull .I options
 32 058b0118 2005-01-03 devnull ]
 33 058b0118 2005-01-03 devnull .B writefd
 34 058b0118 2005-01-03 devnull .I path
 35 058b0118 2005-01-03 devnull .PP
 36 058b0118 2005-01-03 devnull .B 9p
 37 058b0118 2005-01-03 devnull [
 38 011090f0 2005-03-21 devnull .I options
 39 058b0118 2005-01-03 devnull ]
 40 058b0118 2005-01-03 devnull .B stat
 41 058b0118 2005-01-03 devnull .I path
 42 30f6ae14 2005-02-13 devnull .PP
 43 30f6ae14 2005-02-13 devnull .B 9p
 44 011090f0 2005-03-21 devnull [
 45 011090f0 2005-03-21 devnull .I options
 46 011090f0 2005-03-21 devnull ]
 47 30f6ae14 2005-02-13 devnull .B rdwr
 48 30f6ae14 2005-02-13 devnull .I path
 49 011090f0 2005-03-21 devnull .PP
 50 011090f0 2005-03-21 devnull .B 9p
 51 011090f0 2005-03-21 devnull [
 52 011090f0 2005-03-21 devnull .I options
 53 011090f0 2005-03-21 devnull ]
 54 011090f0 2005-03-21 devnull .B ls
 55 011090f0 2005-03-21 devnull [
 56 011090f0 2005-03-21 devnull .B -dl
 57 011090f0 2005-03-21 devnull ]
 58 011090f0 2005-03-21 devnull .I path...
 59 058b0118 2005-01-03 devnull .SH DESCRIPTION
 60 058b0118 2005-01-03 devnull .I 9p
 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:
 65 011090f0 2005-03-21 devnull .TP
 66 011090f0 2005-03-21 devnull .B -a\fI addr
 67 011090f0 2005-03-21 devnull dial
 68 011090f0 2005-03-21 devnull the server at
 69 011090f0 2005-03-21 devnull .I addr
 70 011090f0 2005-03-21 devnull .TP
 71 011090f0 2005-03-21 devnull .B -A\fI aname
 72 011090f0 2005-03-21 devnull attach to the file system named
 73 011090f0 2005-03-21 devnull .I aname
 74 058b0118 2005-01-03 devnull .PP
 75 058b0118 2005-01-03 devnull The first argument is a command, one of:
 76 058b0118 2005-01-03 devnull .TP
 77 058b0118 2005-01-03 devnull .B read
 78 058b0118 2005-01-03 devnull print the contents of
 79 058b0118 2005-01-03 devnull .I path 
 80 058b0118 2005-01-03 devnull to standard output
 81 058b0118 2005-01-03 devnull .TP
 82 058b0118 2005-01-03 devnull .B write
 83 058b0118 2005-01-03 devnull write data on standard input to
 84 d93fca6a 2005-02-11 devnull .IR path ;
 85 d93fca6a 2005-02-11 devnull the 
 86 d93fca6a 2005-02-11 devnull .B -l
 87 d93fca6a 2005-02-11 devnull option causes
 88 d93fca6a 2005-02-11 devnull .I write
 89 d93fca6a 2005-02-11 devnull to write one line at a time
 90 058b0118 2005-01-03 devnull .TP
 91 058b0118 2005-01-03 devnull .BR readfd ", " writefd
 92 058b0118 2005-01-03 devnull like
 93 058b0118 2005-01-03 devnull .B read
 94 058b0118 2005-01-03 devnull and 
 95 058b0118 2005-01-03 devnull .B write
 96 058b0118 2005-01-03 devnull but use
 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
103 058b0118 2005-01-03 devnull .TP
104 058b0118 2005-01-03 devnull .B stat
105 058b0118 2005-01-03 devnull execute
106 058b0118 2005-01-03 devnull .I stat (9p)
107 058b0118 2005-01-03 devnull on 
108 058b0118 2005-01-03 devnull .I path
109 058b0118 2005-01-03 devnull and print the result
110 30f6ae14 2005-02-13 devnull .TP
111 30f6ae14 2005-02-13 devnull .B rdwr
112 30f6ae14 2005-02-13 devnull Open
113 30f6ae14 2005-02-13 devnull .I path
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.
119 30f6ae14 2005-02-13 devnull .B Rdwr
120 30f6ae14 2005-02-13 devnull is useful for interacting with servers like
121 30f6ae14 2005-02-13 devnull .IR factotum (4).
122 011090f0 2005-03-21 devnull .TP
123 011090f0 2005-03-21 devnull .B ls
124 011090f0 2005-03-21 devnull Print a directory listing in the format of
125 011090f0 2005-03-21 devnull .IR ls (1).
126 011090f0 2005-03-21 devnull The
127 011090f0 2005-03-21 devnull .B -d
128 011090f0 2005-03-21 devnull and
129 011090f0 2005-03-21 devnull .B -l
130 011090f0 2005-03-21 devnull flags have the same meaning as in
131 011090f0 2005-03-21 devnull .IR ls .
132 058b0118 2005-01-03 devnull .PD
133 058b0118 2005-01-03 devnull .PP
134 058b0118 2005-01-03 devnull .I 9p
135 058b0118 2005-01-03 devnull dials
136 058b0118 2005-01-03 devnull .I address
137 058b0118 2005-01-03 devnull to connect to the 9P server.
138 058b0118 2005-01-03 devnull If the
139 058b0118 2005-01-03 devnull .B -a
140 058b0118 2005-01-03 devnull option is not given,
141 058b0118 2005-01-03 devnull .I 9p
142 058b0118 2005-01-03 devnull requires the
143 058b0118 2005-01-03 devnull .I path
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
149 058b0118 2005-01-03 devnull (see
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 :
158 058b0118 2005-01-03 devnull .IP
159 058b0118 2005-01-03 devnull .EX
160 058b0118 2005-01-03 devnull cat $HOME/lib/plumbing | 9p write plumb/rules
161 058b0118 2005-01-03 devnull .EE
162 058b0118 2005-01-03 devnull .PP
163 058b0118 2005-01-03 devnull To display the contents of the current
164 058b0118 2005-01-03 devnull .IR acme (4)
165 c8b6342d 2005-01-13 devnull window:
166 058b0118 2005-01-03 devnull .IP
167 058b0118 2005-01-03 devnull .EX
168 058b0118 2005-01-03 devnull 9p read acme/$winid/body
169 058b0118 2005-01-03 devnull .EE
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)