log.h File Reference

Simple message logging. More...

#include <das3/util.h>

Include dependency graph for log.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	daslog_trace(M)   daslog(DASLOG_TRACE, __FILE__, __LINE__, M)
	Macro wrapper around das_log() for TRACE messages with out variable args.
#define	daslog_debug(M)   daslog(DASLOG_DEBUG, __FILE__, __LINE__, M)
	Macro wrapper around das_log() for DEBUG messages with out variable args.
#define	daslog_info(M)   daslog(DASLOG_INFO, __FILE__, __LINE__, M)
	Macro wrapper around das_log() for INFO messages with out variable args.
#define	daslog_warn(M)   daslog(DASLOG_WARN, __FILE__, __LINE__, M)
	Macro wrapper around das_log() for WARNING messages with out variable args.
#define	daslog_error(M)   daslog(DASLOG_ERROR, __FILE__, __LINE__, M)
	Macro wrapper around das_log() for ERROR messages with out variable args.
#define	daslog_critical(M)   daslog(DASLOG_CRIT, __FILE__, __LINE__, M)
	Macro wrapper around das_log() for CRITICAL messages with out variable args.
#define	daslog_trace_v(F, ...)    daslog(DASLOG_TRACE, __FILE__, __LINE__, F, __VA_ARGS__)
	Macro wrapper around das_log() for TRACE messages with variable arguments.
#define	daslog_debug_v(F, ...)    daslog(DASLOG_DEBUG, __FILE__, __LINE__, F, __VA_ARGS__)
	Macro wrapper around das_log() for DEBUG messages with variable arguments.
#define	daslog_info_v(F, ...)    daslog(DASLOG_INFO, __FILE__, __LINE__, F, __VA_ARGS__)
	Macro wrapper around das_log() for INFO messages with variable arguments.
#define	daslog_warn_v(F, ...)    daslog(DASLOG_WARN, __FILE__, __LINE__, F, __VA_ARGS__)
	Macro wrapper around das_log() for WARNING messages with variable arguments.
#define	daslog_error_v(F, ...)    daslog(DASLOG_ERROR, __FILE__, __LINE__, F, __VA_ARGS__)
	Macro wrapper around das_log() for ERROR messages with variable arguments.
#define	daslog_critical_v(F, ...)    daslog(DASLOG_CRIT, __FILE__, __LINE__, F, __VA_ARGS__)
	Macro wrapper around das_log() for CRITICAL messages with variable arguments.

Functions
DAS_API int	daslog_level (void)
	Get the log level.
DAS_API int	daslog_setlevel (int nLevel)
	Set the logging level for this thread.
DAS_API int	daslog_strlevel (const char *sLevel)
	Get a logging level integer from a string.
DAS_API const char *	daslog_levelstr (int nLevel)
	The opposite of daslog_strlevel(), returns a string appropriate for the log level indicated.
DAS_API bool	daslog_set_showline (int nLevel)
	Output source file and line numbers for messages at or above this level.
DAS_API das_log_handler_t	daslog_sethandler (das_log_handler_t new_handler)
	Install a new message handler function for this thread.

Detailed Description

Simple message logging.

Generic thread safe logging. By default messages are simply printed to standard error, use das_log_sethandler() to send messages some where else. All log messages are sent via das_log(), however the following convenience macros make for less typing:

• daslog_trace(): Log a DAS_LL_TRACE level message.
• daslog_trace_v(): Log a DAS_LL_TRACE level message using fprintf style varargs.
• daslog_debug(): Log a DAS_LL_DEBUG level message.
• daslog_debug_v(): Log a DAS_LL_DEBUG level message using fprintf style varargs.
• daslog_info(): Log a DAS_LL_NOTICE level message.
• daslog_info_v(): Log a DAS_LL_NOTICE level message using fprintf style varargs.
• daslog_warn(): Log a DAS_LL_WARN level message.
• daslog_warn_v(): Log a DAS_LL_WARN level message using fprintf style varargs.
• daslog_error(): Log a DAS_LL_ERROR level message.
• daslog_error_v(): Log a DAS_LL_ERROR level message using fprintf style varargs.
• daslog_critical(): Log a DAS_LL_CRITICAL level message, these should be reserved for program exit conditions.
• daslog_critical_v(): Log a DAS_LL_CRITICAL level message using fprintf style varargs, these should be reserved for program exit conditions.

For example a log line such as:

das_warn_v("File %s, Pkt %05d: Header Block > 256 bytes", sFile, nIdx);

is equivalent to:

das_log(DAS_LL_WARN, __FILE__, __LINE__, 
        "File %s, Pkt %05d: Header Block > 256 bytes", sFile, nIdx);

but shorter.