pam_group(8)						    BSD System Manager's Manual 					      pam_group(8)

NAME

     pam_group -- Group PAM module

SYNOPSIS

     [service-name] function-class control-flag pam_group [options]

DESCRIPTION

     The Group PAM module supports the account management function class.  In terms of the function-class parameter, this is the ``account''
     class.

     The Group account management module permits or denies users based on their membership to a particular group (or groups) specified with the
     group option.  If no groups are specified the default group (``wheel'') will be used.

     The following options may be passed to this account management module:

     deny	 Reverse the meaning of the test, i.e., reject the applicant if and only if he or she is a member of the specified group.  This
		 can be useful to exclude certain groups of users from certain services.

     fail_safe	 If the specified group does not exist, or has no members, act as if it does exist and the applicant is a member.

     group=groupname
		 Specify the name of the group to check.  This can be a comma-separated list (i.e. ``group=admin,wheel'').

     root_only	 Skip this module entirely if the target account is not the superuser account.

     ruser	 Check the membership of the applicant (PAM_RUSER), rather than the target account (PAM_USER)

SEE ALSO

     pam_get_item(3), pam.conf(5), pam(8), DirectoryService(8)

AUTHORS

     The pam_group module and this manual page were developed for the FreeBSD Project by ThinkSec AS and NAI Labs, the Security Research Division
     of Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 (``CBOSS''), as part of the DARPA CHATS research program.

BSD
								 February 7, 2009							       BSD