PAM_USERDB(8)                  Linux-PAM Manual                  PAM_USERDB(8)

<?><?><?> (NAME)
       pam_userdb - <?><?><?><?><?> PAM <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       pam_userdb.so db=/path/database [debug] [crypt=[crypt|none]] [icase]
                     [dump] [try_first_pass] [use_first_pass] [unknown_ok]
                     [key_only]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> pam_userdb <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?>/<?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> Berkeley DB
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       crypt=[crypt|none]
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?><?> crypt <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> crypt(3)
           <?><?><?><?><?> <?><?><?><?>. <?><?><?> none <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?> (plaintext) <?><?><?><?><?> <?><?><?><?>.

       db=/path/database
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
           /path/database <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.
           <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> PAM_IGNORE <?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> .db <?><?><?><?> <?><?><?>.

       debug
           <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>.
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> syslog <?><?><?>
           <?><?><?><?><?><?> <?><?>.

       dump
           <?><?><?><?><?> (dump) <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?>. <?><?><?> <?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>!

       icase
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?>).
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?><?>.

       try_first_pass
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?>. <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           (stacking) <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?>.

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

       unknown_ok
           <?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?>. <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?><?>
           pam_userdb <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?>
           <?><?><?> <?><?><?><?><?><?>/<?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

       key_only
           <?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           'username-password' <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?>.

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

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

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

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

       PAM_CONV_ERR
           <?><?><?><?> <?><?> <?><?><?><?><?> (conversation).

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

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

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

<?><?><?><?><?><?><?> (EXAMPLES)
           auth  sufficient pam_userdb.so icase db=/etc/dbtest


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       crypt(3)<?> pam.conf(5)<?> pam.d(5)<?> pam(7)

<?><?><?><?><?><?><?> (AUTHOR)
       pam_userdb <?><?><?><?> Cristian Gafton <gafton@redhat.com>
       <?><?><?><?><?> <?><?><?> <?><?><?>.

Linux-PAM                         06/29/2025                     PAM_USERDB(8)