Command line printer manipulation client, and build goo.

[moira.git] / man / addusr.1

diff --git a/man/addusr.1 b/man/addusr.1
index 36206c8d625d43c07d971a7ebc99775f307dac32..198f790efae4efe881824099788b312859258fd2 100644 (file)
--- a/man/addusr.1
+++ b/man/addusr.1
@@ -1,9 +1,9 @@
-.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
@@ -23,7 +23,8 @@ will take up everything but the last two tokens on the line.  If only
 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 is one additional token on
 the end of the line:
@@ -50,8 +51,20 @@ in this invocation.  If not specified, \fI0 (registerable)\fR will be used.
 .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. The users will be left
@@ -70,6 +83,11 @@ users.  Normally \fBaddusr\fR will check the database for users with
 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