BABELTRACE2-FILTER()                                    BABELTRACE2-FILTER()

NAME         top

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

DESCRIPTION         top

       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.

           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         top

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

       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.

           Single output port.

BUGS         top

       If you encounter any issue or usability problem, please report it on
       the Babeltrace bug tracker (see

RESOURCES         top

       The Babeltrace project shares some communication channels with the
       LTTng project (see <>).

       ·   Babeltrace website (see <>)

       ·   Mailing list (see <>) for support and

       ·   IRC channel (see <irc://>): #lttng on

       ·   Bug tracker (see <>)

       ·   Git repository (see <>)

       ·   GitHub project (see <>)

       ·   Continuous integration (see

       ·   Code review (see <>)

AUTHORS         top

       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

COPYRIGHT         top

       This component class is part of the Babeltrace 2 project.

       Babeltrace is distributed under the MIT license (see

SEE ALSO         top

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

COLOPHON         top

       This page is part of the babeltrace (trace read and write libraries
       and a trace converter) project.  Information about the project can be
       found at ⟨⟩.  If you have a bug
       report for this manual page, send it to
       This page was obtained from the project's upstream Git repository
       ⟨git://⟩ on 2020-02-08.  (At that
       time, the date of the most recent commit that was found in the repos‐
       itory was 2020-02-03.)  If you discover any rendering problems in
       this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to


Pages that refer to this page: babeltrace2(1)babeltrace2-log(1)babeltrace2-plugin-utils(7)