PAM Library Functions				   pam_exts(3PAM)



NAME
     pam_eval -	module control over PAM	configuration

SYNOPSIS
     cc	[ flag ... ] file ... -lpam [ library ... ] #include
     <security/pam_appl.h> #include <security/pam_modules.h>

     int pam_eval(pam_handle_t *pamh, const char *conf_path);

DESCRIPTION
     pam_eval()	causes PAM to evaluate the configuration for the
     current stack (auth, account, password or session)	listed in
     the file named by conf_path.  If conf_path	is not an
     absolute path then	"/usr/lib/security/" will be prepended to
     it.

     pam_eval()	does not have non-local	exits, so if a binding
     module in the given conf_path returns a status other than
     PAM_IGNORE	then pam_eval()	still returns to its caller.

     The named configuration file has the same format as
     pam.conf(4) and must include the service name field just as
     /etc/pam.conf.  pam_eval()	will load the configuration for
     the PAM_SERVICE from conf_path or,	if none	can be found, for
     the "other" service, as usual.

RETURN VALUES
     pam_eval()	returns	the value produced by evaluating the
     given configuration (including PAM_SYSTEM_ERR if the
     configuration could not be	loaded or parsed).  If all
     modules in	the named configuration	return PAM_IGNORE then
     pam_eval()	returns	PAM_IGNORE as well, rather than	the
     default error for the current stack (e.g.,	PAM_AUTH_ERR).

ATTRIBUTES
     See attributes(5) for descriptions	of the following
     attributes:

     ____________________________________________________________
     |	     ATTRIBUTE TYPE	   |	   ATTRIBUTE VALUE
     |
     |_____________________________|_____________________________|
     | Interface Stability	   | Stable
     |
     |_____________________________|_____________________________|
     | MT-Level			   | MT-Safe with exceptions
     |
     |_____________________________|_____________________________|

SEE ALSO
     pam(3PAM),	pam.conf(4), pam_unix_user_policy(5).




21/Apr/105		Last change: 5.11			1






PAM Library Functions				   pam_exts(3PAM)























































21/Apr/105		Last change: 5.11			2