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