Maintenance Commands                                  userdel(1M)

NAME
     userdel, roledel - delete a user's or role's login from the system	  |

SYNOPSIS
     userdel [ -r ] login
     roledel [ -r ] role						  |

DESCRIPTION
     The userdel and roledel utilities delete a user or role account 	  |
     from the system and make the appropriate account-related changes     |
     to the system file and file system. roledel additionally removes     |
     the role from each user's list of assumable roles. 		  |

OPTIONS
     The following options are supported:

     -r   Remove the user's or role's home directory from the system.     |
          This directory  must exist.  The files and directories under
          the home directory will no longer be accessible follow-
          ing successful execution of the command.

OPERANDS
     The following operands are supported:

     login
          An existing login name to be deleted.

     role								  |
          An existing role name to be deleted.				  |


EXIT STATUS
     The following exit values are returned:

     0    Success.

     2    Invalid command syntax.  A usage message for the  user-
          del 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     |
	  account is removed from the /etc/passwd file.			  |

     12   Cannot remove or otherwise modify the home directory.

FILES
     /etc/passwd         system password file
     /etc/shadow         system file contains users' and roles' 	  |
                         encrypted passwords and related information
     /etc/group          system file containing group definitions
     /etc/user_attr      system file containing additional user and	  |
			 role attributes  				  |

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)
     roles(1), profiles(1), auths(1), user_attr(4), prof_attr(4)           |


NOTES
     The userdel and roledel utilities only delete an account definition   |
     that is in  the  local  /etc/group, /etc/passwd, /etc/shadow, and
     /etc/user_attr 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 and roledel     |
     cannot change information supplied by the network name service.