userdel(1M) SYSTEM ADMINISTRATION COMMANDS userdel(1M)
NAME
userdel - delete a user's login from the system
SYNOPSIS
userdel [-r] login
DESCRIPTION
The userdel command deletes a user's login definition from
the system. It removes the definition of the specified
login and makes the appropriate login-related system file
and file system changes. The command also stores the uid of
the user being deleted in the /etc/security/ia/uidage file,
if uid aging is in effect. The following options are avail-
able:
-r Remove the user's home directory from the system. The
files and directories under the home directory will no
longer be accessible following successful execution of
the command.
login
A string of printable characters that specifies an
existing login on the system. It may not contain a
colon (:), or a newline (\n).
FILES
/etc/passwd, /etc/shadow, /etc/group
/etc/security/ia/index, /etc/security/ia/master,
/etc/security/ia/uidage,
SEE ALSO
groupadd(1M), groupdel(1M), groupmod(1M), logins(1M),
passwd(1), passwd(1M), useradd(1M), usermod(1M), users(1).
DIAGNOSTICS
The userdel command exits with one of the following values:
0 Success.
2 Invalid command syntax. A usage message for the user-
del command is displayed.
6 The login to be removed does not exist.
8 The login to be removed is in use.
10 Cannot update the /etc/group file but the login is
removed from the /etc/passwd file.
12 Cannot remove or otherwise modify the home directory.
1
userdel(1M) SYSTEM ADMINISTRATION COMMANDS userdel(1M)
2