2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
|
|
|
uss - Introduction to the uss command suite
|
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The commands in the B<uss> command suite help administrators to create AFS
|
|
|
|
user accounts more easily and efficiently. If B<uss> commands are not
|
|
|
|
used, creating an account requires issuing at least six separate commands
|
|
|
|
to five different AFS servers.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
There are three main commands in the suite:
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<uss add> command creates a single complete user account, based on
|
|
|
|
command line arguments and instructions in a template file.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<uss bulk> command creates multiple complete accounts at once, based
|
|
|
|
on command line arguments, instructions in a template file and a bulk
|
|
|
|
input file.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<uss delete> command removes most parts of a user account.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
To obtain help, issue the B<uss apropos> and B<uss help> commands.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
The following arguments and flags are available on many commands in the
|
2005-12-13 19:21:13 +00:00
|
|
|
B<uss> suite. The reference page for each command also lists them, but
|
|
|
|
they are described here in greater detail.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-admin> <I<administrator to authenticate>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Specifies the AFS user name under which to establish a connection to the
|
|
|
|
AFS server processes that administer the various parts of a user
|
|
|
|
account. If it is omitted, the connection is established under the
|
|
|
|
issuer's effective user ID (his or her identity in the local file
|
|
|
|
system). Even when this argument is included, UNIX commands that run
|
2005-12-13 19:21:13 +00:00
|
|
|
during the B<uss> operation (for instance, the UNIX F</etc/chown> command)
|
|
|
|
run under the effective user ID.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-cell> <I<cell name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Names the cell in which to run the command. It is acceptable to abbreviate
|
|
|
|
the cell name to the shortest form that distinguishes it from the other
|
|
|
|
entries in the F</usr/vice/etc/CellServDB> file on the local machine. If
|
|
|
|
the B<-cell> argument is omitted, the command interpreter determines the
|
|
|
|
name of the local cell by reading the following in order:
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=over 4
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item *
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The value of the AFSCELL environment variable.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The local F</usr/vice/etc/ThisCell> file.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=back
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-dryrun>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Reports actions that the command interpreter needs to perform when
|
2005-12-13 19:21:13 +00:00
|
|
|
executing the B<uss> operation, without actually performing them. Include
|
|
|
|
this flag to verify that the command produces the desired account
|
|
|
|
configuration. Combine it with the B<-verbose> flag to yield even more
|
|
|
|
detailed information. Note that the output does not necessarily reveal all
|
|
|
|
possible problems that can prevent successful execution of the command,
|
|
|
|
especially those that result from transient server or network outages.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-help>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Prints a command's online help message on the standard output stream. Do
|
|
|
|
not combine this flag with any of the command's other options; when it is
|
|
|
|
provided, the command interpreter ignores all other options, and only
|
|
|
|
prints the help message.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-skipauth>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Bypasses mutual authentication with the AFS Authentication Server,
|
2005-12-13 19:21:13 +00:00
|
|
|
allowing a site that uses Kerberos instead of the AFS Authentication
|
|
|
|
Server to substitute that form of authentication.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The issuer of a B<uss> command must have all the rights required for
|
|
|
|
performing the equivalent actions individually. See each B<uss> command's
|
|
|
|
reference page.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
L<uss(5)>,
|
|
|
|
L<uss_bulk(5)>,
|
|
|
|
L<uss_add(8)>,
|
|
|
|
L<uss_apropos(8)>,
|
|
|
|
L<uss_bulk(8)>,
|
|
|
|
L<uss_delete(8)>,
|
|
|
|
L<uss_help(8)>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|