Content-type: text/html Man page of groupdel

groupdel

Section: Maintenance Commands (8)
Index Return to Main Contents
 

NAME

groupdel - Deletes a group definition from the system  

SYNOPSIS

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

FLAGS

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 administrator can use the -x flag to specify whether the group to be deleted is local or whether the group resides in the NIS master database. If the -x flag 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.

You must have superuser privilege to execute this command.  

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  

EXIT VALUES

The groupdel command exits with one of the following values: Success Invalid command syntax or insufficient privilege. A usage message for the groupdel command or an error message is displayed. An invalid argument was provided to an option. The group does not exist. Cannot update the group database.  

FILES

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

RELATED INFORMATION

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

Documents:  System Administration, Security delim off


 

Index

NAME
SYNOPSIS
FLAGS
DESCRIPTION
EXAMPLES
EXIT VALUES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:36 GMT, October 02, 2010