userdel(1M)                                                     userdel(1M)


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

   SYNOPSIS
         userdel [-r] login

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

         The following options are available:

         -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 command.

         login A string of printable characters that specifies an existing
               login on the system.  It may not contain a colon (:), or a
               newline (\n).

   FILES
         /etc/passwd
         /etc/shadow
         /etc/group
         /etc/security/ia/index
         /etc/security/ia/master
         /etc/security/ia/uidage

   SEE ALSO
         groupadd(1M), groupdel(1M), groupmod(1M), logins(1M), passwd(1),
         passwd(1M), useradd(1M), usermod(1M), users(1).

   DIAGNOSTICS
         The userdel command exits with one of the following values:

         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.





   8/91                                                                 Page 1

   userdel(1M)                                                     userdel(1M)


         12    Cannot remove or otherwise modify the home directory.




















































   Page 2                                                                 8/91