From nobody Sat Jun 13 14:00:58 2026 Received: from mail-m15586.qiye.163.com (mail-m15586.qiye.163.com [101.71.155.86]) (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 DB52922D4D3 for ; Thu, 7 May 2026 07:02:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=101.71.155.86 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778137353; cv=none; b=AMznaUvlBnJ3kpg+z6SwwGl/xqKSnSkPSc2ZTIui2DscIs7oJxKmY+AjVkKdqUSYz8apt7w72KMgW61n0NyYf3W2wPud5FAj85wIG3SkguwEWErV8ABnCsAXPkClbwtzas0+tbcFULYHFvJ5/YW2NiY4X4V/QbB2k8aNMDjXn8w= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778137353; c=relaxed/simple; bh=K3RsICl+lZkZhrNELz5/yvfzEHInIoP2a6UyPOzJXxg=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=dANSytc4bFCaJRBu7yf1UgbiIKCnvnqBEgZERjSuEz72SQML3DxrNhh/kjG+AFzRdPZ9NTi5GY+0t+Dh0gB/QlDXdEvGxVsR2ClWfrMigNgY6qUnO0i8/Op5E6q4xwFipUR2Fv2nrqt+WEP3BX40g0pikJiDtkPnGmKxlIWpY9w= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=easystack.cn; spf=pass smtp.mailfrom=easystack.cn; arc=none smtp.client-ip=101.71.155.86 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=easystack.cn Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=easystack.cn Received: from localhost.localdomain (unknown [218.94.118.90]) by smtp.qiye.163.com (Hmail) with ESMTP id 19cdddfbc; Thu, 7 May 2026 14:47:09 +0800 (GMT+08:00) From: Zhen Ni To: akpm@linux-foundation.org, vbabka@kernel.org Cc: surenb@google.com, mhocko@suse.com, jackmanb@google.com, hannes@cmpxchg.org, ziy@nvidia.com, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Zhen Ni Subject: [PATCH v5 1/3] mm/page_owner: add print_mode filter Date: Thu, 7 May 2026 14:46:41 +0800 Message-Id: <20260507064643.179187-2-zhen.ni@easystack.cn> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20260507064643.179187-1-zhen.ni@easystack.cn> References: <20260507064643.179187-1-zhen.ni@easystack.cn> 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-HM-Tid: 0a9e0130b1c80229kunm3f68df491bc94f X-HM-MType: 1 X-HM-Spam-Status: e1kfGhgUHx5ZQUpXWQgPGg8OCBgUHx5ZQUlOS1dZFg8aDwILHllBWSg2Ly tZV1koWUFJQjdXWRgWCB1ZQUpXWS1ZQUlXWQ8JGhUIEh9ZQVlCTx8fVkpJGBkYSR5DHhpLT1YVFA kWGhdVGRETFhoSFyQUDg9ZV1kYEgtZQVlJSkNVQk9VSkpDVUJLWVdZFhoPEhUdFFlBWU9LSFVKS0 lPT09IVUpLS1VKQktLWQY+ Content-Type: text/plain; charset="utf-8" Add a print_mode filter to page_owner that allows users to choose between printing full stack traces or only stack handles, significantly reducing output size for debugging and analysis. The filter provides a string-based interface under /sys/kernel/debug/page_owner_filter/: - Reading shows the current mode with [] brackets around active option - Writing accepts "full_stack" or "stack_handle" strings The default full_stack mode maintains backward compatibility with existing usage, displaying complete stack traces for each page allocation. The stack_handle mode dramatically reduces log size by showing only the handle number instead of the full stack trace. The mapping from handles to actual stack traces can be obtained via the show_stacks_handles interface. Example usage: # echo stack_handle > /sys/kernel/debug/page_owner_filter/print_mode # cat /sys/kernel/debug/page_owner_filter/print_mode full_stack [stack_handle] # cat /sys/kernel/debug/page_owner Page allocated via order 0, migratetype Unmovable, gfp_mask 0x1100ca, pid 1, tgid 1 (systemd), ts 123456789 ns PFN 0x1000 type Unmovable Block 1 type Unmovable Flags 0x3fffe800000084(referenced|lru|active|private|node=3D0|zone=3D1) handle: 17432583 ... Signed-off-by: Zhen Ni Reviewed-by: SeongJae Park --- Changes in v5: - No code changes Changes in v4: - Change from numeric (0/1) to string-based interface ("full_stack"/"stack_= handle") - Merge infrastructure patch into this patch Changes in v3: - No code changes Changes in v2: - Renamed from 'compact mode' to 'print_mode' for better clarity - Use enum values (0=3Dfull_stack, 1=3Dstack_handle) instead of boolean - Update debugfs filename from 'compact' to 'print_mode' --- mm/page_owner.c | 93 +++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 91 insertions(+), 2 deletions(-) diff --git a/mm/page_owner.c b/mm/page_owner.c index 8178e0be557f..28766c854d02 100644 --- a/mm/page_owner.c +++ b/mm/page_owner.c @@ -1,5 +1,6 @@ // SPDX-License-Identifier: GPL-2.0 #include +#include #include #include #include @@ -54,6 +55,24 @@ struct stack_print_ctx { u8 flags; }; =20 +enum page_owner_print_mode { + PAGE_OWNER_PRINT_FULL_STACK, + PAGE_OWNER_PRINT_STACK_HANDLE, +}; + +static const char * const page_owner_print_mode_strings[] =3D { + [PAGE_OWNER_PRINT_FULL_STACK] =3D "full_stack", + [PAGE_OWNER_PRINT_STACK_HANDLE] =3D "stack_handle", +}; + +struct page_owner_filter { + enum page_owner_print_mode print_mode; +}; + +static struct page_owner_filter owner_filter =3D { + .print_mode =3D PAGE_OWNER_PRINT_FULL_STACK, +}; + static bool page_owner_enabled __initdata; DEFINE_STATIC_KEY_FALSE(page_owner_inited); =20 @@ -575,7 +594,11 @@ print_page_owner(char __user *buf, size_t count, unsig= ned long pfn, migratetype_names[pageblock_mt], &page->flags); =20 - ret +=3D stack_depot_snprint(handle, kbuf + ret, count - ret, 0); + if (READ_ONCE(owner_filter.print_mode) =3D=3D PAGE_OWNER_PRINT_STACK_HAND= LE) { + ret +=3D scnprintf(kbuf + ret, count - ret, + "handle: %d\n", handle); + } else + ret +=3D stack_depot_snprint(handle, kbuf + ret, count - ret, 0); if (ret >=3D count) goto err; =20 @@ -970,10 +993,71 @@ static int page_owner_threshold_set(void *data, u64 v= al) DEFINE_SIMPLE_ATTRIBUTE(page_owner_threshold_fops, &page_owner_threshold_g= et, &page_owner_threshold_set, "%llu"); =20 +static ssize_t print_mode_read(struct file *file, char __user *buf, + size_t count, loff_t *ppos) +{ + const char *output; + int mode; + + mode =3D READ_ONCE(owner_filter.print_mode); + + if (mode =3D=3D PAGE_OWNER_PRINT_FULL_STACK) + output =3D "[full_stack] stack_handle\n"; + else + output =3D "full_stack [stack_handle]\n"; + + return simple_read_from_buffer(buf, count, ppos, output, strlen(output)); +} + +static ssize_t print_mode_write(struct file *file, + const char __user *buf, + size_t count, loff_t *ppos) +{ + char *kbuf; + int mode; + int ret =3D count; + + /* + * Limit input size. Maximum valid input is "stack_handle" (12 chars) + * plus newline and null terminator. Use 32 bytes as a reasonable limit. + */ + if (count > 32) + return -EINVAL; + + kbuf =3D kmalloc(count + 1, GFP_KERNEL); + if (!kbuf) + return -ENOMEM; + + if (strncpy_from_user(kbuf, buf, count) < 0) { + ret =3D -EFAULT; + goto out_free; + } + kbuf[count] =3D '\0'; + + mode =3D sysfs_match_string(page_owner_print_mode_strings, kbuf); + if (mode < 0) { + ret =3D -EINVAL; + goto out_free; + } + + WRITE_ONCE(owner_filter.print_mode, mode); + +out_free: + kfree(kbuf); + return ret; +} + +static const struct file_operations page_owner_print_mode_fops =3D { + .owner =3D THIS_MODULE, + .read =3D print_mode_read, + .write =3D print_mode_write, + .llseek =3D default_llseek, +}; + =20 static int __init pageowner_init(void) { - struct dentry *dir; + struct dentry *dir, *filter_dir; =20 if (!static_branch_unlikely(&page_owner_inited)) { pr_info("page_owner is disabled\n"); @@ -981,6 +1065,11 @@ static int __init pageowner_init(void) } =20 debugfs_create_file("page_owner", 0400, NULL, NULL, &page_owner_fops); + + filter_dir =3D debugfs_create_dir("page_owner_filter", NULL); + debugfs_create_file("print_mode", 0600, filter_dir, NULL, + &page_owner_print_mode_fops); + dir =3D debugfs_create_dir("page_owner_stacks", NULL); debugfs_create_file("show_stacks", 0400, dir, (void *)(STACK_PRINT_FLAG_STACK | --=20 2.20.1 From nobody Sat Jun 13 14:00:58 2026 Received: from mail-m155104.qiye.163.com (mail-m155104.qiye.163.com [101.71.155.104]) (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 DE61131E841 for ; Thu, 7 May 2026 07:02:41 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=101.71.155.104 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778137368; cv=none; b=BGHwfbAJuhsnhovPXn5ht0IHVGsPdOTLTkah6/fQsH7gCPiK9H9+oianbjHezogfc3gIbTdjpSVLSqs3sY6WRHvCg8wkMt6WDaKKS0skw36Ropx/V3Al91N7ogi7Yl+MezE9Q4Bh7ccyuNSLE+wJJgyyhyZfdIhN51syxOq9FSc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778137368; c=relaxed/simple; bh=f1C4yIAz4/2QXhCLaiE3RWxr11fGQ0tS5bqO3jHFMLI=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=aBRytTQgEjuTHuCRwhmV3weNdEQ1EHjBr2Mo2HVP/fMXq28cj38+ZHAjBK4GzISG4MYbop6l0OPuWQpTU9yg6KUzNkC3whWea/gMHMtNGxBOr8waDQ53pfFTacuX6dwdVjcc/GB3TFcmv9Di+gwYA13LrlUeB1qVlDRUwGjwDzk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=easystack.cn; spf=pass smtp.mailfrom=easystack.cn; arc=none smtp.client-ip=101.71.155.104 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=easystack.cn Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=easystack.cn Received: from localhost.localdomain (unknown [218.94.118.90]) by smtp.qiye.163.com (Hmail) with ESMTP id 19cdddfc4; Thu, 7 May 2026 14:47:11 +0800 (GMT+08:00) From: Zhen Ni To: akpm@linux-foundation.org, vbabka@kernel.org Cc: surenb@google.com, mhocko@suse.com, jackmanb@google.com, hannes@cmpxchg.org, ziy@nvidia.com, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Zhen Ni Subject: [PATCH v5 2/3] mm/page_owner: add NUMA node filter with nodelist support Date: Thu, 7 May 2026 14:46:42 +0800 Message-Id: <20260507064643.179187-3-zhen.ni@easystack.cn> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20260507064643.179187-1-zhen.ni@easystack.cn> References: <20260507064643.179187-1-zhen.ni@easystack.cn> 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-HM-Tid: 0a9e0130bcd40229kunm3f68df491bc961 X-HM-MType: 1 X-HM-Spam-Status: e1kfGhgUHx5ZQUpXWQgPGg8OCBgUHx5ZQUlOS1dZFg8aDwILHllBWSg2Ly tZV1koWUFJQjdXWRgWCB1ZQUpXWS1ZQUlXWQ8JGhUIEh9ZQVlDSkgdVk1LSB4YSRlJHRlNGFYVFA kWGhdVGRETFhoSFyQUDg9ZV1kYEgtZQVlJSkNVQk9VSkpDVUJLWVdZFhoPEhUdFFlBWU9LSFVKS0 lPT09IVUpLS1VKQktLWQY+ Content-Type: text/plain; charset="utf-8" Add NUMA node filtering functionality to page_owner to allow filtering pages by specific NUMA node(s). This is useful for NUMA-aware memory allocation analysis and debugging. The filter supports flexible nodelist input formats: - Single node: echo "0" > nid - Multiple nodes: echo "0,2,3" > nid - Node range: echo "0-3" > nid - Mixed format: echo "0,2-4,7" > nid - Clear filter: echo > nid (empty string) The implementation uses nodemask_t for efficient multi-node filtering and nodelist_parse() for flexible input parsing. Empty input clears the filter. Note: Access to nid_mask uses plain load/store without locking because nodemask_t is too large (128 bytes) for READ_ONCE/WRITE_ONCE. This is safe for debug use: low-frequency changes and torn reads would only cause temporary inconsistency in debug output. Signed-off-by: Zhen Ni --- Changes in v5: - Optimize nodes_empty() check in page iteration loop - Add __data_racy qualifier to nid_mask field Changes in v4: - Remove "-1" support, use empty string to clear filter - Use strncpy_from_user() instead of copy_from_user() - Add concurrency safety documentation for nid_mask access - Rename fops to page_owner_nid_filter_fops for consistency Changes in v3: - Remove READ_ONCE/WRITE_ONCE for nodemask_t - Add comment explaining input length calculation formula - Simplify "-1" check using kstrtoint() - Move nodemask_t mask read outside PFN iteration loop Changes in v2: - Use nodemask_t instead of int to support multiple nodes - Implement nodelist_parse() for flexible input formats - Use %*pbl format for output --- mm/page_owner.c | 86 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 86 insertions(+) diff --git a/mm/page_owner.c b/mm/page_owner.c index 28766c854d02..227a377d6bb2 100644 --- a/mm/page_owner.c +++ b/mm/page_owner.c @@ -67,10 +67,16 @@ static const char * const page_owner_print_mode_strings= [] =3D { =20 struct page_owner_filter { enum page_owner_print_mode print_mode; + /* + * Lockless access: nodemask_t exceeds READ_ONCE/WRITE_ONCE size limit. + * Torn reads acceptable for debug interface with infrequent writes. + */ + nodemask_t __data_racy nid_mask; }; =20 static struct page_owner_filter owner_filter =3D { .print_mode =3D PAGE_OWNER_PRINT_FULL_STACK, + .nid_mask =3D NODE_MASK_NONE, }; =20 static bool page_owner_enabled __initdata; @@ -687,6 +693,7 @@ read_page_owner(struct file *file, char __user *buf, si= ze_t count, loff_t *ppos) struct page_ext *page_ext; struct page_owner *page_owner; depot_stack_handle_t handle; + nodemask_t mask; =20 if (!static_branch_unlikely(&page_owner_inited)) return -EINVAL; @@ -700,6 +707,9 @@ read_page_owner(struct file *file, char __user *buf, si= ze_t count, loff_t *ppos) while (!pfn_valid(pfn) && (pfn & (MAX_ORDER_NR_PAGES - 1)) !=3D 0) pfn++; =20 + mask =3D owner_filter.nid_mask; + bool filter_by_nid =3D !nodes_empty(mask); + /* Find an allocated page */ for (; pfn < max_pfn; pfn++) { /* @@ -732,6 +742,14 @@ read_page_owner(struct file *file, char __user *buf, s= ize_t count, loff_t *ppos) if (unlikely(!page_ext)) continue; =20 + /* NUMA node filter using bitmask */ + if (filter_by_nid) { + int nid =3D page_to_nid(page); + + if (!node_isset(nid, mask)) + goto ext_put_continue; + } + /* * Some pages could be missed by concurrent allocation or free, * because we don't hold the zone lock. @@ -1054,6 +1072,72 @@ static const struct file_operations page_owner_print= _mode_fops =3D { .llseek =3D default_llseek, }; =20 +static ssize_t nid_filter_write(struct file *file, + const char __user *buf, + size_t count, loff_t *ppos) +{ + char *kbuf; + nodemask_t mask; + int ret; + + /* + * Limit input size to handle worst-case nodelist (all nodes). + * Worst case per node: ",NNNNN" (comma + 5-digit node number) =3D 6 byte= s. + * Formula: 100 bytes overhead + 6 * MAX_NUMNODES + */ + if (count > (100 + 6 * MAX_NUMNODES)) + return -EINVAL; + + kbuf =3D kmalloc(count + 1, GFP_KERNEL); + if (!kbuf) + return -ENOMEM; + + if (strncpy_from_user(kbuf, buf, count) < 0) { + ret =3D -EFAULT; + goto out_free; + } + kbuf[count] =3D '\0'; + + /* Support nodelist format like "0", "0,2", "0-3", or empty to clear */ + if (nodelist_parse(kbuf, mask)) { + ret =3D -EINVAL; + goto out_free; + } + + owner_filter.nid_mask =3D mask; + ret =3D count; + +out_free: + kfree(kbuf); + return ret; +} + +static int nid_filter_show(struct seq_file *m, void *v) +{ + nodemask_t mask =3D owner_filter.nid_mask; + + if (nodes_empty(mask)) + seq_puts(m, "\n"); + else + seq_printf(m, "%*pbl\n", nodemask_pr_args(&mask)); + + return 0; +} + +static int nid_filter_open(struct inode *inode, struct file *file) +{ + return single_open(file, nid_filter_show, NULL); +} + +static const struct file_operations page_owner_nid_filter_fops =3D { + .owner =3D THIS_MODULE, + .open =3D nid_filter_open, + .read =3D seq_read, + .llseek =3D seq_lseek, + .write =3D nid_filter_write, + .release =3D single_release, +}; + =20 static int __init pageowner_init(void) { @@ -1069,6 +1153,8 @@ static int __init pageowner_init(void) filter_dir =3D debugfs_create_dir("page_owner_filter", NULL); debugfs_create_file("print_mode", 0600, filter_dir, NULL, &page_owner_print_mode_fops); + debugfs_create_file("nid", 0600, filter_dir, NULL, + &page_owner_nid_filter_fops); =20 dir =3D debugfs_create_dir("page_owner_stacks", NULL); debugfs_create_file("show_stacks", 0400, dir, --=20 2.20.1 From nobody Sat Jun 13 14:00:58 2026 Received: from mail-m32110.qiye.163.com (mail-m32110.qiye.163.com [220.197.32.110]) (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 BD24A3C9440 for ; Thu, 7 May 2026 11:23:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=220.197.32.110 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778153016; cv=none; b=oENAcjBMwGFveP3Igh3rKN2hQGsSTA/P80DfMpN2QqkARRmcNeD31hs/6KUdx85zApDar14ijE2I8FAWrjPg6MIRYGVa1VNoBuLlISJaUsfypHU78pKHXlk1WufxLMp79DeoyF3Po/nZMQxx8x5Q3kPnkpVo1bxCowUGHx2mXQk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1778153016; c=relaxed/simple; bh=3GSfELYAVEgiTztK129nPZSfPNUDZ1XusfC93FAWfNw=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=UsjWgisSilD0DZyIOvxAHcxEe2IyqYnmaRn5sxMbqsrnfBvmWFsSKsf28pFCe0Lo+MdNCTAdmI1WBEzw63blcWKrvW4FVlsgsKNkpEfF/nXvPq3bcl1ERMLhwE8va/PG4RfuT20gRa/IhTpehPdowt65pmAdssUnJLDUp9h+n1s= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=easystack.cn; spf=pass smtp.mailfrom=easystack.cn; arc=none smtp.client-ip=220.197.32.110 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=easystack.cn Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=easystack.cn Received: from localhost.localdomain (unknown [218.94.118.90]) by smtp.qiye.163.com (Hmail) with ESMTP id 19cdddfca; Thu, 7 May 2026 14:47:14 +0800 (GMT+08:00) From: Zhen Ni To: akpm@linux-foundation.org, vbabka@kernel.org Cc: surenb@google.com, mhocko@suse.com, jackmanb@google.com, hannes@cmpxchg.org, ziy@nvidia.com, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Zhen Ni Subject: [PATCH v5 3/3] mm/page_owner: document page_owner filter features Date: Thu, 7 May 2026 14:46:43 +0800 Message-Id: <20260507064643.179187-4-zhen.ni@easystack.cn> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20260507064643.179187-1-zhen.ni@easystack.cn> References: <20260507064643.179187-1-zhen.ni@easystack.cn> 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-HM-Tid: 0a9e0130c7410229kunm3f68df491bc969 X-HM-MType: 1 X-HM-Spam-Status: e1kfGhgUHx5ZQUpXWQgPGg8OCBgUHx5ZQUlOS1dZFg8aDwILHllBWSg2Ly tZV1koWUFJQjdXWRgWCB1ZQUpXWS1ZQUlXWQ8JGhUIEh9ZQVlCSBhIVk0YHkNJGE9OQh5OSFYVFA kWGhdVGRETFhoSFyQUDg9ZV1kYEgtZQVlJSkNVQk9VSkpDVUJLWVdZFhoPEhUdFFlBWU9LSFVKS0 lPT09IVUpLS1VKQktLWQY+ Content-Type: text/plain; charset="utf-8" Add documentation for the page_owner filter functionality, including: - Print mode filter (full stack vs stack handle) - NUMA node filter (single node, multiple nodes, ranges) - Usage examples for both filters Signed-off-by: Zhen Ni Reviewed-by: SeongJae Park --- Changes in v5: - No code changes Changes in v4: - Update print_mode documentation to reflect string-based interface * Change from "0/1" to "full_stack"/"stack_handle" * Add bracket notation example: "[full_stack] stack_handle" - Update NUMA filter documentation * Remove "-1" example * Add empty string as clear method - Fix indentation: use tabs instead of spaces in code examples Changes in v3: - New patch to document filter features as requested by Andrew Morton --- Documentation/mm/page_owner.rst | 61 ++++++++++++++++++++++++++++++++- 1 file changed, 60 insertions(+), 1 deletion(-) diff --git a/Documentation/mm/page_owner.rst b/Documentation/mm/page_owner.= rst index 6b12f3b007ec..178bacfbb3fd 100644 --- a/Documentation/mm/page_owner.rst +++ b/Documentation/mm/page_owner.rst @@ -74,7 +74,17 @@ Usage =20 3) Do the job that you want to debug. =20 -4) Analyze information from page owner:: +4) (Optional) Use filters to focus on specific memory allocations:: + + cd /sys/kernel/debug/page_owner_filter + + # Print only stack handles instead of full traces + echo stack_handle > print_mode + + # Filter by NUMA nodes + echo "0,2-3" > nid + +5) Analyze information from page owner:: =20 cat /sys/kernel/debug/page_owner_stacks/show_stacks > stacks.txt cat stacks.txt @@ -238,6 +248,55 @@ Usage ./page_owner_sort --tgid=3D1,2,3 ./page_owner_sort --name name1,name2 =20 +Page Owner Filters +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +The page_owner feature provides filtering capabilities to focus on specific +memory allocations (e.g., by NUMA node). Filters are controlled through de= bugfs +files in ``/sys/kernel/debug/page_owner_filter/``. + +Print Mode Filter +----------------- + +The ``print_mode`` file controls the level of detail in stack trace output. + +Available modes: + +- ``full_stack`` (default): Print full stack traces +- ``stack_handle``: Print only stack handles + +Reading the file shows the current mode with brackets around the active op= tion:: + + cat /sys/kernel/debug/page_owner_filter/print_mode + [full_stack] stack_handle + +The ``stack_handle`` mode significantly reduces output size. Instead of fu= ll +stack traces, it prints only the handle number:: + + Page allocated via order 0, mask 0x42800(GFP_NOWAIT|__GFP_COMP), + pid 1, tgid 1 (systemd), ts 349667370 ns + PFN 0xa00a2 type Unmovable Block 1280 type Unmovable + Flags 0x33fffe0000004124(...) + handle: 17432583 + +To retrieve the full stack trace for a handle, use:: + + cat /sys/kernel/debug/page_owner_stacks/show_stacks_handles + +NUMA Node Filter +---------------- + +The ``nid`` file filters pages by NUMA node. This is useful for NUMA-aware +environments to analyze node-specific memory allocation. + +Supported input formats: + +- Single node: ``echo "2" > nid`` +- Multiple nodes: ``echo "0,2,3" > nid`` +- Node range: ``echo "0-3" > nid`` +- Mixed format: ``echo "0,2-4,7" > nid`` +- Clear filter: ``echo > nid`` (empty string) + STANDARD FORMAT SPECIFIERS =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.20.1