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