From patchwork Mon Dec 19 04:22:06 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13076240 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 9461CC3DA78 for ; Mon, 19 Dec 2022 04:22:34 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 60515900002; Sun, 18 Dec 2022 23:22:28 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 5B5438E0005; Sun, 18 Dec 2022 23:22:28 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 34CA9900002; Sun, 18 Dec 2022 23:22:28 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id 032CC8E000C for ; Sun, 18 Dec 2022 23:22:28 -0500 (EST) Received: from smtpin02.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id CDEAC1C3D46 for ; Mon, 19 Dec 2022 04:22:27 +0000 (UTC) X-FDA: 80257759134.02.AA0F827 Received: from mail-pj1-f46.google.com (mail-pj1-f46.google.com [209.85.216.46]) by imf23.hostedemail.com (Postfix) with ESMTP id 15FD014000E for ; Mon, 19 Dec 2022 04:22:25 +0000 (UTC) Authentication-Results: imf23.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=aJ8LYUEr; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf23.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.46 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1671423746; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=lRDhbAuFFMtCfx+H7ZJIpQoYnynck5HVInZvHowpBNk=; b=qKuMiaAJ3LKkFwBI3ME9OkHoPLOx7yJfMnlRxWj10h0NLNisvdEJWghwBe+WKw2eZbKNOe BdZ9hAg6pgQtamcZlYIaHq469g5ho3e+/PwhraGN65LzlpfKni5pI11V3wNcomcPm8rDFM mdbbyBzv1HTLwKElKtMtdLNB6PLLz+M= ARC-Authentication-Results: i=1; imf23.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=aJ8LYUEr; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf23.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.216.46 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1671423746; a=rsa-sha256; cv=none; b=eujW701+S81lH6bvL2wTn0UvjITqLMtyIG3Fux8L9nhil8v6vnWc3QYcFLP5DB/uR0Ciud o1/NCaZ/eKQZc3/GeqMCMeAb6TodPyMUtjW27eeUqAMsHVaNmw7PnfbCj9KiRXa2l1CpD1 8fL3EtRn2mL0LfV2KezP4MvVS13kzTg= Received: by mail-pj1-f46.google.com with SMTP id fy4so7886759pjb.0 for ; Sun, 18 Dec 2022 20:22:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=lRDhbAuFFMtCfx+H7ZJIpQoYnynck5HVInZvHowpBNk=; b=aJ8LYUErJn/ZPG6EC26fQcgCJgiRXAOf+Wbw+PidOOWMUaiVUsUcSgo8htcy1YlFQ7 5bm1d9ZM3R2uYEKryoIQ4t6aV5PBbAJSRU1yzOikLW9IDPs009uccbn2P3EEMCtnWvJR +CyqWbBcyowHmuqUUkGyOLvHs1ktvjGk7UMvLkomuT7rgqpvddtVJC/vMnYvTDSX4Uz9 unhqp0K6PAkA6+9AIErzHE/RGpYjG/w/jfoTnxq83m5DMytP1sh8csjErB9nFyUidNm+ woDrW5wk2XJcVeUrU1oFu23rb7xClFXHHQdRWDYcarrITAEVGSjXIOwCNx5JycJ7tL5+ /HOA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=lRDhbAuFFMtCfx+H7ZJIpQoYnynck5HVInZvHowpBNk=; b=MZInboMw81K+qfF7Hn1d/XVVzCq9xgn0N7IRSiMijegGrT8Nw5I65TW4AdzQ0PGjb7 NTeG9MtFDnBsdfJ/sW4KTAOOA6Ekiw84irF7eEppBsoH+22Mn68suxiMNZ6KeSU8b3O/ 4N1jIZgcncnktLaITS1jUYzYJgiYbDWsvCopqNu5A3bhVWKjysl65gDdgSmdV6tJNKKV 22PZoP+nf4gteT6najZ+xEukmEToHWKD6ImRIFTnxMLhv8ePOvIWl3pU1CeX9bE3nKIE XUC3Hr1vhx0a44O7dFDe+miKJ2Dcgl8+Uu6srmX2cWAWPUCwqs914yJNIjCUqYqHVeWO lOeA== X-Gm-Message-State: ANoB5pkRfnR88HoWttgEPyAZSr20NQdWG5ytiU3qqRo76d17XofPw8Qs wYjX7vPEKEjm0f2UW2zzPHo= X-Google-Smtp-Source: AA0mqf50Q60/cHOKADaVTGJceXn1H4SLjSKCSi1WgOTYDrJ97ZGoPbiT1Y4BH9GfoxR8lLFlpaar3Q== X-Received: by 2002:a17:90a:1b0b:b0:219:396c:9e32 with SMTP id q11-20020a17090a1b0b00b00219396c9e32mr43342946pjq.16.1671423745034; Sun, 18 Dec 2022 20:22:25 -0800 (PST) Received: from debian.me (subs32-116-206-28-20.three.co.id. [116.206.28.20]) by smtp.gmail.com with ESMTPSA id nn11-20020a17090b38cb00b00212cf2fe8c3sm16638727pjb.1.2022.12.18.20.22.23 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 18 Dec 2022 20:22:23 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 1437210164A; Mon, 19 Dec 2022 11:22:14 +0700 (WIB) From: Bagas Sanjaya To: cgroups@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Linux Memory Management List Cc: Tejun Heo , Zefan Li , Johannes Weiner , Jonathan Corbet , Michal Hocko , Andrew Morton , Hugh Dickins , Shakeel Butt , Bagas Sanjaya Subject: [PATCH 07/10] docs: cgroup-v1: use bullet lists for list of stat file tables Date: Mon, 19 Dec 2022 11:22:06 +0700 Message-Id: <20221219042209.22898-8-bagasdotme@gmail.com> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20221219042209.22898-1-bagasdotme@gmail.com> References: <20221219042209.22898-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=6795; i=bagasdotme@gmail.com; h=from:subject; bh=Qv/IUrGqp6BPq2cwpkOiVBXASeOlAsriWizhHWQnHq4=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDMnzn703LdK1T/66R/jyZrvEyVzW0yr0r//Oum3vofGLRydv z+/ijlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAExk+lVGhjki233c9qqJ3Zpyt+jn+o gkR7uyW9yffms/71tXPOvhEVZGhmurJaxWvK0rVNIV2j5n64a4vZzP7l50Cfn0u+h7TswiJh4A X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-Rspamd-Queue-Id: 15FD014000E X-Rspamd-Server: rspam09 X-Rspam-User: X-Stat-Signature: wqmu7ejf1bkfdxee48sdtcks439j1h3p X-HE-Tag: 1671423745-690416 X-HE-Meta: U2FsdGVkX19Gnott4nOTAogE4B+Zc8+QeVWvVA6lpqRDKX9LUz6KUvxTz2aitipgvUSS4RfKrjRyLrjh5ccVByghEGdXZFIzh0f1m9nWZ75HLBJUi2/kgVVkj8e+VuYVv2owNUi+i2pedJE7DDmYBPp61i0FbK1jzev6J7dNc23e3hUxlvHePUqZk79RIRoJIPOMhExdieLUYmXFOeNMAL0SJSmWf9kEAnjqglsp3tMnbQCikhKgYlHEe/gBKCT5zAEBxyPj37pZ+n0Ua73de0Le3+ludpwm0SyxeW2kCuOH68htLkr21xavu8YjZ+vinG/UXrDAyEpavcwRwuDp+RW0mqZaAQWnnJq4/1lDs0SrUiXFYvKzTYC9gWrBPfSRliZ8+FfYy+zMw/fcadUsv0Dtez+U9jUgnon0+hiZPggZIE4iITIGuCHAYfs58I7m1vMTJ5QrqU+bvqkI2bgWyrV5IzCGZARj71clZHRUprcsAmgn1uivBTXwNtiuFYuR0G/KBy6FIvCBiCEbdpluY4JfS0dQngKZsxwHWKZyM+wbYDA4VQjW+dy6IrcxbQs9mDhmtkdx6VyRMWHyfx4nj5EcMAEdms2NYTHz3oucOOkqdfslNntExBQNnsfTO2o6AEZWV1lDV/1ACMvzjOJQKTNbNjrU5sKDdTrbaoW4euzu7Mar+KawMIRnz6b5mviw7c77Ntzda8alQTzyXB072tqDLJNsv1gfTRapAFhBFaDg5cLAM8bcxYIME4qK42XlZAHlq2W6+AsBWFr+rogTdOBQkSOTIhsE1hZD2Tov5lJ530YSeGmx01DZdNU/ScJ8xPN0gGX4y/YjC1cjMdBI49jOd6m/TmuNoEWm/4R4zfPecLVquWt1q01w4+0jXwYH5DmwudqXBZYogrEurXbHtfFBf4C/ciDASdiFknkveweKWDdsNLoH98lctczxyaIM/AgHCm9AW4bltQMZ26g UKKPa9cl pHf90li3vOHvf2l9/GGwZhjjYOQs73tYfRpbD7e+Mk8etO0xODY37BhFnEwQJsHm4tBgYoMkcH76k0iUmkLP1ppIOoLe2rkdkhCOEyP3b7Q/0v6eOXyj7RoXrvK9OJhlqeEs6 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: 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 --- .../admin-guide/cgroup-v1/memory.rst | 93 +++++++++---------- 1 file changed, 46 insertions(+), 47 deletions(-) diff --git a/Documentation/admin-guide/cgroup-v1/memory.rst b/Documentation/admin-guide/cgroup-v1/memory.rst index 3b365a72996be5..01104b459b4cbd 100644 --- a/Documentation/admin-guide/cgroup-v1/memory.rst +++ b/Documentation/admin-guide/cgroup-v1/memory.rst @@ -521,60 +521,59 @@ will be charged as a new owner of it. 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. -rss # of bytes of anonymous and swap cache memory (includes - transparent hugepages). -rss_huge # of bytes of anonymous transparent hugepages. -mapped_file # of bytes of mapped file (includes tmpfs/shmem) -pgpgin # of charging events to the memory cgroup. The charging - event happens each time a page is accounted as either mapped - anon page(RSS) or cache page(Page Cache) to the cgroup. -pgpgout # of uncharging events to the memory cgroup. The uncharging - event happens each time a page is unaccounted from the cgroup. -swap # of bytes of swap usage -dirty # of bytes that are waiting to get written back to the disk. -writeback # of bytes of file/anon cache that are queued for syncing to - disk. -inactive_anon # of bytes of anonymous and swap cache memory on inactive - LRU list. -active_anon # of bytes of anonymous and swap cache memory on active - LRU list. -inactive_file # of bytes of file-backed memory and MADV_FREE anonymous memory( - LazyFree pages) on inactive LRU list. -active_file # of bytes of file-backed memory on active LRU list. -unevictable # of bytes of memory that cannot be reclaimed (mlocked etc). -=============== =============================================================== + =============== =============================================================== + cache # of bytes of page cache memory. + rss # of bytes of anonymous and swap cache memory (includes + transparent hugepages). + rss_huge # of bytes of anonymous transparent hugepages. + mapped_file # of bytes of mapped file (includes tmpfs/shmem) + pgpgin # of charging events to the memory cgroup. The charging + event happens each time a page is accounted as either mapped + anon page(RSS) or cache page(Page Cache) to the cgroup. + pgpgout # of uncharging events to the memory cgroup. The uncharging + event happens each time a page is unaccounted from the + cgroup. + swap # of bytes of swap usage + dirty # of bytes that are waiting to get written back to the disk. + writeback # of bytes of file/anon cache that are queued for syncing to + disk. + inactive_anon # of bytes of anonymous and swap cache memory on inactive + LRU list. + active_anon # of bytes of anonymous and swap cache memory on active + LRU list. + inactive_file # of bytes of file-backed memory and MADV_FREE anonymous + memory (LazyFree pages) on inactive LRU list. + 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 - under which the memory cgroup is -hierarchical_memsw_limit # of bytes of memory+swap limit with regard to - hierarchy under which memory cgroup is. + ========================= =================================================== + hierarchical_memory_limit # of bytes of memory limit with regard to + hierarchy + under which the memory cgroup is + hierarchical_memsw_limit # of bytes of memory+swap limit with regard to + hierarchy under which memory cgroup is. -total_ # hierarchical version of , which in - addition to the cgroup's own value includes the - sum of all hierarchical children's values of - , i.e. total_cache -========================= =================================================== + total_ # hierarchical version of , which in + addition to the cgroup's own value includes the + sum of all hierarchical children's values of + , 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_file 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_rotated_anon 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_file VM internal parameter. (see mm/vmscan.c) + ========================= ======================================== .. hint:: recent_rotated means recent frequency of LRU rotation.