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:

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