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 62BE0A0093; Mon, 14 Nov 2022 19:21:02 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3E1E342D0C; Mon, 14 Nov 2022 19:21:02 +0100 (CET) Received: from NAM02-BN1-obe.outbound.protection.outlook.com (mail-bn1nam02on2077.outbound.protection.outlook.com [40.107.212.77]) by mails.dpdk.org (Postfix) with ESMTP id E228A40150 for ; Mon, 14 Nov 2022 19:21:00 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Jb+fwl2ssM/5VsIRxmKTkLx8OKD7KWzqMEt+FUMPtBwy3cBGVMb9/aNcb7RTuJ3INbT5qnLrhPTsXA7+c2bohoWFVZnbr8zMavayP541pmbVG56mnZ8yO6TUWqevCNNxE13G1GRXguFEkOxq6mNWZDkpCndBoASsrrqFJ6JQAXjQkKjp9TTNw+R5zCzFPJX5VRdUalVhemm/1UJIffpYMWLarrnpuGXrzkLxc83tR1yzY54Vq3oyI+6Sa3wWVyKvv07BuhozYPwayXXMByURA8TDKI9m7nMmbUngZe7EBuqeHwV+ka5bzs7Mwn8k7dP+F/plCXnpEHYnB8H+0AwDNg== 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=QE6R6+ZTftKvTFmCY4F+Vfa5hUml26u6NUu5f0BzpI0=; b=LgaQIedrfxb8+GzBgA4BBAoAPZNhAp7agyQlQRRNLaLBG1B/B/AMa4TP4ZJTrSJKWryKtTsELYoXFtH1/9Q76WIwur83XNN7Y+yV+XWTN/fXFfV2O0hrIVVDBpO5ly3hvPEQXpvBNUtUpMK8F4bkgvYIupktLrHB6cSgqCfzxACCR/YLZMgl3P7jBviW9lwFpgOO6WCPyVNUkhKxG5Xbe6wvvKD6NDUcbx8D6O96WxbKOwTFbke+YDerBsQT1T7aS+bZZIvcBCtRGTPFPNGndDI13N8YK/1T3rkuEZ3FHCmwkyxiXWKOjW46yTl4kF0b9QBkM4lmBVCSLHv/3g2e/A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.160) 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=QE6R6+ZTftKvTFmCY4F+Vfa5hUml26u6NUu5f0BzpI0=; b=USaQrzqqr1fru4UEufWD1+Dk6k5Gc8ySxkid0TH4+islokqxAjBg1xgdG2hGHOcHU9J2a7mJ5K9P6dSvzn2xFCpVHtUi3fqvxemgiVkizEFZjihZM75Iz8ciLSRTAEOW+2pCOYWoZJAVpmJgJiFUNqZfbh3cRn0vLgCnkxjl5qZ/AIhbmXzx9DG/9cPx8jxQxkCiu51uS5s2FZFAellzeuliIWDITcHPI9CDFqYJY+ULaZOlwi1IJX+ytY+CIo64MkpOvNfvFTmmNW6NnLddxsB/xy2wN86eUVmLDh5lLIv/kN5HMqfA9DmIpuCrYfm5Wg+8NJh/wLf2t/IBZ+q8oA== Received: from BN0PR04CA0132.namprd04.prod.outlook.com (2603:10b6:408:ed::17) by CH2PR12MB4923.namprd12.prod.outlook.com (2603:10b6:610:6a::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5813.17; Mon, 14 Nov 2022 18:20:59 +0000 Received: from BN8NAM11FT090.eop-nam11.prod.protection.outlook.com (2603:10b6:408:ed:cafe::2d) by BN0PR04CA0132.outlook.office365.com (2603:10b6:408:ed::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5813.17 via Frontend Transport; Mon, 14 Nov 2022 18:20:58 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.160) 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.160 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.160) by BN8NAM11FT090.mail.protection.outlook.com (10.13.177.105) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5813.12 via Frontend Transport; Mon, 14 Nov 2022 18:20:58 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Mon, 14 Nov 2022 10:20:42 -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; Mon, 14 Nov 2022 10:20:40 -0800 From: Dariusz Sosnowski To: Thomas Monjalon , Ferruh Yigit , Andrew Rybchenko CC: , Aman Singh , Yuying Zhang , Matan Azrad , "Viacheslav Ovsiienko" Subject: [PATCH v3 0/3] ethdev: document special cases of port start and stop Date: Mon, 14 Nov 2022 18:19:53 +0000 Message-ID: <20221114181956.1052159-1-dsosnowski@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20221109190639.886457-1-dsosnowski@nvidia.com> References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.126.230.35] X-ClientProxiedBy: rnnvmail203.nvidia.com (10.129.68.9) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: BN8NAM11FT090:EE_|CH2PR12MB4923:EE_ X-MS-Office365-Filtering-Correlation-Id: 93056ee8-2f75-4819-c9b9-08dac66cfa69 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: 5la1msQPPHozd3if9vVzAfImLgGjDiRzxwDR6bX+uk+bPmZ0//B2d09MRD/PmyFS+OH3Bwk4jHa3rmVSvgQd4OimfKgaBgmnowGHK1i+EP1bgUOnKqA7hNOCjWdr+aOIcrtS3GrQBrg7Mj/IFDzyYMfhNxV6007GjJtkfFHSo1GLdbzhd/7PfYyYX2teJFA/IuDLp/BzrSr5fZs/sSXJ1ebSvk2PBQwpSx8s+/TS7y1IQHd8ptdR3B6JQsYrsJjIoMDOI+h7CbZz2gywoY2rJ3duieFH2NTJYjGEoBtmItsRfiXe0QY+I+UzPw8wpiC/ioNhIFIYQFbT23wCKyRrFHRlijn7KFWzvun2hq6VnIgsyTlZ7ehXiBAZ6AoodNXvdflDHkwLH0O5/Q9wFpdr8N5vpDPc8zsZdRD/J0a4TuXDO6wbOgKIRYpjY4dAE86V+ewITubzrH1yfH+RaiPwKZobh3H5tfMVP+NlO/mwTCAfyokwXtHzjGXOi5nNXLVr0YwUQaQXcKmhNX1HFHm+w4PfBrCmHQkFV/9MOce2e/wHUIKJan1Ws5zeI2V9uu6gkITINBGaauh/45DA69cmvLgWdkW9mg+GzuvzHzPvBQZupeLiofTyKvBzub/hdMRdIAjJeERxCeHZTZ1iEAMNP/B/aGDVN8QCKVc0kEOSqz0g+ZyzPBNAmHBV4WIabdbLBZv5i+WZjkTEM8GNqkSsfukFGyzqjAGwC6wM71Y2cMku01P19IA70yeF2HuXgJ7DKqkK2Yj284MsPWhan6xMuA== X-Forefront-Antispam-Report: CIP:216.228.117.160; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge1.nvidia.com; CAT:NONE; SFS:(13230022)(4636009)(39860400002)(376002)(136003)(346002)(396003)(451199015)(36840700001)(40470700004)(46966006)(7696005)(26005)(316002)(6286002)(70206006)(70586007)(2906002)(86362001)(55016003)(40480700001)(6666004)(107886003)(54906003)(36756003)(82740400003)(8676002)(4326008)(356005)(110136005)(478600001)(7636003)(40460700003)(336012)(186003)(16526019)(1076003)(83380400001)(47076005)(426003)(5660300002)(2616005)(41300700001)(36860700001)(82310400005)(8936002); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Nov 2022 18:20:58.4163 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 93056ee8-2f75-4819-c9b9-08dac66cfa69 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.160]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT090.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR12MB4923 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 cannot be started and start operation must be retried, PMDs might return (-EAGAIN) to notify about such situation. In case of stopping a port, If the port cannot be stopped in the current state, 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. v3: - Allow to retry port stop in testpmd for all errors. - Made error descriptions in the API more generic and moved specific error causes descriptions to PMD. v2: - Fixed documentation build. Dariusz Sosnowski (3): net/mlx5: fix log level on failed transfer proxy stop net/mlx5: document E-Switch limitations with HWS in mlx5 PMD ethdev: document special cases of port start and stop app/test-pmd/testpmd.c | 8 +++++++- doc/guides/nics/mlx5.rst | 13 +++++++++++++ drivers/net/mlx5/mlx5_trigger.c | 17 ++++++++++++++--- lib/ethdev/rte_ethdev.h | 2 ++ 4 files changed, 36 insertions(+), 4 deletions(-) -- 2.25.1