| | 1 | .TH MRTEST 8 "25 Jan 1988" "Project Athena" |
| | 2 | \" RCSID: $Header$ |
| | 3 | .SH NAME |
| | 4 | mrtest \- perform Moira operations manually |
| | 5 | .SH SYNOPSIS |
| | 6 | .B mrtest |
| | 7 | .SH DESCRIPTION |
| | 8 | .I mrtest |
| | 9 | allows one to perform by hand all operations allowed in the Moira |
| | 10 | protocol. There are no command line options, as commands are given to |
| | 11 | a prompt within the program. Control operations are: |
| | 12 | .TP |
| | 13 | .B connect [server] |
| | 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. |
| | 22 | .TP |
| | 23 | .B disconnect |
| | 24 | break the network connection to the Moira server. |
| | 25 | .TP |
| | 26 | .B host |
| | 27 | show the name of the host the client is connected to. |
| | 28 | .TP |
| | 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 |
| | 35 | .B script inputfile [outputfile] |
| | 36 | read commands from |
| | 37 | .I inputfile. |
| | 38 | If |
| | 39 | .I outputfile |
| | 40 | is specified, output will be redirected there while |
| | 41 | commands are read from |
| | 42 | .I inputfile. |
| | 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. |
| | 46 | .TP |
| | 47 | .B list_requests |
| | 48 | lists all of the |
| | 49 | .I mrtest |
| | 50 | commands. |
| | 51 | .TP |
| | 52 | .B quit |
| | 53 | exits the program. |
| | 54 | .PP |
| | 55 | Moira protocol operations include: |
| | 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 |
| | 66 | .B motd |
| | 67 | gets the current message of the day from the server. |
| | 68 | .TP |
| | 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 |
| | 75 | .B access query_handle [query arguments ...] |
| | 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. |
| | 80 | .TP |
| | 81 | .B dcm |
| | 82 | instructs the server to trigger a DCM update immediately. |
| | 83 | .SH BUGS |
| | 84 | Due to problems in the ss library, standard input must be a terminal. |
| | 85 | If it is a file, only the first line will be read. However, the |
| | 86 | script command allows one to read input from a file. |
| | 87 | .SH SEE ALSO |
| | 88 | The Project Athena Technical Plan section on Moira for a list of queries |
| | 89 | and their arguments, and a description of the protocol this |
| | 90 | implements. |
andersk / moira.git / blame_incremental