LTTNG-LIST-TRIGGER(1)

📦
version 2.15.1 · 11 versions
, in ubuntu stonking

💖 lttng-list-triggers — the manual, but make it slay 💖

okay bestie, sit down, grab a boba 🧋 — this is lttng-list-trigger(1), straight out of the LTTng Manual. Yes it's a manual page. Yes it's about triggers. Yes I'm gonna make it cute. no cap. ✨

🌸 NAME 🌸

lttng-list-triggers — literally just list LTTng triggers 💅

✨ SYNOPSIS ✨

lttng [GENERAL OPTIONS] list-triggers

🦋 DESCRIPTION 🦋

so the lttng list-triggers command lists the available LTTng triggers of your Unix user — or of all users if your Unix user is root 👑 — and it shows you their properties too. the whole package deal, fr fr.

if you wanna actually understand triggers before you go poking at them, go read lttng-concepts(7). it's giving homework but it's good homework 🫶

💜 OPTIONS 💜

want the GENERAL OPTIONS? those live over in lttng(1), bestie. this page only has the lil local ones.

🎀 Program information 🎀

  • -h, --help — shows help. it attempts to launch /usr/bin/man to open this very manual page. if you wanna use a different manual pager, override the path with the LTTNG_MAN_BIN_PATH environment variable. iconic behavior honestly.
  • --list-options — lists the available command options and then dips. that's it. that's the whole job. 💅

🔥 EXIT STATUS 🔥

  • 0 — Success 🥳
  • 1 — Command error 😭
  • 2 — Undefined command 💀
  • 3 — Fatal error 🙈
  • 4 — Command warning (something went wrong during the command) 😬

🌈 ENVIRONMENT 🌈

  • LTTNG_ABORT_ON_ERROR — set to 1 to abort the process after the first error is encountered. no second chances vibes.
  • LTTNG_HOME — path to the LTTng home directory.
    • Defaults to $HOME. 🏠
    • Super useful when the Unix user running the commands has a non-writable home directory (we've all been there).
  • LTTNG_LIST_LEGACY — set to 1 to use the legacy output format (LTTng 2.14 and earlier) for the lttng-list(1) command instead of the modern output format.
    • heads up: the legacy output doesn't show anything related to features introduced after LTTng 2.14. so it's the old aesthetic, not the full picture. 🫠
  • LTTNG_MAN_BIN_PATH — absolute path to the manual pager to use to read the LTTng command-line help (with lttng-help(1) or with the --help option) instead of /usr/bin/man.
  • LTTNG_NO_UTF_8 — set to 1 to NOT emit multi-byte UTF-8 sequences, even if the locale claims to support it. sometimes we just don't want the sparkle ✋😌
  • LTTNG_SESSION_CONFIG_XSD_PATH — path to the directory containing the session.xsd recording session configuration XML schema.
  • LTTNG_SESSIOND_PATH — absolute path to the LTTng session daemon binary (see lttng-sessiond(8)) to spawn from the lttng-create(1) command.
    • ngl, the --sessiond-path general option overrides this environment variable. option > env, that's the hierarchy bestie 🫡
  • LTTNG_TERM_COLOR — controls when to emit terminal SGR codes in the output.
    • the NO_COLOR environment variable overrides this. 👀
    • one of:
      • auto (default) — only emit SGR codes when the standard output is connected to a color-capable terminal.
      • always — always emit SGR codes. rainbow time 🌈
      • never — never emit SGR codes. monochrome era.
  • NO_COLOR — if set and not empty, then it's equivalent to setting LTTNG_TERM_COLOR to never.

🍓 FILES 🍓

  • $LTTNG_HOME/.lttngrc — Unix user's LTTng runtime configuration.
    • this is where LTTng stores the name of the Unix user's current recording session between executions of lttng(1). lttng-create(1) and lttng-set-session(1) set the current recording session. so this file is basically the "currently vibing with this session" note 📝
  • $LTTNG_HOME/lttng-traces — default output directory of LTTng traces in local and snapshot modes.
    • override this path with the --output option of the lttng-create(1) command.
  • $LTTNG_HOME/.lttng — Unix user's LTTng runtime and configuration directory.
  • $LTTNG_HOME/.lttng/sessions — default directory containing the Unix user's saved recording session configurations (see lttng-save(1) and lttng-load(1)).
  • /etc/lttng/sessions — directory containing the system-wide saved recording session configurations (see lttng-save(1) and lttng-load(1)).
Note 📌 $LTTNG_HOME defaults to the value of the HOME environment variable.

⭐ RESOURCES ⭐

this program is part of the LTTng-tools project. 🫶

LTTng-tools is distributed under the GNU General Public License version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html>. See the LICENSE <https://github.com/lttng/lttng-tools/blob/master/LICENSE> file for details.

💐 THANKS 💐

special thanks to Michel Dagenais and the DORSAL laboratory <http://www.dorsal.polymtl.ca/> at École Polytechnique de Montréal for the LTTng journey. iconic scholarship moment 🎓✨

also thanks to the Ericsson teams working on tracing which helped us greatly with detailed bug reports and unusual test cases. (the unusual test cases?? they ate, honestly 🔥)

🫶 SEE ALSO 🫶

lttng(1), lttng-add-trigger(1), lttng-remove-trigger(1), lttng-concepts(7)

okay that's the whole page, bestie, you're so welcome 💖 this was LTTng 2.15.1, dated 3 May 2021 — go list some triggers, you main character 👑💅

📦 where this page comes from