The patch titled
Subject: Documentation/vm/page_owner.rst: update the documentation
has been added to the -mm tree. Its filename is
documentation-vm-page_ownerrst-update-the-documentation.patch
This patch should soon appear at
https://ozlabs.org/~akpm/mmots/broken-out/documentation-vm-page_ownerrst-update-the-documentation.patch
and later at
https://ozlabs.org/~akpm/mmotm/broken-out/documentation-vm-page_ownerrst-update-the-documentation.patch
Before you just go and hit "reply", please:
a) Consider who else should be cc'ed
b) Prefer to cc a suitable mailing list as well
c) Ideally: find the original patch on the mailing list and do a
reply-to-all to that, adding suitable additional cc's
*** Remember to use Documentation/process/submit-checklist.rst when testing your code ***
The -mm tree is included into linux-next and is updated
there every 3-4 working days
------------------------------------------------------
From: Shenghong Han <hanshenghong2019@xxxxxxxxxxxxxxxx>
Subject: Documentation/vm/page_owner.rst: update the documentation
Update the documentation of ``page_owner``.
Link: https://lkml.kernel.org/r/20211214134736.2569-1-hanshenghong2019@xxxxxxxxxxxxxxxx
Signed-off-by: Shenghong Han <hanshenghong2019@xxxxxxxxxxxxxxxx>
Cc: Jonathan Corbet <corbet@xxxxxxx>
Cc: Vlastimil Babka <vbabka@xxxxxxx>
Cc: Georgi Djakov <georgi.djakov@xxxxxxxxxx>
Cc: Liam Mark <lmark@xxxxxxxxxxxxxx>
Cc: Tang Bin <tangbin@xxxxxxxxxxxxxxxxxxxx>
Cc: Zhang Shengju <zhangshengju@xxxxxxxxxxxxxxxxxxxx>
Cc: Zhenliang Wei <weizhenliang@xxxxxxxxxx>
Cc: Xiaoming Ni <nixiaoming@xxxxxxxxxx>
Signed-off-by: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>
---
Documentation/vm/page_owner.rst | 21 ++++++++++++++++++++-
1 file changed, 20 insertions(+), 1 deletion(-)
--- a/Documentation/vm/page_owner.rst~documentation-vm-page_ownerrst-update-the-documentation
+++ a/Documentation/vm/page_owner.rst
@@ -97,7 +97,7 @@ Usage
The ``page_owner_sort`` tool ignores ``PFN`` rows, puts the remaining rows
in buf, uses regexp to extract the page order value, counts the times
- and pages of buf, and finally sorts them according to the times.
+ and pages of buf, and finally sorts them according to the parameter(s).
See the result about who allocated each page
in the ``sorted_page_owner.txt``. General output:
@@ -108,3 +108,22 @@ Usage
By default, ``page_owner_sort`` is sorted according to the times of buf.
If you want to sort by the pages nums of buf, use the ``-m`` parameter.
+ The detail parameters are shown as follows:
+
+ fundamental function:
+
+ Sort:
+ -a Sort by memory allocate time.
+ -m Sort by total memory.
+ -p Sort by pid.
+ -r Sort by memory release time.
+ -s Sort by the stack trace.
+ -t Sort by times (default).
+
+ additional function:
+
+ Cull:
+ -c Cull by comparing stacktrace instead of total block.
+
+ Filter:
+ -f Filter out the information of blocks whose memory has not been released.
_
Patches currently in -mm which might be from hanshenghong2019@xxxxxxxxxxxxxxxx are
tools-vm-page_owner_sortc-two-trivial-fixes.patch
documentation-vm-page_ownerrst-update-the-documentation.patch
