shadow/man/groupmod.8

.\"     Title: groupmod
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
.\"      Date: 07/30/2006
.\"    Manual: System Management Commands
.\"    Source: System Management Commands
.\"
.TH "GROUPMOD" "8" "07/30/2006" "System Management Commands" "System Management Commands"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
groupmod \- modify a group definition on the system
.SH "SYNOPSIS"
.HP 9
\fBgroupmod\fR [\fIoptions\fR] \fIGROUP\fR
.SH "DESCRIPTION"
.PP
The
\fBgroupmod\fR
modifies the definition of the specified
\fIGROUP\fR
by modifying the appropriate entry in the group database.
.SH "OPTIONS"
.PP
The options which apply to the
\fBgroupmod\fR
command are:
.TP 3n
\fB\-g\fR, \fB\-\-gid\fR \fIGID\fR
Specify the new group ID for the
\fIGROUP\fR. The numerical value of the
\fIGID\fR
must be a non\-negative decimal integer. This value must be unique, unless the
\fB\-o\fR
option is used. Values between 0 and 999 are typically reserved for system groups. Any files which the old group ID is the file group ID must have the file group ID changed manually.
.TP 3n
\fB\-h\fR, \fB\-\-help\fR
Display help message and exit.
.TP 3n
\fB\-n\fR, \fB\-\-new\-name\fR \fINEW_GROUP\fR
The name of the group will be changed from
\fIGROUP\fR
to
\fINEW_GROUP\fR
name.
.TP 3n
\fB\-o\fR, \fB\-\-non\-unique\fR
When used with the
\fB\-g\fR
option allow to change the group
\fIGID\fR
to non\-unique value.
.SH "FILES"
.TP 3n
\fI/etc/group\fR
Group account information.
.TP 3n
\fI/etc/gshadow\fR
Secure group account information.
.SH "EXIT VALUES"
.PP
The
\fBgroupmod\fR
command exits with the following values:
.TP 3n
\fI0\fR
success
.TP 3n
\fI2\fR
invalid command syntax
.TP 3n
\fI3\fR
invalid argument to option
.TP 3n
\fI4\fR
specified group doesn't exist
.TP 3n
\fI6\fR
specified group doesn't exist
.TP 3n
\fI9\fR
group name already in use
.TP 3n
\fI10\fR
can't update group file
.SH "SEE ALSO"
.PP

\fBchfn\fR(1),
\fBchsh\fR(1),
\fBpasswd\fR(1),
\fBgpasswd\fR(8),
\fBgroupadd\fR(8),
\fBgroupdel\fR(8),
\fBuseradd\fR(8),
\fBuserdel\fR(8),
\fBusermod\fR(8).