Dr Andrew Scott G7VAV

MBCS, MIET, Member ACM, Member IEEE

Senior Lecturer
School of Computing
and Communications

D35 InfoLab21
Lancaster University
Lancaster, LA1 4WA
United Kingdom

November 2025
27	28	29	30	31	1	2
3	4	5	6	7	8	9
10	11	12	13	14	15	16
17	18	19	20	21	22	23
24	25	26	27	28	29	30
1	2	3	4	5	6	7

PAM_LOCALUSER

Section: Linux-PAM Manual (8)
Updated: 06/04/2011
Index Return to Main Contents

NAME

pam_localuser - require users to be listed in /etc/passwd

SYNOPSIS

pam_localuser.so [debug] [file=/path/passwd]

DESCRIPTION

pam_localuser is a PAM module to help implementing site-wide login policies, where they typically include a subset of the network's users and a few accounts that are local to a particular workstation. Using pam_localuser and pam_wheel or pam_listfile is an effective way to restrict access to either local users and/or a subset of the network's users.

This could also be implemented using pam_listfile.so and a very short awk script invoked by cron, but it's common enough to have been separated out.

OPTIONS

debug

: Print debug information.

file=/path/passwd

: Use a file other than /etc/passwd.

MODULE TYPES PROVIDED

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

RETURN VALUES

PAM_SUCCESS

: The new localuser was set successfully.

PAM_SERVICE_ERR

: No username was given.

PAM_USER_UNKNOWN

: User not known.

EXAMPLES

Add the following line to /etc/pam.d/su to allow only local users in group wheel to use su.

account sufficient pam_localuser.so
account required pam_wheel.so

FILES

/etc/passwd

: Local user account information.

AUTHOR

pam_localuser was written by Nalin Dahyabhai <nalin@redhat.com>.

for client (none)

http://www.andrew-scott.uk/

Andrew Scott

http://www.andrew-scott.co.uk/