2007-10-07 17:17:33 +05:30
. \" 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"
2007-10-07 17:16:52 +05:30
. \" disable hyphenation
.nh
. \" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
2007-10-07 17:15:58 +05:30
groupmod \- modify a group
2007-10-07 17:16:25 +05:30
.SH "SYNOPSIS"
.HP 9
2007-10-07 17:16:52 +05:30
\fB groupmod\fR [\- g\ \fI gid\fR \ [\-o\ ]] [\-n\ \fInew_group_name\fR] \fI group\fR
2007-10-07 17:16:25 +05:30
.SH "DESCRIPTION"
.PP
2007-10-07 17:17:01 +05:30
The
\fB groupmod\fR
2007-10-07 17:16:52 +05:30
command modifies the system account files to reflect the changes that are specified on the command line.
2007-10-07 17:16:25 +05:30
.SH "OPTIONS"
.PP
2007-10-07 17:17:01 +05:30
The options which apply to the
\fB groupmod\fR
2007-10-07 17:16:52 +05:30
command are:
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fB \- g\fR \fI gid\fR
2007-10-07 17:17:01 +05:30
The numerical value of the group's ID. This value must be unique, unless the
\fB \- o\fR
2007-10-07 17:16:52 +05:30
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.
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fB \- n\fR \fI new_group_name\fR
2007-10-07 17:17:01 +05:30
The name of the group will be changed from
\fI group\fR
to
2007-10-07 17:16:52 +05:30
\fI new_group_name\fR .
2007-10-07 17:16:25 +05:30
.SH "FILES"
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fI /etc/group\fR
2007-10-07 17:17:33 +05:30
Group account information.
.TP 3 n
2007-10-07 17:16:25 +05:30
\fI /etc/gshadow\fR
2007-10-07 17:17:33 +05:30
Secure group account information.
2007-10-07 17:16:25 +05:30
.SH "EXIT VALUES"
.PP
2007-10-07 17:17:01 +05:30
The
\fB groupmod\fR
command exits with the following values:
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fI 0\fR
success
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fI 2\fR
invalid command syntax
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fI 3\fR
invalid argument to option
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fI 4\fR
specified group doesn't exist
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fI 6\fR
specified group doesn't exist
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fI 9\fR
group name already in use
2007-10-07 17:17:33 +05:30
.TP 3 n
2007-10-07 17:16:25 +05:30
\fI 10\fR
2007-10-07 17:16:52 +05:30
can't update group file
2007-10-07 17:16:25 +05:30
.SH "SEE ALSO"
.PP
2007-10-07 17:17:33 +05:30
2007-10-07 17:17:01 +05:30
\fB chfn\fR (1),
\fB chsh\fR (1),
\fB passwd\fR (1),
\fB gpasswd\fR (8),
\fB groupadd\fR (8),
\fB groupdel\fR (8),
\fB useradd\fR (8),
\fB userdel\fR (8),
\fB usermod\fR (8).