Logging API
[State Utility Library]

Defines
#define	SUL_LVL_1   1
#define	SUL_LVL_2   2
#define	SUL_LVL_3   3
#define	SUL_LVL_4   4
#define	SUL_LVL_5   5
#define	SUL_LVL_6   6
#define	SUL_LVL_7   7
#define	SUL_LVL_8   8
#define	SUL_LVL_9   9
Functions
	sul_logging_create (apr_pool_t *pool)
	sul_logging_level_set (long level)
	sul_logging_toggle (sul_boolean_t enabled)
	sul_logging_destroy (void)
	sul_log_info (long level, const char *msg,...)
	sul_log_fatal (const char *msg,...)
	sul_log_warn (const char *msg,...)
	sul_log_debug (const char *msg,...)
	sul_log_error (const char *msg,...)
	sul_log (const char *facility, const char *msg,...)
	sul_vlog (const char *facility, const char *msg, va_list var_args)
	sul_logfile (const char *facility, const char *msg,...)

---

Function Documentation

sul_log (  const char *  facility, const char *  msg, ...  )

Logs a message to the logging stream. Parameters: facility  Facility to record the message into. msg  Message to be logged including any format specifiers.

sul_log_debug (  const char *  msg, ...  )

Logs a message to the logging stream. Parameters: msg  Message to be logged including any format specifiers.

sul_log_error (  const char *  msg, ...  )

Logs a message to the logging stream. Parameters: msg  Message to be logged including any format specifiers.

sul_log_fatal (  const char *  msg, ...  )

Logs a message to the logging stream. Parameters: msg  Message to be logged including any format specifiers.

sul_log_info (  long  level, const char *  msg, ...  )

Logs a message to the logging stream. Parameters: level  Numeric level representing the verbository of this message. msg  Message to be logged including any format specifiers.

sul_log_warn (  const char *  msg, ...  )

Logs a message to the logging stream. Parameters: msg  Message to be logged including any format specifiers.

sul_logfile (  const char *  facility, const char *  msg, ...  )

Logs a message to the logging stream. Parameters: facility  Facility to record the message into. msg  Message to be logged including any format specifiers.

sul_logging_create (  apr_pool_t *  pool  )

Initializes the logging system. This functions sets up the logging stream and prepares everything for all future log message. Call this before invoking any other logging function. Returns: An sul_error_t instance if an error occured and NULL otherwise.

sul_logging_destroy (  void   )

Destroys the logging system. Returns: An sul_error_t instance if an error occured and NULL otherwise.

sul_logging_level_set (  long  level  )

Sets the logging level. Parameters: level  New logging level.

sul_logging_toggle (  sul_boolean_t  enabled  )

Toggles the logging of data to the standard streams. Parameters: enabled  Flag indicating if logging to standard out is enabled.

sul_vlog (  const char *  facility, const char *  msg, va_list  var_args )

Logs a message to the logging stream. Parameters: facility  Facility to record the message into. msg  Message to be logged including any format specifiers. var_args  Variadiac data to expand the message string.

---