[PATCH] Documentation/vm/page_owner.rst: Update the documentation

From: Shenghong Han
Date: Tue Dec 14 2021 - 08:48:43 EST


Update the documentation of ``page_owner``.

Signed-off-by: Shenghong Han <hanshenghong2019@xxxxxxxxxxxxxxxx>
---
Documentation/vm/page_owner.rst | 21 ++++++++++++++++++++-
1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/Documentation/vm/page_owner.rst b/Documentation/vm/page_owner.rst
index 9837fc8147dd..7a28e7b0d9c2 100644
--- a/Documentation/vm/page_owner.rst
+++ b/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.
--
2.30.1