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 343D7CE79A9 for ; Tue, 19 Sep 2023 19:02:38 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id B9F7D6B00C1; Tue, 19 Sep 2023 15:02:34 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id B07D26B00C2; Tue, 19 Sep 2023 15:02:34 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 99FC46B00C3; Tue, 19 Sep 2023 15:02:34 -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 7E5686B00C1 for ; Tue, 19 Sep 2023 15:02:34 -0400 (EDT) Received: from smtpin04.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 41033140DB6 for ; Tue, 19 Sep 2023 19:02:34 +0000 (UTC) X-FDA: 81254268228.04.9D20193 Received: from mail-yw1-f201.google.com (mail-yw1-f201.google.com [209.85.128.201]) by imf02.hostedemail.com (Postfix) with ESMTP id 37D2780035 for ; Tue, 19 Sep 2023 19:02:32 +0000 (UTC) Authentication-Results: imf02.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=ww97wj1V; spf=pass (imf02.hostedemail.com: domain of 3R_AJZQ0KCH4czgntcuowuugpiqqing.eqonkpwz-oomxcem.qti@flex--axelrasmussen.bounces.google.com designates 209.85.128.201 as permitted sender) smtp.mailfrom=3R_AJZQ0KCH4czgntcuowuugpiqqing.eqonkpwz-oomxcem.qti@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=1695150152; 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=B/mBNxS046NndSUiuzLhVh8+as48kp1msWTNOB3shRo=; b=zCbalQJge6Ir4DWXrTIYq4xZtRP5XOCV7OJcir7/iwJ4YhlGRvVZxT3BcUJbNZ/id8GQCD TxBowFTQsiPL/a2g9uzDAEdLEtszVXcIk5hiKzOqoUB+fL+Tv/HWh0i80GFskFj7sbxbQQ WD58//ld0Wp3A640cCjWpDVSw4qs+lw= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1695150152; a=rsa-sha256; cv=none; b=K0ZPV8UJMZUXQUqYJYvO70M3X1HbI8vZM7EyyiW8F62X3IRZVhfuyu7s7mM9EUgsBY0j8B PMD4s5QngdJNZVt6wrlAOcskvDUvUKdocWM7VagYygS9EVf4WQSZCtq3SSMbtw6JQdAMHF 07i6Xz6TridKJiBqbpebiDyfzElhSNA= ARC-Authentication-Results: i=1; imf02.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=ww97wj1V; spf=pass (imf02.hostedemail.com: domain of 3R_AJZQ0KCH4czgntcuowuugpiqqing.eqonkpwz-oomxcem.qti@flex--axelrasmussen.bounces.google.com designates 209.85.128.201 as permitted sender) smtp.mailfrom=3R_AJZQ0KCH4czgntcuowuugpiqqing.eqonkpwz-oomxcem.qti@flex--axelrasmussen.bounces.google.com; dmarc=pass (policy=reject) header.from=google.com Received: by mail-yw1-f201.google.com with SMTP id 00721157ae682-59eea906b40so1362747b3.0 for ; Tue, 19 Sep 2023 12:02:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1695150151; x=1695754951; 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=B/mBNxS046NndSUiuzLhVh8+as48kp1msWTNOB3shRo=; b=ww97wj1VNlNpLwc99GsMJRMrlcx2BrR/EuDN+lXl24SlHxkcSDguc5bw/q9zonM3/J fqOFU1YfznfrAP4Xe4zCgpxhVW67uUcy3nX3wA6uSdi4wILwSKT/M9eLN2aMvVfgyM7a 7JRqVk5AppVwNTIJzwigvJP+AFoTMD+4O4O9lHpFQ3xARoPhW0ROXfv11wwqhucYVbJJ RSuf9tPXgpkz//2Ab325n0K2cZqWnnRsc5Ql36h4tdVQ6m27FILYRj+gajvK0ol1gC7B C49aW2OeyU8kdRmKi8yNCrO0DzODgA64pnBn6p5oc9Al3j/zB8H/D9hfTVOGoBhML3jW 8PDg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695150151; x=1695754951; 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=B/mBNxS046NndSUiuzLhVh8+as48kp1msWTNOB3shRo=; b=bK3a24zaWGoUarIPMFEj55/Tg/wrAxJEoPksKNQki5MTKa3g6AhOqsXrVBw3elXLoK 8AjbyotTz4jWBeAemdNSleQIL54uM3mKczHGVhbXDqM+PLCTBLaciOZVs3t6Zo1ExovC IiFSum9P+zV1U670UMTCpEcDxuDeLQjfBYGaOrnwg+l4VeA/EsDWi7WdOvPTRySQAL4E 6t/cM02LELy42sQAmAW/imNkxqCogLh9DAhWA5tFTbH6wFPcAnaRDrnG5Y9t9D8/LS/b 75QPer3ZN8bg3dYiXeDu+A2tMGJycYu/jyiPiQwxDPWwt/1OzPJ0b06B2v1b1IaTDg5e G4og== X-Gm-Message-State: AOJu0Yzv8ijHA3sdOe+2+BAa2A++2hZy2wOSvOJdcSyeyITB9a8YorfI Ess+8ApdTgzfrPMup4C1gbWsDnCd7uL/gBipUl9h X-Google-Smtp-Source: AGHT+IH7a8feDFG+W7LkkHL8xBQ33JOSLVkr8l24lseUZrRLYRoJu9ErPhz702o9Ru0cy8y+86WKdCJVmDC1f0ZBz4hx X-Received: from axel.svl.corp.google.com ([2620:15c:2a3:200:8f5a:6a6a:cafc:a3ad]) (user=axelrasmussen job=sendgmr) by 2002:a81:ae07:0:b0:59b:ba8a:97d0 with SMTP id m7-20020a81ae07000000b0059bba8a97d0mr6086ywh.3.1695150151389; Tue, 19 Sep 2023 12:02:31 -0700 (PDT) Date: Tue, 19 Sep 2023 12:02:05 -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-10-axelrasmussen@google.com> Subject: [PATCH 09/10] ioctl_userfaultfd.2: fix / update UFFDIO_REGISTER error code list 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-Rspamd-Queue-Id: 37D2780035 X-Rspam-User: X-Stat-Signature: a4kape4c77xe9wsogksb4u41eu1cwogm X-Rspamd-Server: rspam03 X-HE-Tag: 1695150152-686511 X-HE-Meta: U2FsdGVkX1+rM9KITmQWYsQfhC0PRrQQHTgq+RR7Ck3bgtrvZLr5pE8dT+ZdH79rGpX42ryKMcDG4LbiUgmo49BskSl87qApq5/7DITyzup/loAuV6Wk0V1D0ZLn1o1aJJDbx2Zf44JpeL6TOMZUoklaP94j5IhrRsv85siuXGbhWPQoRtSh4EUqMwyaXY0/m6VSOEVYOvkttPnGFD2lAoQnmxdFeUZBuKhI91T0KTIhvzeL4MkxxE144h0abSFPmFunOSYUCITsQNVH3hzjDR8m9WrWVwCdLZ9YZ0BqM74wfA40KmGZH1+5VoErqMeGxKYMcqA87ckCt3eu+0dGl7jlCydeNSwmTrpwks4b06EOeRBoBTP5wiRatt95lYa4gHY9ymDnd60UdW45mtgVwlKFPMZskxQ8liC3coY0Zlu4wtZ8aALfV1nBsSVJmEliTGquZcoT1MaH8imvfhWIgs0lDDBS93IkuR0NGSOSYbwq2qlQMrmJpIdQiwkkBCO6/DvRQ5vJzXiw3QEg16dHusnMCV47ZYZAwCgYzTwdK532ftd3xxKucaiW0lt5rKiZtRNPdO/MU4GssG1kOvRQsT9oqjN6COOapNEJECg5H79TQdDi83rlq8wlF3Zs1VC7esRcQjEvmOJU7/EueICGnNJSaNsvrjlk2Nb20nXmR65oy30vezeJ8xaKRN8MwTuelu+qJJ1FKexHKteFZdZDkuw2CC2gU/lTvJ1fJLfgpc/9jRbtlIWRnqVR5M36Q1m2AUkQy2x8LU6a4dh6pLzXWCi1QyYwm6Wrwmzfb92WWK515B2cDxLbmv5nfzJhmFcKNMTHGrKO6ZpWpyFFAas6EHdLBBuwqpL/zRL0eXGgjZfJTVr7L55gYbPH1ZeidYzck0CdUeoFMdvQEEqw0J8uRe/LJtFem3rY+1GmPtGD3G/eDYksT/+OjhfA0U7F7ekIUA8NcP2jpa7626qm5Gt JEubmyBm Ku9gVbx3+vhLvhpZMlZ2j2N6ysrrTZxpKQNfcpFMWrXc7NTLGPRlK9ssErzMDZ7K7zJ+foIoaXzBfriBLMHsLl+ZtbcW7iaIaIDViB3oefqPDnbpQZQaUX1Ti7IexpUuIV6JRpg5LP2fjEVtguoBOFHq//Dl5HIj+HlRoni1EJjPm0/WcFTMZDOPnl5Z6JsSbK0ssGDhibFilc+EbWUm+ZZ2uWPNayJj6cGjWTzqiIKuE4hZf9w6t/HUJUvIoRYrZ5CWMGBxqmFOzNXXflsEF5XB8+taGgAMD+WlTEwaVSdEGSbVH+Qy5TkXnp+njyPuppJeNNr8XdkU+KpTQrg5kebaV8P8KsUO6Xz1ogstz8xaSGZs1BgFspdJ2wre0WAgyNOnVMdHS3zMEwNCi7k7md5ipiNtMhhlBvNKxuSems79VuZsI6JxiaXQc5VDmoN07HHEat0zS3wylkEtsSFDcDT9It7DqtIDyVSy2ndb/BcAjREren7Xu5GRSk+mcA7hdoNSzxSXVMbAEvbPxsVKmHgpqvV+erWc9TiZhtBBQR4G/fcWqSVuPZak1vGjGCnEtetZpN0bGBz8RpsCPk0lVW//ANbZidSY9GpvGt9xqNaK8EZy2B7mPm5CGLyuLMgRhLCFBjxq85JBK0XQAMAx9OfooCl3G28RDxxtPn2pty8uTU6ONYTXJefiX85NThgM9NZyoUjCZXGGsrCY= X-Bogosity: Ham, tests=bogofilter, spamicity=0.057216, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: The list of error codes in the man page was out of date with respect to the current state of the kernel. Some errors were partially / incorrectly described. Update the error code listing, so it matches the current state of the kernel, and correctly describes all the errors. Signed-off-by: Axel Rasmussen --- man2/ioctl_userfaultfd.2 | 37 +++++++++++++++++++++---------------- 1 file changed, 21 insertions(+), 16 deletions(-) diff --git a/man2/ioctl_userfaultfd.2 b/man2/ioctl_userfaultfd.2 index 29dca1f6b..afe3caffc 100644 --- a/man2/ioctl_userfaultfd.2 +++ b/man2/ioctl_userfaultfd.2 @@ -413,12 +413,6 @@ On error, \-1 is returned and .I errno is set to indicate the error. Possible errors include: -.\" FIXME Is the following error list correct? -.\" -.TP -.B EBUSY -A mapping in the specified range is registered with another -userfaultfd object. .TP .B EFAULT .I argp @@ -433,21 +427,32 @@ field; or the field was zero. .TP .B EINVAL -There is no mapping in the specified address range. -.TP -.B EINVAL +The specified address range was invalid. +More specifically, +no mapping exists in the given range, +or the mapping that exists there is invalid +(e.g. unsupported type of memory), +or the range values ( .I range.start or .I range.len -is not a multiple of the system page size; or, +) are not multiples of the relevant page size, +or .I range.len -is zero; or these fields are otherwise invalid. +is zero. .TP -.B EINVAL -There as an incompatible mapping in the specified address range. -.\" Mike Rapoport: -.\" ENOMEM if the process is exiting and the -.\" mm_struct has gone by the time userfault grabs it. +.B ENOMEM +The process is exiting, +and its address space has already been torn down +when userfaultfd attempts to reference it. +.TP +.B EPERM +The userfaultfd would allow writing to a file backing the mapping, +but the calling process lacks such write permissions. +.TP +.B EBUSY +A mapping in the specified range is registered with another +userfaultfd object. .SS UFFDIO_UNREGISTER (Since Linux 4.3.) Unregister a memory address range from userfaultfd. -- 2.42.0.459.ge4e396fd5e-goog