LTTNG-REMOVE-TRIGG(1)

📦
version 2.15.1 · 11 versions
, in ubuntu stonking

💖 lttng-remove-trigg(1) — the LTTng Manual, bestie edition 💖

okay so. you wanna know about lttng-remove-trigger? you came to the right girl. sections stay in order, facts stay facts, vibes stay immaculate. let's go 🦋

✨ NAME ✨

lttng-remove-trigger — Remove an LTTng trigger

🎀 SYNOPSIS 🎀

lttng [GENERAL OPTIONS] remove-trigger [--owner-uid=UID] NAME

💅 DESCRIPTION 💅

The lttng remove-trigger command removes the trigger named NAME. that's it. that's the whole job. girlboss behaviour fr fr.

See lttng-concepts(7) to learn more about LTTng triggers. you will learn more, I promise, it's giving homework but cute homework.

Wanna see your triggers? List the triggers of your Unix user — or of all users if your Unix user is root — with the lttng-list-triggers(1) command. window shopping before you delete, we love to see it 💖

The remove-trigger command removes a trigger which belong to your Unix user. (yes bestie, "belong" — I'm keeping it exactly as it is, no cap.) If your Unix user is root, you can remove the trigger of another user with the --owner-uid option. root privileges = universal delete key energy 👑

See the “EXAMPLES” section below for usage examples. scroll down, don't be shy 🌸

⭐ OPTIONS ⭐

🧚 Identification 🧚

  • --owner-uid=UID — Remove the trigger named NAME of the Unix user having the user ID UID.

You may only use this option if your Unix user is root. no root, no pass. it's giving VIP section 💅

🌈 Program information 🌈

  • -h, --help — Show help.

This option attempts to launch /usr/bin/man to view this manual page. Override the manual pager path with the LTTNG_MAN_BIN_PATH environment variable. peak self-awareness, honestly 🫶

  • --list-options — List available command options and quit.

💀 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. first oopsie and we're OUT 🏃‍♀️
  • LTTNG_HOME — Path to the LTTng home directory.

Defaults to $HOME.

Useful when the Unix user running the commands has a non-writable home directory. (been there bestie, not fun)

  • 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.

Note that the legacy output doesn’t show anything related to features introduced after LTTng 2.14. it's giving throwback, but corrupted throwback 🕰️

  • 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. the locale is lying to you, apparently 😭
  • 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.

The --sessiond-path general option overrides this environment variable. option > env var, 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. so NO_COLOR is the bigger boss here, respect the chain of command.

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 mode activated 🌈
  • never — Never emit SGR codes. greyscale era 😔
  • NO_COLOR — If set and not empty, then it’s equivalent to setting LTTNG_TERM_COLOR to never.

See NO_COLOR <https://no-color.org/> to learn more.

🎀 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. it remembers your current session so you don't have to 🥹

  • $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.

🔥 EXAMPLES 🔥

Example 1. Remove a trigger.

$ lttng remove-trigger my-trigger

boom. gone. main character move, honestly 💅

Example 2. Remove a trigger as another Unix user.

The command line below removes a trigger as the mireille Unix user.

Your Unix user must be root to use the --owner-uid option. no root, no entry, sorry bestie 🚫

$ lttng remove-trigger --owner-uid=$(id --user mireille) \
                       my-trigger

🌈 RESOURCES 🌈

go follow them, they're iconic and they know it ⭐

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.

legal stuff but make it iconic 💜

💖 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.

Also thanks to the Ericsson teams working on tracing which helped us greatly with detailed bug reports and unusual test cases.

shoutout to the bug reporters, the unusual test cases are lowkey the best part tbh 🙈

🦋 SEE ALSO 🦋

lttng(1), lttng-add-trigger(1), lttng-list-triggers(1), lttng-concepts(7)

okay that's the whole thing, you're basically an LTTng trigger remover now 🎀 this was the LTTng 2.15.1 flavoured page, dated 17 May 2021, and it lives under the name LTTNG-REMOVE-TRIGG(1) — mwah, periodt 💅✨

📦 where this page comes from