NAME userdel - delete a user's login from the system
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.
The following options are supported:
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.
The following operands are supported:
An existing login name to be deleted.
The following exit values are returned:
Invalid command syntax. A usage message for the userdel command is displayed.
The account to be removed does not exist.
The account to be removed is in use.
Cannot update the /etc/group or /etc/user_attr file but the login is removed from the /etc/passwd file.
Cannot remove or otherwise modify the home directory.
useradd, usermod and userdel configuration file
system password file
system file contain users' encrypted passwords and related information
system file containing group definitions
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.