PAM_LISTFILE(8)                Linux-PAM Manual                PAM_LISTFILE(8)

<?><?><?> (NAME)
       pam_listfile - <?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       pam_listfile.so item=[tty|user|rhost|ruser|group|shell]
                       sense=[allow|deny] file=/path/filename
                       onerr=[succeed|fail] [apply=[user|@group]] [quiet]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> pam_listfile <?><?> <?><?><?><?><?> PAM <?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> item <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       -- user <?><?><?> <?><?><?><?><?><?> (<?><?><?><?> PAM_USER) <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> tty <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?> (<?><?>
       <?><?><?><?> <?><?><?><?><?> PAM_TTY) <?><?><?><?>
       <?><?><?><?><?><?><?> rhost <?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?> (<?><?> <?><?><?><?>
       <?><?><?><?><?> PAM_RHOST) <?><?><?><?> <?><?><?><?><?><?><?> <?> ruser
       <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> (<?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> PAM_RUSER) <?><?><?><?>
       <?><?><?><?><?><?> -- <?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?>
       file=filename <?><?><?><?><?><?><?>.  <?><?><?><?> filename
       <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       sense=allow <?><?><?><?><?> <?><?><?><?><?> PAM_SUCCESS
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> sense=deny <?><?><?><?><?> <?><?><?><?><?>
       PAM_AUTH_ERR <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> (<?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> filename <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?>)<?> <?><?> <?><?><?><?><?> <?><?> onerr=succeed
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> PAM_SUCCESS
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?> onerr=fail <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> PAM_AUTH_ERR <?><?>
       PAM_SERVICE_ERR <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> apply=<?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?> (apply=username) <?><?> <?><?> <?><?><?><?>
       <?><?><?><?> (apply=@groupname) <?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> tty<?> rhost <?> shell <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?>.

       <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       item=[tty|user|rhost|ruser|group|shell]
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?> <?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       sense=[allow|deny]
           <?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?>. <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       file=/path/filename
           <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> (plain file)
           <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> (world writable) <?><?><?><?>.

       onerr=[succeed|fail]
           <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>) <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

       apply=[user|@group]
           <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
           item=[user|ruser|group] <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?><?><?> item=[tty|rhost|shell] <?><?><?><?><?>
           <?><?><?><?><?><?> <?> <?><?><?><?> <?><?><?>.

       quiet
           <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?> (<?><?><?>)
           <?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (MODULE TYPES
       PROVIDED)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (auth<?> account<?>
       password <?> session) <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?><?> (RETURN VALUES)
       PAM_AUTH_ERR
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

       PAM_BUF_ERR
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       PAM_IGNORE
           <?><?><?><?><?> <?><?> <?><?><?><?><?> apply <?><?><?><?><?>
           <?><?><?><?><?><?><?>.

       PAM_SERVICE_ERR
           <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>.

       PAM_SUCCESS
           <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> 'ftpusers' <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?> /etc/pam.d/ftpd <?><?><?><?><?><?><?><?><?><?>
       <?><?><?>:

           #
           # deny ftp-access to users listed in the /etc/ftpusers file
           #
           auth    required       pam_listfile.so \
                   onerr=succeed item=user sense=deny file=/etc/ftpusers


       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> /etc/ftpusers <?><?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?>) <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> ftp <?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> /etc/pam.d/login <?><?><?><?><?><?><?> <?><?><?><?>:

           #
           # permit login to users listed in /etc/loginusers
           #
           auth    required       pam_listfile.so \
                   onerr=fail item=user sense=allow file=/etc/loginusers


       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> (login)
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> /etc/loginusers
       <?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> root <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> root
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> root <?><?> /etc/loginusers <?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> su <?><?> <?><?><?><?> <?><?><?><?><?><?>
       root <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       pam.conf(5), pam.d(5), pam(8)

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?><?><?> pam_listfile <?><?><?><?> Michael K. Johnson
       <johnsonm@redhat.com> <?> Elliot Lee <sopwith@cuc.edu> <?><?><?><?><?>
       <?><?><?> <?><?><?>.

Linux-PAM                         01/26/2026                   PAM_LISTFILE(8)