Maintenance Commands                                  userdel(1M)

NAME
     userdel - delete a user's login from the system

SYNOPSIS
     userdel  [ -r ] login

DESCRIPTION
     The userdel  utility deletes  a user's login from the system
     and makes the appropriate login-related  changes to the sys-
     tem file and file system.

OPTIONS
     The following options are supported:

     -r        Remove the user's home directory from the  system.
               This  directory  must  exist. The files and direc-
               tories under the home directory will no longer  be
               accessible  following  successful execution of the
               command.

OPERANDS
     The following operands are supported:

     login     An existing login name to be deleted.

EXIT STATUS
     The following exit values are returned:

     0         Success.

     2         Invalid command syntax. A usage  message  for  the
               userdel  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  direc-
               tory.

FILES
     /etc/passwd
               system password file

     /etc/shadow
               system file contain users' encrypted passwords and
               related information

     /etc/group

               system file containing group definitions

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO
     passwd(1),    users(1B),     groupadd(1M),     groupdel(1M),
     groupmod(1M),    logins(1M),    useradd(1M),    usermod(1M),
     passwd(4), attributes(5)

NOTES
     The userdel  utility only deletes a user definition that  is
     in  the  local  /etc/passwd  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.