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 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 69D13CE79A8 for ; Tue, 19 Sep 2023 19:02:21 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id EF7B66B00B6; Tue, 19 Sep 2023 15:02:20 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id ECE5F6B00B7; Tue, 19 Sep 2023 15:02:20 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id C849E6B00B8; Tue, 19 Sep 2023 15:02:20 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id B90B16B00B6 for ; Tue, 19 Sep 2023 15:02:20 -0400 (EDT) Received: from smtpin05.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay09.hostedemail.com (Postfix) with ESMTP id 7E0E2806AC for ; Tue, 19 Sep 2023 19:02:20 +0000 (UTC) X-FDA: 81254267640.05.D3CE635 Received: from mail-yb1-f201.google.com (mail-yb1-f201.google.com [209.85.219.201]) by imf19.hostedemail.com (Postfix) with ESMTP id 938FB1A0008 for ; Tue, 19 Sep 2023 19:02:18 +0000 (UTC) Authentication-Results: imf19.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=sqsR5F5L; dmarc=pass (policy=reject) header.from=google.com; spf=pass (imf19.hostedemail.com: domain of 3OfAJZQ0KCHAOlSZfOgaiggSbUccUZS.QcaZWbil-aaYjOQY.cfU@flex--axelrasmussen.bounces.google.com designates 209.85.219.201 as permitted sender) smtp.mailfrom=3OfAJZQ0KCHAOlSZfOgaiggSbUccUZS.QcaZWbil-aaYjOQY.cfU@flex--axelrasmussen.bounces.google.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1695150138; 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:in-reply-to:references:references:dkim-signature; bh=x6ui7w7cp8TYbfd07TcF3y+H8C9qnaw+znngkakEYjM=; b=FVUG3Urw/EFOgYm0HKjGfHyJt9JIF3mTJO34G+EAjudQTpr5zhJmGI+xgLukTOrp0Cbd+2 jV2/wOdOo5XPJO/7rHVEt8MQCBhLqZiRGLKRjjTvhgfoJ2lJyJIPTF3HS0s7QrYpq+8R01 BD2P/2RSQTw+wCbANNGFjeTs5BgKXho= ARC-Authentication-Results: i=1; imf19.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=sqsR5F5L; dmarc=pass (policy=reject) header.from=google.com; spf=pass (imf19.hostedemail.com: domain of 3OfAJZQ0KCHAOlSZfOgaiggSbUccUZS.QcaZWbil-aaYjOQY.cfU@flex--axelrasmussen.bounces.google.com designates 209.85.219.201 as permitted sender) smtp.mailfrom=3OfAJZQ0KCHAOlSZfOgaiggSbUccUZS.QcaZWbil-aaYjOQY.cfU@flex--axelrasmussen.bounces.google.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1695150138; a=rsa-sha256; cv=none; b=ObcviWoMMoZl9xUuiRQ1F8c0yZMHtt4tDAtlAhUPJHYMR3nibrmXxlzPZK4OF8+RljRdhB cIXfz5MDql65YdbfSD4s5GuRxE8znoGY3OhR9cF2F9PZb7MagIdmvchHWwDENcSwXuxpMf 7zU3xVjrBGupfW5/N8sDvF+oRcSZyjo= Received: by mail-yb1-f201.google.com with SMTP id 3f1490d57ef6-d8486b5e780so3315999276.0 for ; Tue, 19 Sep 2023 12:02:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1695150137; x=1695754937; darn=kvack.org; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=x6ui7w7cp8TYbfd07TcF3y+H8C9qnaw+znngkakEYjM=; b=sqsR5F5LMrU+Y+ZIMLpBkH43A4Evg1CZE+qtppKEiKb95BuJGKPviT6eco6ccAffmq 4mLDgVP4oHcQg3ErwTrFYVZ492ydJV2zPOnMTgNjpsIE2IRyNYLAXGqreJsTDOAFqdd2 BUwHDeiut109myI4/l0CIFp1+OwGLYdyQQpjmavwRtK0JIPmfTQupgB4IiznkwMf7X9X INlHDMZ3VTsskKxShaeZd+A82Bg6Gx+YV1sui4mLt3Chxb79E+5qSSGM3R7GguDjtUBC DkeQBJCQ3M0GYuqM3/21UhVKMNZlCb5fRxWiQaRvQK9Y6NYVPHhZfQvnfMCt5OJgTcjF 4wsQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695150137; x=1695754937; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=x6ui7w7cp8TYbfd07TcF3y+H8C9qnaw+znngkakEYjM=; b=ikguRCv8oNMltmDDtJ+sn2mM8VAISu5Cew/tRW0WvWLj4f/00s4nYjUiUL4gPd5HDc 49Nf0Kir5fIfCNK/b87Aj6x5SzBsZm96ABi2lPBui42xJ6TE0ex9HNWmXrLP8Lzoc9Hd V43Y/GxMQag0r7f1GfjJBJCewYMr16uwbDmu7jFN4B1tvv+I0Yv0fr4yI0jhu15K/ifg paGrtT8KKqqg2ENFHdeTjyrPzdIiMmUxb6x8kx/ByAyWqX2rpDjYOtPzJdRy1teMuoiB sR9VDdlwzrDugvKNq5dGab1vMWaWl9i0F4VYGFYGG4MNryvOk9vcj131hd9iwOClrznl M4EQ== X-Gm-Message-State: AOJu0YxKvyPEiPFuarCTmLGPB8QQwqaaJS2JXCiLuPozQI0FqY4pxz4X ptw8I31fWXYxuWWje4ah5cvxST2dlaGW660LsmnT X-Google-Smtp-Source: AGHT+IF7EWSh/N5MMPZLdhCjlunDyn3WMMhW7XdriIWLhkImYiN4zAjIc9dNexk394B25SiyeJMGHk+g/2e7wceTI23w X-Received: from axel.svl.corp.google.com ([2620:15c:2a3:200:8f5a:6a6a:cafc:a3ad]) (user=axelrasmussen job=sendgmr) by 2002:a25:8b0c:0:b0:cf9:3564:33cc with SMTP id i12-20020a258b0c000000b00cf9356433ccmr8307ybl.13.1695150137798; Tue, 19 Sep 2023 12:02:17 -0700 (PDT) Date: Tue, 19 Sep 2023 12:01:58 -0700 In-Reply-To: <20230919190206.388896-1-axelrasmussen@google.com> Mime-Version: 1.0 References: <20230919190206.388896-1-axelrasmussen@google.com> X-Mailer: git-send-email 2.42.0.459.ge4e396fd5e-goog Message-ID: <20230919190206.388896-3-axelrasmussen@google.com> Subject: [PATCH 02/10] userfaultfd.2: reword to account for new fault resolution ioctls From: Axel Rasmussen To: Alejandro Colomar , Peter Xu Cc: linux-man@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Axel Rasmussen Content-Type: text/plain; charset="UTF-8" X-Rspam-User: X-Rspamd-Server: rspam12 X-Rspamd-Queue-Id: 938FB1A0008 X-Stat-Signature: 35s77peti1y4zm19di9oy3dt96ranwgn X-HE-Tag: 1695150138-517999 X-HE-Meta: U2FsdGVkX1/iwc4Savfv7ceHUyd2QBRXHqqIj2i1kVKS8zOJeqjsIpywKx7ot9YGYvsm41zPU7duFAXjePruqoKpv4OmcnMdNqp0vDmM57X2IfInKt8nACldJSHKjXzPLUO+wkIT3Nv0WfKCevc2+Fv60Exw0zVAb0zAeIZFXMIeOzg8mprtA2m8iTM3ERVFcnIi4nHoNg8fyXtSLc9mFIZJ98lrPLwZ7hDH434GMslJ2K62BEsdqVWnSgSOG1ESXbBtEuk9MYek8khjdHbBAD+bnevfZ2u8ZV5bS3clvMUbC8QVm9tu1uFdqXwTpy7J9ZqPXTGdNckq0DvfshgwbDxDccOO1ZhFAnARq7nnDYy+J4AZF5i4Yta9Pdqs3KnfJFGQCjWKZUewRyEWSQtalC2KTBd/dTHmOzNhwBsOwlNw9RStx7bKr3ev6uQA2mhzxkcX8UNYRkjNP2TMn3QGRsuP+83U3g+1uVWETOJ982i0wQxHDsYKg/4qcFmZeUJsHsOsO/mKIOhnCOR1aes2tyGURJ9ZTeBYqNDUzfo7fhTlwsvAnYMq2M50M/yi0SsKWCN01x/NaMDsIpd0RlbL0j559kp7yCl5zD0+75xVl1ZDlXaiQWVgFLAMreI3m75JkeB84tJxCU5z/PEPD4lKsqX7eAa7i4+FwBnZVEQdDitM2uSGoyrPQexEzB6cUj6UkikhCY4W+/oORaOUqFMnclJoRT2xrHT83kEie34tQUqoCJWzn1MluK/FH3054boK3k152pbForADcpex1lRBDhBTWVROWYvta9qQnchc6ZVXH03UDlroxKvK5nbe3UKiopI1AE8zlh8Ao0tCaQHlLIYJTcmLTFho0mFHqGQzm+LmUBmEywFWiPfBVo0H6aeuuORQEeyfCX/ZX/+1xcJBU6RgMAv9pprK7nvKbUTZ4DJmNfXHFPoCAOR4VM6r0eQxJEHfbuplXvX9oh2ilpS gvuLLVI7 3qWE0zPFOq3KYzTQ9pV1QJDviD+ZX2oTKFNCakbC1uc6o7ceY7jBx7WaK15tVRyreKIzOrUt3XC89dpP5E6gvGeEZbVyrREwUIaNboH9PKlaywTt8T/EC9pki18J1kiZtd6xmFRzdrBaL68eL4LsNU1fWJXtxOuFaeANAoeSMkV9FYcA1FpbGD2fnTLkiozWlLzh8RWboCJwjZcgF7srSNua6UZJ9QfCxzlqFyhrW3uUIWtLJ7WcWaomwPwQn8V6UEquAiq1+EnWpGPPcIpfPj+11FPpJ9YlZ7Rw5rgG/xBRwhGSMCL/M/oqRl+G0owc63BWDdhOf8KIsefU+dGChH4oI217WvgMQ4Mk8i5FXDXOqCaMsqrXU3zj5NYNql4YBsT+AqAnf2AH75husUtc1xFxlZMz3j7WKk2X3VC/KaCSb+lNOVuXOUpcPaPsN6aVA0itYIsWeKhp1SBg0axb75k3I/lgiNZoe/bFENxijbrWlQeI1OJ33rcBRHAdtM5rGJIXK3kG13k07+lsO7xV58alQqsmAKJk9F+KhRiOvHhG+GuUQCr4WphTOnW/cTVSDw6RtchfO+pYK7A/Tj+D+i8rp2IviNqkWYNmz626OUSKsqU2WqE2JV/RXsQJiZgwcSq47e+NLp3KnyS26SsR3AjLATg== X-Bogosity: Ham, tests=bogofilter, spamicity=0.296964, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: Basically, reword the sentence to clarify that this isn't a complete list. I don't believe it's worth maintaining a fully complete list here, instead ioctl_userfaultfd.2 is the place to do that. Let this just be an example. Signed-off-by: Axel Rasmussen --- man2/userfaultfd.2 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/man2/userfaultfd.2 b/man2/userfaultfd.2 index 1b2af22f9..00d94e514 100644 --- a/man2/userfaultfd.2 +++ b/man2/userfaultfd.2 @@ -222,11 +222,12 @@ operation, a page fault occurring in the requested memory range, and satisfying the mode defined at the registration time, will be forwarded by the kernel to the user-space application. -The application can then use the +The application can then use various (e.g. .B UFFDIO_COPY , .B UFFDIO_ZEROPAGE , or .B UFFDIO_CONTINUE +) .BR ioctl (2) operations to resolve the page fault. .PP -- 2.42.0.459.ge4e396fd5e-goog