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.