System Administration Commands                        userdel(1M)

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

SYNOPSIS
     userdel [-r] 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       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        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  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 defini-
                             tions



     /etc/user_attr          system  file  containing  additional
                             user attributes



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|


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), attri-
     butes(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.