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 4ff69507 2007-10-12 rsc .TP
 75 4ff69507 2007-10-12 rsc .B -n
 76 4ff69507 2007-10-12 rsc mount without authentication
 77 058b0118 2005-01-03 devnull .PP
 78 058b0118 2005-01-03 devnull The first argument is a command, one of:
 79 058b0118 2005-01-03 devnull .TP
 80 058b0118 2005-01-03 devnull .B read
 81 058b0118 2005-01-03 devnull print the contents of
 82 058b0118 2005-01-03 devnull .I path 
 83 058b0118 2005-01-03 devnull to standard output
 84 058b0118 2005-01-03 devnull .TP
 85 058b0118 2005-01-03 devnull .B write
 86 058b0118 2005-01-03 devnull write data on standard input to
 87 d93fca6a 2005-02-11 devnull .IR path ;
 88 d93fca6a 2005-02-11 devnull the 
 89 d93fca6a 2005-02-11 devnull .B -l
 90 d93fca6a 2005-02-11 devnull option causes
 91 d93fca6a 2005-02-11 devnull .I write
 92 d93fca6a 2005-02-11 devnull to write one line at a time
 93 058b0118 2005-01-03 devnull .TP
 94 058b0118 2005-01-03 devnull .BR readfd ", " writefd
 95 058b0118 2005-01-03 devnull like
 96 058b0118 2005-01-03 devnull .B read
 97 058b0118 2005-01-03 devnull and 
 98 058b0118 2005-01-03 devnull .B write
 99 058b0118 2005-01-03 devnull but use
100 058b0118 2005-01-03 devnull .IR openfd (9p)
101 058b0118 2005-01-03 devnull instead of
102 058b0118 2005-01-03 devnull .IR open ;
103 058b0118 2005-01-03 devnull this masks errors and is mainly useful for debugging
104 058b0118 2005-01-03 devnull the implementation of
105 058b0118 2005-01-03 devnull .I openfd
106 058b0118 2005-01-03 devnull .TP
107 058b0118 2005-01-03 devnull .B stat
108 058b0118 2005-01-03 devnull execute
109 058b0118 2005-01-03 devnull .I stat (9p)
110 058b0118 2005-01-03 devnull on 
111 058b0118 2005-01-03 devnull .I path
112 058b0118 2005-01-03 devnull and print the result
113 30f6ae14 2005-02-13 devnull .TP
114 30f6ae14 2005-02-13 devnull .B rdwr
115 30f6ae14 2005-02-13 devnull Open
116 30f6ae14 2005-02-13 devnull .I path
117 30f6ae14 2005-02-13 devnull for reading and writing.
118 30f6ae14 2005-02-13 devnull Then repeat until end-of-file on standard input:
119 30f6ae14 2005-02-13 devnull copy a line from the file to standard output,
120 30f6ae14 2005-02-13 devnull copy a line from standard input to the file.
121 30f6ae14 2005-02-13 devnull Print errors, but don't give up.
122 30f6ae14 2005-02-13 devnull .B Rdwr
123 30f6ae14 2005-02-13 devnull is useful for interacting with servers like
124 d32deab1 2020-08-16 rsc .MR factotum (4) .
125 011090f0 2005-03-21 devnull .TP
126 011090f0 2005-03-21 devnull .B ls
127 011090f0 2005-03-21 devnull Print a directory listing in the format of
128 d32deab1 2020-08-16 rsc .MR ls (1) .
129 011090f0 2005-03-21 devnull The
130 011090f0 2005-03-21 devnull .B -d
131 011090f0 2005-03-21 devnull and
132 011090f0 2005-03-21 devnull .B -l
133 011090f0 2005-03-21 devnull flags have the same meaning as in
134 011090f0 2005-03-21 devnull .IR ls .
135 058b0118 2005-01-03 devnull .PD
136 058b0118 2005-01-03 devnull .PP
137 058b0118 2005-01-03 devnull .I 9p
138 058b0118 2005-01-03 devnull dials
139 058b0118 2005-01-03 devnull .I address
140 058b0118 2005-01-03 devnull to connect to the 9P server.
141 058b0118 2005-01-03 devnull If the
142 058b0118 2005-01-03 devnull .B -a
143 058b0118 2005-01-03 devnull option is not given,
144 058b0118 2005-01-03 devnull .I 9p
145 058b0118 2005-01-03 devnull requires the
146 058b0118 2005-01-03 devnull .I path
147 058b0118 2005-01-03 devnull to be of the form
148 058b0118 2005-01-03 devnull .IB service / subpath \fR;
149 058b0118 2005-01-03 devnull it connects to the Unix domain socket
150 058b0118 2005-01-03 devnull .I service
151 058b0118 2005-01-03 devnull in the name space directory
152 058b0118 2005-01-03 devnull (see
153 d32deab1 2020-08-16 rsc .MR intro (4) )
154 058b0118 2005-01-03 devnull and then accesses
155 058b0118 2005-01-03 devnull .IR subpath .
156 058b0118 2005-01-03 devnull .SH EXAMPLE
157 058b0118 2005-01-03 devnull To update
158 d32deab1 2020-08-16 rsc .MR plumber (4) 's
159 058b0118 2005-01-03 devnull copy of your plumbing rules after editing
160 058b0118 2005-01-03 devnull .BR $HOME/lib/plumbing :
161 058b0118 2005-01-03 devnull .IP
162 058b0118 2005-01-03 devnull .EX
163 058b0118 2005-01-03 devnull cat $HOME/lib/plumbing | 9p write plumb/rules
164 058b0118 2005-01-03 devnull .EE
165 058b0118 2005-01-03 devnull .PP
166 058b0118 2005-01-03 devnull To display the contents of the current
167 d32deab1 2020-08-16 rsc .MR acme (4)
168 c8b6342d 2005-01-13 devnull window:
169 058b0118 2005-01-03 devnull .IP
170 058b0118 2005-01-03 devnull .EX
171 058b0118 2005-01-03 devnull 9p read acme/$winid/body
172 058b0118 2005-01-03 devnull .EE
173 058b0118 2005-01-03 devnull .SH SOURCE
174 c3674de4 2005-01-11 devnull .B \*9/src/cmd/9p.c
175 058b0118 2005-01-03 devnull .SH SEE ALSO
176 d32deab1 2020-08-16 rsc .MR intro (4) ,
177 058b0118 2005-01-03 devnull .IR intro (9p),
178 d32deab1 2020-08-16 rsc .MR 9pclient (3)