3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
6 .\" Manual: System Management Commands
7 .\" Source: System Management Commands
10 .TH "GROUPDEL" "8" "07/24/2009" "System Management Commands" "System Management Commands"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 groupdel \- delete a group
24 .HP \w'\fBgroupdel\fR\ 'u
25 \fBgroupdel\fR \fIgroup\fR
30 command modifies the system account files, deleting all entries that refer to
31 \fIgroup\fR\&. The named group must exist\&.
34 You may not remove the primary group of any existing user\&. You must remove the user before you remove the group\&.
36 You should manually check all file systems to ensure that no files remain owned by this group\&.
39 The following configuration variables in
41 change the behavior of this tool:
43 \fBMAX_MEMBERS_PER_GROUP\fR (number)
45 Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
47 (with the same name, same password, and same GID)\&.
49 The default value is 0, meaning that there are no limits in the number of members in a group\&.
51 This feature (split group) permits to limit the length of lines in the group file\&. This is useful to make sure that lines for NIS groups are not larger than 1024 characters\&.
53 If you need to enforce such limit, you can use 25\&.
55 Note: split groups may not be supported by all tools (even in the Shadow toolsuite)\&. You should not use this variable unless you really need it\&.
61 Group account information\&.
66 Secure group account information\&.
72 command exits with the following values:
81 invalid command syntax
86 specified group doesn\'t exist
91 can\'t remove user\'s primary group
96 can\'t update group file