tests/utils/bt2_plugins/README.md

   1 The `filter.lttngtest.event_name` plugin only has a single input and output port.
   2 This means that it cannot be connected directly to a `source.ctf.fs` plugin, as
   3 those have multiple output ports for the different event streams.
   4
   5 A `filter.utils.muxer` plugin must be placed between any multi-output port plugin
   6 and the `filter.lttngtest.event_name` plugin. This is done automatically with in
   7 the architecture created by `babeltrace2 convert`.
   8
   9 Example with `babeltrace2 convert`:
  10
  11 ```
  12 SOURCE_PATH=/tmp/tmp.1J5DueCziG
  13 EVENT_NAME=tp:the_string
  14 babeltrace2 --plugin-path=.libs/ convert "${SOURCE_PATH}" -c filter.lttngtest.event_name -p "names=[\"$EVENT_NAME\"]" -c sink.lttngtest.field_stats
  15 ```
  16
  17 Example with `babeltrace2 run`:
  18
  19 ```
  20 SOURCE_PATH=/tmp/tmp.1J5DueCziG
  21 EVENT_NAME=tp:the_string
  22 babeltrace2 --plugin-path=.libs/ run -c A:source.ctf.fs -p "inputs=[\"$SOURCE_PATH\"]" -c muxer:filter.utils.muxer -c B:filter.lttngtest.event_name -p "names=[\"$EVENT_NAME\"]" -c C:sink.lttngtest.field_stats -x A:muxer -x muxer:B -x B:C
  23 ```