GROUPMOD
Section: Maintenance Commands (8)
Index
Return to Main Contents
NAME
groupmod - modify a group
SYNOPSIS
groupmod [-g GID [-o]] [-n NEW_GROUP_NAME]
GROUP
DESCRIPTION
The groupmod command modifies the system account files to reflect the
changes that are specified on the command line.
OPTIONS
The options which apply to the groupmod command are:
- -g GID
-
The numerical value of the group's ID. This value must be unique, unless the
-o option is used. The value must be non-negative. Values between 0
and 999 are typically reserved for system groups. Any files which the old
group ID is the file group ID must have the file group ID changed manually.
- -n NEW_GROUP_NAME
-
The name of the group will be changed from GROUP to NEW_GROUP_NAME.
FILES
/etc/group - group information
/etc/gshadow - secure group information
EXIT VALUES
- The groupmod command exits with the following values:
-
0 - success
2 - bad command syntax
3 - invalid argument to option
4 - gid already in use (and no -o)
6 - specified group doesn't exist
9 - group name already in use
10 - can't update group file
SEE ALSO
chfn(1),
chsh(1),
passwd(1),
groupadd(8),
groupdel(8),
useradd(8),
userdel(8),
usermod(8)
AUTHOR
Julianne Frances Haugh (jockgrrl@ix.netcom.com)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- FILES
-
- EXIT VALUES
-
- SEE ALSO
-
- AUTHOR
-
www.fiveanddime.net
