.\"     Title: groupmems
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
.\"      Date: 07/30/2006
.\"    Manual: System Management Commands
.\"    Source: System Management Commands
.\"
.TH "GROUPMEMS" "8" "07/30/2006" "System Management Commands" "System Management Commands"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
groupmems \- administer members of a user's primary group
.SH "SYNOPSIS"
.HP 10
\fBgroupmems\fR \-a\ \fIuser_name\fR | \-d\ \fIuser_name\fR | \-l | \-p | [\-g\ \fIgroup_name\fR] 
.SH "DESCRIPTION"
.PP
The
\fBgroupmems\fR
utility allows a user to administer his/her own group membership list without the requirement of super user privileges. The
\fBgroupmems\fR
utility is for systems that configure its users to be in their own name sake primary group (i.e., guest / guest).
.PP
Only the super user, as administrator, can use
\fBgroupmems\fR
to alter the memberships of other groups.
.SH "OPTIONS"
.PP
The options which apply to the
\fBgroupmems\fR
command are:
.TP 3n
\fB\-a\fR \fIuser_name\fR
Add a new user to the group membership list.
.TP 3n
\fB\-d\fR \fIuser_name\fR
Delete a user from the group membership list.
.TP 3n
\fB\-p\fR
Purge all users from the group membership list.
.TP 3n
\fB\-g\fR \fIgroup_name\fR
The super user can specify which group membership list to modify.
.TP 3n
\fB\-l\fR
List the group membership list.
.SH "SETUP"
.PP
The
\fBgroupmems\fR
executable should be in mode
2770
as user
\fIroot\fR
and in group
\fIgroups\fR. The system administrator can add users to group
\fIgroups\fR
to allow or disallow them using the
\fBgroupmems\fR
utility to manage their own group membership list.
.sp
.RS 3n
.nf
	$ groupadd \-r groups
	$ chmod 2770 groupmems
	$ chown root.groups groupmems
	$ groupmems \-g groups \-a gk4
    
.fi
.RE
.SH "FILES"
.TP 3n
\fI/etc/group\fR
Group account information.
.TP 3n
\fI/etc/gshadow\fR
secure group account information
.SH "SEE ALSO"
.PP

\fBchfn\fR(1),
\fBchsh\fR(1),
\fBpasswd\fR(1),
\fBgroupadd\fR(8),
\fBgroupdel\fR(8),
\fBuseradd\fR(8),
\fBuserdel\fR(8),
\fBusermod\fR(8).