[babeltrace.git] / src / lib / logging.h

/*
 * SPDX-License-Identifier: MIT
 *
 * Copyright 2017-2018 Philippe Proulx <pproulx@efficios.com>
 */

#ifndef BABELTRACE_LIB_LOGGING_INTERNAL_H
#define BABELTRACE_LIB_LOGGING_INTERNAL_H

#include "common/macros.h"
#include <stdarg.h>

#ifndef BT_LOG_TAG
# error Please define a tag with BT_LOG_TAG before including this file.
#endif

#define BT_LOG_OUTPUT_LEVEL bt_lib_log_level

#include "logging/log.h"

#define BT_LIB_LOG_LIBBABELTRACE2_NAME "libbabeltrace2"

extern
int bt_lib_log_level;

#define BT_LIB_LOG(_lvl, _fmt, ...)					\
	do {								\
		if (BT_LOG_ON(_lvl)) {					\
			bt_lib_log(_BT_LOG_SRCLOC_FUNCTION, __FILE__,	\
				__LINE__, _lvl, _BT_LOG_TAG,		\
				(_fmt), ##__VA_ARGS__);			\
		}							\
	} while (0)

/* See `CONTRIBUTING.adoc` for usage */
#define BT_LIB_LOGF(_fmt, ...)	BT_LIB_LOG(BT_LOG_FATAL, _fmt, ##__VA_ARGS__)
#define BT_LIB_LOGE(_fmt, ...)	BT_LIB_LOG(BT_LOG_ERROR, _fmt, ##__VA_ARGS__)
#define BT_LIB_LOGW(_fmt, ...)	BT_LIB_LOG(BT_LOG_WARNING, _fmt, ##__VA_ARGS__)
#define BT_LIB_LOGI(_fmt, ...)	BT_LIB_LOG(BT_LOG_INFO, _fmt, ##__VA_ARGS__)
#define BT_LIB_LOGD(_fmt, ...)	BT_LIB_LOG(BT_LOG_DEBUG, _fmt, ##__VA_ARGS__)
#define BT_LIB_LOGT(_fmt, ...)	BT_LIB_LOG(BT_LOG_TRACE, _fmt, ##__VA_ARGS__)

/*
 * Log statement, specialized for the Babeltrace library.
 *
 * This function does NOT check that logging is enabled for level `lvl`:
 * you must check it manually with BT_LOG_ON().
 *
 * Use one of the BT_LIB_LOG*() macros above instead of calling this
 * function directly.
 */
void bt_lib_log(const char *func, const char *file, unsigned line,
		int lvl, const char *tag, const char *fmt, ...);

void bt_lib_log_v(const char *func, const char *file, unsigned line,
		int lvl, const char *tag, const char *fmt, va_list *args);

#define BT_LIB_LOG_AND_APPEND(_lvl, _fmt, ...)				\
	do {								\
		bt_lib_maybe_log_and_append_cause(			\
			_BT_LOG_SRCLOC_FUNCTION, __FILE__,		\
			__LINE__, _lvl, _BT_LOG_TAG,			\
			(_fmt), ##__VA_ARGS__);				\
	} while (0)

/* See `CONTRIBUTING.adoc` for usage */
#define BT_LIB_LOGE_APPEND_CAUSE(_fmt, ...)				\
	BT_LIB_LOG_AND_APPEND(BT_LOG_ERROR, _fmt, ##__VA_ARGS__)
#define BT_LIB_LOGW_APPEND_CAUSE(_fmt, ...)				\
	BT_LIB_LOG_AND_APPEND(BT_LOG_WARNING, _fmt, ##__VA_ARGS__)

/*
 * Like bt_lib_log(), but also appends a cause to the current thread's
 * error object.
 *
 * Note that, unlike bt_lib_log(), this function does check that logging
 * is enabled for level `lvl` before logging. This is to ensure that,
 * even though logging is disabled, the function still appends an error
 * cause, as the error reporting system does not rely on logging.
 *
 * Use one of the BT_LIB_LOG*_APPEND_CAUSE() macros above instead of
 * calling this function directly.
 */
void bt_lib_maybe_log_and_append_cause(const char *func, const char *file,
		unsigned line, int lvl, const char *tag,
		const char *fmt, ...);

#define BT_LIB_LOG_SUPPORTED

#endif /* BABELTRACE_LIB_LOGGING_INTERNAL_H */
Commit	Line	Data
beb0fb75	1	/*
0235b0db	2	* SPDX-License-Identifier: MIT
beb0fb75	3	*
0235b0db	4	* Copyright 2017-2018 Philippe Proulx <pproulx@efficios.com>
beb0fb75 PP	5	*/
beb0fb75 PP	6
0235b0db MJ	7	#ifndef BABELTRACE_LIB_LOGGING_INTERNAL_H
	8	#define BABELTRACE_LIB_LOGGING_INTERNAL_H
	9
91d81473	10	#include "common/macros.h"
476ef981	11	#include <stdarg.h>
beb0fb75	12
44c440bc PP	13	#ifndef BT_LOG_TAG
	14	# error Please define a tag with BT_LOG_TAG before including this file.
	15	#endif
	16
beb0fb75 PP	17	#define BT_LOG_OUTPUT_LEVEL bt_lib_log_level
beb0fb75 PP	18
578e048b	19	#include "logging/log.h"
beb0fb75	20
d5becf10 FD	21	#define BT_LIB_LOG_LIBBABELTRACE2_NAME "libbabeltrace2"
d5becf10 FD	22
61d6f9b1	23	extern
beb0fb75 PP	24	int bt_lib_log_level;
beb0fb75 PP	25
3dca2276 PP	26	#define BT_LIB_LOG(_lvl, _fmt, ...) \
	27	do { \
	28	if (BT_LOG_ON(_lvl)) { \
	29	bt_lib_log(_BT_LOG_SRCLOC_FUNCTION, __FILE__, \
	30	__LINE__, _lvl, _BT_LOG_TAG, \
	31	(_fmt), ##__VA_ARGS__); \
	32	} \
	33	} while (0)
	34
b359e350	35	/* See `CONTRIBUTING.adoc` for usage */
476ef981 PP	36	#define BT_LIB_LOGF(_fmt, ...) BT_LIB_LOG(BT_LOG_FATAL, _fmt, ##__VA_ARGS__)
476ef981 PP	37	#define BT_LIB_LOGE(_fmt, ...) BT_LIB_LOG(BT_LOG_ERROR, _fmt, ##__VA_ARGS__)
770538dd	38	#define BT_LIB_LOGW(_fmt, ...) BT_LIB_LOG(BT_LOG_WARNING, _fmt, ##__VA_ARGS__)
476ef981 PP	39	#define BT_LIB_LOGI(_fmt, ...) BT_LIB_LOG(BT_LOG_INFO, _fmt, ##__VA_ARGS__)
476ef981 PP	40	#define BT_LIB_LOGD(_fmt, ...) BT_LIB_LOG(BT_LOG_DEBUG, _fmt, ##__VA_ARGS__)
ef267d12	41	#define BT_LIB_LOGT(_fmt, ...) BT_LIB_LOG(BT_LOG_TRACE, _fmt, ##__VA_ARGS__)
476ef981 PP	42
	43	/*
	44	* Log statement, specialized for the Babeltrace library.
	45	*
3cd4c495 PP	46	* This function does NOT check that logging is enabled for level `lvl`:
	47	* you must check it manually with BT_LOG_ON().
	48	*
	49	* Use one of the BT_LIB_LOG*() macros above instead of calling this
476ef981 PP	50	* function directly.
476ef981 PP	51	*/
476ef981 PP	52	void bt_lib_log(const char func, const char file, unsigned line,
	53	int lvl, const char tag, const char fmt, ...);
	54
e020d134 PP	55	void bt_lib_log_v(const char func, const char file, unsigned line,
	56	int lvl, const char tag, const char fmt, va_list *args);
	57
3cd4c495 PP	58	#define BT_LIB_LOG_AND_APPEND(_lvl, _fmt, ...) \
	59	do { \
	60	bt_lib_maybe_log_and_append_cause( \
	61	_BT_LOG_SRCLOC_FUNCTION, __FILE__, \
	62	__LINE__, _lvl, _BT_LOG_TAG, \
	63	(_fmt), ##__VA_ARGS__); \
	64	} while (0)
	65
	66	/* See `CONTRIBUTING.adoc` for usage */
	67	#define BT_LIB_LOGE_APPEND_CAUSE(_fmt, ...) \
	68	BT_LIB_LOG_AND_APPEND(BT_LOG_ERROR, _fmt, ##__VA_ARGS__)
	69	#define BT_LIB_LOGW_APPEND_CAUSE(_fmt, ...) \
770538dd	70	BT_LIB_LOG_AND_APPEND(BT_LOG_WARNING, _fmt, ##__VA_ARGS__)
3cd4c495 PP	71
	72	/*
	73	* Like bt_lib_log(), but also appends a cause to the current thread's
	74	* error object.
	75	*
	76	* Note that, unlike bt_lib_log(), this function does check that logging
	77	* is enabled for level `lvl` before logging. This is to ensure that,
	78	* even though logging is disabled, the function still appends an error
	79	* cause, as the error reporting system does not rely on logging.
	80	*
	81	* Use one of the BT_LIB_LOG*_APPEND_CAUSE() macros above instead of
	82	* calling this function directly.
	83	*/
	84	void bt_lib_maybe_log_and_append_cause(const char func, const char file,
	85	unsigned line, int lvl, const char *tag,
	86	const char *fmt, ...);
	87
7151fb67 PP	88	#define BT_LIB_LOG_SUPPORTED
7151fb67 PP	89
beb0fb75	90	#endif /* BABELTRACE_LIB_LOGGING_INTERNAL_H */