PAM_SUCCEED_IF(8)              Linux-PAM Manual              PAM_SUCCEED_IF(8)

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

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       pam_succeed_if.so [flag...] [condition...]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> pam_succeed_if.so <?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> PAM<?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.

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

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?> (flag) <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>:

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

       use_uid
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
           UID <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?>.

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

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

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

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

       <?><?><?><?><?><?> (Conditions) <?><?> <?><?><?><?> <?><?><?><?><?>:
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       user, uid, gid, shell, home, ruser, rhost, tty <?> service:

       field < number
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> number <?><?><?>.

       field <= number
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?> number <?><?><?>.

       field eq number
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> number <?><?><?>.

       field >= number
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?> number <?><?><?>.

       field > number
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> number <?><?><?>.

       field ne number
           <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?> number <?><?><?>.

       field = string
           <?><?><?><?> <?><?><?><?><?><?> <?><?> string
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

       field != string
           <?><?><?><?> <?><?> string <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?>.

       field =~ glob
           <?><?><?><?> <?><?> glob <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?>.

       field !~ glob
           <?><?><?><?> <?><?> glob <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?>.

       field in item:item:...
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?>.

       field notin item:item:...
           <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?>.

       user ingroup group[:group:....]
           <?><?><?><?><?> <?><?> <?><?><?><?>(<?><?><?>)
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       user notingroup group[:group:....]
           <?><?><?><?><?> <?><?> <?><?><?><?>(<?><?><?>)
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       user innetgr netgroup
           <?><?><?> (user,host) <?><?> netgroup <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?>.

       user notinnetgr group
           <?><?><?> (user,host) <?><?> netgroup <?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?>.

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

<?><?><?><?><?><?> <?><?><?><?><?><?><?> (RETURN VALUES)
       PAM_SUCCESS
           <?><?><?> <?><?><?><?> (true) <?><?><?>.

       PAM_AUTH_ERR
           <?><?><?> <?><?><?><?><?><?> (false) <?><?><?>.

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

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> pam_wheel<?>
       <?><?> <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (fallback) <?><?><?><?> <?><?><?><?> 0
       <?><?><?><?> <?><?><?><?><?> <?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> root <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?>:

           auth required pam_succeed_if.so quiet user ingroup wheel:root


       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> othermodule <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> UID <?><?><?> <?><?> <?><?><?> <?><?><?><?>.
       <?><?><?> <?><?> <?><?> default <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?>.

           type [default=1 success=ignore] pam_succeed_if.so quiet uid > 500
           type required othermodule.so arguments...


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       glob(7), pam(8)

<?><?><?><?><?><?><?> (AUTHOR)
       Nalin Dahyabhai <nalin@redhat.com>

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