opensolaris man page for sasl_log_t

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.11							    27 Oct 2003 						 sasl_log_t(3SASL)