groupmod(1M)
groupmod --
modify a group definition on the system
Synopsis
groupmod [-g gid [-o]] [-K path] [-n name] group
Description
The groupmod command modifies the definition of the
specified group by modifying the appropriate entry in the /etc/group
file.
The following options are available:
-g gid-
The group ID for the new group.
This group ID must be a
non-negative decimal integer below MAXUID as defined in <param.h>.
The group ID defaults to the next available (unique) number above
99. (Group IDs from 0-99 are reserved.)
-K path-
The pathname of a directory containing two customization scripts,
groupadd.pre and groupadd.post, to be
executed before and after modification of the group, respectively.
-o-
This option allows the gid to be duplicated (non-unique).
-n name-
A string of printable characters that specifies a new name for the group.
It may not include a colon (:) or newline (\n).
group-
The current name of the group to be modified.
If group is preceded by a
``+'', (for example,
``+student''),
the group definition is administered by the Network
Information Service (NIS).
In this case, the value for group ID will be taken from the NIS
database.
For such specifications, use of the -g or -o options will cause a syntax error to be returned.
See
group(4)
for more information.
Files
/etc/group-
Diagnostics
The groupmod command exits with
0 on success, or displays error messages for the
following conditions:
-
Invalid command syntax.
-
An invalid argument was provided to an option.
-
gid is not unique (when the -o option is not used).
-
group does not exist.
-
name already exists as a group name.
-
Cannot update the /etc/group file.
References
groupadd(1M),
groupdel(1M),
groupls(1M),
logins(1M),
useradd(1M),
userdel(1M),
usermod(1M),
users(1bsd),
group(4)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004