LTTNG-VERSION(1)

📦
version 2.15.1 · 12 versions
, in ubuntu stonking

🌸 LTTNG-VERSION(1) 🌸

okay bestie, welcome to the LTTng Manual page for lttng-version — yes, the manual name is literally right there in the corner, we love a title that introduces itself 💅

✨ NAME ✨

lttng-version — get the version of LTTng-tools 🎀

✨ SYNOPSIS ✨

lttng [GENERAL OPTIONS] version

✨ DESCRIPTION ✨

so the lttng version command shows you the version of LTTng-tools — that's the whole LTTng project that gives you the lttng(1) command plus a bunch of other tracing control programs and libraries 🦋

and the output of the version command shows:

  • the major, minor, and patch version numbers 👑
  • the Git commit information, if available (only if it exists, don't come for me)
  • the release name and its description 🌸
  • the URL of the LTTng project website
  • the license information ⭐

✨ OPTIONS ✨

head over to lttng(1) for the GENERAL OPTIONS, bestie 🫶

🎀 Program information 🎀

  • -h, --help — Show help.

this option attempts to launch /usr/bin/man to view this manual page, no cap. you can override the manual pager path with the LTTNG_MAN_BIN_PATH environment variable ✨

  • --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. like, immediately, no mercy 💅
  • 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 🫶

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

  • 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 🚫
  • 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 👑

  • 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 💖
  • never — Never emit SGR codes 🙈
  • 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 🌸

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

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

✨ SEE ALSO ✨

lttng(1)

and that's the whole page bestie 🫶 this was LTTng 2.15.1, dated 21 April 2021, and it's giving LTTNG-VERSION(1) — periodt 💅✨

📦 where this page comes from