1BABELTRACE2-FILTER()                                      BABELTRACE2-FILTER()
2
3
4

NAME

6       babeltrace2-filter.utils.muxer - Babeltrace 2's message muxer filter
7       component class
8

DESCRIPTION

10       A Babeltrace 2 filter.utils.muxer message iterator muxes the messages
11       that it consumes from one or more upstream message iterators into a
12       linear sequence of messages ordered by time.
13
14                       +-----------------+
15                       | flt.utils.muxer |
16                       |                 |
17           Messages -->@ in0         out @--> Sorted messages
18           Messages -->@ in1             |
19           Messages -->@ in2             |
20                       @ in3             |
21                       +-----------------+
22
23       See babeltrace2-intro(7) to learn more about the Babeltrace 2 project
24       and its core concepts.
25
26       A filter.utils.muxer message iterator does not alter the messages it
27       consumes: it only sorts them.
28
29       The message iterator creates one upstream message iterator per
30       connected input port.
31
32           Note
33           To support muxing messages with different default clock classes,
34           the message iterator converts the message times to nanoseconds from
35           the common origin (Unix epoch, for example). This means that the
36           resulting message sequence could be incorrect if one or more clock
37           classes have a frequency which is greater than 1 GHz.
38

PORTS

40           +-----------------+
41           | flt.utils.muxer |
42           |                 |
43           @ in0         out @
44           @ ...             |
45           +-----------------+
46
47   Input
48       inN, where N is a decimal integer starting at 0
49           Input port on which a filter.utils.muxer message iterator creates
50           an upstream message iterator to consumes messages from.
51
52           When the component is initialized, its only input port is in0. When
53           you connect the in0 port, the component creates the in1 input port,
54           and so on.
55
56           In other words, a filter.utils.muxer component always has an
57           available input port.
58
59   Output
60       out
61           Single output port.
62

BUGS

64       If you encounter any issue or usability problem, please report it on
65       the Babeltrace bug tracker (see
66       <https://bugs.lttng.org/projects/babeltrace>).
67

RESOURCES

69       The Babeltrace project shares some communication channels with the
70       LTTng project (see <https://lttng.org/>).
71
72       •   Babeltrace website (see <https://babeltrace.org/>)
73
74       •   Mailing list (see <https://lists.lttng.org>) for support and
75           development: lttng-dev@lists.lttng.org
76
77       •   IRC channel (see <irc://irc.oftc.net/lttng>): #lttng on
78           irc.oftc.net
79
80       •   Bug tracker (see <https://bugs.lttng.org/projects/babeltrace>)
81
82       •   Git repository (see <https://git.efficios.com/?p=babeltrace.git>)
83
84       •   GitHub project (see <https://github.com/efficios/babeltrace>)
85
86       •   Continuous integration (see
87           <https://ci.lttng.org/view/Babeltrace/>)
88
89       •   Code review (see <https://review.lttng.org/q/project:babeltrace>)
90

AUTHORS

92       The Babeltrace 2 project is the result of hard work by many regular
93       developers and occasional contributors.
94
95       The current project maintainer is Jérémie Galarneau
96       <mailto:jeremie.galarneau@efficios.com>.
97

99       This component class is part of the Babeltrace 2 project.
100
101       Babeltrace is distributed under the MIT license (see
102       <https://opensource.org/licenses/MIT>).
103

SEE ALSO

105       babeltrace2-intro(7), babeltrace2-plugin-utils(7)
106
107
108
109                                                          BABELTRACE2-FILTER()
Impressum