sasl_errstring(3sasl) [opensolaris man page]
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.11 14 Oct 2003 sasl_errstring(3SASL)
Check Out this Related Man Page
sasl_seterror(3SASL) Simple Authentication Security Layer Library Functions sasl_seterror(3SASL) NAME
sasl_seterror - set the error string SYNOPSIS
cc [ flag ... ] file ... -lsasl [ library ... ] #include <sasl/sasl.h> void sasl_seterror(sasl_conn_t *conn, unsigned flags, const char *fmt, ...); DESCRIPTION
The sasl_seterror() interface sets the error string that will be returned by sasl_errdetail(3SASL). Use syslog(3C) style formatting, that is, use printf()--style with %m as the most recent errno error. The sasl_seterror() interface is primarily used by server callback functions and internal plug-ins, for example, with the sasl_authorize_t callback. The sasl_seterror() interface triggers a call to the SASL logging callback, if any, with a level of SASL_LOG_FAIL, unless the SASL_NOLOG flag is set. Make the message string sensitive to the current language setting. If there is no SASL_CB_LANGUAGE callback, message strings must be i- default. Otherwise, UTF-8 is used. Use of RFC 2482 for mixed-language text is encouraged. If the value of conn is NULL, the sasl_seterror() interface fails. PARAMETERS
conn The sasl_conn_t for which the call to sasl_seterror() applies. flags If set to SASL_NOLOG, the call to sasl_seterror() is not logged. fmt A syslog(3C) style format string. RETURN VALUES
sasl_seterror() has no return values. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWlibsasl | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
sasl_errdetail(3SASL), syslog(3C), attributes(5) Whistler, K. and Adams, G. RFC 2482, Language Tagging in Unicode Plain Text. Network Working Group. January 1999. SunOS 5.10 14 Oct 2003 sasl_seterror(3SASL)