docs: cgroup: mm: Document why inactive_X + active_X may not equal X
Subsystems (3)
PATCH 1/1 docs: cgroup: mm: Document why inactive_X + active_X may not equal X
This has confused a significant number of people using cgroups inside Facebook, and some of those outside as well judging by posts like this[0] (although it's not a problem unique to cgroup v2). If shmem handling in particular becomes more coherent at some point in the future -- although that seems unlikely now -- we can change the wording here.
[0]: https://unix.stackexchange.com/q/525092/10762
--- Documentation/admin-guide/cgroup-v2.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-)
Documentation/admin-guide/cgroup-v2.rst +6 -1
@@ -1289,7 +1289,12 @@ PAGE_SIZE multiple when read back. inactive_anon, active_anon, inactive_file, active_file, unevictable Amount of memory, swap-backed and filesystem-backed, on the internal memory management lists used by the - page reclaim algorithm + page reclaim algorithm. + + As these represent internal list state (eg. shmem pages are on anon + memory management lists), inactive_foo + active_foo may not be equal to + the value for the foo counter, since the foo counter is type-based, not + list-based. slab_reclaimable Part of "slab" that might be reclaimed, such as
Signature · 1 line
2.24.0
Quoted 8 lines · Chris Down
This has confused a significant number of people using cgroups inside Facebook, and some of those outside as well judging by posts like this[0] (although it's not a problem unique to cgroup v2). If shmem handling in particular becomes more coherent at some point in the future -- although that seems unlikely now -- we can change the wording here.
Quoted 10 lines
Signed-off-by Chris Down <[email protected]>Cc Andrew Morton <[email protected]>Cc Johannes Weiner <[email protected]>Cc Tejun Heo <[email protected]>Cc Roman Gushchin <[email protected]>Cc Michal Hocko <[email protected]>
Quoted 9 lines
--- Documentation/admin-guide/cgroup-v2.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-)Documentation/admin-guide/cgroup-v2.rst +0
-0
Documentation/admin-guide/cgroup-v2.rst PAGE_SIZE multiple when read back. · line 1295
Quoted 8 lines
Documentation/admin-guide/cgroup-v2.rst +4
-1@@ -1289,7 +1289,12 @@ PAGE_SIZE multiple when read back. inactive_anon, active_anon, inactive_file, active_file, unevictable Amount of memory, swap-backed and filesystem-backed, on the internal memory management lists used by the - page reclaim algorithm + page reclaim algorithm. + + As these represent internal list state (eg. shmem pages are on anon + memory management lists), inactive_foo + active_foo may not be equal to
and anon will move to file list after MADV_FREE.
Quoted 7 lines
Documentation/admin-guide/cgroup-v2.rst +2
-0+ the value for the foo counter, since the foo counter is type-based, not + list-based. slab_reclaimable Part of "slab" that might be reclaimed, such asSignature · 1 line
2.24.0
Signature · 2 lines
Michal Hocko SUSE Labs