librsync  2.3.0
Macros | Functions | Variables
trace.c File Reference

Go to the source code of this file.

Macros

#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. More...
 
LIBRSYNC_EXPORT void rs_trace_set_level (rs_loglevel level)
 Set the least important message severity that will be output. More...
 
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. More...
 

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. More...
 

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

◆ rs_trace_to()

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.

◆ rs_trace_set_level()

LIBRSYNC_EXPORT void rs_trace_set_level ( rs_loglevel  level)

Set the least important message severity that will be output.

See also
Debugging trace and error logging

Definition at line 70 of file trace.c.

◆ rs_supports_trace()

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
Debugging trace and error logging

Definition at line 110 of file trace.c.

Variable Documentation

◆ rs_severities

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.