#include <babeltrace/babeltrace-internal.h>
#include <stdarg.h>
+#ifndef BT_LOG_TAG
+# error Please define a tag with BT_LOG_TAG before including this file.
+#endif
+
#define BT_LOG_OUTPUT_LEVEL bt_lib_log_level
#include <babeltrace/logging-internal.h>
* `PRIi64`.
*
* The Babeltrace extension conversion specifier is accepted. Its syntax
- * is:
+ * is either `%!u` to format a UUID (`bt_uuid` type) or:
*
* 1. Introductory `%!` sequence.
*
* 3. Optional: `+` to print extended fields. This depends on the
* provided format specifier.
*
- * 4. Objet category: `_` for common objects, or nothing for default
- * objects (includes CTF IR).
- *
- * 5. Format specifier (see below).
+ * 4. Format specifier (see below).
*
* The available format specifiers are:
*
- * Default category:
- * `r`:
- * Reference count information. The parameter is any Babeltrace
- * object.
- *
* `F`:
- * CTF IR field type. The parameter type is `struct bt_field_type *`.
+ * Trace IR field class. The parameter type is
+ * `structbt_field_class *`.
*
* `f`:
- * CTF IR field. The parameter type is `struct bt_field *`.
+ * Trace IR field. The parameter type is `struct bt_field *`.
*
* `P`:
* Field path. The parameter type is `struct bt_field_path *`.
*
* `E`:
- * CTF IR event class. The parameter type is `struct bt_event_class *`.
+ * Trace IR event class. The parameter type is
+ * `struct bt_event_class *`.
*
* `e`:
- * CTF IR event. The parameter type is `struct bt_event *`.
+ * Trace IR event. The parameter type is `struct bt_event *`.
*
* `S`:
- * CTF IR stream class. The parameter type is `struct bt_stream_class *`.
+ * Trace IR stream class. The parameter type is
+ * `struct bt_stream_class *`.
*
* `s`:
- * CTF IR stream. The parameter type is `struct bt_stream *`.
+ * Trace IR stream. The parameter type is `struct bt_stream *`.
*
* `a`:
* Packet. The parameter type is `struct bt_packet *`.
*
* `t`:
- * CTF IR trace. The parameter type is `struct bt_trace *`.
+ * Trace IR trace. The parameter type is `struct bt_trace *`.
*
* `K`:
* Clock class. The parameter type is `struct bt_clock_class *`.
* `struct bt_notification_iterator *`.
*
* `C`:
- * Component class. The parameter type is `struct bt_component_class *`.
+ * Component class. The parameter type is `struct
+ * bt_component_class *`.
*
* `c`:
* Component. The parameter type is `struct bt_component *`.
* `g`:
* Graph. The parameter type is `struct bt_graph *`.
*
- * `u`:
+ * `l`:
* Plugin. The parameter type is `struct bt_plugin *`.
*
* `o`:
* Object pool. The parameter type is `struct bt_object_pool *`.
*
- * Common category:
- * `F`:
- * Common field type. The parameter type is `struct bt_field_type *`.
- *
- * `f`:
- * Common field. The parameter type is `struct bt_field *`.
- *
- * `E`:
- * Common event class. The parameter type is
- * `struct bt_event_class *`.
- *
- * `e`:
- * Common event. The parameter type is `struct bt_event *`.
- *
- * `S`:
- * Common stream class. The parameter type is
- * `struct bt_stream_class *`.
- *
- * `s`:
- * Common stream. The parameter type is `struct bt_stream *`.
- *
- * `t`:
- * Common trace. The parameter type is `struct bt_trace *`.
+ * `O`:
+ * Object. The parameter type is `struct bt_object *`.
*
* Conversion specifier examples:
*
* %!f
* %![my-event-]+e
- * %!_t
- * %!+_F
+ * %!t
+ * %!+F
*
* The string `, ` is printed between individual fields, but not after
* the last one. Therefore you must put this separator in the format
* string between two Babeltrace objects, e.g.:
*
- * BT_LIB_LOGW("Message: count=%u, %!E, %!+C", count, event_class,
+ * BT_LIB_LOGW("Message: count=%u, %!E, %!+K", count, event_class,
* clock_class);
*
* Example with a custom prefix: