USERDEL(1M) Maintenance Commands USERDEL(1M)

NAME

userdel - delete a user's login from the system

SYNOPSIS


userdel [-r [-z|-Z]] login
 

DESCRIPTION

The userdel utility deletes a user account from the system and makes the appropriate account-related changes to the system file and file system.

OPTIONS

The following options are supported:
 
-r [-z|-Z]
Remove the user's home directory from the system. This directory must exist. The files and directories under the home directory will no longer be accessible following successful execution of the command. CHANGE_ZFS_FS option in /etc/default/useradd file determines if ZFS filesystem underlying user home directory will be destroyed. If user's home directory is a ZFS file system and CHANGE_ZFS_FS option is set to yes, the filesystem will be destroyed. -z and -Z options allow overwrite default behavior. If -z option is specified, userdel tries to destroy file system. If -Z option is specified, file system is not destroyed.
 

OPERANDS

The following operands are supported:
 
login
An existing login name to be deleted.
 

EXIT STATUS

The following exit values are returned:
 
0
Successful completion.
 
 
2
Invalid command syntax. A usage message for the userdel command is displayed.
 
 
6
The account to be removed does not exist.
 
 
8
The account to be removed is in use.
 
 
10
Cannot update the /etc/group or /etc/user_attr file but the login is removed from the /etc/passwd file.
 
 
12
Cannot remove or otherwise modify the home directory.
 

FILES

/etc/default/useradd
useradd, usermod and userdel configuration file
 
 
/etc/passwd
system password file
 
 
/etc/shadow
system file contain users' encrypted passwords and related information
 
 
/etc/group
system file containing group definitions
 
 
/etc/user_attr
system file containing additional user attributes
 

SEE ALSO

auths(1), passwd(1), profiles(1), roles(1), users(1B), groupadd(1M), groupdel(1M), groupmod(1M), logins(1M), roleadd(1M), rolemod(1M), useradd(1M), userdel(1M), usermod(1M), passwd(4), prof_attr(4), user_attr(4), attributes(5)

NOTES

The userdel utility only deletes an account definition that is in the local /etc/group, /etc/passwd, /etc/shadow, and /etc/user_attr file. file. If a network name service such as NIS or NIS+ is being used to supplement the local /etc/passwd file with additional entries, userdel cannot change information supplied by the network name service.
September 8, 1999