|
|
@@ -1,649 +0,0 @@
|
|
|
---- libqb-0.16.0.orig/docs/man3/qblog.h.3 2013-07-25 20:16:18.000000000 +0200
|
|
|
-+++ libqb-0.16.0/docs/man3/qblog.h.3 2013-09-09 05:26:31.703807649 +0200
|
|
|
-@@ -1,4 +1,4 @@
|
|
|
--.TH "qblog.h" 3 "Thu Jul 25 2013" "Version 0.16.0" "libqb" \" -*- nroff -*-
|
|
|
-+.TH "qblog.h" 3 "Mon Sep 9 2013" "Version 0.16.0" "libqb" \" -*- nroff -*-
|
|
|
- .ad l
|
|
|
- .nh
|
|
|
- .SH NAME
|
|
|
-@@ -36,7 +36,7 @@ The logging API provides four main parts
|
|
|
- .br
|
|
|
- .RI "\fIAn instance of this structure is created in a special ELF section at every dynamic debug callsite\&. \fP"
|
|
|
- .in -1c
|
|
|
--.SS "Macros"
|
|
|
-+.SS "Defines"
|
|
|
-
|
|
|
- .in +1c
|
|
|
- .ti -1c
|
|
|
-@@ -117,7 +117,7 @@ The logging API provides four main parts
|
|
|
-
|
|
|
- .in +1c
|
|
|
- .ti -1c
|
|
|
--.RI "enum \fBqb_log_target_state\fP { \fBQB_LOG_STATE_UNUSED\fP = 1, \fBQB_LOG_STATE_DISABLED\fP = 2, \fBQB_LOG_STATE_ENABLED\fP = 3 }"
|
|
|
-+.RI "enum \fBqb_log_target_state\fP { \fBQB_LOG_STATE_UNUSED\fP = 1, \fBQB_LOG_STATE_DISABLED\fP = 2, \fBQB_LOG_STATE_ENABLED\fP = 3 }"
|
|
|
- .br
|
|
|
- .ti -1c
|
|
|
- .RI "enum \fBqb_log_conf\fP { \fBQB_LOG_CONF_ENABLED\fP, \fBQB_LOG_CONF_FACILITY\fP, \fBQB_LOG_CONF_DEBUG\fP, \fBQB_LOG_CONF_SIZE\fP, \fBQB_LOG_CONF_THREADED\fP, \fBQB_LOG_CONF_PRIORITY_BUMP\fP, \fBQB_LOG_CONF_STATE_GET\fP, \fBQB_LOG_CONF_FILE_SYNC\fP }"
|
|
|
-@@ -294,13 +294,13 @@ Call \fBqb_log()\fP to generate a log me
|
|
|
- Simplist possible use:
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--main() {
|
|
|
-- qb_log_init('simple-log', LOG_DAEMON, LOG_INFO);
|
|
|
-+ main() {
|
|
|
-+ qb_log_init('simple-log', LOG_DAEMON, LOG_INFO);
|
|
|
- // \&.\&.\&.
|
|
|
-- qb_log(LOG_WARNING, 'watch out');
|
|
|
-+ qb_log(LOG_WARNING, 'watch out');
|
|
|
- // \&.\&.\&.
|
|
|
-- qb_log_fini();
|
|
|
--}
|
|
|
-+ qb_log_fini();
|
|
|
-+ }
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -313,7 +313,7 @@ A log target can by syslog, stderr, the
|
|
|
- To enable a target do the following
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_ENABLED, QB_TRUE);
|
|
|
-+ qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_ENABLED, QB_TRUE);
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -321,8 +321,8 @@ qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_
|
|
|
- syslog, stderr and the blackbox are static (they don't need to be created, just enabled or disabled\&. However you can open multiple logfiles (32 - QB_LOG_BLACKBOX)\&. To do this use the following code\&.
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--mytarget = qb_log_file_open('/var/log/mylogfile');
|
|
|
--qb_log_ctl(mytarget, QB_LOG_CONF_ENABLED, QB_TRUE);
|
|
|
-+ mytarget = qb_log_file_open('/var/log/mylogfile');
|
|
|
-+ qb_log_ctl(mytarget, QB_LOG_CONF_ENABLED, QB_TRUE);
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -330,7 +330,7 @@ qb_log_ctl(mytarget, QB_LOG_CONF_ENABLED
|
|
|
- Once your targets are enabled/opened you can configure them as follows: Configure the size of blackbox
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_SIZE, 1024*10);
|
|
|
-+ qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_SIZE, 1024*10);
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -338,7 +338,7 @@ qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_
|
|
|
- Make logging to file threaded:
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--qb_log_ctl(mytarget, QB_LOG_CONF_THREADED, QB_TRUE);
|
|
|
-+ qb_log_ctl(mytarget, QB_LOG_CONF_THREADED, QB_TRUE);
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -346,8 +346,8 @@ qb_log_ctl(mytarget, QB_LOG_CONF_THREADE
|
|
|
- To workaround your syslog daemon filtering all messages > LOG_INFO
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--qb_log_ctl(QB_LOG_SYSLOG, QB_LOG_CONF_PRIORITY_BUMP,
|
|
|
-- LOG_INFO - LOG_DEBUG);
|
|
|
-+ qb_log_ctl(QB_LOG_SYSLOG, QB_LOG_CONF_PRIORITY_BUMP,
|
|
|
-+ LOG_INFO - LOG_DEBUG);
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -355,7 +355,7 @@ qb_log_ctl(QB_LOG_SYSLOG, QB_LOG_CONF_PR
|
|
|
- To ensure all logs to file targets are fsync'ed (default QB_FALSE)
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--qb_log_ctl(mytarget, QB_LOG_CONF_FILE_SYNC, QB_TRUE);
|
|
|
-+ qb_log_ctl(mytarget, QB_LOG_CONF_FILE_SYNC, QB_TRUE);
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -375,8 +375,8 @@ format string + priority
|
|
|
- So to make all logs from evil_fnunction() go to stderr do the following:
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--qb_log_filter_ctl(QB_LOG_STDERR, QB_LOG_FILTER_ADD,
|
|
|
-- QB_LOG_FILTER_FUNCTION, 'evil_fnunction', LOG_TRACE);
|
|
|
-+ qb_log_filter_ctl(QB_LOG_STDERR, QB_LOG_FILTER_ADD,
|
|
|
-+ QB_LOG_FILTER_FUNCTION, 'evil_fnunction', LOG_TRACE);
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -384,8 +384,8 @@ qb_log_filter_ctl(QB_LOG_STDERR, QB_LOG_
|
|
|
- So to make all logs from totem* (with a priority <= LOG_INFO) go to stderr do the following:
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--qb_log_filter_ctl(QB_LOG_STDERR, QB_LOG_FILTER_ADD,
|
|
|
-- QB_LOG_FILTER_FILE, 'totem', LOG_INFO);
|
|
|
-+ qb_log_filter_ctl(QB_LOG_STDERR, QB_LOG_FILTER_ADD,
|
|
|
-+ QB_LOG_FILTER_FILE, 'totem', LOG_INFO);
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -393,8 +393,8 @@ qb_log_filter_ctl(QB_LOG_STDERR, QB_LOG_
|
|
|
- So to make all logs with the substring 'ringbuffer' go to stderr do the following:
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--qb_log_filter_ctl(QB_LOG_STDERR, QB_LOG_FILTER_ADD,
|
|
|
-- QB_LOG_FILTER_FORMAT, 'ringbuffer', LOG_TRACE);
|
|
|
-+ qb_log_filter_ctl(QB_LOG_STDERR, QB_LOG_FILTER_ADD,
|
|
|
-+ QB_LOG_FILTER_FORMAT, 'ringbuffer', LOG_TRACE);
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -407,18 +407,18 @@ To achieve non-blocking logging you can
|
|
|
- Threaded logging use:
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--main() {
|
|
|
-- qb_log_init('simple-log', LOG_DAEMON, LOG_INFO);
|
|
|
-- qb_log_ctl(QB_LOG_SYSLOG, QB_LOG_CONF_THREADED, QB_TRUE);
|
|
|
-+ main() {
|
|
|
-+ qb_log_init('simple-log', LOG_DAEMON, LOG_INFO);
|
|
|
-+ qb_log_ctl(QB_LOG_SYSLOG, QB_LOG_CONF_THREADED, QB_TRUE);
|
|
|
- // \&.\&.\&.
|
|
|
- daemonize();
|
|
|
- // call this after you fork()
|
|
|
- qb_log_thread_start();
|
|
|
- // \&.\&.\&.
|
|
|
-- qb_log(LOG_WARNING, 'watch out');
|
|
|
-+ qb_log(LOG_WARNING, 'watch out');
|
|
|
- // \&.\&.\&.
|
|
|
-- qb_log_fini();
|
|
|
--}
|
|
|
-+ qb_log_fini();
|
|
|
-+ }
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -436,28 +436,28 @@ the blackbox is not enabled by default\&
|
|
|
- Blackbox usage:
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--static void sigsegv_handler(int sig)
|
|
|
--{
|
|
|
-+ static void sigsegv_handler(int sig)
|
|
|
-+ {
|
|
|
- (void)signal (SIGSEGV, SIG_DFL);
|
|
|
- qb_log_blackbox_write_to_file('simple-log\&.fdata');
|
|
|
- qb_log_fini();
|
|
|
- raise(SIGSEGV);
|
|
|
--}
|
|
|
-+ }
|
|
|
-
|
|
|
--main() {
|
|
|
-+ main() {
|
|
|
-
|
|
|
-- signal(SIGSEGV, sigsegv_handler);
|
|
|
-+ signal(SIGSEGV, sigsegv_handler);
|
|
|
-
|
|
|
-- qb_log_init('simple-log', LOG_DAEMON, LOG_INFO);
|
|
|
-- qb_log_filter_ctl(QB_LOG_BLACKBOX, QB_LOG_FILTER_ADD,
|
|
|
-- QB_LOG_FILTER_FILE, '*', LOG_DEBUG);
|
|
|
-- qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_SIZE, 1024*10);
|
|
|
-- qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_ENABLED, QB_TRUE);
|
|
|
-+ qb_log_init('simple-log', LOG_DAEMON, LOG_INFO);
|
|
|
-+ qb_log_filter_ctl(QB_LOG_BLACKBOX, QB_LOG_FILTER_ADD,
|
|
|
-+ QB_LOG_FILTER_FILE, '*', LOG_DEBUG);
|
|
|
-+ qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_SIZE, 1024*10);
|
|
|
-+ qb_log_ctl(QB_LOG_BLACKBOX, QB_LOG_CONF_ENABLED, QB_TRUE);
|
|
|
- // \&.\&.\&.
|
|
|
-- qb_log(LOG_WARNING, 'watch out');
|
|
|
-+ qb_log(LOG_WARNING, 'watch out');
|
|
|
- // \&.\&.\&.
|
|
|
-- qb_log_fini();
|
|
|
--}
|
|
|
-+ qb_log_fini();
|
|
|
-+ }
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-@@ -469,7 +469,7 @@ You can tag messages using the second ar
|
|
|
- .PP
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--const char* my_tags_stringify(uint32_t tags) {
|
|
|
-+ const char* my_tags_stringify(uint32_t tags) {
|
|
|
- if (qb_bit_is_set(tags, QB_LOG_TAG_LIBQB_MSG_BIT) {
|
|
|
- return 'libqb';
|
|
|
- } else if (tags == 3) {
|
|
|
-@@ -477,37 +477,33 @@ const char* my_tags_stringify(uint32_t t
|
|
|
- } else {
|
|
|
- return 'MAIN';
|
|
|
- }
|
|
|
--}
|
|
|
--main() {
|
|
|
-+ }
|
|
|
-+ main() {
|
|
|
- // \&.\&.\&.
|
|
|
- qb_log_tags_stringify_fn_set(my_tags_stringify);
|
|
|
- qb_log_format_set(QB_LOG_STDERR, '[%5g] %p %b');
|
|
|
- // \&.\&.\&.
|
|
|
- qb_logt(LOG_INFO, 3, 'hello');
|
|
|
- qb_logt(LOG_INFO, 0, 'hello');
|
|
|
--}
|
|
|
-+ }
|
|
|
- .fi
|
|
|
- .PP
|
|
|
- The code above will produce:
|
|
|
- .PP
|
|
|
- .nf
|
|
|
--[libqb] some message
|
|
|
--[three] info hello
|
|
|
--[MAIN ] info hello
|
|
|
-+ [libqb] some message
|
|
|
-+ [three] info hello
|
|
|
-+ [MAIN ] info hello
|
|
|
-
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-
|
|
|
--.SH "Macro Definition Documentation"
|
|
|
-+.SH "Define Documentation"
|
|
|
- .PP
|
|
|
--.SS "#define LOG_TRACE (LOG_DEBUG + 1)"
|
|
|
--
|
|
|
--.SS "#define qb_enter() \fBqb_log\fP(\fBLOG_TRACE\fP, 'ENTERING %s()', __func__)"
|
|
|
--
|
|
|
--.SS "#define qb_leave() \fBqb_log\fP(\fBLOG_TRACE\fP, 'LEAVING %s()', __func__)"
|
|
|
--
|
|
|
--.SS "#define qb_log(\fBpriority\fP, fmt, args\&.\&.\&.) \fBqb_logt\fP(\fBpriority\fP, 0, fmt, ##args)"
|
|
|
--
|
|
|
-+.SS "#define \fBLOG_TRACE\fP (LOG_DEBUG + 1)"
|
|
|
-+.SS "#define \fBqb_enter\fP() \fBqb_log\fP(\fBLOG_TRACE\fP, 'ENTERING %s()', __func__)"
|
|
|
-+.SS "#define \fBqb_leave\fP() \fBqb_log\fP(\fBLOG_TRACE\fP, 'LEAVING %s()', __func__)"
|
|
|
-+.SS "#define \fBqb_log\fP(\fBpriority\fP, fmt, args\&.\&.\&.) \fBqb_logt\fP(\fBpriority\fP, 0, fmt, ##args)"
|
|
|
- .PP
|
|
|
- This is the main function to generate a log message\&. \fBParameters:\fP
|
|
|
- .RS 4
|
|
|
-@@ -519,34 +515,23 @@ This is the main function to generate a
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "#define QB_LOG_BLACKBOX 2"
|
|
|
--
|
|
|
--.SS "#define QB_LOG_INIT_DATA(name)"
|
|
|
--\fBValue:\fP
|
|
|
-+.SS "#define \fBQB_LOG_BLACKBOX\fP 2"
|
|
|
-+.SS "#define \fBQB_LOG_INIT_DATA\fP(name)"\fBValue:\fP
|
|
|
- .PP
|
|
|
- .nf
|
|
|
- void name(void); \
|
|
|
- void name(void) { if (__start___verbose != __stop___verbose) {assert(1);} } \
|
|
|
- void __attribute__ ((constructor)) name(void);
|
|
|
- .fi
|
|
|
--.SS "#define QB_LOG_MAX_LEN 512"
|
|
|
--
|
|
|
--.SS "#define QB_LOG_STDERR 1"
|
|
|
--
|
|
|
--.SS "#define QB_LOG_STDOUT 3"
|
|
|
--
|
|
|
--.SS "#define QB_LOG_STRERROR_MAX_LEN 128"
|
|
|
--
|
|
|
--.SS "#define QB_LOG_SYSLOG 0"
|
|
|
--
|
|
|
--.SS "#define QB_LOG_TAG_LIBQB_MSG (1 << \fBQB_LOG_TAG_LIBQB_MSG_BIT\fP)"
|
|
|
--
|
|
|
--.SS "#define QB_LOG_TAG_LIBQB_MSG_BIT 31"
|
|
|
--
|
|
|
--.SS "#define QB_LOG_TARGET_MAX 32"
|
|
|
--
|
|
|
--.SS "#define qb_logt(\fBpriority\fP, \fBtags\fP, fmt, args\&.\&.\&.)"
|
|
|
--\fBValue:\fP
|
|
|
-+.SS "#define \fBQB_LOG_MAX_LEN\fP 512"
|
|
|
-+.SS "#define \fBQB_LOG_STDERR\fP 1"
|
|
|
-+.SS "#define \fBQB_LOG_STDOUT\fP 3"
|
|
|
-+.SS "#define \fBQB_LOG_STRERROR_MAX_LEN\fP 128"
|
|
|
-+.SS "#define \fBQB_LOG_SYSLOG\fP 0"
|
|
|
-+.SS "#define \fBQB_LOG_TAG_LIBQB_MSG\fP (1 << \fBQB_LOG_TAG_LIBQB_MSG_BIT\fP)"
|
|
|
-+.SS "#define \fBQB_LOG_TAG_LIBQB_MSG_BIT\fP 31"
|
|
|
-+.SS "#define \fBQB_LOG_TARGET_MAX\fP 32"
|
|
|
-+.SS "#define \fBqb_logt\fP(\fBpriority\fP, \fBtags\fP, fmt, args\&.\&.\&.)"\fBValue:\fP
|
|
|
- .PP
|
|
|
- .nf
|
|
|
- do { \
|
|
|
-@@ -569,8 +554,7 @@ This is the function to generate a log m
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "#define qb_perror(\fBpriority\fP, fmt, args\&.\&.\&.)"
|
|
|
--\fBValue:\fP
|
|
|
-+.SS "#define \fBqb_perror\fP(\fBpriority\fP, fmt, args\&.\&.\&.)"\fBValue:\fP
|
|
|
- .PP
|
|
|
- .nf
|
|
|
- do { \
|
|
|
-@@ -592,24 +576,17 @@ This is similar to perror except it goes
|
|
|
-
|
|
|
- .SH "Typedef Documentation"
|
|
|
- .PP
|
|
|
--.SS "typedef void(* qb_log_close_fn)(int32_t t)"
|
|
|
--
|
|
|
--.SS "typedef void(* qb_log_filter_fn)(struct \fBqb_log_callsite\fP *cs)"
|
|
|
--
|
|
|
--.SS "typedef void(* qb_log_logger_fn)(int32_t t, struct \fBqb_log_callsite\fP *cs, time_t timestamp, const char *msg)"
|
|
|
--
|
|
|
--.SS "typedef void(* qb_log_reload_fn)(int32_t t)"
|
|
|
--
|
|
|
--.SS "typedef const char*(* qb_log_tags_stringify_fn)(uint32_t \fBtags\fP)"
|
|
|
--
|
|
|
--.SS "typedef void(* qb_log_vlogger_fn)(int32_t t, struct \fBqb_log_callsite\fP *cs, time_t timestamp, va_list ap)"
|
|
|
--
|
|
|
-+.SS "typedef void(* \fBqb_log_close_fn\fP)(int32_t t)"
|
|
|
-+.SS "typedef void(* \fBqb_log_filter_fn\fP)(struct \fBqb_log_callsite\fP *cs)"
|
|
|
-+.SS "typedef void(* \fBqb_log_logger_fn\fP)(int32_t t, struct \fBqb_log_callsite\fP *cs, time_t timestamp, const char *msg)"
|
|
|
-+.SS "typedef void(* \fBqb_log_reload_fn\fP)(int32_t t)"
|
|
|
-+.SS "typedef const char*(* \fBqb_log_tags_stringify_fn\fP)(uint32_t \fBtags\fP)"
|
|
|
-+.SS "typedef void(* \fBqb_log_vlogger_fn\fP)(int32_t t, struct \fBqb_log_callsite\fP *cs, time_t timestamp, va_list ap)"
|
|
|
- .SH "Enumeration Type Documentation"
|
|
|
- .PP
|
|
|
- .SS "enum \fBqb_log_conf\fP"
|
|
|
--
|
|
|
- .PP
|
|
|
--\fBEnumerator\fP
|
|
|
-+\fBEnumerator: \fP
|
|
|
- .in +1c
|
|
|
- .TP
|
|
|
- \fB\fIQB_LOG_CONF_ENABLED \fP\fP
|
|
|
-@@ -627,10 +604,10 @@ This is similar to perror except it goes
|
|
|
- \fB\fIQB_LOG_CONF_STATE_GET \fP\fP
|
|
|
- .TP
|
|
|
- \fB\fIQB_LOG_CONF_FILE_SYNC \fP\fP
|
|
|
--.SS "enum \fBqb_log_filter_conf\fP"
|
|
|
-
|
|
|
-+.SS "enum \fBqb_log_filter_conf\fP"
|
|
|
- .PP
|
|
|
--\fBEnumerator\fP
|
|
|
-+\fBEnumerator: \fP
|
|
|
- .in +1c
|
|
|
- .TP
|
|
|
- \fB\fIQB_LOG_FILTER_ADD \fP\fP
|
|
|
-@@ -644,10 +621,10 @@ This is similar to perror except it goes
|
|
|
- \fB\fIQB_LOG_TAG_CLEAR \fP\fP
|
|
|
- .TP
|
|
|
- \fB\fIQB_LOG_TAG_CLEAR_ALL \fP\fP
|
|
|
--.SS "enum \fBqb_log_filter_type\fP"
|
|
|
-
|
|
|
-+.SS "enum \fBqb_log_filter_type\fP"
|
|
|
- .PP
|
|
|
--\fBEnumerator\fP
|
|
|
-+\fBEnumerator: \fP
|
|
|
- .in +1c
|
|
|
- .TP
|
|
|
- \fB\fIQB_LOG_FILTER_FILE \fP\fP
|
|
|
-@@ -655,10 +632,10 @@ This is similar to perror except it goes
|
|
|
- \fB\fIQB_LOG_FILTER_FUNCTION \fP\fP
|
|
|
- .TP
|
|
|
- \fB\fIQB_LOG_FILTER_FORMAT \fP\fP
|
|
|
--.SS "enum \fBqb_log_target_state\fP"
|
|
|
-
|
|
|
-+.SS "enum \fBqb_log_target_state\fP"
|
|
|
- .PP
|
|
|
--\fBEnumerator\fP
|
|
|
-+\fBEnumerator: \fP
|
|
|
- .in +1c
|
|
|
- .TP
|
|
|
- \fB\fIQB_LOG_STATE_UNUSED \fP\fP
|
|
|
-@@ -666,20 +643,17 @@ This is similar to perror except it goes
|
|
|
- \fB\fIQB_LOG_STATE_DISABLED \fP\fP
|
|
|
- .TP
|
|
|
- \fB\fIQB_LOG_STATE_ENABLED \fP\fP
|
|
|
-+
|
|
|
- .SH "Function Documentation"
|
|
|
- .PP
|
|
|
--.SS "struct \fBqb_log_callsite\fP __attribute__ ((aligned(8)))"
|
|
|
--
|
|
|
--.SS "void qb_log_blackbox_print_from_file (const char *filename)"
|
|
|
--
|
|
|
-+.SS "struct \fBqb_log_callsite\fP \fB__attribute__\fP ((aligned(8)))"
|
|
|
-+.SS "void \fBqb_log_blackbox_print_from_file\fP (const char *filename)"
|
|
|
- .PP
|
|
|
- Read the blackbox for file and print it out\&.
|
|
|
--.SS "ssize_t qb_log_blackbox_write_to_file (const char *filename)"
|
|
|
--
|
|
|
-+.SS "ssize_t \fBqb_log_blackbox_write_to_file\fP (const char *filename)"
|
|
|
- .PP
|
|
|
- Write the blackbox to file\&.
|
|
|
--.SS "struct \fBqb_log_callsite\fP* qb_log_callsite_get (const char *function, const char *filename, const char *format, uint8_tpriority, uint32_tlineno, uint32_ttags)\fC [read]\fP"
|
|
|
--
|
|
|
-+.SS "struct \fBqb_log_callsite\fP* \fBqb_log_callsite_get\fP (const char *function, const char *filename, const char *format, uint8_tpriority, uint32_tlineno, uint32_ttags)\fC [read]\fP"
|
|
|
- .PP
|
|
|
- Get or create a callsite at the give position\&. The result can then be passed into \fBqb_log_real_()\fP
|
|
|
- .PP
|
|
|
-@@ -699,23 +673,20 @@ Get or create a callsite at the give pos
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "void qb_log_callsites_dump (void)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_callsites_dump\fP (void)"
|
|
|
- .PP
|
|
|
- Dump the callsite info to stdout\&.
|
|
|
--.SS "int32_t qb_log_callsites_register (struct \fBqb_log_callsite\fP *_start, struct \fBqb_log_callsite\fP *_stop)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_callsites_register\fP (struct \fBqb_log_callsite\fP *_start, struct \fBqb_log_callsite\fP *_stop)"
|
|
|
- .PP
|
|
|
- If you are using dynamically loadable modules via dlopen() and you load them after \fBqb_log_init()\fP then after you load the module you will need to do the following to get the filters to work in that module\&. .PP
|
|
|
- .nf
|
|
|
-- _start = dlsym (dl_handle, '__start___verbose');
|
|
|
--_stop = dlsym (dl_handle, '__stop___verbose');
|
|
|
--qb_log_callsites_register(_start, _stop);
|
|
|
-+ _start = dlsym (dl_handle, '__start___verbose');
|
|
|
-+ _stop = dlsym (dl_handle, '__stop___verbose');
|
|
|
-+ qb_log_callsites_register(_start, _stop);
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "int32_t qb_log_ctl (int32_ttarget, enum \fBqb_log_conf\fPconf_type, int32_targ)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_ctl\fP (int32_ttarget, enum \fBqb_log_conf\fPconf_type, int32_targ)"
|
|
|
- .PP
|
|
|
- Main logging control function\&. \fBParameters:\fP
|
|
|
- .RS 4
|
|
|
-@@ -726,7 +697,7 @@ Main logging control function\&. \fBPara
|
|
|
- \fIarg\fP the new value
|
|
|
- .RE
|
|
|
- .PP
|
|
|
--\fBSee Also:\fP
|
|
|
-+\fBSee also:\fP
|
|
|
- .RS 4
|
|
|
- \fBqb_log_conf\fP
|
|
|
- .RE
|
|
|
-@@ -741,12 +712,10 @@ Main logging control function\&. \fBPara
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "void qb_log_custom_close (int32_tt)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_custom_close\fP (int32_tt)"
|
|
|
- .PP
|
|
|
- Close a custom log target and release is resources\&.
|
|
|
--.SS "int32_t qb_log_custom_open (\fBqb_log_logger_fn\fPlog_fn, \fBqb_log_close_fn\fPclose_fn, \fBqb_log_reload_fn\fPreload_fn, void *user_data)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_custom_open\fP (\fBqb_log_logger_fn\fPlog_fn, \fBqb_log_close_fn\fPclose_fn, \fBqb_log_reload_fn\fPreload_fn, void *user_data)"
|
|
|
- .PP
|
|
|
- Open a custom log target\&. \fBReturn values:\fP
|
|
|
- .RS 4
|
|
|
-@@ -756,20 +725,16 @@ Open a custom log target\&. \fBReturn va
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "int32_t qb_log_facility2int (const char *fname)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_facility2int\fP (const char *fname)"
|
|
|
- .PP
|
|
|
- Convert string 'auth' to equivalent number 'LOG_AUTH' etc\&.
|
|
|
--.SS "const char* qb_log_facility2str (int32_tfnum)"
|
|
|
--
|
|
|
-+.SS "const char* \fBqb_log_facility2str\fP (int32_tfnum)"
|
|
|
- .PP
|
|
|
- Convert number 'LOG_AUTH' to equivalent string 'auth' etc\&.
|
|
|
--.SS "void qb_log_file_close (int32_tt)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_file_close\fP (int32_tt)"
|
|
|
- .PP
|
|
|
- Close a log file and release is resources\&.
|
|
|
--.SS "int32_t qb_log_file_open (const char *filename)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_file_open\fP (const char *filename)"
|
|
|
- .PP
|
|
|
- Open a log file\&. \fBReturn values:\fP
|
|
|
- .RS 4
|
|
|
-@@ -779,22 +744,19 @@ Open a log file\&. \fBReturn values:\fP
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "int32_t qb_log_filter_ctl (int32_tvalue, enum \fBqb_log_filter_conf\fPc, enum \fBqb_log_filter_type\fPtype, const char *text, uint8_tlow_priority)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_filter_ctl\fP (int32_tvalue, enum \fBqb_log_filter_conf\fPc, enum \fBqb_log_filter_type\fPtype, const char *text, uint8_tlow_priority)"
|
|
|
- .PP
|
|
|
- This allows you modify the 'tags' and 'targets' callsite fields at runtime\&.
|
|
|
--.SS "int32_t qb_log_filter_ctl2 (int32_tvalue, enum \fBqb_log_filter_conf\fPc, enum \fBqb_log_filter_type\fPtype, const char *text, uint8_thigh_priority, uint8_tlow_priority)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_filter_ctl2\fP (int32_tvalue, enum \fBqb_log_filter_conf\fPc, enum \fBqb_log_filter_type\fPtype, const char *text, uint8_thigh_priority, uint8_tlow_priority)"
|
|
|
- .PP
|
|
|
- This extends \fBqb_log_filter_ctl()\fP by been able to provide a high_priority\&.
|
|
|
--.SS "int32_t qb_log_filter_fn_set (\fBqb_log_filter_fn\fPfn)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_filter_fn_set\fP (\fBqb_log_filter_fn\fPfn)"
|
|
|
- .PP
|
|
|
- Instead of using the \fBqb_log_filter_ctl()\fP functions you can apply the filters manually by defining a callback and setting the targets field using \fBqb_bit_set()\fP and \fBqb_bit_clear()\fP like the following below\&. .PP
|
|
|
- .nf
|
|
|
--static void
|
|
|
--m_filter(struct qb_log_callsite *cs)
|
|
|
--{
|
|
|
-+ static void
|
|
|
-+ m_filter(struct qb_log_callsite *cs)
|
|
|
-+ {
|
|
|
- if ((cs->priority >= LOG_ALERT &&
|
|
|
- cs->priority <= LOG_DEBUG) &&
|
|
|
- strcmp(cs->filename, 'my_c_file\&.c') == 0) {
|
|
|
-@@ -802,22 +764,19 @@ m_filter(struct qb_log_callsite *cs)
|
|
|
- } else {
|
|
|
- qb_bit_clear(cs->targets, QB_LOG_SYSLOG);
|
|
|
- }
|
|
|
--}
|
|
|
-+ }
|
|
|
- .fi
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "void qb_log_fini (void)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_fini\fP (void)"
|
|
|
- .PP
|
|
|
- Logging system finalization function\&. It releases any shared memory\&. Stops the logging thread if running\&. Flushes the last message to their destinations\&.
|
|
|
--.SS "void qb_log_format_set (int32_tt, const char *format)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_format_set\fP (int32_tt, const char *format)"
|
|
|
- .PP
|
|
|
- Set the format specifiers\&. n FUNCTION NAME f FILENAME l FILELINE p PRIORITY t TIMESTAMP b BUFFER g TAGS N name (passed into qb_log_init) P PID H hostname
|
|
|
- .PP
|
|
|
- any number between % and character specify field length to pad or chop
|
|
|
--.SS "void qb_log_from_external_source (const char *function, const char *filename, const char *format, uint8_tpriority, uint32_tlineno, uint32_ttags, \&.\&.\&.)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_from_external_source\fP (const char *function, const char *filename, const char *format, uint8_tpriority, uint32_tlineno, uint32_ttags, \&.\&.\&.)"
|
|
|
- .PP
|
|
|
- This function is to import logs from other code (like libraries) that provide a callback with their logs\&. \fBNote:\fP
|
|
|
- .RS 4
|
|
|
-@@ -840,10 +799,8 @@ the performance of this will not impress
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "void qb_log_from_external_source_va (const char *function, const char *filename, const char *format, uint8_tpriority, uint32_tlineno, uint32_ttags, va_listap)"
|
|
|
--
|
|
|
--.SS "void qb_log_init (const char *name, int32_tfacility, uint8_tpriority)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_from_external_source_va\fP (const char *function, const char *filename, const char *format, uint8_tpriority, uint32_tlineno, uint32_ttags, va_listap)"
|
|
|
-+.SS "void \fBqb_log_init\fP (const char *name, int32_tfacility, uint8_tpriority)"
|
|
|
- .PP
|
|
|
- Init the logging system\&. \fBParameters:\fP
|
|
|
- .RS 4
|
|
|
-@@ -855,26 +812,20 @@ Init the logging system\&. \fBParameters
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "void qb_log_real_ (struct \fBqb_log_callsite\fP *cs, \&.\&.\&.)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_real_\fP (struct \fBqb_log_callsite\fP *cs, \&.\&.\&.)"
|
|
|
- .PP
|
|
|
- Internal function: use \fBqb_log()\fP or \fBqb_logt()\fP
|
|
|
--.SS "void qb_log_real_va_ (struct \fBqb_log_callsite\fP *cs, va_listap)"
|
|
|
--
|
|
|
--.SS "void qb_log_tags_stringify_fn_set (\fBqb_log_tags_stringify_fn\fPfn)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_real_va_\fP (struct \fBqb_log_callsite\fP *cs, va_listap)"
|
|
|
-+.SS "void \fBqb_log_tags_stringify_fn_set\fP (\fBqb_log_tags_stringify_fn\fPfn)"
|
|
|
- .PP
|
|
|
- Set the callback to map the 'tags' bit map to a string\&.
|
|
|
--.SS "void qb_log_target_format (int32_ttarget, struct \fBqb_log_callsite\fP *cs, time_ttimestamp, const char *formatted_message, char *output_buffer)"
|
|
|
--
|
|
|
-+.SS "void \fBqb_log_target_format\fP (int32_ttarget, struct \fBqb_log_callsite\fP *cs, time_ttimestamp, const char *formatted_message, char *output_buffer)"
|
|
|
- .PP
|
|
|
- format the callsite and timestamp info according to the format set using \fBqb_log_format_set()\fP It is intended to be used from your custom logger function\&.
|
|
|
--.SS "void* qb_log_target_user_data_get (int32_tt)"
|
|
|
--
|
|
|
-+.SS "void* \fBqb_log_target_user_data_get\fP (int32_tt)"
|
|
|
- .PP
|
|
|
- Retrieve the user data set by either qb_log_custom_open or qb_log_target_user_data_set\&.
|
|
|
--.SS "int32_t qb_log_target_user_data_set (int32_tt, void *user_data)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_target_user_data_set\fP (int32_tt, void *user_data)"
|
|
|
- .PP
|
|
|
- Associate user data with this log target\&. \fBNote:\fP
|
|
|
- .RS 4
|
|
|
-@@ -882,8 +833,7 @@ only use this with custom targets
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "int32_t qb_log_thread_priority_set (int32_tpolicy, int32_tpriority)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_thread_priority_set\fP (int32_tpolicy, int32_tpriority)"
|
|
|
- .PP
|
|
|
- When using threaded logging set the pthread policy and priority\&. \fBReturn values:\fP
|
|
|
- .RS 4
|
|
|
-@@ -893,32 +843,21 @@ When using threaded logging set the pthr
|
|
|
- .RE
|
|
|
- .PP
|
|
|
-
|
|
|
--.SS "int32_t qb_log_thread_start (void)"
|
|
|
--
|
|
|
-+.SS "int32_t \fBqb_log_thread_start\fP (void)"
|
|
|
- .PP
|
|
|
- Start the logging pthread\&.
|
|
|
- .SH "Variable Documentation"
|
|
|
- .PP
|
|
|
--.SS "enum \fBqb_log_target_state\fP __attribute__"
|
|
|
--
|
|
|
--.SS "struct \fBqb_log_callsite\fP __start___verbose[]"
|
|
|
--
|
|
|
--.SS "struct \fBqb_log_callsite\fP __stop___verbose[]"
|
|
|
--
|
|
|
--.SS "const char* filename"
|
|
|
--
|
|
|
--.SS "const char* format"
|
|
|
--
|
|
|
--.SS "const char* function"
|
|
|
--
|
|
|
--.SS "uint32_t lineno"
|
|
|
--
|
|
|
--.SS "uint8_t priority"
|
|
|
--
|
|
|
--.SS "uint32_t tags"
|
|
|
--
|
|
|
--.SS "uint32_t targets"
|
|
|
--
|
|
|
-+.SS "enum \fBqb_log_target_state\fP \fB__attribute__\fP"
|
|
|
-+.SS "struct \fBqb_log_callsite\fP \fB__start___verbose\fP[]"
|
|
|
-+.SS "struct \fBqb_log_callsite\fP \fB__stop___verbose\fP[]"
|
|
|
-+.SS "const char* \fBfilename\fP"
|
|
|
-+.SS "const char* \fBformat\fP"
|
|
|
-+.SS "const char* \fBfunction\fP"
|
|
|
-+.SS "uint32_t \fBlineno\fP"
|
|
|
-+.SS "uint8_t \fBpriority\fP"
|
|
|
-+.SS "uint32_t \fBtags\fP"
|
|
|
-+.SS "uint32_t \fBtargets\fP"
|
|
|
- .SH "Author"
|
|
|
- .PP
|
|
|
- Generated automatically by Doxygen for libqb from the source code\&.
|
Waldemar Brodkorb