]>
Commit | Line | Data |
---|---|---|
5834a392 | 1 | .TH SMSD 8 "30 Nov 1988" "Project Athena" |
2 | \" RCSID: $Header$ | |
3 | .SH NAME | |
2ba19438 | 4 | smsd, startsms \- SMS query daemon |
5834a392 | 5 | .SH SYNOPSIS |
6 | .B smsd | |
7 | .br | |
8 | .B startsms | |
9 | .SH DESCRIPTION | |
10 | The SMS server | |
11 | must be running on the machine hosting the SMS database for any of the | |
12 | SMS clients to function. Rather than invoke | |
13 | .B smsd | |
14 | directly, it is started by | |
15 | .B startsms, | |
16 | which starts the daemon running in the proper working directory and | |
17 | captures logging messages. | |
18 | .PP | |
19 | Logging is done to standard output. | |
20 | How much gets logged by | |
21 | .B smsd | |
22 | is controlled by the variable | |
23 | .I log_flags | |
24 | which is compiled into the file | |
25 | .I sms_srvdata.c. | |
26 | If critical errors are detected, they are logged to | |
27 | .B /u1/sms/critical.log | |
28 | and in a zephyrgram to class | |
29 | .B SMS | |
30 | instance | |
31 | .B SMS | |
32 | in addition to standard output. | |
33 | Also, a journal file is kept in | |
34 | .B /u1/sms/journal | |
35 | logging every successful change of the database in a format that can | |
36 | be replayed by | |
37 | .I smstest(8). | |
38 | For the server to be able to function properly, if must be run as root | |
39 | and root must have access to the tables through RTI Ingres. | |
40 | .PP | |
00f3d199 | 41 | It is possible to shutdown the database side of the server when it is |
42 | necessary to lock out clients. In this state the server will only | |
43 | respond to noop and motd requests. When the file | |
44 | .B /etc/smsdown | |
45 | exists, the server will close the database the next time there are no | |
46 | clients using it. To force the server to close down the database as | |
47 | soon as any active operation is finished, send it a USR1 signal. The | |
48 | first time a new client connects after the | |
49 | .B /etc/smsdown | |
50 | file is removed, the database will be re-opened. To force an | |
51 | immediate reopening, send the server a USR2 signal. The contents of | |
52 | the | |
53 | .B /etc/smsdown | |
54 | file are returned as the SMS motd. | |
55 | .PP | |
5834a392 | 56 | .B startsms |
57 | sets its working directory to the root, disconnects from the terminal | |
58 | and puts itself in the background. It then starts | |
59 | .B /u1/sms/bin/smsd, | |
60 | and will capture lines the server writes to standard output and log them | |
61 | in | |
62 | .B /u1/sms/sms.log | |
63 | along with a timestamp. | |
64 | .B startsms | |
65 | will also log the exit status of the | |
66 | .B smsd | |
67 | if it is non-zero. | |
68 | .SH FILES | |
69 | /u1/sms/sms.log | |
70 | .br | |
71 | /u1/sms/critical.log | |
72 | .br | |
73 | /u1/sms/journal | |
74 | .br | |
00f3d199 | 75 | /etc/smsdown |
76 | .br | |
5834a392 | 77 | /etc/srvtab \- The dcm must be able to get Kerberos tickets for "sms.sms". |
78 | .SH "SEE ALSO" | |
79 | The Project Athena Technical Plan section on SMS. |