]>
Commit | Line | Data |
---|---|---|
d91c7811 | 1 | .TH SMSTEST 8 "25 Jan 1988" "Project Athena" |
2 | \" RCSID: $Header$ | |
3 | .SH NAME | |
4 | smstest \- perform SMS operations manually | |
5 | .SH SYNOPSIS | |
6 | .B smstest | |
7 | .SH DESCRIPTION | |
8 | .I smstest | |
9 | allows one to perform by hand all operations allowed in the sms | |
10 | protocol. There are no command line options, as commands are given to | |
11 | a prompt within the program. Control operations are: | |
12 | .TP | |
b3da4492 | 13 | .B connect [server] |
9bfbaa75 | 14 | make a network connection to the SMS server. If no server is |
15 | specified, the default "SMS.MIT.EDU:sms_db" will be used. | |
d91c7811 | 16 | .TP |
17 | .B disconnect | |
18 | break the network connection to the SMS server. | |
19 | .TP | |
227344f4 | 20 | .B new |
21 | specify use of version 2.0 of the protocol. | |
22 | .TP | |
23 | .B old | |
24 | specify use of version 1.0 of the protocol. | |
25 | .TP | |
d91c7811 | 26 | .B script inputfile [outputfile] |
27 | read commands from | |
227344f4 | 28 | .I inputfile. |
29 | If | |
30 | .I outputfile | |
31 | is specified, output will be redirected there while | |
d91c7811 | 32 | commands are read from |
33 | .I inputfile. | |
227344f4 | 34 | The script file may contain comments consisting of lines starting |
35 | with a percent sign. Script files may also recursively perform other | |
36 | script commands up to 8 scripts deep. | |
d91c7811 | 37 | .TP |
38 | .B list_requests | |
39 | lists all of the | |
227344f4 | 40 | .I smstest |
41 | commands. | |
d91c7811 | 42 | .TP |
43 | .B quit | |
44 | exits the program. | |
45 | .PP | |
46 | SMS protocol operations include: | |
47 | .TP | |
48 | .B noop | |
49 | does "no operation" to the server, just making sure the server is | |
50 | still there. | |
51 | .TP | |
52 | .B auth | |
53 | sends | |
54 | .I Kerberos | |
55 | tickets to the server to authenticate the user. | |
56 | .TP | |
57 | .B query query_handle [query arguments ...] | |
58 | performs a query operation on the server. All of the real work is | |
59 | done in queries. There are over 100 queries, each of which requires | |
60 | different arguments. the arguments should be placed on the line | |
61 | following the name of the query, separated by whitespace. | |
62 | .TP | |
b3da4492 | 63 | .B access query_handle [query arguments ...] |
d91c7811 | 64 | performs an authorization check on a query without actually executing |
65 | the query. The arguments are the same as those in the | |
66 | .B query | |
67 | command described above. | |
227344f4 | 68 | .TP |
69 | .B dcm | |
70 | instructs the server to trigger a DCM update immediately. | |
b3da4492 | 71 | .SH BUGS |
72 | Due to problems in the ss library, standard input must be a terminal. | |
73 | If it is a file, only the first line will be read. However, the | |
74 | script command allows one to read input from a file. | |
d91c7811 | 75 | .SH SEE ALSO |
76 | The Project Athena Technical Plan section on SMS for a list of queries | |
b3da4492 | 77 | and their arguments, and a description of the protocol this |
d91c7811 | 78 | implements. |