get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/129292/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 129292,
    "url": "http://patchwork.dpdk.org/api/patches/129292/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20230705111038.9935-4-viacheslavo@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": "<20230705111038.9935-4-viacheslavo@nvidia.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230705111038.9935-4-viacheslavo@nvidia.com",
    "date": "2023-07-05T11:10:37",
    "name": "[v4,3/4] net/mlx5: add Tx datapath trace analyzing script",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "5ac7b30bee2b580c4f4ce36bf5b68fec7b12c142",
    "submitter": {
        "id": 1926,
        "url": "http://patchwork.dpdk.org/api/people/1926/?format=api",
        "name": "Slava Ovsiienko",
        "email": "viacheslavo@nvidia.com"
    },
    "delegate": {
        "id": 3268,
        "url": "http://patchwork.dpdk.org/api/users/3268/?format=api",
        "username": "rasland",
        "first_name": "Raslan",
        "last_name": "Darawsheh",
        "email": "rasland@nvidia.com"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20230705111038.9935-4-viacheslavo@nvidia.com/mbox/",
    "series": [
        {
            "id": 28833,
            "url": "http://patchwork.dpdk.org/api/series/28833/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=28833",
            "date": "2023-07-05T11:10:34",
            "name": "net/mlx5: introduce Tx datapath tracing",
            "version": 4,
            "mbox": "http://patchwork.dpdk.org/series/28833/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/patches/129292/comments/",
    "check": "success",
    "checks": "http://patchwork.dpdk.org/api/patches/129292/checks/",
    "tags": {},
    "related": [],
    "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 22B9B42DD9;\n\tWed,  5 Jul 2023 13:11:37 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id A01C942D37;\n\tWed,  5 Jul 2023 13:11:17 +0200 (CEST)",
            "from NAM12-DM6-obe.outbound.protection.outlook.com\n (mail-dm6nam12on2076.outbound.protection.outlook.com [40.107.243.76])\n by mails.dpdk.org (Postfix) with ESMTP id 74E89410F6\n for <dev@dpdk.org>; Wed,  5 Jul 2023 13:11:14 +0200 (CEST)",
            "from BN9PR03CA0536.namprd03.prod.outlook.com (2603:10b6:408:131::31)\n by SJ1PR12MB6265.namprd12.prod.outlook.com (2603:10b6:a03:458::21)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6544.24; Wed, 5 Jul\n 2023 11:11:12 +0000",
            "from BN8NAM11FT075.eop-nam11.prod.protection.outlook.com\n (2603:10b6:408:131:cafe::2d) by BN9PR03CA0536.outlook.office365.com\n (2603:10b6:408:131::31) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6565.18 via Frontend\n Transport; Wed, 5 Jul 2023 11:11:11 +0000",
            "from mail.nvidia.com (216.228.117.161) by\n BN8NAM11FT075.mail.protection.outlook.com (10.13.176.208) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.6521.45 via Frontend Transport; Wed, 5 Jul 2023 11:11:11 +0000",
            "from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com\n (10.129.200.67) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Wed, 5 Jul 2023\n 04:11:00 -0700",
            "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.37; Wed, 5 Jul 2023\n 04:10:58 -0700"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=WvVivryjPFpKBqRj9AyxKy0Xk+2a/Hy/q4irOotKJ+3zlZnikfOWK6yn4zI0lpSB1NfKHxmLwMDkOIB599n9o4Me6EvxyJCwGUO3uDWIMFw0iYBG59v8ndpN++fus8pVvKY0NkDB/GYjIfwACmBIhH3y9iI/WLaM+WZqa1/RHeXAIOjvRTMefNLkyzoO3mGl8IESnXfUman00w1LCMrAdndcarB+u2uTTmbqy90WE5XZq4Yw3kXO3O4fxeXxXC8DqdU3t/UZHMgeGIABynujVgKk+7BHC9qZSxdKzUkFygmcpgnQ91+r6/ICG6EEskLd7BusMWmsjNSmTpQ88zilOg==",
        "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=/DsapU1Z/lqzk/PAxwff7QOfmmrMm5Xv0ofwjQ6zr/I=;\n b=Q/gvtkfGiWrcbTmHCl2NvzmI+UUOUFNTjeMJ/d0AIWKgoB0KFeZSBQz0E/PeKCQEI4Y1FJ3Kcoh/dgYhaMAfFBC4Lj3YgZqVgtYXymLJjUuzCTiWU4rxDp+nw+P4TO/wKAphsPmYlX30S0Iu8QDioLnh0MB8KHAo1hXP5nDp7V0SNsynODtVigJ1dWfgJgT2vHU7RMTAE6I4+EUc2079ts6MbTRHbG0OCdePADQikzd2+fsaCHkkO+iy1xZLOwbDxFspHamYayKBh5huQpywxUNfjvOwpWzdS1L1tGVPYauKKJ3S44bhUvegyzePufj57u4UJuDzKfDkMBGoBAf8Ig==",
        "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 216.228.117.161) smtp.rcpttodomain=dpdk.org 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=/DsapU1Z/lqzk/PAxwff7QOfmmrMm5Xv0ofwjQ6zr/I=;\n b=MELezuBYU7mgSIlCybWAh2Q2yf34pkaxGhEMXd9N99EAU37wGIQeydh3QeuwAUoXlmFUe4Q1jMzabsIJR8oBGH3K2TjVRcWEzPlKHr4j99rBr/yalyiLo2Tx+DNl7e88/LcYwVNzIn8LiL3nypaY2sTnF2J1qZA3HbHqEnmSIbjDpYEx5pcpbOgAskHixr86tPP7SDJtINTfBJp8zVqdXBkeGbsxy8rNi/zMrd7+sOqIPR3dB6IX/dr/uLmKx7dgHPBEyyDv8bosDuFDjnHGWga1vbGkprQ165s1LZV2UCjnYf1527HkTBeBZEM0oT9LEheNe9D/CWJg/rARiNTrkg==",
        "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 216.228.117.161)\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.161 as permitted sender) receiver=protection.outlook.com;\n client-ip=216.228.117.161; helo=mail.nvidia.com; pr=C",
        "From": "Viacheslav Ovsiienko <viacheslavo@nvidia.com>",
        "To": "<dev@dpdk.org>",
        "CC": "<jerinj@marvell.com>, <rasland@nvidia.com>",
        "Subject": "[PATCH v4 3/4] net/mlx5: add Tx datapath trace analyzing script",
        "Date": "Wed, 5 Jul 2023 14:10:37 +0300",
        "Message-ID": "<20230705111038.9935-4-viacheslavo@nvidia.com>",
        "X-Mailer": "git-send-email 2.18.1",
        "In-Reply-To": "<20230705111038.9935-1-viacheslavo@nvidia.com>",
        "References": "<20230420100803.494-1-viacheslavo@nvidia.com>\n <20230705111038.9935-1-viacheslavo@nvidia.com>",
        "MIME-Version": "1.0",
        "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": "BN8NAM11FT075:EE_|SJ1PR12MB6265:EE_",
        "X-MS-Office365-Filtering-Correlation-Id": "71aa4bd7-c5e7-4526-dae6-08db7d488a5e",
        "X-MS-Exchange-SenderADCheck": "1",
        "X-MS-Exchange-AntiSpam-Relay": "0",
        "X-Microsoft-Antispam": "BCL:0;",
        "X-Microsoft-Antispam-Message-Info": "\n nPcYUmRfxOzlaeq0SKuoVn5XuS7ohYAz4UQgifKMsAUSp3Yh0HAd+Mt4L66PUeBKAJWxRxdDddByQibpCiK0wKkN3nno4KXDVOzHLa/FoNkAFmR3onkIsKAFMdmMPx/b/GwUm3PgoS7ZWNdlCDVsZjAKKPsvuZ0RrwPFoWdswBBLv5cPzQEWdp829nq/SowyDVfP+MICqyPiEITtfZhH9QbZVKOHxCj43aHMehBlPyZ8MGiQomIT26UPODXzrGDOvb4mi0TQP5botKJXx7swJFd0y5AAG2a/9BhXlFpwtjFiJF6V8ZJWO0xWt4E90lNHoA+7a1s/a3xW4FtFhrY9abnH6FuYdQG7bvJNkTpuO2PFmKBpvOhNfurqMp/z3QSIpr/36/8sbfkDCxSmgQkVC/aNoLK/SohByiKtFZzj7BOKsARec5gt/ziicoJYmEdS07beqcBaOHh7pVoKN6BO77wS/kMgZPYLm3UWYHJG4BW31vE3GuDKWXe/i/OJh9j4wOogk1sZLROdfaZDrL+kI+ak1Y6XaT09WqV1aUiIIfpJZLbgA/REodbYMs6E2vBRLLnL97kzddZS4m/47dTGvQ5NQFZdMj4QePomOIZ/jwdHilfHYUsLEEpWSNHI8LHsXdX3Kw0Kr9n3vcDqB1JOVH1RAQEweWrQr9XDaHcbFKEDlDM4At3goAdDoHfqBZ5ifHjORLNe5J1VO1AtFBodFG4s3Tv5qBLa0O2JAOTc4lRikOMojdatdiBDAgZT4NXt",
        "X-Forefront-Antispam-Report": "CIP:216.228.117.161; CTRY:US; LANG:en; SCL:1;\n SRV:;\n IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge2.nvidia.com; CAT:NONE;\n SFS:(13230028)(4636009)(39860400002)(346002)(136003)(376002)(396003)(451199021)(40470700004)(36840700001)(46966006)(336012)(40460700003)(41300700001)(86362001)(6666004)(82310400005)(7636003)(107886003)(47076005)(83380400001)(82740400003)(356005)(6286002)(1076003)(16526019)(2616005)(26005)(426003)(36860700001)(40480700001)(55016003)(7696005)(54906003)(478600001)(316002)(36756003)(4326008)(70206006)(70586007)(6916009)(8676002)(8936002)(186003)(2906002)(5660300002);\n DIR:OUT; SFP:1101;",
        "X-OriginatorOrg": "Nvidia.com",
        "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "05 Jul 2023 11:11:11.3459 (UTC)",
        "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 71aa4bd7-c5e7-4526-dae6-08db7d488a5e",
        "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.161];\n Helo=[mail.nvidia.com]",
        "X-MS-Exchange-CrossTenant-AuthSource": "\n BN8NAM11FT075.eop-nam11.prod.protection.outlook.com",
        "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous",
        "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem",
        "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "SJ1PR12MB6265",
        "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": "The Python script is intended to analyze mlx5 PMD\ndatapath traces and report:\n  - tx_burst routine timings\n  - how packets are pushed to WQEs\n  - how packet sending is completed with timings\n\nSigned-off-by: Viacheslav Ovsiienko <viacheslavo@nvidia.com>\n---\n drivers/net/mlx5/tools/mlx5_trace.py | 307 +++++++++++++++++++++++++++\n 1 file changed, 307 insertions(+)\n create mode 100755 drivers/net/mlx5/tools/mlx5_trace.py",
    "diff": "diff --git a/drivers/net/mlx5/tools/mlx5_trace.py b/drivers/net/mlx5/tools/mlx5_trace.py\nnew file mode 100755\nindex 0000000000..8c1fd0a350\n--- /dev/null\n+++ b/drivers/net/mlx5/tools/mlx5_trace.py\n@@ -0,0 +1,307 @@\n+#!/usr/bin/env python3\n+# SPDX-License-Identifier: BSD-3-Clause\n+# Copyright (c) 2023 NVIDIA Corporation & Affiliates\n+\n+\"\"\"\n+Analyzing the mlx5 PMD datapath tracings\n+\"\"\"\n+import sys\n+import argparse\n+import bt2\n+\n+PFX_TX = \"pmd.net.mlx5.tx.\"\n+PFX_TX_LEN = len(PFX_TX)\n+\n+\n+class MlxQueue:\n+    \"\"\"Queue container object\"\"\"\n+\n+    def __init__(self):\n+        self.done_burst = []  # completed bursts\n+        self.wait_burst = []  # waiting for completion\n+        self.pq_id = 0\n+\n+    def log(self):\n+        \"\"\"Log all queue bursts\"\"\"\n+        for txb in self.done_burst:\n+            txb.log()\n+\n+\n+class MlxMbuf:\n+    \"\"\"Packet mbufs container object\"\"\"\n+\n+    def __init__(self):\n+        self.wqe = 0     # wqe id\n+        self.ptr = None  # first packet mbuf pointer\n+        self.len = 0     # packet data length\n+        self.nseg = 0    # number of segments\n+\n+    def log(self):\n+        \"\"\"Log mbuf\"\"\"\n+        out_txt = \"    %X: %u\" % (self.ptr, self.len)\n+        if self.nseg != 1:\n+            out_txt += \" (%d segs)\" % self.nseg\n+        print(out_txt)\n+\n+\n+class MlxWqe:\n+    \"\"\"WQE container object\"\"\"\n+\n+    def __init__(self):\n+        self.mbuf = []    # list of mbufs in WQE\n+        self.wait_ts = 0  # preceding wait/push timestamp\n+        self.comp_ts = 0  # send/recv completion timestamp\n+        self.opcode = 0\n+\n+    def log(self):\n+        \"\"\"Log WQE\"\"\"\n+        wqe_id = (self.opcode >> 8) & 0xFFFF\n+        wqe_op = self.opcode & 0xFF\n+        out_txt = \"  %04X: \" % wqe_id\n+        if wqe_op == 0xF:\n+            out_txt += \"WAIT\"\n+        elif wqe_op == 0x29:\n+            out_txt += \"EMPW\"\n+        elif wqe_op == 0xE:\n+            out_txt += \"TSO \"\n+        elif wqe_op == 0xA:\n+            out_txt += \"SEND\"\n+        else:\n+            out_txt += \"0x%02X\" % wqe_op\n+        if self.comp_ts != 0:\n+            out_txt += \" (%d, %d)\" % (self.wait_ts, self.comp_ts - self.wait_ts)\n+        else:\n+            out_txt += \" (%d)\" % self.wait_ts\n+        print(out_txt)\n+        for mbuf in self.mbuf:\n+            mbuf.log()\n+\n+    def comp(self, wqe_id, wqe_ts):\n+        \"\"\"Return 0 if WQE in not completedLog WQE\"\"\"\n+        if self.comp_ts != 0:\n+            return 1\n+        cur_id = (self.opcode >> 8) & 0xFFFF\n+        if cur_id > wqe_id:\n+            cur_id -= wqe_id\n+            if cur_id <= 0x8000:\n+                return 0\n+        else:\n+            cur_id = wqe_id - cur_id\n+            if cur_id >= 0x8000:\n+                return 0\n+        self.comp_ts = wqe_ts\n+        return 1\n+\n+\n+class MlxBurst:\n+    \"\"\"Packet burst container object\"\"\"\n+\n+    def __init__(self):\n+        self.wqes = []    # issued burst WQEs\n+        self.done = 0     # number of sent/recv packets\n+        self.req = 0      # requested number of packets\n+        self.call_ts = 0  # burst routine invocation\n+        self.done_ts = 0  # burst routine done\n+        self.queue = None\n+\n+    def log(self):\n+        \"\"\"Log burst\"\"\"\n+        port = self.queue.pq_id >> 16\n+        queue = self.queue.pq_id & 0xFFFF\n+        if self.req == 0:\n+            print(\n+                \"%u: tx(p=%u, q=%u, %u/%u pkts (incomplete)\"\n+                % (self.call_ts, port, queue, self.done, self.req)\n+            )\n+        else:\n+            print(\n+                \"%u: tx(p=%u, q=%u, %u/%u pkts in %u\"\n+                % (\n+                    self.call_ts,\n+                    port,\n+                    queue,\n+                    self.done,\n+                    self.req,\n+                    self.done_ts - self.call_ts,\n+                )\n+            )\n+        for wqe in self.wqes:\n+            wqe.log()\n+\n+    def comp(self, wqe_id, wqe_ts):\n+        \"\"\"Return 0 if not all of WQEs in burst completed\"\"\"\n+        wlen = len(self.wqes)\n+        if wlen == 0:\n+            return 0\n+        for wqe in self.wqes:\n+            if wqe.comp(wqe_id, wqe_ts) == 0:\n+                return 0\n+        return 1\n+\n+\n+class MlxTrace:\n+    \"\"\"Trace representing object\"\"\"\n+\n+    def __init__(self):\n+        self.tx_blst = {}  # current Tx bursts per CPU\n+        self.tx_qlst = {}  # active Tx queues per port/queue\n+        self.tx_wlst = {}  # wait timestamp list per CPU\n+\n+    def run(self, msg_it):\n+        \"\"\"Run over gathered tracing data and build database\"\"\"\n+        for msg in msg_it:\n+            if not isinstance(msg, bt2._EventMessageConst):\n+                continue\n+            event = msg.event\n+            if event.name.startswith(PFX_TX):\n+                do_tx(msg, self)\n+            # Handling of other log event cathegories can be added here\n+\n+    def log(self):\n+        \"\"\"Log gathered trace database\"\"\"\n+        for pq_id in self.tx_qlst:\n+            queue = self.tx_qlst.get(pq_id)\n+            queue.log()\n+\n+\n+def do_tx_entry(msg, trace):\n+    \"\"\"Handle entry Tx busrt\"\"\"\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    burst = trace.tx_blst.get(cpu_id)\n+    if burst is not None:\n+        # continue existing burst after WAIT\n+        return\n+    # allocate the new burst and append to the queue\n+    burst = MlxBurst()\n+    burst.call_ts = msg.default_clock_snapshot.ns_from_origin\n+    trace.tx_blst[cpu_id] = burst\n+    pq_id = event[\"port_id\"] << 16 | event[\"queue_id\"]\n+    queue = trace.tx_qlst.get(pq_id)\n+    if queue is None:\n+        # queue does not exist - allocate the new one\n+        queue = MlxQueue()\n+        queue.pq_id = pq_id\n+        trace.tx_qlst[pq_id] = queue\n+    burst.queue = queue\n+    queue.wait_burst.append(burst)\n+\n+\n+def do_tx_exit(msg, trace):\n+    \"\"\"Handle exit Tx busrt\"\"\"\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    burst = trace.tx_blst.get(cpu_id)\n+    if burst is None:\n+        return\n+    burst.done_ts = msg.default_clock_snapshot.ns_from_origin\n+    burst.req = event[\"nb_req\"]\n+    burst.done = event[\"nb_sent\"]\n+    trace.tx_blst.pop(cpu_id)\n+\n+\n+def do_tx_wqe(msg, trace):\n+    \"\"\"Handle WQE record\"\"\"\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    burst = trace.tx_blst.get(cpu_id)\n+    if burst is None:\n+        return\n+    wqe = MlxWqe()\n+    wqe.wait_ts = trace.tx_wlst.get(cpu_id)\n+    if wqe.wait_ts is None:\n+        wqe.wait_ts = msg.default_clock_snapshot.ns_from_origin\n+    wqe.opcode = event[\"opcode\"]\n+    burst.wqes.append(wqe)\n+\n+\n+def do_tx_wait(msg, trace):\n+    \"\"\"Handle WAIT record\"\"\"\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    trace.tx_wlst[cpu_id] = event[\"ts\"]\n+\n+\n+def do_tx_push(msg, trace):\n+    \"\"\"Handle WQE push event\"\"\"\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    burst = trace.tx_blst.get(cpu_id)\n+    if burst is None:\n+        return\n+    if not burst.wqes:\n+        return\n+    wqe = burst.wqes[-1]\n+    mbuf = MlxMbuf()\n+    mbuf.wqe = event[\"wqe_id\"]\n+    mbuf.ptr = event[\"mbuf\"]\n+    mbuf.len = event[\"mbuf_pkt_len\"]\n+    mbuf.nseg = event[\"mbuf_nb_segs\"]\n+    wqe.mbuf.append(mbuf)\n+\n+\n+def do_tx_complete(msg, trace):\n+    \"\"\"Handle send completion event\"\"\"\n+    event = msg.event\n+    pq_id = event[\"port_id\"] << 16 | event[\"queue_id\"]\n+    queue = trace.tx_qlst.get(pq_id)\n+    if queue is None:\n+        return\n+    qlen = len(queue.wait_burst)\n+    if qlen == 0:\n+        return\n+    wqe_id = event[\"wqe_id\"]\n+    wqe_ts = event[\"ts\"]\n+    rmv = 0\n+    while rmv < qlen:\n+        burst = queue.wait_burst[rmv]\n+        if burst.comp(wqe_id, wqe_ts) == 0:\n+            break\n+        rmv += 1\n+    # mode completed burst to done list\n+    if rmv != 0:\n+        idx = 0\n+        while idx < rmv:\n+            queue.done_burst.append(burst)\n+            idx += 1\n+        del queue.wait_burst[0:rmv]\n+\n+\n+def do_tx(msg, trace):\n+    \"\"\"Handle Tx related records\"\"\"\n+    name = msg.event.name[PFX_TX_LEN:]\n+    if name == \"entry\":\n+        do_tx_entry(msg, trace)\n+    elif name == \"exit\":\n+        do_tx_exit(msg, trace)\n+    elif name == \"wqe\":\n+        do_tx_wqe(msg, trace)\n+    elif name == \"wait\":\n+        do_tx_wait(msg, trace)\n+    elif name == \"push\":\n+        do_tx_push(msg, trace)\n+    elif name == \"complete\":\n+        do_tx_complete(msg, trace)\n+    else:\n+        print(\"Error: unrecognized Tx event name: %s\" % msg.event.name, file=sys.stderr)\n+        raise ValueError()\n+\n+\n+def main() -> int:\n+    \"\"\"Script entry point\"\"\"\n+    try:\n+        parser = argparse.ArgumentParser()\n+        parser.add_argument(\"path\", nargs=1, type=str, help=\"input trace folder\")\n+        args = parser.parse_args()\n+\n+        mlx_tr = MlxTrace()\n+        msg_it = bt2.TraceCollectionMessageIterator(args.path)\n+        mlx_tr.run(msg_it)\n+        mlx_tr.log()\n+        return 0\n+    except ValueError:\n+        return -1\n+\n+\n+if __name__ == \"__main__\":\n+    sys.exit(main())\n",
    "prefixes": [
        "v4",
        "3/4"
    ]
}