2007-10-07 17:16:52 +05:30
. \" ** You probably do not want to edit this file directly **
2007-10-07 17:17:01 +05:30
. \" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
2007-10-07 17:16:52 +05:30
. \" Instead of manually editing it, you probably should edit the DocBook XML
. \" source for it and then use the DocBook XSL Stylesheets to regenerate it.
2007-10-07 17:17:11 +05:30
.TH "GPASSWD" "1" "11/05/2005" "User Commands" "User 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:14:44 +05:30
gpasswd \- administer the /etc/group file
2007-10-07 17:16:25 +05:30
.SH "SYNOPSIS"
.HP 8
2007-10-07 17:16:07 +05:30
\fB gpasswd\fR \fI group\fR
2007-10-07 17:16:25 +05:30
.HP 8
\fB gpasswd\fR \- a\ \fI user\fR \fI group\fR
.HP 8
\fB gpasswd\fR \- d\ \fI user\fR \fI group\fR
.HP 8
\fB gpasswd\fR \- R\ \fI group\fR
.HP 8
\fB gpasswd\fR \- r\ \fI group\fR
.HP 8
\fB gpasswd\fR [\- A\ \fI user,\fR ...] [\- M\ \fI user,\fR ...] \fI group\fR
.SH "DESCRIPTION"
2007-10-07 17:14:44 +05:30
.PP
2007-10-07 17:17:01 +05:30
\fB gpasswd\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
2007-10-07 17:16:52 +05:30
option to define members and has all rights of group administrators and members.
2007-10-07 17:17:11 +05:30
.SS "Notes about group passwords"
.PP
Group passwords are an inherent security problem since more than one person is permitted to know the password. However, groups are a useful tool for permitting co\- operation between different users.
2007-10-07 17:16:25 +05:30
.SH "OPTIONS"
2007-10-07 17:14:44 +05:30
.PP
2007-10-07 17:17:01 +05:30
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
\fB newgrp\fR
to join the group. Option
\fB \- R\fR
disables access via a password to the group through
\fB newgrp\fR
2007-10-07 17:16:52 +05:30
command (however members will still be able to switch to this group).
2007-10-07 17:16:25 +05:30
.PP
2007-10-07 17:17:01 +05:30
\fB gpasswd\fR
called by a group administrator with group name only prompts for the group password. If password is set the members can still
\fB newgrp\fR (1)
2007-10-07 17:16:52 +05:30
without a password, non\- members must supply the password.
2007-10-07 17:16:25 +05:30
.SH "FILES"
.TP
\fI /etc/group\fR
group account information
.TP
\fI /etc/gshadow\fR
secure group account information
.SH "SEE ALSO"
.PP
2007-10-07 17:17:01 +05:30
\fB newgrp\fR (1),
\fB gshadow\fR (5),
\fB groupadd\fR (8),
\fB groupdel\fR (8),
\fB groupmod\fR (8),
\fB grpck\fR (8),
\fB group\fR (5).