NAME

groupmod − modify a group definition on the system

SYNOPSIS

/usr/sbin/groupmod [ −g gid [ −o ]] [ −n name ] group

AVAILABILITY

SUNWcsu

DESCRIPTION

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

−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). 

OPERANDS

group The current name of the group to be modified. 

EXIT STATUS

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. 

FILES

/etc/group group file

SEE ALSO

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

NOTES

groupmod only modifies group definitions in the /etc/group file.  If a network name service such as NIS or NIS+ is being used to supplement the local /etc/group file with additional entries, groupmod cannot change information supplied by the network name service.  However groupmod will verify the uniqueness of group name and group id against the external name service. 

SunOS 5.5.1  —  Last change: 5 Dec 1995