man/moira.1

   1 .TH MOIRA 1 "29 Nov 1988" "Project Athena"
   2 \" RCSID: $Header$
   3 .SH NAME
   4 moira, listmaint, usermaint, dcmmaint \- maintain information stored in moira
   5 .SH SYNOPSIS
   6 .B moira
   7 [
   8 .BI \-nomenu
   9 ] [
  10 .BI \-db
  11 .I host:port
  12 ]
  13 .SH DESCRIPTION
  14 .I Moira
  15 administers all of the information stored in Moira, the Athena Service
  16 Management System database.  When invoked by the name
  17 .B listmaint, usermaint,
  18 or
  19 .B dcmmaint,
  20 .I moira
  21 will immediately drop into the appropriate sub-menu.
  22 It a database is specified on the command line, that server will be
  23 contacted rather than the compiled-in default.  The host and port may
  24 both be symbolic names or numbers.
  25 The option:
  26 .TP
  27 .BI \-nomenu
  28 will cause moira to not take over the screen.  With this option
  29 specified, the screen
  30 will be handled like a printing terminal.  Each menu will be displayed
  31 only once.  Typing '?' will cause a menu to be redisplayed.
  32 .PP
  33 When called without options,
  34 .I moira
  35 displays a menu in the top half of the screen listing other menus;
  36 retrievals, appends, updates, or
  37 deletes to the database; or control actions within the program.
  38 Each menu consists of several lines containing a single character
  39 (usually a numeral), a keyword, and a short description.  Menu items
  40 may be selected by either the single character or the keyword.  Needed
  41 arguments may be put on the same line -- otherwise, they will be
  42 prompted for.  It is possible to invoke an option from a sub-menu by
  43 name while at a higher menu.  The lower half of the screen is a
  44 dialogue area used to prompt the user and display retrieved information.
  45 .PP
  46 The top level menu just lists other menus for each of the types of
  47 objects stored in the database.  Most menus also list the following
  48 control options:
  49 .TP
  50 .B verbose
  51 Toggle the verbosity of delete.  This controls whether or not an extra
  52 confirmation will be required before deleting data from the database.
  53 .TP
  54 .B return
  55 Return to the menu above this one in the menu tree.
  56 .TP
  57 .B toggle
  58 Toggle logging on and off.  When logging is turned on, all output in
  59 the lower half of the screen will also be written to
  60 .I /usr/tmp/sms-log.XXXX,
  61 where XXXX is the process-ID of the moira client.
  62 .TP
  63 .B quit
  64 Exits the moira client immediately.  The connection to the Moira server
  65 will be closed.
  66 .SH DIAGNOSTICS
  67 Pay attention to Kerberos diagnostics, as one must be authenticated to
  68 do most Moira database work.
  69 .PP
  70 As this is a database manipulation application, diagnostics indicate an
  71 incomplete argument list, an attempt to modify/delete an ambiguous
  72 entry, or an invalid menu choice.
  73 .SH ENVIRONMENT
  74 .TP
  75 KRBTKFILE
  76 path name of your Kerberos ticket.  Moira decides who you are and what you
  77 can do based on your Kerberos tickets, and nothing else.
  78 .TP
  79 TERMCAP
  80 used by curses to control of scrolling and menu display.
  81 .SH AUTHOR
  82 Jean Marie Diaz, Mark Roman, Chris Peterson, Mark Rosenstein and a
  83 cast of thousands
  84 .SH "SEE ALSO"
  85 chfn(1), chpobox(1), chsh(1), mailmaint(1), mrlist(1),
  86 Moira section of the Project Athena Technical Plan
  87 .SH NOTES
  88 Moira was previously called SMS, and some places still refer to it by
  89 this name.