[23095] | 1 | .TH MRTEST 8 "25 Jan 1988" "Project Athena" |
---|
[24319] | 2 | \" RCSID: $HeadURL: svn+ssh://svn.mit.edu/moira/trunk/moira/man/mrtest.8 $ $Id: mrtest.8 3956 2010-01-05 20:56:56Z zacheiss $ |
---|
[23095] | 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 script inputfile [outputfile] |
---|
| 30 | read commands from |
---|
| 31 | .I inputfile. |
---|
| 32 | If |
---|
| 33 | .I outputfile |
---|
| 34 | is specified, output will be redirected there while |
---|
| 35 | commands are read from |
---|
| 36 | .I inputfile. |
---|
| 37 | The script file may contain comments consisting of lines starting |
---|
| 38 | with a percent sign. Script files may also recursively perform other |
---|
| 39 | script commands up to 8 scripts deep. |
---|
| 40 | .TP |
---|
| 41 | .B list_requests |
---|
| 42 | lists all of the |
---|
| 43 | .I mrtest |
---|
| 44 | commands. |
---|
| 45 | .TP |
---|
| 46 | .B quit |
---|
| 47 | exits the program. |
---|
| 48 | .PP |
---|
| 49 | Moira protocol operations include: |
---|
| 50 | .TP |
---|
| 51 | .B noop |
---|
| 52 | does "no operation" to the server, just making sure the server is |
---|
| 53 | still there. |
---|
| 54 | .TP |
---|
| 55 | .B auth |
---|
| 56 | sends |
---|
| 57 | .I Kerberos |
---|
| 58 | tickets to the server to authenticate the user. |
---|
| 59 | .TP |
---|
| 60 | .B motd |
---|
| 61 | gets the current message of the day from the server. |
---|
| 62 | .TP |
---|
| 63 | .B query query_handle [query arguments ...] |
---|
| 64 | performs a query operation on the server. All of the real work is |
---|
| 65 | done in queries. There are over 100 queries, each of which requires |
---|
| 66 | different arguments. the arguments should be placed on the line |
---|
| 67 | following the name of the query, separated by whitespace. |
---|
| 68 | .TP |
---|
| 69 | .B access query_handle [query arguments ...] |
---|
| 70 | performs an authorization check on a query without actually executing |
---|
| 71 | the query. The arguments are the same as those in the |
---|
| 72 | .B query |
---|
| 73 | command described above. |
---|
| 74 | .SH SEE ALSO |
---|
| 75 | The Project Athena Technical Plan section on Moira for a list of queries |
---|
| 76 | and their arguments, and a description of the protocol this |
---|
| 77 | implements. |
---|