mbox series

[man-pages,v3,0/4] Add MADV_COLLAPSE documentation

Message ID 20221021223300.3675201-1-zokeefe@google.com (mailing list archive)
Headers show
Series Add MADV_COLLAPSE documentation | expand

Message

Zach O'Keefe Oct. 21, 2022, 10:32 p.m. UTC 
From: Zach O'Keefe <zokeefe@google.com>

v3 Forward

Changes from v2[1]:

- Patch 3 adds a NOTES section that records the security
  requirements when process_madvise(2) syscall was added in Linux 5.10
  (Alex Colomar).
- Patch 3 also corrects documented
  PTRACE_MODE_READ_REALCREDS ptrace mode for process_madvise(2).

[1] https://lore.kernel.org/linux-man/20221018235051.152548-1-zokeefe@google.com/

----------------------------------------------

v2 Forward

Changes from v1[2]:

- All patches have seen some reformatting and/or typo corrections
  (Alex Colomar).
- Patch 3 has had the commit description reworded to reflect that this commit
  is a "fix" rather than an "update" (Alex Colomar).
- Rebased on man-pages-6.01

[2] https://lore.kernel.org/linux-man/20221017175523.2048887-1-zokeefe@google.com/T/#m8e9e94ed52c99e7cf4969bd992492359c59a0faa

----------------------------------------------

Hey Alex / Michael,

This series adds MADV_COLLAPSE (expected for Linux 6.1) documentation to
madvise(2) and process_madvise(2).  A few prerequisite patches are included to
fix up existing MADV_HUGEPAGE and process_madvise(2) documentation, as well as
add some additional clarity for madvise(2) "advice" probing.

Series applies on man-pages-6.00, and I've attempted to use semantic newlines,
though I can't claim I've made the right choices everywhere for long clauses.

Thanks,
Zach



Zach O'Keefe (4):
  madvise.2: update THP file/shmem documentation for +5.4
  madvise.2: document reliable probe for advice support
  process_madvise.2: fix capability and ptrace requirements
  madvise.2: add documentation for MADV_COLLAPSE

 man2/madvise.2         | 133 +++++++++++++++++++++++++++++++++++++++--
 man2/process_madvise.2 |  31 ++++++++--
 2 files changed, 155 insertions(+), 9 deletions(-)