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

NAME

       sasl_log_t - the SASL logging callback function

SYNOPSIS

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

       int sasl_log_t(void *context, int level, const char *message);

DESCRIPTION

       Use  the sasl_log_t() function to log warning and error messages from the SASL library. syslog(3C) is used, unless another logging function
       is specified.

PARAMETERS

       context	       The logging context from the callback record.

       level	       The logging level. Possible values for level include:

		       SASL_LOG_NONE	       Do not log anything.

		       SASL_LOG_ERR	       Log unusual errors. This is the default log level.

		       SASL_LOG_FAIL	       Log all authentication failures.

		       SASL_LOG_WARN	       Log non-fatal warnings.

		       SASL_LOG_NOTE	       Log non-fatal warnings (more verbose than SASL_LOG_WARN).

		       SASL_LOG_DEBUG	       Log non-fatal warnings (more verbose than SASL_LOG_NOTE).

		       SASL_LOG_TRACE	       Log traces of internal protocols.

		       SASL_LOG_PASS	       Log traces of internal protocols, including passwords.

       message	       The message to log

RETURN VALUES

       Like other SASL callback functions, sasl_log_t() returns an integer that corresponds to a SASL error code. See <sasl.h> for a complete list
       of SASL error codes.

ERRORS

       SASL_OK	       The call to sasl_log_t() was successful.

       See sasl_errors(3SASL) for information on SASL error codes.

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_errors(3SASL), syslog(3C), attributes(5)

SunOS 5.10							    27 Oct 2003 						 sasl_log_t(3SASL)