LTTNG-MEMTOP(1)

📦 version 0.6.1, in debian bookworm, ubuntu jammy

💖 LTTNG-MEMTOP — lttng-memtop 💖

okay bestie, welcome to the LTTng analyses memory top page, from the LTTNG-MEMTOP(1) manual (User Commands section, obvi). it lives in the LTTng Analyses universe and it's here to show you who's eating all the memory. no cap. 🫶

✨ NAME ✨

lttng-memtop — LTTng analyses memory top. that's it, that's the vibe. she analyzes, she tops, she serves memory stats. 👑

🌸 DESCRIPTION 🌸

here's how you summon her, fr fr:

usage: lttng-memtop [-h] [-r REFRESH] [--gmt] [--skip-validation]

[--begin BEGIN] [--end END] [--period PERIOD]
       [--period-captures PERIOD_CAPTURES] [--period-begin PERIOD_BEGIN]
       [--period-end PERIOD_END] [--period-begin-key PERIOD_BEGIN_KEY]
       [--period-end-key PERIOD_END_KEY] [--period-key-value
PERIOD_KEY_VALUE] [--cpu CPU] [--timerange TIMERANGE]
       [--progress-use-size] [--no-intersection] [-V] [--debug]
       [--no-color] [--no-progress] [--procname PROCNAME] [--tid TID]
       [--limit LIMIT] [--top] <path/to/trace>

lowkey that's a lot of flags but we're gonna go through every single one together, hand in hand. 🫶

ngl, the description in the original is literally just "The memtop command." so. there it is. the memtop command. iconic behaviour honestly. 💅

🎀 positional arguments 🎀

  • <path/to/trace> — the trace path. this is literally where your trace lives. you gotta give her this or she has nothing to look at. 💖

🦋 optional arguments 🦋

  • -h, --help — shows this help message and exits. the classic. the "help me i'm lost" button. 🙈
  • -r REFRESH, --refresh REFRESH — the refresh period, and you can slap an optional units suffix on it (default units: s). so like, she'll re-draw the screen on that rhythm. ⭐
  • --gmt — manipulate timestamps based on GMT instead of local time. timezone girlie behaviour. 🌈
  • --skip-validation — skip the trace validation. yolo mode, essentially. 🔥
  • --begin BEGIN — start time, formatted like hh:mm:ss[.nnnnnnnnn]. yes, nanoseconds are invited to the party. ✨
  • --end END — end time, formatted like hh:mm:ss[.nnnnnnnnn]. same deal, other end of the window. 💜
  • --period PERIOD — period definition. she likes a defined period, periodt. 🎀
  • --period-captures PERIOD_CAPTURES — period captures definition.
  • --period-begin PERIOD_BEGIN — analysis period start marker event name. this is the event that screams "PERIOD STARTS NOW". 📣
  • --period-end PERIOD_END — analysis period end marker event name. ⚠️ requires --period-begin, so don't come in with an end and no beginning, bestie, that's not how arcs work.
  • --period-begin-key PERIOD_BEGIN_KEY — optional, a list of event field names used to match period markers (default: cpu_id). so if you don't say anything, it's riding with cpu_id. 💅
  • --period-end-key PERIOD_END_KEY — optional, a list of event field names used to match the period marker. if none are specified, it uses the same as --period-begin-key. matching outfits, cute. 🎀
  • --period-key-value PERIOD_KEY_VALUE — optional, defines a fixed key value that a period must correspond to in order to be considered. like a lil bouncer at the door. 👑
  • --cpu CPU — filter the results only for this list of CPU IDs. pick your fave CPUs. 🖥️
  • --timerange TIMERANGE — time range, written as [begin,end]. brackets stay on. 🌸
  • --progress-use-size — use trace size to approximate progress. approximation girlie. ✨
  • --no-intersection — disable stream intersection mode. she's turning off the overlap-matching, okay?? 😭
  • -V, --version — show the program's version number and exit. quick lil flex. 💅
  • --debug — enable debug mode (or set the LTTNG_ANALYSES_DEBUG environment variable). yes she does accept env vars, she's flexible like that. 🧚
  • --no-color — disable colored output. for when you're feeling monochrome and minimal (we support you but we don't get it). 💀
  • --no-progress — don't display the progress bar. no lil bar creeping across your terminal, you're on your own. 🍓
  • --procname PROCNAME — filter the results only for this list of process names. name names, bestie. 🔍
  • --tid TID — filter the results only for this list of TIDs. thread IDs only, we're being specific. 🧵
  • --limit LIMIT — limit to top X (default = 10). so by default you get the top ten, and you can change that number to whatever your heart desires. 💖
  • --top — output the top results. this is literally the whole point of a memtop, but go off. 👑

💜 SEE ALSO 💜

no SEE ALSO section in this one bestie — the original doesn't have one, so we're not inventing references. keeping it honest, fr fr. 🫶

that's the whole page!! every flag, every default, every format string, all present and accounted for, nothing skipped, no cap. 🦋

LTTng Analyses v0.6.0 — January 2017 🎀

and that's the sign-off from your favourite LTTNG-MEMTOP(1) manual, written with love, hype, and absolutely zero removed options. go analyze that memory, main character. ✨👑💖

📦 where this page comes from