sasl_errstring(3) [suse man page]

sasl_errstring(10 July 2001)											      sasl_errstring(10 July 2001)

NAME

       sasl_errstring - Translate a SASL return code to a human-readable form

SYNOPSIS

       #include <sasl/sasl.h>

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

DESCRIPTION

       sasl_usererr is called to convert a SASL return code (an integer) into a human readable string. At this time the only language available is
       american english written by programmers (aka gobbledygook).  Note that a server should call sasl_usererr on a  return  code  first  if  the
       string is going to be sent to the client.

       saslerr specifies the error number to convert.

       langlist is currently unused; Use NULL.

       outlang specifies the desired RFC 1766 language for output.  NULL defaults to "en-us," currently the only supported language.

       It  should  be  noted  that  this function is not the recommended means of extracting error code information from SASL, instead application
       should use sasl_errdetail(3), which contains this information (and more)

RETURN VALUE

       Returns the string.  If langlist is NULL, US-ASCII is used.

CONFORMING TO

       RFC 2222

SEE ALSO

       sasl(3), sasl_errdetail(3), sasl_errors(3)

SASL man pages							       SASL					      sasl_errstring(10 July 2001)

sasl_errstring(3SASL)			      Simple Authentication Security Layer Library Functions			     sasl_errstring(3SASL)

NAME

       sasl_errstring - translate a SASL return code to a human-readable form

SYNOPSIS

       cc [ flag ... ] file ... -lsasl	 [ library ... ]
       #include <sasl/sasl.h>

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

DESCRIPTION

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

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

       The sasl_errstring() 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  aNULL  value,  the  default  language,i-
		       default, is used.

       outlang	       The language actually used. The outlang parameter can be NULL. The returned error string is in UTF-8.

RETURN VALUES

       sasl_errstring() returns the string that describes the error that occurred, or NULL, if there was an error retrieving it.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWlibsasl		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       sasl_errors(3SASL), sasl_seterror(3SASL), attributes(5)

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

SunOS 5.10							    14 Oct 2003 					     sasl_errstring(3SASL)