LTTNG-PERIODFREQ(1)

📦 version 0.6.1, in debian bookworm, ubuntu jammy

💖 LTTNG-PERIODFREQ 💖

okay bestie, welcome to the LTTng Analyses corner of the manual pages — this one's lttng-periodfreq, section 1 (User Commands), and she's here to analyse period frequency. no cap. let's get into it 🦋

✨ NAME ✨

lttng-periodfreq — LTTng analyses period frequency 🌸

🌈 DESCRIPTION 🌈

the usage, verbatim, because I would never gatekeep a synopsis:

usage: lttng-periodfreq [-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] [--min MIN] [--max MAX] [--freq]
       [--freq-resolution FREQ_RESOLUTION] [--freq-uniform]
       [--freq-series] [--limit LIMIT] [--top] [--log] [--stats]
       [--min-duration MIN_DURATION] [--max-duration MAX_DURATION]
       [--aggregate-by AGGREGATE_BY] [--select SELECT] [--group-by
       GROUP_BY] [--order-by ORDER_BY] <path/to/trace>

it's the periods command. that's the whole vibe. periodt. 💅

🎀 positional arguments 🎀

  • <path/to/trace> — the trace path, aka where your little trace files live 🫶

👑 optional arguments 👑

  • -h, --help — shows this help message and dips. iconic.
  • -r REFRESH, --refresh REFRESH — refresh period, and yes you can slap a units suffix on it (default units: s) ⏱️
  • --gmt — manipulates timestamps based on GMT instead of local time 🌍
  • --skip-validation — skip the trace validation. living dangerously, love that for you 🙈
  • --begin BEGIN — start time: hh:mm:ss[.nnnnnnnnn]
  • --end END — end time: hh:mm:ss[.nnnnnnnnn]
  • --period PERIOD — period definition
  • --period-captures PERIOD_CAPTURES — period captures definition
  • --period-begin PERIOD_BEGIN — analysis period start marker event name
  • --period-end PERIOD_END — analysis period end marker event name (and heads up, this one requires --period-begin)
  • --period-begin-key PERIOD_BEGIN_KEY — optional, a list of event field names used to match period markers (default: cpu_id)
  • --period-end-key PERIOD_END_KEY — optional, a list of event field names used to match period marker. if none is specified, it just uses the same as --period-begin-key
  • --period-key-value PERIOD_KEY_VALUE — optional, define a fixed key value that a period must correspond to in order to be considered
  • --cpu CPU — filter the results only for this list of CPU IDs 🖥️
  • --timerange TIMERANGE — time range: [begin,end]
  • --progress-use-size — use trace size to approximate progress
  • --no-intersection — disable stream intersection mode
  • -V, --version — shows the program's version number and exits
  • --debug — enable debug mode (or just set the LTTNG_ANALYSES_DEBUG environment variable, same energy) 🐛
  • --no-color — disable colored output. sad, but valid.
  • --no-progress — don't display the progress bar
  • --min MIN — filter out durations shorter than min usec
  • --max MAX — filter out durations longer than max usec
  • --freq — output statistics about periods durations 📊
  • --freq-resolution FREQ_RESOLUTION — frequency distribution resolution (default 20)
  • --freq-uniform — use a uniform resolution across distributions
  • --freq-series — consolidate frequency distribution histogram as a single one
  • --limit LIMIT — limit to top X (default = 10)
  • --top — output the top sched switch durations 🔥
  • --log — output the sched switches in chronological order
  • --stats — output sched switch statistics
  • --min-duration MIN_DURATION — filter out, periods shorter that duration (usec)
  • --max-duration MAX_DURATION — filter out, periods longer than duration (usec)
  • --aggregate-by AGGREGATE_BY — FIXME 💀 (yes fr, that's literally what it says, I'm not making stuff up)
  • --select SELECT — FIXME 💀 (same, bestie)
  • --group-by GROUP_BY — present the results grouped by a list of fields (period.captured_field[, period.captured_field2])
  • --order-by ORDER_BY — hierarchy, time
no notes, just vibes: if something says FIXME, that's the manpage's words, not mine. I keep it 💯 real and I keep it exact.

that's the whole page, bestie — every flag, every default, every FIXME, all of it. nothing skipped, nothing invented. 🧚

this cutie is from LTTng Analyses v0.6.0, dated January 2017, and it lives in section 1 of the manual. take care of her, she's been holding it down since 2017 and she still ate 💖✨🎀🦋🌸🫶👑🌈⭐💜

📦 where this page comes from