Received: by 2002:a05:7412:37c9:b0:e2:908c:2ebd with SMTP id jz9csp926235rdb; Tue, 19 Sep 2023 14:47:11 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHRfwWwEVudfuib7CTlo8W1Po/sFgRns1EBQTVkz2bVe/69eLJXBvcE8wuSu+csVZIOavKM X-Received: by 2002:a17:902:e5cc:b0:1b9:e241:ad26 with SMTP id u12-20020a170902e5cc00b001b9e241ad26mr909504plf.9.1695160031392; Tue, 19 Sep 2023 14:47:11 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1695160031; cv=none; d=google.com; s=arc-20160816; b=n/Lxd6QEN5tRLu1xzlq3AQ4FQ2nV6zr7NmgLPtEtK8I7w/yRe05ftbzouArm4JUOd4 bn9r7rRs+47csljed3CMhkk7zqUl4dFA/m0ru3bnKyHbIevOBunAa8GRCX1m4HccniMc lLaxYVXxqUw8xQ8t3JqO695Fb0SvIbo8QOd1OsuoUuSA6AckMuwW7W6HA5lBqflxmuU3 9/lmmNj37Vu8bt9D4OEoT2hAloQ+XAh9RWUH2XwZsWRskQ83jjC4reESzmliLTyoTxTm LB6CQcMRXpLq85g60zSOLijTYFl0hKTAMyYU73g+YdpSoFrrwujNw6Fs4aeGflB8XWT8 Vqrg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:from:subject:message-id:mime-version:date :dkim-signature; bh=w7DMdUamBzEa23P7zE5AZLI90338+bQ4zFLdMCSp3KI=; fh=SqwPTGdhTS3wVH9FltNQ4n/lDM1p3ApEDnroT8zra0U=; b=EO35QbiB+R84wIitS9VebK8Rcp4+O1JrngXyTKftyvoxrX74J+Th6e2d6nj8vUgxZN OteL26lw3TCwxkWVWTYzY3cngC3Brj2eJVTqE+11j38TgTBqZ/fWc82q44Oe67HlTJnG Vx4rdH8SwF3QhqiYZGgus3bHOyr148M4DFG1OV1zHkQ71qT+C4y9flzAxINl9nM/jEVK YzBFGOn4UlhTPt9Hlm9txIBghgmADvemfulWviQFFn/ZQQyFpcs5Ty3Zhx43O6eH9HVM Tmfl+DBex0UtcagFsPGP/Fm4FhbTQGZQy9DONLixbmy2uFt6Y1BwZszKBA3qbfmIqStE m4GQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b="UEof/Mk/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Return-Path: Received: from agentk.vger.email (agentk.vger.email. [2620:137:e000::3:2]) by mx.google.com with ESMTPS id jy13-20020a17090342cd00b001c3a06b4fd7si10222831plb.561.2023.09.19.14.47.09 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 Sep 2023 14:47:11 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) client-ip=2620:137:e000::3:2; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b="UEof/Mk/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:2 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by agentk.vger.email (Postfix) with ESMTP id 103B2820BDC9; Tue, 19 Sep 2023 12:02:25 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at agentk.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231921AbjISTCV (ORCPT + 99 others); Tue, 19 Sep 2023 15:02:21 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34722 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231993AbjISTCU (ORCPT ); Tue, 19 Sep 2023 15:02:20 -0400 Received: from mail-yw1-x114a.google.com (mail-yw1-x114a.google.com [IPv6:2607:f8b0:4864:20::114a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CE561E1 for ; Tue, 19 Sep 2023 12:02:14 -0700 (PDT) Received: by mail-yw1-x114a.google.com with SMTP id 00721157ae682-59e79a36097so2560557b3.0 for ; Tue, 19 Sep 2023 12:02:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1695150134; x=1695754934; darn=vger.kernel.org; h=cc:to:from:subject:message-id:mime-version:date:from:to:cc:subject :date:message-id:reply-to; bh=w7DMdUamBzEa23P7zE5AZLI90338+bQ4zFLdMCSp3KI=; b=UEof/Mk/O/C49Pj8KbGq21BVQykE6ts2VwIQ60l6cTX6bumvoMRMXddeHNudsBSPRT uTVUrWBXt2t0eeABdQ/8sgjmcxfE9KT/ktyTjDOYJBj6NyxSnYoU/C0NxA0eJRey8xIa O0HAnbvMobjunQaIY4gjGXScAhwxQtWnLItdO32fpHrhnUtO76iAnl83Enjg18abWx1q mcM0DARDzPwJ/IQ8/647uTGuKGAYaMpe8p9qIB7CTwRVgBA6uKHLuVYu9Yf70mKLFNJ4 ez8he3MUHcCIAXuKTqzr+8x6QvslnMQxcxOQK6L2LOoRvhuDu2bJ1dB2wbY8U83v6o6I 9LqA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695150134; x=1695754934; h=cc:to:from:subject:message-id:mime-version:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=w7DMdUamBzEa23P7zE5AZLI90338+bQ4zFLdMCSp3KI=; b=hyFnnUnWPcRQSRlyiOm138aZ885s//sNOBO0ok22qUoTh8r2D04YG2pI9+Qkc7LEok le2VgpyetWxBOQ6hSAolEwpkr+gbcAPZXhcivCGJFypcSs/maajm5JPTBhFGPMqhui47 AkJvVq9Jqb/IcbmI7nvTz1XrP1BA+jezTaX68cfBoroF4QzD8a2MPPqmqVYPssFXutB6 pRsL66ncCpTWI/QWp1J0Xp5IdOniLItSxCkJHuwXRcvMQdfW4fp8QHXkLHhugByH5Tkg 40ZfJhPsZV+hHdu1xNuJXxrXg1ebMDoU7pwuCfvOmhDGfez6RqMFnIRYSco75bVWKUxS B08Q== X-Gm-Message-State: AOJu0YzYytrWn2K0Z9V1Lz3TuM1ZZC9SVJJD7LpAkZX5cuSE5oRmeLjY F3SUcbo/VrE32lbdZHJAha6FRWkhrQKXfRJzSdYa X-Received: from axel.svl.corp.google.com ([2620:15c:2a3:200:8f5a:6a6a:cafc:a3ad]) (user=axelrasmussen job=sendgmr) by 2002:a5b:c83:0:b0:d81:5c03:df99 with SMTP id i3-20020a5b0c83000000b00d815c03df99mr12778ybq.3.1695150133966; Tue, 19 Sep 2023 12:02:13 -0700 (PDT) Date: Tue, 19 Sep 2023 12:01:56 -0700 Mime-Version: 1.0 X-Mailer: git-send-email 2.42.0.459.ge4e396fd5e-goog Message-ID: <20230919190206.388896-1-axelrasmussen@google.com> Subject: [PATCH 00/10] userfaultfd man page updates 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-Spam-Status: No, score=-8.4 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_IN_DEF_DKIM_WL autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on agentk.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (agentk.vger.email [0.0.0.0]); Tue, 19 Sep 2023 12:02:25 -0700 (PDT) Various updates for userfaultfd man pages. To summarize the changes: - Correctly / fully describe the two-step feature support handshake process. - Describe new UFFDIO_POISON ioctl. - Other small improvements (missing ioctls, error codes, etc). Axel Rasmussen (10): userfaultfd.2: briefly mention two-step feature handshake process userfaultfd.2: reword to account for new fault resolution ioctls userfaultfd.2: comment on feature detection in the example program ioctl_userfaultfd.2: fix a few trivial mistakes ioctl_userfaultfd.2: describe two-step feature handshake ioctl_userfaultfd.2: describe missing UFFDIO_API feature flags ioctl_userfaultfd.2: correct and update UFFDIO_API ioctl error codes ioctl_userfaultfd.2: clarify the state of the uffdio_api structure on error ioctl_userfaultfd.2: fix / update UFFDIO_REGISTER error code list ioctl_userfaultfd.2: document new UFFDIO_POISON ioctl man2/ioctl_userfaultfd.2 | 254 ++++++++++++++++++++++++++++++++------- man2/userfaultfd.2 | 15 ++- 2 files changed, 220 insertions(+), 49 deletions(-) -- 2.42.0.459.ge4e396fd5e-goog