Index for Section 8

Alphabetical listing for G

Bottom of page

groupdel(8)
NAME
  groupdel - Deletes a group definition from the system

SYNOPSIS
  /usr/sbin/groupdel [-P] [-x extended_option] group_name

OPTIONS
  -P  Deletes a PC group only.

  -x extended_option [extended_option...]
      Extended options are of the form attribute=value.	 You may enter any
      number of extended options (within the character limit of the command
      line) by separating each option with a space. Alternatively, they may
      be entered separately following the -x switch. Note that some extended
      options are only available under specific system environments.

      The following sets of extended_option attributes are available:

      local=0|1
	  Indicates that the group to be deleted is local. The value 0
	  indicates that the group is to be deleted from some other database,
	  either the NIS or LDAP.

      distributed=0|1
	  The value 1 indicates that a group is to be deleted from the NIS
	  database. You must be on the NIS master to delete a NIS group.

      ldap=0|1
	  The value 1 indicates that the group to be deleted is from an LDAP
	  server. LDAP must be configured, and you must be on the LDAP server
	  or on an LDAP client with permission to modify the LDAP database.

  group_name
      Specifies the name of the group to be deleted from the system. The
      groupname must exist.

DESCRIPTION
  The groupdel command lets the system administrator delete existing groups
  from the system by group name.

  The -x options local, distributed, ldap and  let the system administrator
  specify whether the group to be deleted is local, distributed by NIS, or on
  an LDAP server. If these options are not specified on the command line, the
  system deletes the group from the appropriate database as specified by the
  system defaults. System defaults for groups may be set with the groupmod -D
  option. In the absence of any defaults, groupdel deletes a local group.
  Certain combinations of these settings are incompatible and produce an
  error: it is invalid to set all of these values to 0 or set more than one
  of them to 1.

RESTRICTIONS
  You must have superuser privilege to execute this command.

  Advanced Server for UNIX (ASU) must be running to delete PC groups
  consisting of members who are holders of Windows NT domain accounts.

  You must be on the NIS master to delete a NIS group.

  LDAP must be configured, and you must be on the LDAP server or an LDAP
  client with permission to modify the LDAP database to delete an LDAP group.

EXIT STATUS
  The groupdel command exits with one of the following values:

  0   Success.

  1   Failure.

  2   Warning.

EXAMPLES
   1.  The following example removes the group, testgrp:
	    % groupdel testgrp

   2.  The following example removes the group, testgrp, from the local group
       database:
	    % groupdel -x local=1 testgrp

   3.  The following example removes the PC users group, domainbdev:
	    % groupdel -P domainbdev

FILES
  The groupdel command operates on the appropriate files for the specific
  level of system security.

SEE ALSO
  Commands:  groupadd(8), groupmod(8), useradd(8), userdel(8), usermod(8)

  Manuals: System Administration, Security

Index for Section 8

Alphabetical listing for G

Top of page