From patchwork Thu Jan 5 13:16:31 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13089863 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 AD33FC53210 for ; Thu, 5 Jan 2023 13:17:15 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 53B7F900005; Thu, 5 Jan 2023 08:17:11 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 49D2B900003; Thu, 5 Jan 2023 08:17:11 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 314CE900005; Thu, 5 Jan 2023 08:17:11 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id 24158900003 for ; Thu, 5 Jan 2023 08:17:11 -0500 (EST) Received: from smtpin06.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id DDACFAB3E4 for ; Thu, 5 Jan 2023 13:17:10 +0000 (UTC) X-FDA: 80320796220.06.940D159 Received: from mail-pl1-f179.google.com (mail-pl1-f179.google.com [209.85.214.179]) by imf17.hostedemail.com (Postfix) with ESMTP id 0D6114001B for ; Thu, 5 Jan 2023 13:17:08 +0000 (UTC) Authentication-Results: imf17.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=I+haejsb; spf=pass (imf17.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.214.179 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1672924629; 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=xwHqK93GBSz13u5EOGerS6VNG9qcHKdmktoqbjmWNKQ=; b=XLir7458Q2xGik8Py/+kHp6puqJcQVngH0pKcAvv82fCATYTWYjEBuOLmbdDzXQXrz5G5m N4+0/RwqAg8UeD9P4Cw1t6v4fneYCLbK9V/p0Ecb7c4M/fJ01KJzO2lYX8rPWN6smZp4ct BzXBQQNz6Ysur98EVqXMBmeApBxs9p0= ARC-Authentication-Results: i=1; imf17.hostedemail.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=I+haejsb; spf=pass (imf17.hostedemail.com: domain of bagasdotme@gmail.com designates 209.85.214.179 as permitted sender) smtp.mailfrom=bagasdotme@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1672924629; a=rsa-sha256; cv=none; b=0kmEI0OeI4e9UhxPIa8PyCDfvesd14SjhsHduNVxzJH+mu6eIhIT+kVbdYqX3Yvaqgd8Ha ri6N00VZOoljlk2PFw02HlKt0HTG5cGaWgGIllD1mK/ecjgeZ8A5a5XlK2tnMAAas2aol8 QLxPkW8SoOjNhcSeTo5NadT/5mx10FY= Received: by mail-pl1-f179.google.com with SMTP id y1so3797825plb.2 for ; Thu, 05 Jan 2023 05:17:08 -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=xwHqK93GBSz13u5EOGerS6VNG9qcHKdmktoqbjmWNKQ=; b=I+haejsbxcT8QansUCm5NiZgqf2JOyk2XoX+L9ANWJ+oZ3TVmy88uTaaDIAnH60Se4 QC+8pZ1DVABAn9fbxX+01giMJL8QxVbK5JPMK71xZAR5l7hIoZ2HXOLK7XsTFATW8Ixz q5RKiApAiRwuaEXAif1bny8NJyICU1d5b6cBVkt8ozpHIt9kHXCkiP5RwaeGheITxLGD pv66I/8vKCfVNCU4pCKkHXOn0aYd0sZ7fEE9fRKjDaTaPdM6tDTlOWpzJaqe86/t7zq+ J5IuSSFoT4VVRLtFO79+qqLr4ipbuvJqdL0XtgxljHoOaC9wrD8egICm691ltJy92+D9 o4lg== 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=xwHqK93GBSz13u5EOGerS6VNG9qcHKdmktoqbjmWNKQ=; b=JOvR1yi/h+NOs8/63W6uDH0N9vJRAZR6gCTHOKXTQvLont8J+ZM3DCXKbMfy7ZjupX RlX4b6gw+N/0cuMOL5wlj9r8fEWXM+7zfBlGWFUq/cNqPPX4tF+Cs+9TsJk0y/r/UlJ/ VsetDsNvki8mpF9at/E+tPZZvgN6itTobjgcrTc0K9ixC5emylLvpVFXLe6oqXpnry2E Wmve9r9umoHZWir9A8d7KeR3ywPTEDQpyMNLzElDOiYrn+6Bj8S83xtJ5m9Hk3d4TxRX aNEoSiBqu6iNuzyke7OXcrkhDrnqn0CNLSodBMaBBDWYdPuCEb6zk+fsIb41Hcd15S3B wfCA== X-Gm-Message-State: AFqh2kpG6qYDpWIxD2M9x5LxRiepwTQRECEEPcJEawM6FPsnZ4munV+W Ms62Lt/cJSAK7CwGJaDkpGXivtFyGok= X-Google-Smtp-Source: AMrXdXvVQHFIAhZFjXWcvmWsd4zYjHp8TCtZNuDhrgXiXGz/KDF8sgcU0cuj/xK31xQp+cbn98HKDw== X-Received: by 2002:a17:90b:4a8c:b0:225:a8f2:fa38 with SMTP id lp12-20020a17090b4a8c00b00225a8f2fa38mr51004080pjb.21.1672924627951; Thu, 05 Jan 2023 05:17:07 -0800 (PST) Received: from debian.me (subs02-180-214-232-68.three.co.id. [180.214.232.68]) by smtp.gmail.com with ESMTPSA id h6-20020a63c006000000b00478b930f970sm21709710pgg.66.2023.01.05.05.17.07 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 05 Jan 2023 05:17:07 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id 2BC92104C58; Thu, 5 Jan 2023 20:17:00 +0700 (WIB) From: Bagas Sanjaya To: Linux CGroups , Linux Documentation , LKML , 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 v2 6/9] docs: cgroup-v1: use bullet lists for list of stat file tables Date: Thu, 5 Jan 2023 20:16:31 +0700 Message-Id: <20230105131633.553574-7-bagasdotme@gmail.com> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20230105131633.553574-1-bagasdotme@gmail.com> References: <20230105131633.553574-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=SoIEcDdcT5n5ldqzkBmfedkjJd/EdMw6QuqYA3S+KDs=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDMnbzm6ofK+yRrC/JWDHq/r1ulxRxxxnKLB3/v5w8IjPvxk1 Z7pEOkpZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjAR325GhpZFRVP+NhbwxQf07X/ULH dQqH2NpZHRx3nVQsUaj+IvuTD8z7n7YJ5tTpdh076r6d6G/05xbVAXtfb+sau3RtPG+o4bBwA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-Rspamd-Server: rspam05 X-Rspamd-Queue-Id: 0D6114001B X-Stat-Signature: io53frg6esxb4wf6g5xapkac5nd6crnt X-Rspam-User: X-HE-Tag: 1672924628-542779 X-HE-Meta: U2FsdGVkX18NDfq2BH83ixQ3xI5WTCbBL5xEmlmW5jfwoZFmZzHvwz2C+KU6GZGoHD4MCEyo/FLFGjiCrYpb3qMdqSmNa4iaCPL89aiIFZpp8p1yxVAI6gr6jdAbrnHVIkD1YpPry+UfWTBofJf6SvFN0SC2Kbxtjedn5d4ytfgrcE7VjQc9agzkW34l+9G0HmM6U1VKJoDh/eNGqCTzVykEef6LtOiv4xhzNVJ+KeCN2iA7kJLR8FAbo0No5qmu8ioXdkSM5sF9wx3RRHoxrN5yCab5CoNfdp8ODFDFMCRuQxqdr5dlDO5BRRktoV/w2kcdUZa+IACPGudtkzlaLUSbLMbL+43hQdf074yBQJaQ1vgxywoUK7P1CHLlkCcO/yXPebNgqxn7uUFPr0oldewQBxmE6MAP/eH+FPZY581kRlPkP0zyq6HWAn+nPO4cQlpohImfeNMeEQnyveKiqbB8u+bGtzRXb4JITyNe16QgAqx6hof5eluYO7BiW6WnojNgq2ofKRL5+1LZEqykcpubmrXpjN5oXoKvmzND4/HsfGqr4ygtmkz0FMHdyoldzUikw/3ZfqZKH4yu7+0+GecSfaIv3yUx+SIjW9KnyFWHYGAFAgMjP27uWZ0IYAd6cgvYNN5rx44gMhs5gd09AW32lvzWs9A3hHs+cE4bLKPMibLDqXzQ4wmsNvUpqTqpBfK5sH1cDnV0BIu/ell+9l25bop1BTQz1gSgmdin3pGREsqBIcE02bL6fQvt2MPpKxxOvHBkwJmSLWHLY4IMcYW33GpV6KJaHXQd5PgiyRFOlHZd9MVcap+IPMf/wnY7SQ+pQhbumRxiynppa2eBXoV2JRYCMg+VB2LnL3q7GTpMLNSYpSQ7RTNeHFPDbNuxEkgMMAat6rgPGLjxdPjTGfa9AbVoedks+CDbsuFGUDg68KrhIhiOl7QaGB0ag1y8kU/NWMgmmUjVcFczCCe Dx6xWTZG FxxBnEEVhdp0Ob24gTjg6I7+swz7TMIjnjuo5PmBosvOMjnVQ4nZ+aa/8P7q2FGEElpW+vp0cgiWVm4RnkFGlGrFPFduLE/Sel+cdQZAzP+3zVw/MnGjiYMPFicfq4+VlzU7q 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 4d96a5bbbfcfdc..162cc26dcddb25 100644 --- a/Documentation/admin-guide/cgroup-v1/memory.rst +++ b/Documentation/admin-guide/cgroup-v1/memory.rst @@ -519,60 +519,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.