From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id BB867A00C5; Thu, 30 Apr 2020 09:08:49 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 89F751D924; Thu, 30 Apr 2020 09:08:42 +0200 (CEST) Received: from EUR04-DB3-obe.outbound.protection.outlook.com (mail-eopbgr60057.outbound.protection.outlook.com [40.107.6.57]) by dpdk.org (Postfix) with ESMTP id 6220D1D909 for ; Thu, 30 Apr 2020 09:08:39 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=BdPGAzMQphEo4GV+6Ag/rbGRyQfy++EjMRrJ9KFE1NHM0229G+cNGATT1AOpw4gRjP/9D2lVmItHoicjGndKAON5JS/476cZ/mqeH1Sigf93617lVnGwfkz07jtxM9r9Fc1XsKWOmwpEvrrdR5OG3fmlxlQkEs5EGZ24UMQklRsX2fyFUA0pXplDDvN2u/OB3LMTKQhQCfWXVEMW9WklGyjoMs44ax4wmpryGSyoxhwLZlKAKiWwQtmvuqfCrL0NJeNsjUKbj2Wu/YIXhmIsUixeBNOq3fpa/jhMBZGJiLMT3IJO+qq50SIQy6yGi7I8TrSmcrTqrniYPNZPL3r/Dw== 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-SenderADCheck; bh=bl7tQetROXHgWR6TLkKRey4A8r/KTav39nB1mzuxXpQ=; b=izANzcC8GiYQSihcZV5Ye4MNUW4YX1rlBSERtMr4dMBxUzACNwyk0/B+TRSp4zYHk4eQXkkf2tSGNRyJWZ6kQqQnc4H2bDLetxmXlRYM4DP8/HbTN/piTvQXsrFb+G8MxPvrw9BedyuCss5krsbu8fM4eG97vdWRH6PSyRL5+yzVtmotaB+gV663Vo9F5qmyoQLyyU7ECDBA3+qYW5PGDFHizftco2Psd4E3kwfMW7j92/MRad6SkYOByjtRejRusy5nyeLVO/OSO14PqQqJC3H+IjHibil1SxefpvwhATrd48qeWNI+EP29laGsC3zpscMkAngk3oQzml5MJsH9kw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=mellanox.com; dmarc=pass action=none header.from=mellanox.com; dkim=pass header.d=mellanox.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Mellanox.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=bl7tQetROXHgWR6TLkKRey4A8r/KTav39nB1mzuxXpQ=; b=OZOi0yFcxk5Ne/GckvwWoYl57qEc0Q6zZAYwzwBaQbUwFtUnKtK5VpCwqQ3dUFAk+/wgNnluV896fSIiJNiGr7we2NkRIHyxoO4gDXfnc0f1wuMX8xFdzOq7tYUXcqFD1c8vS5aoN+qcT1lIr4jyYFV6WA+YcO29ff4dsYleoXk= Authentication-Results: mellanox.com; dkim=none (message not signed) header.d=none;mellanox.com; dmarc=none action=none header.from=mellanox.com; Received: from AM0PR05MB6610.eurprd05.prod.outlook.com (2603:10a6:208:12f::18) by AM0PR05MB6707.eurprd05.prod.outlook.com (2603:10a6:20b:15b::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2958.20; Thu, 30 Apr 2020 07:08:38 +0000 Received: from AM0PR05MB6610.eurprd05.prod.outlook.com ([fe80::900:c0ac:78bd:18fc]) by AM0PR05MB6610.eurprd05.prod.outlook.com ([fe80::900:c0ac:78bd:18fc%6]) with mapi id 15.20.2937.028; Thu, 30 Apr 2020 07:08:38 +0000 From: Wisam Jaddo To: jackmin@mellanox.com, thomas@monjalon.net, jerinjacobk@gmail.com, gerlitz.or@gmail.com, l.yan@epfl.ch, dev@dpdk.org Date: Thu, 30 Apr 2020 07:08:19 +0000 Message-Id: <20200430070823.24046-2-wisamm@mellanox.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20200430070823.24046-1-wisamm@mellanox.com> References: <20200409154257.11539-1-wisamm@mellanox.com> <20200430070823.24046-1-wisamm@mellanox.com> Content-Type: text/plain X-ClientProxiedBy: PR3P191CA0051.EURP191.PROD.OUTLOOK.COM (2603:10a6:102:55::26) To AM0PR05MB6610.eurprd05.prod.outlook.com (2603:10a6:208:12f::18) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from mellanox.com (37.142.13.130) by PR3P191CA0051.EURP191.PROD.OUTLOOK.COM (2603:10a6:102:55::26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2958.20 via Frontend Transport; Thu, 30 Apr 2020 07:08:37 +0000 X-Mailer: git-send-email 2.17.1 X-Originating-IP: [37.142.13.130] X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-HT: Tenant X-MS-Office365-Filtering-Correlation-Id: 05a9a26c-716a-4ff9-f37a-08d7ecd54e48 X-MS-TrafficTypeDiagnostic: AM0PR05MB6707:|AM0PR05MB6707: X-LD-Processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:639; X-Forefront-PRVS: 0389EDA07F X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: UrS/68iurcSR6jl4Z7UkggIBPN032hqx9GnLvTGuzvkRbaD6vCESz79aZ4NMcxkUEnpWZ4ftbFCe9YQJGCcu1lANXrxL6wJ9iPx0rQb0Sh5UGAo/u6soihfjYZfndPE2UDoVw0UsWzHwPlI+5AVOu+RVrD1krobFdVSaIxGuJGiM4Wu0SVAo6/otofmD4hLbeWsBC3AYxZHIsOG3A4ZjhAEQ/d7fcLDEyEBc2EoPMU41uWcOd0jyNpj7OJ0Gegqx60GjCGHNWos9FhMT7lOWKubskDHPFO3TdjeyzYd+7WajguUATVLhw0I9lIJC0ZWAsOuimb/pFa2GvfOLmRQqWBwiAdErmBKNHJ4DdZxRuH6yaMqC7BazsStdsSLD6w4FhGXEaIgaKmQ9K7R4Oznn39bS1TJQfDnKQ0MVQR4aU6CPjXTCdhYUjqxDjHhMBV1D X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM0PR05MB6610.eurprd05.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(39860400002)(136003)(366004)(346002)(376002)(396003)(66556008)(1076003)(26005)(186003)(55016002)(66946007)(8886007)(16526019)(2906002)(2616005)(956004)(66476007)(30864003)(36756003)(6666004)(8936002)(316002)(86362001)(8676002)(52116002)(5660300002)(478600001)(7696005); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData: S0SvT3bISQkIo9v7ThJ79GLKwt+y7D4umKcscCpXCUDz1/dWD8Xg9bCyAsnL/m41+uxrL9J3NX/fKh573Mr0TuZ4VDfG3eYGewCBKDuKnrbQ4ljIL+KdoZB6R6sdYY/0bPJhwEZA3Z5AfvkB9H6jItVj8+l8xp46UqvV/KRYlbQkgfr1yi5XcbfDY4QR9bRE/J0t9a1RE2YnL5wySJ5ELuBIRbnoU7mSeumJUlgP8t11vU7TiivH5mfzHfE6rCVvmr8KGH4H1d+MK1DW3Q3VQ9ZXqPMSUOm1aOE5akZ4x7aBb+0Uz/EB2oeQI6lBrWWUusz5tc+J0fo6X2Kj4Y7cayjA8jcU00j78yrW3SPxhzkg9yKEJFa2rz6YunU5RyEHc2YHbSoaYgXzfdvewFEK5wfayx0QkVFm11wSQEW3Q0jyFbgn9ICKNkgBAhe/ZjlHZMgchVXQMVwSItu4bjklPleQcWo6I7/YapTGPrV6+G41PwQMp3a7ZTWSGOozWSyGGsT15r7FBatka0mP6sQ5FJTbVJOaFDQBENni3u5z8+WOKdYUnJu+GwZK+x8ui7RdPAnIFZbiExigmHDIiRgy8yp9BD2WH5QQneuq8N7LK3FbWubtXJWnjNq7jorCxAfxS4fnOIb/sGab5leky0aCaSWc4zmzVOfRiw+dykg0YtRR7JUdUoGk9wNslwePjnJXf9gSYA9dMhpVaSVh4sPqBc0ru6q2hJw7t8hlnSTjJgcUpu2BZVEz+VFO3I1vAI1wimmmMKH4fRJYEgOdJsBRIU0vzxrGmUOJ8KkGjOy8JNQ= X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-Network-Message-Id: 05a9a26c-716a-4ff9-f37a-08d7ecd54e48 X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Apr 2020 07:08:38.4725 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: nt7i05wO8E0QTVMNVQa3LLAvbAAUeyI1pDaFqXWqpVZHysuEYdkoRUSWquhIzHFWCDx9eX97lIEebnzJRxZqTQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR05MB6707 Subject: [dpdk-dev] [PATCH v2 1/5] app/test-flow-perf: add flow performance skeleton X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Add flow performance application skeleton. Signed-off-by: Wisam Jaddo --- MAINTAINERS | 5 + app/Makefile | 1 + app/meson.build | 1 + app/test-flow-perf/Makefile | 26 +++ app/test-flow-perf/main.c | 246 +++++++++++++++++++++++++++ app/test-flow-perf/meson.build | 11 ++ app/test-flow-perf/user_parameters.h | 16 ++ config/common_base | 5 + doc/guides/tools/flow-perf.rst | 69 ++++++++ doc/guides/tools/index.rst | 1 + 10 files changed, 381 insertions(+) create mode 100644 app/test-flow-perf/Makefile create mode 100644 app/test-flow-perf/main.c create mode 100644 app/test-flow-perf/meson.build create mode 100644 app/test-flow-perf/user_parameters.h create mode 100644 doc/guides/tools/flow-perf.rst diff --git a/MAINTAINERS b/MAINTAINERS index d31a809292..b5632c1bf5 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -1504,6 +1504,11 @@ T: git://dpdk.org/next/dpdk-next-net F: app/test-pmd/ F: doc/guides/testpmd_app_ug/ +Flow performance tool +M: Wisam Jaddo +F: app/test-flow-perf +F: doc/guides/flow-perf.rst + Compression performance test application T: git://dpdk.org/next/dpdk-next-crypto F: app/test-compress-perf/ diff --git a/app/Makefile b/app/Makefile index 823771c5fc..bd823f3db7 100644 --- a/app/Makefile +++ b/app/Makefile @@ -9,6 +9,7 @@ DIRS-$(CONFIG_RTE_PROC_INFO) += proc-info DIRS-$(CONFIG_RTE_LIBRTE_PDUMP) += pdump DIRS-$(CONFIG_RTE_LIBRTE_ACL) += test-acl DIRS-$(CONFIG_RTE_LIBRTE_CMDLINE) += test-cmdline +DIRS-$(CONFIG_RTE_TEST_FLOW_PERF) += test-flow-perf DIRS-$(CONFIG_RTE_LIBRTE_FIB) += test-fib DIRS-$(CONFIG_RTE_LIBRTE_PIPELINE) += test-pipeline DIRS-$(CONFIG_RTE_LIBRTE_IPSEC) += test-sad diff --git a/app/meson.build b/app/meson.build index 0f7fe94649..e26f5b72f5 100644 --- a/app/meson.build +++ b/app/meson.build @@ -14,6 +14,7 @@ apps = [ 'test-compress-perf', 'test-crypto-perf', 'test-eventdev', + 'test-flow-perf', 'test-fib', 'test-pipeline', 'test-pmd', diff --git a/app/test-flow-perf/Makefile b/app/test-flow-perf/Makefile new file mode 100644 index 0000000000..45b1fb1464 --- /dev/null +++ b/app/test-flow-perf/Makefile @@ -0,0 +1,26 @@ +# SPDX-License-Identifier: BSD-3-Clause +# Copyright 2020 Mellanox Technologies, Ltd + +include $(RTE_SDK)/mk/rte.vars.mk + +ifeq ($(CONFIG_RTE_TEST_FLOW_PERF),y) + +# +# library name +# +APP = flow_perf + +CFLAGS += -DALLOW_EXPERIMENTAL_API +CFLAGS += -O3 +CFLAGS += $(WERROR_FLAGS) +CFLAGS += -Wno-deprecated-declarations +CFLAGS += -Wno-unused-function + +# +# all source are stored in SRCS-y +# +SRCS-y += main.c + +include $(RTE_SDK)/mk/rte.app.mk + +endif diff --git a/app/test-flow-perf/main.c b/app/test-flow-perf/main.c new file mode 100644 index 0000000000..156b9ef553 --- /dev/null +++ b/app/test-flow-perf/main.c @@ -0,0 +1,246 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * + * This file contain the application main file + * This application provides the user the ability to test the + * insertion rate for specific rte_flow rule under stress state ~4M rule/ + * + * Then it will also provide packet per second measurement after installing + * all rules, the user may send traffic to test the PPS that match the rules + * after all rules are installed, to check performance or functionality after + * the stress. + * + * The flows insertion will go for all ports first, then it will print the + * results, after that the application will go into forwarding packets mode + * it will start receiving traffic if any and then forwarding it back and + * gives packet per second measurement. + * + * Copyright 2020 Mellanox Technologies, Ltd + */ +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "user_parameters.h" + +static uint32_t nb_lcores; +static struct rte_mempool *mbuf_mp; + +static void usage(char *progname) +{ + printf("\nusage: %s", progname); +} + +static void +args_parse(int argc, char **argv) +{ + char **argvopt; + int opt; + int opt_idx; + static struct option lgopts[] = { + /* Control */ + { "help", 0, 0, 0 }, + }; + + argvopt = argv; + + while ((opt = getopt_long(argc, argvopt, "", + lgopts, &opt_idx)) != EOF) { + switch (opt) { + case 0: + if (!strcmp(lgopts[opt_idx].name, "help")) { + usage(argv[0]); + rte_exit(EXIT_SUCCESS, "Displayed help\n"); + } + break; + default: + usage(argv[0]); + printf("Invalid option: %s\n", argv[optind]); + rte_exit(EXIT_SUCCESS, "Invalid option\n"); + break; + } + } +} + +static void +init_port(void) +{ + int ret; + uint16_t i, j; + uint16_t port_id; + uint16_t nr_ports = rte_eth_dev_count_avail(); + struct rte_eth_hairpin_conf hairpin_conf = { + .peer_count = 1, + }; + struct rte_eth_conf port_conf = { + .rxmode = { + .split_hdr_size = 0, + }, + .rx_adv_conf = { + .rss_conf.rss_hf = + ETH_RSS_IP | + ETH_RSS_UDP | + ETH_RSS_TCP, + } + }; + struct rte_eth_txconf txq_conf; + struct rte_eth_rxconf rxq_conf; + struct rte_eth_dev_info dev_info; + + if (nr_ports == 0) + rte_exit(EXIT_FAILURE, "Error: no port detected\n"); + mbuf_mp = rte_pktmbuf_pool_create("mbuf_pool", + TOTAL_MBUF_NUM, MBUF_CACHE_SIZE, + 0, MBUF_SIZE, + rte_socket_id()); + + if (mbuf_mp == NULL) + rte_exit(EXIT_FAILURE, "Error: can't init mbuf pool\n"); + + for (port_id = 0; port_id < nr_ports; port_id++) { + ret = rte_eth_dev_info_get(port_id, &dev_info); + if (ret != 0) + rte_exit(EXIT_FAILURE, + "Error during getting device (port %u) info: %s\n", + port_id, strerror(-ret)); + + port_conf.txmode.offloads &= dev_info.tx_offload_capa; + printf(":: initializing port: %d\n", port_id); + ret = rte_eth_dev_configure(port_id, RXQs + HAIRPIN_QUEUES, + TXQs + HAIRPIN_QUEUES, &port_conf); + if (ret < 0) + rte_exit(EXIT_FAILURE, + ":: cannot configure device: err=%d, port=%u\n", + ret, port_id); + + rxq_conf = dev_info.default_rxconf; + rxq_conf.offloads = port_conf.rxmode.offloads; + for (i = 0; i < RXQs; i++) { + ret = rte_eth_rx_queue_setup(port_id, i, NR_RXD, + rte_eth_dev_socket_id(port_id), + &rxq_conf, + mbuf_mp); + if (ret < 0) + rte_exit(EXIT_FAILURE, + ":: Rx queue setup failed: err=%d, port=%u\n", + ret, port_id); + } + + txq_conf = dev_info.default_txconf; + txq_conf.offloads = port_conf.txmode.offloads; + + for (i = 0; i < TXQs; i++) { + ret = rte_eth_tx_queue_setup(port_id, i, NR_TXD, + rte_eth_dev_socket_id(port_id), + &txq_conf); + if (ret < 0) + rte_exit(EXIT_FAILURE, + ":: Tx queue setup failed: err=%d, port=%u\n", + ret, port_id); + } + + ret = rte_eth_promiscuous_enable(port_id); + if (ret != 0) + rte_exit(EXIT_FAILURE, + ":: promiscuous mode enable failed: err=%s, port=%u\n", + rte_strerror(-ret), port_id); + + for (i = RXQs, j = 0; i < RXQs + HAIRPIN_QUEUES; i++, j++) { + hairpin_conf.peers[0].port = port_id; + hairpin_conf.peers[0].queue = j + TXQs; + ret = rte_eth_rx_hairpin_queue_setup(port_id, i, + NR_RXD, &hairpin_conf); + if (ret != 0) + rte_exit(EXIT_FAILURE, + ":: Hairpin rx queue setup failed: err=%d, port=%u\n", + ret, port_id); + } + + for (i = TXQs, j = 0; i < TXQs + HAIRPIN_QUEUES; i++, j++) { + hairpin_conf.peers[0].port = port_id; + hairpin_conf.peers[0].queue = j + RXQs; + ret = rte_eth_tx_hairpin_queue_setup(port_id, i, + NR_TXD, &hairpin_conf); + if (ret != 0) + rte_exit(EXIT_FAILURE, + ":: Hairpin tx queue setup failed: err=%d, port=%u\n", + ret, port_id); + } + + ret = rte_eth_dev_start(port_id); + if (ret < 0) + rte_exit(EXIT_FAILURE, + "rte_eth_dev_start:err=%d, port=%u\n", + ret, port_id); + + printf(":: initializing port: %d done\n", port_id); + } +} + +int +main(int argc, char **argv) +{ + uint16_t lcore_id; + uint16_t port; + uint16_t nr_ports; + int ret; + struct rte_flow_error error; + + nr_ports = rte_eth_dev_count_avail(); + ret = rte_eal_init(argc, argv); + if (ret < 0) + rte_exit(EXIT_FAILURE, "EAL init failed\n"); + + argc -= ret; + argv += ret; + + if (argc > 1) + args_parse(argc, argv); + + init_port(); + + nb_lcores = rte_lcore_count(); + + if (nb_lcores <= 1) + rte_exit(EXIT_FAILURE, "This app needs at least two cores\n"); + + RTE_LCORE_FOREACH_SLAVE(lcore_id) + + if (rte_eal_wait_lcore(lcore_id) < 0) + break; + + for (port = 0; port < nr_ports; port++) { + rte_flow_flush(port, &error); + rte_eth_dev_stop(port); + rte_eth_dev_close(port); + } + return 0; +} diff --git a/app/test-flow-perf/meson.build b/app/test-flow-perf/meson.build new file mode 100644 index 0000000000..ec9bb3b3aa --- /dev/null +++ b/app/test-flow-perf/meson.build @@ -0,0 +1,11 @@ +# SPDX-License-Identifier: BSD-3-Clause +# Copyright(c) 2020 Mellanox Technologies, Ltd + +# meson file, for building this example as part of a main DPDK build. +# +# To build this example as a standalone application with an already-installed +# DPDK instance, use 'make' + +sources = files( + 'main.c', +) diff --git a/app/test-flow-perf/user_parameters.h b/app/test-flow-perf/user_parameters.h new file mode 100644 index 0000000000..56ec7f47b5 --- /dev/null +++ b/app/test-flow-perf/user_parameters.h @@ -0,0 +1,16 @@ +/* SPDX-License-Identifier: BSD-3-Claus + * + * This file will hold the user parameters values + * + * Copyright 2020 Mellanox Technologies, Ltd + */ + +/** Configuration **/ +#define RXQs 4 +#define TXQs 4 +#define HAIRPIN_QUEUES 4 +#define TOTAL_MBUF_NUM 32000 +#define MBUF_SIZE 2048 +#define MBUF_CACHE_SIZE 512 +#define NR_RXD 256 +#define NR_TXD 256 diff --git a/config/common_base b/config/common_base index 14000ba07e..eaaeaaaee2 100644 --- a/config/common_base +++ b/config/common_base @@ -1124,3 +1124,8 @@ CONFIG_RTE_APP_CRYPTO_PERF=y # Compile the eventdev application # CONFIG_RTE_APP_EVENTDEV=y + +# +# Compile the rte flow perf application +# +CONFIG_RTE_TEST_FLOW_PERF=y diff --git a/doc/guides/tools/flow-perf.rst b/doc/guides/tools/flow-perf.rst new file mode 100644 index 0000000000..30ce1b6cc0 --- /dev/null +++ b/doc/guides/tools/flow-perf.rst @@ -0,0 +1,69 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright 2020 Mellanox Technologies, Ltd + +RTE Flow performance tool +========================= + +Application for rte_flow performance testing. + + +Compiling the Application +========================= +The ``test-flow-perf`` application is compiled as part of the main compilation +of the DPDK libraries and tools. + +Refer to the DPDK Getting Started Guides for details. +The basic compilation steps are: + +#. Set the required environmental variables and go to the source directory: + + .. code-block:: console + + export RTE_SDK=/path/to/rte_sdk + cd $RTE_SDK + +#. Set the compilation target. For example: + + .. code-block:: console + + export RTE_TARGET=x86_64-native-linux-gcc + +#. Build the application: + + .. code-block:: console + + make install T=$RTE_TARGET + +#. The compiled application will be located at: + + .. code-block:: console + + $RTE_SDK/$RTE_TARGET/app/flow-perf + + +Running the Application +======================= + +EAL Command-line Options +------------------------ + +Please refer to :doc:`EAL parameters (Linux) <../linux_gsg/linux_eal_parameters>` +or :doc:`EAL parameters (FreeBSD) <../freebsd_gsg/freebsd_eal_parameters>` for +a list of available EAL command-line options. + + +Flow performance Options +------------------------ + +The following are the command-line options for the flow performance application. +They must be separated from the EAL options, shown in the previous section, with +a ``--`` separator: + +.. code-block:: console + + sudo ./test-flow-perf -n 4 -w 08:00.0,dv_flow_en=1 -- + +The command line options are: + +* ``--help`` + Display a help message and quit. diff --git a/doc/guides/tools/index.rst b/doc/guides/tools/index.rst index 782b30864e..7279daebc6 100644 --- a/doc/guides/tools/index.rst +++ b/doc/guides/tools/index.rst @@ -16,3 +16,4 @@ DPDK Tools User Guides cryptoperf comp_perf testeventdev + flow-perf -- 2.17.1