Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/65179/?format=api
{ "id": 65179, "url": "http://patches.dpdk.org/api/patches/65179/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20200128053506.2173-12-pbhagavatula@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": "<20200128053506.2173-12-pbhagavatula@marvell.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20200128053506.2173-12-pbhagavatula@marvell.com", "date": "2020-01-28T05:35:05", "name": "[v6,11/11] doc: update l3fwd user guide to support eventdev", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": true, "hash": "4dcb01e6082ab304a34ebf9119b5c60f754202e5", "submitter": { "id": 1183, "url": "http://patches.dpdk.org/api/people/1183/?format=api", "name": "Pavan Nikhilesh Bhagavatula", "email": "pbhagavatula@marvell.com" }, "delegate": { "id": 310, "url": "http://patches.dpdk.org/api/users/310/?format=api", "username": "jerin", "first_name": "Jerin", "last_name": "Jacob", "email": "jerinj@marvell.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20200128053506.2173-12-pbhagavatula@marvell.com/mbox/", "series": [ { "id": 8312, "url": "http://patches.dpdk.org/api/series/8312/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=8312", "date": "2020-01-28T05:34:54", "name": "example/l3fwd: introduce event device support", "version": 6, "mbox": "http://patches.dpdk.org/series/8312/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/65179/comments/", "check": "fail", "checks": "http://patches.dpdk.org/api/patches/65179/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 dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 7A811A04B3;\n\tTue, 28 Jan 2020 06:37:15 +0100 (CET)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 27CC81C069;\n\tTue, 28 Jan 2020 06:36:15 +0100 (CET)", "from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com\n [67.231.148.174]) by dpdk.org (Postfix) with ESMTP id 881761C035\n for <dev@dpdk.org>; Tue, 28 Jan 2020 06:36:13 +0100 (CET)", "from pps.filterd (m0045849.ppops.net [127.0.0.1])\n by mx0a-0016f401.pphosted.com (8.16.0.42/8.16.0.42) with SMTP id\n 00S5XPfj031054; Mon, 27 Jan 2020 21:36:12 -0800", "from sc-exch01.marvell.com ([199.233.58.181])\n by mx0a-0016f401.pphosted.com with ESMTP id 2xt6bssvfm-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT);\n Mon, 27 Jan 2020 21:36:12 -0800", "from SC-EXCH01.marvell.com (10.93.176.81) by SC-EXCH01.marvell.com\n (10.93.176.81) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Mon, 27 Jan\n 2020 21:36:11 -0800", "from maili.marvell.com (10.93.176.43) by SC-EXCH01.marvell.com\n (10.93.176.81) with Microsoft SMTP Server id 15.0.1497.2 via Frontend\n Transport; Mon, 27 Jan 2020 21:36:11 -0800", "from BG-LT7430.marvell.com (unknown [10.28.17.49])\n by maili.marvell.com (Postfix) with ESMTP id 2A4123F703F;\n Mon, 27 Jan 2020 21:36:05 -0800 (PST)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com;\n h=from : to : cc :\n subject : date : message-id : in-reply-to : references : mime-version :\n content-transfer-encoding : content-type; s=pfpt0818;\n bh=DCDNd4FyBcsd3wPE7uNCfTrM1hYdVkhS0jz77DjA3Aw=;\n b=N4BL2/lLz+NSpJUsMmC/UWBpJ3ZHw+IV2QxY1KYM939Y1cj4CLuyVRiihiCAAKQz6102\n 8Tj5WueVsFjGAZSqAR/xsYU9VYbJFkA2Aj2rIx5AkKqJDCrjhYWeeE4pz66q+Q8o9qIg\n 00c/uIwhlFdboaHofIXGY1uz+T9KyRoq7nf4powzl/h3kE8HC9yMSqjcwCCMEuVSfIKw\n lSvR9so6QUMTgO5K7e0pJaKXrXHSXxXqfdmUnJDFmO2qGit5I61yLcVhzW25tpSd5sF/\n C9rtWlrFG6RJbc1z/tMyMeKScCJlu8bqrKeDIZDicGmQfcHInzGJd9js8u0iFArMSVfV ww==", "From": "<pbhagavatula@marvell.com>", "To": "<jerinj@marvell.com>, <konstantin.ananyev@intel.com>, Thomas Monjalon\n <thomas@monjalon.net>, John McNamara <john.mcnamara@intel.com>, \"Marko\n Kovacevic\" <marko.kovacevic@intel.com>, Ori Kam <orika@mellanox.com>,\n \"Bruce Richardson\" <bruce.richardson@intel.com>, Radu Nicolau\n <radu.nicolau@intel.com>, Akhil Goyal <akhil.goyal@nxp.com>,\n Tomasz Kantecki <tomasz.kantecki@intel.com>,\n Sunil Kumar Kori <skori@marvell.com>, \"Pavan\n Nikhilesh\" <pbhagavatula@marvell.com>", "CC": "<dev@dpdk.org>", "Date": "Tue, 28 Jan 2020 11:05:05 +0530", "Message-ID": "<20200128053506.2173-12-pbhagavatula@marvell.com>", "X-Mailer": "git-send-email 2.17.1", "In-Reply-To": "<20200128053506.2173-1-pbhagavatula@marvell.com>", "References": "<20200124040542.2360--1-pbhagavatula@marvell.com>\n <20200128053506.2173-1-pbhagavatula@marvell.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Content-Type": "text/plain", "X-Proofpoint-Virus-Version": "vendor=fsecure engine=2.50.10434:6.0.138, 18.0.572\n definitions=2020-01-27_08:2020-01-24,\n 2020-01-27 signatures=0", "Subject": "[dpdk-dev] [PATCH v6 11/11] doc: update l3fwd user guide to support\n\teventdev", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.15", "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", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "From: Pavan Nikhilesh <pbhagavatula@marvell.com>\n\nUpdate l3fwd user guide to include event device related information.\nUpdate release notes and MAINTAINERS file.\n\nSigned-off-by: Pavan Nikhilesh <pbhagavatula@marvell.com>\n---\n MAINTAINERS | 1 +\n doc/guides/rel_notes/release_20_02.rst | 5 ++\n doc/guides/sample_app_ug/l3_forward.rst | 79 +++++++++++++++++++++++--\n 3 files changed, 79 insertions(+), 6 deletions(-)", "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 94bccae6d..8047aaf2a 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -430,6 +430,7 @@ T: git://dpdk.org/next/dpdk-next-eventdev\n F: lib/librte_eventdev/\n F: drivers/event/skeleton/\n F: app/test/test_eventdev.c\n+F: examples/l3fwd/l3fwd_event*\n \n Eventdev Ethdev Rx Adapter API\n M: Nikhil Rao <nikhil.rao@intel.com>\ndiff --git a/doc/guides/rel_notes/release_20_02.rst b/doc/guides/rel_notes/release_20_02.rst\nindex 50e2c1484..9cb69e53b 100644\n--- a/doc/guides/rel_notes/release_20_02.rst\n+++ b/doc/guides/rel_notes/release_20_02.rst\n@@ -143,6 +143,11 @@ New Features\n Added a new OCTEON TX2 rawdev PMD for End Point mode of operation.\n See the :doc:`../rawdevs/octeontx2_ep` for more details on this new PMD.\n \n+* **Add event device support for l3fwd sample application.**\n+\n+ Add event device support for ``l3fwd`` sample application. It demonstrates\n+ usage of poll and event mode IO mechanism under a single application.\n+\n \n Removed Items\n -------------\ndiff --git a/doc/guides/sample_app_ug/l3_forward.rst b/doc/guides/sample_app_ug/l3_forward.rst\nindex 4cb4b18da..153e46893 100644\n--- a/doc/guides/sample_app_ug/l3_forward.rst\n+++ b/doc/guides/sample_app_ug/l3_forward.rst\n@@ -4,16 +4,23 @@\n L3 Forwarding Sample Application\n ================================\n \n-The L3 Forwarding application is a simple example of packet processing using the DPDK.\n+The L3 Forwarding application is a simple example of packet processing using\n+DPDK to demonstrate usage of poll and event mode packet I/O mechanism.\n The application performs L3 forwarding.\n \n Overview\n --------\n \n-The application demonstrates the use of the hash and LPM libraries in the DPDK to implement packet forwarding.\n-The initialization and run-time paths are very similar to those of the :doc:`l2_forward_real_virtual`.\n-The main difference from the L2 Forwarding sample application is that the forwarding decision\n-is made based on information read from the input packet.\n+The application demonstrates the use of the hash and LPM libraries in the DPDK\n+to implement packet forwarding using poll or event mode PMDs for packet I/O.\n+The initialization and run-time paths are very similar to those of the\n+:doc:`l2_forward_real_virtual` and :doc:`l2_forward_event`.\n+The main difference from the L2 Forwarding sample application is that optionally\n+packet can be Rx/Tx from/to eventdev instead of port directly and forwarding\n+decision is made based on information read from the input packet.\n+\n+Eventdev can optionally use S/W or H/W (if supported by platform) scheduler\n+implementation for packet I/O based on run time parameters.\n \n The lookup method is either hash-based or LPM-based and is selected at run time. When the selected lookup method is hash-based,\n a hash object is used to emulate the flow classification stage.\n@@ -56,6 +63,9 @@ The application has a number of command line options::\n [--ipv6]\n [--parse-ptype]\n [--per-port-pool]\n+ [--mode]\n+ [--eventq-sched]\n+ [--event-eth-rxqs]\n \n Where,\n \n@@ -86,6 +96,13 @@ Where,\n \n * ``--per-port-pool:`` Optional, set to use independent buffer pools per port. Without this option, single buffer pool is used for all ports.\n \n+* ``--mode:`` Optional, Packet transfer mode for I/O, poll or eventdev.\n+\n+* ``--eventq-sched:`` Optional, Event queue synchronization method, Ordered, Atomic or Parallel. Only valid if --mode=eventdev.\n+\n+* ``--event-eth-rxqs:`` Optional, Number of ethernet RX queues per device. Only valid if --mode=eventdev.\n+\n+\n For example, consider a dual processor socket platform with 8 physical cores, where cores 0-7 and 16-23 appear on socket 0,\n while cores 8-15 and 24-31 appear on socket 1.\n \n@@ -116,6 +133,51 @@ In this command:\n | | | | |\n +----------+-----------+-----------+-------------------------------------+\n \n+To use eventdev mode with sync method **ordered** on above mentioned environment,\n+Following is the sample command:\n+\n+.. code-block:: console\n+\n+ ./build/l3fwd -l 0-3 -n 4 -w <event device> -- -p 0x3 --eventq-sched=ordered\n+\n+or\n+\n+.. code-block:: console\n+\n+ ./build/l3fwd -l 0-3 -n 4 -w <event device> -- -p 0x03 --mode=eventdev --eventq-sched=ordered\n+\n+In this command:\n+\n+* -w option whitelist the event device supported by platform. Way to pass this device may vary based on platform.\n+\n+* The --mode option defines PMD to be used for packet I/O.\n+\n+* The --eventq-sched option enables synchronization menthod of event queue so that packets will be scheduled accordingly.\n+\n+If application uses S/W scheduler, it uses following DPDK services:\n+\n+* Software scheduler\n+* Rx adapter service function\n+* Tx adapter service function\n+\n+Application needs service cores to run above mentioned services. Service cores\n+must be provided as EAL parameters along with the --vdev=event_sw0 to enable S/W\n+scheduler. Following is the sample command:\n+\n+.. code-block:: console\n+\n+ ./build/l3fwd -l 0-7 -s 0-3 -n 4 --vdev event_sw0 -- -p 0x3 --mode=eventdev --eventq-sched=ordered\n+\n+In case of eventdev mode, *--config* option is not used for ethernet port\n+configuration. Instead each ethernet port will be configured with mentioned\n+setup:\n+\n+* Single Rx/Tx queue\n+\n+* Each Rx queue will be connected to event queue via Rx adapter.\n+\n+* Each Tx queue will be connected via Tx adapter.\n+\n Refer to the *DPDK Getting Started Guide* for general information on running applications and\n the Environment Abstraction Layer (EAL) options.\n \n@@ -125,7 +187,7 @@ Explanation\n -----------\n \n The following sections provide some explanation of the sample application code. As mentioned in the overview section,\n-the initialization and run-time paths are very similar to those of the :doc:`l2_forward_real_virtual`.\n+the initialization and run-time paths are very similar to those of the :doc:`l2_forward_real_virtual` and :doc:`l2_forward_event`.\n The following sections describe aspects that are specific to the L3 Forwarding sample application.\n \n Hash Initialization\n@@ -315,3 +377,8 @@ for LPM-based lookups is done by the get_ipv4_dst_port() function below:\n \n return ((rte_lpm_lookup(ipv4_l3fwd_lookup_struct, rte_be_to_cpu_32(ipv4_hdr->dst_addr), &next_hop) == 0)? next_hop : portid);\n }\n+\n+Eventdev Driver Initialization\n+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n+Eventdev driver initialization is same as L2 forwarding eventdev application.\n+Refer :doc:`l2_forward_event` for more details.\n", "prefixes": [ "v6", "11/11" ] }