.\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "USS_BULK 8"
.TH USS_BULK 8 "2012-01-23" "OpenAFS" "AFS Command Reference"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
uss_bulk \- Executes multiple uss commands listed in a file (deprecated)
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBuss bulk\fR \fB\-file\fR\ <\fIbulk\ input\ file\fR>
    [\fB\-template\fR\ <\fIpathname\ of\ template\ file\fR>] [\fB\-verbose\fR]
    [\fB\-cell\fR\ <\fIcell\ name\fR>]
    [\fB\-admin\fR\ <\fIadministrator\ to\ authenticate\fR>] [\fB\-dryrun\fR]
    [\fB\-skipauth\fR] [\fB\-overwrite\fR]
    [\fB\-pwexpires\fR <\fIpassword expires in [0..254] days (0 =\fR never)>>]
    [\fB\-pipe\fR] [\fB\-help\fR]
.PP
\&\fBuss b\fR \fB\-f\fR\ <\fIbulk\ input\ file\fR> [\fB\-t\fR\ <\fIpathname\ of\ template\ file\fR>]
    [\fB\-v\fR] [\fB\-c\fR\ <\fIcell\ name\fR>]
    [\fB\-a\fR\ <\fIadministrator\ to\ authenticate\fR>] [\fB\-d\fR] [\fB\-s\fR]
    [\fB\-o\fR] [\fB\-pw\fR <\fIpassword expires in [0..254] days (0 =\fR never)>>]
    [\fB\-pi\fR] [\fB\-h\fR]
.SH "CAUTIONS"
.IX Header "CAUTIONS"
The \fBuss\fR command suite is currently designed for cells using the
obsolete Authentication Server, and therefore is primarily useful for
sites that have not yet migrated to a Kerberos version 5 \s-1KDC\s0. The
Authentication Server and supporting commands will be removed in a future
version of OpenAFS, which may include \fBuss\fR unless someone who finds it
useful converts it to work with a Kerberos version 5 \s-1KDC\s0.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \fBuss bulk\fR command executes the uss commands listed in the \fIbulk
input file\fR specified with the \fB\-file\fR argument. If the bulk input file
includes \fBadd\fR instructions that reference a template file, then the
\&\fB\-template\fR argument is required.
.PP
To create a single account, use the \fBuss add\fR command. To delete one or
more accounts, use the \fBuss delete\fR command.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-file\fR <\fIbulk input file\fR>" 4
.IX Item "-file <bulk input file>"
Specifies the pathname of the bulk input file. Partial pathnames are
interpreted relative to the current working directory. For details on the
file's format, see \fIuss_bulk\fR\|(5).
.IP "\fB\-template\fR <\fIpathname of template file\fR>" 4
.IX Item "-template <pathname of template file>"
Specifies the pathname of the template file for any uss add commands that
appear in the bulk input file. Partial pathnames are interpreted relative
to the current working directory. For details on the file's format, see
\&\fIuss\fR\|(5).
.IP "\fB\-verbose\fR" 4
.IX Item "-verbose"
Produces on the standard output stream a detailed trace of the command's
execution. If this argument is omitted, only warnings and error messages
appear.
.IP "\fB\-cell\fR <\fIcell name\fR>" 4
.IX Item "-cell <cell name>"
Specifies the cell in which to run the command. For more details, see
\&\fIuss\fR\|(8).
.IP "\fB\-admin\fR <\fIadministrator to authenticate\fR>" 4
.IX Item "-admin <administrator to authenticate>"
Specifies the \s-1AFS\s0 user name under which to establish authenticated
connections to the \s-1AFS\s0 server processes that maintain the various
components of a user account. For more details, see \fIuss\fR\|(8).
.IP "\fB\-dryrun\fR" 4
.IX Item "-dryrun"
Reports actions that the command interpreter needs to perform while
executing the command, without actually performing them. For more details,
see \fIuss\fR\|(8).
.IP "\fB\-skipauth\fR" 4
.IX Item "-skipauth"
Prevents authentication with the \s-1AFS\s0 Authentication Server, allowing a
site using Kerberos to substitute that form of authentication.
.IP "\fB\-overwrite\fR" 4
.IX Item "-overwrite"
Overwrites any directories, files and links that exist in the file system
and for which there are also \f(CW\*(C`D\*(C'\fR, \f(CW\*(C`E\*(C'\fR, \f(CW\*(C`F\*(C'\fR, \f(CW\*(C`L\*(C'\fR, or \f(CW\*(C`S\*(C'\fR instructions
in a template file referenced by an \f(CW\*(C`add\*(C'\fR instruction in the bulk input
file. If this flag is omitted, the command interpreter prompts, once for
each \f(CW\*(C`add\*(C'\fR instruction in the bulk input file, for confirmation that it
should overwrite such elements. Do not include this flag if the bulk input
file does not contain \f(CW\*(C`add\*(C'\fR instructions.
.IP "\fB\-pwexpires\fR <\fIpassword expiration\fR>" 4
.IX Item "-pwexpires <password expiration>"
Sets the number of days after a user's password is changed that it remains
valid, for each user named by an \f(CW\*(C`add\*(C'\fR instruction in the bulk input
file. Provide an integer from the range \f(CW1\fR through \f(CW254\fR to specify the
number of days until expiration, or the value \f(CW0\fR to indicate that the
password never expires (the default).
.Sp
When the password becomes invalid (expires), the user is unable to
authenticate, but has 30 more days in which to issue the \fBkpasswd\fR
command to change the password (after that, only an administrator can
change it).
.IP "\fB\-pipe\fR" 4
.IX Item "-pipe"
Suppresses the Authentication Server's prompt for the password of the
issuer or the user named by the \fB\-admin\fR argument (the Authentication
Server always separately authenticates the creator of an entry in the
Authentication Database). Instead, the command interpreter accepts the
password via the standard input stream, as piped in from another
program. This enables the \fBuss bulk\fR command to run as part of unattended
batch jobs.
.IP "\fB\-help\fR" 4
.IX Item "-help"
Prints the online help for this command. All other valid options are
ignored.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
The following example command executes the instructions in the bulk input
file called \fInew_students\fR, which includes \f(CW\*(C`add\*(C'\fR instructions that refer
to the template file \fIstudent.template\fR. Both files reside in the current
working directory.
.PP
.Vb 1
\&   % uss bulk new_students student.template
.Ve
.SH "PRIVILEGE REQUIRED"
.IX Header "PRIVILEGE REQUIRED"
The issuer (or the user named by the \fB\-admin\fR argument) must have the
privileges necessary to run the commands that correspond to instructions
in the bulk input file.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIuss\fR\|(5),
\&\fIuss_bulk\fR\|(5),
\&\fIuss\fR\|(8),
\&\fIuss_add\fR\|(8),
\&\fIuss_delete\fR\|(8)
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
\&\s-1IBM\s0 Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
.PP
This documentation is covered by the \s-1IBM\s0 Public License Version 1.0.  It was
converted from \s-1HTML\s0 to \s-1POD\s0 by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.