USERDEL(1M) Maintenance Commands USERDEL(1M)
userdel - delete a user's login from the system
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: -r
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
If the user's home directory is located on a separate ZFS
system and the /etc/default/useradd
file contains the parameter MANAGE_ZFS
set to the value YES
, the file system will be destroyed.
The following operands are supported: login
An existing login name to be deleted.
The following exit values are returned: 0
Successful completion. 2
Invalid command syntax. A usage message for the userdel
The account to be removed does not exist. 8
The account to be removed is in use. 10
Cannot update the /etc/group
file but the login
is removed from the /etc/passwd
Cannot remove or otherwise modify the home directory.
configuration file for user and role administrative
system password file /etc/shadow
system file containing 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)
utility only deletes an account definition that is in the
, and /etc/user_attr
file. If a network name service is being used to supplement the local /etc/passwd
file with additional entries, userdel
information supplied by the network name service.
January 7, 2018 USERDEL(1M)