.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.20) .\" .\" 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_DELETE 8" .TH USS_DELETE 8 "2021-12-09" "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_delete \- Deletes a user account (deprecated) .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBuss delete\fR \fB\-user\fR\ <\fIlogin\ name\fR> [\fB\-mountpoint\fR\ <\fImountpoint\ for\ user's\ volume\fR>] [\fB\-savevolume\fR] [\fB\-verbose\fR] [\fB\-cell\fR\ <\fIcell\ name\fR>] [\fB\-admin\fR\ <\fIadministrator\ to\ authenticate\fR>] [\fB\-dryrun\fR] [\fB\-skipauth\fR] [\fB\-help\fR] .PP \&\fBuss d\fR \fB\-u\fR\ <\fIlogin\ name\fR> [\fB\-m\fR\ <\fImountpoint\ for\ user's\ volume\fR>] [\fB\-sa\fR] [\fB\-v\fR] [\fB\-c\fR\ <\fIcell\ name\fR>] [\fB\-a\fR\ <\fIadministrator\ to\ authenticate\fR>] [\fB\-d\fR] [\fB\-sk\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 delete\fR command removes the Authentication Database and Protection Database entries for the user named by \fB\-user\fR argument. In addition, it can remove the user's home volume and associated \s-1VLDB\s0 entry, a mount point for the volume or both, depending on whether the \&\fB\-mountpoint\fR and \fB\-savevolume\fR options are provided. .IP "\(bu" 4 To remove both the volume and mount point, use the \fB\-mountpoint\fR 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. .IP "\(bu" 4 To remove the mount point only, provide both the \fB\-mountpoint\fR and \&\fB\-savevolume\fR options. .IP "\(bu" 4 To preserve both the volume and mount point, omit the \fB\-mountpoint\fR argument (or both it and the \fB\-savevolume\fR flag). .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-user\fR <\fIlogin name\fR>" 4 .IX Item "-user " Names the entry to delete from the Protection and Authentication Databases. .IP "\fB\-mountpoint\fR <\fImountpoint for the user's volume\fR>" 4 .IX 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 (\s-1VLDB\s0) entry. To retain the volume and \s-1VLDB\s0 entry, include the \fB\-savevolume\fR flag. Partial pathnames are interpreted relative to the current working directory. .Sp 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, \&\fI/afs/.example.com\fR). For further discussion of the concept of read/write and read-only paths through the filespace, see the \fBfs mkmount\fR reference page. .IP "\fB\-savevolume\fR" 4 .IX Item "-savevolume" Preserves the user's volume and \s-1VLDB\s0 entry. .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 " 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 " 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\-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 command removes smith's user account from the \f(CW\*(C`example.com\*(C'\fR cell. The \fB\-savevolume\fR argument retains the \f(CW\*(C`user.smith\*(C'\fR volume on its file server machine. .PP .Vb 1 \& % uss delete smith \-mountpoint /afs/example.com/usr/smith \-savevolume .Ve .SH "PRIVILEGE REQUIRED" .IX Header "PRIVILEGE REQUIRED" The issuer (or the user named by \fB\-admin\fR argument) must belong to the system:administrators group in the Protection Database, must have the \&\f(CW\*(C`ADMIN\*(C'\fR flag turned on in his or her Authentication Database entry, and must have at least \f(CW\*(C`a\*(C'\fR (administer) and \f(CW\*(C`d\*(C'\fR (delete) permissions on the access control list (\s-1ACL\s0) of the mount point's parent directory. If the \&\fB\-savevolume\fR flag is not included, the issuer must also be listed in the \&\fI/usr/afs/etc/UserList\fR file. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIUserList\fR\|(5), \&\fIfs_mkmount\fR\|(1), \&\fIuss\fR\|(8) .SH "COPYRIGHT" .IX Header "COPYRIGHT" \&\s-1IBM\s0 Corporation 2000. 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.