Library Logging Interfaces

Macros
#define	metal_fmt(fmt)   fmt
#define	metal_log(level, fmt, ...)
	Emit a log message if the log level permits. More...
#define	metal_err(fmt, args...)   metal_log(METAL_LOG_ERROR, fmt, ##args)
#define	metal_warn(fmt, args...)   metal_log(METAL_LOG_WARNING, fmt, ##args)
#define	metal_info(fmt, args...)   metal_log(METAL_LOG_INFO, fmt, ##args)
#define	metal_dbg(fmt, args...)   metal_log(METAL_LOG_DEBUG, fmt, ##args)

Typedefs
typedef void(*	metal_log_handler) (enum metal_log_level level, const char *format,...)
	Log message handler type. More...

Enumerations
enum	metal_log_level {   METAL_LOG_EMERGENCY , METAL_LOG_ALERT , METAL_LOG_CRITICAL , METAL_LOG_ERROR ,   METAL_LOG_WARNING , METAL_LOG_NOTICE , METAL_LOG_INFO , METAL_LOG_DEBUG }
	Log message priority levels for libmetal. More...

Functions
void	metal_set_log_handler (metal_log_handler handler)
	Set libmetal log handler. More...
metal_log_handler	metal_get_log_handler (void)
	Get the current libmetal log handler. More...
void	metal_set_log_level (enum metal_log_level level)
	Set the level for libmetal logging. More...
enum metal_log_level	metal_get_log_level (void)
	Get the current level for libmetal logging. More...
void	metal_default_log_handler (enum metal_log_level level, const char *format,...)
	Default libmetal log handler. More...

Detailed Description

Macro Definition Documentation

metal_dbg

#define metal_dbg	(		fmt,
			args...
	)		metal_log(METAL_LOG_DEBUG, fmt, ##args)

metal_err

#define metal_err	(		fmt,
			args...
	)		metal_log(METAL_LOG_ERROR, fmt, ##args)

metal_fmt

#define metal_fmt

(

fmt

)

fmt

metal_info

#define metal_info	(		fmt,
			args...
	)		metal_log(METAL_LOG_INFO, fmt, ##args)

metal_log

#define metal_log	(		level,
			fmt,
			...
	)

Value:

        ({                                 \
        if (_metal.common.log_handler && level <= _metal.common.log_level) \
                _metal.common.log_handler(level, metal_fmt(fmt), ## __VA_ARGS__);  \
})

Emit a log message if the log level permits.

Parameters

level	Log level.
fmt	Format string.
...	Variable number of arguments.

metal_warn

#define metal_warn	(		fmt,
			args...
	)		metal_log(METAL_LOG_WARNING, fmt, ##args)

Typedef Documentation

metal_log_handler

typedef void(* metal_log_handler) (enum metal_log_level level, const char *format,...)

Log message handler type.

Enumeration Type Documentation

metal_log_level

enum metal_log_level

Log message priority levels for libmetal.

Enumerator
METAL_LOG_EMERGENCY	system is unusable.
METAL_LOG_ALERT	action must be taken immediately.
METAL_LOG_CRITICAL	critical conditions.
METAL_LOG_ERROR	error conditions.
METAL_LOG_WARNING	warning conditions.
METAL_LOG_NOTICE	normal but significant condition.
METAL_LOG_INFO	informational messages.
METAL_LOG_DEBUG	debug-level messages.

Function Documentation

metal_default_log_handler()

void metal_default_log_handler	(	enum metal_log_level	level,
		const char *	format,
			...
	)

Default libmetal log handler.

This handler prints libmetal log messages to stderr.

Parameters

[in]	level	log message level.
[in]	format	log message format string.

metal_get_log_handler()

metal_log_handler metal_get_log_handler

(

void

)

Get the current libmetal log handler.

Returns

Current log handler.

metal_get_log_level()

enum metal_log_level metal_get_log_level

(

void

)

Get the current level for libmetal logging.

Returns

Current log level.

metal_set_log_handler()

void metal_set_log_handler

(

metal_log_handler

handler

)

Set libmetal log handler.

Parameters

[in]

handler

log message handler.

metal_set_log_level()

void metal_set_log_level

(

enum metal_log_level

level

)

Set the level for libmetal logging.

Parameters

[in]

level

log message level.