RV-MON-SCHED(1)

💖 RV-MON-SCHED(1) 💖

okay bestie, so this is a page from the General Commands Manual — it's the manual page for rv-mon-sched, and we're gonna get you all the way together on it. no cap.

---

✨ NAME ✨

rv-mon-sched — Scheduler monitors collection

---

🌸 SYNOPSIS 🌸

rv mon sched [OPTIONS]

rv mon <NESTED_MONITOR> [OPTIONS]

rv mon sched:<NESTED_MONITOR> [OPTIONS]

---

🦋 DESCRIPTION 🦋

so the scheduler monitor collection is, like, a container for several monitors that together model how the scheduler behaves. each monitor describes a spec that the scheduler should follow. it's giving group project but make it kernel.

as a monitor container, it will enable all nested monitors and set them up according to OPTIONS. but plot twist — nested monitors can also be activated independently, both by name and by prefixing with sched:. so if you only wanna turn on the tss monitor, literally any of these work:

# rv mon sched:tss

# rv mon tss

for even more lore about this monitor, go check the kernel docs: <https://docs.kernel.org/trace/rv/monitor_sched.html> 👑

---

💅 OPTIONS 💅

• -h, --help — prints the monitor's options plus the list of available reactors. your lil cheat sheet, fr.
• -r, --reactor reactor — enables the reactor. peek at -h to see which reactors you can actually pick from.
• -s, --self — when you're tracing (-t), this also prints the events that happened while the rv command itself was running. heads up tho: if the rv command generates too many events on its own, the tool might get busy just processing its own events. 😭 self-absorbed much.
• -t, --trace — trace the monitor's events and errors.
• -v, --verbose — print debug messages.

---

🎀 NESTED MONITOR 🎀

the nested monitors you've got available are:

• scpd: schedule called with preemption disabled
• snep: schedule does not enable preempt
• sncid: schedule not called with interrupt disabled
• snroc: set non runnable on its own context
• sco: scheduling context operations
• tss: task switch while scheduling

---

🌈 SEE ALSO 🌈

• rv(1), rv-mon(1)
• Linux kernel RV documentation: <https://www.kernel.org/doc/html/latest/trace/rv/index.html>

---

👑 AUTHOR 👑

written by Gabriele Monaco <gmonaco@redhat.com> 🫶

---

💀 REPORTING BUGS 💀

found a bug? report it to <linux-kernel@vger.kernel.org> and <linux-trace-devel@vger.kernel.org>. not me being the one to tell you to email the kernel list 💀 but like, do it.

---

⭐ LICENSE ⭐

rv is Free Software, licensed under the GNU GPLv2. periodt.

---

💜 COPYING 💜

Copyright (C) 2022 Red Hat, Inc. Free use of this software is granted under the terms of the GNU Public License (GPL).

---

and that's the whole thing, bestie ✨ that was RV-MON-SCHED(1) from the General Commands Manual — go forth and monitor those schedulers, you absolute icon 🧚💖