qb_log_format_set(3)

Usage

#include <qb/qblog.h>

void qb_log_format_set(
    int32_t       t,
    const char   *format
);

Overview

%n FUNCTION NAME

%f FILENAME

%l FILELINE

%p PRIORITY

%t TIMESTAMP

%T TIMESTAMP with milliseconds

%b BUFFER

%g TAGS

%N name (passed into qb_log_init)

%P PID

%H hostname

Any number between % and character specify field length to pad or chop.

Note

Some of the fields are immediately evaluated and remembered for performance reasons, so whenlog messages carry PIDs (not the default) this function needs to be reinvoked following fork (clone) in the respective children. When already linking with libpthread, pthread_atfork callback registration could be useful.

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

qb_log_filter_fn_set(3) Instead of using the qb_log_filter_ctl() functions you can apply the filters manually by defining a callback and setting the targets field using qb_bit_set() and qb_bit_clear() like the following below: qb_log_from_external_source_va2(3) qb_log_thread_start(3) Start the logging pthread. qb_log_target_user_data_get(3) Retrieve the user data set by either qb_log_custom_open or qb_log_target_user_data_set. qb_log_tags_stringify_fn_set(3) Set the callback to map the 'tags' bit map to a string. qb_log_file_reopen(3) Open a new log file for an existing target. qb_log_fini(3) Logging system finalization function. qb_log_callsites_dump(3) Dump the callsite info to stdout. qb_log_ctl2(3) Extension of main logging control function accepting also strings. qb_log_target_user_data_set(3) Associate user data with this log target. qb_log_target_format(3) Format the callsite and timestamp info according to the format. qb_log_thread_priority_set(3) When using threaded logging set the pthread policy and priority. qb_log_facility2int(3) Convert string "auth" to equivalent number "LOG_AUTH" etc. qb_log_callsites_register(3) If you are using dynamically loadable modules via dlopen() and you load them after qb_log_init() then after you load the module you will need to do the following to get the filters to work in that module: qb_log_filter_ctl2(3) This extends qb_log_filter_ctl() by been able to provide a high_priority. qb_log_file_close(3) Close a log file and release its resources. qb_log_real_(3) Internal function: use qb_log() or qb_logt(). qb_log_from_external_source_va(3) qb_log_callsite_get(3) Get or create a callsite at the given position. qb_log_blackbox_write_to_file(3) Write the blackbox to file. qb_log_real_va_(3) qb_log_from_external_source(3) This function is to import logs from other code (like libraries) that provide a callback with their logs. qb_log_blackbox_print_from_file(3) Read the blackbox for file and print it out. qb_log_facility2str(3) Convert number "LOG_AUTH" to equivalent string "auth" etc. qb_log_callsite_get2(3) qb_log_ctl(3) Main logging control function. qb_log_filter_ctl(3) This allows you modify the 'tags' and 'targets' callsite fields at runtime. qb_log_custom_close(3) Close a custom log target and release its resources. qb_log_init(3) Init the logging system. qb_log_file_open(3) Open a log file. qb_log_custom_open(3) Open a custom log target.

Referred to by

qblog.h(3) The logging API provides four main parts (basics, filtering, threading & blackbox). qb_log_ctl(3) Main logging control function. qb_log_ctl2(3) Extension of main logging control function accepting also strings. qb_log_fini(3) Logging system finalization function. qb_log_init(3) Init the logging system. qb_log_real_(3) Internal function: use qb_log() or qb_logt(). qb_log_real_va_(3) qb_log_file_open(3) Open a log file. qb_log_file_close(3) Close a log file and release its resources. qb_log_filter_ctl(3) This allows you modify the 'tags' and 'targets' callsite fields at runtime. qb_log_custom_open(3) Open a custom log target. qb_log_file_reopen(3) Open a new log file for an existing target. qb_log_filter_ctl2(3) This extends qb_log_filter_ctl() by been able to provide a high_priority. qb_log_callsite_get(3) Get or create a callsite at the given position. qb_log_custom_close(3) Close a custom log target and release its resources. qb_log_facility2int(3) Convert string "auth" to equivalent number "LOG_AUTH" etc. qb_log_facility2str(3) Convert number "LOG_AUTH" to equivalent string "auth" etc. qb_log_thread_start(3) Start the logging pthread. qb_log_filter_fn_set(3) Instead of using the qb_log_filter_ctl() functions you can apply the filters manually by defining a callback and setting the targets field using qb_bit_set() and qb_bit_clear() like the following below: qb_log_target_format(3) Format the callsite and timestamp info according to the format. qb_log_callsites_dump(3) Dump the callsite info to stdout. qb_log_callsites_register(3) If you are using dynamically loadable modules via dlopen() and you load them after qb_log_init() then after you load the module you will need to do the following to get the filters to work in that module: qb_log_thread_priority_set(3) When using threaded logging set the pthread policy and priority. qb_log_from_external_source(3) This function is to import logs from other code (like libraries) that provide a callback with their logs. qb_log_target_user_data_get(3) Retrieve the user data set by either qb_log_custom_open or qb_log_target_user_data_set. qb_log_target_user_data_set(3) Associate user data with this log target. qb_log_tags_stringify_fn_set(3) Set the callback to map the 'tags' bit map to a string. qb_log_blackbox_write_to_file(3) Write the blackbox to file. qb_log_from_external_source_va(3) qb_log_blackbox_print_from_file(3) Read the blackbox for file and print it out.

Usage

Overview

Note

Releases

See also

Referred to by