HP-UX Reference (11i v3 07/02) - 1M System Administration Commands A-M (vol 3)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

291

292

293

294

295

296

297

298

299

300

groupdel(1M) groupdel(1M)

NAME

groupdel - delete a group from the system

SYNOPSIS

groupdel [-s] group

DESCRIPTION

The groupdel command deletes a group from the system by removing the appropriate entry from the

/etc/group ﬁle.

The groupdel command must be used with the group argument which is the name of the group to be

deleted. The name consists of a string of printable characters that may not include a colon (

:) or newline

(

\n).

Options

The groupadd command uses the following option:

-s Exercise the safe delete feature. That is, if the gid of the primary group of any system user

matches the gid of group, then group is not deleted.

NIS

The groupdel command is aware of NIS user entries. Only local groups may be deleted with group-

del

. Attempts to delete an NIS group will result in an error. NIS groups must be administered from the

NIS server. If groupdel is used on a system where NIS is installed, it may fail with the error

group x does not exist

(return value 6), if the group speciﬁed is an NIS group (see group(4)).

RETURN VALUE

groupdel exits with one of the following values:

0 No error.

2 Invalid command syntax.

3 Invalid argument supplied to an option.

6 group does not exist.

10 Cannot modify the /etc/group ﬁle.

11 /etc/passwd ﬁle or /etc/ptmp

ﬁle busy. Another command may be modifying the

/etc/passwd ﬁle.

12 Unable to open /etc/ptmp or /etc/passwd ﬁle is non-existent.

13 group is busy or cannot delete the primary group.

EXAMPLES

Delete the group project1 from the /etc/group ﬁle if it exists:

groupdel project1

WARNINGS

Because many users may try to write the /etc/passwd ﬁle simultaneously, a password locking mechan-

ism was devised. If this locking fails after subsequent retrying, groupdel terminates.

FILES

/etc/group

/etc/ptmp