1GROUPMOD(8)               System Management Commands               GROUPMOD(8)
2
3
4

NAME

6       groupmod - modify a group definition on the system
7

SYNOPSIS

9       groupmod [options] GROUP
10

DESCRIPTION

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

OPTIONS

16       The options which apply to the groupmod command are:
17
18       -g, --gid GID
19          Specify the new group ID for the GROUP. The numerical value of the
20          GID must be a non-negative decimal integer. This value must be
21          unique, unless the -o option is used. Values between 0 and 999 are
22          typically reserved for system groups. Any files which the old group
23          ID is the file group ID must have the file group ID changed
24          manually.
25
26       -h, --help
27          Display help message and exit.
28
29       -n, --new-name NEW_GROUP
30          The name of the group will be changed from GROUP to NEW_GROUP name.
31
32       -o, --non-unique
33          When used with the -g option allow to change the group GID to
34          non-unique value.
35

FILES

37       /etc/group
38          Group account information.
39
40       /etc/gshadow
41          Secure group account information.
42

EXIT VALUES

44       The groupmod command exits with the following values:
45
46       0  success
47
48       2  invalid command syntax
49
50       3  invalid argument to option
51
52       4  specified group doesn't exist
53
54       6  specified group doesn't exist
55
56       9  group name already in use
57
58       10 can't update group file
59

SEE ALSO

61       chfn(1), chsh(1), passwd(1), gpasswd(8), groupadd(8), groupdel(8),
62       useradd(8), userdel(8), usermod(8).
63
64
65
66System Management Commands        07/30/2006                       GROUPMOD(8)