Groupmod

Techniques: Linux: groupmod

Manpage Text

Name

groupmod - Modify a group

Synopsis

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

Description

The groupmod command modifies the system account files to reflect the changes that are specified on the command line. 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 99 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 group_name

  The name of the group will be changed from group to group_name.

Files

• /etc/group - group information
• /etc/gshadow - secure group information

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)

Notes

• This command is normally not on the search path for executables, so you may need to use whereis to find it.
• This command usually requires root access.

Examples

• /usr/sbin/groupmod -n newname oldname

  changes the name of the group; file-ownership and group membership are preserved, i.e. users and files belonging to oldname now belong to newname.

Edit Log

• 2005-06-12 Transcribed from Ubuntu (hoary) manpages