docs: cgroup-v1: use bullet lists for list of stat file tables

The stat file section contains three tables, where the leading texts for
them are subsection heading. Organize them in the bullet list, while
demoting headings into normal text.

Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Signed-off-by: Tejun Heo <tj@kernel.org>
This commit is contained in:
Bagas Sanjaya 2023-01-05 20:16:31 +07:00 committed by Tejun Heo
parent f7423bb771
commit b9d2a17b32

View file

@ -519,60 +519,59 @@ will be charged as a new owner of it.
5.2 stat file 5.2 stat file
------------- -------------
memory.stat file includes following statistics memory.stat file includes following statistics:
per-memory cgroup local status * per-memory cgroup local status
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
=============== =============================================================== =============== ===============================================================
cache # of bytes of page cache memory. cache # of bytes of page cache memory.
rss # of bytes of anonymous and swap cache memory (includes rss # of bytes of anonymous and swap cache memory (includes
transparent hugepages). transparent hugepages).
rss_huge # of bytes of anonymous transparent hugepages. rss_huge # of bytes of anonymous transparent hugepages.
mapped_file # of bytes of mapped file (includes tmpfs/shmem) mapped_file # of bytes of mapped file (includes tmpfs/shmem)
pgpgin # of charging events to the memory cgroup. The charging pgpgin # of charging events to the memory cgroup. The charging
event happens each time a page is accounted as either mapped event happens each time a page is accounted as either mapped
anon page(RSS) or cache page(Page Cache) to the cgroup. anon page(RSS) or cache page(Page Cache) to the cgroup.
pgpgout # of uncharging events to the memory cgroup. The uncharging pgpgout # of uncharging events to the memory cgroup. The uncharging
event happens each time a page is unaccounted from the cgroup. event happens each time a page is unaccounted from the
swap # of bytes of swap usage cgroup.
dirty # of bytes that are waiting to get written back to the disk. swap # of bytes of swap usage
writeback # of bytes of file/anon cache that are queued for syncing to dirty # of bytes that are waiting to get written back to the disk.
disk. writeback # of bytes of file/anon cache that are queued for syncing to
inactive_anon # of bytes of anonymous and swap cache memory on inactive disk.
LRU list. inactive_anon # of bytes of anonymous and swap cache memory on inactive
active_anon # of bytes of anonymous and swap cache memory on active LRU list.
LRU list. active_anon # of bytes of anonymous and swap cache memory on active
inactive_file # of bytes of file-backed memory and MADV_FREE anonymous memory( LRU list.
LazyFree pages) on inactive LRU list. inactive_file # of bytes of file-backed memory and MADV_FREE anonymous
active_file # of bytes of file-backed memory on active LRU list. memory (LazyFree pages) on inactive LRU list.
unevictable # of bytes of memory that cannot be reclaimed (mlocked etc). active_file # of bytes of file-backed memory on active LRU list.
=============== =============================================================== unevictable # of bytes of memory that cannot be reclaimed (mlocked etc).
=============== ===============================================================
status considering hierarchy (see memory.use_hierarchy settings) * status considering hierarchy (see memory.use_hierarchy settings):
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
========================= =================================================== ========================= ===================================================
hierarchical_memory_limit # of bytes of memory limit with regard to hierarchy hierarchical_memory_limit # of bytes of memory limit with regard to
under which the memory cgroup is hierarchy
hierarchical_memsw_limit # of bytes of memory+swap limit with regard to under which the memory cgroup is
hierarchy under which memory cgroup is. hierarchical_memsw_limit # of bytes of memory+swap limit with regard to
hierarchy under which memory cgroup is.
total_<counter> # hierarchical version of <counter>, which in total_<counter> # hierarchical version of <counter>, which in
addition to the cgroup's own value includes the addition to the cgroup's own value includes the
sum of all hierarchical children's values of sum of all hierarchical children's values of
<counter>, i.e. total_cache <counter>, i.e. total_cache
========================= =================================================== ========================= ===================================================
The following additional stats are dependent on CONFIG_DEBUG_VM * additional vm parameters (depends on CONFIG_DEBUG_VM):
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
========================= ======================================== ========================= ========================================
recent_rotated_anon VM internal parameter. (see mm/vmscan.c) recent_rotated_anon VM internal parameter. (see mm/vmscan.c)
recent_rotated_file VM internal parameter. (see mm/vmscan.c) recent_rotated_file VM internal parameter. (see mm/vmscan.c)
recent_scanned_anon VM internal parameter. (see mm/vmscan.c) recent_scanned_anon VM internal parameter. (see mm/vmscan.c)
recent_scanned_file VM internal parameter. (see mm/vmscan.c) recent_scanned_file VM internal parameter. (see mm/vmscan.c)
========================= ======================================== ========================= ========================================
.. hint:: .. hint::
recent_rotated means recent frequency of LRU rotation. recent_rotated means recent frequency of LRU rotation.