Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/135674/?format=api
{ "id": 135674, "url": "http://patches.dpdk.org/api/patches/135674/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20240102072818.886476-3-rkudurumalla@marvell.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": "<20240102072818.886476-3-rkudurumalla@marvell.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20240102072818.886476-3-rkudurumalla@marvell.com", "date": "2024-01-02T07:28:18", "name": "[v9,3/3] app/graph: implement port forward usecase", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "25aec10d6a8c532b063c222fa634497f3cbcf63b", "submitter": { "id": 2289, "url": "http://patches.dpdk.org/api/people/2289/?format=api", "name": "Rakesh Kudurumalla", "email": "rkudurumalla@marvell.com" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20240102072818.886476-3-rkudurumalla@marvell.com/mbox/", "series": [ { "id": 30695, "url": "http://patches.dpdk.org/api/series/30695/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=30695", "date": "2024-01-02T07:28:16", "name": "[v9,1/3] node: support to add next node to ethdev Rx node", "version": 9, "mbox": "http://patches.dpdk.org/series/30695/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/135674/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/135674/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 152CC437F9;\n\tTue, 2 Jan 2024 08:28:39 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 34B1940691;\n\tTue, 2 Jan 2024 08:28:34 +0100 (CET)", "from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com\n [67.231.148.174])\n by mails.dpdk.org (Postfix) with ESMTP id 0ECAC40691\n for <dev@dpdk.org>; Tue, 2 Jan 2024 08:28:31 +0100 (CET)", "from pps.filterd (m0045849.ppops.net [127.0.0.1])\n by mx0a-0016f401.pphosted.com (8.17.1.24/8.17.1.24) with ESMTP id\n 4025LRpd008200 for <dev@dpdk.org>; Mon, 1 Jan 2024 23:28:31 -0800", "from dc5-exch01.marvell.com ([199.233.59.181])\n by mx0a-0016f401.pphosted.com (PPS) with ESMTPS id 3vcc9088xr-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT)\n for <dev@dpdk.org>; Mon, 01 Jan 2024 23:28:30 -0800 (PST)", "from DC5-EXCH02.marvell.com (10.69.176.39) by DC5-EXCH01.marvell.com\n (10.69.176.38) with Microsoft SMTP Server (TLS) id 15.0.1497.48;\n Mon, 1 Jan 2024 23:28:29 -0800", "from maili.marvell.com (10.69.176.80) by DC5-EXCH02.marvell.com\n (10.69.176.39) with Microsoft SMTP Server id 15.0.1497.48 via Frontend\n Transport; Mon, 1 Jan 2024 23:28:29 -0800", "from localhost.localdomain (unknown [10.28.36.154])\n by maili.marvell.com (Postfix) with ESMTP id 4DF1F3F7080;\n Mon, 1 Jan 2024 23:28:27 -0800 (PST)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=\n from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding:content-type; s=\n pfpt0220; bh=mSP/YHmrLHFQhCdNXYg+soDpHxSSY/fPcVHnNF2CL4E=; b=MN/\n xzjxxAd3CeUS1b7I3R4pw6J/CZyT4OPGOr8yonuo+saCPtEvf239FlCTY0AuQ6mi\n YBqCqrbg7jxrb+E5Zq9s0D8FRJXLe1tNKF8UScDlspeeRHHi+TgwhH4pUBnMWnMd\n ngN1FYVzQLWEWHBP4YFAv2ke/BeMyMddz5IQjWPQrTD+G7Sz7ecePz2gXYUxEUP0\n H8epLXB8Z6pjonTFYoWlFhj/4DzMkbkyZId2YI8pskyrk2UaTUZsqAT5nJYrnwDP\n Wiw5+5GydoDIMG9pUM9XeFOQgt/wEHrcim0LnI/ndSXsv9EHUKOojtVUn4N31BQj\n TBDEbqSkOi0Jzrc3tzg==", "From": "Rakesh Kudurumalla <rkudurumalla@marvell.com>", "To": "Sunil Kumar Kori <skori@marvell.com>, Rakesh Kudurumalla\n <rkudurumalla@marvell.com>", "CC": "<dev@dpdk.org>, <jerinj@marvell.com>, <ndabilpuram@marvell.com>", "Subject": "[PATCH v9 3/3] app/graph: implement port forward usecase", "Date": "Tue, 2 Jan 2024 12:58:18 +0530", "Message-ID": "<20240102072818.886476-3-rkudurumalla@marvell.com>", "X-Mailer": "git-send-email 2.25.1", "In-Reply-To": "<20240102072818.886476-1-rkudurumalla@marvell.com>", "References": "<20240101083726.875161-1-rkudurumalla@marvell.com>\n <20240102072818.886476-1-rkudurumalla@marvell.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Content-Type": "text/plain", "X-Proofpoint-ORIG-GUID": "yXCZEeYXhxBgnQTRLt98CIHoPUT1htmO", "X-Proofpoint-GUID": "yXCZEeYXhxBgnQTRLt98CIHoPUT1htmO", "X-Proofpoint-Virus-Version": "vendor=baseguard\n engine=ICAP:2.0.272,Aquarius:18.0.997,Hydra:6.0.619,FMLib:17.11.176.26\n definitions=2023-12-09_02,2023-12-07_01,2023-05-22_02", "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": "Added portforward usecase.In this usecase\npackets received Rx port is forwarded to\nrespective Tx port.\n\nSigned-off-by: Rakesh Kudurumalla <rkudurumalla@marvell.com>\nAcked-by: Sunil Kumar Kori <skori@marvell.com>\n---\n app/graph/ethdev.c | 13 ++\n app/graph/ethdev.h | 1 +\n app/graph/examples/l2fwd.cli | 41 +++++\n app/graph/examples/l2fwd_pcap.cli | 37 +++++\n app/graph/graph.c | 8 +-\n app/graph/l2fwd.c | 152 +++++++++++++++++++\n app/graph/l2fwd.h | 11 ++\n app/graph/meson.build | 1 +\n app/graph/module_api.h | 1 +\n doc/guides/tools/graph.rst | 21 +++\n doc/guides/tools/img/graph-usecase-l2fwd.svg | 92 +++++++++++\n 11 files changed, 377 insertions(+), 1 deletion(-)\n create mode 100644 app/graph/examples/l2fwd.cli\n create mode 100644 app/graph/examples/l2fwd_pcap.cli\n create mode 100644 app/graph/l2fwd.c\n create mode 100644 app/graph/l2fwd.h\n create mode 100644 doc/guides/tools/img/graph-usecase-l2fwd.svg", "diff": "diff --git a/app/graph/ethdev.c b/app/graph/ethdev.c\nindex bb502a6134..a622275338 100644\n--- a/app/graph/ethdev.c\n+++ b/app/graph/ethdev.c\n@@ -76,6 +76,19 @@ ethdev_port_by_id(uint16_t port_id)\n \treturn NULL;\n }\n \n+int16_t\n+ethdev_txport_by_rxport_get(uint16_t portid_rx)\n+{\n+\tint portid = -EINVAL;\n+\tstruct ethdev *port;\n+\n+\tport = ethdev_port_by_id(portid_rx);\n+\tif (port)\n+\t\tportid = port->tx_port_id;\n+\n+\treturn portid;\n+}\n+\n void *\n ethdev_mempool_list_by_portid(uint16_t portid)\n {\ndiff --git a/app/graph/ethdev.h b/app/graph/ethdev.h\nindex 836052046b..ec457b89bf 100644\n--- a/app/graph/ethdev.h\n+++ b/app/graph/ethdev.h\n@@ -36,6 +36,7 @@ void ethdev_stop(void);\n void *ethdev_mempool_list_by_portid(uint16_t portid);\n int16_t ethdev_portid_by_ip4(uint32_t ip, uint32_t mask);\n int16_t ethdev_portid_by_ip6(uint8_t *ip, uint8_t *mask);\n+int16_t ethdev_txport_by_rxport_get(uint16_t portid_rx);\n void ethdev_list_clean(void);\n \n #endif\ndiff --git a/app/graph/examples/l2fwd.cli b/app/graph/examples/l2fwd.cli\nnew file mode 100644\nindex 0000000000..861e83bd70\n--- /dev/null\n+++ b/app/graph/examples/l2fwd.cli\n@@ -0,0 +1,41 @@\n+; SPDX-License-Identifier: BSD-3-Clause\n+; Copyright(c) 2023 Marvell.\n+\n+;\n+; Graph configuration for given usecase\n+;\n+graph l2fwd coremask 0xff bsz 32 tmo 10 model default pcap_enable 1 num_pcap_pkts 100000 pcap_file /tmp/output.pcap\n+\n+;\n+; Mempools to be attached with ethdev\n+;\n+mempool mempool0 size 8192 buffers 4000 cache 256 numa 0\n+\n+;\n+; DPDK devices and configuration.\n+;\n+; Note: Customize the parameters below to match your setup.\n+;\n+ethdev 0002:01:00.1 rxq 1 txq 8 mempool0\n+ethdev 0002:01:00.4 rxq 1 txq 8 mempool0\n+ethdev 0002:01:00.6 rxq 1 txq 8 mempool0\n+ethdev 0002:02:00.0 rxq 1 txq 8 mempool0\n+\n+;\n+; Rx/Tx port mapping\n+;\n+ethdev forward 0002:01:00.4 0002:02:00.0\n+ethdev forward 0002:01:00.1 0002:01:00.6\n+\n+;\n+; Port-Queue-Core mapping for ethdev_rx node\n+;\n+ethdev_rx map port 0002:02:00.0 queue 0 core 1\n+ethdev_rx map port 0002:01:00.6 queue 0 core 2\n+\n+;\n+; Graph start command to create graph.\n+;\n+; Note: No more command should come after this.\n+;\n+graph start\ndiff --git a/app/graph/examples/l2fwd_pcap.cli b/app/graph/examples/l2fwd_pcap.cli\nnew file mode 100644\nindex 0000000000..67308b3b72\n--- /dev/null\n+++ b/app/graph/examples/l2fwd_pcap.cli\n@@ -0,0 +1,37 @@\n+; SPDX-License-Identifier: BSD-3-Clause\n+; Copyright(c) 2023 Marvell.\n+\n+;\n+; Graph configuration for given usecase\n+;\n+graph l2fwd coremask 0xff bsz 32 tmo 10 model default pcap_enable 1 num_pcap_pkts 100000 pcap_file /tmp/output.pcap\n+\n+;\n+; Mempools to be attached with ethdev\n+;\n+mempool mempool0 size 8192 buffers 4000 cache 256 numa 0\n+\n+;\n+; DPDK devices and configuration.\n+;\n+; Note: Customize the parameters below to match your setup.\n+;\n+ethdev net_pcap0 rxq 1 txq 8 mempool0\n+ethdev net_pcap1 rxq 1 txq 8 mempool0\n+\n+;\n+; Rx/Tx port mapping\n+;\n+ethdev forward net_pcap1 net_pcap0\n+\n+;\n+; Port-Queue-Core mapping for ethdev_rx node\n+;\n+ethdev_rx map port net_pcap0 queue 0 core 1\n+\n+;\n+; Graph start command to create graph.\n+;\n+; Note: No more command should come after this.\n+;\n+graph start\ndiff --git a/app/graph/graph.c b/app/graph/graph.c\nindex a65723a196..4e0441f1a7 100644\n--- a/app/graph/graph.c\n+++ b/app/graph/graph.c\n@@ -24,7 +24,7 @@ cmd_graph_help[] = \"graph <usecases> bsz <size> tmo <ns> coremask <bitmask> \"\n \t\t \"model <rtc | mcd | default> pcap_enable <0 | 1> num_pcap_pkts <num>\"\n \t\t \"pcap_file <output_capture_file>\";\n \n-static const char * const supported_usecases[] = {\"l3fwd\"};\n+static const char * const supported_usecases[] = {\"l3fwd\", \"l2fwd\"};\n struct graph_config graph_config;\n bool graph_started;\n \n@@ -273,6 +273,12 @@ cli_graph_start(__rte_unused void *parsed_result, __rte_unused struct cmdline *c\n \t\t\t\tbreak;\n \t\t\t}\n \t\t}\n+\t\tif (!strcmp(graph_config.usecases[i].name, \"l2fwd\")) {\n+\t\t\tif (graph_config.usecases[i].enabled) {\n+\t\t\t\trc = usecase_l2fwd_configure(conf, nb_conf, nb_graphs);\n+\t\t\t\tbreak;\n+\t\t\t}\n+\t\t}\n \t}\n \n \tif (!rc)\ndiff --git a/app/graph/l2fwd.c b/app/graph/l2fwd.c\nnew file mode 100644\nindex 0000000000..20894b64fe\n--- /dev/null\n+++ b/app/graph/l2fwd.c\n@@ -0,0 +1,152 @@\n+/* SPDX-License-Identifier: BSD-3-Clause\n+ * Copyright(c) 2023 Marvell.\n+ */\n+\n+#include <errno.h>\n+#include <stdbool.h>\n+#include <stdint.h>\n+#include <stdio.h>\n+#include <stdlib.h>\n+#include <string.h>\n+\n+#include <rte_common.h>\n+#include <rte_ethdev.h>\n+#include <rte_graph.h>\n+#include <rte_graph_worker.h>\n+#include <rte_lcore.h>\n+#include <rte_node_eth_api.h>\n+\n+#include \"module_api.h\"\n+\n+static int\n+l2fwd_pattern_configure(void)\n+{\n+\tstruct rte_graph_param graph_conf;\n+\tconst char **node_patterns;\n+\tuint64_t pcap_pkts_count;\n+\tstruct lcore_conf *qconf;\n+\tuint16_t nb_patterns;\n+\tuint8_t pcap_ena;\n+\tchar *pcap_file;\n+\tint lcore_id;\n+\n+\tnb_patterns = 0;\n+\tnode_patterns = malloc((ETHDEV_RX_QUEUE_PER_LCORE_MAX + nb_patterns) *\n+\t\t\tsizeof(*node_patterns));\n+\tif (!node_patterns)\n+\t\treturn -ENOMEM;\n+\n+\tmemset(&graph_conf, 0, sizeof(graph_conf));\n+\tgraph_conf.node_patterns = node_patterns;\n+\n+\t/* Pcap config */\n+\tgraph_pcap_config_get(&pcap_ena, &pcap_pkts_count, &pcap_file);\n+\tgraph_conf.pcap_enable = pcap_ena;\n+\tgraph_conf.num_pkt_to_capture = pcap_pkts_count;\n+\tgraph_conf.pcap_filename = strdup(pcap_file);\n+\n+\tfor (lcore_id = 0; lcore_id < RTE_MAX_LCORE; lcore_id++) {\n+\t\trte_graph_t graph_id;\n+\t\trte_edge_t i;\n+\n+\t\tif (rte_lcore_is_enabled(lcore_id) == 0)\n+\t\t\tcontinue;\n+\n+\t\tqconf = &lcore_conf[lcore_id];\n+\n+\t\t/* Skip graph creation if no source exists */\n+\t\tif (!qconf->n_rx_queue)\n+\t\t\tcontinue;\n+\n+\t\t/* Add rx node patterns of this lcore */\n+\t\tfor (i = 0; i < qconf->n_rx_queue; i++) {\n+\t\t\tgraph_conf.node_patterns[nb_patterns + i] =\n+\t\t\t\tqconf->rx_queue_list[i].node_name;\n+\t\t}\n+\n+\t\tgraph_conf.nb_node_patterns = nb_patterns + i;\n+\t\tgraph_conf.socket_id = rte_lcore_to_socket_id(lcore_id);\n+\n+\t\tsnprintf(qconf->name, sizeof(qconf->name), \"worker_%u\",\n+\t\t\t\tlcore_id);\n+\n+\t\tgraph_id = rte_graph_create(qconf->name, &graph_conf);\n+\t\tif (graph_id == RTE_GRAPH_ID_INVALID)\n+\t\t\trte_exit(EXIT_FAILURE,\n+\t\t\t\t\t\"rte_graph_create(): graph_id invalid\"\n+\t\t\t\t\t\" for lcore %u\\n\", lcore_id);\n+\n+\t\tqconf->graph_id = graph_id;\n+\t\tqconf->graph = rte_graph_lookup(qconf->name);\n+\t\t/* >8 End of graph initialization. */\n+\t\tif (!qconf->graph)\n+\t\t\trte_exit(EXIT_FAILURE,\n+\t\t\t\t\t\"rte_graph_lookup(): graph %s not found\\n\",\n+\t\t\t\t\tqconf->name);\n+\t}\n+\n+\t/* Launch per-lcore init on every worker lcore */\n+\trte_eal_mp_remote_launch(graph_walk_start, NULL, SKIP_MAIN);\n+\n+\t/* Accumulate and print stats on main until exit */\n+\tif (rte_graph_has_stats_feature() && app_graph_stats_enabled())\n+\t\tgraph_stats_print();\n+\n+\treturn 0;\n+}\n+\n+static int\n+ethdev_rx_to_tx_node_link(uint32_t lcore_id)\n+{\n+\tchar name[RTE_NODE_NAMESIZE];\n+\tconst char *next_node = name;\n+\tstruct lcore_conf *qconf;\n+\tuint16_t queue, port_id;\n+\trte_node_t rx_id;\n+\tint16_t txport;\n+\tint rc = 0;\n+\n+\tqconf = &lcore_conf[lcore_id];\n+\n+\tfor (queue = 0; queue < qconf->n_rx_queue; ++queue) {\n+\t\tport_id = qconf->rx_queue_list[queue].port_id;\n+\t\ttxport = ethdev_txport_by_rxport_get(port_id);\n+\t\tif (txport >= 0) {\n+\t\t\trx_id = rte_node_from_name(qconf->rx_queue_list[queue].node_name);\n+\t\t\tsnprintf(name, sizeof(name), \"ethdev_tx-%u\", txport);\n+\t\t\trte_node_edge_update(rx_id, RTE_EDGE_ID_INVALID, &next_node, 1);\n+\t\t\trc = rte_node_ethdev_rx_next_update(rx_id, name);\n+\t\t\tif (rc)\n+\t\t\t\tgoto exit;\n+\t\t} else {\n+\t\t\trc = -EINVAL;\n+\t\t\tgoto exit;\n+\t\t}\n+\t}\n+exit:\n+\treturn rc;\n+}\n+\n+\n+int\n+usecase_l2fwd_configure(struct rte_node_ethdev_config *conf, uint16_t nb_confs, uint16_t nb_graphs)\n+{\n+\tuint32_t lcore_id;\n+\tint rc;\n+\n+\trc = rte_node_eth_config(conf, nb_confs, nb_graphs);\n+\tif (rc)\n+\t\trte_exit(EXIT_FAILURE, \"rte_node_eth_config: err=%d\\n\", rc);\n+\n+\tfor (lcore_id = 0; lcore_id < RTE_MAX_LCORE; lcore_id++) {\n+\t\trc = ethdev_rx_to_tx_node_link(lcore_id);\n+\t\tif (rc)\n+\t\t\trte_exit(EXIT_FAILURE, \"rte_node_eth_config: err=%d\\n\", rc);\n+\t}\n+\n+\trc = l2fwd_pattern_configure();\n+\tif (rc)\n+\t\trte_exit(EXIT_FAILURE, \"l2fwd_pattern_failure: err=%d\\n\", rc);\n+\n+\treturn rc;\n+}\ndiff --git a/app/graph/l2fwd.h b/app/graph/l2fwd.h\nnew file mode 100644\nindex 0000000000..3486ce52b2\n--- /dev/null\n+++ b/app/graph/l2fwd.h\n@@ -0,0 +1,11 @@\n+/* SPDX-License-Identifier: BSD-3-Clause\n+ * Copyright(c) 2023 Marvell.\n+ */\n+\n+#ifndef APP_GRAPH_L2FWD_H\n+#define APP_GRAPH_L2FWD_H\n+\n+int usecase_l2fwd_configure(struct rte_node_ethdev_config *conf, uint16_t nb_conf,\n+\t\t\t uint16_t nb_graphs);\n+\n+#endif\ndiff --git a/app/graph/meson.build b/app/graph/meson.build\nindex 5b0f966d99..edd6b17ebc 100644\n--- a/app/graph/meson.build\n+++ b/app/graph/meson.build\n@@ -17,6 +17,7 @@ sources = files(\n 'graph.c',\n 'ip4_route.c',\n 'ip6_route.c',\n+ 'l2fwd.c',\n 'l3fwd.c',\n 'main.c',\n 'mempool.c',\ndiff --git a/app/graph/module_api.h b/app/graph/module_api.h\nindex 7193e0b616..c80eeb704c 100644\n--- a/app/graph/module_api.h\n+++ b/app/graph/module_api.h\n@@ -13,6 +13,7 @@\n #include \"ethdev.h\"\n #include \"ethdev_rx.h\"\n #include \"graph.h\"\n+#include \"l2fwd.h\"\n #include \"l3fwd.h\"\n #include \"mempool.h\"\n #include \"neigh.h\"\ndiff --git a/doc/guides/tools/graph.rst b/doc/guides/tools/graph.rst\nindex 0aab41cbca..5308967b6b 100644\n--- a/doc/guides/tools/graph.rst\n+++ b/doc/guides/tools/graph.rst\n@@ -77,6 +77,13 @@ This use case is supported for both H/W and PCAP vdev network devices.\n To demonstrate, corresponding ``.cli`` files are available at ``app/graph/examples/``\n named as ``l3fwd.cli`` and ``l3fwd_pcap.cli`` respectively.\n \n+l2fwd\n+~~~~~\n+\n+This use case is supported for both H/W and PCAP vdev network devices.\n+To demonstrate, corresponding ``.cli`` files are available at ``app/graph/examples/``\n+named as ``l2fwd.cli`` and ``l2fwd_pcap.cli`` respectively.\n+\n Example Commands\n ^^^^^^^^^^^^^^^^\n For H/W devices\n@@ -86,6 +93,9 @@ For H/W devices\n ./dpdk-graph -c 0xff -a 0002:02:00.0 -a 0002:03:00.0 --\n -s <dpdk_root_dir>/app/graph/examples/l3fwd.cli\n \n+ ./dpdk-graph -c 0xff -a 0002:02:00.0 -a 0002:03:00.0 --\n+ -s <dpdk_root_dir>/app/graph/examples/l2fwd.cli\n+\n For net_pcapX devices\n \n .. code-block:: console\n@@ -94,6 +104,10 @@ For net_pcapX devices\n --vdev=net_pcap1,rx_pcap=in_net_pcap1.pcap,tx_pcap=out_net_pcap0.pcap\n -- -s <dpdk_root_dir>/app/graph/examples/l3fwd_pcap.cli\n \n+ ./dpdk-graph -c 0xff --vdev=net_pcap0,rx_pcap=in_net_pcap0.pcap,tx_pcap=out_net_pcap1.pcap\n+ --vdev=net_pcap1,rx_pcap=in_net_pcap1.pcap,tx_pcap=out_net_pcap0.pcap\n+ -- -s <dpdk_root_dir>/app/graph/examples/l2fwd_pcap.cli\n+\n Verifying traffic\n ^^^^^^^^^^^^^^^^^\n \n@@ -325,3 +339,10 @@ l3fwd\n .. _figure_l3fwd_graph:\n \n .. figure:: img/graph-usecase-l3fwd.*\n+\n+l2fwd\n+~~~~~\n+\n+.. _figure_l2fwd_graph:\n+\n+.. figure:: img/graph-usecase-l2fwd.*\ndiff --git a/doc/guides/tools/img/graph-usecase-l2fwd.svg b/doc/guides/tools/img/graph-usecase-l2fwd.svg\nnew file mode 100644\nindex 0000000000..15763d8fa5\n--- /dev/null\n+++ b/doc/guides/tools/img/graph-usecase-l2fwd.svg\n@@ -0,0 +1,92 @@\n+<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?>\n+<!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\"\n+ \"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd\">\n+<!-- Generated by graphviz version 2.43.0 (0)\n+ -->\n+<!-- SPDX-License-Identifier: BSD-3-Clause -->\n+<!-- Copyright(C) 2023 Marvell. -->\n+<!--\n+\n+Generated with following command\n+dot -Tsvg dot.dot -o doc/guides/tools/img/graph-usecase-l2fwd.svg\n+\n+cat dot.dot\n+digraph dpdk_app_graph_l2fwd_nodes_flow {\n+ ingress_port [shape=rect]\n+ ethdev_rx\n+ ethdev_tx\n+ pkt_drop\n+ egress_port [shape=rect]\n+\n+ ingress_port -> ethdev_rx [label=\"ingress packet\"]\n+\n+ ethdev_rx -> ethdev_tx\n+ ethdev_tx -> egress_port [label=\"egress packet\"]\n+ ethdev_tx -> pkt_drop [color=\"red\" style=\"dashed\"]\n+}\n+ -->\n+\n+<!-- Title: dpdk_app_graph_l2fwd_nodes_flow Pages: 1 -->\n+<svg width=\"253pt\" height=\"291pt\"\n+ viewBox=\"0.00 0.00 253.00 291.00\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n+<g id=\"graph0\" class=\"graph\" transform=\"scale(1 1) rotate(0) translate(4 287)\">\n+<title>dpdk_app_graph_l2fwd_nodes_flow</title>\n+<polygon fill=\"white\" stroke=\"transparent\" points=\"-4,4 -4,-287 249,-287 249,4 -4,4\"/>\n+<!-- ingress_port -->\n+<g id=\"node1\" class=\"node\">\n+<title>ingress_port</title>\n+<polygon fill=\"none\" stroke=\"black\" points=\"165,-283 59,-283 59,-247 165,-247 165,-283\"/>\n+<text text-anchor=\"middle\" x=\"112\" y=\"-261.3\" font-family=\"Times,serif\" font-size=\"14.00\">ingress_port</text>\n+</g>\n+<!-- ethdev_rx -->\n+<g id=\"node2\" class=\"node\">\n+<title>ethdev_rx</title>\n+<ellipse fill=\"none\" stroke=\"black\" cx=\"112\" cy=\"-178\" rx=\"56.59\" ry=\"18\"/>\n+<text text-anchor=\"middle\" x=\"112\" y=\"-174.3\" font-family=\"Times,serif\" font-size=\"14.00\">ethdev_rx</text>\n+</g>\n+<!-- ingress_port->ethdev_rx -->\n+<g id=\"edge1\" class=\"edge\">\n+<title>ingress_port->ethdev_rx</title>\n+<path fill=\"none\" stroke=\"black\" d=\"M112,-246.8C112,-235.16 112,-219.55 112,-206.24\"/>\n+<polygon fill=\"black\" stroke=\"black\" points=\"115.5,-206.18 112,-196.18 108.5,-206.18 115.5,-206.18\"/>\n+<text text-anchor=\"middle\" x=\"164.5\" y=\"-217.8\" font-family=\"Times,serif\" font-size=\"14.00\">ingress packet</text>\n+</g>\n+<!-- ethdev_tx -->\n+<g id=\"node3\" class=\"node\">\n+<title>ethdev_tx</title>\n+<ellipse fill=\"none\" stroke=\"black\" cx=\"112\" cy=\"-105\" rx=\"55.79\" ry=\"18\"/>\n+<text text-anchor=\"middle\" x=\"112\" y=\"-101.3\" font-family=\"Times,serif\" font-size=\"14.00\">ethdev_tx</text>\n+</g>\n+<!-- ethdev_rx->ethdev_tx -->\n+<g id=\"edge2\" class=\"edge\">\n+<title>ethdev_rx->ethdev_tx</title>\n+<path fill=\"none\" stroke=\"black\" d=\"M112,-159.81C112,-151.79 112,-142.05 112,-133.07\"/>\n+<polygon fill=\"black\" stroke=\"black\" points=\"115.5,-133.03 112,-123.03 108.5,-133.03 115.5,-133.03\"/>\n+</g>\n+<!-- pkt_drop -->\n+<g id=\"node4\" class=\"node\">\n+<title>pkt_drop</title>\n+<ellipse fill=\"none\" stroke=\"black\" cx=\"52\" cy=\"-18\" rx=\"51.99\" ry=\"18\"/>\n+<text text-anchor=\"middle\" x=\"52\" y=\"-14.3\" font-family=\"Times,serif\" font-size=\"14.00\">pkt_drop</text>\n+</g>\n+<!-- ethdev_tx->pkt_drop -->\n+<g id=\"edge4\" class=\"edge\">\n+<title>ethdev_tx->pkt_drop</title>\n+<path fill=\"none\" stroke=\"red\" stroke-dasharray=\"5,2\" d=\"M100.14,-87.21C91.43,-74.87 79.45,-57.89 69.62,-43.97\"/>\n+<polygon fill=\"red\" stroke=\"red\" points=\"72.45,-41.91 63.82,-35.76 66.73,-45.95 72.45,-41.91\"/>\n+</g>\n+<!-- egress_port -->\n+<g id=\"node5\" class=\"node\">\n+<title>egress_port</title>\n+<polygon fill=\"none\" stroke=\"black\" points=\"222.5,-36 121.5,-36 121.5,0 222.5,0 222.5,-36\"/>\n+<text text-anchor=\"middle\" x=\"172\" y=\"-14.3\" font-family=\"Times,serif\" font-size=\"14.00\">egress_port</text>\n+</g>\n+<!-- ethdev_tx->egress_port -->\n+<g id=\"edge3\" class=\"edge\">\n+<title>ethdev_tx->egress_port</title>\n+<path fill=\"none\" stroke=\"black\" d=\"M123.85,-87.21C132.5,-74.95 144.39,-58.11 154.18,-44.24\"/>\n+<polygon fill=\"black\" stroke=\"black\" points=\"157.05,-46.24 159.96,-36.05 151.33,-42.2 157.05,-46.24\"/>\n+<text text-anchor=\"middle\" x=\"195\" y=\"-57.8\" font-family=\"Times,serif\" font-size=\"14.00\">egress packet</text>\n+</g>\n+</g>\n+</svg>\n", "prefixes": [ "v9", "3/3" ] }