# babeltrace2-filter.utils.muxer

## NAME



           babeltrace2-filter.utils.muxer - Babeltrace 2: 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 doesn’t 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>)
    


* * *