PAM Library Functions                          pamstrerror(3PAM)



NAME
     pamstrerror - get PAM error message string

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



     const char *pamstrerror(pamhandlet*pamh, int errnum);


DESCRIPTION
     The pamstrerror() 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 pamstart(). If pamstart() returns an error, a null
     PAM handle should be passed.

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

ATRIBUTES
     See attributes(5) for description of  the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability           Stable                     
    
     MT-Level                     MT-Safe with exceptions     
    


SEE ALSO
     pam(3PAM), pamstart(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