get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 129048,
    "url": "http://patchwork.dpdk.org/api/patches/129048/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20230628110958.1403-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": "<20230628110958.1403-4-viacheslavo@nvidia.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230628110958.1403-4-viacheslavo@nvidia.com",
    "date": "2023-06-28T11:09:57",
    "name": "[v3,3/4] net/mlx5: add Tx datapath trace analyzing script",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "c0ac77fe7d139651d3e7e3d953e6d8149f1c7bd5",
    "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/20230628110958.1403-4-viacheslavo@nvidia.com/mbox/",
    "series": [
        {
            "id": 28686,
            "url": "http://patchwork.dpdk.org/api/series/28686/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=28686",
            "date": "2023-06-28T11:09:54",
            "name": "net/mlx5: introduce Tx datapath tracing",
            "version": 3,
            "mbox": "http://patchwork.dpdk.org/series/28686/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/patches/129048/comments/",
    "check": "success",
    "checks": "http://patchwork.dpdk.org/api/patches/129048/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 40CE442D7F;\n\tWed, 28 Jun 2023 13:10:45 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 08E3842BFE;\n\tWed, 28 Jun 2023 13:10:37 +0200 (CEST)",
            "from NAM12-BN8-obe.outbound.protection.outlook.com\n (mail-bn8nam12on2079.outbound.protection.outlook.com [40.107.237.79])\n by mails.dpdk.org (Postfix) with ESMTP id AB89642D0D\n for <dev@dpdk.org>; Wed, 28 Jun 2023 13:10:35 +0200 (CEST)",
            "from BN8PR04CA0024.namprd04.prod.outlook.com (2603:10b6:408:70::37)\n by SN7PR12MB6861.namprd12.prod.outlook.com (2603:10b6:806:266::14)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6521.24; Wed, 28 Jun\n 2023 11:10:34 +0000",
            "from BN8NAM11FT108.eop-nam11.prod.protection.outlook.com\n (2603:10b6:408:70:cafe::7b) by BN8PR04CA0024.outlook.office365.com\n (2603:10b6:408:70::37) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6521.34 via Frontend\n Transport; Wed, 28 Jun 2023 11:10:33 +0000",
            "from mail.nvidia.com (216.228.117.161) by\n BN8NAM11FT108.mail.protection.outlook.com (10.13.176.155) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.6500.47 via Frontend Transport; Wed, 28 Jun 2023 11:10:33 +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, 28 Jun 2023\n 04:10:20 -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, 28 Jun\n 2023 04:10:19 -0700"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=C2hpnoRAC8nSz/dzzM2sbUa6d7lyi2qTjgQWtqh/JR+zwpcjE9HoJtSsYNS/1d5txbayABC23B5+iWnr0M6Yms++8hVYWK0TctyUlbncPSF+vabEiXcJMv8cggFZvfFralWzbyqmo9NjqxrcVD2IJgnFlhxmZ+CV2/oMBr7LxOos7xuGhYrLaSGVZpvCHaaxL2jF0+8TnjklkNcaFt6vjffA6jHuLuXENz9I1FrAaCli6cNidq8C1dFQFkF+el1buHeLBj9oncSkcr5bre97ADtvJvlNkOXU5GSVLJapHNF97X+y/RHIqYNinKhWVyCNELggJP79S/WaRqtTOCoORg==",
        "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=MYiacIuwMsvJ4xeh+TMKQLFoa38kzzHwJ+42WXNm0ZU=;\n b=BuzgUDoBxEdhdxtBUD9B/bp6c9EnPi9rabFLZTCgYsBCY3OkYIFcXLuRFQ/30eO9g7fPoqZ+z8TRicwHt7GpkJ4XELB2gUTP5nJNHfB78QHZldzOB80MFumllcOY0hgvpKFkzdYJWmYRVvdhPuGz41jralfmz8QP3PkCdSH0zMUE2xkg+Nds6K6BPN9cWJ68+MNQoc39+CpiemKM8TDeFNXk4afYu9IkxZKuCUf6sucKQwW80FZuzn5twgHfP3WZASghp1qYSqhc7VcZVAGsjISeRL85sjY3aKyu0oIAeOT+fEUNTV21dRhF90KxL6cv3u911YIpV8VeaqAgFy34nw==",
        "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=MYiacIuwMsvJ4xeh+TMKQLFoa38kzzHwJ+42WXNm0ZU=;\n b=HeTcOgSj930xyaaBe30LATj0RISwFaH2Wtl1VhrQxdJCyGTt3zI5ICJ4Mp18LKAHIUgUvPCvIUNgoiPCQT/wbk0LU+Ghq7S3LUIMshVwUiODpcueDvLiSIlMi3ZIiOsT7yjFw1VTB9+r+oRoYluG3OiKM5IcRPzRV7VQiCmDr06wPp4otd/P8jlIcIspb0vYejvmy1WVyDMDnxX8DWMWtIDwE+Pfw+pDWMQLvYxY3JRgi3/1yvRis0DYFRagfcyJHhBfrziNAdCOcfpAnPCGj2ereITQv/QASDxcpjZnI2Zdv1UVS6NtYqkFhKNFF/Rg5ILfDxJL/ADFAevKwGIWew==",
        "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>",
        "Subject": "[PATCH v3 3/4] net/mlx5: add Tx datapath trace analyzing script",
        "Date": "Wed, 28 Jun 2023 14:09:57 +0300",
        "Message-ID": "<20230628110958.1403-4-viacheslavo@nvidia.com>",
        "X-Mailer": "git-send-email 2.18.1",
        "In-Reply-To": "<20230628110958.1403-1-viacheslavo@nvidia.com>",
        "References": "<20230420100803.494-1-viacheslavo@nvidia.com>\n <20230628110958.1403-1-viacheslavo@nvidia.com>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain",
        "X-Originating-IP": "[10.126.230.35]",
        "X-ClientProxiedBy": "rnnvmail201.nvidia.com (10.129.68.8) To\n rnnvmail201.nvidia.com (10.129.68.8)",
        "X-EOPAttributedMessage": "0",
        "X-MS-PublicTrafficType": "Email",
        "X-MS-TrafficTypeDiagnostic": "BN8NAM11FT108:EE_|SN7PR12MB6861:EE_",
        "X-MS-Office365-Filtering-Correlation-Id": "e0bb871c-4d8c-4369-00e2-08db77c84afe",
        "X-MS-Exchange-SenderADCheck": "1",
        "X-MS-Exchange-AntiSpam-Relay": "0",
        "X-Microsoft-Antispam": "BCL:0;",
        "X-Microsoft-Antispam-Message-Info": "\n m9dA1zbFUkqzsv8qZgGVEPNev+OpPEBJPQUmNrRYxZiqmICy5a8E3YqZv1aeg7wJog5ZMginDvaSiwL+ufMms8pD081t0YJEjLC8gTO10wtAhnfpZvGU0hFOG2h4e1uvODTYkxXZceSZZRrAHRoQBQZdQnDYdrcANskwPkbiZV+J9wZpkUncyisBIN0DkA5T93TpfCrpcpYhV5EYoU54WrYSgnF/Hhe4lb2vR47vX3vwqf+ulAr+6cAbZsU9mwWHJopid7pbc36FnKoCvH+MLKMb57Q8dE0XcjC7DXS3o3G0EuPSdJfK9nPpTbbIOdxTBzaV/xr4zSxkJfgeAM0W9HsdcpOEvpOf779ewAzSrstzSQEHy6JP3xsxVUwMAWD20HyjYUWceEgihzA+z5A8aL0xx5l5pLp1UdoaQHj2LnD/3yzuFff0oUOnSEEIJsDU5wbAQLwiz5sA/DMDV0oGaep1VM48ZqZsxxVq0dRTKFQY4F05q9tDDBEUrkov+IIkErN+k56ALSGcAuo4rmJESMaIBjLoUC5CeWdJI1sSrxyotS8FzqlKGe8TcbVM9aOpb81pooGBz6WvikwvmQ4c/SRbgqQw0H8W9+8SlcFUYBbPwvryzgMzrhOtP1IvaKpSOsB8NDyFqLM//Dqpd5dgkAEtLoXO82LnVhVJST5EVtlOou+GhYeMv2LySsu5Uovh2izhvz5wetImbmPEj6VSe8ew8BgfPrnIfu1iorfj9xYlrO/dFlTrYxuQZVAzZEHV",
        "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)(396003)(39860400002)(136003)(376002)(346002)(451199021)(36840700001)(46966006)(40470700004)(5660300002)(6916009)(70206006)(478600001)(36756003)(316002)(70586007)(8936002)(8676002)(2906002)(40460700003)(55016003)(36860700001)(41300700001)(82310400005)(186003)(7696005)(40480700001)(336012)(86362001)(26005)(16526019)(47076005)(6666004)(426003)(6286002)(356005)(1076003)(2616005)(7636003)(82740400003)(83380400001);\n DIR:OUT; SFP:1101;",
        "X-OriginatorOrg": "Nvidia.com",
        "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "28 Jun 2023 11:10:33.6350 (UTC)",
        "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n e0bb871c-4d8c-4369-00e2-08db77c84afe",
        "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 BN8NAM11FT108.eop-nam11.prod.protection.outlook.com",
        "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous",
        "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem",
        "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "SN7PR12MB6861",
        "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 | 271 +++++++++++++++++++++++++++\n 1 file changed, 271 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..c8fa63a7b9\n--- /dev/null\n+++ b/drivers/net/mlx5/tools/mlx5_trace.py\n@@ -0,0 +1,271 @@\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 pathlib\n+import bt2\n+\n+PFX_TX     = \"pmd.net.mlx5.tx.\"\n+PFX_TX_LEN = len(PFX_TX)\n+\n+tx_blst = {}                    # current Tx bursts per CPU\n+tx_qlst = {}                    # active Tx queues per port/queue\n+tx_wlst = {}                    # wait timestamp list per CPU\n+\n+class mlx5_queue(object):\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+        for txb in self.done_burst:\n+            txb.log()\n+\n+\n+class mlx5_mbuf(object):\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+        out = \"    %X: %u\" % (self.ptr, self.len)\n+        if self.nseg != 1:\n+            out += \" (%d segs)\" % self.nseg\n+        print(out)\n+\n+\n+class mlx5_wqe(object):\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+        id = (self.opcode >> 8) & 0xFFFF\n+        op = self.opcode & 0xFF\n+        fl = self.opcode >> 24\n+        out = \"  %04X: \" % id\n+        if op == 0xF:\n+            out += \"WAIT\"\n+        elif op == 0x29:\n+            out += \"EMPW\"\n+        elif op == 0xE:\n+            out += \"TSO \"\n+        elif op == 0xA:\n+            out += \"SEND\"\n+        else:\n+            out += \"0x%02X\" % op\n+        if self.comp_ts != 0:\n+            out += \" (%d, %d)\" % (self.wait_ts, self.comp_ts - self.wait_ts)\n+        else:\n+            out += \" (%d)\" % self.wait_ts\n+        print(out)\n+        for mbuf in self.mbuf:\n+            mbuf.log()\n+\n+    # return 0 if WQE in not completed\n+    def comp(self, wqe_id, ts):\n+        if self.comp_ts != 0:\n+            return 1\n+        id = (self.opcode >> 8) & 0xFFFF\n+        if id > wqe_id:\n+            id -= wqe_id\n+            if id <= 0x8000:\n+                return 0\n+        else:\n+            id = wqe_id - id\n+            if id >= 0x8000:\n+                return 0\n+        self.comp_ts = ts\n+        return 1\n+\n+\n+class mlx5_burst(object):\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+        port = self.queue.pq_id >> 16\n+        queue = self.queue.pq_id & 0xFFFF\n+        if self.req == 0:\n+            print(\"%u: tx(p=%u, q=%u, %u/%u pkts (incomplete)\" %\n+                  (self.call_ts, port, queue, self.done, self.req))\n+        else:\n+            print(\"%u: tx(p=%u, q=%u, %u/%u pkts in %u\" %\n+                  (self.call_ts, port, queue, self.done, self.req,\n+                   self.done_ts - self.call_ts))\n+        for wqe in self.wqes:\n+            wqe.log()\n+\n+    # return 0 if not all of WQEs in burst completed\n+    def comp(self, wqe_id, ts):\n+        wlen = len(self.wqes)\n+        if wlen == 0:\n+            return 0\n+        for wqe in self.wqes:\n+            if wqe.comp(wqe_id, ts) == 0:\n+                return 0\n+        return 1\n+\n+\n+def do_tx_entry(msg):\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    burst = 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 = mlx5_burst()\n+    burst.call_ts = msg.default_clock_snapshot.ns_from_origin\n+    tx_blst[cpu_id] = burst\n+    pq_id = event[\"port_id\"] << 16 | event[\"queue_id\"]\n+    queue = tx_qlst.get(pq_id)\n+    if queue is None:\n+        # queue does not exist - allocate the new one\n+        queue = mlx5_queue();\n+        queue.pq_id = pq_id\n+        tx_qlst[pq_id] = queue\n+    burst.queue = queue\n+    queue.wait_burst.append(burst)\n+\n+\n+def do_tx_exit(msg):\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    burst = 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+    tx_blst.pop(cpu_id)\n+\n+\n+def do_tx_wqe(msg):\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    burst = tx_blst.get(cpu_id)\n+    if burst is None:\n+        return\n+    wqe = mlx5_wqe()\n+    wqe.wait_ts = 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):\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    tx_wlst[cpu_id] = event[\"ts\"]\n+\n+\n+def do_tx_push(msg):\n+    event = msg.event\n+    cpu_id = event[\"cpu_id\"]\n+    burst = 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 = mlx5_mbuf()\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):\n+    event = msg.event\n+    pq_id = event[\"port_id\"] << 16 | event[\"queue_id\"]\n+    queue = 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+    ts = event[\"ts\"]\n+    rmv = 0\n+    while rmv < qlen:\n+        burst = queue.wait_burst[rmv]\n+        if burst.comp(wqe_id, 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):\n+    name = msg.event.name[PFX_TX_LEN:]\n+    if name == \"entry\":\n+        do_tx_entry(msg)\n+    elif name == \"exit\":\n+        do_tx_exit(msg)\n+    elif name == \"wqe\":\n+        do_tx_wqe(msg)\n+    elif name == \"wait\":\n+        do_tx_wait(msg)\n+    elif name == \"push\":\n+        do_tx_push(msg)\n+    elif name == \"complete\":\n+        do_tx_complete(msg)\n+    else:\n+        print(\"Error: unrecognized Tx event name: %s\" % msg.event.name)\n+        sys.exit(1)\n+\n+\n+def do_log(msg_it):\n+    for msg in msg_it:\n+        if type(msg) is not bt2._EventMessageConst:\n+            continue\n+        event = msg.event\n+        if event.name.startswith(PFX_TX):\n+            do_tx(msg)\n+        # Handling of other log event cathegories can be added here\n+\n+\n+def do_print():\n+    for pq_id in tx_qlst:\n+        queue = tx_qlst.get(pq_id)\n+        queue.log()\n+\n+\n+def main(args):\n+    parser = argparse.ArgumentParser()\n+    parser.add_argument(\"path\",\n+                        nargs = 1,\n+                        type = str,\n+                        help = \"input trace folder\")\n+    args = parser.parse_args()\n+\n+    msg_it = bt2.TraceCollectionMessageIterator(args.path)\n+    do_log(msg_it)\n+    do_print()\n+    exit(0)\n+\n+if __name__ == \"__main__\":\n+    main(sys.argv)\n",
    "prefixes": [
        "v3",
        "3/4"
    ]
}