Blame shared/nm-glib-aux/nm-logging-fwd.h

Packit Service b23acc
// SPDX-License-Identifier: LGPL-2.1+
Packit Service b23acc
/*
Packit Service b23acc
 * Copyright (C) 2006 - 2018 Red Hat, Inc.
Packit Service b23acc
 * Copyright (C) 2006 - 2008 Novell, Inc.
Packit Service b23acc
 */
Packit Service b23acc
Packit Service b23acc
#ifndef __NM_LOGGING_FWD_H__
Packit Service b23acc
#define __NM_LOGGING_FWD_H__
Packit Service b23acc
Packit Service b23acc
/* Log domains */
Packit Service b23acc
Packit Service b23acc
typedef enum  { /*< skip >*/
Packit Service b23acc
	LOGD_NONE       = 0LL,
Packit Service b23acc
	LOGD_PLATFORM   = (1LL << 0), /* Platform services */
Packit Service b23acc
	LOGD_RFKILL     = (1LL << 1),
Packit Service b23acc
	LOGD_ETHER      = (1LL << 2),
Packit Service b23acc
	LOGD_WIFI       = (1LL << 3),
Packit Service b23acc
	LOGD_BT         = (1LL << 4),
Packit Service b23acc
	LOGD_MB         = (1LL << 5), /* mobile broadband */
Packit Service b23acc
	LOGD_DHCP4      = (1LL << 6),
Packit Service b23acc
	LOGD_DHCP6      = (1LL << 7),
Packit Service b23acc
	LOGD_PPP        = (1LL << 8),
Packit Service b23acc
	LOGD_WIFI_SCAN  = (1LL << 9),
Packit Service b23acc
	LOGD_IP4        = (1LL << 10),
Packit Service b23acc
	LOGD_IP6        = (1LL << 11),
Packit Service b23acc
	LOGD_AUTOIP4    = (1LL << 12),
Packit Service b23acc
	LOGD_DNS        = (1LL << 13),
Packit Service b23acc
	LOGD_VPN        = (1LL << 14),
Packit Service b23acc
	LOGD_SHARING    = (1LL << 15), /* Connection sharing/dnsmasq */
Packit Service b23acc
	LOGD_SUPPLICANT = (1LL << 16), /* Wi-Fi and 802.1x */
Packit Service b23acc
	LOGD_AGENTS     = (1LL << 17), /* Secret agents */
Packit Service b23acc
	LOGD_SETTINGS   = (1LL << 18), /* Settings */
Packit Service b23acc
	LOGD_SUSPEND    = (1LL << 19), /* Suspend/Resume */
Packit Service b23acc
	LOGD_CORE       = (1LL << 20), /* Core daemon and policy stuff */
Packit Service b23acc
	LOGD_DEVICE     = (1LL << 21), /* Device state and activation */
Packit Service b23acc
	LOGD_OLPC       = (1LL << 22),
Packit Service b23acc
	LOGD_INFINIBAND = (1LL << 23),
Packit Service b23acc
	LOGD_FIREWALL   = (1LL << 24),
Packit Service b23acc
	LOGD_ADSL       = (1LL << 25),
Packit Service b23acc
	LOGD_BOND       = (1LL << 26),
Packit Service b23acc
	LOGD_VLAN       = (1LL << 27),
Packit Service b23acc
	LOGD_BRIDGE     = (1LL << 28),
Packit Service b23acc
	LOGD_DBUS_PROPS = (1LL << 29),
Packit Service b23acc
	LOGD_TEAM       = (1LL << 30),
Packit Service b23acc
	LOGD_CONCHECK   = (1LL << 31),
Packit Service b23acc
	LOGD_DCB        = (1LL << 32), /* Data Center Bridging */
Packit Service b23acc
	LOGD_DISPATCH   = (1LL << 33),
Packit Service b23acc
	LOGD_AUDIT      = (1LL << 34),
Packit Service b23acc
	LOGD_SYSTEMD    = (1LL << 35),
Packit Service b23acc
	LOGD_VPN_PLUGIN = (1LL << 36),
Packit Service b23acc
	LOGD_PROXY      = (1LL << 37),
Packit Service b23acc
Packit Service b23acc
	__LOGD_MAX,
Packit Service b23acc
	LOGD_ALL       = (((__LOGD_MAX - 1LL) << 1) - 1LL),
Packit Service b23acc
	LOGD_DEFAULT   = LOGD_ALL & ~(
Packit Service b23acc
	                              LOGD_DBUS_PROPS |
Packit Service b23acc
	                              LOGD_WIFI_SCAN |
Packit Service b23acc
	                              LOGD_VPN_PLUGIN |
Packit Service b23acc
	                              0),
Packit Service b23acc
Packit Service b23acc
	/* aliases: */
Packit Service b23acc
	LOGD_DHCP       = LOGD_DHCP4 | LOGD_DHCP6,
Packit Service b23acc
	LOGD_IP         = LOGD_IP4 | LOGD_IP6,
Packit Service b23acc
} NMLogDomain;
Packit Service b23acc
Packit Service b23acc
static inline NMLogDomain
Packit Service b23acc
LOGD_DHCP_from_addr_family (int addr_family)
Packit Service b23acc
{
Packit Service b23acc
	nm_assert_addr_family (addr_family);
Packit Service b23acc
Packit Service b23acc
	return addr_family == AF_INET6 ? LOGD_DHCP6 : LOGD_DHCP4;
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
/* Log levels */
Packit Service b23acc
typedef enum  { /*< skip >*/
Packit Service b23acc
	LOGL_TRACE,
Packit Service b23acc
	LOGL_DEBUG,
Packit Service b23acc
	LOGL_INFO,
Packit Service b23acc
	LOGL_WARN,
Packit Service b23acc
	LOGL_ERR,
Packit Service b23acc
Packit Service b23acc
	_LOGL_N_REAL, /* the number of actual logging levels */
Packit Service b23acc
Packit Service b23acc
	_LOGL_OFF = _LOGL_N_REAL, /* special logging level that is always disabled. */
Packit Service b23acc
	_LOGL_KEEP,               /* special logging level to indicate that the logging level should not be changed. */
Packit Service b23acc
Packit Service b23acc
	_LOGL_N, /* the number of logging levels including "OFF" */
Packit Service b23acc
} NMLogLevel;
Packit Service b23acc
Packit Service b23acc
gboolean _nm_log_enabled_impl (gboolean mt_require_locking,
Packit Service b23acc
                               NMLogLevel level,
Packit Service b23acc
                               NMLogDomain domain);
Packit Service b23acc
Packit Service b23acc
void _nm_log_impl (const char *file,
Packit Service b23acc
                   guint line,
Packit Service b23acc
                   const char *func,
Packit Service b23acc
                   gboolean mt_require_locking,
Packit Service b23acc
                   NMLogLevel level,
Packit Service b23acc
                   NMLogDomain domain,
Packit Service b23acc
                   int error,
Packit Service b23acc
                   const char *ifname,
Packit Service b23acc
                   const char *con_uuid,
Packit Service b23acc
                   const char *fmt,
Packit Service b23acc
                   ...) _nm_printf (10, 11);
Packit Service b23acc
Packit Service b23acc
static inline NMLogLevel
Packit Service b23acc
nm_log_level_from_syslog (int syslog_level)
Packit Service b23acc
{
Packit Service b23acc
	switch (syslog_level) {
Packit Service b23acc
	case 0 /* LOG_EMERG */   : return LOGL_ERR;
Packit Service b23acc
	case 1 /* LOG_ALERT */   : return LOGL_ERR;
Packit Service b23acc
	case 2 /* LOG_CRIT */    : return LOGL_ERR;
Packit Service b23acc
	case 3 /* LOG_ERR */     : return LOGL_ERR;
Packit Service b23acc
	case 4 /* LOG_WARNING */ : return LOGL_WARN;
Packit Service b23acc
	case 5 /* LOG_NOTICE */  : return LOGL_INFO;
Packit Service b23acc
	case 6 /* LOG_INFO */    : return LOGL_DEBUG;
Packit Service b23acc
	case 7 /* LOG_DEBUG */   : return LOGL_TRACE;
Packit Service b23acc
	default:
Packit Service b23acc
		return syslog_level >= 0 ? LOGL_TRACE : LOGL_ERR;
Packit Service b23acc
	}
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
static inline int
Packit Service b23acc
nm_log_level_to_syslog (NMLogLevel nm_level)
Packit Service b23acc
{
Packit Service b23acc
	switch (nm_level) {
Packit Service b23acc
	case LOGL_ERR:    return 3; /* LOG_ERR */
Packit Service b23acc
	case LOGL_WARN:   return 4; /* LOG_WARN */
Packit Service b23acc
	case LOGL_INFO:   return 5; /* LOG_NOTICE */
Packit Service b23acc
	case LOGL_DEBUG:  return 6; /* LOG_INFO */
Packit Service b23acc
	case LOGL_TRACE:  return 7; /* LOG_DEBUG */
Packit Service b23acc
	default:          return 0; /* LOG_EMERG */
Packit Service b23acc
	}
Packit Service b23acc
}
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
struct timespec;
Packit Service b23acc
Packit Service b23acc
/* this function must be implemented to handle the notification when
Packit Service b23acc
 * the first monotonic-timestamp is fetched. */
Packit Service b23acc
extern void _nm_utils_monotonic_timestamp_initialized (const struct timespec *tp,
Packit Service b23acc
                                                       gint64 offset_sec,
Packit Service b23acc
                                                       gboolean is_boottime);
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
#define _LOGL_TRACE LOGL_TRACE
Packit Service b23acc
#define _LOGL_DEBUG LOGL_DEBUG
Packit Service b23acc
#define _LOGL_INFO  LOGL_INFO
Packit Service b23acc
#define _LOGL_WARN  LOGL_WARN
Packit Service b23acc
#define _LOGL_ERR   LOGL_ERR
Packit Service b23acc
Packit Service b23acc
/* This is the default definition of _NMLOG_ENABLED(). Special implementations
Packit Service b23acc
 * might want to undef this and redefine it. */
Packit Service b23acc
#define _NMLOG_ENABLED(level) ( nm_logging_enabled ((level), (_NMLOG_DOMAIN)) )
Packit Service b23acc
Packit Service b23acc
#define _LOGT(...)          _NMLOG (_LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#define _LOGD(...)          _NMLOG (_LOGL_DEBUG, __VA_ARGS__)
Packit Service b23acc
#define _LOGI(...)          _NMLOG (_LOGL_INFO , __VA_ARGS__)
Packit Service b23acc
#define _LOGW(...)          _NMLOG (_LOGL_WARN , __VA_ARGS__)
Packit Service b23acc
#define _LOGE(...)          _NMLOG (_LOGL_ERR  , __VA_ARGS__)
Packit Service b23acc
Packit Service b23acc
#define _LOGT_ENABLED(...)  _NMLOG_ENABLED (_LOGL_TRACE, ##__VA_ARGS__)
Packit Service b23acc
#define _LOGD_ENABLED(...)  _NMLOG_ENABLED (_LOGL_DEBUG, ##__VA_ARGS__)
Packit Service b23acc
#define _LOGI_ENABLED(...)  _NMLOG_ENABLED (_LOGL_INFO , ##__VA_ARGS__)
Packit Service b23acc
#define _LOGW_ENABLED(...)  _NMLOG_ENABLED (_LOGL_WARN , ##__VA_ARGS__)
Packit Service b23acc
#define _LOGE_ENABLED(...)  _NMLOG_ENABLED (_LOGL_ERR  , ##__VA_ARGS__)
Packit Service b23acc
Packit Service b23acc
#define _LOGT_err(errsv, ...) _NMLOG_err (errsv, _LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#define _LOGD_err(errsv, ...) _NMLOG_err (errsv, _LOGL_DEBUG, __VA_ARGS__)
Packit Service b23acc
#define _LOGI_err(errsv, ...) _NMLOG_err (errsv, _LOGL_INFO , __VA_ARGS__)
Packit Service b23acc
#define _LOGW_err(errsv, ...) _NMLOG_err (errsv, _LOGL_WARN , __VA_ARGS__)
Packit Service b23acc
#define _LOGE_err(errsv, ...) _NMLOG_err (errsv, _LOGL_ERR  , __VA_ARGS__)
Packit Service b23acc
Packit Service b23acc
/* _LOGT() and _LOGt() both log with level TRACE, but the latter is disabled by default,
Packit Service b23acc
 * unless building with --with-more-logging. */
Packit Service b23acc
#if NM_MORE_LOGGING
Packit Service b23acc
#define _LOGt_ENABLED(...)    _NMLOG_ENABLED (_LOGL_TRACE, ##__VA_ARGS__)
Packit Service b23acc
#define _LOGt(...)            _NMLOG (_LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#define _LOGt_err(errsv, ...) _NMLOG_err (errsv, _LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#else
Packit Service b23acc
/* still call the logging macros to get compile time checks, but they will be optimized out. */
Packit Service b23acc
#define _LOGt_ENABLED(...)    ( FALSE && (_NMLOG_ENABLED (_LOGL_TRACE, ##__VA_ARGS__)) )
Packit Service b23acc
#define _LOGt(...)            G_STMT_START { if (FALSE) { _NMLOG (_LOGL_TRACE, __VA_ARGS__); } } G_STMT_END
Packit Service b23acc
#define _LOGt_err(errsv, ...) G_STMT_START { if (FALSE) { _NMLOG_err (errsv, _LOGL_TRACE, __VA_ARGS__); } } G_STMT_END
Packit Service b23acc
#endif
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
/* Some implementation define a second set of logging macros, for a separate
Packit Service b23acc
 * use. As with the _LOGD() macro family above, the exact implementation
Packit Service b23acc
 * depends on the file that uses them.
Packit Service b23acc
 * Still, it encourages a common pattern to have the common set of macros
Packit Service b23acc
 * like _LOG2D(), _LOG2I(), etc. and have _LOG2t() which by default
Packit Service b23acc
 * is disabled at compile time. */
Packit Service b23acc
Packit Service b23acc
#define _NMLOG2_ENABLED(level) ( nm_logging_enabled ((level), (_NMLOG2_DOMAIN)) )
Packit Service b23acc
Packit Service b23acc
#define _LOG2T(...)          _NMLOG2 (_LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#define _LOG2D(...)          _NMLOG2 (_LOGL_DEBUG, __VA_ARGS__)
Packit Service b23acc
#define _LOG2I(...)          _NMLOG2 (_LOGL_INFO , __VA_ARGS__)
Packit Service b23acc
#define _LOG2W(...)          _NMLOG2 (_LOGL_WARN , __VA_ARGS__)
Packit Service b23acc
#define _LOG2E(...)          _NMLOG2 (_LOGL_ERR  , __VA_ARGS__)
Packit Service b23acc
Packit Service b23acc
#define _LOG2T_ENABLED(...)  _NMLOG2_ENABLED (_LOGL_TRACE, ##__VA_ARGS__)
Packit Service b23acc
#define _LOG2D_ENABLED(...)  _NMLOG2_ENABLED (_LOGL_DEBUG, ##__VA_ARGS__)
Packit Service b23acc
#define _LOG2I_ENABLED(...)  _NMLOG2_ENABLED (_LOGL_INFO , ##__VA_ARGS__)
Packit Service b23acc
#define _LOG2W_ENABLED(...)  _NMLOG2_ENABLED (_LOGL_WARN , ##__VA_ARGS__)
Packit Service b23acc
#define _LOG2E_ENABLED(...)  _NMLOG2_ENABLED (_LOGL_ERR  , ##__VA_ARGS__)
Packit Service b23acc
Packit Service b23acc
#define _LOG2T_err(errsv, ...) _NMLOG2_err (errsv, _LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#define _LOG2D_err(errsv, ...) _NMLOG2_err (errsv, _LOGL_DEBUG, __VA_ARGS__)
Packit Service b23acc
#define _LOG2I_err(errsv, ...) _NMLOG2_err (errsv, _LOGL_INFO , __VA_ARGS__)
Packit Service b23acc
#define _LOG2W_err(errsv, ...) _NMLOG2_err (errsv, _LOGL_WARN , __VA_ARGS__)
Packit Service b23acc
#define _LOG2E_err(errsv, ...) _NMLOG2_err (errsv, _LOGL_ERR  , __VA_ARGS__)
Packit Service b23acc
Packit Service b23acc
#if NM_MORE_LOGGING
Packit Service b23acc
#define _LOG2t_ENABLED(...)    _NMLOG2_ENABLED (_LOGL_TRACE, ##__VA_ARGS__)
Packit Service b23acc
#define _LOG2t(...)            _NMLOG2 (_LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#define _LOG2t_err(errsv, ...) _NMLOG2_err (errsv, _LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#else
Packit Service b23acc
/* still call the logging macros to get compile time checks, but they will be optimized out. */
Packit Service b23acc
#define _LOG2t_ENABLED(...)    ( FALSE && (_NMLOG2_ENABLED (_LOGL_TRACE, ##__VA_ARGS__)) )
Packit Service b23acc
#define _LOG2t(...)            G_STMT_START { if (FALSE) { _NMLOG2 (_LOGL_TRACE, __VA_ARGS__); } } G_STMT_END
Packit Service b23acc
#define _LOG2t_err(errsv, ...) G_STMT_START { if (FALSE) { _NMLOG2_err (errsv, _LOGL_TRACE, __VA_ARGS__); } } G_STMT_END
Packit Service b23acc
#endif
Packit Service b23acc
Packit Service b23acc
#define _NMLOG3_ENABLED(level) ( nm_logging_enabled ((level), (_NMLOG3_DOMAIN)) )
Packit Service b23acc
Packit Service b23acc
#define _LOG3T(...)          _NMLOG3 (_LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#define _LOG3D(...)          _NMLOG3 (_LOGL_DEBUG, __VA_ARGS__)
Packit Service b23acc
#define _LOG3I(...)          _NMLOG3 (_LOGL_INFO , __VA_ARGS__)
Packit Service b23acc
#define _LOG3W(...)          _NMLOG3 (_LOGL_WARN , __VA_ARGS__)
Packit Service b23acc
#define _LOG3E(...)          _NMLOG3 (_LOGL_ERR  , __VA_ARGS__)
Packit Service b23acc
Packit Service b23acc
#define _LOG3T_ENABLED(...)  _NMLOG3_ENABLED (_LOGL_TRACE, ##__VA_ARGS__)
Packit Service b23acc
#define _LOG3D_ENABLED(...)  _NMLOG3_ENABLED (_LOGL_DEBUG, ##__VA_ARGS__)
Packit Service b23acc
#define _LOG3I_ENABLED(...)  _NMLOG3_ENABLED (_LOGL_INFO , ##__VA_ARGS__)
Packit Service b23acc
#define _LOG3W_ENABLED(...)  _NMLOG3_ENABLED (_LOGL_WARN , ##__VA_ARGS__)
Packit Service b23acc
#define _LOG3E_ENABLED(...)  _NMLOG3_ENABLED (_LOGL_ERR  , ##__VA_ARGS__)
Packit Service b23acc
Packit Service b23acc
#define _LOG3T_err(errsv, ...) _NMLOG3_err (errsv, _LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#define _LOG3D_err(errsv, ...) _NMLOG3_err (errsv, _LOGL_DEBUG, __VA_ARGS__)
Packit Service b23acc
#define _LOG3I_err(errsv, ...) _NMLOG3_err (errsv, _LOGL_INFO , __VA_ARGS__)
Packit Service b23acc
#define _LOG3W_err(errsv, ...) _NMLOG3_err (errsv, _LOGL_WARN , __VA_ARGS__)
Packit Service b23acc
#define _LOG3E_err(errsv, ...) _NMLOG3_err (errsv, _LOGL_ERR  , __VA_ARGS__)
Packit Service b23acc
Packit Service b23acc
#if NM_MORE_LOGGING
Packit Service b23acc
#define _LOG3t_ENABLED(...)    _NMLOG3_ENABLED (_LOGL_TRACE, ##__VA_ARGS__)
Packit Service b23acc
#define _LOG3t(...)            _NMLOG3 (_LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#define _LOG3t_err(errsv, ...) _NMLOG3_err (errsv, _LOGL_TRACE, __VA_ARGS__)
Packit Service b23acc
#else
Packit Service b23acc
/* still call the logging macros to get compile time checks, but they will be optimized out. */
Packit Service b23acc
#define _LOG3t_ENABLED(...)    ( FALSE && (_NMLOG3_ENABLED (_LOGL_TRACE, ##__VA_ARGS__)) )
Packit Service b23acc
#define _LOG3t(...)            G_STMT_START { if (FALSE) { _NMLOG3 (_LOGL_TRACE, __VA_ARGS__); } } G_STMT_END
Packit Service b23acc
#define _LOG3t_err(errsv, ...) G_STMT_START { if (FALSE) { _NMLOG3_err (errsv, _LOGL_TRACE, __VA_ARGS__); } } G_STMT_END
Packit Service b23acc
#endif
Packit Service b23acc
Packit Service b23acc
/*****************************************************************************/
Packit Service b23acc
Packit Service b23acc
#endif /* __NM_LOGGING_FWD_H__ */