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 the NIS database.

      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.

  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 and distributed let the system administrator specify
  whether the group to be deleted is local or distributed by NIS. 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
  both of these values to 0 or set both 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.

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)

  System Administration

  Security

Index for Section 8

Alphabetical listing for G

Top of page