NAME

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

DESCRIPTION

       A Babeltrace 2 filter.utils.muxer message iterator muxes the messages that it consumes
       from one or more upstream message iterators into a linear sequence of messages ordered by
       time.

                       +-----------------+
                       | flt.utils.muxer |
                       |                 |
           Messages -->@ in0         out @--> Sorted messages
           Messages -->@ in1             |
           Messages -->@ in2             |
                       @ in3             |
                       +-----------------+

       See babeltrace2-intro(7) to learn more about the Babeltrace 2 project and its core
       concepts.

       A filter.utils.muxer message iterator does not alter the messages it consumes: it only
       sorts them.

       The message iterator creates one upstream message iterator per connected input port.

           Note
           To support muxing messages with different default clock classes, the message iterator
           converts the message times to nanoseconds from the common origin (Unix epoch, for
           example). This means that the resulting message sequence could be incorrect if one or
           more clock classes have a frequency which is greater than 1 GHz.

PORTS

           +-----------------+
           | flt.utils.muxer |
           |                 |
           @ in0         out @
           @ ...             |
           +-----------------+

   Input
       inN, where N is a decimal integer starting at 0
           Input port on which a filter.utils.muxer message iterator creates an upstream message
           iterator to consumes messages from.

           When the component is initialized, its only input port is in0. When you connect the
           in0 port, the component creates the in1 input port, and so on.

           In other words, a filter.utils.muxer component always has an available input port.

   Output
       out
           Single output port.

BUGS

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

RESOURCES

       The Babeltrace project shares some communication channels with the LTTng project (see
       <https://lttng.org/>).

       •   Babeltrace website (see <https://babeltrace.org/>)

       •   Mailing list (see <https://lists.lttng.org>) for support and development: lttng-
           dev@lists.lttng.org

       •   IRC channel (see <irc://irc.oftc.net/lttng>): #lttng on irc.oftc.net

       •   Bug tracker (see <https://bugs.lttng.org/projects/babeltrace>)

       •   Git repository (see <https://git.efficios.com/?p=babeltrace.git>)

       •   GitHub project (see <https://github.com/efficios/babeltrace>)

       •   Continuous integration (see <https://ci.lttng.org/view/Babeltrace/>)

       •   Code review (see <https://review.lttng.org/q/project:babeltrace>)

AUTHORS

       The Babeltrace 2 project is the result of hard work by many regular developers and
       occasional contributors.

       The current project maintainer is Jérémie Galarneau
       <mailto:jeremie.galarneau@efficios.com>.

COPYRIGHT

       This component class is part of the Babeltrace 2 project.

       Babeltrace is distributed under the MIT license (see
       <https://opensource.org/licenses/MIT>).

SEE ALSO

       babeltrace2-intro(7), babeltrace2-plugin-utils(7)

                                                                             BABELTRACE2-FILTER()