man/mrtest.8

   1 .TH SMSTEST 8 "25 Jan 1988" "Project Athena"
   2 \" RCSID: $Header$
   3 .SH NAME
   4 smstest \- perform SMS operations manually
   5 .SH SYNOPSIS
   6 .B smstest
   7 .SH DESCRIPTION
   8 .I smstest
   9 allows one to perform by hand all operations allowed in the sms
  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 SMS server.  If no server is
  15 specified, the default "SMS.MIT.EDU:sms_db" will be used.
  16 .TP
  17 .B disconnect
  18 break the network connection to the SMS server.
  19 .TP
  20 .B new
  21 specify use of version 2.0 of the protocol.
  22 .TP
  23 .B old
  24 specify use of version 1.0 of the protocol.
  25 .TP
  26 .B script inputfile [outputfile]
  27 read commands from
  28 .I inputfile.
  29 If
  30 .I outputfile
  31 is specified, output will be redirected there while
  32 commands are read from
  33 .I inputfile.
  34 The script file may contain comments consisting of lines starting
  35 with a percent sign.  Script files may also recursively perform other
  36 script commands up to 8 scripts deep.
  37 .TP
  38 .B list_requests
  39 lists all of the
  40 .I smstest
  41 commands.
  42 .TP
  43 .B quit
  44 exits the program.
  45 .PP
  46 SMS protocol operations include:
  47 .TP
  48 .B noop
  49 does "no operation" to the server, just making sure the server is
  50 still there.
  51 .TP
  52 .B auth
  53 sends
  54 .I Kerberos
  55 tickets to the server to authenticate the user.
  56 .TP
  57 .B query query_handle [query arguments ...]
  58 performs a query operation on the server.  All of the real work is
  59 done in queries.  There are over 100 queries, each of which requires
  60 different arguments.  the arguments should be placed on the line
  61 following the name of the query, separated by whitespace.
  62 .TP
  63 .B access query_handle [query arguments ...]
  64 performs an authorization check on a query without actually executing
  65 the query.  The arguments are the same as those in the
  66 .B query
  67 command described above.
  68 .TP
  69 .B dcm
  70 instructs the server to trigger a DCM update immediately.
  71 .SH BUGS
  72 Due to problems in the ss library, standard input must be a terminal.
  73 If it is a file, only the first line will be read.  However, the
  74 script command allows one to read input from a file.
  75 .SH SEE ALSO
  76 The Project Athena Technical Plan section on SMS for a list of queries
  77 and their arguments, and a description of the protocol this
  78 implements.