gpasswd(1) [redhat man page]

GPASSWD(1)						      General Commands Manual							GPASSWD(1)

NAME

       gpasswd - administer the /etc/group file

SYNOPSIS

       gpasswd group
       gpasswd -a user group
       gpasswd -d user group
       gpasswd -R group
       gpasswd -r group
       gpasswd [-A user,...] [-M user,...] group

DESCRIPTION

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

       Group  administrator  can add and delete users using -a and -d options respectively. Administrators can use -r option to remove group pass-
       word. When no password is set only group members can use newgrp(1) to join the group. Option -R disables access to the group  through  new-
       grp(1) command.

       gpasswd	called by a group administrator with group name only prompts for the group password. If password is set the members can still new-
       grp(1) without a password, non-members must supply the password.

FILES

       /etc/group - group information
       /etc/gshadow - shadow group information

SEE ALSO

       newgrp(1), groupadd(8), groupdel(8), groupmod(8), grpck(8)

AUTHOR

       Rafal Maszkowski <rzm@pdi.net>

																	GPASSWD(1)

GSHADOW(5)						   File Formats and Conversions 						GSHADOW(5)

NAME

       gshadow - shadowed group file

DESCRIPTION

       /etc/gshadow contains the shadowed information for group accounts.

       This file must not be readable by regular users if password security is to be maintained.

       Each line of this file contains the following colon-separated fields:

       group name
	   It must be a valid group name, which exist on the system.

       encrypted password
	   Refer to crypt(3) for details on how this string is interpreted.

	   If the password field contains some string that is not a valid result of crypt(3), for instance ! or *, users will not be able to use a
	   unix password to access the group (but group members do not need the password).

	   The password is used when an user who is not a member of the group wants to gain the permissions of this group (see newgrp(1)).

	   This field may be empty, in which case only the group members can gain the group permissions.

	   A password field which starts with a exclamation mark means that the password is locked. The remaining characters on the line represent
	   the password field before the password was locked.

	   This password supersedes any password specified in /etc/group.

       administrators
	   It must be a comma-separated list of user names.

	   Administrators can change the password or the members of the group.

	   Administrators also have the same permissions as the members (see below).

       members
	   It must be a comma-separated list of user names.

	   Members can access the group without being prompted for a password.

	   You should use the same list of users as in /etc/group.

FILES

       /etc/group
	   Group account information.

       /etc/gshadow
	   Secure group account information.

SEE ALSO

       gpasswd(5), group(5), grpck(8), grpconv(8), newgrp(1).

shadow-utils 4.1.5.1						    05/25/2012								GSHADOW(5)