get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 106038,
    "url": "http://patches.dpdk.org/api/patches/106038/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220118153557.3947859-1-akozyrev@nvidia.com/",
    "project": {
        "id": 1,
        "url": "http://patches.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": "<20220118153557.3947859-1-akozyrev@nvidia.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20220118153557.3947859-1-akozyrev@nvidia.com",
    "date": "2022-01-18T15:35:57",
    "name": "[v2,08/10] app/testpmd: implement rte flow queue drain",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "ffd9ed4cf1e016161abb5e734c7dff059b3c0b6a",
    "submitter": {
        "id": 1873,
        "url": "http://patches.dpdk.org/api/people/1873/?format=api",
        "name": "Alexander Kozyrev",
        "email": "akozyrev@nvidia.com"
    },
    "delegate": {
        "id": 319,
        "url": "http://patches.dpdk.org/api/users/319/?format=api",
        "username": "fyigit",
        "first_name": "Ferruh",
        "last_name": "Yigit",
        "email": "ferruh.yigit@amd.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/patch/20220118153557.3947859-1-akozyrev@nvidia.com/mbox/",
    "series": [
        {
            "id": 21235,
            "url": "http://patches.dpdk.org/api/series/21235/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=21235",
            "date": "2022-01-18T15:30:17",
            "name": "ethdev: datapath-focused flow rules management",
            "version": 2,
            "mbox": "http://patches.dpdk.org/series/21235/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/106038/comments/",
    "check": "success",
    "checks": "http://patches.dpdk.org/api/patches/106038/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 793D2A034C;\n\tTue, 18 Jan 2022 16:36:19 +0100 (CET)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 62DC84273B;\n\tTue, 18 Jan 2022 16:36:19 +0100 (CET)",
            "from NAM10-DM6-obe.outbound.protection.outlook.com\n (mail-dm6nam10on2075.outbound.protection.outlook.com [40.107.93.75])\n by mails.dpdk.org (Postfix) with ESMTP id 9FCFA4068E\n for <dev@dpdk.org>; Tue, 18 Jan 2022 16:36:18 +0100 (CET)",
            "from MWHPR1201MB0078.namprd12.prod.outlook.com\n (2603:10b6:301:56::20) by CY4PR12MB1128.namprd12.prod.outlook.com\n (2603:10b6:903:3e::13) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4909.7; Tue, 18 Jan\n 2022 15:36:16 +0000",
            "from DM5PR15CA0068.namprd15.prod.outlook.com (2603:10b6:3:ae::30) by\n MWHPR1201MB0078.namprd12.prod.outlook.com (2603:10b6:301:56::20) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.12; Tue, 18 Jan\n 2022 15:36:15 +0000",
            "from DM6NAM11FT021.eop-nam11.prod.protection.outlook.com\n (2603:10b6:3:ae:cafe::4b) by DM5PR15CA0068.outlook.office365.com\n (2603:10b6:3:ae::30) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.12 via Frontend\n Transport; Tue, 18 Jan 2022 15:36:14 +0000",
            "from mail.nvidia.com (12.22.5.235) by\n DM6NAM11FT021.mail.protection.outlook.com (10.13.173.76) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id\n 15.20.4888.9 via Frontend Transport; Tue, 18 Jan 2022 15:36:14 +0000",
            "from rnnvmail201.nvidia.com (10.129.68.8) by DRHQMAIL107.nvidia.com\n (10.27.9.16) with Microsoft SMTP Server (TLS) id 15.0.1497.18;\n Tue, 18 Jan 2022 15:36:14 +0000",
            "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_CBC_SHA384) id 15.2.986.9; Tue, 18 Jan 2022\n 07:36:10 -0800"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=jUkiUlER/MZW4iHkxkwLCCcbjRC9zvAfGuByBRllFlUSErLebeHsG/TZTsHUL1XPxHpzbu0HTllwmWsunx/6qhNCGhq7YVNPvotWBQW62YToDQfBvfsdUeZ6kjQaF03FCfE57+Y7JyIVnqwJNGerrPomsuWcRufW6e++LHMD5mKM5gdfxcIwgAIo08SJoZ0xcYkrbAwOskjAdag/YtoO+6RP8X/4FE2VTOW5wn0t38wZ5xMDxojsWA+l6NP4X0k1z4xL/si62+MaDLmqcN1pawBIEC0/2k4wYk13nmvchPGOMWnJ1DKaGbfgAFncBBXE4qczXw3h0LdQalSwJYLxXQ==",
        "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=y+LSKXYCkmmWKSy3X5QJ7e0bRzJRUbY04qmSXgW7SCA=;\n b=Jx0B8JfwsVHEHJum98eGSaz5NwBp97JEoRRjpToE8kz8Ovkd64Yul/9V4jDPr5czYtcBWwXeOxLHNW2LIDTffNhGupW2Ae1aauMt23Wx3xXIkQhB5NO8twu9XtoOQojmfM+96qNGPFN/rzEoJezCe/I9ZYJFIOctwYgTkClJerNB5JPd499fPV2IEj77gfS+KYJ+klJFexo9gzREvWHb9vDVzA11z4eObwmQCVigMmYw0KE0m4sYio7hQRJkAqhCHRKOHXfuF5hbOHCC44Z5l4mNcr8rrffVET4/lYX08iVQhp1JoGQOkvg0nJmpomr9bLRuKJFKBaw6Eg747Ep4yA==",
        "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 12.22.5.235) smtp.rcpttodomain=intel.com smtp.mailfrom=nvidia.com; dmarc=pass\n (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none\n (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=y+LSKXYCkmmWKSy3X5QJ7e0bRzJRUbY04qmSXgW7SCA=;\n b=QrqUX85y/SY0B4s51pcQ7ja698OR+ULovXz3U16XpSgazDy745ES6kZHGxTR6KP4U1uekpvVhy/Y0o9Un5g/nj14CDpN7WmvfpBsRrAKeSEs5oWGWbMTK80SSILU7rQgjzdWUckx0iP10a8CutNHJ3aLcjjoy39uu5njTxvR0aEDLQVvGQSrqE3FflxL0X7LexRR9DpHtpamuT0yRGzjCRDhmcXXvRvp6b1g9VkYETm4ry5uDCAxQ5tv9ywp9bnKaWqBmvXuy6T0EJ8HD9nylA7h625RCHd+66YHcYEP+0WPW6IwRKPsIrRwapvwDzzk43TgoV2Vg3C53YPl7GuQPA==",
        "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 12.22.5.235)\n smtp.mailfrom=nvidia.com; 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 12.22.5.235 as permitted sender) receiver=protection.outlook.com;\n client-ip=12.22.5.235; helo=mail.nvidia.com;",
        "From": "Alexander Kozyrev <akozyrev@nvidia.com>",
        "To": "<dev@dpdk.org>",
        "CC": "<orika@nvidia.com>, <thomas@monjalon.net>, <ivan.malov@oktetlabs.ru>,\n <andrew.rybchenko@oktetlabs.ru>, <ferruh.yigit@intel.com>,\n <mohammad.abdul.awal@intel.com>, <qi.z.zhang@intel.com>,\n <jerinj@marvell.com>, <ajit.khaparde@broadcom.com>",
        "Subject": "[v2,08/10] app/testpmd: implement rte flow queue drain",
        "Date": "Tue, 18 Jan 2022 17:35:57 +0200",
        "Message-ID": "<20220118153557.3947859-1-akozyrev@nvidia.com>",
        "X-Mailer": "git-send-email 2.18.2",
        "In-Reply-To": "<20220118153027.3947448-1-akozyrev@nvidia.com>",
        "References": "<20220118153027.3947448-1-akozyrev@nvidia.com>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain",
        "X-Originating-IP": "[10.126.230.35]",
        "X-ClientProxiedBy": "HQMAIL107.nvidia.com (172.20.187.13) To\n rnnvmail201.nvidia.com (10.129.68.8)",
        "X-EOPAttributedMessage": "0",
        "X-MS-PublicTrafficType": "Email",
        "X-MS-Office365-Filtering-Correlation-Id": "cc9c0063-fe8e-4e30-6391-08d9da98434a",
        "X-MS-TrafficTypeDiagnostic": "MWHPR1201MB0078:EE_|CY4PR12MB1128:EE_",
        "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr,ExtAddr",
        "X-Microsoft-Antispam-PRVS": "\n <MWHPR1201MB00780D4B67B234E2F7521E07AF589@MWHPR1201MB0078.namprd12.prod.outlook.com>",
        "X-MS-Oob-TLC-OOBClassifiers": "OLM:4714;",
        "X-MS-Exchange-SenderADCheck": "1",
        "X-MS-Exchange-AntiSpam-Relay": "0",
        "X-Microsoft-Antispam": "BCL:0;",
        "X-Microsoft-Antispam-Message-Info": "\n H8g1ta4Sw04AVdwZHx3uM3LM70NDluBgrQkdo/UikUj8WB4Q6Ji72nNxcoHq9STLkc1Sf+Por7dKPNvahltZgIXN5YLjiTrbsyrj3MWhr+8YegEynhz69vl7IEMw+BE6fpvgFD5yxE2FU6TX9enNCelvSz4GLDtkpSoQKSSlL6xs6/QenN6FuNbCxRBzkIcKjRJ+KNjnmTUmK7B3Saxs13bw6cDQLiiumTNMXe1Y20G6p4vMGfNodULNyZcLIrkpk747GH/lgp7X4qJtEOipsIaQ+4xcMpGwp++8H+8IRpycJ17grCyEvR5GHd2vjKZ/2N8VbYZV99nmP0TG7oFCQ2sYj2AwBJVMi7F1cmJNd0WOX2lBtZgSAn2q+dP079rx0GnnqP/t5zHhlcp6n9Oprcyu+ioXfhuWA33SecJvUfKOrJmeDfpxCYMf7rtAvYjZo+nCUIhBr8cPQ0ZZwM120NrodvJiKovGTTnMtK65PiHd0UNaakf6stjknQCFh4j9H7ekHF5iYHX+ITYpaki97mwRDzWTMQSTFXNZrjWBncLHyrD9tylEGrUdi6yFi0RsCd+SErdPH1MY7/F2zQSgSSQvV6xmWdyMjbp7nwkRxG5zfvYjA4iuJwFxlaUGEdMi2ofrCGQXSEqLkxEsfmvJX2plMLv45kdL+Yoqf2ef6SspSXK8oGtB4fwIrV7o/YRzfYlXofJdV3soWTx0D2RbOBwj9Y0LiSI3Nu9Ni78tNQZQ+Hyk5+Ta++fWp+tleL43150tGlFWYXUM1Q3GMK/um04lcE4hahqr2/46Of4qx8E=",
        "X-Forefront-Antispam-Report": "CIP:12.22.5.235; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:CAL; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE;\n SFS:(4636009)(40470700002)(36840700001)(46966006)(6666004)(8936002)(40460700001)(26005)(16526019)(426003)(1076003)(55016003)(82310400004)(6916009)(36756003)(8676002)(5660300002)(508600001)(4326008)(2616005)(70206006)(70586007)(86362001)(2906002)(6286002)(336012)(81166007)(356005)(83380400001)(54906003)(47076005)(7696005)(316002)(36860700001)(186003)(36900700001);\n DIR:OUT; SFP:1101;",
        "X-OriginatorOrg": "Nvidia.com",
        "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "18 Jan 2022 15:36:14.7374 (UTC)",
        "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n cc9c0063-fe8e-4e30-6391-08d9da98434a",
        "X-MS-Exchange-CrossTenant-Id": "43083d15-7273-40c1-b7db-39efd9ccc17a",
        "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.235];\n Helo=[mail.nvidia.com]",
        "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem",
        "X-MS-Exchange-CrossTenant-AuthSource": "\n DM6NAM11FT021.eop-nam11.prod.protection.outlook.com",
        "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous",
        "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "CY4PR12MB1128",
        "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": "Add testpmd support for the rte_flow_q_drain API.\nProvide the command line interface for the queue draining.\nUsage example: flow queue 0 drain 0\n\nSigned-off-by: Alexander Kozyrev <akozyrev@nvidia.com>\n---\n app/test-pmd/cmdline_flow.c                 | 56 ++++++++++++++++++++-\n app/test-pmd/config.c                       | 28 +++++++++++\n app/test-pmd/testpmd.h                      |  1 +\n doc/guides/testpmd_app_ug/testpmd_funcs.rst | 21 ++++++++\n 4 files changed, 105 insertions(+), 1 deletion(-)",
    "diff": "diff --git a/app/test-pmd/cmdline_flow.c b/app/test-pmd/cmdline_flow.c\nindex 6a8e6fc683..e94c01cf75 100644\n--- a/app/test-pmd/cmdline_flow.c\n+++ b/app/test-pmd/cmdline_flow.c\n@@ -93,6 +93,7 @@ enum index {\n \tTUNNEL,\n \tFLEX,\n \tQUEUE,\n+\tDRAIN,\n \n \t/* Flex arguments */\n \tFLEX_ITEM_INIT,\n@@ -131,6 +132,9 @@ enum index {\n \tQUEUE_DESTROY_ID,\n \tQUEUE_DESTROY_DRAIN,\n \n+\t/* Drain arguments. */\n+\tDRAIN_QUEUE,\n+\n \t/* Table arguments. */\n \tTABLE_CREATE,\n \tTABLE_DESTROY,\n@@ -2155,6 +2159,9 @@ static int parse_qo(struct context *, const struct token *,\n static int parse_qo_destroy(struct context *, const struct token *,\n \t\t\t    const char *, unsigned int,\n \t\t\t    void *, unsigned int);\n+static int parse_drain(struct context *, const struct token *,\n+\t\t       const char *, unsigned int,\n+\t\t       void *, unsigned int);\n static int parse_tunnel(struct context *, const struct token *,\n \t\t\tconst char *, unsigned int,\n \t\t\tvoid *, unsigned int);\n@@ -2432,7 +2439,8 @@ static const struct token token_list[] = {\n \t\t\t      ISOLATE,\n \t\t\t      TUNNEL,\n \t\t\t      FLEX,\n-\t\t\t      QUEUE)),\n+\t\t\t      QUEUE,\n+\t\t\t      DRAIN)),\n \t\t.call = parse_init,\n \t},\n \t/* Top-level command. */\n@@ -2767,6 +2775,21 @@ static const struct token token_list[] = {\n \t\t.call = parse_qo_destroy,\n \t},\n \t/* Top-level command. */\n+\t[DRAIN] = {\n+\t\t.name = \"drain\",\n+\t\t.help = \"drain a flow queue\",\n+\t\t.next = NEXT(NEXT_ENTRY(DRAIN_QUEUE), NEXT_ENTRY(COMMON_PORT_ID)),\n+\t\t.args = ARGS(ARGS_ENTRY(struct buffer, port)),\n+\t\t.call = parse_drain,\n+\t},\n+\t/* Sub-level commands. */\n+\t[DRAIN_QUEUE] = {\n+\t\t.name = \"queue\",\n+\t\t.help = \"specify queue id\",\n+\t\t.next = NEXT(NEXT_ENTRY(END), NEXT_ENTRY(COMMON_QUEUE_ID)),\n+\t\t.args = ARGS(ARGS_ENTRY(struct buffer, queue)),\n+\t},\n+\t/* Top-level command. */\n \t[INDIRECT_ACTION] = {\n \t\t.name = \"indirect_action\",\n \t\t.type = \"{command} {port_id} [{arg} [...]]\",\n@@ -8385,6 +8408,34 @@ parse_qo_destroy(struct context *ctx, const struct token *token,\n \t}\n }\n \n+/** Parse tokens for drain queue command. */\n+static int\n+parse_drain(struct context *ctx, const struct token *token,\n+\t    const char *str, unsigned int len,\n+\t    void *buf, unsigned int size)\n+{\n+\tstruct buffer *out = buf;\n+\n+\t/* Token name must match. */\n+\tif (parse_default(ctx, token, str, len, NULL, 0) < 0)\n+\t\treturn -1;\n+\t/* Nothing else to do if there is no buffer. */\n+\tif (!out)\n+\t\treturn len;\n+\tif (!out->command) {\n+\t\tif (ctx->curr != DRAIN)\n+\t\t\treturn -1;\n+\t\tif (sizeof(*out) > size)\n+\t\t\treturn -1;\n+\t\tout->command = ctx->curr;\n+\t\tctx->objdata = 0;\n+\t\tctx->object = out;\n+\t\tctx->objmask = NULL;\n+\t\tout->args.vc.data = (uint8_t *)out + size;\n+\t}\n+\treturn len;\n+}\n+\n static int\n parse_flex(struct context *ctx, const struct token *token,\n \t     const char *str, unsigned int len,\n@@ -9749,6 +9800,9 @@ cmd_flow_parsed(const struct buffer *in)\n \t\t\t\t\tin->args.destroy.rule_n,\n \t\t\t\t\tin->args.destroy.rule);\n \t\tbreak;\n+\tcase DRAIN:\n+\t\tport_queue_flow_drain(in->port, in->queue);\n+\t\tbreak;\n \tcase INDIRECT_ACTION_CREATE:\n \t\tport_action_handle_create(\n \t\t\t\tin->port, in->args.vc.attr.group,\ndiff --git a/app/test-pmd/config.c b/app/test-pmd/config.c\nindex 31164d6bf6..c6469dd06f 100644\n--- a/app/test-pmd/config.c\n+++ b/app/test-pmd/config.c\n@@ -2564,6 +2564,34 @@ port_queue_flow_destroy(portid_t port_id, queueid_t queue_id,\n \treturn ret;\n }\n \n+/** Drain all the queue operations down the queue. */\n+int\n+port_queue_flow_drain(portid_t port_id, queueid_t queue_id)\n+{\n+\tstruct rte_port *port;\n+\tstruct rte_flow_error error;\n+\tint ret = 0;\n+\n+\tif (port_id_is_invalid(port_id, ENABLED_WARN) ||\n+\t    port_id == (portid_t)RTE_PORT_ALL)\n+\t\treturn -EINVAL;\n+\tport = &ports[port_id];\n+\n+\tif (queue_id >= port->queue_nb) {\n+\t\tprintf(\"Queue #%u is invalid\\n\", queue_id);\n+\t\treturn -EINVAL;\n+\t}\n+\n+\tmemset(&error, 0x55, sizeof(error));\n+\tret = rte_flow_q_drain(port_id, queue_id, &error);\n+\tif (ret < 0) {\n+\t\tprintf(\"Failed to drain queue\\n\");\n+\t\treturn -EINVAL;\n+\t}\n+\tprintf(\"Queue #%u drained\\n\", queue_id);\n+\treturn ret;\n+}\n+\n /** Create flow rule. */\n int\n port_flow_create(portid_t port_id,\ndiff --git a/app/test-pmd/testpmd.h b/app/test-pmd/testpmd.h\nindex 99845b9e2f..bf4597e7ba 100644\n--- a/app/test-pmd/testpmd.h\n+++ b/app/test-pmd/testpmd.h\n@@ -934,6 +934,7 @@ int port_queue_flow_create(portid_t port_id, queueid_t queue_id,\n \t\t\t   const struct rte_flow_action *actions);\n int port_queue_flow_destroy(portid_t port_id, queueid_t queue_id,\n \t\t\t    bool drain, uint32_t n, const uint32_t *rule);\n+int port_queue_flow_drain(portid_t port_id, queueid_t queue_id);\n int port_flow_validate(portid_t port_id,\n \t\t       const struct rte_flow_attr *attr,\n \t\t       const struct rte_flow_item *pattern,\ndiff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst\nindex eb9dff7221..2ff4e4aef1 100644\n--- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst\n+++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst\n@@ -3368,6 +3368,10 @@ following sections.\n    flow queue {port_id} destroy {queue_id}\n        [drain {boolean}] rule {rule_id} [...]\n \n+- Drain a queue::\n+\n+   flow drain {port_id} queue {queue_id}\n+\n - Create a flow rule::\n \n    flow create {port_id}\n@@ -3561,6 +3565,23 @@ The usual error message is shown when a table cannot be destroyed::\n \n    Caught error type [...] ([...]): [...]\n \n+Draining a flow queue\n+~~~~~~~~~~~~~~~~~~~~~\n+\n+``flow drain`` drains the specific queue to push all the\n+outstanding queued operations to the underlying device immediately.\n+It is bound to ``rte_flow_q_drain()``::\n+\n+   flow drain {port_id} queue {queue_id}\n+\n+If successful, it will show::\n+\n+   Queue #[...] drained\n+\n+The usual error message is shown when a queue cannot be drained::\n+\n+   Caught error type [...] ([...]): [...]\n+\n Creating a tunnel stub for offload\n ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n \n",
    "prefixes": [
        "v2",
        "08/10"
    ]
}