| @@ -1,112 +0,0 @@ |
| 1 | | −.TH SRV 8 obsolete |
| 2 | | −.SH NAME |
| 3 | | −srv \- start services |
| 4 | | −.SH SYNOPSIS |
| 5 | | −.B lib/srv |
| 6 | | −[ |
| 7 | | −.BI -n " nsfile" |
| 8 | | −] |
| 9 | | −[ |
| 10 | | −.B -v |
| 11 | | −] |
| 12 | | −[ |
| 13 | | −.B -s |
| 14 | | −] |
| 15 | | −.SH DESCRIPTION |
| 16 | | −.I Srv |
| 17 | | −starts listeners for local network services. |
| 18 | | −It is now considered obsolete: see |
| 19 | | −.IR svc (8), |
| 20 | | −which replaces it using |
| 21 | | −.IR sh (1) |
| 22 | | −and |
| 23 | | −.IR listen (1). |
| 24 | | −.PP |
| 25 | | −If the file |
| 26 | | −.B /services/namespace |
| 27 | | −exists, |
| 28 | | −.I srv |
| 29 | | −builds a new name space using |
| 30 | | −.IR newns (2). |
| 31 | | −The |
| 32 | | −.B -n |
| 33 | | −option may be used to supply a different file. |
| 34 | | −.I Srv |
| 35 | | −then starts a listener for each service configured in |
| 36 | | −.BR /services/server/config . |
| 37 | | −.PP |
| 38 | | −The configuration file is a text file. |
| 39 | | −Empty lines and lines beginning |
| 40 | | −.B # |
| 41 | | −are comments, and ignored. |
| 42 | | −Each non-comment line has at least four fields: |
| 43 | | −the server type, the service name, the network name on which to announce the service |
| 44 | | −(typically |
| 45 | | −.B tcp |
| 46 | | −or |
| 47 | | −.BR udp ), |
| 48 | | −and the path name of the service command (module). |
| 49 | | −Any further arguments are passed as arguments to that command. |
| 50 | | −.PP |
| 51 | | −Normally the server type field contains the letter |
| 52 | | −.BR S , |
| 53 | | −and |
| 54 | | −.I srv |
| 55 | | −announces the service on the network itself, listens for incoming calls, |
| 56 | | −and on each call invokes the command with any arguments given. |
| 57 | | −The standard input and output of the command are set to refer to the |
| 58 | | −network connection. |
| 59 | | −If the server type field contains the letter |
| 60 | | −.BR M , |
| 61 | | −however, |
| 62 | | −.I srv |
| 63 | | −starts the given command once during its own initialisation, and leaves the server |
| 64 | | −to announce and manage its incoming calls. |
| 65 | | −This is typically used to start self-contained services such as |
| 66 | | −.B bootp |
| 67 | | −and |
| 68 | | −.BR tftpd . |
| 69 | | −The diagnostics from all servers will appear on the standard |
| 70 | | −error of |
| 71 | | −.I srv |
| 72 | | −itself. |
| 73 | | −.PP |
| 74 | | −For example, the default configuration file includes the following lines: |
| 75 | | −.PP |
| 76 | | −.EX |
| 77 | | −.ps -2 |
| 78 | | −S infsigner tcp /dis/auth/signer.dis |
| 79 | | −S infcsigner tcp /dis/auth/countersigner.dis |
| 80 | | −S inflogin tcp /dis/auth/logind.dis |
| 81 | | −S styx tcp /dis/lib/styxd.dis none clear sha md5 rc4 sha/rc4 md5/rc4 |
| 82 | | −S rstyx tcp /dis/lib/rstyxd.dis none clear sha md5 rc4 sha/rc4 md5/rc4 |
| 83 | | −S infdb tcp /dis/lib/dbsrv.dis none clear sha md5 rc4 sha/rc4 md5/rc4 |
| 84 | | −S virgil udp /dis/lib/virgild.dis |
| 85 | | −.ps +2 |
| 86 | | −.EE |
| 87 | | −.PP |
| 88 | | −The arguments to |
| 89 | | −.IR rstyxd |
| 90 | | −and |
| 91 | | −.IR stxyd |
| 92 | | −(see |
| 93 | | −.IR rstyxd (8)), |
| 94 | | −and |
| 95 | | −.IR dbsrv (7) |
| 96 | | −should list the security algorithms supported by the server's |
| 97 | | −.IR ssl (3). |
| 98 | | −.SH FILES |
| 99 | | −.B /services/namespace |
| 100 | | −.br |
| 101 | | −.B /services/server/config |
| 102 | | −.SH SOURCE |
| 103 | | −.B /appl/lib/srv.b |
| 104 | | −.SH SEE ALSO |
| 105 | | −.IR listen (1), |
| 106 | | −.IR services (6), |
| 107 | | −.IR cs (8), |
| 108 | | −.IR dbsrv (7), |
| 109 | | −.IR rstyxd (8), |
| 110 | | −.IR svc (8) |
| 111 | | −.SH BUGS |
| 112 | | −Each service should arguably start in a minimal name space. |