added motd

[moira.git] / man / mrtest.8

diff --git a/man/mrtest.8 b/man/mrtest.8
index e2f53a11f8cc7c44d284d7872fe34bf6e2257778..9ac8fab9b3f3c968b6198b6c3a7eed923589354d 100644 (file)
--- a/man/mrtest.8
+++ b/man/mrtest.8
@@ -1,36 +1,58 @@
-.TH SMSTEST 8 "25 Jan 1988" "Project Athena"
+.TH MRTEST 8 "25 Jan 1988" "Project Athena"
 \" RCSID: $Header$
 .SH NAME
-smstest \- perform SMS operations manually
+mrtest \- perform Moira operations manually
 .SH SYNOPSIS
-.B smstest
+.B mrtest
 .SH DESCRIPTION
-.I smstest
-allows one to perform by hand all operations allowed in the sms
+.I mrtest
+allows one to perform by hand all operations allowed in the Moira
 protocol.  There are no command line options, as commands are given to
 a prompt within the program.  Control operations are:
 .TP
-.B connnect
-make a network connection to the SMS server.
+.B connect [server]
+make a network connection to the Moira server.  The server
+specification is optional.  If present, it is of the form
+hostname:portname.  The portname is optional as well, and if specified
+will be looked up in
+.B /etc/services.
+If no server is specified, then the server will be found from the
+MOIRASERVER environment variable, the "moira" sloc entry in hesiod, or
+the compiled in default, in that order.
 .TP
 .B disconnect
-break the network connection to the SMS server.
+break the network connection to the Moira server.
+.TP
+.B host
+show the name of the host the client is connected to.
+.TP
+.B new
+specify use of version 2.0 of the protocol.
+.TP
+.B old
+specify use of version 1.0 of the protocol.
 .TP
 .B script inputfile [outputfile]
 read commands from 
-.I inputfile.  If
-.I outputfile is specified, output will be redirected there while
+.I inputfile.
+If
+.I outputfile
+is specified, output will be redirected there while
 commands are read from
 .I inputfile.
+The script file may contain comments consisting of lines starting
+with a percent sign.  Script files may also recursively perform other
+script commands up to 8 scripts deep.
 .TP
 .B list_requests
 lists all of the 
-.I smstest commands.
+.I mrtest
+commands.
 .TP
 .B quit
 exits the program.
 .PP
-SMS protocol operations include:
+Moira protocol operations include:
 .TP
 .B noop
 does "no operation" to the server, just making sure the server is
@@ -41,20 +63,28 @@ sends
 .I Kerberos
 tickets to the server to authenticate the user.
 .TP
+.B motd
+gets the current message of the day from the server.
+.TP
 .B query query_handle [query arguments ...]
 performs a query operation on the server.  All of the real work is
 done in queries.  There are over 100 queries, each of which requires
 different arguments.  the arguments should be placed on the line
 following the name of the query, separated by whitespace.
 .TP
-.B access query_handle [query arguements ...]
+.B access query_handle [query arguments ...]
 performs an authorization check on a query without actually executing
 the query.  The arguments are the same as those in the
 .B query
 command described above.
+.TP
+.B dcm
+instructs the server to trigger a DCM update immediately.
 .SH BUGS
-There is no way to enter whitespace into a string argument to a query.
+Due to problems in the ss library, standard input must be a terminal.
+If it is a file, only the first line will be read.  However, the
+script command allows one to read input from a file.
 .SH SEE ALSO
-The Project Athena Technical Plan section on SMS for a list of queries
-and their arguements, and a description of the protocol this
+The Project Athena Technical Plan section on Moira for a list of queries
+and their arguments, and a description of the protocol this
 implements.