Merge tag 'docs-6.1-2' of git://git.lwn.net/linux
authorLinus Torvalds <torvalds@linux-foundation.org>
Thu, 13 Oct 2022 17:58:32 +0000 (10:58 -0700)
committerLinus Torvalds <torvalds@linux-foundation.org>
Thu, 13 Oct 2022 17:58:32 +0000 (10:58 -0700)
Pull documentation fixes from Jonathan Corbet:
 "A handful of relatively simple documentation fixes, plus a set of
  patches catching the Chinese translation up with the front-page
  rework"

* tag 'docs-6.1-2' of git://git.lwn.net/linux:
  Documentation: rtla: Correct command line example
  docs/zh_CN: add a man-pages link to zh_CN/index.rst
  docs/zh_CN: Rewrite the Chinese translation front page
  docs/zh_CN: add zh_CN/arch.rst
  docs/zh_CN: promote the title of zh_CN/process/index.rst
  docs/zh_CN: Update the translation of page_owner to 6.0-rc7
  docs/zh_CN: Update the translation of ksm to 6.0-rc7
  docs/howto: Replace abundoned URL of gmane.org
  Documentation: ubifs: Fix compression idiom
  Documentation/mm/page_owner.rst: delete frequently changing experimental data
  docs/zh_CN: Fix build warning
  docs: ftrace: Correct access mode

1  2 
Documentation/mm/page_owner.rst

index f18fd89070493e8105a9dfc66c09844393ae9afd,f1efbb414ea6836f9e14a417dcfb819c647bc6b5..127514955a5e8021b1fe5ed8d1fe63b80c03679b
@@@ -38,22 -38,10 +38,10 @@@ not affect to allocation performance, e
  label patching functionality is available. Following is the kernel's code
  size change due to this facility.
  
- - Without page owner::
-    text    data     bss     dec     hex filename
-    48392   2333     644   51369    c8a9 mm/page_alloc.o
- - With page owner::
-    text    data     bss     dec     hex filename
-    48800   2445     644   51889    cab1 mm/page_alloc.o
-    6662     108      29    6799    1a8f mm/page_owner.o
-    1025       8       8    1041     411 mm/page_ext.o
- Although, roughly, 8 KB code is added in total, page_alloc.o increase by
- 520 bytes and less than half of it is in hotpath. Building the kernel with
- page owner and turning it on if needed would be great option to debug
- kernel memory problem.
+ Although enabling page owner increases kernel size by several kilobytes,
+ most of this code is outside page allocator and its hot path. Building
+ the kernel with page owner and turning it on if needed would be great
+ option to debug kernel memory problem.
  
  There is one notice that is caused by implementation detail. page owner
  stores information into the memory from struct page extension. This memory
@@@ -94,11 -82,6 +82,11 @@@ Usag
        Page allocated via order XXX, ...
        PFN XXX ...
        // Detailed stack
 +    By default, it will do full pfn dump, to start with a given pfn,
 +    page_owner supports fseek.
 +
 +    FILE *fp = fopen("/sys/kernel/debug/page_owner", "r");
 +    fseek(fp, pfn_start, SEEK_SET);
  
     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