100 lines
2.1 KiB
Groff
100 lines
2.1 KiB
Groff
.\" 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).
|