Manual Pages for UNIX Operating System command usage for man pam_strerror

PAM Library Functions                          pam_strerror(3PAM)



NAME
     pam_strerror - get PAM error message string

SYNOPSIS
     cc [ flag... ] file... -lpam [ library... ]
     #include 

     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  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | 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 han-
     dle.








SunOS 5.11           Last change: 9 Jul 2003                    1