From patchwork Mon Oct 17 17:55:19 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: 13009195 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 2F75AC433FE for ; Mon, 17 Oct 2022 17:55:29 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 495586B0074; Mon, 17 Oct 2022 13:55:28 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 423346B0075; Mon, 17 Oct 2022 13:55:28 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 2BF646B0078; Mon, 17 Oct 2022 13:55:28 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id 184D16B0074 for ; Mon, 17 Oct 2022 13:55:28 -0400 (EDT) Received: from smtpin17.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id C4E18160E30 for ; Mon, 17 Oct 2022 17:55:27 +0000 (UTC) X-FDA: 80031193494.17.8DB75BF Received: from mail-pj1-f74.google.com (mail-pj1-f74.google.com [209.85.216.74]) by imf18.hostedemail.com (Postfix) with ESMTP id 66F431C0030 for ; Mon, 17 Oct 2022 17:55:27 +0000 (UTC) Received: by mail-pj1-f74.google.com with SMTP id y7-20020a17090a134700b0020b1347568bso4777620pjf.7 for ; Mon, 17 Oct 2022 10:55:27 -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=ttsr9BbXFZlbPd9uwE3ZbwtF/CRPzTdkpxe4mJFifv4=; b=LgVvfFBiaF7vSUMgKBYwmok8zFmDmOBSmPuGpLPiS6XHn4IdhnUrCy+uYjjXT2sB4Z W/djXIRogYPq5JQ5Ugn2WzJtVzVCMfyCIlrabV1l1IaYc+3WWADcmuyQzfw5fL5WOoXD 6ZgvyCtP4tg7fwHN1hhdlBhcCPnBX6joxkwD7oeddxxkzD5EztH8ikE7I+hdHRXBgzwk 15ggh07lrGaacZJQRAH/FKnXolWWL2fh7QHT0nZ/k+R5BKqTh1CI78iKiUuaokEZJ6M0 rBV3+YoXdQtBCCrr2QHBFligPNYieYgE5i5kUnptaTlNGPIOVL8Je7Z0ehNtlRMFqhya Z69Q== 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=ttsr9BbXFZlbPd9uwE3ZbwtF/CRPzTdkpxe4mJFifv4=; b=CoReTtUHQ8JAKUb79PAeOoWbyyz1Y/WgiKtqc6cqd75SlykWEj3TWApfte5u+wY3YL rtmzPHzwVf/gm3nMoe0G5yI0jCcF+lsUpQMgs8ve5BBGUqtJy+iEqkCGmU8L/+EU8qZW WtEopU7vMMdCK1u65C6Ut02gOMbAFkKbA9iGe7OkLeMVvCK6SJui9IzqOOqdD76cO9oi BUYtFGhGervAXs6gfMcW08Ocdv++ZRSZybHjl665QuHb0Xil9Kcp7bg9IfapY+zDEbrV hdvHgVYtyVFPzDCzEfUc9lxoWYqjbIyQMErMkPgutOI6aI26KR1qdMMKbRUs9U7Imd6d 0nMg== X-Gm-Message-State: ACrzQf26WYkoxmEfEC2IhXEQbHZ6hAsjho1e5KK2cGThcUaVwq3P2DE3 uyPvy1BZe1DGM/8fY7NLfpcA3YmEtc22 X-Google-Smtp-Source: AMsMyM6KZ6V6N1GVyq3cMXsDh/qTct3kZECHr/Vs7YFOg3SthJZfomGkZVNFg51DJk8+Cc4r9isbAZgi8CAB X-Received: from zokeefe3.c.googlers.com ([fda3:e722:ac3:cc00:7f:e700:c0a8:1b6]) (user=zokeefe job=sendgmr) by 2002:a05:6a00:9a7:b0:563:a9e0:fe50 with SMTP id u39-20020a056a0009a700b00563a9e0fe50mr13725204pfg.45.1666029326177; Mon, 17 Oct 2022 10:55:26 -0700 (PDT) Date: Mon, 17 Oct 2022 10:55:19 -0700 Mime-Version: 1.0 X-Mailer: git-send-email 2.38.0.413.g74048e4d9e-goog Message-ID: <20221017175523.2048887-1-zokeefe@google.com> Subject: [PATCH 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 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1666029327; 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=ttsr9BbXFZlbPd9uwE3ZbwtF/CRPzTdkpxe4mJFifv4=; b=e2jC2s6m3BCv+npaW2MKTNdlxNDFz3pJk87qD8LvKVdVjpH8AyGIF7FARMlXF/ESHYgllc OEuVg4EH5yiBdVnxmMrb/49Z19CsFIyAVR3ZdEIK+Yex0QUUgRtWalYXVrHIaPorqgpHyb zvZG95WYZR5QYqT/FSoYkXd2GW8/ZZ0= ARC-Authentication-Results: i=1; imf18.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=LgVvfFBi; spf=pass (imf18.hostedemail.com: domain of 3DpdNYwcKCJMMB711213BB381.zB985AHK-997Ixz7.BE3@flex--zokeefe.bounces.google.com designates 209.85.216.74 as permitted sender) smtp.mailfrom=3DpdNYwcKCJMMB711213BB381.zB985AHK-997Ixz7.BE3@flex--zokeefe.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1666029327; a=rsa-sha256; cv=none; b=aKpdH5g1jtBXvr3GmjHjmCLMzIoGFJ3/56IhQpWJG4/JGhfEupGwSoyr3+F1nkHm1PZ17E RYBo6tAePepJbahhv47+uQ/Tro96j089NcnJflu5/JNfqYLaVsOKCzO6iy/98ml+dY4AVH BMn1n6FoINGay7MofOnOS8D3qfKHrXU= X-Rspamd-Server: rspam12 X-Rspam-User: Authentication-Results: imf18.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=LgVvfFBi; spf=pass (imf18.hostedemail.com: domain of 3DpdNYwcKCJMMB711213BB381.zB985AHK-997Ixz7.BE3@flex--zokeefe.bounces.google.com designates 209.85.216.74 as permitted sender) smtp.mailfrom=3DpdNYwcKCJMMB711213BB381.zB985AHK-997Ixz7.BE3@flex--zokeefe.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com X-Stat-Signature: mbu1xdb16cpwh441wsnm1irugk4pxhuf X-Rspamd-Queue-Id: 66F431C0030 X-HE-Tag: 1666029327-982294 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000022, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: From: Zach O'Keefe Hey Alex / Michael, This series adds MADV_COLLAPSE (currently in 6.1-rc1 and 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 though I've attempted to use semantic newlines, I can't claim I've made the right choices everywhere. 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: CAP_SYS_ADMIN cleanup madvise.2: add documentation for MADV_COLLAPSE man2/madvise.2 | 135 +++++++++++++++++++++++++++++++++++++++-- man2/process_madvise.2 | 13 +++- 2 files changed, 142 insertions(+), 6 deletions(-)