1GROUPADD(8)               System Management Commands               GROUPADD(8)
2
3
4

NAME

6       groupadd - create a new group
7

SYNOPSIS

9       groupadd [-g gid [-o]] [-r] [-f] [-K KEY=VALUE] group
10

DESCRIPTION

12       The groupadd command creates a new group account using the values
13       specified on the command line and the default values from the system.
14       The new group will be entered into the system files as needed.
15

OPTIONS

17       The options which apply to the groupadd command are:
18
19       -f This option causes to just exit with success status if the specified
20          group already exists. With -g, if specified GID already exists,
21          other (unique) GID is chosen (i.e.  -g is turned off).
22
23       -r This flag instructs groupadd to add a system account.  The first
24          available gid lower than 499 will be automatically selected unless
25          the -g option is also given on the command line. This is an option
26          added by Red Hat.
27
28       -g GID
29          The numerical value of the group's ID. This value must be unique,
30          unless the -o option is used. The value must be non-negative. The
31          default is to use the smallest ID value greater than 500 and greater
32          than every other group. Values between 0 and 499 are typically
33          reserved for system accounts.
34
35       -h, --help
36          Display help message and exit.
37
38       -K KEY=VALUE
39          Overrides /etc/login.defs defaults (GID_MIN, GID_MAX and others).
40          Multiple -K options can be specified.
41
42          Example: -K GID_MIN=100
43           -K GID_MAX=499
44
45          Note: -K GID_MIN=10,GID_MAX=499 doesn't work yet.
46
47       -o This option permits to add group with non-unique GID.
48

FILES

50       /etc/group
51          Group account information.
52
53       /etc/gshadow
54          Secure group account information.
55
56       /etc/login.defs
57          Shadow password suite configuration.
58

CAVEATS

60       Groupnames must begin with a lower case letter or an underscore, and
61       only lower case letters, underscores, dashes, and dollar signs may
62       follow. In regular expression terms: [a-z_][a-z0-9_-]*[$]
63
64       Groupnames may only be up to 16 characters long.
65
66       If the groupname already exists in an external group database such as
67       NIS, groupadd will deny the group creation request.
68
69       Groupnames may only be up to 16 characters long.
70

EXIT VALUES

72       The groupadd command exits with the following values:
73
74       0  success
75
76       2  invalid command syntax
77
78       3  invalid argument to option
79
80       4  GID not unique (when -o not used)
81
82       9  group name not unique
83
84       10 can't update group file
85

SEE ALSO

87       chfn(1), chsh(1), passwd(1), gpasswd(8), groupdel(8), groupmod(8),
88       login.defs(5), useradd(8), userdel(8), usermod(8).
89
90
91
92System Management Commands        07/30/2006                       GROUPADD(8)
Impressum