groupmod(8) System Manager's Manual groupmod(8)
NAME
groupmod - Modifies a group definition on the system
SYNOPSIS
/usr/sbin/groupmod [-g gid [-o]] [-n newgroup] [-P] [-x extended_option] group_name
/usr/sbin/groupmod -D [-x extended_option]
OPTIONS
If invoked with any combination of the options listed by the groupmod -D command, it sets the default values for those options. Subsequent
invocations of usermod without the -D option uses these new defaults. Specifies a new group identification number (GID) for the group
being modified. The GID must be a non-negative decimal integer. When the -o option is used, the GID can be duplicated. Specifies a new
name for the group. The group name can be any printable characters, except the colon (:) and newline (
) characters. You cannot rename a
PC group. Lets a group identification (GID) number be duplicated (non-unique). This option can be used only with the -g option. Creates
a PC group only. The extended_option attributes can be input as a list, delimited by a space. The following extended_option attributes are
available. Note that min_gid must be less than or equal to next_gid which in turn must be less than or equal to max_gid. This applies to
all modifications of GID values. Specifies the largest numeric identifier, which may be associated with a group. This attribute can be
used only with the -D option. The value of the max_gid attribute must be a non-negative decimal number. Specifies the smallest numeric
identifier, which may be associated with a group. This attribute can be used only with the -D option. The value of the min_gid attribute
must be a non-negative decimal number. Specifies the next available group identifier number (GID) in the range of min_gid to max_gid.
This attribute can be used only with the -D option. The value of the next_gid attribute must be a non-negative decimal number. Specifies
whether duplicate GIDs are allowed. If set to 1, duplicate GIDs are enabled. If set to 0, duplicate GIDs are disabled. This attribute can
be used only with the -D option. Indicates that the group is distributed. The value of the distributed=n attribute must be 0 or 1. If set
to 0, the group is maintained on the local system. If set to 1, the group is maintained in the NIS master database on the running system.
Note that local is automatically set to the opposite value of distributed. Indicates that the group is local. The value of the local=n
attribute must be 0 or 1. If set to 1, the group is stored on a local database. If set to 0, the group information is not stored locally,
but exists in the NIS master database. Note that distributed is automatically set to the opposite value of local.
The following extended_option attributes are available for PC group administration. All attributes are applicable if ASU is run-
ning: Specifies a text string that provides a description of the PC group. Specifies a comma delimited list of PC users to be added
to the current list of members of a PC group. Note that this adds, but does not replace members. Specifies the name of the group to
be modified. The group name must exist.
DESCRIPTION
The groupmod command is part of a set of command-line interfaces (CLI) that are used to create and administer user groups on the system.
When The Advanced Server for UNIX (ASU) is installed and running, the groupmod command can also be used to administer PC groups with mem-
bers who are Windows NT domain account users. Accounts can also be created with the /usr/bin/X11/dxaccounts graphical user interface (GUI),
although the extended options are only available from the CLI utilities such as useradd and groupadd.
Different options are available depending on how the local system is configured: User account management is compliant with the IEEE POSIX
Draft P13873.3 standard. The CLI is backwards-compatible, so all legacy scripts will function. However, you should consider testing your
account management scripts befire use.
The groupmod command lets the system administrator modify and rename groups on the system. In addition, the system administrator can use
the -D and -x options on the same command line to change the maximum, minimum, and/or next available group identifier numbers, as well as
specify whether the group account is local or resides in the NIS master database. If the -x option is not specified on the command line,
the system modifies the group information in the appropriate database as specified by the system defaults.
The default behavior on the system for the groupmod command is distributed=0 and local=1. With these values, the system modifies the group
information in the local database by default. Setting the distributed= and local= attributes to the same value (for example, distributed=0
and local=0) produces an error.
You must have superuser privilege to execute this command.
EXIT STATUS
EXAMPLES
The following example changes the GID of the group, testgrp, to 451: % groupmod -g 451 testgrp The following example changes the group name
of the testgrp group to unxgrp: % groupmod -n unxgrp testgrp The following example changes the maximum group ID (max_gid) to 300 and the
next available group ID (next_gid) to 30: % groupmod -D -x max_gid=300 -x next_gid=30
FILES
The groupmod command operates on the appropriate files for the specific level of system security.
SEE ALSO
Commands: groupadd(8), groupdel(8), useradd(8), userdel(8), usermod(8)
System Administration
Security
Advanced Server for UNIX administration and configuration documents.
groupmod(8)