LTTNG-IRQLOG(1)

✨ LTTNG-IRQLOG ✨

okay so bestie, this is lttng-irqlog — the LTTng analyses IRQ log tool 💅 it lives in the LTTng Analyses family of user commands and it's literally here to make your IRQ trace data make sense. no cap. 🫶

🌸 NAME 🌸

lttng-irqlog — LTTng analyses IRQ log 💖

🦋 DESCRIPTION 🦋

the vibe is: you point it at a trace, it does irq stuff. here's the whole usage, exactly as it goes down:

usage: lttng-irqlog [-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. that's where your trace lives. 📁

💜 optional arguments 💜

• -h, --help — show this help message and exit. the classic. the icon. 🙈
• -r REFRESH, --refresh REFRESH — refresh period, with an optional units suffix (default units: s). tick tock ⏰
• --gmt — manipulate 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 (requires --period-begin)
• --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, but okay 🥲)
• --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

bestie reminder: --period-end will not work without --period-begin, and --period-end-key will silently just borrow --period-begin-key if you don't give it one. ikyk. 💅

that's the whole page, bestie, you ate it. 🎀

✨ this one's from LTTng Analyses v0.6.0, dated January 2017 — shoutout to the og manual page, still iconic after all these years. mwah 💖 🦋 🫶