groupadd(1M)groupadd(1M)NAMEgroupadd - add a new group to the system
The command creates a new group on the system by adding the appropriate
entry to the file. The command must be used with the group argument,
which is the name of the new group. The name consists of a string of
printable characters that may not include a colon or newline
Refer to usergroupname(5) to understand the functionality changes with
the Numeric User Group Name feature.
The command uses the following options:
Specify the group ID
for the new group. gid must be a non-negative decimal
integer less than as defined in the header file. By
default the next available unique group ID in the
valid range is allocated. Group IDs in the range 0-99
Allow the gid to be non-unique (that is, a duplicate).
The command is aware of NIS user entries. Only local groups may be
added with this command. Attempts to add an NIS group will result in
an error. NIS groups must be administered from the NIS server. If is
used on a system where NIS is installed, it may fail with the error
(return value 9) if the group specified is not present in the local
file, but is an NIS group (see group(4)). NIS groups are also checked
when verifying uniqueness of the new gid, which may result in the error
(return value 4).
The command exits with one of the following values:
Invalid command syntax.
Invalid argument supplied to an option.
gid is not unique (when is not used).
is not unique.
Cannot modify the
file busy. Another command may be modifying the file.
Unable to open
file or file is non-existent.
Add the group to the file.
Add the group to the file with the group ID as long as no group cur‐
rently exists with a group ID of
Because many users may try to write the file simultaneously, a password
locking mechanism was devised. If this locking fails after subsequent
FILESSEE ALSOusers(1), groupdel(1M), groupmod(1M), logins(1M), useradd(1M),
userdel(1M), usermod(1M), group(4), usergroupname(5).