From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 8AC54A034C; Wed, 9 Nov 2022 20:08:01 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 668CE400EF; Wed, 9 Nov 2022 20:08:00 +0100 (CET) Received: from NAM11-DM6-obe.outbound.protection.outlook.com (mail-dm6nam11on2050.outbound.protection.outlook.com [40.107.223.50]) by mails.dpdk.org (Postfix) with ESMTP id 2B0E2400D4 for ; Wed, 9 Nov 2022 20:07:59 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ef5zKsS3ivH28sSwYs4AkVoJKeJfFUbltZL/crkJ4U0nYljPgmiI/0o4QhmCFLgh8dXN+YHTfPcpNPH+HJDb/0yUNT7kVycUkhf/2CIab6UNIdRr9Uf/hAJ1mJtmS4diS0cPM+KiaT+45/aV6rjh67Kph0jklUDnImo/0yh4iZh4LQI180cQ9eCGDK2RW5/hsG20y4rbaqLskL8ITwrIF40CVUh4xTq50WFuNmIaIYz2hyaLMZDyO8n7s7Q0OdFj3fES+fxIGTRW7Q8bef+DoNB0G/6ivdDvj+aljhFdf2m5eo6K5Xf80p1BIquDW9m6BfyIMAQV7Tu9NSlALb0HLg== 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=+9YorDvc+hGMnREDVwSxr/FQuDeO+vOds1A26eEdGGE=; b=MmPB41w0JfLrrxXyz0L2lF9RfSn1G2sNLnJAboY1eg6Dy8cO6gDc+O1w4XyZunWJaBr7RlE4pluf4eIbNc7Cz7CNgaFGL4/bkk8h9DpiHYo22z8VFJLRbrJWPv/mazwJ9ZIwuV4vt4fm/bfKALLsRvdwlrHArEJ8ENmPr5XHKnkld93s2YgwgclzYhYZkfZQPllPT+lcZz0RkHBNxChCVwxH09HIwX0x4ttn3AJijzXjvFw7QxCWRNjMqGswB/ybnG+oAlrbVmBBBxdt6ejdufnJymKcXRkfmDZNJCnA/Mnj44vupyAFY99NGUGzGpxui1pnIuim2tYrAJYoGWeVow== 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=+9YorDvc+hGMnREDVwSxr/FQuDeO+vOds1A26eEdGGE=; b=oAq+3N8ua5eZk6yOsNVQbTO7oKudMcZR2Q6cALTa99N+FYchzSc/hiG9Uljl/fM1GyS90PWwAN4voDHSqtJBmlNavjeljFxUcjHYqqJV9Y5RFYnwPx7nbmKfpjbc3+bqyz9CEeqJ+HaisWycjLab1kqK9i/3O4rmKrklt1yEA4AYuYZ06+svmu9BhQeJPuUgdlsWZDEPsOY3MKSjZ6HA1PCVBa8c8SrCl+wJ4PvbQJPEWVOkQv5OHM/MGO28HuHnIQc0zMJxIML/zKOUnySI1+ze4KnO14KE2VqC1VeXg07IIOQsGaIotJ/BVXXsb58FhPesBbYpNx8dWF69gVN+1A== Received: from BN9PR03CA0421.namprd03.prod.outlook.com (2603:10b6:408:113::6) by IA0PR12MB7652.namprd12.prod.outlook.com (2603:10b6:208:434::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5791.25; Wed, 9 Nov 2022 19:07:57 +0000 Received: from BN8NAM11FT092.eop-nam11.prod.protection.outlook.com (2603:10b6:408:113:cafe::a) by BN9PR03CA0421.outlook.office365.com (2603:10b6:408:113::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5791.27 via Frontend Transport; Wed, 9 Nov 2022 19:07:56 +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 BN8NAM11FT092.mail.protection.outlook.com (10.13.176.180) 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 19:07:56 +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 11:07:44 -0800 Received: from nvidia.com (10.126.231.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 11:07:41 -0800 From: Dariusz Sosnowski To: Thomas Monjalon , Ferruh Yigit , Andrew Rybchenko CC: , Aman Singh , Yuying Zhang , Matan Azrad , "Viacheslav Ovsiienko" Subject: [PATCH v2 0/3] ethdev: document special cases of port start and stop Date: Wed, 9 Nov 2022 19:06:36 +0000 Message-ID: <20221109190639.886457-1-dsosnowski@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20221109163115.868939-1-dsosnowski@nvidia.com> References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.126.231.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: BN8NAM11FT092:EE_|IA0PR12MB7652:EE_ X-MS-Office365-Filtering-Correlation-Id: 56b27760-51d1-4dce-cfbc-08dac285b61b 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: cpd6qRNS+B50mniW9qZSbzWCMQp58Z+lbjmyva6SdsGKiop6FL3SpPY9RKdpmtBma0KgrFYs14ptPuWrRgCDWuTzj9ZnCyykoEnzk1lqHIPLzFg/EDWHnBLLVJj540sIIwiQ/hHNeUdJQZEqgBm21WDI6XTayErLq5Wg9UrIdZpoZjB9SqZwxtR8WA9rPq4ZRy+JCbJKY5DFRRk5UZ2rOtBUSzsLLiQkndkDPA/tz1dJKXtRfCUmjn34PS9D8CHlVmEBzlz3bs2gT8FFBvVZPV2AxdMeMEr/pphd8nVVuLlma5ipkKY/h3P6WaIjdAMZR2tnZAjVe4iFS4qgVqlZKOBbjDp+oER2mezV+I/MCeEVyYCxN3KYzuWHpJgva7+FDOe4K14fzuD8oZ/Q3iV1i0IOs7N5ECBZgoE0AmsTBIms9zhYg/v2RyYZ3Z9VWPBApFrC/GfhaxWjVKiWTRcs5KmjibijzVpA9hvBuM775tO6DrBHx/khm3V6WmiroCwCgTfrpgqVGhrROVyp0EQkHEkHHgVBNIU8bAnpBINHFp/PQLL8viyC4byL9YtSGN3Cmn+iJK+bD7eQuESa7/groAyWqCpAedS13eVm7XB9iw1H8APiz+sxsB1JI6wiBLPW/GPYEd9S2UADfMXucQAMfQgvGyp6Fb4OE38+vRfMAdxZ820D4DWE2hppsIXLP23+gjrbmPLLAHG1uMO1c+U17D+lc/kIzSvFvm6CRKlsB/pALQToIkL6EerIpAuaHKk1bcYYxkHJvzStawO6MH2ql+VwXC6Ob3ZpUCMDVoyC3GT0xRYB4hiZYyzb/3ymwYCB 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)(346002)(136003)(39860400002)(396003)(376002)(451199015)(46966006)(40470700004)(36840700001)(336012)(4326008)(47076005)(426003)(8936002)(8676002)(70586007)(36756003)(26005)(7696005)(16526019)(5660300002)(70206006)(4744005)(186003)(1076003)(2616005)(41300700001)(82740400003)(86362001)(82310400005)(356005)(40460700003)(7636003)(6286002)(83380400001)(36860700001)(2906002)(6666004)(40480700001)(478600001)(316002)(55016003)(54906003)(107886003)(110136005); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Nov 2022 19:07:56.6030 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 56b27760-51d1-4dce-cfbc-08dac285b61b 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: BN8NAM11FT092.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA0PR12MB7652 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. v2: - Fixed documentation build. 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(-) -- 2.25.1