shadow/man/gpasswd.1

.\"Generated by db2man.xsl. Don't modify this, modify the source.
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "GPASSWD" 1 "" "" ""
.SH NAME
gpasswd \- administer the /etc/group file
.SH "SYNOPSIS"
.ad l
.hy 0
.HP 8
\fBgpasswd\fR \fIgroup\fR
.ad
.hy
.ad l
.hy 0
.HP 8
\fBgpasswd\fR \-a\ \fIuser\fR \fIgroup\fR
.ad
.hy
.ad l
.hy 0
.HP 8
\fBgpasswd\fR \-d\ \fIuser\fR \fIgroup\fR
.ad
.hy
.ad l
.hy 0
.HP 8
\fBgpasswd\fR \-R\ \fIgroup\fR
.ad
.hy
.ad l
.hy 0
.HP 8
\fBgpasswd\fR \-r\ \fIgroup\fR
.ad
.hy
.ad l
.hy 0
.HP 8
\fBgpasswd\fR [\-A\ \fIuser,\fR...] [\-M\ \fIuser,\fR...] \fIgroup\fR
.ad
.hy

.SH "DESCRIPTION"

.PP
\fBgpasswd\fR is used to administer the \fI/etc/group\fR file (and \fI/etc/gshadow\fR file if compiled with SHADOWGRP defined)\&. Every group can have administrators, members and a password\&. System administrator can use \fB\-A\fR option to define group administrator(s) and \fB\-M\fR option to define members and has all rights of group administrators and members\&.

.SH "OPTIONS"

.PP
Group administrator can add and delete users using \fB\-a\fR and \fB\-d\fR options respectively\&. Administrators can use \fB\-r\fR option to remove group password\&. When no password is set only group members can use \fBnewgrp\fR to join the group\&. Option \fB\-R\fR disables access via a password to the group through \fBnewgrp\fR command (however members will still be able to switch to this group)\&.

.PP
\fBgpasswd\fR called by a group administrator with group name only prompts for the group password\&. If password is set the members can still \fBnewgrp\fR(1) without a password, non\-members must supply the password\&.

.SH "FILES"

.TP
\fI/etc/group\fR
group account information
.TP
\fI/etc/gshadow\fR
secure group account information
.SH "SEE ALSO"

.PP
\fBnewgrp\fR(1), \fBgroupadd\fR(8), \fBgroupdel\fR(8), \fBgroupmod\fR(8), \fBgrpck\fR(8), \fBgroup\fR(5), \fBgshadow\fR(5) 

.SH "AUTHOR"

.PP
Rafal Maszkowski <rzm@pdi\&.net>