While <<choose-a-log-level,care must be taken>> when placing _DEBUG_ to
_FATAL_ logging statements, you should liberally instrument your
-Babeltrace module with _VERBOSE_ logging statements to help future you
+Babeltrace module with _TRACE_ logging statements to help future you
and other developers understand what's happening at run time.
|Internal API enumerator
|Public API enumerator
-|_VERBOSE_
-|`V`
-|`BT_LOG_VERBOSE`
-|`BT_LOGGING_LEVEL_VERBOSE`
+|_TRACE_
+|`T`
+|`BT_LOG_TRACE`
+|`BT_LOGGING_LEVEL_TRACE`
|_DEBUG_
|`D`
(generic)>> and <<logging-instrument-h-file-gen,Instrument a C header
file (generic)>> to learn how to be able to use the following macros.
-`+BT_LOGV("format string", ...)+`::
- Generic verbose logging statement.
+`+BT_LOGT("format string", ...)+`::
+ Generic trace logging statement.
`+BT_LOGD("format string", ...)+`::
Generic debug logging statement.
`+BT_LOGF("format string", ...)+`::
Generic fatal logging statement.
-`+BT_LOGV_STR("preformatted string")+`::
- Generic preformatted string verbose logging statement.
+`+BT_LOGT_STR("preformatted string")+`::
+ Generic preformatted string trace logging statement.
`+BT_LOGD_STR("preformatted string")+`::
Generic preformatted string debug logging statement.
`+BT_LOGF_STR("preformatted string")+`::
Generic preformatted string fatal logging statement.
-`+BT_LOGV_MEM(data_ptr, data_size, "format string", ...)+`::
- Generic memory verbose logging statement.
+`+BT_LOGT_MEM(data_ptr, data_size, "format string", ...)+`::
+ Generic memory trace logging statement.
`+BT_LOGD_MEM(data_ptr, data_size, "format string", ...)+`::
Generic memory debug logging statement.
`+BT_LOGF_MEM(data_ptr, data_size, "format string", ...)+`::
Generic memory fatal logging statement.
-`+BT_LOGV_ERRNO("initial message", "format string", ...)+`::
- Generic `errno` string verbose logging statement.
+`+BT_LOGT_ERRNO("initial message", "format string", ...)+`::
+ Generic `errno` string trace logging statement.
`+BT_LOGD_ERRNO("initial message", "format string", ...)+`::
Generic `errno` string debug logging statement.
The library logging statement macros are named `+BT_LIB_LOG*()+` instead
of `+BT_LOG*()+`:
-`+BT_LIB_LOGV("format string", ...)+`::
- Library verbose logging statement.
+`+BT_LIB_LOGT("format string", ...)+`::
+ Library trace logging statement.
`+BT_LIB_LOGD("format string", ...)+`::
Library debug logging statement.
The component logging statement macros are named `+BT_COMP_LOG*()+`
instead of `+BT_LOG*()+`:
-`+BT_COMP_LOGV("format string", ...)+`::
- Component verbose logging statement.
+`+BT_COMP_LOGT("format string", ...)+`::
+ Component trace logging statement.
`+BT_COMP_LOGD("format string", ...)+`::
Component debug logging statement.
`+BT_COMP_LOGF("format string", ...)+`::
Component fatal logging statement.
-`+BT_COMP_LOGV_STR("preformatted string")+`::
- Component preformatted string verbose logging statement.
+`+BT_COMP_LOGT_STR("preformatted string")+`::
+ Component preformatted string trace logging statement.
`+BT_COMP_LOGD_STR("preformatted string")+`::
Component preformatted string debug logging statement.
`+BT_COMP_LOGF_STR("preformatted string")+`::
Component preformatted string fatal logging statement.
-`+BT_COMP_LOGV_ERRNO("initial message", "format string", ...)+`::
- Component `errno` string verbose logging statement.
+`+BT_COMP_LOGT_ERRNO("initial message", "format string", ...)+`::
+ Component `errno` string trace logging statement.
`+BT_COMP_LOGD_ERRNO("initial message", "format string", ...)+`::
Component `errno` string debug logging statement.
`+BT_COMP_LOGF_ERRNO("initial message", "format string", ...)+`::
Component `errno` string fatal logging statement.
-`+BT_COMP_LOGV_MEM(data_ptr, data_size, "format string", ...)+`::
- Component memory verbose logging statement.
+`+BT_COMP_LOGT_MEM(data_ptr, data_size, "format string", ...)+`::
+ Component memory trace logging statement.
`+BT_COMP_LOGD_MEM(data_ptr, data_size, "format string", ...)+`::
Component memory debug logging statement.
The available definitions for build-time conditions are:
-* `BT_LOG_ENABLED_VERBOSE`
+* `BT_LOG_ENABLED_TRACE`
* `BT_LOG_ENABLED_DEBUG`
* `BT_LOG_ENABLED_INFO`
* `BT_LOG_ENABLED_WARN`
The available definitions for run-time conditions are:
-* `BT_LOG_ON_VERBOSE`
+* `BT_LOG_ON_TRACE`
* `BT_LOG_ON_DEBUG`
* `BT_LOG_ON_INFO`
* `BT_LOG_ON_WARN`
{
/* ... */
-#ifdef BT_LOGV
- BT_LOGV(...);
+#ifdef BT_LOGT
+ BT_LOGT(...);
#endif
/* ... */
`switch` statement.
* Failed assertion (within `BT_ASSERT()`).
* Unsatisfied library precondition (within `BT_ASSERT_PRE()`).
+* Unsatisfied library postcondition (within `BT_ASSERT_POST()`).
|Almost none: should be executed in production.
|_ERROR_
* Calling user methods and logging the result.
* Setting object properties (except fields and values).
|
-Noticeable, but not as much as the _VERBOSE_ level: could be executed
+Noticeable, but not as much as the _TRACE_ level: could be executed
in production if you're going to need a thorough log for support
tickets without having to rebuild the project.
-|_VERBOSE_
+|_TRACE_
|
Low-level debugging context information (anything that does not fit the
other log levels). More appropriate for tracing in general.
property from an object by name or key that fails to find the value is
not a warning scenario: the user could legitimately use this function to
check if the name/key exists in the object. In this case, use the
-_VERBOSE_ level (or do not log at all).
+_TRACE_ level (or do not log at all).
--
----
$ G_SLICE=always-malloc G_DEBUG=gc-friendly PYTHONMALLOC=malloc \
- BABELTRACE_NO_DLCLOSE=1 valgrind --leak-check=full \
+ LIBBABELTRACE2_NO_DLCLOSE=1 valgrind --leak-check=full \
--suppressions=/path/to/babeltrace/extras/valgrind/popt.supp app
----
the Python plugin provider (Valgrind will probably show a lot of errors
which originate from the Python interpreter anyway).
-`BABELTRACE_NO_DLCLOSE=1` makes libbabeltrace2 not close the shared
+`LIBBABELTRACE2_NO_DLCLOSE=1` makes libbabeltrace2 not close the shared
libraries (plugins) which it loads. You need this to see the appropriate
backtrace when Valgrind shows errors.