| @@ -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. | | |