SASL_ERRSTRING(3SASL) Simple Authentication Security Layer Library Functions
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_errdetail(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
the
langlist parameter has a
NULL 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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | Safe |
+--------------------+-----------------+
SEE ALSO
sasl_errors(3SASL),
sasl_seterror(3SASL),
attributes(7) Alvestrand, H.
RFC 1766, Tags for the Identification of Languages.
Network Working Group. November 1995.
October 14, 2003 SASL_ERRSTRING(3SASL)
