Received: by 2002:a05:6a10:9848:0:0:0:0 with SMTP id x8csp3911939pxf; Mon, 29 Mar 2021 15:20:18 -0700 (PDT) X-Google-Smtp-Source: ABdhPJyBBfN58VpLIZPYxf5eMzFU8/kaOnnc+BMtiRAiohPhkDCGE9YXhdrx0jsgmfDRy0ZMXPFZ X-Received: by 2002:a17:906:a3d1:: with SMTP id ca17mr30716833ejb.92.1617056418086; Mon, 29 Mar 2021 15:20:18 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1617056418; cv=none; d=google.com; s=arc-20160816; b=tcdRC9k7V4B+H6WViwtCbtljHL/xs4mew9XGb/x6dsZhGSYs7coo4kROTAqyyWofDB mxw/LBuMt0mrZsjvF0LrSNXHF+IkH8fTLpbVZOi0HF+aNi2bkwCS9o94Xxyh1lEpq+oT 8UCEQY25kaPRH+DFn8IZ+2u07SmL1gXmPiVDDe4JIX94MfUTfmMvdwGpMJN9WB25fr5i IY5yChjxiTtj3rI9ktycIL3mTCmu8k8nm3PNmWJ3C5zlkmc/pKwMsssAlXUZhBt8ptcj xFmMli8wv6g9KqRSREpHjKNK/AI8c01etUITDOteyzT4MvTfpynkfr8C+TJOZs0N5/fZ JNJg== 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=a2LCEVo4TBpl00I4ylw0j9DYE4xxtQovFWZPzhkRNFo=; b=T1ctpl0VQiO9L3Wo1z/HxJk//RAc+bHMLP4y+M9S8w/DREuB6s29Fz9QwXsAh2F9l+ xZsmIRNywn8+otwcWu1z1JN/3/3x6D8G0HihdPqtGpLJMcQIRNbdxp07zsyyWvMnIjL7 yhfB0EY4VstjN9+x6bLida66eK1LRyMvblm9hZrvvrfBVTshyK5VSjTUETCBeZ1b08Ey HSYlG6/wpP+rc2tBND99MUUGYLHHfH4cVWAdqYiMhiYQNSbCJHpWMLrEbVZoQkGBJPop UkNkVQegHT2AMCRqRY9btkfaAlmXxacKbSwFSXf8C8jXk86kDjaJMlsFibahgA17QSzi a4Aw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=LMFBGe+Z; 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 b15si13677152ejv.689.2021.03.29.15.19.55; Mon, 29 Mar 2021 15:20:18 -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=LMFBGe+Z; 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 S231238AbhC2WTC (ORCPT + 99 others); Mon, 29 Mar 2021 18:19:02 -0400 Received: from us-smtp-delivery-124.mimecast.com ([63.128.21.124]:33901 "EHLO us-smtp-delivery-124.mimecast.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230271AbhC2WSj (ORCPT ); Mon, 29 Mar 2021 18:18:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1617056319; 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=a2LCEVo4TBpl00I4ylw0j9DYE4xxtQovFWZPzhkRNFo=; b=LMFBGe+Z+8rEI91QPf7U1A4RQNcKrn3gINCeZR+9GD0FoP70Sj+HISyk8Kv8O1s74J2Dav 3ktx0yE7VIaR17tyhjbGxJJmuq4L0m2aITfsEi4/gUrR172SOmLZHdPKuYgYb3qPov1Jhe Akz3CYmQIWZ5Cpky46q5TUx8smXPg6c= Received: from mail-qk1-f199.google.com (mail-qk1-f199.google.com [209.85.222.199]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-572-j523m72GPLuC_rcF_SN4Fg-1; Mon, 29 Mar 2021 18:18:37 -0400 X-MC-Unique: j523m72GPLuC_rcF_SN4Fg-1 Received: by mail-qk1-f199.google.com with SMTP id b78so13206069qkg.13 for ; Mon, 29 Mar 2021 15:18:37 -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=a2LCEVo4TBpl00I4ylw0j9DYE4xxtQovFWZPzhkRNFo=; b=cxvOWJC7aQGUan89MeFXgsbYvr0QmfGbeoByvmQiMtN5ZKm/QWbZ83qFcp//gkNW6I zQy7Lb/+yzYKVdxYJPOTuCo3FbhEC/dxJAElglr51EArYy0WTMLHQjmw9Eov5BYHNdeA tHTH0lzePP/I0PiG6ArSEOZE/6tUcSRPc0GN9oXP53z4izkm2iooWdRoDsFl/Uj6HbFl jIqry+ZH+95qPQWeF9+i/lSQDr9hPWwhWJnJAoSejSE/Z0wHYFEp7+Gb+ptwALn7xuBO Ff5pU3Y2PUIiIspkNE0/ifZf1INmy6Mz+2wMFL30AF8q643EzNVzmEY6nlH7uT0VHz2j B5iw== X-Gm-Message-State: AOAM530R/tilDbK4/pYGkY5/gWK5EJ19Cg50H5jdMDJrIWUKELhPbNi7 dkYQyV1y6zwiUNqs0bCXQddVLZ+xP6LLncGhe+8edzRx2la4OPSOW/1UCf8diibqnWuhIxRodQv gx0ThbL7/1on5EHl3TSkQmEtO X-Received: by 2002:a0c:fd62:: with SMTP id k2mr27266584qvs.51.1617056316469; Mon, 29 Mar 2021 15:18:36 -0700 (PDT) X-Received: by 2002:a0c:fd62:: with SMTP id k2mr27266568qvs.51.1617056316155; Mon, 29 Mar 2021 15:18:36 -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 i17sm12255215qtr.33.2021.03.29.15.18.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Mar 2021 15:18:35 -0700 (PDT) From: Peter Xu To: linux-mm@kvack.org, linux-kernel@vger.kernel.org, linux-man@vger.kernel.org Cc: Axel Rasmussen , peterx@redhat.com, Nadav Amit , Mike Rapoport , Alejandro Colomar , Andrea Arcangeli , Michael Kerrisk , Andrew Morton Subject: [PATCH v5 0/4] man2: udpate mm/userfaultfd manpages to latest Date: Mon, 29 Mar 2021 18:18:29 -0400 Message-Id: <20210329221833.517923-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 v5:=0D - add r-bs for Mike R.=0D - Fix spelling mistake "diable" [Mike R.]=0D - s/Starting from/Since/ for patch 2 (also replaced two existing ones in th= e=0D same file) [Alex]=0D - s/un-write-protect/write-unprotect/ [Alex]=0D - s/The process was interrupted and need to retry/The process was interrupt= ed;=0D retry this call/ in the last patch. [Alex]=0D =0D 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 | 121 +++++++++++++++++++++++++++++++++++++--=0D 2 files changed, 203 insertions(+), 7 deletions(-)=0D =0D -- =0D 2.26.2=0D =0D