From patchwork Thu Mar 4 16:31:36 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Xu X-Patchwork-Id: 12116583 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=-13.8 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 5B685C433DB for ; Thu, 4 Mar 2021 16:32:13 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 078AB64F40 for ; Thu, 4 Mar 2021 16:32:13 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 078AB64F40 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 982DB8D0001; Thu, 4 Mar 2021 11:32:12 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 932286B0027; Thu, 4 Mar 2021 11:32:12 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7D4918D0001; Thu, 4 Mar 2021 11:32:12 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0146.hostedemail.com [216.40.44.146]) by kanga.kvack.org (Postfix) with ESMTP id 6168E6B0026 for ; Thu, 4 Mar 2021 11:32:12 -0500 (EST) Received: from smtpin21.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay03.hostedemail.com (Postfix) with ESMTP id 22C3C8249980 for ; Thu, 4 Mar 2021 16:32:12 +0000 (UTC) X-FDA: 77882734104.21.8310911 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by imf25.hostedemail.com (Postfix) with ESMTP id D6C956000126 for ; Thu, 4 Mar 2021 16:31:54 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1614875505; 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=D0AP3pbInR2ax64y3IZP1R8JdXmTdGU5ZPgxjiuqihI=; b=g3JEwgLJkpgxLXRlZGHL6202+QHbbYEMe1vdJaISFHlti0e6+tSdKknPYYgtoJ2yYAjbwF nI/EySLQ02TkeydFBxCDRB0D2aTR22ChwBsY7dUjdBwnzpLIA8e7ZsDTXwxccMnxBmFcTt CZli29bcpzyUUHjL/6Cc9Fcp+dVVzgE= Received: from mail-qk1-f200.google.com (mail-qk1-f200.google.com [209.85.222.200]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-571-uji0SGbKMQiAQDq6x_ca6Q-1; Thu, 04 Mar 2021 11:31:43 -0500 X-MC-Unique: uji0SGbKMQiAQDq6x_ca6Q-1 Received: by mail-qk1-f200.google.com with SMTP id y9so452580qki.14 for ; Thu, 04 Mar 2021 08:31:43 -0800 (PST) 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=ZUXTrjCiBnFBfW3I1AJm2v8RBKCC0eFrzGXvwdchW8I=; b=Pd4me80aXR3pR+EOM3zOmVhuRoP4BJGI/obRDZJSw9O2qhu41lM0TgRu8C7lNV4kXz dutQVuYFVHXgoLpOGf66UvxgW1nC/6Aqazrd/x3+POO4j8ex7OisDs/S3Xl0XG+XoftH d+qJNOJ5BU22LfrGJXa+/nDfb4XWTyumqsWOUAU46zUbke/2B06axTSAATAdhxGpnZT/ INc7MazGemDs6o8Z1VsYfrQb6s1GjgnxG1gRz7pgyMejp8zGsnfLvwjFWpWGq1QQX1tN UvrMl0MYrIEQSJrO5pjfIot0hVz45q+woN4UZbemfmxwX8LfQZ3MkEOCDcjIZPQdXFnM rVKA== X-Gm-Message-State: AOAM532DHka66e+AixiqnuIS72iNn5F4StS3JJVRNIQqDa0UP9i9qYlX THrfJqFYbVE3CRrAB2n/96e3f+lMvJXvvEZfkVpEx+/g4GgDD20QXamc15LYt8ZDlvhAkJz1qLu BqtzjqgA0Swg= X-Received: by 2002:a05:620a:887:: with SMTP id b7mr4600088qka.215.1614875503058; Thu, 04 Mar 2021 08:31:43 -0800 (PST) X-Google-Smtp-Source: ABdhPJxRwA8NqRHMC76ampCa9culrt7kttzspJbhFtBwbLgYJh88JCUd4TvyBMqBdtoeCEtTi0yNxg== X-Received: by 2002:a05:620a:887:: with SMTP id b7mr4600063qka.215.1614875502794; Thu, 04 Mar 2021 08:31:42 -0800 (PST) Received: from xz-x1.redhat.com (bras-vprn-toroon474qw-lp130-25-174-95-95-253.dsl.bell.ca. [174.95.95.253]) by smtp.gmail.com with ESMTPSA id r2sm51753qti.4.2021.03.04.08.31.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 04 Mar 2021 08:31:42 -0800 (PST) From: Peter Xu To: linux-man@vger.kernel.org Cc: Alejandro Colomar , Nadav Amit , Andrea Arcangeli , linux-kernel@vger.kernel.org, Michael Kerrisk , Mike Rapoport , Axel Rasmussen , Andrew Morton , Linux MM Mailing List , peterx@redhat.com Subject: [PATCH v2 0/4] man2: udpate mm/userfaultfd manpages to latest Date: Thu, 4 Mar 2021 11:31:36 -0500 Message-Id: <20210304163140.543171-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 X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: D6C956000126 X-Stat-Signature: bgipp36imse146k5c3wc4yay7qohgu7f Received-SPF: none (redhat.com>: No applicable sender policy available) receiver=imf25; 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: 1614875514-422130 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: v2 changes: - Fix wordings as suggested [MikeR] - convert ".BR" to ".B" where proper for the patchset [Alex] - rearrange a few lines in the last two patches where they got messed up - document more things, e.g. UFFDIO_COPY_MODE_WP; and also on how to resolve a wr-protect page fault. There're two features missing in current manpage, namely: (1) Userfaultfd Thread-ID feature (2) Userfaultfd write protect mode There's also a 3rd one which was just contributed from Axel - Axel, I think it would be great if you can add that part too, probably after the whole hugetlbfs/shmem minor mode reaches the linux master branch. Please review, thanks. Peter Xu (4): userfaultfd.2: Add UFFD_FEATURE_THREAD_ID docs userfaultfd.2: Add write-protect mode ioctl_userfaultfd.2: Add UFFD_FEATURE_THREAD_ID docs ioctl_userfaultfd.2: Add write-protect mode docs man2/ioctl_userfaultfd.2 | 81 ++++++++++++++++++++++++++-- man2/userfaultfd.2 | 111 ++++++++++++++++++++++++++++++++++++++- 2 files changed, 187 insertions(+), 5 deletions(-)