From patchwork Wed Nov 9 16:31:12 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dariusz Sosnowski X-Patchwork-Id: 119619 Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 32C52A034C; Wed, 9 Nov 2022 17:32:20 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id EAF5040156; Wed, 9 Nov 2022 17:32:15 +0100 (CET) Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11on2057.outbound.protection.outlook.com [40.107.223.57]) by mails.dpdk.org (Postfix) with ESMTP id 9B834400D4 for ; Wed, 9 Nov 2022 17:32:13 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=jwc3O2U6XVB32WOxPzazqGlSVdOuO6fspkRpRh63x1IX6JhfRJCiKzX198wYfEM2t7UlHYEURVS5P/uYHyXJobTEjqC0uiPcZC+0PmY0y1TbOhG8l3oqNL3brA22GLnY/x3r3Ru8uA5zG6VsJ1+Ec+/zl/jDSCK05kNyh17giEPIftZCnBs76Y55acH6bgSenZkEfzBNFu0b9E9FvcULJvJ6RV3p2vWei3iAAI0Zq0ZchEYjUyoPoNwvKvS/+omAeivo+9h/Zf3JpaPfQH019o2sW5MZkKHS62pBb7XrKbE3JFBap3QjnP8FA9CubypAkWzULO3p/p7G2owotbhVfQ== 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=8fTjANIG2GT9FNW0LRMia65xNYq59WMsroQmfYh2gkg=; b=kw+VcbPYF9yK4ISYi76134Y0eh4UYYNG4LOKaA3jKTm9hu3bqmUOq32JcxOnHdX2gQ4VwFAc/fHtKLWOutzpUFngTXJcNd1+uvfs6tc6xGualbg8f64EIn7u+E2p9JGXf7ZUe82pE1R1jOIDWvxQar9+gb2NqedqZ88DS8LgwrmFjABErnHAim8nSWGaurEfNn70fpBucbtyoz7svEFP6LnobhwzIj6HvfA71p6KTgCTXsX9SyLak2/HY9oFVj0y3AGHRQmK67YOwBe92EUZnmIV0w3etlkTIVbdbPdk+tulUbhOBM376ZjYoFbV4fQLiGnZ2k0sjY+9MJltDPWqcw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) smtp.rcpttodomain=monjalon.net 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=8fTjANIG2GT9FNW0LRMia65xNYq59WMsroQmfYh2gkg=; b=SpfVjLE+dUyVI/7juI+hOpPPi8CRkHMkUTW4r2y6O845Efeg98M4SndMzajJjak23J3pjKdOfD7hStZXaOprc/Rnuvxgbfgm7d+AWwZfjkLOZRT0JV29T3mAineWAiSf3suZTOChhMDleNU0SLjfpqtx4vc9goQE4q0Bnkspze6y4RDkAh/z0/mDQ0y01xUi2t7Gk47BTEyHEI5jIaPxbqgSOSlcAUHq9/v7Q0plwmuTVDC+wSm6V52/qwRm6+pzhFkuxgVFvRkbt1SK6E+HUdcfofhSx9QgUoMx0NYk2o7I5gs34AV1og8Ftr0ZunlAWvLITLpe21pBDC1/DvXhmQ== Received: from DS7PR03CA0065.namprd03.prod.outlook.com (2603:10b6:5:3bb::10) by CO6PR12MB5441.namprd12.prod.outlook.com (2603:10b6:303:13b::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5791.27; Wed, 9 Nov 2022 16:32:10 +0000 Received: from DM6NAM11FT052.eop-nam11.prod.protection.outlook.com (2603:10b6:5:3bb:cafe::bd) by DS7PR03CA0065.outlook.office365.com (2603:10b6:5:3bb::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5813.12 via Frontend Transport; Wed, 9 Nov 2022 16:32:10 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.161) 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 216.228.117.161 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.161; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.161) by DM6NAM11FT052.mail.protection.outlook.com (10.13.172.111) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5813.12 via Frontend Transport; Wed, 9 Nov 2022 16:32:09 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.67) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.26; Wed, 9 Nov 2022 08:32:01 -0800 Received: from nvidia.com (10.126.230.35) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Wed, 9 Nov 2022 08:31:59 -0800 From: Dariusz Sosnowski To: Thomas Monjalon , Ferruh Yigit , Andrew Rybchenko CC: , Aman Singh , Yuying Zhang , Matan Azrad , "Viacheslav Ovsiienko" Subject: [PATCH 0/3] ethdev: document special cases of port start and stop Date: Wed, 9 Nov 2022 16:31:12 +0000 Message-ID: <20221109163115.868939-1-dsosnowski@nvidia.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 X-Originating-IP: [10.126.230.35] X-ClientProxiedBy: rnnvmail201.nvidia.com (10.129.68.8) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6NAM11FT052:EE_|CO6PR12MB5441:EE_ X-MS-Office365-Filtering-Correlation-Id: bdef4728-5c8d-4fc8-520b-08dac26ff2f3 X-LD-Processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: b6T0Shx6y84DLLx4X92lK0PB+MvzHY52shCwWbku1uPQ9n5qXH/ET0XS1gclDwF4kpOblUPadirNcgtFHzDrX5+H1x6ug+UvA1Sf2XdfUzrZBJMmcsvrJ1g65+3pmvMYkvjplmHllhkQi9CIRH1tDcfLSwWBIvssNZUDvOI0QDtzhohSbONUKZ9QkHn748as/bEMVFbNTIpOfU8MQM526JZIFSqF4oO15r6nq6sKAIPoemYdxPEWEry48TV0JsgOYsiLx4v13oQFcg+Uq2QgTos9CBjrLeSxaqVlC0nhYU/5GqdKPpiwKPMJqX7QT3lfb6VV8cHEWXgJJ1SHYTLXsGG8Lo7GptqCeUsdUe6fruUiTJZ0v1t1QUOmJd1yA0v/wKxV3+5fmzPzaOhxodSLPoWxp8KdEJs8TIVcNfxp8c0fW+xSSgZ9btrgyqxDDDZFIVGlEbfJxOVe9eJRsjidv0J2s4lfojmaUMcsOXtSKCOmUpcejfFEcb6elkfxcaIro/SYPDRL598IMkfs1fYQDgGiqsNQZCVGNYzO4MI78WzuYDt2w26QfndTsTMWIfExMo7GTnKpsOu0LdRIFuoW7GfoxsV0OE3Xw05zLVK6RVsNA+Pkx+q1CFKkygFRQ54DkSk5i7L0N8iskd2eh9TEknd//3ZJDIbf41YAik/RVGxRMXU642/1emR0x7HRcZng5Oeaqtv50BHDAzCaEp9KCunO8psnQDeqmSpnrZ4mVKZsCQwndfkNMTs5WGF64cXLvWMBy7wz2ae9x+sEanGalw== X-Forefront-Antispam-Report: CIP:216.228.117.161; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge2.nvidia.com; CAT:NONE; SFS:(13230022)(4636009)(39860400002)(136003)(376002)(346002)(396003)(451199015)(46966006)(40470700004)(36840700001)(186003)(16526019)(336012)(26005)(1076003)(82740400003)(426003)(7636003)(356005)(83380400001)(47076005)(4744005)(2616005)(6286002)(2906002)(8936002)(5660300002)(55016003)(40460700003)(41300700001)(7696005)(40480700001)(107886003)(6666004)(478600001)(36860700001)(82310400005)(4326008)(110136005)(8676002)(54906003)(316002)(70206006)(86362001)(70586007)(36756003); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Nov 2022 16:32:09.7975 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: bdef4728-5c8d-4fc8-520b-08dac26ff2f3 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.161]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: DM6NAM11FT052.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO6PR12MB5441 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org This patch series attempts to address the special failure cases of rte_eth_dev_stop() and rte_eth_dev_start(). In case of starting a port, If the port depends on another one being started, PMDs might return (-EAGAIN) to notify about such situation. In case of stopping a port, If the port cannot be stopped, because other port depends on its resources, PMDs might return (-EBUSY) to notify about such situation. These cases are addressed in ethdev API docs. Testpmd is updated to allow users to manually retry start/stop operations. Dariusz Sosnowski (3): net/mlx5: fix log level on failed transfer proxy stop doc: document E-Switch limitations with HWS in mlx5 PMD ethdev: document special cases of port start and stop app/test-pmd/testpmd.c | 10 +++++++++- doc/guides/nics/mlx5.rst | 13 +++++++++++++ drivers/net/mlx5/mlx5_trigger.c | 6 +++--- lib/ethdev/rte_ethdev.h | 9 +++++++++ 4 files changed, 34 insertions(+), 4 deletions(-)