From patchwork Tue Oct 17 23:01:07 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Axel Rasmussen X-Patchwork-Id: 13426167 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 0A5B5CDB482 for ; Tue, 17 Oct 2023 23:01:19 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 699368D0005; Tue, 17 Oct 2023 19:01:19 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 63FB78D0002; Tue, 17 Oct 2023 19:01:19 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 507A28D0005; Tue, 17 Oct 2023 19:01:19 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id 3EC1D8D0002 for ; Tue, 17 Oct 2023 19:01:19 -0400 (EDT) Received: from smtpin10.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id F220A40EF8 for ; Tue, 17 Oct 2023 23:01:18 +0000 (UTC) X-FDA: 81356476236.10.01E8A05 Received: from mail-yw1-f202.google.com (mail-yw1-f202.google.com [209.85.128.202]) by imf29.hostedemail.com (Postfix) with ESMTP id 3DFC112001F for ; Tue, 17 Oct 2023 23:01:17 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=UoFtbH4+; spf=pass (imf29.hostedemail.com: domain of 3PBIvZQ0KCE0pCt06p71977t2v33v0t.r310x29C-11zAprz.36v@flex--axelrasmussen.bounces.google.com designates 209.85.128.202 as permitted sender) smtp.mailfrom=3PBIvZQ0KCE0pCt06p71977t2v33v0t.r310x29C-11zAprz.36v@flex--axelrasmussen.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1697583677; 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: references:dkim-signature; bh=4SDhb6UAPkxAoM2wRCL8OdhbgRXprRWmehTmuNxYxAM=; b=W1Y8oZ+QOSfN1hdEZfUNCOLAh3CkMqxWZBs41vihS+IVMU4pw/OwGp/p+0yJtLve+PCL9S FV13YqJ2JO0YgSY02uzHFFmePPHACcyzQXLEcufYkNWW9ZgUquNzsLpDZRXyQanxMhXNjH mHA1vKxu7VTNfNuqXkMP7n4ti/4btC0= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1697583677; a=rsa-sha256; cv=none; b=ExLb31BlcoAbB6qFAcYbCYCG8AqPGOHgOPMlIN0IoYqOijXgZ7PcnZrjOVnklrmIDSnbpW XtlQJNiiDq2vvlMk4aOlF7JSxK6vwuiQLDPNFZgjsksY5zzKarSoUeDwUp/zAWcMLrGk87 6kL3NBQxPMXsbp60trCnLI4Jilyzenk= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=UoFtbH4+; spf=pass (imf29.hostedemail.com: domain of 3PBIvZQ0KCE0pCt06p71977t2v33v0t.r310x29C-11zAprz.36v@flex--axelrasmussen.bounces.google.com designates 209.85.128.202 as permitted sender) smtp.mailfrom=3PBIvZQ0KCE0pCt06p71977t2v33v0t.r310x29C-11zAprz.36v@flex--axelrasmussen.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com Received: by mail-yw1-f202.google.com with SMTP id 00721157ae682-5a81a80097fso77199457b3.3 for ; Tue, 17 Oct 2023 16:01:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1697583676; x=1698188476; darn=kvack.org; h=cc:to:from:subject:message-id:mime-version:date:from:to:cc:subject :date:message-id:reply-to; bh=4SDhb6UAPkxAoM2wRCL8OdhbgRXprRWmehTmuNxYxAM=; b=UoFtbH4+nWFj6jLJSVV4bG1vCkCeTuFl1kPsoH7xG8FDHTEFcxQr5KecqKoBdg27Zc tb/KMgoQ7JBAU/FeHlJNx4pim4D4qnhW1RrGpaldLgB+wq3icHEuWM9Jz+s+hy7iKXQN SbPqdssep1N/BLYx8MXOqgUOf8sgkUXlkSLsbFgSncWzL6dQ4iRB6OPe0U1vZXMBCsca tMVX+S4wDsDM9TCezTmdZnwKF6VxSWNy/K/uMl7pu/MuoijsVTr1uE6951TwNvBwvsVo BuiT04Nv6fBaycrViYjDr9f5F+6mAhkdhFCq7IOfLbkvUYmx+Zh18FKQp7JLBAehpm2u xRTw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697583676; x=1698188476; h=cc:to:from:subject:message-id:mime-version:date:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=4SDhb6UAPkxAoM2wRCL8OdhbgRXprRWmehTmuNxYxAM=; b=AQQAoZGQ7cbxys6E4P/kp8kXhVsk/P5Ukl/HOZeCKXaNtt8Y4yST2TxJFaFCMpANN8 m8ojZWi+P0fgDwGZx9LLqBSCtlVtbQ6IcZW6wanehhf3xvxf1n64Fx3XNuSQnu0Sn/s/ qKhY2YMLlkzYrMSOYqhlGNdSJeB1r0ZV20dXta6aiIXk14IOaaFYtE8IDxd+oBWOVMw9 fnGhExG2MkzbfRBUwKw9bMaXexdeOmJD6qFfPQGUloMZRf1wDneA/BNbAEIT7+AGfkAN C/3yloqFfGJSUWerJhz05iE+QZZnPArCDXECqGaFJmQjmZSDZytxObF8q2sJErjmfHEi aIdQ== X-Gm-Message-State: AOJu0YwNqUFHeDy8GLz+GlKdBrwzuuL64qZvUHjUb1wemTvmtlI+5QdK MqXfeoXEgzDmBjXLMpmKgBHXePsXga7hwnLb+YZy X-Google-Smtp-Source: AGHT+IElOQnXJ8mAPfK/Uft/QZDFbxpj4waEhQQCD8PjRlSuHnU6ChFz05siV7yB+6AvAe9n/NYUaIe3MGJeZK0G635R X-Received: from axel.svl.corp.google.com ([2620:15c:2a3:200:cd04:35d6:a586:5c86]) (user=axelrasmussen job=sendgmr) by 2002:a0d:ea43:0:b0:5a8:3f07:ddd6 with SMTP id t64-20020a0dea43000000b005a83f07ddd6mr81182ywe.6.1697583676211; Tue, 17 Oct 2023 16:01:16 -0700 (PDT) Date: Tue, 17 Oct 2023 16:01:07 -0700 Mime-Version: 1.0 X-Mailer: git-send-email 2.42.0.655.g421f12c284-goog Message-ID: <20231017230110.3170850-1-axelrasmussen@google.com> Subject: [PATCH v3 0/3] userfaultfd man page updates From: Axel Rasmussen To: Alejandro Colomar , Mike Rapoport , Peter Xu Cc: linux-man@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Axel Rasmussen X-Stat-Signature: cdb9eonmsa4puxpoph456c4aw6o8w8wj X-Rspamd-Server: rspam10 X-Rspamd-Queue-Id: 3DFC112001F X-Rspam-User: X-HE-Tag: 1697583677-1115 X-HE-Meta: U2FsdGVkX1+6s5Dn5s0UyuzosX62cfsZfS4JcPUbO6zTEMy6LA95sN5okyIqdHuiFf1mvZxgxUgJ+tBc9wqgiv6Bmc5YoA4KG7e3eM8q8lW8V8bRFprTNV7xxcX2sv/LeJhlOesK8J5k7/BRoawHmbxXOH44Cqk85lN+iOfcfOa/kN+8CKMCkAGGpLHFb9y4o+BOhelSR9gA4ATqmsUeR7sNS4egRcX3AmhAzYhDUoXlbiavjvB3i5RPqCnjTD7CkBhuTtslQY7mQJrZVte0Kumf4vfMDlPXfp1HXkul5pZodmDlPTXdyPX3M9jjUgBFK84pUmD5m0vM9pULDohb8fu3xRhckAK/n7ZcRki14Pd6F1PBzFM20R7jgrSrst4JAwHYOQGMxLh26+gABp6G0ggO18Yd/0TVFDXehf2P1FMSiITan1Ua6jXDs5AGMZ9udmOoeSX0BW1/pHCfeYHwdqT/QQIl+dEIvpUJPN/9oRTUWA0JsZRjUcTic7JD04UpPQnx9Q7LJq4aCjLz/rnG1gPkhGxhZuzmeFBuIgWA0kOYLKV+vtc5NwJnp6MSCnPYMfhDJDYo4cWXaMGVDLagYdDp/leRlVOwF/RoWyX/qICOBwGNEfpVmglxZmZeOHEGc860w2DCToTGDZTEEEh5pImEsQYoOVtiI5S2HTkNuNNal7xBPgYfw3tIbCfnpBfK7gdoKFIf/1957dHKf5zvjOwCZLCdVm2SZG8L+Jd+fTcubVicJmd1Vnt22JplU+nFqv9/TsMWiSQ9SzqB5P1kBTaQo3fh4zlpqSE4R1RgrQmiXShh9YEChYr2QM95Xygd+PLRTQtvfetX7oBb7vMKOv0DB5RVCmO6A6I6N/O72tST/4igVQr6+niasPSvFMcwStNlb9mcK6re/W86kXAjSSAfBUA8r3Ykycalg9paH3wI1n8qpWlQgjimpUjU58qyOiNyLXNQJV9J4mU0O5R llP7ONbT ME09M22iKYWZdnLNvppj9MT9vMIRGq8qkSqnsMhZcsmrWlGge+oTO2hwCCVyJIRnCd8UMynQINtKuVyWPveKT8cXGVX+aOXXlbBCYGbvFLJyi89HGMCIDvdwteRlP8dSbSU/x0phs01LTouNB8ez9CAzSPZIsRwk33u62+4O1iLTMPRPrfLIO6mjYbOFjO/grbVs9OhJJ0kmY/f1w01AQCS2P6ELQVrHeUfssM39zYFm3MNv7joUTSe65Zejo4z9efwiR52HJLiUSP9G7WVZqjJeHcOzE4slTFQUefASaz5nTaXNibDIEwM5oi6oaqXvj4htj5XhE4uGR79hU1gsVI/Hh5S3xrNp0/RCgOF/ptOoUBWfCqCubi4tcoWLDOLRR0KOchi0RvjVdLj9xxVZ9JlVkKNAXT13PL7zF+Hnpu572oxvRj7jUBz5sev6VcsOJFZxnj86aqitIbZH/o4P4k6Psy4N61J7RvSbxRAJmgsGGz+hK3tNWO6zUUysy1nU5Rv2GBj5QePnjkKJyOpzn0AYQ0kN3Iky/Q+uunrah/flM/cU1Iof5FBis6EZHjruSfNcSHdNk8EZppFgG7vrMpmIxZ/uKHBwkd69cLWE+fmObu8hOvCL431mscA0W9frQWR64FjPa8A2Bgo/h4YEYX940FJ0FGf8vAeNBs4s9bBowOz8TQLQG2B5dz8P/hVDMzG7K X-Bogosity: Ham, tests=bogofilter, spamicity=0.122572, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: This series includes only the remaining patches not applied from v1/v2, with review comments addressed. This series is based on the "contrib" branch [1]. Changelog: v2->v3: - Rebased onto updated contrib branch. - In patch 2 (patch 4 in v2), reordered error codes in alphabetical order, and fixed extra spacing in the EINVAL error description. - In patch 3, fix mistakenly copy-pasted "struct uffdio_continue" (should have been "struct uffdio_poison"), and alphabetically order UFFDIO_CONTINUE error codes. v1->v2: - In patch 1 (patch 5 in v1), change "after" to "since" for consistency and to be clear that we mean 4.11+ (inclusive). - In patch 2 (patch 7 in v1), reorder error codes alphabetically (EINVAL then EPERM). - In patch 3 (patch 8 in v1), resolve conflicts with earlier review comments. Original cover letter: 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). [1]: https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/log/?h=contrib Axel Rasmussen (3): 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 | 173 ++++++++++++++++++++++++++++++++------- 1 file changed, 145 insertions(+), 28 deletions(-) --- 2.42.0.655.g421f12c284-goog