Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

PAM_GROUPMEMBER(8)	  Pam-Modules User Reference	    PAM_GROUPMEMBER(8)

NAME
       pam_groupmember - test group membership

SYNOPSIS
       pam_groupmember groups=GROUPLIST [sense=SENSE] [debug[=NUMBER]]
       [waitdebug] [audit]

DESCRIPTION
       Tests if the user is member of  at  least  one  group  from  GROUPLIST.
       GROUPLIST is a comma-separated list of group names or IDs (numbers pre‐
       fixed with a plus sign).

OPTIONS
       groups=GROUPLIST
	      Defines a list of groups to check against.  GROUPLIST is a  com‐
	      ma-separated  list of group names.  A group name prefixed with a
	      plus sign is treated as GID number.

       sense=allow|deny
	      What to do if the user name matches the expression given by  the
	      regex  option.  The value allow (the default) instructs the mod‐
	      ule to return PAM_SUCCESS,  the  deny  instructs	it  to	return
	      PAM_AUTH_ERR.

       debug[=NUMBER]
	      Set debugging level (0 <= NUMBER <= 100).

       audit  Log full debugging information (equivalent to debug=100).

       waitdebug=N
	      Wait  for N seconds before starting up.  This option is intended
	      to facilitate attaching to the module with gdb(1).  It is avail‐
	      able  only if the package was configured with the --enable-debug
	      option.

MODULE TYPES PROVIDED
       All module types (account, auth, password and session) are provided.

RETURN VALUES
       PAM_SUCCESS
	      Successful return.

       PAM_AUTH_ERR
	      Authentication failed.

       PAM_AUTHINFO_UNAVAIL
	      The input information is not sufficient.

       PAM_USER_UNKNOWN
	      Supplied username not found.

EXAMPLES
       auth required pam_groupmember.so groups=users,+80,ftp

NOTE
       This manpage is a short description of pam_groupmember.	For a detailed
       discussion,  including examples and usage recommendations, refer to the
       PAM-modules Manual available in texinfo format.	If the info reader and
       the  tar	 documentation are properly installed on your system, the com‐
       mand

	   info pam-modules

       should give you access to the complete manual.

       You can also view the manual using the info mode in emacs(1),  or  find
       it in various formats online at

	   http://www.gnu.org.ua/software/pam-modules/manual

       If  any	discrepancies  occur  between this manpage and the PAM-modules
       Manual, the later shall be considered the authoritative source.

SEE ALSO
       pam.conf(5), pam.d(5), pam(8).

AUTHORS
       Sergey Poznyakoff <gray@gnu.org>

BUG REPORTS
       Report bugs to <bug-pam-modules@gnu.org.ua>.

COPYRIGHT
       Copyright © 2001-2014 Sergey Poznyakoff
       License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licens‐
       es/gpl.html>
       This  is	 free  software:  you  are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

PAM-MODULES			  May 6, 2014		    PAM_GROUPMEMBER(8)

Vote for polarhome