Received: by 2002:a05:6a10:9848:0:0:0:0 with SMTP id x8csp3780743pxf; Mon, 22 Mar 2021 15:10:28 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwxgsWt6obSTvoe/fRrOzhHoKpDGA1apuALVxK6N6SRs6nWdIsL4MD1oQz41TPQfpj8QYvE X-Received: by 2002:a05:6402:1157:: with SMTP id g23mr1686760edw.303.1616451028536; Mon, 22 Mar 2021 15:10:28 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1616451028; cv=none; d=google.com; s=arc-20160816; b=oe9R8hEOehta9W0D+T0dNZB7E6sN9GSOfglMk8jeo8PHp8JZaVraA4S3WJAnUR6an4 vPRXqCBo+IfJrxf9ncMQScir1TRWNNk02JRcsBtWt8i8uo2CfA55L7WVC2rgUF0VwRx8 de64uRKGv/i64dSfldVBUPzTB0f2RZh0D6wPYH/gdbDblRML8B8A3Z0FK/qTCI6Egjry nBdcBJHHsJOU4tqBvGonbHvkivt2sDE9TCSZ9/CYzKlhexEG4VBeyZApnWYbtKXUa4Vn P0smxczsR669H71Q6v5N/m+9zedtO23ue78uNT8ntOan4y1eEOgeIgJQRO2zoAXOBLIm xvFA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=4XYWRbgpuCRhnOk3ThFLECfCQaCS+n7XOpk8jXBRAB4=; b=S8Y9DyeSeGkyOg6c0VY/64P0x+y3/VSvzDHAOoOgGcn5mwv8T6eqcb+I4AXoDlCHJw gC97zkMnHseqnXReO4WjAPO1CImH5m9ANz+sbcwknsCneJ1YGv1BCtSvhp3Yhylddlz+ yftJAZE7I8M5we7BjLfcbzWOWj2IgyB8YgCTDpOEVgj0ngAcyOyu7yflpsJrRjfNRhwK bn1B9GOtaAIYJwc8Z8F1X8x0SMgJSdZhqV/X2Lf93CH3NNOrdBSHrSn/V6GGhmjjFajb fvK1URE0TlEi31Ym0idByOpcIchE/M+JZMOMxe9rlXe/DyUZ7B7QMzfMD9gpMqwrjckf fw5A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=UMtmzzP9; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id hr30si11991049ejc.545.2021.03.22.15.10.06; Mon, 22 Mar 2021 15:10:28 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=UMtmzzP9; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229993AbhCVWJF (ORCPT + 99 others); Mon, 22 Mar 2021 18:09:05 -0400 Received: from us-smtp-delivery-124.mimecast.com ([216.205.24.124]:58533 "EHLO us-smtp-delivery-124.mimecast.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230237AbhCVWIx (ORCPT ); Mon, 22 Mar 2021 18:08:53 -0400 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=4XYWRbgpuCRhnOk3ThFLECfCQaCS+n7XOpk8jXBRAB4=; b=UMtmzzP9gbNX/gLO7CexUKTL7BW34BwX74PWm5ZwdtAxuWG3HIZ2fv+IEweXqiznX6/OMq CS7dD62u4SwMhGkR91PEOkzt3TK2RWvHzTiuqX1iL2D16cR31gQkPrtMFUErFXbASEIhEH 9CCDz98TN5RtX85eRO1ye/bGKt2NvQo= Received: from mail-qv1-f72.google.com (mail-qv1-f72.google.com [209.85.219.72]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-445-CrkTrJMjOUWob2dCFdnlLg-1; Mon, 22 Mar 2021 18:08:51 -0400 X-MC-Unique: CrkTrJMjOUWob2dCFdnlLg-1 Received: by mail-qv1-f72.google.com with SMTP id i1so365319qvu.12 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=G/PCDeSa9zgehejSufqQ7FCg008B1LNEyzsnLIvjwoxFGlHKpfE+UCcd5QRapfZz4y FZ0U2nxgTuGIHz4os6O2jfTsOgvB1EQ/PlJgeuGi46ft4Z5Lx8rLBufobdk/Qc1DliJq aemNLlAYT0mZFQKJGhTZhKbsRRYG1JyWN8Q719rn/9YYQEeFIycb1CT06FwA0ZgW2BQv SX5MMgJmlziMdrOcbCyQ0vYMAqpWrYXkwRrRVujMyD8dXfsu+E1Xz6hEPLFJPAJx6t3P v0ylgXy58f9DvPHYQ9YydjFHubBL7wKS0siWJBHzIz7xZzcfM73VHnt2OaHD+lZPns30 wdKA== X-Gm-Message-State: AOAM531xfR7kOO1uUSWS/LNp8/JZWTveKBf4flP+Dspbf9lLm8tqZzS8 YQq2hijqU98TblPFHGwZAyB29FzAkq97Oy3zJUbxWR3sApD00gOy4m+xduw4/mPHwYnU9+ha41x RFoj5cDQOGX0wBrnIaD2ozbQC X-Received: by 2002:ac8:45d7:: with SMTP id e23mr1914221qto.107.1616450931006; Mon, 22 Mar 2021 15:08:51 -0700 (PDT) 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 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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 -- =0D 2.26.2=0D =0D