2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
2007-11-11 22:54:56 +00:00
|
|
|
uss_delete - Deletes a user account
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
=for html
|
|
|
|
<div class="synopsis">
|
|
|
|
|
|
|
|
B<uss delete> S<<< B<-user> <I<login name>> >>>
|
|
|
|
S<<< [B<-mountpoint> <I<mountpoint for user's volume>>] >>>
|
|
|
|
[B<-savevolume>] [B<-verbose>] S<<< [B<-cell> <I<cell name>>] >>>
|
|
|
|
S<<< [B<-admin> <I<administrator to authenticate>>] >>> [B<-dryrun>]
|
2005-12-13 19:21:13 +00:00
|
|
|
[B<-skipauth>] [B<-help>]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2006-03-01 05:02:29 +00:00
|
|
|
B<uss d> S<<< B<-u> <I<login name>> >>> S<<< [B<-m> <I<mountpoint for user's volume>>] >>>
|
|
|
|
[B<-sa>] [B<-v>] S<<< [B<-c> <I<cell name>>] >>>
|
|
|
|
S<<< [B<-a> <I<administrator to authenticate>>] >>> [B<-d>] [B<-sk>] [B<-h>]
|
|
|
|
|
|
|
|
=for html
|
|
|
|
</div>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<uss delete> command removes the Authentication Database and
|
|
|
|
Protection Database entries for the user named by B<-user> argument. In
|
|
|
|
addition, it can remove the user's home volume and associated VLDB entry,
|
|
|
|
a mount point for the volume or both, depending on whether the
|
|
|
|
B<-mountpoint> and B<-savevolume> options are provided.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
To remove both the volume and mount point, use the B<-mountpoint> argument
|
|
|
|
to name the user's home directory. It is best to create a tape backup of a
|
|
|
|
volume before deleting it. Note that other mount points for the volume are
|
|
|
|
not removed, if they exist.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
To remove the mount point only, provide both the B<-mountpoint> and
|
|
|
|
B<-savevolume> options.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=item *
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
To preserve both the volume and mount point, omit the B<-mountpoint>
|
|
|
|
argument (or both it and the B<-savevolume> flag).
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-user> <I<login name>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Names the entry to delete from the Protection and Authentication
|
|
|
|
Databases.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-mountpoint> <I<mountpoint for the user's volume>>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Specifies the pathname to the user's home directory, which is deleted from
|
|
|
|
the filespace. By default, the volume referenced by the mount point is
|
|
|
|
also removed from the file server machine that houses it, along with its
|
|
|
|
Volume Location Database (VLDB) entry. To retain the volume and VLDB
|
|
|
|
entry, include the B<-savevolume> flag. Partial pathnames are interpreted
|
|
|
|
relative to the current working directory.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Specify the read/write path to the mount point, to avoid the failure that
|
|
|
|
results from attempting to remove a mount point from a read-only
|
|
|
|
volume. By convention, the read/write path is indicated by placing a
|
|
|
|
period before the cell name at the pathname's second level (for example,
|
2005-12-13 19:21:13 +00:00
|
|
|
F</afs/.abc.com>). For further discussion of the concept of read/write and
|
|
|
|
read-only paths through the filespace, see the B<fs mkmount> reference
|
|
|
|
page.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-savevolume>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Preserves the user's volume and VLDB entry.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-verbose>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
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.
|
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
|
|
|
Specifies the cell in which to run the command. For more details, see
|
|
|
|
L<uss(8)>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
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 authenticated
|
2005-12-13 19:21:13 +00:00
|
|
|
connections to the AFS server processes that maintain the various
|
|
|
|
components of a user account. For more details, see L<uss(8)>.
|
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 while
|
2005-12-13 19:21:13 +00:00
|
|
|
executing the command, without actually performing them. For more details,
|
|
|
|
see L<uss(8)>.
|
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
|
|
|
|
|
|
|
Prevents authentication with the AFS Authentication Server, allowing a
|
|
|
|
site using Kerberos to substitute that form of authentication.
|
|
|
|
|
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 the online help for this command. All other valid options are
|
|
|
|
ignored.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The following command removes smith's user account from the C<abc.com>
|
|
|
|
cell. The B<-savevolume> argument retains the C<user.smith> volume on its
|
|
|
|
file server machine.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
% uss delete smith -mountpoint /afs/abc.com/usr/smith -savevolume
|
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The issuer (or the user named by B<-admin> argument) must belong to the
|
|
|
|
system:administrators group in the Protection Database, must have the
|
|
|
|
C<ADMIN> flag turned on in his or her Authentication Database entry, and
|
|
|
|
must have at least C<a> (administer) and C<d> (delete) permissions on the
|
|
|
|
access control list (ACL) of the mount point's parent directory. If the
|
|
|
|
B<-savevolume> flag is not included, the issuer must also be listed in the
|
|
|
|
F</usr/afs/etc/UserList> file.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
L<UserList(5)>,
|
2005-12-08 12:14:33 +00:00
|
|
|
L<fs_mkmount(1)>,
|
2005-12-13 19:21:13 +00:00
|
|
|
L<uss(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.
|