BABELTRACE(1)

💖 BABELTRACE 💖

okay bestie, buckle up — this is the babeltrace manual page, aka Babeltrace Trace Viewer and Converter, from the fine folks in section 1 of the manual. no cap, it's lowkey iconic. 🦋

---

✨ SYNOPSIS ✨

babeltrace [OPTIONS] FILE...

---

🌸 DESCRIPTION 🌸

So, Babeltrace is a trace viewer and converter — it reads and writes the Common Trace Format (that's CTF, iykyk). Its whole main-character thing? Pretty-printing CTF traces into a human-readable text output that's all nicely ordered by time. Chef's kiss. 👑

This program follows the usual GNU command line syntax, with long options starting with two dashes. Below is a summary of the available options, and yes, we're going through all of them, no skipping. 💅

• FILE — Input trace FILE(s) or directory(ies). (yes, you can just hand it a pile of them 🫶)

🎀 OPTIONS 🎀

• -w, --output OUTPUT — Output trace path. (default: stdout, so it just vibes onto your screen)
• -i, --input-format FORMAT — Input trace format. (default: ctf) And ngl, CTF is currently the only supported input format, so that's the whole menu.
• -o, --output-format FORMAT — Output trace format. (default: text)
• -h, --help — This help message. the classic. 🙈
• -l, --list — List available formats.
• -v, --verbose — Verbose mode. (or set the BABELTRACE_VERBOSE environment variable, if that's more your vibe)
• -d, --debug — Debug mode. (or set the BABELTRACE_DEBUG environment variable 💀)
• --no-delta — Do not print time delta between consecutive events.
• -n, --names name1<,name2,...> — Print field names. Your options are: (payload OR args OR arg), none, all, scope, header, (context OR ctx). (default: payload,context)
• -f, --fields name1<,name2,...> — Print additional fields: all, trace, trace:hostname, trace:domain, trace:procname, trace:vpid, loglevel.
• --clock-cycles — Disregard internal clock offset (use the raw value, bestie).
• --clock-offset seconds — Clock offset in seconds.
• --clock-seconds — Print the timestamps as [sec.ns] (default is: [hh:mm:ss.ns]).
• --clock-date — Print clock date.
• --clock-gmt — Print clock in GMT time zone. (default: local time zone, in case you were wondering 🌍)
• --stream-intersection — Only print events when all streams are active.
• --debug-info-dir — Directory in which to look for debugging information files. (default: /usr/lib/debug/)
• --debug-info-target-prefix — Directory to use as a prefix for executable lookup.
• --debug-info-full-path — Show full debug info source and binary paths (if available ✨).

Formats available: ctf, dummy, text.

---

💜 ENVIRONMENT VARIABLES 💜

Heads up bestie: all command line options will override environmental variables. the command line always wins, periodt. 💅

• BABELTRACE_VERBOSE — Activate verbose Babeltrace output.
• BABELTRACE_DEBUG — Activate debug Babeltrace output.

---

🦋 SEE ALSO 🦋

babeltrace-log(1), lttng(1), lttng-ust(3), lttng-sessiond(8)

go read those next, they're the friend group. 🌈

---

💀 BUGS 💀

okay so, not everything is slay:

• The lttng-live plugin does not honor the --output command line option. yeah. it just doesn't. 😭

If you encounter any issues or usability problem, please report it on our mailing list <lttng-dev@lists.lttng.org> to help improve this project. we're literally begging you, it helps. 🫶

---

👑 CREDITS 👑

Babeltrace and the babeltrace library are distributed under the MIT license. See the files LICENSE and mit-license.txt for details.

A Web site is available at http://www.efficios.com/babeltrace for more information on Babeltrace and the Common Trace Format. See http://lttng.org for more information on the LTTng project.

Mailing list for support and development: <lttng-dev@lists.lttng.org>.

You can find us on IRC server irc.oftc.net (OFTC) in #lttng. come say hi!! 🎀

---

🌸 THANKS 🌸

Thanks to the Linux Foundation and Ericsson for funding part of this work. Thanks to the Multicore Association Tool Infrastructure Working Group for their active role in the creation of the Common Trace Format. absolute legends, every one of them. 🙌

---

⭐ AUTHORS ⭐

Babeltrace was originally written by Mathieu Desnoyers, with additional contributions from various other people. It is currently maintained by Mathieu Desnoyers <mathieu.desnoyers@efficios.com>.

---

and that's the whole page bestie!! ✨ this one's dated February 6, 2012, and yeah — it's the BABELTRACE(1) page, section 1 of the manual, so you know exactly where to find it again. go forth and pretty-print some traces. you got this. 💖🌈🦋