GROUPADD(8) Maintenance Commands and Procedures GROUPADD(8)
NAME
groupadd - add (create) a new group definition on the system
SYNOPSIS
/usr/sbin/groupadd [
-g gid [
-o]]
groupDESCRIPTION
The
groupadd command creates a new group definition on the system by
adding the appropriate entry to the
/etc/group file.
OPTIONS
The following options are supported:
-g gid Assigns the group id
gid for the new group. This group id must
be a non-negative decimal integer below
MAXUID as defined in
<sys/param.h>. The group
ID defaults to the next available
(unique) number above the highest number currently assigned.
For example, if groups
100,
105, and
200 are assigned as
groups, the next default group number will be
201. (Group
IDs from
0-
99 are reserved for future applications.)
-o Allows the
gid to be duplicated (non-unique).
OPERANDS
The following operands are supported:
group A string consisting of characters from the set of lower case
alphabetic characters and numeric characters. A warning message
will be written if the string exceeds
MAXGLEN, which is usually
set at eight characters. The
group field must contain at least
one character; it accepts lower case or numeric characters or a
combination of both, and must not contain a colon (
:) or
NEWLINE.EXIT STATUS
The following exit values are returned:
0 Successful completion.
2 Invalid command syntax. A usage message for the
groupadd command is
displayed.
3 An invalid argument was provided to an option.
4 The
gid is not unique (when
-o option is not used).
9 The
group is not unique.
10 The
/etc/group file cannot be updated.
FILES
o
/etc/group o
/usr/include/userdefs.hSEE ALSO
group(5),
attributes(7),
groupdel(8),
groupmod(8),
grpck(8),
logins(8),
pwck(8),
useradd(8),
userdel(8),
usermod(8)NOTES
groupadd only adds a group definition to the local system. If a network
name service is being used to supplement the local
/etc/group file with
additional entries,
groupadd cannot change information supplied by the
network name service. However,
groupadd will verify the uniqueness of
group name and group
ID against the external name service.
If the number of characters in a
group entry exceeds 2047, group
maintenance commands, such as
groupdel(8) and
groupmod(8), fail.
January 7, 2018
GROUPADD(8)