pacemaker 3.0.1-16e74fc4da
Scalable High-Availability cluster resource manager
Loading...
Searching...
No Matches
Macros | Functions | Variables
logging.h File Reference
Core API

Wrappers for and extensions to libqb logging. More...

#include <stdio.h>
#include <stdint.h>
#include <glib.h>
#include <qb/qblog.h>
#include <libxml/tree.h>
#include <assert.h>
#include <crm/common/logging_compat.h>
Include dependency graph for logging.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define LOG_TRACE   (LOG_DEBUG+1)
 
#define LOG_STDOUT   254
 
#define LOG_NEVER   255
 
#define crm_log_output(level, prefix, output)
 
#define CRM_TRACE_INIT_DATA(name)
 
#define do_crm_log(level, fmt, args...)
 Log a message.
 
#define do_crm_log_unlikely(level, fmt, args...)
 Log a message that is likely to be filtered out.
 
#define CRM_LOG_ASSERT(expr)
 
#define CRM_CHECK(expr, failure_action)
 
#define do_crm_log_xml(level, text, xml)
 Log XML line-by-line in a formatted fashion.
 
#define do_crm_log_alias(level, file, function, line, fmt, args...)
 Log a message as if it came from a different code location.
 
#define crm_perror(level, fmt, args...)
 Send a system error message to both the log and stderr.
 
#define crm_log_tag(level, tag, fmt, args...)
 Log a message with a tag (for use with PCMK_trace_tags)
 
#define crm_emerg(fmt, args...)
 
#define crm_crit(fmt, args...)
 
#define crm_err(fmt, args...)
 
#define crm_warn(fmt, args...)
 
#define crm_notice(fmt, args...)
 
#define crm_info(fmt, args...)
 
#define crm_debug(fmt, args...)
 
#define crm_trace(fmt, args...)
 
#define crm_log_xml_crit(xml, text)
 
#define crm_log_xml_err(xml, text)
 
#define crm_log_xml_warn(xml, text)
 
#define crm_log_xml_notice(xml, text)
 
#define crm_log_xml_info(xml, text)
 
#define crm_log_xml_debug(xml, text)
 
#define crm_log_xml_trace(xml, text)
 
#define crm_log_xml_explicit(xml, text)
 

Functions

void crm_enable_blackbox (int nsig)
 
void crm_disable_blackbox (int nsig)
 
void crm_write_blackbox (int nsig, const struct qb_log_callsite *callsite)
 
void crm_update_callsites (void)
 
void crm_log_deinit (void)
 
void crm_log_preinit (const char *entity, int argc, char *const *argv)
 Initializes the logging system and defaults to the least verbose output level.
 
gboolean crm_log_init (const char *entity, uint8_t level, gboolean daemon, gboolean to_stderr, int argc, char **argv, gboolean quiet)
 
void crm_log_args (int argc, char **argv)
 Log the command line (once)
 
void crm_log_output_fn (const char *file, const char *function, int line, int level, const char *prefix, const char *output)
 
void crm_bump_log_level (int argc, char **argv)
 Make logging more verbose.
 
void crm_enable_stderr (int enable)
 
gboolean crm_is_callsite_active (struct qb_log_callsite *cs, uint8_t level, uint32_t tags)
 
unsigned int set_crm_log_level (unsigned int level)
 
unsigned int get_crm_log_level (void)
 
void pcmk_log_xml_as (const char *file, const char *function, uint32_t line, uint32_t tags, uint8_t level, const char *text, const xmlNode *xml)
 Log XML line-by-line in a formatted fashion.
 

Variables

unsigned int crm_log_level
 
unsigned int crm_trace_nonlog
 

Detailed Description

Wrappers for and extensions to libqb logging.

Definition in file logging.h.

Macro Definition Documentation

◆ CRM_CHECK

#define CRM_CHECK ( expr,
failure_action )
Value:
do { \
if (!(expr)) { \
static struct qb_log_callsite *core_cs = NULL; \
if (core_cs == NULL) { \
core_cs = qb_log_callsite_get(__func__, __FILE__, \
"check-assert", \
LOG_TRACE, __LINE__, 0); \
} \
crm_abort(__FILE__, __func__, __LINE__, #expr, \
(core_cs? core_cs->targets: FALSE), TRUE); \
failure_action; \
} \
} while(0)
LOG_TRACE
#define LOG_TRACE
Definition logging.h:38

Definition at line 213 of file logging.h.

◆ crm_crit

#define crm_crit ( fmt,
args... )
Value:
qb_logt(LOG_CRIT, 0, fmt , ##args)

Definition at line 354 of file logging.h.

◆ crm_debug

#define crm_debug ( fmt,
args... )
Value:
do_crm_log_unlikely(LOG_DEBUG, fmt , ##args)
do_crm_log_unlikely
#define do_crm_log_unlikely(level, fmt, args...)
Log a message that is likely to be filtered out.
Definition logging.h:174

Definition at line 368 of file logging.h.

◆ crm_emerg

#define crm_emerg ( fmt,
args... )
Value:
qb_log(LOG_EMERG, fmt , ##args)

Definition at line 353 of file logging.h.

◆ crm_err

#define crm_err ( fmt,
args... )
Value:
qb_logt(LOG_ERR, 0, fmt , ##args)

Definition at line 357 of file logging.h.

◆ crm_info

#define crm_info ( fmt,
args... )
Value:
qb_logt(LOG_INFO, 0, fmt , ##args)

Definition at line 365 of file logging.h.

◆ CRM_LOG_ASSERT

#define CRM_LOG_ASSERT ( expr)
Value:
do { \
if (!(expr)) { \
static struct qb_log_callsite *core_cs = NULL; \
if(core_cs == NULL) { \
core_cs = qb_log_callsite_get(__func__, __FILE__, \
"log-assert", LOG_TRACE, \
__LINE__, 0); \
} \
crm_abort(__FILE__, __func__, __LINE__, #expr, \
core_cs?core_cs->targets:FALSE, TRUE); \
} \
} while(0)

Definition at line 196 of file logging.h.

◆ crm_log_output

#define crm_log_output ( level,
prefix,
output )
Value:
crm_log_output_fn(__FILE__, __func__, __LINE__, level, prefix, output)
crm_log_output_fn
void crm_log_output_fn(const char *file, const char *function, int line, int level, const char *prefix, const char *output)
Definition logging.c:1133

Definition at line 83 of file logging.h.

◆ crm_log_tag

#define crm_log_tag ( level,
tag,
fmt,
args... )
Value:
do { \
uint8_t _level = pcmk__clip_log_level(level); \
\
switch (_level) { \
case LOG_STDOUT: case LOG_NEVER: \
break; \
default: { \
static struct qb_log_callsite *trace_tag_cs = NULL; \
int converted_tag = g_quark_try_string(tag); \
if (trace_tag_cs == NULL) { \
trace_tag_cs = qb_log_callsite_get(__func__, __FILE__, \
fmt, _level, \
__LINE__, \
converted_tag); \
} \
if (crm_is_callsite_active(trace_tag_cs, _level, \
converted_tag)) { \
qb_log_from_external_source(__func__, __FILE__, fmt, \
_level, __LINE__, \
converted_tag , ##args); \
} \
} \
} \
} while (0)
crm_is_callsite_active
gboolean crm_is_callsite_active(struct qb_log_callsite *cs, uint8_t level, uint32_t tags)
Definition logging.c:694
LOG_STDOUT
#define LOG_STDOUT
Definition logging.h:43
LOG_NEVER
#define LOG_NEVER
Definition logging.h:48

Log a message with a tag (for use with PCMK_trace_tags)

Parameters
[in]levelPriority at which to log the message
[in]tagString to tag message with
[in]fmtprintf-style format string for message
[in]argsAny arguments needed by format string
Note
This does nothing when level is LOG_STDOUT.

Definition at line 328 of file logging.h.

◆ crm_log_xml_crit

#define crm_log_xml_crit ( xml,
text )
Value:
do_crm_log_xml(LOG_CRIT, text, xml)
do_crm_log_xml
#define do_crm_log_xml(level, text, xml)
Log XML line-by-line in a formatted fashion.
Definition logging.h:236

Definition at line 372 of file logging.h.

◆ crm_log_xml_debug

#define crm_log_xml_debug ( xml,
text )
Value:
do_crm_log_xml(LOG_DEBUG, text, xml)

Definition at line 377 of file logging.h.

◆ crm_log_xml_err

#define crm_log_xml_err ( xml,
text )
Value:
do_crm_log_xml(LOG_ERR, text, xml)

Definition at line 373 of file logging.h.

◆ crm_log_xml_explicit

#define crm_log_xml_explicit ( xml,
text )
Value:
do { \
static struct qb_log_callsite *digest_cs = NULL; \
digest_cs = qb_log_callsite_get( \
__func__, __FILE__, text, LOG_TRACE, __LINE__, \
crm_trace_nonlog); \
if (digest_cs && digest_cs->targets) { \
do_crm_log_xml(LOG_TRACE, text, xml); \
} \
} while(0)
crm_trace_nonlog
unsigned int crm_trace_nonlog
Definition logging.c:46

Definition at line 380 of file logging.h.

◆ crm_log_xml_info

#define crm_log_xml_info ( xml,
text )
Value:
do_crm_log_xml(LOG_INFO, text, xml)

Definition at line 376 of file logging.h.

◆ crm_log_xml_notice

#define crm_log_xml_notice ( xml,
text )
Value:
do_crm_log_xml(LOG_NOTICE, text, xml)

Definition at line 375 of file logging.h.

◆ crm_log_xml_trace

#define crm_log_xml_trace ( xml,
text )
Value:
do_crm_log_xml(LOG_TRACE, text, xml)

Definition at line 378 of file logging.h.

◆ crm_log_xml_warn

#define crm_log_xml_warn ( xml,
text )
Value:
do_crm_log_xml(LOG_WARNING, text, xml)

Definition at line 374 of file logging.h.

◆ crm_notice

#define crm_notice ( fmt,
args... )
Value:
qb_logt(LOG_NOTICE, 0, fmt , ##args)

Definition at line 363 of file logging.h.

◆ crm_perror

#define crm_perror ( level,
fmt,
args... )
Value:
do { \
uint8_t _level = pcmk__clip_log_level(level); \
\
switch (_level) { \
case LOG_NEVER: \
break; \
default: { \
const char *err = strerror(errno); \
if (_level <= crm_log_level) { \
fprintf(stderr, fmt ": %s (%d)\n" , ##args, err, \
errno); \
} \
/* Pass original level arg since do_crm_log() also declares \
* _level \
*/ \
do_crm_log((level), fmt ": %s (%d)" , ##args, err, errno); \
} \
break; \
} \
} while (0)
crm_log_level
unsigned int crm_log_level
Definition logging.c:45

Send a system error message to both the log and stderr.

Parameters
[in]levelPriority at which to log the message
[in]fmtprintf-style format string for message
[in]argsAny arguments needed by format string
Deprecated
One of the other logging functions should be used with pcmk_strerror() instead.
Note
This is a macro, and level may be evaluated more than once.
Because crm_perror() adds the system error message and error number onto the end of fmt, that information will become extended information if QB_XS is used inside fmt and will not show up in syslog.

Definition at line 299 of file logging.h.

◆ crm_trace

#define crm_trace ( fmt,
args... )
Value:
do_crm_log_unlikely(LOG_TRACE, fmt , ##args)

Definition at line 370 of file logging.h.

◆ CRM_TRACE_INIT_DATA

#define CRM_TRACE_INIT_DATA ( name)
Value:
QB_LOG_INIT_DATA(name)
name
const char * name
Definition cib.c:26

Definition at line 111 of file logging.h.

◆ crm_warn

#define crm_warn ( fmt,
args... )
Value:
qb_logt(LOG_WARNING, 0, fmt , ##args)

Definition at line 360 of file logging.h.

◆ do_crm_log

#define do_crm_log ( level,
fmt,
args... )
Value:
do { \
uint8_t _level = pcmk__clip_log_level(level); \
\
switch (_level) { \
case LOG_STDOUT: \
printf(fmt "\n" , ##args); \
break; \
case LOG_NEVER: \
break; \
default: \
qb_log_from_external_source(__func__, __FILE__, fmt, \
_level, __LINE__, 0 , ##args); \
break; \
} \
} while (0)

Log a message.

Parameters
[in]levelPriority at which to log the message
[in]fmtprintf-style format string literal for message
[in]argsAny arguments needed by format string

Definition at line 149 of file logging.h.

◆ do_crm_log_alias

#define do_crm_log_alias ( level,
file,
function,
line,
fmt,
args... )
Value:
do { \
uint8_t _level = pcmk__clip_log_level(level); \
\
switch (_level) { \
case LOG_STDOUT: \
printf(fmt "\n" , ##args); \
break; \
case LOG_NEVER: \
break; \
default: \
qb_log_from_external_source(function, file, fmt, _level, \
line, 0 , ##args); \
break; \
} \
} while (0)

Log a message as if it came from a different code location.

Parameters
[in]levelPriority at which to log the message
[in]fileSource file name to use instead of FILE
[in]functionSource function name to use instead of func
[in]lineSource line number to use instead of line
[in]fmtprintf-style format string literal for message
[in]argsAny arguments needed by format string

Definition at line 268 of file logging.h.

◆ do_crm_log_unlikely

#define do_crm_log_unlikely ( level,
fmt,
args... )
Value:
do { \
uint8_t _level = pcmk__clip_log_level(level); \
\
switch (_level) { \
case LOG_STDOUT: case LOG_NEVER: \
break; \
default: { \
static struct qb_log_callsite *trace_cs = NULL; \
if (trace_cs == NULL) { \
trace_cs = qb_log_callsite_get(__func__, __FILE__, fmt, \
_level, __LINE__, 0); \
} \
if (crm_is_callsite_active(trace_cs, _level, 0)) { \
qb_log_from_external_source(__func__, __FILE__, fmt, \
_level, __LINE__, 0 , \
##args); \
} \
} \
break; \
} \
} while (0)

Log a message that is likely to be filtered out.

Parameters
[in]levelPriority at which to log the message
[in]fmtprintf-style format string for message
[in]argsAny arguments needed by format string
Note
This does nothing when level is LOG_STDOUT.

Definition at line 174 of file logging.h.

◆ do_crm_log_xml

#define do_crm_log_xml ( level,
text,
xml )
Value:
do { \
uint8_t _level = pcmk__clip_log_level(level); \
static struct qb_log_callsite *xml_cs = NULL; \
\
switch (_level) { \
case LOG_STDOUT: \
case LOG_NEVER: \
break; \
default: \
if (xml_cs == NULL) { \
xml_cs = qb_log_callsite_get(__func__, __FILE__, \
"xml-blob", _level, \
__LINE__, 0); \
} \
if (crm_is_callsite_active(xml_cs, _level, 0)) { \
pcmk_log_xml_as(__FILE__, __func__, __LINE__, 0, \
_level, text, (xml)); \
} \
break; \
} \
} while(0)

Log XML line-by-line in a formatted fashion.

Parameters
[in]levelPriority at which to log the messages
[in]textPrefix for each line
[in]xmlXML to log
Note
This does nothing when level is LOG_STDOUT.

Definition at line 236 of file logging.h.

◆ LOG_NEVER

#define LOG_NEVER   255

Definition at line 48 of file logging.h.

◆ LOG_STDOUT

#define LOG_STDOUT   254

Definition at line 43 of file logging.h.

◆ LOG_TRACE

#define LOG_TRACE   (LOG_DEBUG+1)

Definition at line 38 of file logging.h.

Function Documentation

◆ crm_bump_log_level()

void crm_bump_log_level ( int argc,
char ** argv )

Make logging more verbose.

If logging to stderr is not already enabled when this function is called, enable it. Otherwise, increase the log level by 1.

Parameters
[in]argcIgnored
[in]argvIgnored

Definition at line 1092 of file logging.c.

◆ crm_disable_blackbox()

void crm_disable_blackbox ( int nsig)

Definition at line 503 of file logging.c.

◆ crm_enable_blackbox()

void crm_enable_blackbox ( int nsig)

Definition at line 497 of file logging.c.

◆ crm_enable_stderr()

void crm_enable_stderr ( int enable)

Definition at line 1071 of file logging.c.

◆ crm_is_callsite_active()

gboolean crm_is_callsite_active ( struct qb_log_callsite * cs,
uint8_t level,
uint32_t tags )

Definition at line 694 of file logging.c.

◆ crm_log_args()

void crm_log_args ( int argc,
char ** argv )

Log the command line (once)

Parameters
[in]Numberof values in argv
[in]Command-linearguments (including command name)
Note
This function will only log once, even if called with different arguments.

Definition at line 1118 of file logging.c.

◆ crm_log_deinit()

void crm_log_deinit ( void )

Definition at line 134 of file logging.c.

◆ crm_log_init()

gboolean crm_log_init ( const char * entity,
uint8_t level,
gboolean daemon,
gboolean to_stderr,
int argc,
char ** argv,
gboolean quiet )

Definition at line 923 of file logging.c.

◆ crm_log_output_fn()

void crm_log_output_fn ( const char * file,
const char * function,
int line,
int level,
const char * prefix,
const char * output )

Definition at line 1133 of file logging.c.

◆ crm_log_preinit()

void crm_log_preinit ( const char * entity,
int argc,
char *const * argv )

Initializes the logging system and defaults to the least verbose output level.

Parameters
[in]entityIf not NULL, will be used as the identity for logging purposes
[in]argcThe number of command line parameters
[in]argvThe command line parameter values

Definition at line 823 of file logging.c.

◆ crm_update_callsites()

void crm_update_callsites ( void )

Definition at line 723 of file logging.c.

◆ crm_write_blackbox()

void crm_write_blackbox ( int nsig,
const struct qb_log_callsite * callsite )

Definition at line 519 of file logging.c.

◆ get_crm_log_level()

unsigned int get_crm_log_level ( void )

Definition at line 1103 of file logging.c.

◆ pcmk_log_xml_as()

void pcmk_log_xml_as ( const char * file,
const char * function,
uint32_t line,
uint32_t tags,
uint8_t level,
const char * text,
const xmlNode * xml )

Log XML line-by-line in a formatted fashion.

Parameters
[in]fileFile name to use for log filtering
[in]functionFunction name to use for log filtering
[in]lineLine number to use for log filtering
[in]tagsLogging tags to use for log filtering
[in]levelPriority at which to log the messages
[in]textPrefix for each line
[in]xmlXML to log
Note
This does nothing when level is LOG_STDOUT.
Do not call this function directly. It should be called only from the do_crm_log_xml() macro.

Definition at line 1190 of file logging.c.

◆ set_crm_log_level()

unsigned int set_crm_log_level ( unsigned int level)

Definition at line 1057 of file logging.c.

Variable Documentation

◆ crm_log_level

unsigned int crm_log_level
extern
Deprecated
Do not use

Definition at line 45 of file logging.c.

◆ crm_trace_nonlog

unsigned int crm_trace_nonlog
extern
Deprecated
Do not use

Definition at line 46 of file logging.c.

Generated on Thu Aug 7 2025 12:04:48 for pacemaker by doxygen 1.12.0