| 1 | .TH MRTEST 8 "25 Jan 1988" "Project Athena" |
|---|
| 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 $ |
|---|
| 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. |
|---|
