userdel - delete a user's login from the system
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:
The following operands 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.
If the user's home directory is located on a separate ZFS
file system and the /etc/default/useradd file contains the parameter
MANAGE_ZFS set to the value YES, the file system will be
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
Cannot remove or otherwise modify the home
configuration file for user and role administrative
system password file
system file containing users' encrypted passwords and
system file containing group definitions
system file containing additional user attributes
auths(1), passwd(1), profiles(1), roles(1),
passwd(5), prof_attr(5), user_attr(5),
attributes(7), groupadd(8), groupdel(8),
groupmod(8), logins(8), roleadd(8), roledel(8),
rolemod(8), useradd(8), usermod(8), zfs(8)
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 is being used to
supplement the local /etc/passwd file with additional entries,
userdel cannot change information supplied by the network name service.