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 058b0118 2005-01-03 devnull .B -a
  8 058b0118 2005-01-03 devnull .I addr
  9 058b0118 2005-01-03 devnull ]
 10 058b0118 2005-01-03 devnull .B read
 11 058b0118 2005-01-03 devnull .I path
 12 058b0118 2005-01-03 devnull .br
 13 058b0118 2005-01-03 devnull .B 9p
 14 058b0118 2005-01-03 devnull [
 15 058b0118 2005-01-03 devnull .B -a
 16 058b0118 2005-01-03 devnull .I addr
 17 058b0118 2005-01-03 devnull ]
 18 058b0118 2005-01-03 devnull .B readfd
 19 058b0118 2005-01-03 devnull .I path
 20 058b0118 2005-01-03 devnull .PP
 21 058b0118 2005-01-03 devnull .B 9p
 22 058b0118 2005-01-03 devnull [
 23 058b0118 2005-01-03 devnull .B -a
 24 058b0118 2005-01-03 devnull .I addr
 25 058b0118 2005-01-03 devnull ]
 26 058b0118 2005-01-03 devnull .B write
 27 d93fca6a 2005-02-11 devnull [
 28 d93fca6a 2005-02-11 devnull .B -l
 29 d93fca6a 2005-02-11 devnull ]
 30 058b0118 2005-01-03 devnull .I path
 31 058b0118 2005-01-03 devnull .br
 32 058b0118 2005-01-03 devnull .B 9p
 33 058b0118 2005-01-03 devnull [
 34 058b0118 2005-01-03 devnull .B -a
 35 058b0118 2005-01-03 devnull .I addr
 36 058b0118 2005-01-03 devnull ]
 37 058b0118 2005-01-03 devnull .B writefd
 38 058b0118 2005-01-03 devnull .I path
 39 058b0118 2005-01-03 devnull .PP
 40 058b0118 2005-01-03 devnull .B 9p
 41 058b0118 2005-01-03 devnull [
 42 058b0118 2005-01-03 devnull .B -a
 43 058b0118 2005-01-03 devnull .I addr
 44 058b0118 2005-01-03 devnull ]
 45 058b0118 2005-01-03 devnull .B stat
 46 058b0118 2005-01-03 devnull .I path
 47 30f6ae14 2005-02-13 devnull .PP
 48 30f6ae14 2005-02-13 devnull .B 9p
 49 30f6ae14 2005-02-13 devnull .B rdwr
 50 30f6ae14 2005-02-13 devnull .I path
 51 058b0118 2005-01-03 devnull .SH DESCRIPTION
 52 058b0118 2005-01-03 devnull .I 9p
 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.
 56 058b0118 2005-01-03 devnull .PP
 57 058b0118 2005-01-03 devnull The first argument is a command, one of:
 58 058b0118 2005-01-03 devnull .TP
 59 058b0118 2005-01-03 devnull .B read
 60 058b0118 2005-01-03 devnull print the contents of
 61 058b0118 2005-01-03 devnull .I path 
 62 058b0118 2005-01-03 devnull to standard output
 63 058b0118 2005-01-03 devnull .TP
 64 058b0118 2005-01-03 devnull .B write
 65 058b0118 2005-01-03 devnull write data on standard input to
 66 d93fca6a 2005-02-11 devnull .IR path ;
 67 d93fca6a 2005-02-11 devnull the 
 68 d93fca6a 2005-02-11 devnull .B -l
 69 d93fca6a 2005-02-11 devnull option causes
 70 d93fca6a 2005-02-11 devnull .I write
 71 d93fca6a 2005-02-11 devnull to write one line at a time
 72 058b0118 2005-01-03 devnull .TP
 73 058b0118 2005-01-03 devnull .BR readfd ", " writefd
 74 058b0118 2005-01-03 devnull like
 75 058b0118 2005-01-03 devnull .B read
 76 058b0118 2005-01-03 devnull and 
 77 058b0118 2005-01-03 devnull .B write
 78 058b0118 2005-01-03 devnull but use
 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
 85 058b0118 2005-01-03 devnull .TP
 86 058b0118 2005-01-03 devnull .B stat
 87 058b0118 2005-01-03 devnull execute
 88 058b0118 2005-01-03 devnull .I stat (9p)
 89 058b0118 2005-01-03 devnull on 
 90 058b0118 2005-01-03 devnull .I path
 91 058b0118 2005-01-03 devnull and print the result
 92 30f6ae14 2005-02-13 devnull .TP
 93 30f6ae14 2005-02-13 devnull .B rdwr
 94 30f6ae14 2005-02-13 devnull Open
 95 30f6ae14 2005-02-13 devnull .I path
 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.
101 30f6ae14 2005-02-13 devnull .B Rdwr
102 30f6ae14 2005-02-13 devnull is useful for interacting with servers like
103 30f6ae14 2005-02-13 devnull .IR factotum (4).
104 058b0118 2005-01-03 devnull .PD
105 058b0118 2005-01-03 devnull .PP
106 058b0118 2005-01-03 devnull .I 9p
107 058b0118 2005-01-03 devnull dials
108 058b0118 2005-01-03 devnull .I address
109 058b0118 2005-01-03 devnull to connect to the 9P server.
110 058b0118 2005-01-03 devnull If the
111 058b0118 2005-01-03 devnull .B -a
112 058b0118 2005-01-03 devnull option is not given,
113 058b0118 2005-01-03 devnull .I 9p
114 058b0118 2005-01-03 devnull requires the
115 058b0118 2005-01-03 devnull .I path
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
121 058b0118 2005-01-03 devnull (see
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 :
130 058b0118 2005-01-03 devnull .IP
131 058b0118 2005-01-03 devnull .EX
132 058b0118 2005-01-03 devnull cat $HOME/lib/plumbing | 9p write plumb/rules
133 058b0118 2005-01-03 devnull .EE
134 058b0118 2005-01-03 devnull .PP
135 058b0118 2005-01-03 devnull To display the contents of the current
136 058b0118 2005-01-03 devnull .IR acme (4)
137 c8b6342d 2005-01-13 devnull window:
138 058b0118 2005-01-03 devnull .IP
139 058b0118 2005-01-03 devnull .EX
140 058b0118 2005-01-03 devnull 9p read acme/$winid/body
141 058b0118 2005-01-03 devnull .EE
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)