$treeview $search $mathjax $extrastylesheet
librsync  2.3.0
$projectbrief
$projectbrief
$searchbox

trace.c File Reference

logging and debugging output. More...

Go to the source code of this file.

Defines

#define MY_NAME   "librsync"

Functions

static void rs_log_va (int level, char const *fn, char const *fmt, va_list va)
LIBRSYNC_EXPORT void rs_trace_to (rs_trace_fn_t *new_impl)
 Set the destination of trace information.
LIBRSYNC_EXPORT void rs_trace_set_level (rs_loglevel level)
 Set the least important message severity that will be output.
void rs_log0 (int level, char const *fn, char const *fmt,...)
LIBRSYNC_EXPORT void rs_trace_stderr (rs_loglevel UNUSED(level), char const *msg)
LIBRSYNC_EXPORT int rs_supports_trace (void)
 Check whether the library was compiled with debugging trace.

Variables

rs_trace_fn_trs_trace_impl = rs_trace_stderr
int rs_trace_level = RS_LOG_INFO
static const char * rs_severities []
 Log severity strings, if any.

Detailed Description

logging and debugging output.

Todo:
Have a bit set in the log level that says not to include the function name.

Definition in file trace.c.


Function Documentation

LIBRSYNC_EXPORT void rs_trace_to ( rs_trace_fn_t new_impl  ) 

Set the destination of trace information.

Set trace callback.

The callback scheme allows for use within applications that may have their own particular ways of reporting errors: log files for a web server, perhaps, and an error dialog for a browser.

Todo:
Do we really need such fine-grained control, or just yes/no tracing?

Definition at line 65 of file trace.c.

LIBRSYNC_EXPORT void rs_trace_set_level ( rs_loglevel  level  ) 

Set the least important message severity that will be output.

See also:
api_trace

Definition at line 70 of file trace.c.

LIBRSYNC_EXPORT int rs_supports_trace ( void   ) 

Check whether the library was compiled with debugging trace.

Returns:
True if the library contains trace code; otherwise false.

If this returns false, then trying to turn trace on will achieve nothing.

See also:
api_trace

Definition at line 110 of file trace.c.


Variable Documentation

const char* rs_severities[] [static]
Initial value:
 {
    "EMERGENCY! ", "ALERT! ", "CRITICAL! ", "ERROR: ", "Warning: ",
    "", "", ""
}

Log severity strings, if any.

Must match ordering in rs_loglevel.

Definition at line 53 of file trace.c.