LTTNG-IRQFREQ(1)

💖 LTTNG-IRQFREQ 💖

okay bestie, welcome to the lttng-irqfreq page — it lives in the LTTng analyses manual (section 1, the user-commands girlies) and it is literally here to analyse IRQ frequency. no cap. let's get into it 🦋

✨ NAME ✨

lttng-irqfreq — LTTng analyses IRQ frequency 💅

🌸 DESCRIPTION 🌸

okay so the vibe is: this is the irq command. that's the whole thing. she analyses IRQ frequency and she serves. here's exactly how you call her:

usage: lttng-irqfreq [-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>

like yes, that's a lot of brackets. she's versatile. 💅

🎀 positional arguments

• <path/to/trace> — the trace path. that's it, that's the whole vibe, just hand her where your trace lives bestie 🫶

🧚 optional arguments

• -h, --help — show this help message and exit. the classic. the icon. when in doubt, -h it out 💖
• -r REFRESH, --refresh REFRESH — refresh period, with an optional units suffix (default units: s). so if you just say a number, she assumes seconds, iykyk.
• --gmt — manipulate timestamps based on GMT instead of local time. timezone girlie behaviour 🌍
• --skip-validation — skip the trace validation. living dangerously, no judgement 🙈
• --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). note the dependency bestie, she's not doing it alone 💅
• --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. pick your fave cores ⭐
• --timerange TIMERANGE — time range: [begin,end]
• --progress-use-size — use trace size to approximate progress. a lil estimation moment 📏
• --no-intersection — disable stream intersection mode
• -V, --version — show program's version number and exit
• --debug — enable debug mode (or set the LTTNG_ANALYSES_DEBUG environment variable). yes she said env var, go off 🔥
• --no-color — disable colored output. for when you're feeling monochrome 💀
• --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. the main character of this whole page honestly 👑
• --freq-resolution FREQ_RESOLUTION — frequency distribution resolution (default 20)
• --freq-uniform — use a uniform resolution across distributions. consistency queen ✨
• --freq-series — consolidate frequency distribution histogram as a single one
• --log — output the IRQs in chronological order. timeline vibes ⏳
• --stats — output IRQ statistics
• --irq IRQ — output results only for the list of IRQ
• --softirq SOFTIRQ — output results only for the list of SoftIRQ

ok bestie real talk: that's every single flag, every default, every env var, every literal. nothing skipped, nothing invented. she ate and left no crumbs 💅

and that's the page! this one's from LTTng Analyses v0.6.0, dated January 2017 — yeah she's vintage but she still slays, and honestly? iconic for it. mwah, go analyse some IRQs, ily 🫶💖🌸