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  Creates a PC group only.

  -x extended_option
      The following extended_option attributes are available:

      distributed=n
	  Indicates whether or not the group is distributed. The value of the
	  distributed=n attribute can be 0 or 1. If set to 0, the group is
	  deleted from the local system. If set to 1, the group is deleted
	  from the NIS master database on the running system.

      local=n
	  Indicates whether or not the group is local. The value of the
	  local=n attribute can be 0 or 1. If set to 1, the group is deleted
	  from the local database. If set to 0, the group is deleted from the
	  NIS master 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.  In addition, the system administrator can
  use the -x option to specify whether the group to be deleted is local or
  whether the group resides in the NIS master database.	 If the -x option is
  not specified, the group is deleted from the appropriate database as
  specified by the system defaults.

  The default behavior on the system for the groupdel command is
  distributed=0 and local=1.  With these values, the system deletes the group
  from the local database by default. Setting the distributed= and local=
  attributes to the same value (for example, distributed=0 and local=0)
  produces an error.

  When the Advanced Server for UNIX (ASU) is running, you can also delete PC
  groups consisting of members who are holders of Windows NT domain accounts.

  You must have superuser privilege to execute this command.




EXIT STATUS
  The groupmod 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, from the
       local group database:
	    % 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