pam_strerror(3) [redhat man page]

PAM_STRERROR(3) 						Programmers' Manual						   PAM_STRERROR(3)

NAME

       pam_strerror - return a textual description of a Linux-PAM error

SYNOPSIS

       #include <security/pam_appl.h>
       or,
       #include <security/pam_modules.h>

       const char * pam_strerror( pam_handle_t *pamh, int pam_error);

DESCRIPTION

       pam_strerror

       This function returns some text describing the Linux-PAM error associated with the pam_error argument.

RETURN VALUE

       On  success  this  function returns a description of the indicated error.  Should the function not recognize the error, ``Unknown Linux-PAM
       error'' is returned.

CONFORMING TO

       DCE-RFC 86.0, October 1995.

BUGS

       This function should be internationalized.

SEE ALSO

       pam(8).

       Also, see the three Linux-PAM Guides, for System administrators, module developers, and application developers.

Linux-PAM 0.70							    1999 Oct 4							   PAM_STRERROR(3)

pam_strerror(3PAM)					       PAM Library Functions						pam_strerror(3PAM)

NAME

       pam_strerror - get PAM error message string

SYNOPSIS

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

       const char *pam_strerror(pam_handle_t*pamh, int errnum);

DESCRIPTION

       The  pam_strerror()  function  maps the PAM error number in errnum to a PAM error message string, and returns a pointer to that string. The
       application should not free or modify the string returned.

       The pamh argument is the  PAM handle obtained by a prior call to pam_start(). If pam_start() returns an error, a null PAM handle should	be
       passed.

ERRORS

       The pam_strerror() function returns the string "Unknown error" if errnum is out-of-range.

ATTRIBUTES

       See attributes(5) for description of the following attributes:

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

SEE ALSO

       pam(3PAM), pam_start(3PAM), attributes(5)

NOTES

       The interfaces in  libpam are MT-Safe only if each thread within the multithreaded application uses its own  PAM handle.

SunOS 5.11							    9 Jul 2003							pam_strerror(3PAM)