---
name: "babeltrace2-filter.utils.muxer"
section: "7"
platform: "linux"
package: "babeltrace2"
version: "2.1.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/babeltrace2-filter.utils.muxer"
---

# babeltrace2-filter.utils.muxer(7)

Babeltrace 2: Message muxer filter component class

## 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)](/babeltrace2-intro/7.md) 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\>)

## 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-intro/7.md), [**babeltrace2-plugin-utils**(7)](/babeltrace2-plugin-utils/7.md)