Show a cover letter.

GET /api/covers/119852/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 119852,
    "url": "http://patchwork.dpdk.org/api/covers/119852/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/cover/20221114181956.1052159-1-dsosnowski@nvidia.com/",
    "project": {
        "id": 1,
        "url": "http://patchwork.dpdk.org/api/projects/1/?format=api",
        "name": "DPDK",
        "link_name": "dpdk",
        "list_id": "dev.dpdk.org",
        "list_email": "dev@dpdk.org",
        "web_url": "http://core.dpdk.org",
        "scm_url": "git://dpdk.org/dpdk",
        "webscm_url": "http://git.dpdk.org/dpdk",
        "list_archive_url": "https://inbox.dpdk.org/dev",
        "list_archive_url_format": "https://inbox.dpdk.org/dev/{}",
        "commit_url_format": ""
    },
    "msgid": "<20221114181956.1052159-1-dsosnowski@nvidia.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20221114181956.1052159-1-dsosnowski@nvidia.com",
    "date": "2022-11-14T18:19:53",
    "name": "[v3,0/3] ethdev: document special cases of port start and stop",
    "submitter": {
        "id": 2386,
        "url": "http://patchwork.dpdk.org/api/people/2386/?format=api",
        "name": "Dariusz Sosnowski",
        "email": "dsosnowski@nvidia.com"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/cover/20221114181956.1052159-1-dsosnowski@nvidia.com/mbox/",
    "series": [
        {
            "id": 25759,
            "url": "http://patchwork.dpdk.org/api/series/25759/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=25759",
            "date": "2022-11-14T18:19:53",
            "name": "ethdev: document special cases of port start and stop",
            "version": 3,
            "mbox": "http://patchwork.dpdk.org/series/25759/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/covers/119852/comments/",
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "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])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 62BE0A0093;\n\tMon, 14 Nov 2022 19:21:02 +0100 (CET)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 3E1E342D0C;\n\tMon, 14 Nov 2022 19:21:02 +0100 (CET)",
            "from NAM02-BN1-obe.outbound.protection.outlook.com\n (mail-bn1nam02on2077.outbound.protection.outlook.com [40.107.212.77])\n by mails.dpdk.org (Postfix) with ESMTP id E228A40150\n for <dev@dpdk.org>; Mon, 14 Nov 2022 19:21:00 +0100 (CET)",
            "from BN0PR04CA0132.namprd04.prod.outlook.com (2603:10b6:408:ed::17)\n by CH2PR12MB4923.namprd12.prod.outlook.com (2603:10b6:610:6a::9) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5813.17; Mon, 14 Nov\n 2022 18:20:59 +0000",
            "from BN8NAM11FT090.eop-nam11.prod.protection.outlook.com\n (2603:10b6:408:ed:cafe::2d) by BN0PR04CA0132.outlook.office365.com\n (2603:10b6:408:ed::17) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5813.17 via Frontend\n Transport; Mon, 14 Nov 2022 18:20:58 +0000",
            "from mail.nvidia.com (216.228.117.160) by\n BN8NAM11FT090.mail.protection.outlook.com (10.13.177.105) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.5813.12 via Frontend Transport; Mon, 14 Nov 2022 18:20:58 +0000",
            "from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com\n (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Mon, 14 Nov\n 2022 10:20:42 -0800",
            "from nvidia.com (10.126.230.35) by rnnvmail201.nvidia.com\n (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Mon, 14 Nov\n 2022 10:20:40 -0800"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n 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;\n s=arcselector9901;\n 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;\n bh=QE6R6+ZTftKvTFmCY4F+Vfa5hUml26u6NUu5f0BzpI0=;\n 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\n 216.228.117.160) smtp.rcpttodomain=monjalon.net smtp.mailfrom=nvidia.com;\n dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com;\n dkim=none (message not signed); arc=none",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com;\n s=selector2;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=QE6R6+ZTftKvTFmCY4F+Vfa5hUml26u6NUu5f0BzpI0=;\n b=USaQrzqqr1fru4UEufWD1+Dk6k5Gc8ySxkid0TH4+islokqxAjBg1xgdG2hGHOcHU9J2a7mJ5K9P6dSvzn2xFCpVHtUi3fqvxemgiVkizEFZjihZM75Iz8ciLSRTAEOW+2pCOYWoZJAVpmJgJiFUNqZfbh3cRn0vLgCnkxjl5qZ/AIhbmXzx9DG/9cPx8jxQxkCiu51uS5s2FZFAellzeuliIWDITcHPI9CDFqYJY+ULaZOlwi1IJX+ytY+CIo64MkpOvNfvFTmmNW6NnLddxsB/xy2wN86eUVmLDh5lLIv/kN5HMqfA9DmIpuCrYfm5Wg+8NJh/wLf2t/IBZ+q8oA==",
        "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 216.228.117.160)\n smtp.mailfrom=nvidia.com;\n dkim=none (message not signed)\n header.d=none;dmarc=pass action=none header.from=nvidia.com;",
        "Received-SPF": "Pass (protection.outlook.com: domain of nvidia.com designates\n 216.228.117.160 as permitted sender) receiver=protection.outlook.com;\n client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C",
        "From": "Dariusz Sosnowski <dsosnowski@nvidia.com>",
        "To": "Thomas Monjalon <thomas@monjalon.net>, Ferruh Yigit\n <ferruh.yigit@amd.com>, Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>",
        "CC": "<dev@dpdk.org>, Aman Singh <aman.deep.singh@intel.com>, Yuying Zhang\n <yuying.zhang@intel.com>, Matan Azrad <matan@nvidia.com>, \"Viacheslav\n Ovsiienko\" <viacheslavo@nvidia.com>",
        "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\n 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": "\n 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;\n SRV:;\n IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge1.nvidia.com; CAT:NONE;\n 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);\n 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": "\n 93056ee8-2f75-4819-c9b9-08dac66cfa69",
        "X-MS-Exchange-CrossTenant-Id": "43083d15-7273-40c1-b7db-39efd9ccc17a",
        "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.160];\n Helo=[mail.nvidia.com]",
        "X-MS-Exchange-CrossTenant-AuthSource": "\n 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 <dev.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "List-Post": "<mailto:dev@dpdk.org>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org"
    },
    "content": "This patch series attempts to address the special failure\ncases of rte_eth_dev_stop() and rte_eth_dev_start().\n\nIn case of starting a port, If the port cannot be started and\nstart operation must be retried, PMDs might return (-EAGAIN)\nto notify about such situation.\n\nIn case of stopping a port, If the port cannot be stopped\nin the current state, PMDs might return (-EBUSY)\nto notify about such situation.\n\nThese cases are addressed in ethdev API docs.\nTestpmd is updated to allow users to manually retry start/stop operations.\n\nv3:\n- Allow to retry port stop in testpmd for all errors.\n- Made error descriptions in the API more generic and\n  moved specific error causes descriptions to PMD.\n\nv2:\n- Fixed documentation build.\n\nDariusz Sosnowski (3):\n  net/mlx5: fix log level on failed transfer proxy stop\n  net/mlx5: document E-Switch limitations with HWS in mlx5 PMD\n  ethdev: document special cases of port start and stop\n\n app/test-pmd/testpmd.c          |  8 +++++++-\n doc/guides/nics/mlx5.rst        | 13 +++++++++++++\n drivers/net/mlx5/mlx5_trigger.c | 17 ++++++++++++++---\n lib/ethdev/rte_ethdev.h         |  2 ++\n 4 files changed, 36 insertions(+), 4 deletions(-)"
}