X-Git-Url: http://andersk.mit.edu/gitweb/moira.git/blobdiff_plain/9bfbaa75cb6aaa1159989e369a1103c1c92e680b..dcfa270ac1d2f55eb793c4da4bbd555903a88b09:/man/mrtest.8 diff --git a/man/mrtest.8 b/man/mrtest.8 index 45d13dac..9ac8fab9 100644 --- a/man/mrtest.8 +++ b/man/mrtest.8 @@ -1,21 +1,30 @@ -.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 [server] -make a network connection to the SMS server. If no server is -specified, the default "SMS.MIT.EDU:sms_db" will be used. +.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. @@ -37,13 +46,13 @@ script commands up to 8 scripts deep. .TP .B list_requests lists all of the -.I smstest +.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 @@ -54,13 +63,16 @@ 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 @@ -68,7 +80,11 @@ command described above. .TP .B dcm instructs the server to trigger a DCM update immediately. +.SH BUGS +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.