mirror of
https://git.openafs.org/openafs.git
synced 2025-01-19 07:20:11 +00:00
e3dfba8e6c
This is the initial conversion of the AFS Adminstrators Reference into POD for use as man pages. The man pages are now generated via pod2man from regen.sh so that only those working from CVS have to have pod2man available. The Makefile only installs. The pages have also been sorted out into pod1, pod5, and pod8 directories, making conversion to the right section of man page easier without maintaining a separate list and allowing for names to be duplicated between pod5 and pod1 or pod8 (which will likely be needed in a few cases). This reconversion is done with a new script based on work by Chas Williams. In some cases, the output is worse than the previous POD pages, but this is a more comprehensive conversion. This is only the first step, and this initial conversion has various problems. In addition, the file man pages that didn't have simple names have not been converted in this pass and will be added later. Some of the man pages have syntax problems and all of them have formatting errors. The next editing pass, coming shortly, will clean up most of the remaining mess.
149 lines
4.4 KiB
Plaintext
149 lines
4.4 KiB
Plaintext
=head1 NAME
|
|
|
|
uss delete - Deletes a user account
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<uss delete -user> <I<login name>> [-mountpoint <I<mountpoint for user's volume>>]
|
|
[B<-savevolume>] [B<-verbose>] [B<-cell> <I<cell name>>]
|
|
[B<-admin> <I<administrator to authenticate>>] [-dryrun]
|
|
[B<-skipauth>] [-help]
|
|
|
|
B<uss d -u> <I<login name>> [B<-m> <I<mountpoint for user's volume>>] [B<-sa>] [-v]
|
|
[B<-c> <I<cell name>>] B<-a> <I<administrator to authenticate>>]
|
|
[B<-d>] [B<-sk>] [-h]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
The 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.
|
|
|
|
=over 4
|
|
|
|
=item *
|
|
|
|
To remove both the volume and mount point, use the -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.
|
|
|
|
|
|
=item *
|
|
|
|
To remove the mount point only, provide both the -mountpoint
|
|
and B<-savevolume> options.
|
|
|
|
|
|
=item *
|
|
|
|
To preserve both the volume and mount point, omit the
|
|
B<-mountpoint> argument (or both it and the B<-savevolume>
|
|
flag).
|
|
|
|
|
|
=back
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 4
|
|
|
|
=item -user
|
|
|
|
Names the entry to delete from the Protection and Authentication
|
|
Databases.
|
|
|
|
=item -mountpoint
|
|
|
|
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.
|
|
|
|
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,
|
|
B</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.
|
|
|
|
=item -savevolume
|
|
|
|
Preserves the user's volume and VLDB entry.
|
|
|
|
=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.
|
|
|
|
=item -cell
|
|
|
|
Specifies the cell in which to run the command. For more details,
|
|
see the introductory B<uss> reference page.
|
|
|
|
=item -admin
|
|
|
|
Specifies the AFS user name under which to establish authenticated
|
|
connections to the AFS server processes that maintain the various components
|
|
of a user account. For more details, see the introductory
|
|
B<uss> reference page.
|
|
|
|
=item -dryrun
|
|
|
|
Reports actions that the command interpreter needs to perform while
|
|
executing the command, without actually performing them. For more
|
|
details, see the introductory B<uss> reference page.
|
|
|
|
=item -skipauth
|
|
|
|
Prevents authentication with the AFS Authentication Server, allowing a
|
|
site using Kerberos to substitute that form of authentication.
|
|
|
|
=item -help
|
|
|
|
Prints the online help for this command. All other valid options
|
|
are ignored.
|
|
|
|
=back
|
|
|
|
=head1 EXAMPLES
|
|
|
|
The following command removes smith's user account from the
|
|
B<abc.com> cell. The B<-savevolume> argument
|
|
retains the C<user.smith> volume on its file server
|
|
machine.
|
|
|
|
% uss delete smith -mountpoint /afs/abc.com/usr/smith -savevolume
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
The issuer (or the user named by -admin argument) must belong to
|
|
the B<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 B<a> (B<administer>)
|
|
and B<d> (B<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 B</usr/afs/etc/UserList> file.
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<UserList(1)>,
|
|
L<fs_mkmount(1)>,
|
|
L<uss(1)>
|
|
|
|
=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.
|