1 | .TH STANLEY 1 "25 Sep 2001" "MIT Athena" |
---|
2 | \" RCSID: $Header: /afs/athena.mit.edu/astaff/project/moiradev/repository/moira/man/stanley.1,v 1.5 2007-11-29 22:17:58 zacheiss Exp $ |
---|
3 | .SH NAME |
---|
4 | stanley \- examine and modify information about users in Moira |
---|
5 | .SH SYNOPSIS |
---|
6 | .B stanley username [options] |
---|
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 | |
---|
50 | .IP \fB-mitid\ \fImitid\ \fRor\ \fB-I\ \fImitid\fR |
---|
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-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 | |
---|
69 | .IP \fB-unformatted\ \fRor\ \fB-u\fR |
---|
70 | Display user information with each field on a seperate line, in the |
---|
71 | form "fieldname: value". |
---|
72 | .IP \fB-verbose\ \fRor\ \fB-v\fR |
---|
73 | Give more information. With this flag, stanley will display the |
---|
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. |
---|