LTTNG-SCHEDFREQ-MI(1)

💖 LTTNG-SCHEDFREQ-MI(1) 💖

ok so bestie, welcome to the lttng-schedfreq-mi manual page — that's from section 1 of the manuals, the User Commands girlies 💅. This is the LTTng analyses Scheduler frequency machine interface and she is iconic and also kind of a lot. Buckle up 🎀

✨ NAME ✨

lttng-schedfreq-mi — LTTng analyses Scheduler frequency machine interface 🦋

🌸 DESCRIPTION 🌸

okay so here's the vibe. Usage goes like this:

lttng-schedfreq-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] [--procname
       PROCNAME] [--tid TID] [--freq] [--freq-resolution
       FREQ_RESOLUTION] [--freq-uniform] [--freq-series] [--limit LIMIT]
       [--top] [--log] [--stats] [--total] [--per-tid] [--per-prio]
       <path/to/trace>

It's the sched command. periodt. 💀

🧚 positional arguments

• <path/to/trace> — literally just the trace path bestie, that's where your trace lives 🫶

🎀 optional arguments

• -h, --help — shows this help message and then dips, exit stage left ✨
• -r REFRESH, --refresh REFRESH — the refresh period, and you can tack an optional 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 🙈
• --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 (heads up: this one requires --period-begin, no skipping 💅)
• --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 specified, it just uses the same --period-begin-key 🪞
• --period-key-value PERIOD_KEY_VALUE — optional, defines 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, bye 👋
• --debug — enable debug mode (or you can set the LTTNG_ANALYSES_DEBUG environment variable instead, your call bestie) 🐛
• --no-color — disable colored output 😭 (devastating 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
• --procname PROCNAME — filter the results only for this list of process names
• --tid TID — filter the results only for this list of TIDs
• --freq — output the frequency distribution of sched switch latencies 📊
• --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 latencies 🔝
• --log — output the sched switches in chronological order 📜
• --stats — output sched switch statistics
• --total — group all results (applies to stats and freq)
• --per-tid — group results per-TID (applies to stats and freq) (default) 🫶
• --per-prio — group results per-prio (applies to stats and freq)

no cap: if you're mixing --per-tid and --per-prio, just remember --per-tid is the default, so if you say nothing, that's the one you get 💖

and that's the whole page bestie, you ate it up 🍓 this was LTTng Analyses v0.6.0, dated January 2017 — slay, mwah, go analyze some sched switches 💜✨