From patchwork Tue Oct 18 23:50:47 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: 13011211 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 B9461C43219 for ; Tue, 18 Oct 2022 23:51:14 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 58ADE6B0078; Tue, 18 Oct 2022 19:51:14 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 53B856B007B; Tue, 18 Oct 2022 19:51:14 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 403396B007D; Tue, 18 Oct 2022 19:51:14 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 35F2C6B0078 for ; Tue, 18 Oct 2022 19:51:14 -0400 (EDT) Received: from smtpin05.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id F37171A0134 for ; Tue, 18 Oct 2022 23:51:13 +0000 (UTC) X-FDA: 80035718868.05.9311376 Received: from mail-oa1-f74.google.com (mail-oa1-f74.google.com [209.85.160.74]) by imf06.hostedemail.com (Postfix) with ESMTP id A2946180032 for ; Tue, 18 Oct 2022 23:51:12 +0000 (UTC) Received: by mail-oa1-f74.google.com with SMTP id 586e51a60fabf-131caeb598bso6765836fac.12 for ; Tue, 18 Oct 2022 16:51:12 -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=UemkWnYNzX2G5RZp/3AbBJukQzg9bD1s0f4MZJKggRU=; b=mmvBeWPKKL3MlOOcZOddsoReojSh0/yOLXhQwgl52bi+uq44YGG7O6XRIzr9lJb2e1 iYVIsdwb/Z4vsaq1o7doyGWHepwD7gVdbCDwWQBaCGWseQsJXz5iZSSPd5zeP+p8XJ+e SbA2Xcw29uRUGvIcBz5rLlL1seLKmjSPiC8mpWFTAqJ4kMHiDNpjT1ugUlVH+78XxqKj UqsCC4Ppb9TjnjBLQQ1j3ZaTvEfsrffQ49WLKZvOOz4d+nI8Cco77mM5R/vY8ZtLkhVP 1n1Ed9QgKYBQX0eMsdhjNBkDJ+WlOaxowRcJGLzLE4EOvSoXWGbE4jL7nwJgDcohyed1 Vvbw== 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=UemkWnYNzX2G5RZp/3AbBJukQzg9bD1s0f4MZJKggRU=; b=VqwL9GkZjcrtTvoAJgGqQdqS07BAtS2TsKFIssIriZhwRkg+De+TGyrqnp6i/KEroE 9vU5OFArezSY8hTdSu+EZTGdxLQZzZmSXHenMU7kooaU11sMh0/JNTuSfG0tRaKhH9KC 3N+Bjr0e938Gwv6bnjNHBD+r9+kkxDgCzOhSJxz0phl4pt6ZMkmB58dy4TboMrNnrbh+ wYkF38B4YXubHXZtPeVv7agJKbBcmq4oU+BQqwgQOHLzliRkZgWheCYek6+w5siQU8Qs +C95DHK1fL6hFZ0W5PB1txgHwUDHd0OtvdN/3lmj9bpn2r+mFigb1RJxynhglyC8MXiL 2kLw== X-Gm-Message-State: ACrzQf0rETk0RkjZHJKzmYNXzc+l+ujft0T5wFIiHakak5LrQrATbOUV nA9LYZE7fyNcvykxQGLClveyavNBnEtR X-Google-Smtp-Source: AMsMyM4vn/VD5UrAJIYb9/9Ki8oNaZLAj7JQ0TAMtAAcxUXakalot4Yk2JPdeVU+ajGCX24Y2Lq9WYSgBPEK X-Received: from zokeefe3.c.googlers.com ([fda3:e722:ac3:cc00:7f:e700:c0a8:1b6]) (user=zokeefe job=sendgmr) by 2002:a17:90b:4a09:b0:20d:5b67:1496 with SMTP id kk9-20020a17090b4a0900b0020d5b671496mr41114816pjb.67.1666137060675; Tue, 18 Oct 2022 16:51:00 -0700 (PDT) Date: Tue, 18 Oct 2022 16:50:47 -0700 Mime-Version: 1.0 X-Mailer: git-send-email 2.38.0.413.g74048e4d9e-goog Message-ID: <20221018235051.152548-1-zokeefe@google.com> Subject: [PATCH man-pages v2 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=1666137072; a=rsa-sha256; cv=none; b=JsG5ppp5WCti/75n4aiTCezm6VDIMskmQgW/dNvn9s+Yy5/8uzfuVTg9FL/EuXgMu+2fYV 7JO3QCkrhzRrzWzKJlZHuR2a4aLNSdh30QnE85Y/a+tNu9EsK5kzwS7K86GDv7kaTUg7l7 YuxVZfnYOOF5nVrGAzRuMIG2P6sEiVo= ARC-Authentication-Results: i=1; imf06.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=mmvBeWPK; spf=pass (imf06.hostedemail.com: domain of 35DtPYwcKCLkynjddedfnnfkd.bnlkhmtw-lljuZbj.nqf@flex--zokeefe.bounces.google.com designates 209.85.160.74 as permitted sender) smtp.mailfrom=35DtPYwcKCLkynjddedfnnfkd.bnlkhmtw-lljuZbj.nqf@flex--zokeefe.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1666137072; 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=UemkWnYNzX2G5RZp/3AbBJukQzg9bD1s0f4MZJKggRU=; b=6cD71jW/BjTLoe5+uOEC6aYUD0kvVATIu6FfvLfRsATH7Hq5AjvlqixAUX7ymXe2pyrPHs Irzywym2j0XYbEY7ocGJq4eqw2YsWKfe2xaWrx8/E5ghuk9z10ljb26ozeggkvYUSu3uCE pxQyQlBMSZGibqSOzSZRkVsPZokk81U= X-Stat-Signature: t6p88kt95qbxzkwt58fho9oimjkrha37 X-Rspamd-Queue-Id: A2946180032 X-Rspam-User: X-Rspamd-Server: rspam03 Authentication-Results: imf06.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=mmvBeWPK; spf=pass (imf06.hostedemail.com: domain of 35DtPYwcKCLkynjddedfnnfkd.bnlkhmtw-lljuZbj.nqf@flex--zokeefe.bounces.google.com designates 209.85.160.74 as permitted sender) smtp.mailfrom=35DtPYwcKCLkynjddedfnnfkd.bnlkhmtw-lljuZbj.nqf@flex--zokeefe.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com X-HE-Tag: 1666137072-852216 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000001, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: From: Zach O'Keefe v2 Forward Changes from v1[1]: - 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 [1] 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: CAP_SYS_ADMIN cleanup madvise.2: add documentation for MADV_COLLAPSE man2/madvise.2 | 133 +++++++++++++++++++++++++++++++++++++++-- man2/process_madvise.2 | 13 +++- 2 files changed, 140 insertions(+), 6 deletions(-)