mirror of
git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
synced 2025-08-05 16:54:27 +00:00

Add man page and kernel documentation for the sched monitors, as sched is a container of other monitors, document all in the same page. sched is the first nested monitor, also explain what is a nested monitor and how enabling containers or children monitors work. To: Ingo Molnar <mingo@redhat.com> To: Peter Zijlstra <peterz@infradead.org> Cc: Juri Lelli <juri.lelli@redhat.com> Cc: Ingo Molnar <mingo@redhat.com> Cc: Peter Zijlstra <peterz@infradead.org> Cc: Jonathan Corbet <corbet@lwn.net> Cc: John Kacur <jkacur@redhat.com> Cc: Clark Williams <williams@redhat.com> Link: https://lore.kernel.org/20250305140406.350227-9-gmonaco@redhat.com Signed-off-by: Gabriele Monaco <gmonaco@redhat.com> Signed-off-by: Steven Rostedt (Google) <rostedt@goodmis.org>
69 lines
1.5 KiB
ReStructuredText
69 lines
1.5 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
============
|
|
rv-mon-sched
|
|
============
|
|
-----------------------------
|
|
Scheduler monitors collection
|
|
-----------------------------
|
|
|
|
:Manual section: 1
|
|
|
|
SYNOPSIS
|
|
========
|
|
|
|
**rv mon sched** [*OPTIONS*]
|
|
|
|
**rv mon <NESTED_MONITOR>** [*OPTIONS*]
|
|
|
|
**rv mon sched:<NESTED_MONITOR>** [*OPTIONS*]
|
|
|
|
DESCRIPTION
|
|
===========
|
|
|
|
The scheduler monitor collection is a container for several monitors to model
|
|
the behaviour of the scheduler. Each monitor describes a specification that
|
|
the scheduler should follow.
|
|
|
|
As a monitor container, it will enable all nested monitors and set them
|
|
according to OPTIONS.
|
|
Nevertheless nested monitors can also be activated independently both by name
|
|
and by specifying sched: , e.g. to enable only monitor tss you can do any of:
|
|
|
|
# rv mon sched:tss
|
|
|
|
# rv mon tss
|
|
|
|
See kernel documentation for further information about this monitor:
|
|
<https://docs.kernel.org/trace/rv/monitor_sched.html>
|
|
|
|
OPTIONS
|
|
=======
|
|
|
|
.. include:: common_ikm.rst
|
|
|
|
NESTED MONITOR
|
|
==============
|
|
|
|
The available nested monitors 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>
|
|
|
|
.. include:: common_appendix.rst
|