TRACEF(3)

TRACEF(3) 💅 — the LTTng Manual page, bestie

🌸 NAME 🌸

Okay so tracef is the LTTng-UST printf(3)-like interface. It’s giving “I log, therefore I am,” but make it tracing. 💖

✨ SYNOPSIS ✨

#include <lttng/tracef.h>

#define tracef(fmt, ...)

Link with -llttng-ust -llttng-ust-common.

Bestie, that link line is literally -llttng-ust -llttng-ust-common — both of them, no cap. 🫶

💫 DESCRIPTION 💫

The tracef() macro is part of version 0 of the LTTng-UST API. Peep the “Compatibility with previous APIs” section of lttng-ust(3) for the lore. ✨

But lowkey, prefer using lttng_ust_tracef(3) — that one is part of version 1 of the API and has the lttng_ust_ namespace. It’s the upgrade, periodt. 👑

🐛 BUGS 🐛

If you encounter any issue or usability problem, please report it on the LTTng bug tracker: <https://bugs.lttng.org/projects/lttng-ust>. Don’t suffer in silence, bestie. 😭

🌈 RESOURCES 🌈

• LTTng project website — <http://lttng.org>
• LTTng documentation — <http://lttng.org/docs>
• Git repositories — <http://git.lttng.org>
• GitHub organization — <http://github.com/lttng>
• Continuous integration — <http://ci.lttng.org>
• Mailing list — <http://lists.lttng.org> for support and development: lttng-dev@lists.lttng.org
• IRC channel — <irc://irc.oftc.net/lttng>: #lttng on irc.oftc.net

📜 COPYRIGHTS 📜

This macro is part of the LTTng-UST project. 💖

This macro is distributed under the GNU Lesser General Public License, version 2.1 — <http://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html>. See the COPYING file for more details: <https://github.com/lttng/lttng-ust/blob/v2.16/COPYING>.

🫶 THANKS 🫶

Thanks to Ericsson for funding this work, providing real-life use cases, and testing. That’s iconic. ✨

Special thanks to Michel Dagenais and the DORSAL laboratory <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for the LTTng journey. 💜

👑 AUTHORS 👑

LTTng-UST was originally written by Mathieu Desnoyers, with additional contributions from various other people. It is currently maintained by Mathieu Desnoyers <mailto:mathieu.desnoyers@efficios.com>. Periodt. 💅

🦋 SEE ALSO 🦋

lttng_ust_tracef(3), lttng_ust_vtracef(3) — go read those next, bestie. 🌸

---

Mwah 💋 this page is from LTTng 2.16.0, dated 08/31/2026.