groupmod(1M)

groupmod -- modify a group definition on the system

Synopsis

groupmod [-g gid [-o]] [-K path] [-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.)
-K path: The pathname of a directory containing two customization scripts, groupadd.pre and groupadd.post, to be executed before and after modification of the group, respectively.
-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.

If group is preceded by a ``+'', (for example, ``+student''), the group definition is administered by the Network Information Service (NIS). In this case, the value for group ID will be taken from the NIS database. For such specifications, use of the -g or -o options will cause a syntax error to be returned. See group(4) for more information.

Files

/etc/group

Diagnostics

The groupmod command exits with 0 on success, or displays error messages for the following conditions:

Invalid command syntax.
An invalid argument was provided to an option.
gid is not unique (when the -o option is not used).
group does not exist.
name already exists as a group name.
Cannot update the /etc/group file.

References

groupadd(1M), groupdel(1M), groupls(1M), logins(1M), useradd(1M), userdel(1M), usermod(1M), users(1bsd), group(4)