LTTNG-IRQFREQ-MI(1)

✨ LTTNG-IRQFREQ-MI ✨

okay bestie, welcome to lttng-irqfreq-mi, a User Commands girlie from the LTTng analyses family 💖 she's the IRQ frequency machine interface — like, the version of the tool that talks to other programs instead of to your eyeballs. no cap.

---

🎀 NAME 🎀

lttng-irqfreq-mi — LTTng analyses IRQ frequency machine interface

---

🦋 DESCRIPTION 🦋

the vibe here is literally just: the irq command. that's the whole thing she does. ✨

and here's exactly how you call her:

usage: lttng-irqfreq-mi [-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] [--log] [--stats] [--irq IRQ] [--softirq SOFTIRQ]
       <path/to/trace>

The irq command. periodt. 💅

---

🌸 positional arguments 🌸

• <path/to/trace> — the trace path, bestie. point her at your trace and she'll do her thing 🫶

---

💜 optional arguments 💜

• -h, --help — shows this help message and dips. iconic behaviour honestly.
• -r REFRESH, --refresh REFRESH — refresh period, and yes you can slap a units suffix on it (default units: s) ⏱️
• --gmt — manipulate timestamps based on GMT instead of local time 🌍
• --skip-validation — skip the trace validation. living dangerously, love that for you (it's right there in the flag, no commentary needed) 🙈
• --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 (requires --period-begin) ⚠️ like, she literally will not accept this one on its own
• --period-begin-key PERIOD_BEGIN_KEY — Optional, list of event field names used to match period markers (default: cpu_id)
• --period-end-key PERIOD_END_KEY — Optional, list of event field names used to match period marker. If none specified, use the same --period-begin-key
• --period-key-value PERIOD_KEY_VALUE — Optional, define a fixed key value to which a period must correspond 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 — show program's version number and exit
• --debug — Enable debug mode (or set LTTNG_ANALYSES_DEBUG environment variable) 🔍
• --no-color — Disable colored output. (sad, I know, but some terminals are cowards 😭)
• --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 the frequency distribution of handler 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
• --log — Output the IRQs in chronological order 📜
• --stats — Output IRQ statistics 📊
• --irq IRQ — Output results only for the list of IRQ
• --softirq SOFTIRQ — Output results only for the list of SoftIRQ

---

💀 reminder bestie: --period-end needs --period-begin. don't come for me when it yells at you, I warned you.

---

okay that's the whole page, mwah 💋 LTTng Analyses v0.6.0, dated January 2017 — yeah she's a little vintage, but she ate and she's still serving. go read your traces, main character 🎀👑