> Linux Man Page: "groupmod"


Search with Google


The Linux Documentation Project maintains an archive of snaphots of the (English language) core Linux manual pages that are maintained by Michael Kerrisk. Corrections and additions are welcome, but review the "Help Wanted" list, first.

Man pages belonging to programs are usually distributed together with those programs. Therefore, the core Linux man-pages mainly contains the pages for system calls and library routines, special devices, and file formats. However, it also contains documentation for a few programs, in cases where the authors or maintainers of the program do not distribute man pages themselves.

This page is part of release 3.11 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at


man page(1) manual page Table of Contents


groupmod - modify a group definition on the system


groupmod [options] GROUP


The groupmod modifies the definition of the specified GROUP by modifying the appropriate entry in the group database.


The options which apply to the groupmod command are:

-g, --gid GID
Specify the new group ID for the GROUP. The numerical value of the GID must be a non-negative decimal integer. This value must be unique, unless the -o option is used. 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.

-h, --help
Display help message and exit.

-n, --new-name NEW_GROUP
The name of the group will be changed from GROUP to NEW_GROUP name.

-o, --non-unique
When used with the -g option allow to change the group GID to non-unique value.


Group account information.

Secure group account information.

Exit Values

The groupmod command exits with the following values:

0 success

2 invalid command syntax

3 invalid argument to option

4 specified group doesn’t exist

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) , gpasswd(8) , groupadd(8) , groupdel(8) , useradd(8) , userdel(8) , usermod(8) .

Table of Contents

use open software!