-.TH SMS 1 "29 Nov 1988" "Project Athena"
+.TH MOIRA 1 "29 Nov 1988" "Project Athena"
\" RCSID: $Header$
.SH NAME
-sms, listmaint, usermaint, dcmmaint \- maintain information stored in SMS
+moira, listmaint, usermaint, dcmmaint \- maintain information stored in moira
.SH SYNOPSIS
-.B sms
+.B moira
[
.BI \-nomenu
+|
+.BI \-menu
+] [
+.BI \-db
+.I host:port
]
.SH DESCRIPTION
-.I sms
-administers all of the information stored in the SMS database. When
-invoked by the name
+.I Moira
+administers all of the information stored in Moira, the Athena Service
+Management System database. When invoked by the name
.B listmaint, usermaint,
or
.B dcmmaint,
-.I sms
+.I moira
will immediately drop into the appropriate sub-menu.
-There is only one option:
+
+It a database is specified on the command line, that server will be
+contacted rather than the compiled-in default. The host and port may
+both be symbolic names or numbers. If the port is not specified, the
+default Moira server port will be used. The server chosen will be the
+one specified on the command line, from the environment variable
+MOIRASERVER, from the "moira" sloc entry in hesiod, or the compiled in
+default, in that order of preference.
+
+The option:
.TP
.BI \-nomenu
-Do not take over the screen. With this option specified, the screen
+will cause moira to not take over the screen. With this option
+specified, the screen
will be handled like a printing terminal. Each menu will be displayed
only once. Typing '?' will cause a menu to be redisplayed.
.PP
When called without options,
-.I sms
+.I moira
displays a menu in the top half of the screen listing other menus;
retrievals, appends, updates, or
deletes to the database; or control actions within the program.
arguments may be put on the same line -- otherwise, they will be
prompted for. It is possible to invoke an option from a sub-menu by
name while at a higher menu. The lower half of the screen is a
-dialoge area used to prompt the user and display retrieved information.
+dialogue area used to prompt the user and display retrieved information.
.PP
The top level menu just lists other menus for each of the types of
objects stored in the database. Most menus also list the following
control options:
.TP
.B verbose
-Toggle the verosity of delete. This controls whether or not an extra
+Toggle the verbosity of delete. This controls whether or not an extra
confirmation will be required before deleting data from the database.
.TP
.B return
.B toggle
Toggle logging on and off. When logging is turned on, all output in
the lower half of the screen will also be written to
-.I /usr/tmp/sms-log.XXXX,
-where XXXX is the process-ID of the sms client.
+.I /var/tmp/moira-log.XXXX,
+where XXXX is the process-ID of the moira client.
.TP
.B quit
-Exits the sms client immediately. The connection to the SMS server
+Exits the moira client immediately. The connection to the Moira server
will be closed.
.SH DIAGNOSTICS
Pay attention to Kerberos diagnostics, as one must be authenticated to
-do most SMS database work.
+do most Moira database work.
.PP
As this is a database manipulation application, diagnostics indicate an
incomplete argument list, an attempt to modify/delete an ambiguous
.SH ENVIRONMENT
.TP
KRBTKFILE
-path name of your Kerberos ticket. SMS decides who you are and what you
+path name of your Kerberos ticket. Moira decides who you are and what you
can do based on your Kerberos tickets, and nothing else.
.TP
TERMCAP
Jean Marie Diaz, Mark Roman, Chris Peterson, Mark Rosenstein and a
cast of thousands
.SH "SEE ALSO"
-chfn(1), chpobox(1), chsh(1), mailmaint(1), smslist(1),
-SMS section of the Project Athena Technical Plan
-.SH NOTES
-SMS is Project Athena's Service Management System.
+chfn(1), chpobox(1), chsh(1), mailmaint(1), blanche(1),
+Moira section of the Project Athena Technical Plan