From nobody Sun Feb 8 15:29:14 2026 Received: from out-178.mta0.migadu.com (out-178.mta0.migadu.com [91.218.175.178]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A70EB481FAC for ; Wed, 21 Jan 2026 12:40:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.178 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768999238; cv=none; b=fYJ0Zk6cNcuc5eEdH3SFpjjzaXI/LXio6SaTAsFsYFeQFllwD3c+G1RfJJ5UWWa4txd4szP+fUTZjcHsiRvqYYl1KTw4P7nnswOQK1aHH1G4ehq7znDNW62sDHNNhujYLVFgXBS39nwYWPgq6ovqEY3YbrJ9O3aNC4MnrIiDQSU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1768999238; c=relaxed/simple; bh=KX0jdUNzXru7m+7hjkqbLQeZGOGKF1Jq6B5UtBA/uVA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=PkH03FoIkUe7QR6PoWPkaljJutBKWIzD9dZjUSCgYfFN74Iy7/IeQ7jBGrscdtWd39zUvj4Qmum4n7l6nHvuwa/lslgSOB4JZMPoScI2B1JO8PFbCBAzsEosE2IHhpMF9u4MB5K7cyWrBPLMYhRlgGVLHdHmT7cNlH/WIppjf04= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.dev; spf=pass smtp.mailfrom=linux.dev; dkim=pass (1024-bit key) header.d=linux.dev header.i=@linux.dev header.b=vYegVE80; arc=none smtp.client-ip=91.218.175.178 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.dev Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.dev Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linux.dev header.i=@linux.dev header.b="vYegVE80" X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.dev; s=key1; t=1768999233; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=P/QIycmg/Rp660OZ1P92MK5kFHPJosNCmQKo3uxOY+w=; b=vYegVE80q2P99aKNiXmOPWPUQvsIvoabN/PTHj4Kum0jSGe4HmwxKwWaVgP+XTxQLU9Vc+ xDL3GVtpm/ae90vlif6u21ElxIQ6gqwqm9oy1I8eyEFB4UGCb5zfTqhGJgQigxRYLi34D1 Ueac4zqmHjZtQ1v/IRwv8W4qr+aZYv4= From: Jiayuan Chen To: linux-mm@kvack.org Cc: Jiayuan Chen , Tejun Heo , Johannes Weiner , =?UTF-8?q?Michal=20Koutn=C3=BD?= , Jonathan Corbet , Andrew Morton , Axel Rasmussen , Yuanchu Xie , Wei Xu , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Roman Gushchin , Shakeel Butt , Muchun Song , Qi Zheng , cgroups@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [RFC PATCH 3/3] docs/cgroup: document memory.lru_gen interface Date: Wed, 21 Jan 2026 20:39:49 +0800 Message-ID: <20260121123955.84806-4-jiayuan.chen@linux.dev> In-Reply-To: <20260121123955.84806-1-jiayuan.chen@linux.dev> References: <20260121123955.84806-1-jiayuan.chen@linux.dev> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Migadu-Flow: FLOW_OUT Content-Type: text/plain; charset="utf-8" From: Jiayuan Chen Add documentation for the memory.lru_gen interface in cgroup v2. For detailed information about MGLRU and the command format, refer to the multi-gen LRU documentation. Signed-off-by: Jiayuan Chen --- Documentation/admin-guide/cgroup-v2.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/Documentation/admin-guide/cgroup-v2.rst b/Documentation/admin-= guide/cgroup-v2.rst index 7f5b59d95fce..bb3ca7ffd600 100644 --- a/Documentation/admin-guide/cgroup-v2.rst +++ b/Documentation/admin-guide/cgroup-v2.rst @@ -1426,6 +1426,23 @@ PAGE_SIZE multiple when read back. This means that the networking layer will not adapt based on reclaim induced by memory.reclaim. =20 + memory.lru_gen + A read-write file that exists when CONFIG_LRU_GEN is enabled. + + Reading this file displays the multi-gen LRU information for + this memcg, including generation numbers, page counts for + anonymous and file pages across all NUMA nodes. + + Writing to this file allows performing aging or eviction + operations on this memcg. The format is:: + + echo ' [ []]' > memory.lru_gen + + This interface provides the same functionality as the debugfs + lru_gen interface but operates directly on the cgroup without + requiring the memcg_id. For detailed documentation of the + command format and MGLRU, see Documentation/admin-guide/mm/multigen_lru.r= st. + The following nested keys are defined. =20 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.43.0