]>
Commit | Line | Data |
---|---|---|
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 | ||
15e9ffdd | 61 | .IP \fB-sponsor\ \fIsponsor\ \fRor\ \fB-sp\ \fIsponsor\fR |
62 | Set the sponsor of the specified user to \fIsponsor\fR. This field is | |
63 | intended to be used for accounts in the GUEST and VOUCH classes. | |
64 | .IP \fB-expiration\ \fIdate\ \fRor\ \fB-e\ \fIdate\fR | |
65 | Set the expiration date for the specified user to \fIdate\fR. This | |
66 | field is intended to be used for accounts in the GUEST and VOUCH | |
67 | classes. | |
68 | ||
0b681a26 | 69 | .IP \fB-unformatted\ \fRor\ \fB-u\fR |
a10b28ee | 70 | Display user information with each field on a seperate line, in the |
0b681a26 | 71 | form "fieldname: value". |
72 | .IP \fB-verbose\ \fRor\ \fB-v\fR | |
7b7cc074 | 73 | Give more information. With this flag, stanley will display the |
0b681a26 | 74 | queries it is making to the moira server. |
75 | .IP \fB-noauth\ \fRor\ \fB-n\fR | |
76 | Do not attempt to perform Kerberos authentication with the Moira server. | |
77 | Most lookup operations should be still possible without tickets. | |
78 | .IP \fB-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR | |
79 | Use the specified host and port to contact the Moira database instead of | |
80 | the default server. Both may be symbolic names or numbers. If the | |
81 | port is left off, the default Moira server port will be assumed. The | |
82 | database chosen will be the one specified on the command line, specified | |
83 | in the MOIRASERVER environment variable, the hesiod "moira" sloc entry, | |
84 | or the compiled in default, in that order or preference. | |
85 | ||
86 | .IP \fB-create\ \fRor\ \fB-C\fR | |
87 | This will create the specified user, with information provided by other | |
88 | options. By default, the user will be be status 0, and will be assigned | |
89 | a unique username and uid, and will not require an Account Coupon to register. | |
90 | .IP \fB-deact\ \fRor\ \fB-D\fR | |
91 | This will deactivate the specified user, as well as the matching list | |
92 | and filesystem, assuming they exist. | |
93 | .IP \fB-rename\ \fInewname\ \fRor\ \fB-R\ \fInewname\fR | |
94 | This will rename the given user to \fInewname\fR. | |
95 | .IP \fB-register\ \fRor\ \fB-r\fR | |
96 | This will register the specified username, creating a filesystem and | |
97 | assigning a PO Box. It will not create a Kerberos principal. A status | |
98 | 0 user will be status 2 after having been registered in this way, and | |
99 | the user will still need to use the registration applet to set an | |
100 | initial password. Status 6 users will be status 1 and have full Athena | |
101 | accounts after being registered. | |
102 | ||
103 | .SH AUTHORS | |
104 | Garry Zacheiss, MIT Information Systems. | |
105 | .SH SEE ALSO | |
106 | moira(1) | |
107 | ||
108 | .SH DIAGNOSTICS | |
109 | An exit status of 2 indicates a problem contacting the server. An exit | |
110 | status of 1 indicates that the arguments could not be parsed or some | |
111 | query to the moira server returned an error. An exit status of 0 | |
112 | indicates that all operations requested completed successfully. | |
113 | ||
114 | .SH NOTES | |
115 | The username doesn't actually have to be the first argument, but if | |
116 | you put it anywhere else, it's easy to get the other arguments in the | |
117 | wrong order and do something other than what you intended. |