groupdel(8)groupdel(8)NAMEgroupdel - Deletes a group definition from the system
SYNOPSIS
/usr/sbin/groupdel [-P] [-x extended_option] group_name
OPTIONS
Deletes a PC group only. 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 spe‐
cific system environments.
The following sets of extended_option attributes are available:
Indicates that the group to be deleted is local. The value 0
indicates that the group is to be deleted from some other data‐
base, either the NIS or LDAP. 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. 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. Specifies
the name of the group to be deleted from the system. The group‐
name 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 administra‐
tor 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 data‐
base 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 con‐
sisting 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: 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: % 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
groupdel(8)
