]>
Commit | Line | Data |
---|---|---|
b5d539b4 | 1 | .TH MRTEST 8 "25 Jan 1988" "Project Athena" |
d91c7811 | 2 | \" RCSID: $Header$ |
3 | .SH NAME | |
b5d539b4 | 4 | mrtest \- perform Moira operations manually |
d91c7811 | 5 | .SH SYNOPSIS |
b5d539b4 | 6 | .B mrtest |
d91c7811 | 7 | .SH DESCRIPTION |
b5d539b4 | 8 | .I mrtest |
9 | allows one to perform by hand all operations allowed in the Moira | |
d91c7811 | 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] |
b5d539b4 | 14 | make a network connection to the Moira server. The server |
15 | specification is optional. If present, it is of the form | |
16 | hostname:portname. The portname is optional as well, and if specified | |
17 | will be looked up in | |
18 | .B /etc/services. | |
19 | If no server is specified, then the server will be found from the | |
20 | MOIRASERVER environment variable, the "moira" sloc entry in hesiod, or | |
21 | the compiled in default, in that order. | |
d91c7811 | 22 | .TP |
23 | .B disconnect | |
b5d539b4 | 24 | break the network connection to the Moira server. |
d91c7811 | 25 | .TP |
1e56b68c | 26 | .B host |
27 | show the name of the host the client is connected to. | |
28 | .TP | |
227344f4 | 29 | .B new |
30 | specify use of version 2.0 of the protocol. | |
31 | .TP | |
32 | .B old | |
33 | specify use of version 1.0 of the protocol. | |
34 | .TP | |
d91c7811 | 35 | .B script inputfile [outputfile] |
36 | read commands from | |
227344f4 | 37 | .I inputfile. |
38 | If | |
39 | .I outputfile | |
40 | is specified, output will be redirected there while | |
d91c7811 | 41 | commands are read from |
42 | .I inputfile. | |
227344f4 | 43 | The script file may contain comments consisting of lines starting |
44 | with a percent sign. Script files may also recursively perform other | |
45 | script commands up to 8 scripts deep. | |
d91c7811 | 46 | .TP |
47 | .B list_requests | |
48 | lists all of the | |
b5d539b4 | 49 | .I mrtest |
227344f4 | 50 | commands. |
d91c7811 | 51 | .TP |
52 | .B quit | |
53 | exits the program. | |
54 | .PP | |
b5d539b4 | 55 | Moira protocol operations include: |
d91c7811 | 56 | .TP |
57 | .B noop | |
58 | does "no operation" to the server, just making sure the server is | |
59 | still there. | |
60 | .TP | |
61 | .B auth | |
62 | sends | |
63 | .I Kerberos | |
64 | tickets to the server to authenticate the user. | |
65 | .TP | |
7ba00193 | 66 | .B motd |
67 | gets the current message of the day from the server. | |
68 | .TP | |
d91c7811 | 69 | .B query query_handle [query arguments ...] |
70 | performs a query operation on the server. All of the real work is | |
71 | done in queries. There are over 100 queries, each of which requires | |
72 | different arguments. the arguments should be placed on the line | |
73 | following the name of the query, separated by whitespace. | |
74 | .TP | |
b3da4492 | 75 | .B access query_handle [query arguments ...] |
d91c7811 | 76 | performs an authorization check on a query without actually executing |
77 | the query. The arguments are the same as those in the | |
78 | .B query | |
79 | command described above. | |
227344f4 | 80 | .TP |
81 | .B dcm | |
82 | instructs the server to trigger a DCM update immediately. | |
d91c7811 | 83 | .SH SEE ALSO |
b5d539b4 | 84 | The Project Athena Technical Plan section on Moira for a list of queries |
b3da4492 | 85 | and their arguments, and a description of the protocol this |
d91c7811 | 86 | implements. |