]> git.ipfire.org Git - thirdparty/kernel/linux.git/commit
Docs/admin-guide/cgroup-v2: note blkcg_debug_stats gates io.latency stats
authorGuopeng Zhang <zhangguopeng@kylinos.cn>
Tue, 7 Jul 2026 10:21:48 +0000 (18:21 +0800)
committerTejun Heo <tj@kernel.org>
Tue, 7 Jul 2026 22:26:23 +0000 (12:26 -1000)
commit97fef602584458b100d383afed9d176c0bc689ab
tree58c57f71ca1b646dffc402813e718d75c83c9009
parent451a7467570d9578b5f7fba9aa6e0ed1ac1fcfec
Docs/admin-guide/cgroup-v2: note blkcg_debug_stats gates io.latency stats

The io.stat section says that enabling the io.latency controller exposes
the depth, avg_lat and win stats in addition to the normal ones. However,
these io.latency-specific stats are debug stats and are only emitted when
the blkcg_debug_stats module parameter is enabled, which is disabled by
default.

Make this explicit so users do not expect these fields to appear in
io.stat by default, and qualify the usage text that suggests using
avg_lat to pick an io.latency target.

Signed-off-by: Guopeng Zhang <zhangguopeng@kylinos.cn>
Signed-off-by: Tejun Heo <tj@kernel.org>
Documentation/admin-guide/cgroup-v2.rst