groupadd(1M) System Administration Commands groupadd(1M)NAMEgroupadd - add (create) a new group definition on the system
SYNOPSIS
/usr/sbin/groupadd [-g gid [-o]] group
DESCRIPTION
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 /usr/include/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 is 201.
(Group IDs from 0−99 are reserved by SunOS for future appli‐
cations.)
-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 mes‐
sage is written if the string exceeds MAXGLEN-1, which is usu‐
ally 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.h
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcs │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOusers(1B), groupdel(1M), groupmod(1M), grpck(1M), logins(1M), pwck(1M),
useradd(1M), userdel(1M), usermod(1M), group(4), attributes(5)NOTESgroupadd only adds a group definition to the local system. If a network
name service such as NIS is being used to supplement the local
/etc/group file with additional entries, groupadd cannot change infor‐
mation supplied by the network name service. However, groupadd verifies
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 main‐
tenance commands, such as groupdel(1M) and groupmod(1M), fail.
SunOS 5.11 22 Feb 2010 groupadd(1M)