groupdel(8) System Manager's Manual groupdel(8)
NAME
groupdel - Deletes a group definition from the system
SYNOPSIS
/usr/sbin/groupdel [-P] [-x extended_option] group_name
OPTIONS
Creates a PC group only. The following extended_option attributes are available: 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. 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. 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 adminis-
trator 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: Success. Failure. Warning.
EXAMPLES
The following example removes the group, testgrp: % groupdel testgrp The following example removes the group, testgrp, from the local group
database: % groupdel -x local=1 testgrp 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
groupdel(8)