]>
Commit | Line | Data |
---|---|---|
1 | .TH ADDUSR 1 "6 Jul 1992" "Project Athena" | |
2 | \" RCSID: $Header$ | |
3 | .SH NAME | |
4 | addusr \- add and/or register users in Moira | |
5 | .SH SYNOPSIS | |
6 | .B addusr [-cCdfhrRsSv] | |
7 | .SH DESCRIPTION | |
8 | .I Addusr | |
9 | is a tool for adding users in bulk to the moira database and | |
10 | registering them for accounts. It reads the users from a file (or | |
11 | stdin) rather than the menu-oriented regular moira client. | |
12 | ||
13 | The users are entered in one of two formats, depending on whether or | |
14 | not they will be registered. When users are only being added to the | |
15 | database, the format is: | |
16 | .nf | |
17 | lastname, firstname middlename idnumber | |
18 | .fi | |
19 | The lastname may have spaces in it, as it will continue up until the | |
20 | first comma on the line. The firstname also may have spaces, as it | |
21 | will take up everything but the last two tokens on the line. If only | |
22 | 3 tokens are on the line, the middlename will be assumed to be the | |
23 | empty string. The middlename cannot have spaces in it. The idnumber | |
24 | also cannot have spaces, although it may have hyphens in it. The | |
25 | capitalization of the names is not important as it will be corrected | |
26 | before entering into the database. If the operation specified for | |
27 | .B addusr | |
28 | includes registering users, then there are two additional tokens on | |
29 | the end of the line: | |
30 | .nf | |
31 | lastname, firstname middlename idnumber loginname password | |
32 | .fi | |
33 | Note that neither the loginname nor the password may contain spaces. | |
34 | .SH OPTIONS | |
35 | .IP \fB-file\ \fIfilename\ \fRor\ \fB-f\ \fIfilename\fR: | |
36 | This specifies the file that will be read for the list of users to | |
37 | operate on. If not specifed, standard input will be used. The file | |
38 | format is described above. | |
39 | .IP \fB-class\ \fIclass\ \fRor\ \fB-c\ \fIclass\fR: | |
40 | This specifies the account class that will be used for all users added | |
41 | in this invocation. If not specified, \fITEMP\fR will be used. | |
42 | .IP \fB-comment\ \fI"comment"\ \fRor\ \fB-C\ \fI"comment"\fR: | |
43 | This specifies the comment that will be stored for all users added | |
44 | in this invocation. If not specified, the comment field will be left | |
45 | blank. Note that the double-quotes are not required by \fBaddusr\fR, | |
46 | but will be parsed out by the shell and are only needed to specify | |
47 | comments with spaces in them. | |
48 | .IP \fB-status\ \fIstatus\ \fRor\ \fB-s\ \fIstatus\fR: | |
49 | This specifies the account status that will be used for all users added | |
50 | in this invocation. If not specified, \fI0 (registerable)\fR will be used. | |
51 | .IP \fB-shell\ \fIshell\ \fRor\ \fB-h\ \fIshell\fR: | |
52 | This specifies the login shell that will be stored for all users added | |
53 | in this invocation. If not specified, \fI/bin/csh\fR will be used. | |
54 | .IP \fB-register\ \fRor\ \fB-R\fR: | |
55 | This instructs \fBaddusr\fR to both add the users to the database and | |
56 | then to immediately register them. | |
57 | .IP \fB-reg_only\ \fRor\ \fB-r\fR: | |
58 | This instructs \fBaddusr\fR to register the users without attempting | |
59 | to add them to the database. They must already exist in the database. | |
60 | .IP \fB-verbose\ \fRor\ \fB-v\fR: | |
61 | This causes \fBaddusr\fR to print messages about each operation as it | |
62 | performs it. | |
63 | .IP \fB-nodupcheck\ \fRor\ \fB-d\fR: | |
64 | Do not attempt to check the database for duplicates before adding | |
65 | users. Normally \fBaddusr\fR will check the database for users with | |
66 | the same name. If it finds any who match in both name and ID number, | |
67 | the user will not be added. If it finds a name match with a different | |
68 | ID number, it will print a warning and add the user anyway. | |
69 | .IP \fB-server\ \fIhost:port\ \fRor\ \fB-S\ \fIhost:port\fR: | |
70 | Use the specified host and port to contact the Moira server instead of | |
71 | the default server. Both may be symbolic names or numbers. If the | |
72 | port is left off, the default Moira server port will be assumed. The | |
73 | server chosen will be the one specified on the command line, specified | |
74 | in the MOIRASERVER environment variable, the hesiod "moira" sloc entry, | |
75 | or the compiled in default, in that order or preference. | |
76 | ||
77 | .SH AUTHOR | |
78 | Mark Rosenstein | |
79 | .SH SEE ALSO | |
80 | moira(1), userreg(1) |