Simple Authentication Security Layer Library Functions
                                            saslerrstring(3SASL)



NAME
     saslerrstring - translate a SASL return code  to  a  human-
     readable form

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

     const char * saslerrstring(int saslerr, const char *langlist,
          const char **outlang);


DESCRIPTION
     The saslerrstring() interface is called to convert  a  SASL
     return code from an integer into a human readable string.


     You  should  not  used  the  saslerrstring()  interface  to
     extract  error  code  information  from  SASL.  Applications
     should use  saslerrdetail(3SASL)  instead,  which  contains
     this error information and more.


     The saslerrstring() interface supports only  i-default  and
     i-local at this time.

PARAMETERS
     saslerr     The error number to be translated.


     langlist    A comma-separated list  of  languages.  See  RFC
                 1766.  If thelanglist parameter has aNUL value,
                 the default language,i-default, is used.


     outlang     The language actually used. The outlang  parame-
                 ter can be NUL. The returned error string is in
                 UTF-8.


RETURN VALUES
     saslerrstring() returns the string that describes the error
     that occurred, or NUL, if there was an error retrieving it.

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







SunOS 5.11          Last change: 14 Oct 2003                    1






Simple Authentication Security Layer Library Functions
                                            saslerrstring(3SASL)




           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWlibsasl                 
    
     Interface Stability          Evolving                    
    
     MT-Level                     Safe                        
    


SEE ALSO
     saslerrors(3SASL), saslseterror(3SASL), attributes(5)


     Alvestrand, H. RFC 1766,  Tags  for  the  Identification  of
     Languages. Network Working Group. November 1995.





































SunOS 5.11          Last change: 14 Oct 2003                    2






Simple Authentication Security Layer Library Functions
                                            saslerrstring(3SASL)






















































SunOS 5.11          Last change: 14 Oct 2003                    3