84 lines
1.8 KiB
Groff
84 lines
1.8 KiB
Groff
.\" Title: groupmod
|
|
.\" Author:
|
|
.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
|
|
.\" Date: 06/06/2006
|
|
.\" Manual: System Management Commands
|
|
.\" Source: System Management Commands
|
|
.\"
|
|
.TH "GROUPMOD" "8" "06/06/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
|
|
.SH "SYNOPSIS"
|
|
.HP 9
|
|
\fBgroupmod\fR [\-g\ \fIgid\fR\ [\-o\ ]] [\-n\ \fInew_group_name\fR] \fIgroup\fR
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
The
|
|
\fBgroupmod\fR
|
|
command modifies the system account files to reflect the changes that are specified on the command line.
|
|
.SH "OPTIONS"
|
|
.PP
|
|
The options which apply to the
|
|
\fBgroupmod\fR
|
|
command are:
|
|
.TP 3n
|
|
\fB\-g\fR \fIgid\fR
|
|
The numerical value of the group's ID. This value must be unique, unless the
|
|
\fB\-o\fR
|
|
option is used. The value must be non\-negative. 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\-n\fR \fInew_group_name\fR
|
|
The name of the group will be changed from
|
|
\fIgroup\fR
|
|
to
|
|
\fInew_group_name\fR.
|
|
.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).
|