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 bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 18131C54EE9 for ; Tue, 13 Sep 2022 20:02:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:References: Message-ID:Subject:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=sCfuqq+sKUawevXxSCIt9ZZuUi9Xa55H1nK1WaHHjbA=; b=vtu1wYKF8Tuwmn 4zcf1e4qW4ESfVAKIqIqLtwev020k/EkarsRPLEGmct74XcabuN0hkRHw4h7OFfeYOgIvLsNN02Yg 7gMZXXX/3Lry9C1TFpF6q5sQOBjghUXIiNxdIQ/gChORaIpWSP8NYrDkFB5KWlL+JYC9xOLMLuMvY 69sWI+FOhDc84hItujVmUjTpzS16GaMq7Vwx9hZU2Ft5tI+XF2M1HNI3MeSiN73FbCPBHJkRHU8Ni ofXxDfVxCyfb986wvPGlcg06pJI1qf/B7sbSLvTEN8Q1B6lP4EE+uTzOn2Lv9M9dBSBwuyTuh8vIk 8xcmmV47upj/HWIv0zaw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1oYC5J-00Fpkv-EQ; Tue, 13 Sep 2022 20:00:41 +0000 Received: from mail-mw2nam10on2043.outbound.protection.outlook.com ([40.107.94.43] helo=NAM10-MW2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1oYC5F-00Fphw-17; Tue, 13 Sep 2022 20:00:38 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=IKl+kBKusRFW95Nnme1cfOx21ZWyCX8EvWRo0dfrPJ5uk8kXx3h9epnQH8pBEklOLUJ5qYm6ol8hRnEX2RgSFuHCG5qnCdzRl1Y9l1MrDqVZ6w3Q1dg8ZxsatHt7k5/PShoF77aR9fcSByTJlGXklIjKDIt7GMHHR/ZOqlTAJ2KsICtJcYKanaXKFKyd0zuhavg/6yy7QfFzXk5k/mZ5neqgcihIsvHQ8F5dNhN56mBomylMHvEZkrxDsotEJgVn1eQrbJCrCOsj7BvGjRsW0UsgoIrSeD9ITXmEJ7H+JQ6XPLnLJIkdyZYzNfsBsqIPkZCthhGrmqy+BcptSvrR/A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=IZfGFrNYfckX8y7d1ap8+ifboVX6qxI8DDXWoZjUUz4=; b=gjwKV+fxfudWoeeAI1++r8CuvMoWjtxtBzwg/ZuQP6gX6W4yV9gmo8R2k+GDNu8+67uKNEPN6T7fNveR6gZRoDujtgX94jsjap5/PVxUxLx1GXTz1yHQd9yXDuCeQ9Y670Qq6iVbW3lxkjKyyu0e2E670qzzGB+lKzeCCM+85GaH9m30Php7thkk2nJrjqobpDZhYPVZgI/esQc4yJI4zBP1wUeRPOc0SwDZqpIkEKm0KHKFmjnFNk9xOP4UsdmhuQdpCca/zDyqZanQintMCHJFtkYwVd3KxNug9D9TE7YYMF71Izm0XREmsVMSw0SJe7qXSGh4JwAGvG9xvs16RA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.238) smtp.rcpttodomain=infradead.org smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=IZfGFrNYfckX8y7d1ap8+ifboVX6qxI8DDXWoZjUUz4=; b=e3tqAY7JPDkmFU0NBEaLIxvqvigQut/jhYfOWrHJOch/tdHLGbHnb++Cu5XQn6awt2CHq7GB4rBHxyz3ByZxSJPcK3kUGX6EyNphOg+V1SMZ4n7LbuuZVu2wPGY4WjFPzYHi0AbudFX85L64xYwcEaI2KJHzmjvzPg+ySiNBKj6jRDkD61zoTbAE3u2xCx7og3QRA/p1Rf+Fmdsp+ls09t6bRtM+ge01ZucuDDmGXYkfJ25vhkSYIzjKZTXVSpoq0+GaBRYuB83mIArpsf8Qz7aWVWE146Z51X0fQ0Uav66WncZGNrXSguvrSrXvMyON7PD7FQmc5KQp5xjyDKtInA== Received: from DM6PR08CA0045.namprd08.prod.outlook.com (2603:10b6:5:1e0::19) by DM4PR12MB5167.namprd12.prod.outlook.com (2603:10b6:5:396::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5612.19; Tue, 13 Sep 2022 20:00:31 +0000 Received: from DM6NAM11FT040.eop-nam11.prod.protection.outlook.com (2603:10b6:5:1e0:cafe::ee) by DM6PR08CA0045.outlook.office365.com (2603:10b6:5:1e0::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5612.12 via Frontend Transport; Tue, 13 Sep 2022 20:00:31 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.238) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 12.22.5.238 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.238; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (12.22.5.238) by DM6NAM11FT040.mail.protection.outlook.com (10.13.173.133) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5612.13 via Frontend Transport; Tue, 13 Sep 2022 20:00:31 +0000 Received: from drhqmail202.nvidia.com (10.126.190.181) by DRHQMAIL105.nvidia.com (10.27.9.14) with Microsoft SMTP Server (TLS) id 15.0.1497.38; Tue, 13 Sep 2022 20:00:30 +0000 Received: from drhqmail203.nvidia.com (10.126.190.182) by drhqmail202.nvidia.com (10.126.190.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.29; Tue, 13 Sep 2022 13:00:30 -0700 Received: from Asurada-Nvidia (10.127.8.11) by mail.nvidia.com (10.126.190.182) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.29 via Frontend Transport; Tue, 13 Sep 2022 13:00:28 -0700 Date: Tue, 13 Sep 2022 13:00:27 -0700 From: Nicolin Chen To: Jeff Johnson Subject: Re: [PATCH 3/5] iommu: Add return errno rules to ->attach_dev ops Message-ID: References: <20220913082448.31120-1-nicolinc@nvidia.com> <20220913082448.31120-4-nicolinc@nvidia.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6NAM11FT040:EE_|DM4PR12MB5167:EE_ X-MS-Office365-Filtering-Correlation-Id: eb3b88e3-1aa6-47b3-b11a-08da95c29cc4 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: SDYPSxfbai2zCo+qcmdiJ9xYaB1OPrc6aYYh/UsRMNreDfAp9rdHFG2RyhT3wOkax7xznsaoXFUeZh7p4ymv3Mv1hBLegPWgFMtQICmXJvF7o0LSwUCgRBA/xkT2pC60scXt6jjRdGvs2la+NyWeOXbL2AKZjJMiiDZpy0cu2JJrENGcR1URIfxLV3dDLrBqbppQEb9eJQbJrOm3KQ4F6M29rYworgAye1JVsCjBXGLym8oF1JfTApfwxGQm86qilgzIiQN7drwX0SpmvS6/WPbhR3fsDqVwUeaO2hXQmeqHDLVcMQbVTlsLlHB9TruRqWX+oHOdpEjvdxJXXp+B3J/56l+VmbgRj5r7SX2jx6aHY6WAB42ZFyJ4QZcJDmOPD1jAHCDOftYTmrCmvCblwP3vdNuYtuNCFEEWygvu4cLMIVUbViOVZjFPcAemhbZYxJmYqkdltZv+e2rFTnqRMU1p+NRoWmLCNu2ASlxBi9+ofw+mDTBSkvCqQDiWEnjtM+fy/IaiOIXLkmyHGA8cRGSHOauPw0DhFFWsUswF14Qs14Pb8AhBBhUu4mHt2elsuc5j1Z1suV8fTPl7m6w1dXaJmoqQHp3maKJ8fAaFhEGjt9sS9KO7zvxOhTx4npAayyzyLaL2wA18cRkueLQ1LJfIszNK1f+SciFTHpIPnzk1eFVclewVU1ry8w6brYQkXiismmJz5C5Z1/PMANkDWvbet53iJkVJu5efTAvUxwMFpk1zXWc58Hp3YECKzixYhVsTTBTRd0xos4apFJlf3jytQOifTw7OhAJa1Pf3/nxfotASH36diEhNVliGai0aUBSsFxvm/xcxx3R2FR4dhiInmgxm3wU2S3luXeEwFiaiKhjFpQIVrknQBRj59/ZC X-Forefront-Antispam-Report: CIP:12.22.5.238;CTRY:US;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:mail.nvidia.com;PTR:InfoNoRecords;CAT:NONE;SFS:(13230022)(4636009)(39860400002)(376002)(396003)(136003)(346002)(451199015)(46966006)(40470700004)(36840700001)(7416002)(47076005)(186003)(9686003)(40480700001)(356005)(82310400005)(86362001)(81166007)(41300700001)(316002)(40460700003)(7406005)(36860700001)(478600001)(33716001)(54906003)(82740400003)(8936002)(6916009)(70206006)(4326008)(70586007)(336012)(5660300002)(26005)(426003)(8676002)(55016003)(2906002)(36900700001);DIR:OUT;SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Sep 2022 20:00:31.1582 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: eb3b88e3-1aa6-47b3-b11a-08da95c29cc4 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a;Ip=[12.22.5.238];Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: DM6NAM11FT040.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR12MB5167 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220913_130037_173238_1D386324 X-CRM114-Status: GOOD ( 21.77 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: heiko@sntech.de, konrad.dybcio@somainline.org, bjorn.andersson@linaro.org, linux-tegra@vger.kernel.org, thierry.reding@gmail.com, will@kernel.org, jean-philippe@linaro.org, zhang.lyra@gmail.com, joro@8bytes.org, jon@solid-run.com, jonathanh@nvidia.com, linux-rockchip@lists.infradead.org, iommu@lists.linux.dev, agross@kernel.org, linux-arm-kernel@lists.infradead.org, jgg@nvidia.com, yangyingliang@huawei.com, orsonzhai@gmail.com, linux-arm-msm@vger.kernel.org, robin.murphy@arm.com, christophe.jaillet@wanadoo.fr, baolin.wang@linux.alibaba.com, thunder.leizhen@huawei.com, matthias.bgg@gmail.com, tglx@linutronix.de, virtualization@lists.linux-foundation.org, yong.wu@mediatek.com, dwmw2@infradead.org, linux-kernel@vger.kernel.org, shameerali.kolothum.thodi@huawei.com, robdclark@gmail.com, suravee.suthikulpanit@amd.com, linux-mediatek@lists.infradead.org, sricharan@codeaurora.org, baolu.lu@linux.intel.com Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Hi Jeff, On Tue, Sep 13, 2022 at 11:41:35AM -0700, Jeff Johnson wrote: > > diff --git a/include/linux/iommu.h b/include/linux/iommu.h > > index ea30f00dc145..c5d7ec0187c7 100644 > > --- a/include/linux/iommu.h > > +++ b/include/linux/iommu.h > > @@ -266,6 +266,17 @@ struct iommu_ops { > > /** > > * struct iommu_domain_ops - domain specific operations > > * @attach_dev: attach an iommu domain to a device > > + * Rules of its return errno: > > + * EINVAL - Exclusively, device and domain are incompatible. Must > > + * avoid kernel prints along with this errno. Any EINVAL > > + * returned from kAPIs must be converted to ENODEV if it > > + * is device-specific, or to some other reasonable errno > > + * being listed below > > + * ENOMEM - Out of memory > > + * ENOSPC - No space left on device > > + * EBUSY - Device is attached to a domain and cannot be changed > > + * ENODEV - Device specific errors, not able to be attached > > + * - Treated as ENODEV by the caller. Use is discouraged > > It is my understanding that kernel-doc won't preserve your formatting > without extra directives. See the "Note" after > Thanks for the review! Perhaps the following one would work: diff --git a/include/linux/iommu.h b/include/linux/iommu.h index ea30f00dc145..14f078b58e17 100644 --- a/include/linux/iommu.h +++ b/include/linux/iommu.h @@ -266,6 +266,17 @@ struct iommu_ops { /** * struct iommu_domain_ops - domain specific operations * @attach_dev: attach an iommu domain to a device + * Return: + * * 0 - success + * * EINVAL - Exclusively, device and domain are incompatible. Must avoid + * kernel prints along with this errno. Any EINVAL returned from + * a kAPI must be converted to ENODEV if it is device-specific, + * or to some other reasonable errno being listed below + * * ENOMEM - Out of memory + * * ENOSPC - No space left on device + * * EBUSY - Device is attached to a domain and cannot be changed + * * ENODEV - Device specific errors, not able to be attached + * * - Treated as ENODEV by the caller. Use is discouraged * @detach_dev: detach an iommu domain from a device * @map: map a physically contiguous memory region to an iommu domain * @map_pages: map a physically contiguous set of pages of the same size to _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel