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 058b0118 2005-01-03 devnull .SH DESCRIPTION
 48 058b0118 2005-01-03 devnull .I 9p
 49 058b0118 2005-01-03 devnull is a trivial 9P client that can access a single file on a 9P server.
 50 058b0118 2005-01-03 devnull It can be useful for manual interaction with a 9P server or for
 51 058b0118 2005-01-03 devnull accessing simple 9P services from within shell scripts.
 52 058b0118 2005-01-03 devnull .PP
 53 058b0118 2005-01-03 devnull The first argument is a command, one of:
 54 058b0118 2005-01-03 devnull .TP
 55 058b0118 2005-01-03 devnull .B read
 56 058b0118 2005-01-03 devnull print the contents of
 57 058b0118 2005-01-03 devnull .I path 
 58 058b0118 2005-01-03 devnull to standard output
 59 058b0118 2005-01-03 devnull .TP
 60 058b0118 2005-01-03 devnull .B write
 61 058b0118 2005-01-03 devnull write data on standard input to
 62 d93fca6a 2005-02-11 devnull .IR path ;
 63 d93fca6a 2005-02-11 devnull the 
 64 d93fca6a 2005-02-11 devnull .B -l
 65 d93fca6a 2005-02-11 devnull option causes
 66 d93fca6a 2005-02-11 devnull .I write
 67 d93fca6a 2005-02-11 devnull to write one line at a time
 68 058b0118 2005-01-03 devnull .TP
 69 058b0118 2005-01-03 devnull .BR readfd ", " writefd
 70 058b0118 2005-01-03 devnull like
 71 058b0118 2005-01-03 devnull .B read
 72 058b0118 2005-01-03 devnull and 
 73 058b0118 2005-01-03 devnull .B write
 74 058b0118 2005-01-03 devnull but use
 75 058b0118 2005-01-03 devnull .IR openfd (9p)
 76 058b0118 2005-01-03 devnull instead of
 77 058b0118 2005-01-03 devnull .IR open ;
 78 058b0118 2005-01-03 devnull this masks errors and is mainly useful for debugging
 79 058b0118 2005-01-03 devnull the implementation of
 80 058b0118 2005-01-03 devnull .I openfd
 81 058b0118 2005-01-03 devnull .TP
 82 058b0118 2005-01-03 devnull .B stat
 83 058b0118 2005-01-03 devnull execute
 84 058b0118 2005-01-03 devnull .I stat (9p)
 85 058b0118 2005-01-03 devnull on 
 86 058b0118 2005-01-03 devnull .I path
 87 058b0118 2005-01-03 devnull and print the result
 88 058b0118 2005-01-03 devnull .PD
 89 058b0118 2005-01-03 devnull .PP
 90 058b0118 2005-01-03 devnull .I 9p
 91 058b0118 2005-01-03 devnull dials
 92 058b0118 2005-01-03 devnull .I address
 93 058b0118 2005-01-03 devnull to connect to the 9P server.
 94 058b0118 2005-01-03 devnull If the
 95 058b0118 2005-01-03 devnull .B -a
 96 058b0118 2005-01-03 devnull option is not given,
 97 058b0118 2005-01-03 devnull .I 9p
 98 058b0118 2005-01-03 devnull requires the
 99 058b0118 2005-01-03 devnull .I path
100 058b0118 2005-01-03 devnull to be of the form
101 058b0118 2005-01-03 devnull .IB service / subpath \fR;
102 058b0118 2005-01-03 devnull it connects to the Unix domain socket
103 058b0118 2005-01-03 devnull .I service
104 058b0118 2005-01-03 devnull in the name space directory
105 058b0118 2005-01-03 devnull (see
106 058b0118 2005-01-03 devnull .IR intro (4))
107 058b0118 2005-01-03 devnull and then accesses
108 058b0118 2005-01-03 devnull .IR subpath .
109 058b0118 2005-01-03 devnull .SH EXAMPLE
110 058b0118 2005-01-03 devnull To update
111 058b0118 2005-01-03 devnull .IR plumber (4)'s
112 058b0118 2005-01-03 devnull copy of your plumbing rules after editing
113 058b0118 2005-01-03 devnull .BR $HOME/lib/plumbing :
114 058b0118 2005-01-03 devnull .IP
115 058b0118 2005-01-03 devnull .EX
116 058b0118 2005-01-03 devnull cat $HOME/lib/plumbing | 9p write plumb/rules
117 058b0118 2005-01-03 devnull .EE
118 058b0118 2005-01-03 devnull .PP
119 058b0118 2005-01-03 devnull To display the contents of the current
120 058b0118 2005-01-03 devnull .IR acme (4)
121 c8b6342d 2005-01-13 devnull window:
122 058b0118 2005-01-03 devnull .IP
123 058b0118 2005-01-03 devnull .EX
124 058b0118 2005-01-03 devnull 9p read acme/$winid/body
125 058b0118 2005-01-03 devnull .EE
126 058b0118 2005-01-03 devnull .SH SOURCE
127 c3674de4 2005-01-11 devnull .B \*9/src/cmd/9p.c
128 058b0118 2005-01-03 devnull .SH SEE ALSO
129 058b0118 2005-01-03 devnull .IR intro (4),
130 058b0118 2005-01-03 devnull .IR intro (9p),
131 058b0118 2005-01-03 devnull .IR 9pclient (3)