From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-14.0 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id DBF3CC433DB for ; Mon, 22 Mar 2021 22:09:17 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 6AC3E619A9 for ; Mon, 22 Mar 2021 22:09:17 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 6AC3E619A9 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=redhat.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id EBD806B0117; Mon, 22 Mar 2021 18:09:16 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id E6D166B011A; Mon, 22 Mar 2021 18:09:16 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id CD2ED6B011B; Mon, 22 Mar 2021 18:09:16 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0167.hostedemail.com [216.40.44.167]) by kanga.kvack.org (Postfix) with ESMTP id ABB836B0117 for ; Mon, 22 Mar 2021 18:09:16 -0400 (EDT) Received: from smtpin23.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay02.hostedemail.com (Postfix) with ESMTP id 6F86952BB for ; Mon, 22 Mar 2021 22:09:16 +0000 (UTC) X-FDA: 77948901912.23.3A3A2B8 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by imf19.hostedemail.com (Postfix) with ESMTP id EB60C9001143 for ; Mon, 22 Mar 2021 22:08:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1616450933; h=from:from: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:content-transfer-encoding; bh=1/ubDq4XBX4iF7ELV5r2hxSWyoyU+rDMd9vX5929Oow=; b=bj49X5K888Y6/EhgurefLNUwlRHA4UmqNrrQLupXDfQBMG0Gp5wSc7CkyY9OBvVK5NuWNv 58cFNsw6cl0P02Tdl6Tw0xS5bjbMoBwCl+vUDbuZTZDmRjgDHeq5Fq+YMUUIKHoUFU3Cw5 Lm8+QzgIIm2af9qzAAJ9fK1G6RE2Ci0= Received: from mail-qv1-f70.google.com (mail-qv1-f70.google.com [209.85.219.70]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-489-D1Mh-0NNPJilBu8AzUx0CQ-1; Mon, 22 Mar 2021 18:08:51 -0400 X-MC-Unique: D1Mh-0NNPJilBu8AzUx0CQ-1 Received: by mail-qv1-f70.google.com with SMTP id s16so386806qvw.3 for ; Mon, 22 Mar 2021 15:08:51 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=4XYWRbgpuCRhnOk3ThFLECfCQaCS+n7XOpk8jXBRAB4=; b=nP30E4cPwxQi3IrIOz2ilGqnVpTckO4SwLED8tZhDrvW1iTGNsJsXa+DiF2FFt+jVL AcQ9mql15pM/l1rxX8hUo/z3qwa+Zl6jGWmeAv7RZ+oxUYOQEGgHANr6OTO383m8+ZGE 4ip7SpdGs4Ncjf3e+qvZo3EjcwsJak7U3UvzxduOqcDY7oxKxUnfDI2tY78G1GNpFhSH cNQNee6Vxg9SEjvXvI3vADwFw1oITO87kFPxR+V1u0DqxJYkQ4Ldb9PDm7b1RTUsJSAq 8Y8oeiKrimFsRu9J1lExo+acuVZm5v8aIv6mLpkbATnev218/LW7B1m1m7h+0mGV0NeR sF2w== X-Gm-Message-State: AOAM533U2OusAKEidivO4WDhHz9pcZFsrO/0HO8vHLNWjiEsZ82fidZo U65XyqeMm3tzXggY15457n1qk9JVAeDzEgM0ZqyY0f9mjkHqeS6ajroa7Ru6Q5d+MoUXR0dlihT kXIWFEqUG7Vg= X-Received: by 2002:ac8:45d7:: with SMTP id e23mr1914222qto.107.1616450931006; Mon, 22 Mar 2021 15:08:51 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxtiJG/Gqkg3qXMUtWXZN+9qm0csx0cMdPEQixLBFzq0wbtzTaq4fGbvRIVYGgqTLBE7WPU1A== X-Received: by 2002:ac8:45d7:: with SMTP id e23mr1914206qto.107.1616450930755; Mon, 22 Mar 2021 15:08:50 -0700 (PDT) Received: from xz-x1.redhat.com (bras-base-toroon474qw-grc-82-174-91-135-175.dsl.bell.ca. [174.91.135.175]) by smtp.gmail.com with ESMTPSA id x1sm9627850qtr.97.2021.03.22.15.08.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 22 Mar 2021 15:08:50 -0700 (PDT) From: Peter Xu To: linux-man@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Cc: Andrea Arcangeli , Mike Rapoport , Axel Rasmussen , Alejandro Colomar , peterx@redhat.com, Michael Kerrisk , Nadav Amit , Andrew Morton Subject: [PATCH v4 0/4] man2: udpate mm/userfaultfd manpages to latest Date: Mon, 22 Mar 2021 18:08:44 -0400 Message-Id: <20210322220848.52162-1-peterx@redhat.com> X-Mailer: git-send-email 2.26.2 MIME-Version: 1.0 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=peterx@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Stat-Signature: 4tyaym4quwrcwb776uw5ye7sq8h4bayw X-Rspamd-Server: rspam01 X-Rspamd-Queue-Id: EB60C9001143 Received-SPF: none (redhat.com>: No applicable sender policy available) receiver=imf19; identity=mailfrom; envelope-from=""; helo=us-smtp-delivery-124.mimecast.com; client-ip=216.205.24.124 X-HE-DKIM-Result: pass/pass X-HE-Tag: 1616450938-157041 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: v4:=0D - Fixed a few "subordinate clauses" (SC) cases [Alex]=0D - Reword in ioctl_userfaultfd.2 to use bold font for the two modes referenc= ed,=0D so as to be clear on what is "both" referring to [Alex]=0D =0D v3:=0D - Don't use "Currently", instead add "(since x.y)" mark where proper [Alex]= =0D - Always use semantic newlines across the whole patchset [Alex]=0D - Use quote when possible, rather than escapes [Alex]=0D - Fix one missing replacement of ".BR" -> ".B" [Alex]=0D - Some other trivial rephrases here and there when fixing up above=0D =0D v2 changes:=0D - Fix wordings as suggested [MikeR]=0D - convert ".BR" to ".B" where proper for the patchset [Alex]=0D - rearrange a few lines in the last two patches where they got messed up=0D - document more things, e.g. UFFDIO_COPY_MODE_WP; and also on how to resolv= e a=0D wr-protect page fault.=0D =0D There're two features missing in current manpage, namely:=0D =0D (1) Userfaultfd Thread-ID feature=0D (2) Userfaultfd write protect mode=0D =0D There's also a 3rd one which was just contributed from Axel - Axel, I think= it=0D would be great if you can add that part too, probably after the whole=0D hugetlbfs/shmem minor mode reaches the linux master branch.=0D =0D Please review, thanks.=0D =0D Peter Xu (4):=0D userfaultfd.2: Add UFFD_FEATURE_THREAD_ID docs=0D userfaultfd.2: Add write-protect mode=0D ioctl_userfaultfd.2: Add UFFD_FEATURE_THREAD_ID docs=0D ioctl_userfaultfd.2: Add write-protect mode docs=0D =0D man2/ioctl_userfaultfd.2 | 89 ++++++++++++++++++++++++++++-=0D man2/userfaultfd.2 | 117 ++++++++++++++++++++++++++++++++++++++-=0D 2 files changed, 201 insertions(+), 5 deletions(-)=0D =0D --=20=0D 2.26.2=0D =0D