NAME

groupmod - modify a group definition on the system

SYNOPSIS

groupmod [-g gid [-o]] [-n name] group

DESCRIPTION

The groupmod command modifies the definition of the specified group by modifying the appropriate entry in 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 <param.h>. The group ID defaults to the next available (unique) number above 99. (Group IDs from 0-99 are reserved.)

-o This option allows the gid to be duplicated (non-unique).

-n name

A string of printable characters that specifies a new name for the group. It may not include a colon (:) or newline (\\n).

group

The current name of the group to be modified.

FILES

/etc/group

SEE ALSO

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

DIAGNOSTICS

The groupmod command exits with one of the following values:

0 Success.

2 Invalid command syntax. A usage message for the groupmod command is displayed.

3 An invalid argument was provided to an option.

4 gid is not unique (when the -o option is not used).

6 group does not exist.

9 name already exists as a group name.

10 Cannot update the /etc/group file.