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 host
  21 show the name of the host the client is connected to.
  22 .TP
  23 .B new
  24 specify use of version 2.0 of the protocol.
  25 .TP
  26 .B old
  27 specify use of version 1.0 of the protocol.
  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 smstest
  44 commands.
  45 .TP
  46 .B quit
  47 exits the program.
  48 .PP
  49 SMS 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 query query_handle [query arguments ...]
  61 performs a query operation on the server.  All of the real work is
  62 done in queries.  There are over 100 queries, each of which requires
  63 different arguments.  the arguments should be placed on the line
  64 following the name of the query, separated by whitespace.
  65 .TP
  66 .B access query_handle [query arguments ...]
  67 performs an authorization check on a query without actually executing
  68 the query.  The arguments are the same as those in the
  69 .B query
  70 command described above.
  71 .TP
  72 .B dcm
  73 instructs the server to trigger a DCM update immediately.
  74 .SH BUGS
  75 Due to problems in the ss library, standard input must be a terminal.
  76 If it is a file, only the first line will be read.  However, the
  77 script command allows one to read input from a file.
  78 .SH SEE ALSO
  79 The Project Athena Technical Plan section on SMS for a list of queries
  80 and their arguments, and a description of the protocol this
  81 implements.