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 7591BE8FDB0 for ; Tue, 3 Oct 2023 19:46:06 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id C0FC18D008A; Tue, 3 Oct 2023 15:46:05 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id B70328D0003; Tue, 3 Oct 2023 15:46:05 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 976878D008A; Tue, 3 Oct 2023 15:46:05 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id 754978D0003 for ; Tue, 3 Oct 2023 15:46:05 -0400 (EDT) Received: from smtpin19.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 48D4C14042C for ; Tue, 3 Oct 2023 19:46:05 +0000 (UTC) X-FDA: 81305181090.19.1DAFE0D Received: from mail-yb1-f202.google.com (mail-yb1-f202.google.com [209.85.219.202]) by imf06.hostedemail.com (Postfix) with ESMTP id 97383180002 for ; Tue, 3 Oct 2023 19:46:03 +0000 (UTC) Authentication-Results: imf06.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=E01ITjN+; dmarc=pass (policy=reject) header.from=google.com; spf=pass (imf06.hostedemail.com: domain of 3em8cZQ0KCPkbyfmsbtnvttfohpphmf.dpnmjovy-nnlwbdl.psh@flex--axelrasmussen.bounces.google.com designates 209.85.219.202 as permitted sender) smtp.mailfrom=3em8cZQ0KCPkbyfmsbtnvttfohpphmf.dpnmjovy-nnlwbdl.psh@flex--axelrasmussen.bounces.google.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1696362363; 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=KHojRgQcvHJlG3tNkbT5JYy4vaQ9RVgTVjOSA6AH+sQ=; b=WvOPshJFtMVZ++a1MIAo7tWqH6zf55zcD+49ihDee7H835O5fG6xakOSvACo3gjgBD4fpK 6iZuRxGbAzDpBgxoQh7WhPanmLVmPvR18VCyIKmVd6O1vCwSi/iCHbr23/YRStEDUHiGF3 5Sl8Cqv5lBD8LOQtlpa6PKz4RRgHmGU= ARC-Authentication-Results: i=1; imf06.hostedemail.com; dkim=pass header.d=google.com header.s=20230601 header.b=E01ITjN+; dmarc=pass (policy=reject) header.from=google.com; spf=pass (imf06.hostedemail.com: domain of 3em8cZQ0KCPkbyfmsbtnvttfohpphmf.dpnmjovy-nnlwbdl.psh@flex--axelrasmussen.bounces.google.com designates 209.85.219.202 as permitted sender) smtp.mailfrom=3em8cZQ0KCPkbyfmsbtnvttfohpphmf.dpnmjovy-nnlwbdl.psh@flex--axelrasmussen.bounces.google.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1696362363; a=rsa-sha256; cv=none; b=ckQ1jnkKx2rCEG2EnXK/KzkzJjVMUKmjMUmY9IvUSwFNoS8wKxfzdNisAtO/8BO7B7bGC0 N4MloriOVUKtwAQ45v9SJj3bTZxsvCroSxDVjTOM9y0qI5REOzw2WCu6ZCOHmVXKz/NW1F yPttYS3ZYRAA/MEepL2xZVVWOx7jYNw= Received: by mail-yb1-f202.google.com with SMTP id 3f1490d57ef6-d868842eda1so1720032276.0 for ; Tue, 03 Oct 2023 12:46:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1696362363; x=1696967163; 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=KHojRgQcvHJlG3tNkbT5JYy4vaQ9RVgTVjOSA6AH+sQ=; b=E01ITjN+ohmAq0nlSaiLcFZXh1XHPAI2gM76x2cstWeuC2km4A2Vazw412cuDPXPuI aiaDXYI6xNlJ56axvPxeAq0xOyex1ZrGLC6bIIfDr+6MbkxzPaY+nKhgOO07o4+z0Dq3 7bxOy7XraEvaeXsLFXl/Ju+6Nnji19Z9QjaS7RgnEk9aP3guNhXtauVSvU1FAkWOYMDY JclFYtfxlTOrB0BmBYXixZj4ROjmwG/O8XKZJSoXh865Xf/kQxwSQMY8uy65/dFYiXq4 8oyqWw8XRg+LaTYy3UdQe0uzgIJNd01DOQHgPAmfv8RIat7xxmWwlJHKKM0XrFJQ+VzZ zkXQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1696362363; x=1696967163; 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=KHojRgQcvHJlG3tNkbT5JYy4vaQ9RVgTVjOSA6AH+sQ=; b=RbYAJLeFD/FhpJ+0vGlM/kZP3l9KJ7BYq1/Qkn7n3bx+HveRBYtRO/Ej899rsoRtT+ l/yFd5d+qQon3ebagWAqPHG2jzZi9vOn8us/+QgNlCzmSms8i+msP/x+NDZr7OoUKmaq VWc63SAgma5P3cTrFErY0fEAzv1bqBEaUfqodMwDGQQ/TrnHehrscty+3zUBncBeVdyY z4S2Co0Ea4k95+sQb7iWqMeApDbVXNf7qOu3tIx2ULDYH165a7dJL8cg0J0/3nM2YUBP gfaxMqiy8+YcI1+7AASK/1iryI2hdwbR7MD115ua7cG0qEnsKvlvuevK2mIM9kFdQyWR HuMw== X-Gm-Message-State: AOJu0YyP5hPqN/1fW33H6KmZnh9NgYcQUiN5qQcfOIDlNmd8WigMGkV3 1ZFigXdy5FX0SDB+JrHRNXIynaQDmiYVAcqT9YGH X-Google-Smtp-Source: AGHT+IEqhtFQcshbqUK4gTfwcaeBbR5gxWj6j2J6NdanzQb0K4203DhX5lB+56HhQWq3zs1Ah3+xDDFNYZ8+YYbf0JmL X-Received: from axel.svl.corp.google.com ([2620:15c:2a3:200:6577:b8c1:dd2d:1c93]) (user=axelrasmussen job=sendgmr) by 2002:a05:6902:212:b0:d89:b072:d06f with SMTP id j18-20020a056902021200b00d89b072d06fmr3912ybs.7.1696362362806; Tue, 03 Oct 2023 12:46:02 -0700 (PDT) Date: Tue, 3 Oct 2023 12:45:46 -0700 In-Reply-To: <20231003194547.2237424-1-axelrasmussen@google.com> Mime-Version: 1.0 References: <20231003194547.2237424-1-axelrasmussen@google.com> X-Mailer: git-send-email 2.42.0.609.gbb76f46606-goog Message-ID: <20231003194547.2237424-5-axelrasmussen@google.com> Subject: [PATCH v2 4/5] 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-Rspam-User: X-Stat-Signature: b1zn1s6ksqcnw5y71chco7a8b87n77f7 X-Rspamd-Server: rspam07 X-Rspamd-Queue-Id: 97383180002 X-HE-Tag: 1696362363-555036 X-HE-Meta: U2FsdGVkX19mOaYi+YUeNXnQ7WdIVSDe0Q7COzXsrv35XGrjSvINoYuID8gAc5DlqxKfq96tucBo2USdZOuLBw7jDj450FIadBrIleFuC6wLGZLmbVoWWV6DGa65cFYIh8n/dqYWUmLfmNI9eXxQkpl0K37Ilzvm2/8sbBMhIdlp+CnngZd78/sX8riB8pcsWotcEshGK0v11696jiYTmSyBKXBGgECiXjsS5dqgu78nfWKlMILoAEusIIy0WsIunh5g2ANE5LHNJP3ElzjjgHfBbuJfxKzZEt97bx6AlHlsGpV+LhRMEFqQKOh9h65LuMhkybXejVUSoPCKVv/5oewTPJIBDUXMkz/mipaHagwkI7sIjv6VG/KsN1GnzASU0AQBFSQBWysoJXUFy8KOCBYCr35hgJpJuAK0EecHZeCr/vB9iEhvxKwEHpFGTa9OES88hLkpd3fLX0wz7n/+EY8NGgpm+bg1wLK0SpUtH2YJLkc2Op9zPJleJpDXvbUkY+BvGB/jeQBelomoCgLc/L7bW2G6HdIVFi3W2eBJH6Z9w/WqBzuuwUb0tBxZN19IjfTroFHgFVwYDoJESMqNLFfUeX862imuC11jtyAIP59n3hStrq3bFzvKeevf0vorjHGMSzK/rg/rAgSwYpzfoYiEuy8ATVn63/kMq0Dkvmy0oDVQV1TRyret3vG6Z6QMEUDyrvFGiuiqgFaq8ML5Wt6PSGkYjXPiPllKZ2ANSkrxKMcXjoClgYuk6YmPPVJBVv3a3ND3CAkSz8vX3cPSC13IzCZ2icw6HTPM+6RvyZ3SV0oid2Gki0sW9uPKY2BG0mwME6rWTIbdDEc2RQLA5aARcTpzTaOGZpELYFQp5pOnCVbyV0qFBT6JXP/zjasrWgypPp6mOG1IcMlEkTlICgisqDdZc5ut694KAooxKlSN6xyK/9MhV7fWQao0KvPuEJoOPwilGRMSKrl9Z4V pawXmqBv IEUWH3l/mpmK4XqAqnXb15tZWWayPzqpmwTasIfXqCv+cn4230gm6jdvVRXbdVBpCisy+ABYkdoXpuEGljINVCupvajSzns5XgE9pGmF6NmAtrq4kMHnFKrQLFiJS0hZZja9/1S6N91HGwSjVOxUn8H1fC6Ywp3Q7EToBG7EjdW9eMKGc9z5jlNQqjbypiA0sZEDVh6ATcKDarEjAUyL0rJAIfZTLj3K1HJa3FsKizvB/1f+q9yoCWOyyliSAQvuRayZk9QXIpZdLk1tEHwoBZzCjZP5cjeaLb+igWJqoo6n4SP7o9uXPDnaYpslENdgICLwX7qU7zz7sxD0cX36TJYloDulrk7zKsYOJu6lpXKABVjVhsKsyRynLm1XBw/dwSn1+TBQIE5Kns+4NZeU3fYq1s3kXBadLlnjiUCELwqRin9oRGCBcHqngH5KO0zvTUbgvwSzBh3TSvJHK74KCr3Gkd7vE+QzsmV2tmj2yP0FVU7CoVkdvcGhX8vj/BLsQR+uaBQIkJzpmhDYqTB2CLzV6TP30jXZLt9CL7aw68LBGutggZTjxLO0/5IwZDhlmBSOWmBcKL/6mLrLefv+j2krHEr8DpwG+ekYSxb2N6xRDzh0= X-Bogosity: Ham, tests=bogofilter, spamicity=0.005592, 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 2ee6a0532..95d69f773 100644 --- a/man2/ioctl_userfaultfd.2 +++ b/man2/ioctl_userfaultfd.2 @@ -388,12 +388,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 @@ -408,21 +402,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.609.gbb76f46606-goog