shadow/man/gpasswd.1

.\"	$Id: gpasswd.1,v 1.4 2001/01/27 02:55:52 kloczek Exp $
.\" Copyright 1996, Rafal Maszkowski, rzm@pdi.net
.\" All rights reserved. You can redistribute this man page and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of the
.\" License, or (at your option) any later version.
.TH GPASSWD 1
.SH NAME
gpasswd \- administer the /etc/group file
.br
.SH SYNOPSIS
\fBgpasswd\fR \fIgroup\fR
.br
\fBgpasswd\fR \fB-a\fR \fIuser\fR \fIgroup\fR
.br
\fBgpasswd\fR \fB-d\fR \fIuser\fR \fIgroup\fR
.br
\fBgpasswd\fR \fB-R\fR \fIgroup\fR
.br
\fBgpasswd\fR \fB-r\fR \fIgroup\fR
.br
\fBgpasswd\fR [\fB-A\fR \fIuser\fR,...] [\fB-M\fR \fIuser\fR,...] \fIgroup\fR
.br
.SH DESCRIPTION
.B gpasswd
is used to administer the /etc/group file (and /etc/gshadow
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.
.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
.BR newgrp (1)
to join the group. Option \fB-R\fR disables 
access to the group through
.BR newgrp (1)
command.
.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
.BR newgrp (1)
without a password, non-members must supply the password.

.SH FILES
/etc/group \- group information
.br
/etc/gshadow \- shadow group information
.SH SEE ALSO
.BR newgrp (1),
.BR groupadd (8),
.BR groupdel (8),
.BR groupmod (8),
.BR grpck (8)