-.TH ADDUSR 1 "12 Jan 1996" "Project Athena"
+.TH ADDUSR 1 "29 Nov 2007" "Project Athena"
\" RCSID: $Header$
.SH NAME
addusr \- add and/or register users in Moira
.SH SYNOPSIS
-.B addusr [-cCdfhrRsSv6]
+.B addusr [options]
.SH DESCRIPTION
.I Addusr
is a tool for adding users in bulk to the moira database and
empty string. The middlename cannot have spaces in it. The idnumber
also cannot have spaces, although it may have hyphens in it. The
capitalization of the names is not important as it will be corrected
-before entering into the database. If the operation specified for
+before entering into the database, unless the \fB-n\fR flag has been
+specified. If the operation specified for
.B addusr
-includes registering users, then there are two additional tokens on
+includes registering users, then there is one additional token on
the end of the line:
.nf
- lastname, firstname middlename idnumber loginname password
+ lastname, firstname middlename idnumber loginname
.fi
-Note that neither the loginname nor the password may contain spaces.
.SH OPTIONS
.IP \fB-file\ \fIfilename\ \fRor\ \fB-f\ \fIfilename\fR:
This specifies the file that will be read for the list of users to
.IP \fB-shell\ \fIshell\ \fRor\ \fB-h\ \fIshell\fR:
This specifies the login shell that will be stored for all users added
in this invocation. If not specified, a default will be used. At MIT
-Athena the default is \fI/bin/athena/tcsh\fR, elsewhere it is likely to be
-\fI/bin/csh\fR.
+Athena the default is \fI/bin/athena/bash\fR, elsewhere it is likely to be
+\fI/bin/bash\fR.
+.IP \fB-winshell\ \fIshell\ \fRor\ \fB-w\ \fIshell\fR:
+This specifies the Windows console shell that will be used for all users
+added in this invocation. If not specified, a default value of
+\fIcmd\fR will be used.
+.IP \fB-sponsor\ \fIsponsor\ \fRor\ \fB-sp\ \fIsponsor\fR:
+This specifies the USER, LIST, or KERBEROS that will be listed as the
+sponsor for all users added in this invocation. This is intended for
+use with accounts in the GUEST and VOUCH classes.
+.IP \fB-expiration\ \fIdate\ \fRor\ \fB-e\ \fIdate\fR:
+This specified the expiration date that will be recorded for all users
+added in this invocation. This is intended for use with accounts in the
+GUEST or VOUCH classes.
.IP \fB-register\ \fRor\ \fB-R\fR:
This instructs \fBaddusr\fR to both add the users to the database and
-then to immediately register them.
+then to immediately register them. The users will be left
+"half-registered", meaning that they have everything but a Kerberos
+principal.
.IP \fB-reg_only\ \fRor\ \fB-r\fR:
-This instructs \fBaddusr\fR to register the users without attempting
-to add them to the database. They must already exist in the database.
+This instructs \fBaddusr\fR to (half-) register the users without
+attempting to add them to the database. They must already exist in the
+database.
.IP \fB-verbose\ \fRor\ \fB-v\fR:
This causes \fBaddusr\fR to print messages about each operation as it
performs it.
the same name. If it finds any who match in both name and ID number,
the user will not be added. If it finds a name match with a different
ID number, it will print a warning and add the user anyway.
+.IP \fB-nocaps\ \fRor\ \fB-n\fR:
+Do not attempt to normalize the capitalization of first, middle, and
+last names before adding users. Normally, \fBaddusr\fR will update the
+capitalization of names based on a set of heuristics. This flag can be
+used to suppress this behavior if it is inappropriate for certain names.
.IP \fB-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR:
Use the specified host and port to contact the Moira server instead of
the default server. Both may be symbolic names or numbers. If the
andersk / moira.git / blobdiff