Documentation/vm/page_owner.rst: update the documentation

Update the documentation of ``page_owner``.

[akpm@linux-foundation.org: small grammatical tweaks]

Link: https://lkml.kernel.org/r/20211214134736.2569-1-hanshenghong2019@email.szu.edu.cn
Signed-off-by: Shenghong Han <hanshenghong2019@email.szu.edu.cn>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Vlastimil Babka <vbabka@suse.cz>
Cc: Georgi Djakov <georgi.djakov@linaro.org>
Cc: Liam Mark <lmark@codeaurora.org>
Cc: Tang Bin <tangbin@cmss.chinamobile.com>
Cc: Zhang Shengju <zhangshengju@cmss.chinamobile.com>
Cc: Zhenliang Wei <weizhenliang@huawei.com>
Cc: Xiaoming Ni <nixiaoming@huawei.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
This commit is contained in:
Shenghong Han 2022-03-24 18:08:56 -07:00 committed by Linus Torvalds
parent 41ed64347b
commit 57f2b54a93
1 changed files with 21 additions and 2 deletions

View File

@ -97,7 +97,7 @@ Usage
The ``page_owner_sort`` tool ignores ``PFN`` rows, puts the remaining rows 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 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 See the result about who allocated each page
in the ``sorted_page_owner.txt``. General output:: in the ``sorted_page_owner.txt``. General output::
@ -107,4 +107,23 @@ Usage
// Detailed stack // Detailed stack
By default, ``page_owner_sort`` is sorted according to the times of buf. 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. If you want to sort by the page nums of buf, use the ``-m`` parameter.
The detailed parameters are:
fundamental function:
Sort:
-a Sort by memory allocation time.
-m Sort by total memory.
-p Sort by pid.
-r Sort by memory release time.
-s Sort by 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.