groupadd(1M) groupadd(1M)
NAME
groupadd - add (create) a new group definition on the system
SYNOPSIS
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
-g gid The group id for the new group. This group id must be a
non-negative decimal integer below MAXUID as defined in the
<param.h> header file. 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.)
-o This option allows the gid to be duplicated (non-unique).
group A string with a maximum of 16 printable characters, which
specifies the name of the new group. It may not include a
colon (:) or newline (\n).
DIAGNOSTICS
The command exits with one of the following values:
0 = Success.
2 = Invalid command syntax. A usage message for the groupadd command
is displayed.
3 = An invalid argument was provided to an option.
4 = gid is not unique (when -o option is not used).
9 = group is not unique.
10 = Cannot update the /etc/group file.
LOCALE
The LCMESSAGES environment variable governs the language in which
message texts are displayed.
If LCMESSAGES is undefined or is defined as the null string, it
defaults to the value of LANG. If LANG is likewise undefined or null,
the system acts as if it were not internationalized.
If any of the locale variables has an invalid value, the system acts
as if none of the variables was set.
Page 1 Reliant UNIX 5.44 Printed 11/98
groupadd(1M) groupadd(1M)
The LCALL environment variable governs the entire locale. LCALL
takes precedence over all the other environment variables which affect
internationalization.
FILES
/etc/group
SEE ALSO
users(1), groupdel(1M), groupmod(1M), logins(1M), useradd(1M),
userdel(1M), usermod(1M).
Page 2 Reliant UNIX 5.44 Printed 11/98