shadow/man/gpasswd.1

.\"$Id: gpasswd.1,v 1.10 2004/11/02 19:28:31 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
.TP 6
\fBgpasswd \fIgroup\fR
.br
\fBgpasswd -a \fIuser\fR \fIgroup\fR
.br
\fBgpasswd -d \fIuser\fR \fIgroup\fR
.br
\fBgpasswd -R \fIgroup\fR
.br
\fBgpasswd -r \fIgroup\fR
.br
\fBgpasswd\fR [\fB-A \fIuser\fR,...] [\fB-M\fR \fIuser\fR,...] \fIgroup\fR
.SH DESCRIPTION
\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 to the group through
\fBnewgrp\fR 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
\fI/etc/group\fR	\- group information
.br
\fI/etc/gshadow\fR	\- shadow group information
.SH SEE ALSO
.BR newgrp (1),
.BR groupadd (8),
.BR groupdel (8),
.BR groupmod (8),
.BR grpck (8)
.SH AUTHOR
Rafal Maszkowski <rzm@pdi.net>