# phpman > man > PAM_DEBUG(8)

[PAM_DEBUG(8)](https://www.chedong.com/phpMan.php/man/PAMDEBUG/8/markdown)                              Linux-PAM Manual                              [PAM_DEBUG(8)](https://www.chedong.com/phpMan.php/man/PAMDEBUG/8/markdown)



## NAME
       pam_debug - PAM module to debug the PAM stack

## SYNOPSIS
       **pam**___**debug.so** [auth=_value_] [cred=_value_] [acct=_value_] [prechauthtok=_value_] [chauthtok=_value_]
                    [auth=_value_] [open_session=_value_] [close_session=_value_]

## DESCRIPTION
       The pam_debug PAM module is intended as a debugging aide for determining how the PAM stack is
       operating. This module returns what its module arguments tell it to return.

## OPTIONS
       **auth=**_value_
           The **pam**___**sm**___**[authenticate**(3)](https://www.chedong.com/phpMan.php/man/authenticate/3/markdown) function will return _value_.

       **cred=**_value_
           The **pam**___**sm**___**[setcred**(3)](https://www.chedong.com/phpMan.php/man/setcred/3/markdown) function will return _value_.

       **acct=**_value_
           The **pam**___**sm**___**acct**___**[mgmt**(3)](https://www.chedong.com/phpMan.php/man/mgmt/3/markdown) function will return _value_.

       **prechauthtok=**_value_
           The **pam**___**sm**___**[chauthtok**(3)](https://www.chedong.com/phpMan.php/man/chauthtok/3/markdown) function will return _value_ if the _PAM_PRELIM_CHECK_ flag is set.

       **chauthtok=**_value_
           The **pam**___**sm**___**[chauthtok**(3)](https://www.chedong.com/phpMan.php/man/chauthtok/3/markdown) function will return _value_ if the _PAM_PRELIM_CHECK_ flag is **not**
           set.

       **open**___**session=**_value_
           The **pam**___**sm**___**open**___**[session**(3)](https://www.chedong.com/phpMan.php/man/session/3/markdown) function will return _value_.

       **close**___**session=**_value_
           The **pam**___**sm**___**close**___**[session**(3)](https://www.chedong.com/phpMan.php/man/session/3/markdown) function will return _value_.

       Where _value_ can be one of: success, open_err, symbol_err, service_err, system_err, buf_err,
       perm_denied, auth_err, cred_insufficient, authinfo_unavail, user_unknown, maxtries,
       new_authtok_reqd, acct_expired, session_err, cred_unavail, cred_expired, cred_err,
       no_module_data, conv_err, authtok_err, authtok_recover_err, authtok_lock_busy,
       authtok_disable_aging, try_again, ignore, abort, authtok_expired, module_unknown, bad_item,
       conv_again, incomplete.

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

## RETURN VALUES
       PAM_SUCCESS
           Default return code if no other value was specified, else specified return value.

## EXAMPLES
           auth    requisite       pam_permit.so
           auth    [success=2 default=ok]  pam_debug.so auth=perm_denied cred=success
           auth    [default=reset]         pam_debug.so auth=success cred=perm_denied
           auth    [success=done default=die] pam_debug.so
           auth    optional        pam_debug.so auth=perm_denied cred=perm_denied
           auth    sufficient      pam_debug.so auth=success cred=success


## SEE ALSO
       [**pam.conf**(5)](https://www.chedong.com/phpMan.php/man/pam.conf/5/markdown), [**pam.d**(5)](https://www.chedong.com/phpMan.php/man/pam.d/5/markdown), [**pam**(7)](https://www.chedong.com/phpMan.php/man/pam/7/markdown)

## AUTHOR
       pam_debug was written by Andrew G. Morgan <<morgan@kernel.org>>.



Linux-PAM Manual                             06/08/2020                                 [PAM_DEBUG(8)](https://www.chedong.com/phpMan.php/man/PAMDEBUG/8/markdown)