diff options
Diffstat (limited to 'package/libqb/patches/patch-docs_man3_qblog_h_3')
| -rw-r--r-- | package/libqb/patches/patch-docs_man3_qblog_h_3 | 649 |
1 files changed, 649 insertions, 0 deletions
diff --git a/package/libqb/patches/patch-docs_man3_qblog_h_3 b/package/libqb/patches/patch-docs_man3_qblog_h_3 new file mode 100644 index 000000000..de83d0f86 --- /dev/null +++ b/package/libqb/patches/patch-docs_man3_qblog_h_3 @@ -0,0 +1,649 @@ +--- 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\&. |