sasl_errdetail(3SASL) Simple Authentication Security Layer Library Functions sasl_errdetail(3SASL)NAME
sasl_errdetail - retrieve detailed information about an error
SYNOPSIS
cc [ flag ... ] file ... -lsasl [ library ... ]
#include <sasl/sasl.h>
const char * sasl_errdetail(sasl_conn_t *conn);
DESCRIPTION
The sasl_errdetail() interface returns an internationalized string that is a message that describes the error that occurred on a SASL con-
nection. The sasl_errdetail() interface provides a more user friendly error message than the SASL error code returned when SASL indicates
that an error has occurred on a connection. See sasl_errors(3SASL).
PARAMETERS
conn The SASL connection context for which the inquiry is made.
RETURN VALUES
sasl_errdetail() 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)SunOS 5.10 14 Oct 2003 sasl_errdetail(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)