| 7b7cc074 |
1 | .TH STANLEY 1 "25 Sep 2001" "MIT Athena" |
| 0b681a26 |
2 | \" RCSID: $Header$ |
| 3 | .SH NAME |
| 4 | stanley \- examine and modify information about users in Moira |
| 5 | .SH SYNOPSIS |
| a10b28ee |
6 | .B stanley username [options] |
| 0b681a26 |
7 | .SH DESCRIPTION |
| 8 | .I Stanley |
| 9 | is a tool for updating information about users in Moira. It supports |
| 10 | all user modification commands and a few options to change user |
| 11 | reservations. |
| 12 | |
| 13 | If no options are specified, it will assume \fI-info\fR, which will |
| 14 | result in all information about the specified user being displayed. |
| 15 | |
| 16 | .SH OPTIONS |
| 17 | |
| 18 | .IP \fB-info\ \fRor\ \fB-i\fR |
| 19 | Display information about a user. This is the default mode if no other |
| 20 | options are given. The output is similar to that of moira. |
| 21 | |
| 22 | .IP \fB-addreservation\ \fIreservation\ \fRor\ \fB-ar\ \fIreservation\fR |
| 23 | This will add the reservation \fIreservation\fR for the user. This |
| 24 | option can be specified multiple times with different reservations |
| 25 | on the same command line. |
| 26 | .IP \fB-deletereservation\ \fIreservation\ \fRor\ \fB-dr\ \fIreservation\fR |
| 27 | This will remove the reservation \fIreservation\fR for the given user. This |
| 28 | option can be specified multiple times with different reservations |
| 29 | on the same command line. |
| 30 | |
| 31 | .IP \fB-listreservation\ \fRor\ \fB-lr\fR |
| 32 | This will list reservations for the specified user. |
| 33 | |
| 34 | .IP \fB-uid\ \fIuid\ \fRor\ \fB-u\ \fIuid\fR |
| 35 | Update the uid field for the specified user to \fIuid\fR. |
| 36 | .IP \fB-shell\ \fIshell\ \fRor\ \fB-s\ \fIshell\fR |
| 37 | Update the shell field for the specified user to \fIshell\fR. |
| 38 | .IP \fB-winshell\ \fIwinshell\ \fRor\ \fB-w\ \fIwinshell\fR |
| 39 | Update the winshell field for the specified user to \fIwinshell\fR. |
| 40 | .IP \fB-status\ \fIstatus\ \fRor\ \fB-S\ \fIstatus\fR |
| 41 | Update the status field for the specified user to \fIstatus\fR. |
| 42 | |
| 43 | .IP \fB-first\ \fIfirstname\ \fRor\ \fB-F\ \fIfirstname\fR |
| 44 | Change the first name of the given user to \fIfirstname\fR. |
| 45 | .IP \fB-last\ \fIlastname\ \fRor\ \fB-L\ \fIlastname\fR |
| 46 | Change the last name of the given user to \fIlastname\fR. |
| 47 | .IP \fB-middle\ \fImiddlename\ \fRor\ \fB-M\ \fImiddlename\fR |
| 48 | Change the middle name of the given user to \fImiddlename\fR. |
| 49 | |
| 484f87be |
50 | .IP \fB-mitid\ \fImitid\ \fRor\ \fB-I\ \fImitid\fR |
| 0b681a26 |
51 | Change the MIT ID number of the given user to \fImitid\fR. |
| 52 | .IP \fB-class\ \fIclass\ \fRor\ \fB-cl\ \fIclass\fR |
| 53 | Change the class of the given user to \fIclass\fR. |
| 54 | .IP \fB-comment\ \fIcomment\ \fRor\ \fB-c\ \fIcomment\fR |
| 55 | Update the comment for the given user to \fIcomment\fR. |
| 56 | |
| 57 | .IP \fB-secure\ \fI0|1\ \fRor\ \fB-6\ \fI0|1\fR |
| 58 | Change whether a user requires a secure Account Coupon to register for |
| 59 | an account. |
| 60 | |
| 61 | .IP \fB-unformatted\ \fRor\ \fB-u\fR |
| a10b28ee |
62 | Display user information with each field on a seperate line, in the |
| 0b681a26 |
63 | form "fieldname: value". |
| 64 | .IP \fB-verbose\ \fRor\ \fB-v\fR |
| 7b7cc074 |
65 | Give more information. With this flag, stanley will display the |
| 0b681a26 |
66 | queries it is making to the moira server. |
| 67 | .IP \fB-noauth\ \fRor\ \fB-n\fR |
| 68 | Do not attempt to perform Kerberos authentication with the Moira server. |
| 69 | Most lookup operations should be still possible without tickets. |
| 70 | .IP \fB-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR |
| 71 | Use the specified host and port to contact the Moira database instead of |
| 72 | the default server. Both may be symbolic names or numbers. If the |
| 73 | port is left off, the default Moira server port will be assumed. The |
| 74 | database chosen will be the one specified on the command line, specified |
| 75 | in the MOIRASERVER environment variable, the hesiod "moira" sloc entry, |
| 76 | or the compiled in default, in that order or preference. |
| 77 | |
| 78 | .IP \fB-create\ \fRor\ \fB-C\fR |
| 79 | This will create the specified user, with information provided by other |
| 80 | options. By default, the user will be be status 0, and will be assigned |
| 81 | a unique username and uid, and will not require an Account Coupon to register. |
| 82 | .IP \fB-deact\ \fRor\ \fB-D\fR |
| 83 | This will deactivate the specified user, as well as the matching list |
| 84 | and filesystem, assuming they exist. |
| 85 | .IP \fB-rename\ \fInewname\ \fRor\ \fB-R\ \fInewname\fR |
| 86 | This will rename the given user to \fInewname\fR. |
| 87 | .IP \fB-register\ \fRor\ \fB-r\fR |
| 88 | This will register the specified username, creating a filesystem and |
| 89 | assigning a PO Box. It will not create a Kerberos principal. A status |
| 90 | 0 user will be status 2 after having been registered in this way, and |
| 91 | the user will still need to use the registration applet to set an |
| 92 | initial password. Status 6 users will be status 1 and have full Athena |
| 93 | accounts after being registered. |
| 94 | |
| 95 | .SH AUTHORS |
| 96 | Garry Zacheiss, MIT Information Systems. |
| 97 | .SH SEE ALSO |
| 98 | moira(1) |
| 99 | |
| 100 | .SH DIAGNOSTICS |
| 101 | An exit status of 2 indicates a problem contacting the server. An exit |
| 102 | status of 1 indicates that the arguments could not be parsed or some |
| 103 | query to the moira server returned an error. An exit status of 0 |
| 104 | indicates that all operations requested completed successfully. |
| 105 | |
| 106 | .SH NOTES |
| 107 | The username doesn't actually have to be the first argument, but if |
| 108 | you put it anywhere else, it's easy to get the other arguments in the |
| 109 | wrong order and do something other than what you intended. |
andersk / moira.git / blame