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