From patchwork Tue Feb 14 15:48:35 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jiawei Wang X-Patchwork-Id: 123901 X-Patchwork-Delegate: ferruh.yigit@amd.com Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 6D2DF41C96; Tue, 14 Feb 2023 16:49:18 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 57F6F42DAF; Tue, 14 Feb 2023 16:49:18 +0100 (CET) Received: from NAM10-MW2-obe.outbound.protection.outlook.com (mail-mw2nam10on2073.outbound.protection.outlook.com [40.107.94.73]) by mails.dpdk.org (Postfix) with ESMTP id 12E2A410D1 for ; Tue, 14 Feb 2023 16:49:16 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=IjVAvhJFt/h4wt/WwrOEJlIpnoOCli0DzsJ+kGZDvtOxakyK1SWzFK4hcpoj7EX/pSSZ0ghZeUpZlXvKzY4rwM9zmZtWqY5//00Ye+Fiwif6hOqojxUy5cPKE1oYyDUW/4Qpn0qtBZHfQhzz3+nNXZ1XfN4fauW+SXxfPQYfqesCPorzsgy4i7Ave8WiaqW3n/CYr4MXYgrf21+Fo2zY1g6OarHAnBt9T2n2j80SxeJXxN5hW4CsurvKYXUbPEyzVL5egi8TnSgA9jeaAiuN8a4emZvdXjvBolZ/Pn7ya80Ugn/DxLVJQPmwdkmmDYvGWbxMQWoMew2pkdXMc37vzw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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; bh=sNA7HQaPehyLIfgp4nZ0UJvA2Ru+V3F2uLS0hY6P4GU=; b=a+/aRuyEyOvgJJaufdrOU54SsssEs0+BpDex2Zuvh9WQMrTFbRPxH5od4sj7f9Q0wsTK/c3cfY7qjMcKucL1WgpOeo9yxqNWPZoEbobQbGXl4vFXoeGu1Gs7f/Hc9g/F3+LJNQr7dfS48webs7F/bxmq62TlhZnPnPid02ctJliVdnBG5fGoej1vLtfDttM82s08bgDt67NfodZ7zfrvBRYKkRrgm1l0CrPHUWthgF2AAQkTqv7W2hZ0Q3FSyRp/dkRT1QwDmoST2USC3rN15ewyMPHBgL+doBUYob+6jb9ia1YQi2FwyL9h/AnoMJ3Ev9sXudLWWhsY53DwL841mw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) smtp.rcpttodomain=monjalon.net smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=sNA7HQaPehyLIfgp4nZ0UJvA2Ru+V3F2uLS0hY6P4GU=; b=PZiTnw8eQ0aNkCSTD4qJEZQGlipqKLDS12eKBuBJBSCXkh5kPAjpC1CxE9ibhshuPCihPPmj1brztACnQ7G99C18OyZ4432qDgMbBrgdgJ0us7DhWQblfbk8EcDjXHhuMbKGVvL9XiC2VP7BiuMR/4qarD5qOdLCu3d83bBH3GLgq0wMzm1642zn6CQNCxdUODlziZXO+CudpiphB8ON3U3g+jDzjry72Pek++mvVlcV0IGbAiKSQn7pRdtAGFCuRHv3Ox6ZywDXPLWrhC5LUmibRYTMDlbFjD5m10+GNepmR/MaPLI7Wh+wtAn0H72+1anGqInvezZxV1Wssu637w== Received: from DS7PR03CA0087.namprd03.prod.outlook.com (2603:10b6:5:3bb::32) by PH8PR12MB6913.namprd12.prod.outlook.com (2603:10b6:510:1ca::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6086.19; Tue, 14 Feb 2023 15:49:13 +0000 Received: from CY4PEPF0000C96D.namprd02.prod.outlook.com (2603:10b6:5:3bb:cafe::54) by DS7PR03CA0087.outlook.office365.com (2603:10b6:5:3bb::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6086.26 via Frontend Transport; Tue, 14 Feb 2023 15:49:13 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.161) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.117.161 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.161; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.161) by CY4PEPF0000C96D.mail.protection.outlook.com (10.167.242.5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6111.8 via Frontend Transport; Tue, 14 Feb 2023 15:49:12 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.67) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Tue, 14 Feb 2023 07:49:02 -0800 Received: from nvidia.com (10.126.231.37) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Tue, 14 Feb 2023 07:48:59 -0800 From: Jiawei Wang To: , , , , Aman Singh , Yuying Zhang , Ferruh Yigit CC: , Subject: [PATCH v5 1/2] ethdev: introduce the Tx map API for aggregated ports Date: Tue, 14 Feb 2023 17:48:35 +0200 Message-ID: <20230214154836.9681-2-jiaweiw@nvidia.com> X-Mailer: git-send-email 2.18.1 In-Reply-To: <20230214154836.9681-1-jiaweiw@nvidia.com> References: <20230203050717.46914-1-jiaweiw@nvidia.com> <20230214154836.9681-1-jiaweiw@nvidia.com> MIME-Version: 1.0 X-Originating-IP: [10.126.231.37] X-ClientProxiedBy: rnnvmail202.nvidia.com (10.129.68.7) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CY4PEPF0000C96D:EE_|PH8PR12MB6913:EE_ X-MS-Office365-Filtering-Correlation-Id: 1a6c4b68-503a-44d0-bc9f-08db0ea304eb 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: 2fa8CE0J2JdaBkXISYZB/ksNsOFg++DsH/67No8oZZZ5XiO7hs/7om2TFzcsiu0HQnlQH3XTTi7OKv0MN7aKFoDNkLdqK9TUeRa0hnDtlMv3cQxzm6GLAcfhfbNnAHWipmrpDPmXDvwf5v9uxTSnV883KBCOdSuj7imTnfiTPTSDv6Zwav7E+vOCVCGarB0nRDcCIAFZ7L0xwYrkdkploNNsu50IUqXhXBFvyqKo8o7NuRinEqerwiW7WzHkrS5KW1G6wLCHrDkTOVgu+rHU7gbjpGArDyMz9M/R7I3+weoxHJu8DG2Du0S9FYJKCZJxz6/XWwMR29BD0o5mucw17CcHNRmzxBvrJYo4kf+bRoiChRatw9dcTiGdE8B7PnSsuIMMri1CBamdeiKEkECGH6KRQRaefk7VIQG96kOwhvxfde1SzduurWOV93Omv4MrXMs+r4lKk3TOMd1tv388+u0pOI3McAFSF9sjpyw4txohUCXh+OcXLMhYwPZafPVeQjTPpMc50n2vtsl4YiOfw4sMjn3U3u5gBt/hCfdaULIiHa65FzZD9xhvm0ijHFLaxk9qkaxHD70A8q8X2R1+HpIRWNqzTdjjHwgPFBEX6qQ8sY3H1EwF9HZ3gDcIls7UfolGs+bFYJbrxxcWJgwQhmR8UzyRl6CGVfur5dsPNVBKeHJkhOKgW95ja6wKDJxQarrvFdCpKg0NzfAG15zVKw== X-Forefront-Antispam-Report: CIP:216.228.117.161; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge2.nvidia.com; CAT:NONE; SFS:(13230025)(4636009)(396003)(346002)(136003)(376002)(39860400002)(451199018)(46966006)(40470700004)(36840700001)(336012)(1076003)(47076005)(426003)(478600001)(83380400001)(16526019)(107886003)(6666004)(6286002)(7696005)(186003)(356005)(7636003)(26005)(36756003)(316002)(86362001)(2616005)(82310400005)(82740400003)(40480700001)(55016003)(70586007)(8676002)(40460700003)(5660300002)(30864003)(54906003)(41300700001)(36860700001)(110136005)(8936002)(4326008)(70206006)(2906002); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Feb 2023 15:49:12.6354 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 1a6c4b68-503a-44d0-bc9f-08db0ea304eb X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.161]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CY4PEPF0000C96D.namprd02.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH8PR12MB6913 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org When multiple ports are aggregated into a single DPDK port, (example: Linux bonding, DPDK bonding, failsafe, etc.), we want to know which port use for Tx via a queue. This patch introduces the new ethdev API rte_eth_dev_map_aggr_tx_affinity(), it's used to map a Tx queue with an aggregated port of the DPDK port (specified with port_id), The affinity is the number of the aggregated port. Value 0 means no affinity and traffic could be routed to any aggregated port, this is the default current behavior. The maximum number of affinity is given by rte_eth_dev_count_aggr_ports(). Add the trace point for ethdev rte_eth_dev_count_aggr_ports() and rte_eth_dev_map_aggr_tx_affinity() functions. Add the testpmd command line: testpmd> port config (port_id) txq (queue_id) affinity (value) For example, there're two physical ports connected to a single DPDK port (port id 0), and affinity 1 stood for the first physical port and affinity 2 stood for the second physical port. Use the below commands to config tx phy affinity for per Tx Queue: port config 0 txq 0 affinity 1 port config 0 txq 1 affinity 1 port config 0 txq 2 affinity 2 port config 0 txq 3 affinity 2 These commands config the Tx Queue index 0 and Tx Queue index 1 with phy affinity 1, uses Tx Queue 0 or Tx Queue 1 send packets, these packets will be sent from the first physical port, and similar with the second physical port if sending packets with Tx Queue 2 or Tx Queue 3. Signed-off-by: Jiawei Wang Acked-by: Thomas Monjalon --- app/test-pmd/cmdline.c | 96 +++++++++++++++++++++ doc/guides/rel_notes/release_23_03.rst | 7 ++ doc/guides/testpmd_app_ug/testpmd_funcs.rst | 14 +++ lib/ethdev/ethdev_driver.h | 39 +++++++++ lib/ethdev/ethdev_trace.h | 17 ++++ lib/ethdev/ethdev_trace_points.c | 6 ++ lib/ethdev/rte_ethdev.c | 49 +++++++++++ lib/ethdev/rte_ethdev.h | 46 ++++++++++ lib/ethdev/version.map | 2 + 9 files changed, 276 insertions(+) diff --git a/app/test-pmd/cmdline.c b/app/test-pmd/cmdline.c index bb7ff2b449..36c798ac45 100644 --- a/app/test-pmd/cmdline.c +++ b/app/test-pmd/cmdline.c @@ -776,6 +776,10 @@ static void cmd_help_long_parsed(void *parsed_result, "port cleanup (port_id) txq (queue_id) (free_cnt)\n" " Cleanup txq mbufs for a specific Tx queue\n\n" + + "port config (port_id) txq (queue_id) affinity (value)\n" + " Map a Tx queue with an aggregated port " + "of the DPDK port\n\n" ); } @@ -12636,6 +12640,97 @@ static cmdline_parse_inst_t cmd_show_port_flow_transfer_proxy = { } }; +/* *** configure port txq affinity value *** */ +struct cmd_config_tx_affinity_map { + cmdline_fixed_string_t port; + cmdline_fixed_string_t config; + portid_t portid; + cmdline_fixed_string_t txq; + uint16_t qid; + cmdline_fixed_string_t affinity; + uint8_t value; +}; + +static void +cmd_config_tx_affinity_map_parsed(void *parsed_result, + __rte_unused struct cmdline *cl, + __rte_unused void *data) +{ + struct cmd_config_tx_affinity_map *res = parsed_result; + int ret; + + if (port_id_is_invalid(res->portid, ENABLED_WARN)) + return; + + if (res->portid == (portid_t)RTE_PORT_ALL) { + printf("Invalid port id\n"); + return; + } + + if (strcmp(res->txq, "txq")) { + printf("Unknown parameter\n"); + return; + } + if (tx_queue_id_is_invalid(res->qid)) + return; + + ret = rte_eth_dev_count_aggr_ports(res->portid); + if (ret < 0) { + printf("Failed to count the aggregated ports: (%s)\n", + strerror(-ret)); + return; + } + if (ret == 0) { + printf("Number of aggregated ports is 0 which is invalid for affinity mapping\n"); + return; + } + if (ret < res->value) { + printf("The affinity value %u is Invalid, exceeds the " + "number of aggregated ports\n", res->value); + return; + } + + rte_eth_dev_map_aggr_tx_affinity(res->portid, res->qid, res->value); +} + +cmdline_parse_token_string_t cmd_config_tx_affinity_map_port = + TOKEN_STRING_INITIALIZER(struct cmd_config_tx_affinity_map, + port, "port"); +cmdline_parse_token_string_t cmd_config_tx_affinity_map_config = + TOKEN_STRING_INITIALIZER(struct cmd_config_tx_affinity_map, + config, "config"); +cmdline_parse_token_num_t cmd_config_tx_affinity_map_portid = + TOKEN_NUM_INITIALIZER(struct cmd_config_tx_affinity_map, + portid, RTE_UINT16); +cmdline_parse_token_string_t cmd_config_tx_affinity_map_txq = + TOKEN_STRING_INITIALIZER(struct cmd_config_tx_affinity_map, + txq, "txq"); +cmdline_parse_token_num_t cmd_config_tx_affinity_map_qid = + TOKEN_NUM_INITIALIZER(struct cmd_config_tx_affinity_map, + qid, RTE_UINT16); +cmdline_parse_token_string_t cmd_config_tx_affinity_map_affinity = + TOKEN_STRING_INITIALIZER(struct cmd_config_tx_affinity_map, + affinity, "affinity"); +cmdline_parse_token_num_t cmd_config_tx_affinity_map_value = + TOKEN_NUM_INITIALIZER(struct cmd_config_tx_affinity_map, + value, RTE_UINT8); + +static cmdline_parse_inst_t cmd_config_tx_affinity_map = { + .f = cmd_config_tx_affinity_map_parsed, + .data = (void *)0, + .help_str = "port config txq affinity ", + .tokens = { + (void *)&cmd_config_tx_affinity_map_port, + (void *)&cmd_config_tx_affinity_map_config, + (void *)&cmd_config_tx_affinity_map_portid, + (void *)&cmd_config_tx_affinity_map_txq, + (void *)&cmd_config_tx_affinity_map_qid, + (void *)&cmd_config_tx_affinity_map_affinity, + (void *)&cmd_config_tx_affinity_map_value, + NULL, + }, +}; + /* ******************************************************************************** */ /* list of instructions */ @@ -12869,6 +12964,7 @@ static cmdline_parse_ctx_t builtin_ctx[] = { (cmdline_parse_inst_t *)&cmd_show_port_cman_capa, (cmdline_parse_inst_t *)&cmd_show_port_cman_config, (cmdline_parse_inst_t *)&cmd_set_port_cman_config, + (cmdline_parse_inst_t *)&cmd_config_tx_affinity_map, NULL, }; diff --git a/doc/guides/rel_notes/release_23_03.rst b/doc/guides/rel_notes/release_23_03.rst index ab998a5357..becf6fed91 100644 --- a/doc/guides/rel_notes/release_23_03.rst +++ b/doc/guides/rel_notes/release_23_03.rst @@ -68,6 +68,13 @@ New Features * Applications can register a callback at startup via ``rte_lcore_register_usage_cb()`` to provide lcore usage information. +* **Added support for Tx queue mapping with an aggregated port.** + + * Introduced new function ``rte_eth_dev_count_aggr_ports()`` + to get the number of aggregated ports. + * Introduced new function ``rte_eth_dev_map_aggr_tx_affinity()`` + to map a Tx queue with an aggregated port of the DPDK port. + * **Added rte_flow support for matching IPv6 routing extension header fields.** Added ``ipv6_routing_ext`` items in rte_flow to match IPv6 routing extension diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst index 357adb09d7..1d3c372601 100644 --- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst +++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst @@ -1612,6 +1612,20 @@ Enable or disable a per queue Tx offloading only on a specific Tx queue:: This command should be run when the port is stopped, or else it will fail. +config per queue Tx affinity mapping +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Map a Tx queue with an aggregated port of the DPDK port (specified with port_id):: + + testpmd> port (port_id) txq (queue_id) affinity (value) + +* ``affinity``: the number of the aggregated port. + When multiple ports are aggregated into a single one, + it allows to choose which port to use for Tx via a queue. + +This command should be run when the port is stopped, otherwise it fails. + + Config VXLAN Encap outer layers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/lib/ethdev/ethdev_driver.h b/lib/ethdev/ethdev_driver.h index 6a550cfc83..b7fdc454a8 100644 --- a/lib/ethdev/ethdev_driver.h +++ b/lib/ethdev/ethdev_driver.h @@ -1171,6 +1171,40 @@ typedef int (*eth_tx_descriptor_dump_t)(const struct rte_eth_dev *dev, uint16_t queue_id, uint16_t offset, uint16_t num, FILE *file); +/** + * @internal + * Get the number of aggregated ports. + * + * @param port_id + * The port identifier of the Ethernet device. + * + * @return + * Negative errno value on error, 0 or positive on success. + * + * @retval >=0 + * The number of aggregated port if success. + * @retval -ENOTSUP + * Get aggregated ports API is not supported. + */ +typedef int (*eth_count_aggr_ports_t)(uint16_t port_id); + +/** + * @internal + * Map a Tx queue with an aggregated port of the DPDK port. + * + * @param port_id + * The identifier of the port used in rte_eth_tx_burst(). + * @param tx_queue_id + * The index of the transmit queue used in rte_eth_tx_burst(). + * @param affinity + * The number of the aggregated port. + * + * @return + * Negative on error, 0 on success. + */ +typedef int (*eth_map_aggr_tx_affinity_t)(uint16_t port_id, uint16_t tx_queue_id, + uint8_t affinity); + /** * @internal A structure containing the functions exported by an Ethernet driver. */ @@ -1403,6 +1437,11 @@ struct eth_dev_ops { eth_cman_config_set_t cman_config_set; /** Retrieve congestion management configuration */ eth_cman_config_get_t cman_config_get; + + /** Get the number of aggregated ports */ + eth_count_aggr_ports_t count_aggr_ports; + /** Map a Tx queue with an aggregated port of the DPDK port */ + eth_map_aggr_tx_affinity_t map_aggr_tx_affinity; }; /** diff --git a/lib/ethdev/ethdev_trace.h b/lib/ethdev/ethdev_trace.h index 9fae22c490..4e210d099b 100644 --- a/lib/ethdev/ethdev_trace.h +++ b/lib/ethdev/ethdev_trace.h @@ -1385,6 +1385,23 @@ RTE_TRACE_POINT( rte_trace_point_emit_int(ret); ) +RTE_TRACE_POINT( + rte_eth_trace_count_aggr_ports, + RTE_TRACE_POINT_ARGS(uint16_t port_id, int ret), + rte_trace_point_emit_u16(port_id); + rte_trace_point_emit_int(ret); +) + +RTE_TRACE_POINT( + rte_eth_trace_map_aggr_tx_affinity, + RTE_TRACE_POINT_ARGS(uint16_t port_id, uint16_t tx_queue_id, + uint8_t affinity, int ret), + rte_trace_point_emit_u16(port_id); + rte_trace_point_emit_u16(tx_queue_id); + rte_trace_point_emit_u8(affinity); + rte_trace_point_emit_int(ret); +) + RTE_TRACE_POINT( rte_flow_trace_dynf_metadata_register, RTE_TRACE_POINT_ARGS(int offset, uint64_t flag), diff --git a/lib/ethdev/ethdev_trace_points.c b/lib/ethdev/ethdev_trace_points.c index 34d12e2859..61010cae56 100644 --- a/lib/ethdev/ethdev_trace_points.c +++ b/lib/ethdev/ethdev_trace_points.c @@ -475,6 +475,12 @@ RTE_TRACE_POINT_REGISTER(rte_eth_trace_cman_config_set, RTE_TRACE_POINT_REGISTER(rte_eth_trace_cman_config_get, lib.ethdev.cman_config_get) +RTE_TRACE_POINT_REGISTER(rte_eth_trace_count_aggr_ports, + lib.ethdev.count_aggr_ports) + +RTE_TRACE_POINT_REGISTER(rte_eth_trace_map_aggr_tx_affinity, + lib.ethdev.map_aggr_tx_affinity) + RTE_TRACE_POINT_REGISTER(rte_flow_trace_copy, lib.ethdev.flow.copy) diff --git a/lib/ethdev/rte_ethdev.c b/lib/ethdev/rte_ethdev.c index dc0a4eb12c..1d5b3a16b2 100644 --- a/lib/ethdev/rte_ethdev.c +++ b/lib/ethdev/rte_ethdev.c @@ -6915,6 +6915,55 @@ rte_eth_buffer_split_get_supported_hdr_ptypes(uint16_t port_id, uint32_t *ptypes return j; } +int rte_eth_dev_count_aggr_ports(uint16_t port_id) +{ + struct rte_eth_dev *dev; + int ret; + + RTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV); + dev = &rte_eth_devices[port_id]; + + if (*dev->dev_ops->count_aggr_ports == NULL) + return -ENOTSUP; + ret = eth_err(port_id, (*dev->dev_ops->count_aggr_ports)(port_id)); + + rte_eth_trace_count_aggr_ports(port_id, ret); + + return ret; +} + +int rte_eth_dev_map_aggr_tx_affinity(uint16_t port_id, uint16_t tx_queue_id, + uint8_t affinity) +{ + struct rte_eth_dev *dev; + int ret; + + RTE_ETH_VALID_PORTID_OR_ERR_RET(port_id, -ENODEV); + dev = &rte_eth_devices[port_id]; + + if (tx_queue_id >= dev->data->nb_tx_queues) { + RTE_ETHDEV_LOG(ERR, "Invalid Tx queue_id=%u\n", tx_queue_id); + return -EINVAL; + } + + if (*dev->dev_ops->map_aggr_tx_affinity == NULL) + return -ENOTSUP; + + if (dev->data->dev_started) { + RTE_ETHDEV_LOG(ERR, + "Port %u must be stopped to allow configuration\n", + port_id); + return -EBUSY; + } + + ret = eth_err(port_id, (*dev->dev_ops->map_aggr_tx_affinity)(port_id, + tx_queue_id, affinity)); + + rte_eth_trace_map_aggr_tx_affinity(port_id, tx_queue_id, affinity, ret); + + return ret; +} + RTE_LOG_REGISTER_DEFAULT(rte_eth_dev_logtype, INFO); RTE_INIT(ethdev_init_telemetry) diff --git a/lib/ethdev/rte_ethdev.h b/lib/ethdev/rte_ethdev.h index c129ca1eaf..07b8250eb8 100644 --- a/lib/ethdev/rte_ethdev.h +++ b/lib/ethdev/rte_ethdev.h @@ -2589,6 +2589,52 @@ int rte_eth_hairpin_bind(uint16_t tx_port, uint16_t rx_port); __rte_experimental int rte_eth_hairpin_unbind(uint16_t tx_port, uint16_t rx_port); +/** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice. + * + * Get the number of aggregated ports. + * + * @param port_id + * The port identifier of the Ethernet device. + * @return + * - (>=0) the number of aggregated port if success. + * - (-ENOTSUP) if not supported. + */ +__rte_experimental +int rte_eth_dev_count_aggr_ports(uint16_t port_id); + +/** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice. + * + * Map a Tx queue with an aggregated port of the DPDK port (specified with port_id). + * When multiple ports are aggregated into a single one, + * it allows to choose which port to use for Tx via a queue. + * + * The application should use rte_eth_dev_map_aggr_tx_affinity() + * after rte_eth_dev_configure(), rte_eth_tx_queue_setup(), and + * before rte_eth_dev_start(). + * + * @param port_id + * The identifier of the port used in rte_eth_tx_burst(). + * @param tx_queue_id + * The index of the transmit queue used in rte_eth_tx_burst(). + * The value must be in the range [0, nb_tx_queue - 1] previously supplied + * to rte_eth_dev_configure(). + * @param affinity + * The number of the aggregated port. + * Value 0 means no affinity and traffic could be routed to any aggregated port. + * The first aggregated port is number 1 and so on. + * The maximum number is given by rte_eth_dev_count_aggr_ports(). + * + * @return + * Zero if successful. Non-zero otherwise. + */ +__rte_experimental +int rte_eth_dev_map_aggr_tx_affinity(uint16_t port_id, uint16_t tx_queue_id, + uint8_t affinity); + /** * Return the NUMA socket to which an Ethernet device is connected * diff --git a/lib/ethdev/version.map b/lib/ethdev/version.map index dbc2bffe64..685aa71e51 100644 --- a/lib/ethdev/version.map +++ b/lib/ethdev/version.map @@ -300,6 +300,8 @@ EXPERIMENTAL { rte_mtr_meter_profile_get; # added in 23.03 + rte_eth_dev_count_aggr_ports; + rte_eth_dev_map_aggr_tx_affinity; rte_flow_async_create_by_index; }; From patchwork Tue Feb 14 15:48:36 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jiawei Wang X-Patchwork-Id: 123902 X-Patchwork-Delegate: ferruh.yigit@amd.com Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 7E2C741C96; Tue, 14 Feb 2023 16:49:46 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 67C8E42F84; Tue, 14 Feb 2023 16:49:46 +0100 (CET) Received: from NAM04-BN8-obe.outbound.protection.outlook.com (mail-bn8nam04on2072.outbound.protection.outlook.com [40.107.100.72]) by mails.dpdk.org (Postfix) with ESMTP id C94F2410D1 for ; Tue, 14 Feb 2023 16:49:44 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=NNp0CH30aomP+mkAVi2oiSNLmjj23Aevcp1npAAU9xAxcoY7TNo5baZBDzbQMtM+HDgJw8IVi377+VoacGezkll+nSChJfcaXUzur96t0ubNfJBKaIUEfIhV8VffeUsT3mu9YmCD3RDzj3ncOHEH0IAmIQ8Uu0/vBz64oHvVnzYthLsWt8w25RaLPssUrAtVzKAHc0YLzXboiPk84LCJyVJru+yp2PYc06vUMfEDUIkBzopHTPh50ZTEkGonlx/Ab6xgh3x78wlVelmIPADQsWSUYdLrQG2sYnp2OoTIPpfSdfDv3A0+G6AxxbXKkl4GAf9DzHttAS6/8w/0SDnQyw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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; bh=A23NYFgJLYqoVc1/i2Y97AqHEg9XV0HTODKi/s0+37A=; b=Z3j8ccA0D7VEL29WOGATWlxmIdpytglhlXtgcQ8UQ9fiLXraB3mKwSa61LdOHcB7uEiFwv72TGmNEgwPK3h07E9YkwVMriresFWYVr1Inek85oLhRBLyoak+87oJM/YEiQh5OOTrANcUOQPG6Eq+WFfcEw6kxmjF9RFgwdH5dA2kbYP99chL2ODY/4OQVubbhTDG9NWcu8AA8wcbXur4D0WU3a3ptaW1bXMYfRcS7+WRw94luVFUx/VM3ZKkTfsuJLHiX1EcOoQ/SswRhVquXa5SoH4SKfbQ7G+i4eHy61/iyOu8Fko9QyiJQ9DHzPk4LwPuDKQBPKS6rZKsAQozUg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.160) smtp.rcpttodomain=monjalon.net smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=A23NYFgJLYqoVc1/i2Y97AqHEg9XV0HTODKi/s0+37A=; b=G0ryhhBvkhO+zh8Aa/SjMLxGzngRafYWyUNpe7sKFXeVJVjFJAgj48NCMni+xcFjIl+E3d4TRLl6XkrWImwdlunYQyaks4WWIswLQ1MRfF9j9Rn5OHx0ANJIqt/8kSh7um9GUCK2hxAO+j0o5SYGRvmvQX7fZxp32gOmNd4BthZMifLrJNlaGxT2gsXLfydOhAJE2vpFzS6QcjHy5ae4MtCDxun5uFXqePvyG6NquGCPxhcRhLGiMamiKs2HC7TCpD7Z5UFGLAIqP+qUjnbBKpRuRaFYMvOIBjklXLjaj7qYW0iKM6MBX0RfalKD69BKx8CXHkum/qWLWQN7sH+kJQ== Received: from CY5PR15CA0057.namprd15.prod.outlook.com (2603:10b6:930:1b::32) by DM4PR12MB7719.namprd12.prod.outlook.com (2603:10b6:8:101::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6086.24; Tue, 14 Feb 2023 15:49:43 +0000 Received: from CY4PEPF0000C97E.namprd02.prod.outlook.com (2603:10b6:930:1b:cafe::9c) by CY5PR15CA0057.outlook.office365.com (2603:10b6:930:1b::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6086.26 via Frontend Transport; Tue, 14 Feb 2023 15:49:42 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.160) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.117.160 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.160) by CY4PEPF0000C97E.mail.protection.outlook.com (10.167.241.198) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6111.8 via Frontend Transport; Tue, 14 Feb 2023 15:49:42 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Tue, 14 Feb 2023 07:49:07 -0800 Received: from nvidia.com (10.126.231.37) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.36; Tue, 14 Feb 2023 07:49:04 -0800 From: Jiawei Wang To: , , , , Aman Singh , Yuying Zhang , Ferruh Yigit CC: , Subject: [PATCH v5 2/2] ethdev: add Aggregated affinity match item Date: Tue, 14 Feb 2023 17:48:36 +0200 Message-ID: <20230214154836.9681-3-jiaweiw@nvidia.com> X-Mailer: git-send-email 2.18.1 In-Reply-To: <20230214154836.9681-1-jiaweiw@nvidia.com> References: <20230203050717.46914-1-jiaweiw@nvidia.com> <20230214154836.9681-1-jiaweiw@nvidia.com> MIME-Version: 1.0 X-Originating-IP: [10.126.231.37] X-ClientProxiedBy: rnnvmail202.nvidia.com (10.129.68.7) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CY4PEPF0000C97E:EE_|DM4PR12MB7719:EE_ X-MS-Office365-Filtering-Correlation-Id: 0bf09d1e-2bc0-4427-54df-08db0ea316eb 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: PXBO35qsz0ueMxh19eE19FKsVLnHVZCoaUqRfRaM8b+neen8z8KVEf56JvWunuN8iFkFQeEitQ0daZ7UKPYeXGQfLvfGwrecn8tz6Ekkcl9dW+WmemXv0Rw5V3nXOJbFLR8upn4vndyxXQ1G06uVswLnSaAzp8Z9J+A06BwaY3CJrIMfpybRWbCCO/ajxOunmzeTV7pQWYb/5dV+M8MI1BljQbA2C7eZSbx2sbLFl+t1bVLSKZF7raxaPYSbu9+Ed7usi/Jdn1dbEZFtlZ2U1GodkXv5gF6GdzrB8z+dOhiSuJZ5m0BHNOb3sBAn/4BYPuP6DuZBxtrrsoBOsIhWrgFy8UB2rD4/X2h57Yq8wQ/P2mYPq1aDcmOKkS0RlCqUCgR6ZqWc03OiZRcCbWv6iiFqbBcYe9oeJnHoCmaYgaewYt+Dx98+s0g8oTniFXMeB5Cue5Cwk1iBdKgFic3ncRbQPuJfUaYWmejlqD5OPak3ZxoZuddEyx50ZDgIAziOJhn3IXK9g+8khsoxJzYcMGOYGU0tAV1ELDJVp8PatLWAHTN0GI3qtxlvbMqTqRLP/Cwj6025nIZAIdK1yyJfC7u2JOQA4GsRybJCenaZKAMomAxq2trS15uX+41QinSUcKt1+cyQzYKRq75TjiaQKpsk2sj9YxqMWt/sBFhCcfnj3Eh5OWfVNiTWPNYH2xfB6rB9T9Rq482Rue6CvA6dsw== X-Forefront-Antispam-Report: CIP:216.228.117.160; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge1.nvidia.com; CAT:NONE; SFS:(13230025)(4636009)(136003)(346002)(376002)(39860400002)(396003)(451199018)(40470700004)(36840700001)(46966006)(82310400005)(86362001)(36756003)(2616005)(40460700003)(70586007)(70206006)(426003)(40480700001)(47076005)(336012)(4326008)(8676002)(55016003)(478600001)(7696005)(54906003)(6286002)(186003)(26005)(316002)(16526019)(107886003)(6666004)(1076003)(110136005)(82740400003)(7636003)(2906002)(356005)(5660300002)(41300700001)(83380400001)(8936002)(36860700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Feb 2023 15:49:42.8942 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 0bf09d1e-2bc0-4427-54df-08db0ea316eb X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.160]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CY4PEPF0000C97E.namprd02.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM4PR12MB7719 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org When multiple ports are aggregated into a single DPDK port, (example: Linux bonding, DPDK bonding, failsafe, etc.), we want to know which port is used for Rx and Tx. This patch allows to map a Rx queue with an aggregated port by using a flow rule. The new item is called RTE_FLOW_ITEM_TYPE_AGGR_AFFINITY. While uses the aggregated affinity as a matching item in the flow rule, and sets the same affinity value by call rte_eth_dev_map_aggr_tx_affinity(), then the packet can be sent from the same port as the receiving one. The affinity numbering starts from 1, then trying to match on aggr_affinity 0 will result in an error. Add the testpmd command line to match the new item: flow create 0 ingress group 0 pattern aggr_affinity affinity is 1 / end actions queue index 0 / end The above command means that creates a flow on a single DPDK port and matches the packet from the first physical port and redirects these packets into Rx queue 0. Signed-off-by: Jiawei Wang Acked-by: Thomas Monjalon --- app/test-pmd/cmdline_flow.c | 28 +++++++++++++++++ doc/guides/prog_guide/rte_flow.rst | 9 ++++++ doc/guides/rel_notes/release_23_03.rst | 1 + doc/guides/testpmd_app_ug/testpmd_funcs.rst | 4 +++ lib/ethdev/rte_flow.c | 1 + lib/ethdev/rte_flow.h | 35 +++++++++++++++++++++ 6 files changed, 78 insertions(+) diff --git a/app/test-pmd/cmdline_flow.c b/app/test-pmd/cmdline_flow.c index 63a0b36622..889c49a28a 100644 --- a/app/test-pmd/cmdline_flow.c +++ b/app/test-pmd/cmdline_flow.c @@ -481,6 +481,8 @@ enum index { ITEM_METER, ITEM_METER_COLOR, ITEM_METER_COLOR_NAME, + ITEM_AGGR_AFFINITY, + ITEM_AGGR_AFFINITY_VALUE, /* Validate/create actions. */ ACTIONS, @@ -1403,6 +1405,7 @@ static const enum index next_item[] = { ITEM_L2TPV2, ITEM_PPP, ITEM_METER, + ITEM_AGGR_AFFINITY, END_SET, ZERO, }; @@ -1892,6 +1895,12 @@ static const enum index item_meter[] = { ZERO, }; +static const enum index item_aggr_affinity[] = { + ITEM_AGGR_AFFINITY_VALUE, + ITEM_NEXT, + ZERO, +}; + static const enum index next_action[] = { ACTION_END, ACTION_VOID, @@ -6694,6 +6703,22 @@ static const struct token token_list[] = { ARGS_ENTRY(struct buffer, port)), .call = parse_mp, }, + [ITEM_AGGR_AFFINITY] = { + .name = "aggr_affinity", + .help = "match on the aggregated port receiving the packets", + .priv = PRIV_ITEM(AGGR_AFFINITY, + sizeof(struct rte_flow_item_aggr_affinity)), + .next = NEXT(item_aggr_affinity), + .call = parse_vc, + }, + [ITEM_AGGR_AFFINITY_VALUE] = { + .name = "affinity", + .help = "aggregated affinity value", + .next = NEXT(item_aggr_affinity, NEXT_ENTRY(COMMON_UNSIGNED), + item_param), + .args = ARGS(ARGS_ENTRY(struct rte_flow_item_aggr_affinity, + affinity)), + }, }; /** Remove and return last entry from argument stack. */ @@ -11424,6 +11449,9 @@ flow_item_default_mask(const struct rte_flow_item *item) case RTE_FLOW_ITEM_TYPE_IPV6_ROUTING_EXT: mask = &ipv6_routing_ext_default_mask; break; + case RTE_FLOW_ITEM_TYPE_AGGR_AFFINITY: + mask = &rte_flow_item_aggr_affinity_mask; + break; default: break; } diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index 161c5dce53..dcc8b42540 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -1536,6 +1536,15 @@ Matches IPv6 routing extension header. - ``type``: IPv6 routing extension header type. - ``segments_left``: How many IPv6 destination addresses carries on. + +Item: ``AGGR_AFFINITY`` +^^^^^^^^^^^^^^^^^^^^^^^ + +Matches on the aggregated port of the received packet. +In case of multiple aggregated ports, the affinity numbering starts from 1. + +- ``affinity``: Aggregated affinity. + Actions ~~~~~~~ diff --git a/doc/guides/rel_notes/release_23_03.rst b/doc/guides/rel_notes/release_23_03.rst index becf6fed91..7bd8881077 100644 --- a/doc/guides/rel_notes/release_23_03.rst +++ b/doc/guides/rel_notes/release_23_03.rst @@ -74,6 +74,7 @@ New Features to get the number of aggregated ports. * Introduced new function ``rte_eth_dev_map_aggr_tx_affinity()`` to map a Tx queue with an aggregated port of the DPDK port. + * Added Rx affinity flow matching of an aggregated port. * **Added rte_flow support for matching IPv6 routing extension header fields.** diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst index 1d3c372601..5a88933635 100644 --- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst +++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst @@ -3775,6 +3775,10 @@ This section lists supported pattern items and their attributes, if any. - ``color {value}``: meter color value (green/yellow/red). +- ``aggr_affinity``: match aggregated port. + + - ``affinity {value}``: aggregated port (starts from 1). + - ``send_to_kernel``: send packets to kernel. diff --git a/lib/ethdev/rte_flow.c b/lib/ethdev/rte_flow.c index b29c66e2f4..749effb19b 100644 --- a/lib/ethdev/rte_flow.c +++ b/lib/ethdev/rte_flow.c @@ -162,6 +162,7 @@ static const struct rte_flow_desc_data rte_flow_desc_item[] = { MK_FLOW_ITEM(PPP, sizeof(struct rte_flow_item_ppp)), MK_FLOW_ITEM(METER_COLOR, sizeof(struct rte_flow_item_meter_color)), MK_FLOW_ITEM(IPV6_ROUTING_EXT, sizeof(struct rte_flow_item_ipv6_routing_ext)), + MK_FLOW_ITEM(AGGR_AFFINITY, sizeof(struct rte_flow_item_aggr_affinity)), }; /** Generate flow_action[] entry. */ diff --git a/lib/ethdev/rte_flow.h b/lib/ethdev/rte_flow.h index 6a51442b8c..6fc2d37847 100644 --- a/lib/ethdev/rte_flow.h +++ b/lib/ethdev/rte_flow.h @@ -656,6 +656,15 @@ enum rte_flow_item_type { * @see struct rte_flow_item_icmp6_echo. */ RTE_FLOW_ITEM_TYPE_ICMP6_ECHO_REPLY, + + /** + * Matches on the aggregated port of the received packet. + * Used in case multiple ports are aggregated to the a DPDK port. + * First port is number 1. + * + * @see struct rte_flow_item_aggr_affinity. + */ + RTE_FLOW_ITEM_TYPE_AGGR_AFFINITY, }; /** @@ -2187,6 +2196,32 @@ static const struct rte_flow_item_meter_color rte_flow_item_meter_color_mask = { }; #endif +/** + * @warning + * @b EXPERIMENTAL: this structure may change without prior notice + * + * RTE_FLOW_ITEM_TYPE_AGGR_AFFINITY + * + * For multiple ports aggregated to a single DPDK port, + * match the aggregated port receiving the packets. + */ +struct rte_flow_item_aggr_affinity { + /** + * An aggregated port receiving the packets. + * Numbering starts from 1. + * Number of aggregated ports is reported by rte_eth_dev_count_aggr_ports(). + */ + uint8_t affinity; +}; + +/** Default mask for RTE_FLOW_ITEM_TYPE_AGGR_AFFINITY. */ +#ifndef __cplusplus +static const struct rte_flow_item_aggr_affinity +rte_flow_item_aggr_affinity_mask = { + .affinity = 0xff, +}; +#endif + /** * Action types. *