man/mrtest.8

   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 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.