sys/man/8/9pcon

   1 .TH 9PCON 8
   2 .SH NAME
   3 9pcon \- 9P to text translator
   4 .SH SYNOPSIS
   5 .B aux/9pcon
   6 [
   7 .B -cn
   8 ]
   9 [
  10 .B -m
  11 .I msize
  12 ]
  13 .I service
  14 .SH DESCRIPTION
  15 .I 9pcon
  16 provides a textual interface to
  17 .IR service ,
  18 a conventional 9P server.
  19 By default,
  20 .I 9pcon
  21 interprets
  22 .I service
  23 as a file to be opened.
  24 The
  25 .B -c
  26 flag causes
  27 .I 9pcon
  28 to interpret
  29 .I service
  30 as a command to run which will carry out a
  31 (binary) 9P
  32 conversation over file descriptors 0 and 1.
  33 The
  34 .B -n
  35 flag
  36 causes
  37 .I 9pcon
  38 to interpret
  39 .I service
  40 as a network address to dial.
  41 .PP
  42 Once the connection is established,
  43 .I 9pcon
  44 prints R-messages as they arrive from the server,
  45 and sends T-messages as they are typed on standard input.
  46 There is no prompt.
  47 Lines beginning with # are ignored.
  48 The syntax for T-messages is one of:
  49 .IP
  50 .B Tversion
  51 .I msize
  52 .I version
  53 .br
  54 .B Tauth
  55 .I afid
  56 .I uname
  57 .I aname
  58 .br
  59 .B Tattach
  60 .I fid
  61 .I afid
  62 .I uname
  63 .I aname
  64 .br
  65 .B Twalk
  66 .I fid
  67 .I newfid
  68 .I wname...
  69 .br
  70 .B Topen
  71 .I fid
  72 .I mode
  73 .br
  74 .B Tcreate
  75 .I fid
  76 .I name
  77 .I perm
  78 .I mode
  79 .br
  80 .B Tread
  81 .I fid
  82 .I offset
  83 .I count
  84 .br
  85 .B Twrite
  86 .I fid
  87 .I offset
  88 .I data
  89 .br
  90 .B Tclunk
  91 .I fid
  92 .br
  93 .B Tremove
  94 .I fid
  95 .br
  96 .B Tstat
  97 .I fid
  98 .br
  99 .B Twstat
 100 .I fid
 101 .I name
 102 .I uid
 103 .I gid
 104 .I mode
 105 .I mtime
 106 .I length
 107 .br
 108 .B Tflush
 109 .I oldtag
 110 .LP
 111 See
 112 .IR intro (5)
 113 for a description of the fields in each message.
 114 For the most part, the syntax mirrors the description
 115 of the messages in section 5.
 116 The exceptions are that
 117 the tags on the T-messages are added automatically;
 118 .BR Twalk 's
 119 .I nwname
 120 count is inferred from the number of
 121 .I wnames
 122 given;
 123 and
 124 .BR Twstat 's
 125 .I dir
 126 is in expanded form rather than being an opaque byte sequence.
 127 Note that since commands are parsed with
 128 .B tokenize
 129 (see
 130 .IR getfields (2)),
 131 it is easy to pass empty strings for absent
 132 .IR name ,
 133 .IR uid ,
 134 and
 135 .I gid
 136 fields.
 137 To ease specifying default integer fields, the
 138 .B Twstat
 139 message recognizes
 140 .B ~0
 141 in the
 142 .IR mode ,
 143 .IR mtime ,
 144 and
 145 .I length
 146 arguments.
 147 For example,
 148 .EX
 149     Twstat 101 '' '' sys ~0 ~0 ~0
 150 .EE
 151 sends a
 152 .I wstat
 153 message that attempts to change the group id associated with fid 101.
 154 .SH SOURCE
 155 .B /sys/src/cmd/aux/9pcon.c
 156 .SH SEE ALSO
 157 .IR intro (5)
 158 .SH BUGS
 159 There should be a flag to wait for responses,
 160 to facilitate scripting.