 |
Index for
Section 8 |
|
 |
Alphabetical
listing for G |
|
 |
Bottom of
page |
|
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
-D 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.
-g gid
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.
-n newgroup
Specifies a new name for the group. The group name can be any
printable characters, except the colon (:) and newline (\n) characters.
You cannot rename a PC group.
-o Lets a group identification (GID) number be duplicated (non-unique).
This option can be used only with the -g option.
-P Creates a PC group only.
-x extended_option, extended_option...
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.
max_gid=n
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.
min_gid=n
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.
next_gid=n
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.
dup_gid=0|1
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.
distributed=0|1
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.
local=0|1
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 running:
pc_group_description=string
Specifies a text string that provides a description of the PC
group.
pc_group_members=user,user....
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.
group_name
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 members 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
1. The following example changes the GID of the group, testgrp, to 451:
% groupmod -g 451 testgrp
2. The following example changes the group name of the testgrp group to
unxgrp:
% groupmod -n unxgrp testgrp
3. 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.
|
Index for
Section 8 |
|
|
Alphabetical
listing for G |
|
 |
Top of
page |
|