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. The following options are available:

-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 of printable characters that specifies the name of the new group. It may not include a colon (:) or newline (\\n).

FILES

/etc/group

SEE ALSO

groupdel(1M),   groupmod(1M),    logins(1M),    useradd(1M),
userdel(1M), usermod(1M), users(1).

DIAGNOSTICS

The groupadd 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.