get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 105996,
    "url": "http://patchwork.dpdk.org/api/patches/105996/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20220118050802.3915187-9-akozyrev@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": "<20220118050802.3915187-9-akozyrev@nvidia.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20220118050802.3915187-9-akozyrev@nvidia.com",
    "date": "2022-01-18T05:08:00",
    "name": "[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://patchwork.dpdk.org/api/people/1873/?format=api",
        "name": "Alexander Kozyrev",
        "email": "akozyrev@nvidia.com"
    },
    "delegate": {
        "id": 319,
        "url": "http://patchwork.dpdk.org/api/users/319/?format=api",
        "username": "fyigit",
        "first_name": "Ferruh",
        "last_name": "Yigit",
        "email": "ferruh.yigit@amd.com"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20220118050802.3915187-9-akozyrev@nvidia.com/mbox/",
    "series": [
        {
            "id": 21222,
            "url": "http://patchwork.dpdk.org/api/series/21222/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=21222",
            "date": "2022-01-18T05:02:11",
            "name": "ethdev: datapath-focused flow rules management",
            "version": 1,
            "mbox": "http://patchwork.dpdk.org/series/21222/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/patches/105996/comments/",
    "check": "success",
    "checks": "http://patchwork.dpdk.org/api/patches/105996/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 C6920A00C3;\n\tTue, 18 Jan 2022 06:09:26 +0100 (CET)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id B8D5A426E4;\n\tTue, 18 Jan 2022 06:09:26 +0100 (CET)",
            "from NAM11-BN8-obe.outbound.protection.outlook.com\n (mail-bn8nam11on2050.outbound.protection.outlook.com [40.107.236.50])\n by mails.dpdk.org (Postfix) with ESMTP id 0697B426E2\n for <dev@dpdk.org>; Tue, 18 Jan 2022 06:09:25 +0100 (CET)",
            "from CH0PR12MB5138.namprd12.prod.outlook.com (2603:10b6:610:bd::17)\n by BN6PR1201MB0227.namprd12.prod.outlook.com (2603:10b6:405:4e::7)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.11; Tue, 18 Jan\n 2022 05:09:23 +0000",
            "from MWHPR14CA0047.namprd14.prod.outlook.com (2603:10b6:300:12b::33)\n by CH0PR12MB5138.namprd12.prod.outlook.com (2603:10b6:610:bd::17)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.10; Tue, 18 Jan\n 2022 05:09:21 +0000",
            "from CO1NAM11FT067.eop-nam11.prod.protection.outlook.com\n (2603:10b6:300:12b:cafe::20) by MWHPR14CA0047.outlook.office365.com\n (2603:10b6:300:12b::33) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4888.10 via Frontend\n Transport; Tue, 18 Jan 2022 05:09:21 +0000",
            "from mail.nvidia.com (12.22.5.235) by\n CO1NAM11FT067.mail.protection.outlook.com (10.13.174.212) 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 05:09:21 +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 05:09:20 +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; Mon, 17 Jan 2022\n 21:09:17 -0800"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=UxfQ3pXQGdkvUH0Qreyv3BIbTFMeyrRjntqAleNQf8hrPhwGxohANrf9JDVfS+9FYobrBDRTEkjl+ik8bKP5cebueFBL5GCi9rshdX0N++lC3wN9hyZ+VAvHvPaNV3XVgyASaYV9Yo4rWULVbMREsxTH39ZqmBLOCMkbiuKJw0TWhAtaWWNqS/Az4Qb/OW+lZMTckD4U9Ebb9Gvzd2EoITuSlx29Tm+rooGEnssRTmVjVlAZLNFoXtjbJYwieM0kU+EXMQE8wq+w7hffPpopZDxCNRoZsHPbyn1biC+q/7/cv1FHs84AUirJfpMo49169JsfJq1Uv8duEf/PQwPUvw==",
        "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=WFYJYE0MrAKuURCewd7XT4l+MGQFIk2u24xvOj/T8K0wICylmBdu7UciPTkHk/5uU2eTqVPB2zNsTVjeSTuIjrMH4pxSVvrpVGnnSLCFymJmIKocjzZ72Zt8wzpM4Moyfx2f4Bg08l5xTxCPiDqLEw1WrzWHAMdDZDO4G/RJA1g7AITpUKXctG58MTpLJqj2g7e2hfD673DlJCMqrREYyzttcFSsX0dRFUEAOksWOZvvrA62K0AblK49Y1jeAwDXNRtJHIh6/YMCNBbZWgS7Hb0IQ5JaBZodYFJ79MYdXU4OLTh7zaxQgV1t04mJJmB2R6wv+hDXADseyz11SpWUMw==",
        "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=GSu9/Gr9AiCcWBIKQXQI1dPTIhbXRZgPchuk2iPhFQDK1Q1kkiXIJ52TnGN2N6fycFu64MS6269PBZZW7ykpUKmWR0SapON8I+Xj6yMmLGqZkn1QJ6dax7KPzy2/p43u8OysexWXTZzGmkbymPbeDeLKlSFdbsFp3WpvVtn/O6UpcMbd8Amui+e+8hDMx+Oh0pYYATYv9wBCqy9ieiHk1qaP3czZ3XbMdoo1h0L6iXvca7lTXZOugVRtG5kyxBwkF8Gnf5GsMGM44ZEj7dJZZWghSSoyQTSYhzO5uyijW6Vk6BuEE8aO57n86k11mTpjM87D0fXm+/8MkxaptmQTRA==",
        "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": "[PATCH 08/10] app/testpmd: implement rte flow queue drain",
        "Date": "Tue, 18 Jan 2022 07:08:00 +0200",
        "Message-ID": "<20220118050802.3915187-9-akozyrev@nvidia.com>",
        "X-Mailer": "git-send-email 2.18.2",
        "In-Reply-To": "<20220118050802.3915187-6-akozyrev@nvidia.com>",
        "References": "<20220118050802.3915187-6-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": "35edd853-9f8c-4c36-f661-08d9da40afd5",
        "X-MS-TrafficTypeDiagnostic": "CH0PR12MB5138:EE_|BN6PR1201MB0227:EE_",
        "X-LD-Processed": "43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr,ExtAddr",
        "X-Microsoft-Antispam-PRVS": "\n <CH0PR12MB513881FB92DFA568871DD673AF589@CH0PR12MB5138.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 P5V2uq7yk+w6K1Z8sH97lLTlzGypfEZOlBF997Fnw8rMVN3fYcx5bS7ecVcxBQSexO69FJXKqPwZyInJ5SAXWfwhVYPweyqc2byy5fBxF8fxPrkdmRQ2yI/tUGYyp27F3xYsKZugsHCDWxsCE0yXZWhi6AmHc2AxZmCdbF+D1A8Y163AEk+GRAdZbFqHm9Kwi8mbOB+usSGU+f7gXOWkT90YX9C4TZpU6dEbZhBob8mw/XDGXlhNrewh/t5lQ/7SorwXTK6nT4QF7BSAOes3QYCLRBTxuVnV1eIz/bcC2ge71LyKXNWvvpkaPw8oc0423LXPgbp5bbAPweMDzty2Dxn3CThPgVmEXgqcNaw4YEihsYoB0cVzotGMZdnhOBPo2slZVVQbN7fdlzn7jsuLtGyTz7IJcjJIzKxzVG0bffwi/cY+HSTW5xI31tyawvkvnNfgxgL5DmCALdOAbBsxcCnGECrD6UhG9/y0NARb3VgScmIDH49epdPNj4B4D8UyWcq5SeExLWzuF8BWFZxoEtoIghJ1h54onfJ8zSh3GJzoPPyP1MnAimax1d8mbc5349XQNgq58yp8wh/oGuHjTsBw3EXb2WyCkl3ncRMW9mcftc/Qj9fGjYf1WlpyRt3LKo9uOSGeYkFCz5c8blewXNpIeuYcd0xn7/NeriRr29Sv6NODmZgUVbcRuJNHfjP6/8i6T4KUj4smas8r+uFJq6RWdTlRAUJX4NREkBPpdkHGM9gDtxSRSwALpNrmvBFu+oRAoS94pmRFDOlivj4asZSrLYXkX5C+pcNtpbm3wL0=",
        "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)(83380400001)(70206006)(70586007)(36860700001)(8936002)(1076003)(4326008)(6666004)(508600001)(426003)(6286002)(82310400004)(2906002)(5660300002)(7696005)(55016003)(6916009)(81166007)(8676002)(40460700001)(356005)(36756003)(47076005)(2616005)(54906003)(316002)(336012)(86362001)(26005)(186003)(16526019)(36900700001);\n DIR:OUT; SFP:1101;",
        "X-OriginatorOrg": "Nvidia.com",
        "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "18 Jan 2022 05:09:21.1339 (UTC)",
        "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 35edd853-9f8c-4c36-f661-08d9da40afd5",
        "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 CO1NAM11FT067.eop-nam11.prod.protection.outlook.com",
        "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous",
        "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "BN6PR1201MB0227",
        "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": [
        "08/10"
    ]
}