sys/man/4/srv

   1 .TH SRV 4
   2 .SH NAME
   3 srv, srvtls, 9fs \- start network file service
   4 .SH SYNOPSIS
   5 .B srv
   6 [
   7 .B -abcCemnNq
   8 ] [
   9 .B -s
  10 .I seconds
  11 ]
  12 .RI [ net !] system\c
  13 .RI [! service ]
  14 [
  15 .I srvname
  16 [
  17 .I mtpt
  18 ] ]
  19 .PP
  20 .B srvtls
  21 [
  22 .B -abcCnq
  23 ] [
  24 .B -k
  25 .I keyspec
  26 ]
  27 .RI [ net !] system\c
  28 .RI [! service ]
  29 [
  30 .I srvname
  31 [
  32 .I mtpt
  33 ] ]
  34 .PP
  35 .B 9fs
  36 .RI [ net !] system
  37 .RI [ mountpoint ]
  38 .SH DESCRIPTION
  39 .I Srv
  40 dials the given machine and initializes the connection to serve the
  41 9P protocol.
  42 By default, it connects to the
  43 .L 9fs
  44 (9P)
  45 service, which for TCP is port 564.
  46 It then creates in
  47 .B /srv
  48 a file named
  49 .IR srvname .
  50 Users can then
  51 .B mount
  52 (see
  53 .IR bind (1))
  54 the service, typically on a name in
  55 .BR /n ,
  56 to access the files provided by the remote machine.
  57 If
  58 .I srvname
  59 is omitted, the first argument to
  60 .I srv
  61 is used.
  62 Option
  63 .B m
  64 directs
  65 .I srv
  66 to mount the service on
  67 .BI /n/ system
  68 or onto
  69 .I mtpt
  70 if it is given.
  71 Option
  72 .B q
  73 suppresses complaints if the
  74 .B /srv
  75 file already exists.
  76 The
  77 .BR a ,
  78 .BR b ,
  79 .BR c ,
  80 .BR C ,
  81 and
  82 .BR n ,
  83 .B N
  84 options are used to control the mount flags as in
  85 .I mount
  86 (see
  87 .IR bind (1)).
  88 The
  89 .B e
  90 option causes
  91 .I srv
  92 to treat
  93 .I system
  94 as a shell command to be executed rather than
  95 an address to be dialed.
  96 The
  97 .B s
  98 option causes
  99 .I srv
 100 to sleep for the specified number of seconds
 101 after establishing the connection
 102 before posting and mounting it.
 103 .PP
 104 The specified
 105 .I service
 106 must serve 9P.  Usually
 107 .I service
 108 can be omitted; when calling some
 109 non-Plan-9 systems, a
 110 .I service
 111 such as
 112 .B u9fs
 113 must be mentioned explicitly.
 114 .PP
 115 The
 116 .I 9fs
 117 command does the
 118 .I srv
 119 and the
 120 .I mount
 121 necessary to make available the files of
 122 .I system
 123 on network
 124 .IR net .
 125 The files are mounted on
 126 .IR mountpoint ,
 127 if given;
 128 otherwise they are mounted on
 129 .BI /n/ system\f1.
 130 If
 131 .I system
 132 contains
 133 .L /
 134 characters, only the last element of
 135 .I system
 136 is used in the
 137 .B /n
 138 name.
 139 .PP
 140 .I 9fs
 141 recognizes some special names, such as
 142 .B dump
 143 to make the dump file system available on
 144 .BR /n/dump .
 145 .I 9fs
 146 is an
 147 .IR rc (1)
 148 script; examine it to see what local conventions apply.
 149 .PP
 150 .I Srvtls
 151 is an
 152 .IR rc (1)
 153 command that uses
 154 .I tlsclient
 155 (see
 156 .IR tlssrv (8))
 157 to establish an mutual authenticated and encrypted 9P
 158 connection to the
 159 .I t9fs
 160 service which by default listens on tcp port 17020.
 161 .SH EXAMPLES
 162 To see kremvax's and deepthought's files in
 163 .B /n/kremvax
 164 and
 165 .BR /n/deepthought :
 166 .IP
 167 .EX
 168 9fs kremvax
 169 9fs hhgttg /n/deepthought
 170 .EE
 171 .SH FILES
 172 .TF /srv/*
 173 .TP
 174 .B /srv/*
 175 ports to file systems and servers posted by
 176 .I srv
 177 and
 178 .I 9fs
 179 .SH SOURCE
 180 .B /sys/src/cmd/srv.c
 181 .br
 182 .B /rc/bin/9fs
 183 .br
 184 .B /rc/bin/srvtls
 185 .SH "SEE ALSO"
 186 .IR bind (1),
 187 .IR auth (2),
 188 .IR dial (2),
 189 .IR srv (3),
 190 .IR tlssrv (4),
 191 .IR exportfs (4).
 192 .SH BUGS
 193 .I Srv
 194 does not explicitly report failures of
 195 .I auth_proxy
 196 (see
 197 .IR auth (2));
 198 .I mount
 199 (see
 200 .IR bind (1))
 201 does.