338 lines
4.9 KiB
Text
338 lines
4.9 KiB
Text
.TH SRV 4
|
|
.SH NAME
|
|
srv, srvold9p, 9fs, srvssh \- start network file service
|
|
.SH SYNOPSIS
|
|
.B srv
|
|
[
|
|
.B -abcCemnq
|
|
] [
|
|
.B -s
|
|
.I seconds
|
|
]
|
|
.RI [ net !] system\c
|
|
.RI [! service ]
|
|
[
|
|
.I srvname
|
|
[
|
|
.I mtpt
|
|
] ]
|
|
.PP
|
|
.B srvssh
|
|
[
|
|
.B -r
|
|
]
|
|
[
|
|
.B -R
|
|
]
|
|
[
|
|
.B -s
|
|
]
|
|
[
|
|
.B -u
|
|
.I u9fspath
|
|
]
|
|
.I system
|
|
[
|
|
.I srvname
|
|
[
|
|
.I mtpt
|
|
] ]
|
|
.PP
|
|
.B 9fs
|
|
.RI [ net !] system
|
|
.RI [ mountpoint ]
|
|
.PP
|
|
.in +0.5i
|
|
.ti -0.5i
|
|
.B srvold9p
|
|
[
|
|
.B -abcCdF
|
|
] [
|
|
.B -p
|
|
.I servicename
|
|
] [
|
|
.B -s
|
|
|
|
|
.B -m
|
|
.I mountpoint
|
|
] [
|
|
.B -u
|
|
.I user
|
|
] [
|
|
.B -x
|
|
.I command
|
|
|
|
|
.B -n
|
|
.I network-addr
|
|
|
|
|
.B -f
|
|
.I file
|
|
]
|
|
.br
|
|
.in -0.5i
|
|
.SH DESCRIPTION
|
|
.I Srv
|
|
dials the given machine and initializes the connection to serve the
|
|
9P protocol.
|
|
By default, it connects to the
|
|
.L 9fs
|
|
(9P)
|
|
service, which for TCP is port 564.
|
|
It then creates in
|
|
.B /srv
|
|
a file named
|
|
.IR srvname .
|
|
Users can then
|
|
.B mount
|
|
(see
|
|
.IR bind (1))
|
|
the service, typically on a name in
|
|
.BR /n ,
|
|
to access the files provided by the remote machine.
|
|
If
|
|
.I srvname
|
|
is omitted, the first argument to
|
|
.I srv
|
|
is used.
|
|
Option
|
|
.B m
|
|
directs
|
|
.I srv
|
|
to mount the service on
|
|
.BI /n/ system
|
|
or onto
|
|
.I mtpt
|
|
if it is given.
|
|
Option
|
|
.B q
|
|
suppresses complaints if the
|
|
.B /srv
|
|
file already exists.
|
|
The
|
|
.BR a ,
|
|
.BR b ,
|
|
.BR c ,
|
|
.BR C ,
|
|
and
|
|
.B n
|
|
options are used to control the mount flags as in
|
|
.I mount
|
|
(see
|
|
.IR bind (1)).
|
|
The
|
|
.B e
|
|
option causes
|
|
.I srv
|
|
to treat
|
|
.I system
|
|
as a shell command to be executed rather than
|
|
an address to be dialed.
|
|
The
|
|
.B s
|
|
option causes
|
|
.I srv
|
|
to sleep for the specified number of seconds
|
|
after establishing the connection
|
|
before posting and mounting it.
|
|
This is sometimes needed by
|
|
.IR srvssh .
|
|
.PP
|
|
The specified
|
|
.I service
|
|
must serve 9P. Usually
|
|
.I service
|
|
can be omitted; when calling some
|
|
non-Plan-9 systems, a
|
|
.I service
|
|
such as
|
|
.B u9fs
|
|
must be mentioned explicitly.
|
|
.PP
|
|
The
|
|
.I 9fs
|
|
command does the
|
|
.I srv
|
|
and the
|
|
.I mount
|
|
necessary to make available the files of
|
|
.I system
|
|
on network
|
|
.IR net .
|
|
The files are mounted on
|
|
.IR mountpoint ,
|
|
if given;
|
|
otherwise they are mounted on
|
|
.BI /n/ system\f1.
|
|
If
|
|
.I system
|
|
contains
|
|
.L /
|
|
characters, only the last element of
|
|
.I system
|
|
is used in the
|
|
.B /n
|
|
name.
|
|
.PP
|
|
.I 9fs
|
|
recognizes some special names, such as
|
|
.B dump
|
|
to make the dump file system available on
|
|
.BR /n/dump .
|
|
.I 9fs
|
|
is an
|
|
.IR rc (1)
|
|
script; examine it to see what local conventions apply.
|
|
.PP
|
|
.I Srvssh
|
|
is an
|
|
.IR rc (1)
|
|
command that
|
|
connects to a remote Unix system via
|
|
.IR ssh (1)
|
|
and starts
|
|
.IR u9fs (4).
|
|
The
|
|
.B -u
|
|
option specifies the path to the
|
|
.B u9fs
|
|
binary on the remote system.
|
|
(By default, an unrooted path of
|
|
.B u9fs
|
|
is used; if the binary is in the path of
|
|
the remote SSH server, you don't need the
|
|
.B -u
|
|
option.)
|
|
For information about the other options,
|
|
see the introductory comment in
|
|
.BR /rc/bin/srvssh .
|
|
The arguments are the same as
|
|
.IR srv .
|
|
.PP
|
|
.I Srvold9p
|
|
is a compatibilty hack to allow Fourth Edition Plan 9 systems
|
|
to connect to older 9P servers.
|
|
It functions as a variant of
|
|
.I srv
|
|
that performs a version translation on the 9P messages on the underlying connection.
|
|
Some of its options are the same as those of
|
|
.IR srv ;
|
|
the special ones are:
|
|
.TF "-x commandxx"
|
|
.PD
|
|
.TP
|
|
.B -d
|
|
Enable debugging.
|
|
.TP
|
|
.B -F
|
|
Insert a special (internal) filter process to the connection to maintain
|
|
message boundaries; usually only needed on TCP connections.
|
|
.TP
|
|
.BI -p\ servicename
|
|
Post the service under
|
|
.IR srv (3)
|
|
as
|
|
.BI /srv/ servicename\f1.
|
|
.TP
|
|
.BI -u\ user
|
|
When connecting to the remote server, log in as
|
|
.IR user .
|
|
Since
|
|
.I srvold9p
|
|
does no authentication, and since new kernels cannot authenticate to
|
|
old services, the likeliest value of
|
|
.I user
|
|
is
|
|
.BR none .
|
|
.TP
|
|
.BI -x\ command
|
|
Run
|
|
.I command
|
|
and use its standard input and output as the 9P service connection.
|
|
If the
|
|
.I command
|
|
string contains blanks, it should be quoted.
|
|
.TP
|
|
.BI -n\ network-addr
|
|
Dial
|
|
.I network-addr
|
|
to establish the connection.
|
|
.TP
|
|
.BI -f\ file
|
|
Use
|
|
.I file
|
|
(typically an existing
|
|
.IR srv (3)
|
|
file) as the connection.
|
|
.PP
|
|
.I Srvold9p
|
|
is run automatically when a
|
|
.IR cpu (1)
|
|
call is received on the service port for the old protocol.
|
|
.SH EXAMPLES
|
|
To see kremvax's and deepthought's files in
|
|
.B /n/kremvax
|
|
and
|
|
.BR /n/deepthought :
|
|
.IP
|
|
.EX
|
|
9fs kremvax
|
|
9fs hhgttg /n/deepthought
|
|
.EE
|
|
.PP
|
|
To mount as user
|
|
.B none
|
|
a connection to an older server kgbsun:
|
|
.IP
|
|
.EX
|
|
srvold9p -u none -m /n/kgbsun -p kgbsun -n il!kgbsun
|
|
.EE
|
|
.PP
|
|
Other windows may then mount the connection directly:
|
|
.IP
|
|
.EX
|
|
mount /srv/kgbsun /n/kgbsun
|
|
.EE
|
|
.PP
|
|
To connect to an instance of the Unix server
|
|
.IR u9fs (4)
|
|
started via
|
|
.IR ssh (1):
|
|
.IP
|
|
.EX
|
|
srvssh unix
|
|
.EE
|
|
.SH FILES
|
|
.TF /srv/*
|
|
.TP
|
|
.B /srv/*
|
|
ports to file systems and servers posted by
|
|
.I srv
|
|
and
|
|
.I 9fs
|
|
.SH SOURCE
|
|
.B /sys/src/cmd/srv.c
|
|
.br
|
|
.B /rc/bin/9fs
|
|
.br
|
|
.B /rc/bin/srvssh
|
|
.br
|
|
.B /sys/src/cmd/srvold9p
|
|
.SH "SEE ALSO"
|
|
.IR bind (1),
|
|
.IR auth (2),
|
|
.IR dial (2),
|
|
.IR srv (3),
|
|
.IR exportfs (4),
|
|
.IR import (4),
|
|
.IR ftpfs (4),
|
|
.IR u9fs (4)
|
|
.SH BUGS
|
|
.I Srv
|
|
does not explicitly report failures of
|
|
.I auth_proxy
|
|
(see
|
|
.IR auth (2));
|
|
.I mount
|
|
(see
|
|
.IR bind (1))
|
|
does.
|