LTTNG-IRQLOG-MI(1)

👑 NAME 👑

lttng-irqlog-mi — the LTTng analyses IRQ log machine interface, bestie 💖

✨ DESCRIPTION ✨

Okay so. This is the command-line tool that does the IRQ log thing through LTTng analyses' machine interface. She's a command, and here's exactly how you call her:

usage: lttng-irqlog-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. That's the whole vibe 🦋

🎀 positional arguments

• <path/to/trace> — the path to your trace. that's it, that's the one thing she needs from you, no cap.

💅 optional arguments

• -h, --help — shows this help message and dips. classic ✨
• -r REFRESH, --refresh REFRESH — the refresh period, and you can tack a units suffix on there if you want (default units are s).
• --gmt — do the timestamp math based on GMT instead of your local time. timezone girlies rise 🫶
• --skip-validation — skips validating the trace. yolo mode, but make it sanctioned.
• --begin BEGIN — start time, formatted like hh:mm:ss[.nnnnnnnnn].
• --end END — end time, formatted like hh:mm:ss[.nnnnnnnnn].
• --period PERIOD — defines a period.
• --period-captures PERIOD_CAPTURES — defines period captures.
• --period-begin PERIOD_BEGIN — the event name that marks the start of the analysis period.
• --period-end PERIOD_END — the event name that marks the end of the analysis period. heads up bestie, this one requires --period-begin 👀
• --period-begin-key PERIOD_BEGIN_KEY — optional; a list of event field names used to match the period markers (default: cpu_id).
• --period-end-key PERIOD_END_KEY — optional; a list of event field names used to match the period marker. if you don't specify any, it just uses whatever you gave to --period-begin-key.
• --period-key-value PERIOD_KEY_VALUE — optional; pins down a fixed key value that a period has to correspond to in order to even be considered. picky, and honestly? valid.
• --cpu CPU — filters the results so you only see this list of CPU IDs.
• --timerange TIMERANGE — the time range, written as [begin,end].
• --progress-use-size — approximates progress using the trace size.
• --no-intersection — turns off stream intersection mode.
• -V, --version — shows the program's version number and exits. main character exit 💅
• --debug — enables debug mode (or you can just set the LTTNG_ANALYSES_DEBUG environment variable, whatever's easier).
• --no-color — kills the colored output. for the monochrome minimalists 🖤
• --no-progress — doesn't display the progress bar.
• --min MIN — filters out any durations shorter than min usec.
• --max MAX — filters out any durations longer than max usec.
• --freq — outputs the frequency distribution of handler durations.
• --freq-resolution FREQ_RESOLUTION — the resolution for that frequency distribution (default 20).
• --freq-uniform — uses a uniform resolution across all the distributions.
• --freq-series — consolidates the frequency distribution histogram down into a single one.
• --log — outputs the IRQs in chronological order. timeline slay 🔥
• --stats — outputs IRQ statistics.
• --irq IRQ — outputs results only for this list of IRQ.
• --softirq SOFTIRQ — outputs results only for this list of SoftIRQ.

and that's the whole page, bestie, you ate it up 💖✨

this was LTTng Analyses v0.6.0, dated January 2017 — iconique, historic, we stan a legacy release 🎀🦋