mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
103 lines
1.7 KiB
Groff
103 lines
1.7 KiB
Groff
.TH SRV 4
|
|
.SH NAME
|
|
srv, 9fs \- start network file service
|
|
.SH SYNOPSIS
|
|
.B srv
|
|
[
|
|
.B -an
|
|
]
|
|
[
|
|
.B -k
|
|
.I keypattern
|
|
]
|
|
.I address
|
|
[
|
|
.I srvname
|
|
]
|
|
.PP
|
|
.B 9fs
|
|
.I system
|
|
.SH DESCRIPTION
|
|
.I Srv
|
|
dials the given address and initializes the connection to serve the 9P protocol.
|
|
It then posts the resulting connection in the current name space
|
|
(see
|
|
.MR intro (4) )
|
|
as
|
|
.I srvname
|
|
(default
|
|
.IR address ).
|
|
.PP
|
|
The
|
|
.B -a
|
|
option causes
|
|
.I srv
|
|
to post a pre-authenticated connection to the file system
|
|
.I aname
|
|
(by default, the empty string;
|
|
see
|
|
.IR attach (9p)).
|
|
.PP
|
|
The
|
|
.B -n
|
|
option causes
|
|
.I srv
|
|
to reject authentication attempts by clients,
|
|
useful if the remote server is known not to require authentication.
|
|
.PP
|
|
.I Srv
|
|
authenticates over the 9P connection to establish a valid auth fid.
|
|
.IR Keypattern ,
|
|
if specified, is used to select the key used for authentication.
|
|
Client attach requests are rewritten to use the specified
|
|
.I aname
|
|
and auth fid.
|
|
.PP
|
|
The
|
|
.I 9fs
|
|
command executes the
|
|
.I srv
|
|
necessary to make available the files of
|
|
.IR system .
|
|
.PP
|
|
.I 9fs
|
|
recognizes some special names,
|
|
such as
|
|
.B sources
|
|
to make the file server
|
|
.I sources.cs.bell-labs.com
|
|
available as service
|
|
.IR sources .
|
|
.I 9fs
|
|
is an
|
|
.MR rc (1)
|
|
script; examine it to see what local conventions apply.
|
|
.SH EXAMPLES
|
|
List the root directory on
|
|
.IR sources :
|
|
.IP
|
|
.EX
|
|
9fs sources
|
|
9p ls sources
|
|
.EE
|
|
.PP
|
|
Mount a remote file server
|
|
.I bootes
|
|
on Linux using the kernel 9P mount driver,
|
|
with
|
|
.I srv
|
|
handling authentication:
|
|
.IP
|
|
.EX
|
|
srv -a sources.cs.bell-labs.com sources
|
|
sudo mount -t 9p -o trans=unix,uname=$USER,dfltuid=`id -u`,dfltgid=`id -g`
|
|
`namespace`/sources /n/sources
|
|
.EE
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/srv.c
|
|
.br
|
|
.B \*9/bin/9fs
|
|
.SH "SEE ALSO
|
|
.MR dial (3) ,
|
|
.MR intro (4) ,
|
|
.MR netfiles (1)
|