10564b1175
groff 1.23.0 added .MR to its -man macro package. The NEWS file states
that the inclusion of the macro "was prompted by its introduction to
Plan 9 from User Space's troff in August 2020." From d32deab it seems
that the name for Plan 9 from User Space's implementation was suggested
by groff maintainer G. Brandon Robinson.
Not sure if the intention was to make these definitions compatible, but
it would be nice if they were.
Currently, Plan 9 from User Space's .MR expects its second argument to
be parenthesized. groff's .MR does not. This results in extra
parentheses appearing in manual references when viewing Plan 9 from User
Space's manual pages on a system using groff.
104 lines
1.7 KiB
Groff
104 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
|