git: 0730a05cd383 - main - tuning.7: document schedulers knobs

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Thu, 29 Jan 2026 22:44:03 UTC
The branch main has been updated by kib:

URL: https://cgit.FreeBSD.org/src/commit/?id=0730a05cd383276ca8eedf295509e869ac9b88a0

commit 0730a05cd383276ca8eedf295509e869ac9b88a0
Author:     Konstantin Belousov <kib@FreeBSD.org>
AuthorDate: 2026-01-29 21:40:29 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2026-01-29 22:43:45 +0000

    tuning.7: document schedulers knobs
    
    Reviewed by:    emaste, olce, ziaee
    Sponsored by:   The FreeBSD Foundation
    MFC after:      1 week
    Differential revision:  https://reviews.freebsd.org/D54951
---
 share/man/man7/tuning.7 | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/share/man/man7/tuning.7 b/share/man/man7/tuning.7
index c03cce0aba0f..586b63c247a8 100644
--- a/share/man/man7/tuning.7
+++ b/share/man/man7/tuning.7
@@ -601,6 +601,32 @@ See the
 section in the
 .Xr sendfile 2
 manual page for details.
+.Sh SCHEDULERS
+.Fx
+allows having more than one scheduler specified in the kernel config,
+and the desired scheduler selected from them at boot time.
+Right now the options are:
+.Bl -tag -width SCHED_4BSD
+.It Cd SCHED_ULE
+The modern scheduler with O(1) thread selection behavior.
+.It Cd SCHED_4BSD
+Classic scheduler inherited from 4.x BSD.
+.El
+.Pp
+At least one option must be specified.
+.Cd SCHED_ULE
+is used by default if compiled in.
+.Pp
+The
+.Va kern.sched.available
+sysctl provides the comma-separated list of available (compiled in)
+schedulers.
+The
+.Va kern.sched.name
+loader tunable can be set to select the desired scheduler at boot time.
+The
+.Va kern.sched.name
+sysctl reports which scheduler is used.
 .Sh KERNEL CONFIG TUNING
 There are a number of kernel options that you may have to fiddle with in
 a large-scale system.