MkObjectC - log information to MkLogFileC (default: stderr) …
More...
|
#define | MkLogC_4X(x, message, debug, callfunc) |
|
#define | MkLogC_3X(x, message, debug) |
|
#define | MkLogC_2X(x, message) |
|
#define | MkLogW(x, callfunc, _debug, message) |
|
#define | MkLogV_lvl(x, debug, printfmt, ...) |
|
#define | MkLogV_4M(x, callfunc, debug, printfmt, ...) |
|
#define | MkLogV_4X(x, callfunc, debug, printfmt, ...) |
|
#define | MkLogV_3X(x, callfunc, printfmt, ...) |
|
#define | MkLogV_2X(x, printfmt, ...) |
|
#define | MkLogVL_5X(fmtobj, callfunc, debug, printfmt, var_list) |
|
#define | MkDDInit const MK_I32 __dbg = MK_RT_REF.debug |
|
#define | MkDDInitNum(n) |
|
#define | MkLogHEX_4X(fmtobj, callfunc, data, len) |
|
#define | MkObjectLogSimple_1X(x) |
|
#define | MkObjectLogDetail_1X(x) |
|
#define | MkObjectLogDetail_1M(m) |
|
#define | MkObjectLog_1X(x) |
|
|
MK_EXTERN void | MkLogC_RT (MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const message, MK_DBG const debug, MK_STRN const callfunc) |
| write a logging-message to MkLogFileC (default: stderr) using the internal format …
|
|
MK_EXTERN void | MkLogV_RT (MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const callfunc, MK_DBG debug, MK_FST const printfmt,...) |
| write a printf style logging-message to MkLogFileC (default: stderr) using the internal format …
|
|
MK_EXTERN void | MkLogVL_RT (MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const callfunc, MK_DBG debug, MK_FST const printfmt, va_list var_list) |
| write a vprintf style logging-message to MkLogFileC using the internal format …
|
|
MK_EXTERN void | MkLogHEX_RT (MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const callfunc, MkBinaryR const data) |
| log binaray data as HEX into the MkLogFileC (default: stderr) …
|
|
MK_EXTERN void | MkObjectLogSimple_RT (MK_RT mkrt, MK_OBJN const obj, MK_OBJN fmtobj, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl) |
| log the MkObjectS into the MkLogFileC (default: stderr) …
|
|
MK_EXTERN void | MkObjectLogDetail_RT (MK_RT mkrt, MK_OBJN const obj, MK_OBJN fmtobj, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl) |
| log the MkObjectS verbose into the MkLogFileC (default: stderr) …
|
|
MK_EXTERN void | MkObjectLog_RT (MK_RT mkrt, MK_OBJN const obj, MK_OBJN fmtobj, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl) |
| Log-Slot - log the entire object to the MkLogFileC (default: stderr) target …
|
|
|
- Parameters
-
[in] | fmtobj | managed object used to format the log-message (default=MK_NULL → use default-format) _debug |
| str | the message to log |
|
#define | MkDLogC_O(fmtobj, _debug, str) |
|
#define | MkDLogC(x, _debug, str) |
|
#define | MkDDLogC(x, _debug, str) |
|
|
- Parameters
-
[in] | fmtobj | managed object used to format the log-message (default=MK_NULL → use default-format) _debug |
[in] | printfmt | is a c-string used as printf like format string |
| ... | vararg string argument |
|
#define | MkDLogV_O(fmtobj, _debug, printfmt, ...) |
|
#define | MkDLogV(x, _debug, printfmt, ...) |
|
#define | MkDDLogV(fmtobj, _debug, printfmt, ...) |
|
|
#define | MkLogC_NULL(...) |
|
#define | MkLogC(...) |
|
#define | MkLogC_3(fmtobj, message, debug) |
|
#define | MkLogC_2(fmtobj, message) |
|
#define | MkLogC_1(message) |
|
#define | MkLogHEX_NULL(...) |
|
#define | MkLogHEX(...) |
|
#define | MkLogHEX_2(fmtobj, data) |
|
#define | MkLogHEX_1(data) |
|
#define | MkLogV_NULL(...) |
|
#define | MkLogV(...) |
|
#define | MkLogV_3(fmtobj, callfunc, printfmt, ...) |
|
#define | MkLogV_2(fmtobj, printfmt, ...) |
|
#define | MkLogV_1(printfmt, ...) |
|
#define | MkLogVL_NULL(...) |
|
#define | MkLogVL(...) |
|
#define | MkLogVL_4(fmtobj, callfunc, printfmt, var_list) |
|
#define | MkLogVL_3(fmtobj, printfmt, var_list) |
|
#define | MkLogVL_2(printfmt, var_list) |
|
#define | MkObjectLog_NULL(...) |
|
#define | MkObjectLog(...) |
|
#define | MkObjectLog_4(obj, fmtobj, debug, callfunc) |
|
#define | MkObjectLog_3(obj, fmtobj, debug) |
|
#define | MkObjectLog_2(obj, fmtobj) |
|
#define | MkObjectLog_1(obj) |
|
#define | MkObjectLogDetail_NULL(...) |
|
#define | MkObjectLogDetail(...) |
|
#define | MkObjectLogDetail_4(obj, fmtobj, debug, callfunc) |
|
#define | MkObjectLogDetail_3(obj, fmtobj, debug) |
|
#define | MkObjectLogDetail_2(obj, fmtobj) |
|
#define | MkObjectLogDetail_1(obj) |
|
#define | MkObjectLogSimple_NULL(...) |
|
#define | MkObjectLogSimple(...) |
|
#define | MkObjectLogSimple_4(obj, fmtobj, debug, callfunc) |
|
#define | MkObjectLogSimple_3(obj, fmtobj, debug) |
|
#define | MkObjectLogSimple_2(obj, fmtobj) |
|
#define | MkObjectLogSimple_1(obj) |
|
MkObjectC - log information to MkLogFileC (default: stderr) …
The logging-target is set direct by RuntimeSetLogfile or using the class MkLogFileC.
The target is stored at the MkRuntimeC using a FILE-stream and can be set individually for each thread. The default is stderr.
possible values are:
value | decription | OS man-page |
stdout | the standart output | stdio(3) |
stderr | the standart error output | stdio(3) |
fileName | an arbitary fileName | fopen(3) |
Many logging functions have common parameters:
- Parameters
-
[in] | fmtobj | managed object used to format the log-message (default=MK_NULL → use default-format) |
[in] | callfunc | a user-defined postfix to identify the calling function or the environment (default=name-of-function ) |
[in] | debug | the debug level from MkRuntimeS::debug, use 0 <= debug <= 9 (default=0 ) |
◆ MkDCheck
#define MkDCheck |
( |
| _debug | ) |
|
◆ MkDDCheck
#define MkDDCheck |
( |
| _debug | ) |
|
◆ MkDDInit
#define MkDDInit const MK_I32 __dbg = MK_RT_REF.debug |
◆ MkDDInitNum
◆ MkDDLogC
#define MkDDLogC |
( |
| x, |
|
|
| _debug, |
|
|
| str ) |
Value:
#define MkLogC_4X(x, message, debug, callfunc)
Definition at line 4994 of file LibMkKernel_mk.h.
4994# define MkDDLogC(x,_debug,str) \
4995 if (unlikely(__dbg >= _debug)) MkLogC_4X(x,str,_debug,__func__)
◆ MkDDLogV
#define MkDDLogV |
( |
| fmtobj, |
|
|
| _debug, |
|
|
| printfmt, |
|
|
| ... ) |
Value: if (
unlikely(__dbg >= _debug))
MkLogV_4M(fmtobj,__func__,_debug,printfmt,__VA_ARGS__)
#define MkLogV_4M(x, callfunc, debug, printfmt,...)
Definition at line 5009 of file LibMkKernel_mk.h.
5009# define MkDDLogV(fmtobj,_debug,printfmt,...) \
5010 if (unlikely(__dbg >= _debug)) MkLogV_4M(fmtobj,__func__,_debug,printfmt,__VA_ARGS__)
◆ MkDLogC
#define MkDLogC |
( |
| x, |
|
|
| _debug, |
|
|
| str ) |
Value:
#define MkOBJ(x)
cast a known-object into an MkObjectS pointer
#define MkDLogC_O(fmtobj, _debug, str)
Definition at line 4992 of file LibMkKernel_mk.h.
◆ MkDLogC_O
#define MkDLogC_O |
( |
| fmtobj, |
|
|
| _debug, |
|
|
| str ) |
Value:
Definition at line 4989 of file LibMkKernel_mk.h.
4989# define MkDLogC_O(fmtobj,_debug,str) \
4990 if (unlikely(MK_RT_REF.debug >= _debug)) MkLogC(fmtobj,str,_debug,__func__)
◆ MkDLogV
#define MkDLogV |
( |
| x, |
|
|
| _debug, |
|
|
| printfmt, |
|
|
| ... ) |
Value:
#define MkDLogV_O(fmtobj, _debug, printfmt,...)
Definition at line 5007 of file LibMkKernel_mk.h.
◆ MkDLogV_O
#define MkDLogV_O |
( |
| fmtobj, |
|
|
| _debug, |
|
|
| printfmt, |
|
|
| ... ) |
Value:
Definition at line 5004 of file LibMkKernel_mk.h.
5004# define MkDLogV_O(fmtobj,_debug,printfmt,...) \
5005 if (unlikely(MK_RT_REF.debug >= _debug)) MkLogV(fmtobj,__func__,_debug,printfmt,__VA_ARGS__)
◆ MkLogC
Value:
MK_EXTERN void MkLogC_RT(MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const message, MK_DBG const debug, MK_STRN const callfunc)
write a logging-message to MkLogFileC (default: stderr) using the internal format …
Definition at line 1533 of file kernel_overload_mk.h.
◆ MkLogC_1
#define MkLogC_1 |
( |
| message | ) |
|
◆ MkLogC_2
#define MkLogC_2 |
( |
| fmtobj, |
|
|
| message ) |
◆ MkLogC_2X
#define MkLogC_2X |
( |
| x, |
|
|
| message ) |
◆ MkLogC_3
#define MkLogC_3 |
( |
| fmtobj, |
|
|
| message, |
|
|
| debug ) |
◆ MkLogC_3X
#define MkLogC_3X |
( |
| x, |
|
|
| message, |
|
|
| debug ) |
◆ MkLogC_4X
#define MkLogC_4X |
( |
| x, |
|
|
| message, |
|
|
| debug, |
|
|
| callfunc ) |
◆ MkLogC_NULL
#define MkLogC_NULL |
( |
| ... | ) |
|
◆ MkLogHEX
Value:
MK_EXTERN void MkLogHEX_RT(MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const callfunc, MkBinaryR const data)
log binaray data as HEX into the MkLogFileC (default: stderr) …
Definition at line 1538 of file kernel_overload_mk.h.
◆ MkLogHEX_1
#define MkLogHEX_1 |
( |
| data | ) |
|
◆ MkLogHEX_2
#define MkLogHEX_2 |
( |
| fmtobj, |
|
|
| data ) |
◆ MkLogHEX_4X
#define MkLogHEX_4X |
( |
| fmtobj, |
|
|
| callfunc, |
|
|
| data, |
|
|
| len ) |
◆ MkLogHEX_NULL
#define MkLogHEX_NULL |
( |
| ... | ) |
|
◆ MkLogV
Value:
MK_EXTERN void MkLogV_RT(MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const callfunc, MK_DBG debug, MK_FST const printfmt,...)
write a printf style logging-message to MkLogFileC (default: stderr) using the internal format …
Definition at line 1542 of file kernel_overload_mk.h.
◆ MkLogV_1
#define MkLogV_1 |
( |
| printfmt, |
|
|
| ... ) |
◆ MkLogV_2
#define MkLogV_2 |
( |
| fmtobj, |
|
|
| printfmt, |
|
|
| ... ) |
◆ MkLogV_2X
#define MkLogV_2X |
( |
| x, |
|
|
| printfmt, |
|
|
| ... ) |
◆ MkLogV_3
#define MkLogV_3 |
( |
| fmtobj, |
|
|
| callfunc, |
|
|
| printfmt, |
|
|
| ... ) |
◆ MkLogV_3X
#define MkLogV_3X |
( |
| x, |
|
|
| callfunc, |
|
|
| printfmt, |
|
|
| ... ) |
Value:
#define MkLogV_3(fmtobj, callfunc, printfmt,...)
Definition at line 4943 of file LibMkKernel_mk.h.
◆ MkLogV_4M
#define MkLogV_4M |
( |
| x, |
|
|
| callfunc, |
|
|
| debug, |
|
|
| printfmt, |
|
|
| ... ) |
Value:
MK_OBJN MkObjN(MK_MNGN mng)
(const) cast a unknown-object into an MkObjectS pointer or NULL if not possible
Definition at line 4941 of file LibMkKernel_mk.h.
◆ MkLogV_4X
#define MkLogV_4X |
( |
| x, |
|
|
| callfunc, |
|
|
| debug, |
|
|
| printfmt, |
|
|
| ... ) |
◆ MkLogV_lvl
#define MkLogV_lvl |
( |
| x, |
|
|
| debug, |
|
|
| printfmt, |
|
|
| ... ) |
◆ MkLogV_NULL
#define MkLogV_NULL |
( |
| ... | ) |
|
◆ MkLogVL
Value:
MK_EXTERN void MkLogVL_RT(MK_RT mkrt, MK_OBJN fmtobj, MK_STRN const callfunc, MK_DBG debug, MK_FST const printfmt, va_list var_list)
write a vprintf style logging-message to MkLogFileC using the internal format …
Definition at line 1547 of file kernel_overload_mk.h.
◆ MkLogVL_2
#define MkLogVL_2 |
( |
| printfmt, |
|
|
| var_list ) |
◆ MkLogVL_3
#define MkLogVL_3 |
( |
| fmtobj, |
|
|
| printfmt, |
|
|
| var_list ) |
◆ MkLogVL_4
#define MkLogVL_4 |
( |
| fmtobj, |
|
|
| callfunc, |
|
|
| printfmt, |
|
|
| var_list ) |
◆ MkLogVL_5X
#define MkLogVL_5X |
( |
| fmtobj, |
|
|
| callfunc, |
|
|
| debug, |
|
|
| printfmt, |
|
|
| var_list ) |
Value:
Definition at line 4965 of file LibMkKernel_mk.h.
4965#define MkLogVL_5X(fmtobj,callfunc,debug,printfmt,var_list) \
4966 MkLogVL(MkOBJ(fmtobj),callfunc,debug,printfmt,var_list)
◆ MkLogVL_NULL
#define MkLogVL_NULL |
( |
| ... | ) |
|
◆ MkLogW
#define MkLogW |
( |
| x, |
|
|
| callfunc, |
|
|
| _debug, |
|
|
| message ) |
◆ MkObjectLog
#define MkObjectLog |
( |
| ... | ) |
|
Value:
MK_EXTERN void MkObjectLog_RT(MK_RT mkrt, MK_OBJN const obj, MK_OBJN fmtobj, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl)
Log-Slot - log the entire object to the MkLogFileC (default: stderr) target …
Definition at line 1552 of file kernel_overload_mk.h.
◆ MkObjectLog_1
#define MkObjectLog_1 |
( |
| obj | ) |
|
◆ MkObjectLog_1X
#define MkObjectLog_1X |
( |
| x | ) |
|
◆ MkObjectLog_2
#define MkObjectLog_2 |
( |
| obj, |
|
|
| fmtobj ) |
◆ MkObjectLog_3
#define MkObjectLog_3 |
( |
| obj, |
|
|
| fmtobj, |
|
|
| debug ) |
◆ MkObjectLog_4
#define MkObjectLog_4 |
( |
| obj, |
|
|
| fmtobj, |
|
|
| debug, |
|
|
| callfunc ) |
◆ MkObjectLog_NULL
#define MkObjectLog_NULL |
( |
| ... | ) |
|
◆ MkObjectLogDetail
#define MkObjectLogDetail |
( |
| ... | ) |
|
Value:
MK_EXTERN void MkObjectLogDetail_RT(MK_RT mkrt, MK_OBJN const obj, MK_OBJN fmtobj, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl)
log the MkObjectS verbose into the MkLogFileC (default: stderr) …
Definition at line 1558 of file kernel_overload_mk.h.
◆ MkObjectLogDetail_1
#define MkObjectLogDetail_1 |
( |
| obj | ) |
|
◆ MkObjectLogDetail_1M
#define MkObjectLogDetail_1M |
( |
| m | ) |
|
Value:
MK_OBJ MkObj(MK_MNG mng)
cast a unknown-object into an MkObjectS pointer or NULL if not possible
Definition at line 5073 of file LibMkKernel_mk.h.
◆ MkObjectLogDetail_1X
#define MkObjectLogDetail_1X |
( |
| x | ) |
|
◆ MkObjectLogDetail_2
#define MkObjectLogDetail_2 |
( |
| obj, |
|
|
| fmtobj ) |
◆ MkObjectLogDetail_3
#define MkObjectLogDetail_3 |
( |
| obj, |
|
|
| fmtobj, |
|
|
| debug ) |
◆ MkObjectLogDetail_4
#define MkObjectLogDetail_4 |
( |
| obj, |
|
|
| fmtobj, |
|
|
| debug, |
|
|
| callfunc ) |
◆ MkObjectLogDetail_NULL
#define MkObjectLogDetail_NULL |
( |
| ... | ) |
|
◆ MkObjectLogSimple
#define MkObjectLogSimple |
( |
| ... | ) |
|
Value:
MK_EXTERN void MkObjectLogSimple_RT(MK_RT mkrt, MK_OBJN const obj, MK_OBJN fmtobj, MK_DBG const debug, MK_STRN const callfunc, MK_I32 const lvl)
log the MkObjectS into the MkLogFileC (default: stderr) …
Definition at line 1564 of file kernel_overload_mk.h.
◆ MkObjectLogSimple_1
#define MkObjectLogSimple_1 |
( |
| obj | ) |
|
◆ MkObjectLogSimple_1X
#define MkObjectLogSimple_1X |
( |
| x | ) |
|
◆ MkObjectLogSimple_2
#define MkObjectLogSimple_2 |
( |
| obj, |
|
|
| fmtobj ) |
◆ MkObjectLogSimple_3
#define MkObjectLogSimple_3 |
( |
| obj, |
|
|
| fmtobj, |
|
|
| debug ) |
◆ MkObjectLogSimple_4
#define MkObjectLogSimple_4 |
( |
| obj, |
|
|
| fmtobj, |
|
|
| debug, |
|
|
| callfunc ) |
◆ MkObjectLogSimple_NULL
#define MkObjectLogSimple_NULL |
( |
| ... | ) |
|
◆ MkLogC_RT()
write a logging-message to MkLogFileC (default: stderr) using the internal format …
The logging is only done if 'MqDebug
>= level
' and 'MqIsSilent
== MK_NO
'
using the following format:
C> (NAME:PID:THREADID) [YYYY-MM-DD:HH-MM-SS] [String|Binary-DEBUGLEVEL-CONTEXTID-REFCOUNT-CONTEXTPTR-prefix]: message
The message is build with snprintf
and finally send with fputsn
without newline '\n'
character at the end. To add the newline or an other special-caracter use the '\xxx'
syntax.
- Parameters
-
[in] | mkrt | the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only) |
[in] | fmtobj | managed object used to format the log-message (default=MK_NULL → use default-format) |
[in] | callfunc | a user-defined postfix to identify the calling function or the environment (default=name-of-function ) |
[in] | debug | the debug level from MkRuntimeS::debug, use 0 <= debug <= 9 (default=0 ) |
[in] | message | string to log |
◆ MkLogHEX_RT()
log binaray data as HEX into the MkLogFileC (default: stderr) …
- Parameters
-
[in] | mkrt | the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only) |
[in] | fmtobj | managed object used to format the log-message (default=MK_NULL → use default-format) |
[in] | callfunc | a user-defined postfix to identify the calling function or the environment (default=name-of-function ) |
[in] | data | the binary data to log |
◆ MkLogV_RT()
write a printf style logging-message to MkLogFileC (default: stderr) using the internal format …
Use the format and the restrictions from LogC.
- Parameters
-
[in] | mkrt | the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only) |
[in] | fmtobj | managed object used to format the log-message (default=MK_NULL → use default-format) |
[in] | callfunc | a user-defined postfix to identify the calling function or the environment (default=name-of-function ) |
[in] | debug | the debug level from MkRuntimeS::debug, use 0 <= debug <= 9 (default=0 ) |
[in] | printfmt | is a c-string used as printf like format string |
◆ MkLogVL_RT()
write a vprintf style logging-message to MkLogFileC using the internal format …
Use the format and the restrictions from LogC.
- Parameters
-
[in] | mkrt | the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only) |
[in] | fmtobj | managed object used to format the log-message (default=MK_NULL → use default-format) |
[in] | callfunc | a user-defined postfix to identify the calling function or the environment (default=name-of-function ) |
[in] | debug | the debug level from MkRuntimeS::debug, use 0 <= debug <= 9 (default=0 ) |
[in] | printfmt | is a c-string used as printf like format string |
[in] | var_list | a variable argument list object |
◆ MkObjectLog_RT()
Log-Slot - log the entire object to the MkLogFileC (default: stderr) target …
- Todo
log_doku
slot_doku
- Parameters
-
[in] | mkrt | the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only) |
[in] | obj | the MkObjectS instance to work on - a MANAGED OBJECT after type-check and able to be supported by the MkObjectS API |
[in] | fmtobj | managed object used to format the log-message (default=MK_NULL → use default-format) |
[in] | debug | the debug level from MkRuntimeS::debug, use 0 <= debug <= 9 (default=0 ) |
[in] | callfunc | a user-defined postfix to identify the calling function or the environment (default=name-of-function ) |
[in] | lvl | a user-defined prefix starting with "" for lvl=0 and increase with " " for lvl+1 (default=0 ) |
- See also
- MkBufferLog, MkBufferListLog, MkBufferStreamLog, ?MkLogFileLog, MkErrorLog, MkRuntimeLog, MkObjectLog
◆ MkObjectLogDetail_RT()
◆ MkObjectLogSimple_RT()
log the MkObjectS into the MkLogFileC (default: stderr) …
- Parameters
-
[in] | mkrt | the MkRuntimeS instance to work on - the runtime argument, used by MK_RT_CALL (C-only) |
[in] | obj | the MkObjectS instance to work on - a MANAGED OBJECT after type-check and able to be supported by the MkObjectS API |
[in] | fmtobj | managed object used to format the log-message (default=MK_NULL → use default-format) |
[in] | debug | the debug level from MkRuntimeS::debug, use 0 <= debug <= 9 (default=0 ) |
[in] | callfunc | a user-defined postfix to identify the calling function or the environment (default=name-of-function ) |
[in] | lvl | a user-defined prefix starting with "" for lvl=0 and increase with " " for lvl+1 (default=0 ) |
- See also
- MkObjectC