The scheme employed in Babeltrace to break this cycle consists in the
"children" holding *reverse component references* to their parents. That
-is, in the context of CTF IR, that event classes hold a reference to
-their parent stream class and stream classes hold a reference to their
-parent trace.
+is, in the context of the trace IR, that event classes hold a reference
+to their parent stream class and stream classes hold a reference to
+their parent trace.
On the other hand, parents hold *claiming aggregation references* to
their children. A claiming aggregation reference means that the object
== Valgrind
To use Valgrind on an application (for example, the CLI or a test) which
-loads libbabeltrace, use:
+loads libbabeltrace2, use:
$ G_SLICE=always-malloc G_DEBUG=gc-friendly PYTHONMALLOC=malloc \
BABELTRACE_NO_DLCLOSE=1 valgrind --leak-check=full \
the Python plugin provider (Valgrind will probably show a lot of errors
which originate from Python interpreter anyway).
-`BABELTRACE_NO_DLCLOSE=1` makes libbabeltrace not close the shared
+`BABELTRACE_NO_DLCLOSE=1` makes libbabeltrace2 not close the shared
libraries (plugins) which it loads. This is needed to see the
appropriate backtrace when Valgrind shows errors.
`<babeltrace/logging.h>`::
Public header which a library user can use to control and read
- libbabeltrace's current log level.
+ libbabeltrace2's current log level.
`<babeltrace/logging-internal.h>`::
Internal, generic logging API which you can use in any Babeltrace
example, there is one log level per component class, which makes log
filtering easier during execution.
+
-In libbabeltrace, the user can set the current run-time log level with
+In libbabeltrace2, the user can set the current run-time log level with
the `bt_logging_set_global_level()` function, for example:
+
--
of your module's object in your module's root `Makefile.am`.
. Add the log level initializing environment variable name to the
- `log_level_env_var_names` array in `cli/babeltrace.c`.
+ `log_level_env_var_names` array in `cli/babeltrace2.c`.
[[logging-instrument-source]]