.TH SRV 8 obsolete.SH NAMEsrv \- start services.SH SYNOPSIS.B lib/srv[.BI -n " nsfile"][.B -v][.B -s].SH DESCRIPTION.I Srvstarts listeners for local network services.It is now considered obsolete: see.IR svc (8),which replaces it using.IR sh (1)and.IR listen (1)..PPIf the file.B /services/namespaceexists,.I srvbuilds a new name space using.IR newns (2).The.B -noption may be used to supply a different file..I Srvthen starts a listener for each service configured in.BR /services/server/config ..PPThe configuration file is a text file.Empty lines and lines beginning.B #are comments, and ignored.Each non-comment line has at least four fields:the server type, the service name, the network name on which to announce the service(typically.B tcpor.BR udp ),and the path name of the service command (module).Any further arguments are passed as arguments to that command..PPNormally the server type field contains the letter.BR S ,and.I srvannounces the service on the network itself, listens for incoming calls,and on each call invokes the command with any arguments given.The standard input and output of the command are set to refer to thenetwork connection.If the server type field contains the letter.BR M ,however,.I srvstarts the given command once during its own initialisation, and leaves the serverto announce and manage its incoming calls.This is typically used to start self-contained services such as.B bootpand.BR tftpd .The diagnostics from all servers will appear on the standarderror of.I srvitself..PPFor example, the default configuration file includes the following lines:.PP.EX.ps -2S infsigner tcp /dis/auth/signer.dis S infcsigner tcp /dis/auth/countersigner.disS inflogin tcp /dis/auth/logind.dis S styx tcp /dis/lib/styxd.dis none clear sha md5 rc4 sha/rc4 md5/rc4S rstyx tcp /dis/lib/rstyxd.dis none clear sha md5 rc4 sha/rc4 md5/rc4S infdb tcp /dis/lib/dbsrv.dis none clear sha md5 rc4 sha/rc4 md5/rc4S virgil udp /dis/lib/virgild.dis.ps +2.EE.PPThe arguments to.IR rstyxdand.IR stxyd(see.IR rstyxd (8)),and.IR dbsrv (7)should list the security algorithms supported by the server's.IR ssl (3)..SH FILES.B /services/namespace.br.B /services/server/config.SH SOURCE.B /appl/lib/srv.b.SH SEE ALSO.IR listen (1),.IR services (6),.IR cs (8),.IR dbsrv (7),.IR rstyxd (8),.IR svc (8).SH BUGSEach service should arguably start in a minimal name space.
.TH SRV 8 obsolete
.SH NAME
srv \- start services
.SH SYNOPSIS
.B lib/srv
[
.BI -n " nsfile"
]
[
.B -v
]
[
.B -s
]
.SH DESCRIPTION
.I Srv
starts listeners for local network services.
It is now considered obsolete: see
.IR svc (8),
which replaces it using
.IR sh (1)
and
.IR listen (1).
.PP
If the file
.B /services/namespace
exists,
.I srv
builds a new name space using
.IR newns (2).
The
.B -n
option may be used to supply a different file.
.I Srv
then starts a listener for each service configured in
.BR /services/server/config .
.PP
The configuration file is a text file.
Empty lines and lines beginning
.B #
are comments, and ignored.
Each non-comment line has at least four fields:
the server type, the service name, the network name on which to announce the service
(typically
.B tcp
or
.BR udp ),
and the path name of the service command (module).
Any further arguments are passed as arguments to that command.
.PP
Normally the server type field contains the letter
.BR S ,
and
.I srv
announces the service on the network itself, listens for incoming calls,
and on each call invokes the command with any arguments given.
The standard input and output of the command are set to refer to the
network connection.
If the server type field contains the letter
.BR M ,
however,
.I srv
starts the given command once during its own initialisation, and leaves the server
to announce and manage its incoming calls.
This is typically used to start self-contained services such as
.B bootp
and
.BR tftpd .
The diagnostics from all servers will appear on the standard
error of
.I srv
itself.
.PP
For example, the default configuration file includes the following lines:
.PP
.EX
.ps -2
S infsigner tcp /dis/auth/signer.dis
S infcsigner tcp /dis/auth/countersigner.dis
S inflogin tcp /dis/auth/logind.dis
S styx tcp /dis/lib/styxd.dis none clear sha md5 rc4 sha/rc4 md5/rc4
S rstyx tcp /dis/lib/rstyxd.dis none clear sha md5 rc4 sha/rc4 md5/rc4
S infdb tcp /dis/lib/dbsrv.dis none clear sha md5 rc4 sha/rc4 md5/rc4
S virgil udp /dis/lib/virgild.dis
.ps +2
.EE
.PP
The arguments to
.IR rstyxd
and
.IR stxyd
(see
.IR rstyxd (8)),
and
.IR dbsrv (7)
should list the security algorithms supported by the server's
.IR ssl (3).
.SH FILES
.B /services/namespace
.br
.B /services/server/config
.SH SOURCE
.B /appl/lib/srv.b
.SH SEE ALSO
.IR listen (1),
.IR services (6),
.IR cs (8),
.IR dbsrv (7),
.IR rstyxd (8),
.IR svc (8)
.SH BUGS
Each service should arguably start in a minimal name space.