shadow/man/userdel.8

.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "USERDEL" 8 "" "" ""
.SH NAME
userdel \- Delete a user account and related files
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 8
\fBuserdel\fR [\-r] \fIlogin\fR
.ad
.hy

.SH "DESCRIPTION"

.PP
The \fBuserdel\fR command modifies the system account files, deleting all entries that refer to \fIlogin\fR\&. The named user must exist\&.

.SH "OPTIONS"

.PP
The options which apply to the \fBuserdel\fR command are:

.TP
\fB\-r\fR
Files in the user's home directory will be removed along with the home directory itself and the user's mail spool\&. Files located in other file systems will have to be searched for and deleted manually\&.

.SH "FILES"

.TP
\fI/etc/group\fR
group account information
.TP
\fI/etc/passwd\fR
user account information
.TP
\fI/etc/shadow\fR
secure user account information
.SH "EXIT VALUES"

.PP
The \fBuserdel\fR command exits with the following values: 

.TP
\fI0\fR
success
.TP
\fI1\fR
can't update password file
.TP
\fI2\fR
invalid command syntax
.TP
\fI6\fR
specified user doesn't exist
.TP
\fI8\fR
user currently logged in
.TP
\fI10\fR
can't update group file
.TP
\fI12\fR
can't remove home directory 

.SH "CAVEATS"

.PP
\fBuserdel\fR will not allow you to remove an account if the user is currently logged in\&. You must kill any running processes which belong to an account that you are deleting\&. You may not remove any NIS attributes on an NIS client\&. This must be performed on the NIS server\&.

.SH "SEE ALSO"

.PP
\fBchfn\fR(1), \fBchsh\fR(1), \fBpasswd\fR(1), \fBgpasswd\fR(8), \fBgroupadd\fR(8), \fBgroupdel\fR(8), \fBgroupmod\fR(8), \fBuseradd\fR(8), \fBusermod\fR(8) 

.SH "AUTHOR"

.PP
Julianne Frances Haugh (jockgrrl@ix\&.netcom\&.com)