From patchwork Fri Oct 21 22:32:56 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Zach O'Keefe X-Patchwork-Id: 13015557 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 62053C433FE for ; Fri, 21 Oct 2022 22:33:12 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id EA2D28E0003; Fri, 21 Oct 2022 18:33:11 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id E2C908E0001; Fri, 21 Oct 2022 18:33:11 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id CCDA08E0003; Fri, 21 Oct 2022 18:33:11 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id B85EF8E0001 for ; Fri, 21 Oct 2022 18:33:11 -0400 (EDT) Received: from smtpin29.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 58E8D1202E4 for ; Fri, 21 Oct 2022 22:33:11 +0000 (UTC) X-FDA: 80046408582.29.AF5A535 Received: from mail-pg1-f201.google.com (mail-pg1-f201.google.com [209.85.215.201]) by imf28.hostedemail.com (Postfix) with ESMTP id EF1CEC000D for ; Fri, 21 Oct 2022 22:33:10 +0000 (UTC) Received: by mail-pg1-f201.google.com with SMTP id l185-20020a6388c2000000b004610d11faddso1933491pgd.1 for ; Fri, 21 Oct 2022 15:33:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20210112; h=cc:to:from:subject:message-id:mime-version:date:from:to:cc:subject :date:message-id:reply-to; bh=U0OIuEMEH9l5Q4HWoUr/Nw3rsnosYMHa/wX8hbZgkkw=; b=JXsccLmPazbvY3yz9+j3ZKkjoBa44lMTGr8eiX+NClbNa0yF2NBetRRu84BAcVRe/x 9t3B54C1LGV7/LV50TfmjO/rTK55KPNW7UTrbsryCTpWnNu1Dn1/oxcRNgCFkuAHZwdy EfU9h8nrpqPfW4DMYqQ/cXKqwF5ytvQ8WlL6GAmHjDb8J0GpP2KWCkjFDRKX5WLR7Wtn GU0gIrRFGJOfTEnhxOqAgUbTPMIw/ik5nozjHAbraNoR5K8PwH9Tm0hb0JEFfzMCcVgy SY2gVp/tFLBl3FuHooYGBu9Uc7Lw2GwwgIaNBhmIP09+2B3GwCLCSKpK4IR6vOCbZqEZ 7asg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:from:subject:message-id:mime-version:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=U0OIuEMEH9l5Q4HWoUr/Nw3rsnosYMHa/wX8hbZgkkw=; b=K+I+VJ/QGqIIOxgCLgRlOv5S9/bn3DURxeqZ83miyZzxsx8+of+OVgUIcLdH+f5xAk 74NC2DxTlHEU3oKvHKBW8B8vzXKtS0nfVqH5IoA+KqERs37c74Kvi7Wd1deAiczbfP4H tC9SCe/evjIGsEDOqRYrxwehV82h6wkR01V7FLr310NVPiuzH7Bo/xhI+H+BpVQnaZ2y /NxgC6juVspa7g15u62NSNAmpiPikYuacB/sY0JS55uC9WrSMnNOK7B04kCMQJqcQ+nZ pcLieST2jUJz/eeZzwB/xStjIoxjKoEIRlksLq3rQgzg6FNwiazE1RwMhuDef42b+ygo 5Eww== X-Gm-Message-State: ACrzQf3H9zWjgi5xnR80/xWNYYpQnpFP9mnLSD/dI/v6P4tA38lxhnon KW7PhBmCl15+gRQYtnFeNM/R45QfFgHP X-Google-Smtp-Source: AMsMyM58m85HwYhFr2aPduoBomosb1foVa1mHjB4uYv9qsL8Wv+mXx84drIDAE7IDbSXc1/8lBwymKRDMU19 X-Received: from zokeefe3.c.googlers.com ([fda3:e722:ac3:cc00:7f:e700:c0a8:1b6]) (user=zokeefe job=sendgmr) by 2002:a17:902:eb83:b0:185:46b7:7de3 with SMTP id q3-20020a170902eb8300b0018546b77de3mr21284859plg.19.1666391589698; Fri, 21 Oct 2022 15:33:09 -0700 (PDT) Date: Fri, 21 Oct 2022 15:32:56 -0700 Mime-Version: 1.0 X-Mailer: git-send-email 2.38.0.135.g90850a2211-goog Message-ID: <20221021223300.3675201-1-zokeefe@google.com> Subject: [PATCH man-pages v3 0/4] Add MADV_COLLAPSE documentation From: Zach OKeefe To: Alejandro Colomar , Michael Kerrisk Cc: Yang Shi , linux-mm@kvack.org, linux-man@vger.kernel.org, "Zach O'Keefe" ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1666391591; a=rsa-sha256; cv=none; b=Q0NqIgqQ1ZqMNh0I6ETpOd9oTqFw+t6FxULnTIuYY5WIuTjAqu+Jzg/RObSAB3tQHA9sit y4BYxA5e/gVv65tVrZgRvIZQ5jZ28MmipkYPuNHwQBvb4zEvPqFAryvZTYpOHgfPzFkkUe svLeIkTs1Gl2+xLQjIZSfG+t+ooDqC8= ARC-Authentication-Results: i=1; imf28.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=JXsccLmP; dmarc=pass (policy=reject) header.from=google.com; spf=pass (imf28.hostedemail.com: domain of 3JR5TYwcKCM4J84yyzy08805y.w86527EH-664Fuw4.8B0@flex--zokeefe.bounces.google.com designates 209.85.215.201 as permitted sender) smtp.mailfrom=3JR5TYwcKCM4J84yyzy08805y.w86527EH-664Fuw4.8B0@flex--zokeefe.bounces.google.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1666391591; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding:in-reply-to: references:dkim-signature; bh=U0OIuEMEH9l5Q4HWoUr/Nw3rsnosYMHa/wX8hbZgkkw=; b=ONCUEqjZ0N6JZgOJV01f+wq7IEJ66i2FVQqQsYo7Udc6B1R+auAQs0javsQaFGKUtBtoDQ 2vXJ7TnnZqJOR+bQ4Ig+JHkOJhSy5dAhcU9iIyXzGzORCCWScaw/7CjX5OjhJempN1KMUp bx5pgJXSC/1DmoLEIarIAQYosiLUX4E= Authentication-Results: imf28.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=JXsccLmP; dmarc=pass (policy=reject) header.from=google.com; spf=pass (imf28.hostedemail.com: domain of 3JR5TYwcKCM4J84yyzy08805y.w86527EH-664Fuw4.8B0@flex--zokeefe.bounces.google.com designates 209.85.215.201 as permitted sender) smtp.mailfrom=3JR5TYwcKCM4J84yyzy08805y.w86527EH-664Fuw4.8B0@flex--zokeefe.bounces.google.com X-Rspamd-Server: rspam04 X-Rspam-User: X-Stat-Signature: ubt38rifhuumzrhgfesp9mj55xd45xy7 X-Rspamd-Queue-Id: EF1CEC000D X-HE-Tag: 1666391590-542525 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: From: Zach O'Keefe 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(-)