F: drivers/dma/skeleton/
F: app/test/test_dmadev*
F: doc/guides/prog_guide/dmadev.rst
+M: Kevin Laatz <kevin.laatz@intel.com>
+M: Bruce Richardson <bruce.richardson@intel.com>
+F: examples/dma/
+F: doc/guides/sample_app_ug/dma.rst
Eventdev API
M: Jerin Jacob <jerinj@marvell.com>
M: Bruce Richardson <bruce.richardson@intel.com>
F: drivers/raw/ioat/
F: doc/guides/rawdevs/ioat.rst
-F: examples/ioat/
-F: doc/guides/sample_app_ug/ioat.rst
Marvell CNXK BPHY
M: Jakub Palider <jpalider@marvell.com>
--- /dev/null
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(c) 2019-2021 Intel Corporation.
+
+.. include:: <isonum.txt>
+
+Packet copying using DMAdev library
+===================================
+
+Overview
+--------
+
+This sample is intended as a demonstration of the basic components of a DPDK
+forwarding application and example of how to use the DMAdev API to make a packet
+copy application.
+
+Also while forwarding, the MAC addresses are affected as follows:
+
+* The source MAC address is replaced by the TX port MAC address
+
+* The destination MAC address is replaced by 02:00:00:00:00:TX_PORT_ID
+
+This application can be used to compare performance of using software packet
+copy with copy done using a DMA device for different sizes of packets.
+The example will print out statistics each second. The stats shows
+received/send packets and packets dropped or failed to copy.
+
+Compiling the Application
+-------------------------
+
+To compile the sample application see :doc:`compiling`.
+
+The application is located in the ``dma`` sub-directory.
+
+
+Running the Application
+-----------------------
+
+In order to run the hardware copy application, the copying device
+needs to be bound to user-space IO driver.
+
+Refer to the "DMAdev library" chapter in the "Programmers guide" for information
+on using the library.
+
+The application requires a number of command line options:
+
+.. code-block:: console
+
+ ./<build_dir>/examples/dpdk-ioat [EAL options] -- [-p MASK] [-q NQ] [-s RS] [-c <sw|hw>]
+ [--[no-]mac-updating] [-b BS] [-f FS] [-i SI]
+
+where,
+
+* p MASK: A hexadecimal bitmask of the ports to configure (default is all)
+
+* q NQ: Number of Rx queues used per port equivalent to DMA channels
+ per port (default is 1)
+
+* c CT: Performed packet copy type: software (sw) or hardware using
+ DMA (hw) (default is hw)
+
+* s RS: Size of dmadev descriptor ring for hardware copy mode or rte_ring for
+ software copy mode (default is 2048)
+
+* --[no-]mac-updating: Whether MAC address of packets should be changed
+ or not (default is mac-updating)
+
+* b BS: set the DMA batch size
+
+* f FS: set the max frame size
+
+* i SI: set the interval, in second, between statistics prints (default is 1)
+
+The application can be launched in various configurations depending on
+provided parameters. The app can use up to 2 lcores: one of them receives
+incoming traffic and makes a copy of each packet. The second lcore then
+updates MAC address and sends the copy. If one lcore per port is used,
+both operations are done sequentially. For each configuration an additional
+lcore is needed since the main lcore does not handle traffic but is
+responsible for configuration, statistics printing and safe shutdown of
+all ports and devices.
+
+The application can use a maximum of 8 ports.
+
+To run the application in a Linux environment with 3 lcores (the main lcore,
+plus two forwarding cores), a single port (port 0), software copying and MAC
+updating issue the command:
+
+.. code-block:: console
+
+ $ ./<build_dir>/examples/dpdk-dma -l 0-2 -n 2 -- -p 0x1 --mac-updating -c sw
+
+To run the application in a Linux environment with 2 lcores (the main lcore,
+plus one forwarding core), 2 ports (ports 0 and 1), hardware copying and no MAC
+updating issue the command:
+
+.. code-block:: console
+
+ $ ./<build_dir>/examples/dpdk-dma -l 0-1 -n 1 -- -p 0x3 --no-mac-updating -c hw
+
+Refer to the *DPDK Getting Started Guide* for general information on
+running applications and the Environment Abstraction Layer (EAL) options.
+
+Explanation
+-----------
+
+The following sections provide an explanation of the main components of the
+code.
+
+All DPDK library functions used in the sample code are prefixed with
+``rte_`` and are explained in detail in the *DPDK API Documentation*.
+
+
+The Main Function
+~~~~~~~~~~~~~~~~~
+
+The ``main()`` function performs the initialization and calls the execution
+threads for each lcore.
+
+The first task is to initialize the Environment Abstraction Layer (EAL).
+The ``argc`` and ``argv`` arguments are provided to the ``rte_eal_init()``
+function. The value returned is the number of parsed arguments:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Init EAL. 8<
+ :end-before: >8 End of init EAL.
+ :dedent: 1
+
+
+The ``main()`` also allocates a mempool to hold the mbufs (Message Buffers)
+used by the application:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Allocates mempool to hold the mbufs. 8<
+ :end-before: >8 End of allocates mempool to hold the mbufs.
+ :dedent: 1
+
+Mbufs are the packet buffer structure used by DPDK. They are explained in
+detail in the "Mbuf Library" section of the *DPDK Programmer's Guide*.
+
+The ``main()`` function also initializes the ports:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Initialize each port. 8<
+ :end-before: >8 End of initializing each port.
+ :dedent: 1
+
+Each port is configured using ``port_init()`` function. The Ethernet
+ports are configured with local settings using the ``rte_eth_dev_configure()``
+function and the ``port_conf`` struct. The RSS is enabled so that
+multiple Rx queues could be used for packet receiving and copying by
+multiple DMA channels per port:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Configuring port to use RSS for multiple RX queues. 8<
+ :end-before: >8 End of configuring port to use RSS for multiple RX queues.
+ :dedent: 1
+
+For this example the ports are set up with the number of Rx queues provided
+with -q option and 1 Tx queue using the ``rte_eth_rx_queue_setup()``
+and ``rte_eth_tx_queue_setup()`` functions.
+
+The Ethernet port is then started:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Start device. 8<
+ :end-before: >8 End of starting device.
+ :dedent: 1
+
+
+Finally the Rx port is set in promiscuous mode:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: RX port is set in promiscuous mode. 8<
+ :end-before: >8 End of RX port is set in promiscuous mode.
+ :dedent: 1
+
+
+After that each port application assigns resources needed.
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Assigning each port resources. 8<
+ :end-before: >8 End of assigning each port resources.
+ :dedent: 1
+
+Ring structures are assigned for exchanging packets between lcores for both SW
+and HW copy modes.
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Assign ring structures for packet exchanging. 8<
+ :end-before: >8 End of assigning ring structures for packet exchanging.
+ :dedent: 0
+
+
+When using hardware copy each Rx queue of the port is assigned a DMA device
+(``assign_dmadevs()``) using DMAdev library API functions:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Using dmadev API functions. 8<
+ :end-before: >8 End of using dmadev API functions.
+ :dedent: 0
+
+
+The initialization of hardware device is done by ``rte_dma_configure()`` and
+``rte_dma_vchan_setup()`` functions using the ``rte_dma_conf`` and
+``rte_dma_vchan_conf`` structs. After configuration the device is started
+using ``rte_dma_start()`` function. Each of the above operations is done in
+``configure_dmadev_queue()``.
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Configuration of device. 8<
+ :end-before: >8 End of configuration of device.
+ :dedent: 0
+
+If initialization is successful, memory for hardware device
+statistics is allocated.
+
+Finally ``main()`` function starts all packet handling lcores and starts
+printing stats in a loop on the main lcore. The application can be
+interrupted and closed using ``Ctrl-C``. The main lcore waits for
+all worker lcores to finish, deallocates resources and exits.
+
+The processing lcores launching function are described below.
+
+The Lcores Launching Functions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+As described above, ``main()`` function invokes ``start_forwarding_cores()``
+function in order to start processing for each lcore:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Start processing for each lcore. 8<
+ :end-before: >8 End of starting to processfor each lcore.
+ :dedent: 0
+
+The function launches Rx/Tx processing functions on configured lcores
+using ``rte_eal_remote_launch()``. The configured ports, their number
+and number of assigned lcores are stored in user-defined
+``rxtx_transmission_config`` struct:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Configuring ports and number of assigned lcores in struct. 8<
+ :end-before: >8 End of configuration of ports and number of assigned lcores.
+ :dedent: 0
+
+The structure is initialized in 'main()' function with the values
+corresponding to ports and lcores configuration provided by the user.
+
+The Lcores Processing Functions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For receiving packets on each port, the ``dma_rx_port()`` function is used.
+The function receives packets on each configured Rx queue. Depending on the
+mode the user chose, it will enqueue packets to DMA channels and
+then invoke copy process (hardware copy), or perform software copy of each
+packet using ``pktmbuf_sw_copy()`` function and enqueue them to an rte_ring:
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Receive packets on one port and enqueue to dmadev or rte_ring. 8<
+ :end-before: >8 End of receive packets on one port and enqueue to dmadev or rte_ring.
+ :dedent: 0
+
+The packets are received in burst mode using ``rte_eth_rx_burst()``
+function. When using hardware copy mode the packets are enqueued in
+copying device's buffer using ``dma_enqueue_packets()`` which calls
+``rte_dma_copy()``. When all received packets are in the
+buffer the copy operations are started by calling ``rte_dma_submit()``.
+Function ``rte_dma_copy()`` operates on physical address of
+the packet. Structure ``rte_mbuf`` contains only physical address to
+start of the data buffer (``buf_iova``). Thus the ``rte_pktmbuf_iova()`` API is
+used to get the address of the start of the data within the mbuf.
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Receive packets on one port and enqueue to dmadev or rte_ring. 8<
+ :end-before: >8 End of receive packets on one port and enqueue to dmadev or rte_ring.
+ :dedent: 0
+
+
+Once the copies have been completed (this includes gathering the completions in
+HW copy mode), the copied packets are enqueued to the ``rx_to_tx_ring``, which
+is used to pass the packets to the TX function.
+
+All completed copies are processed by ``dma_tx_port()`` function. This function
+dequeues copied packets from the ``rx_to_tx_ring``. Then each packet MAC address is changed
+if it was enabled. After that copies are sent in burst mode using ``rte_eth_tx_burst()``.
+
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Transmit packets from dmadev/rte_ring for one port. 8<
+ :end-before: >8 End of transmitting packets from dmadev.
+ :dedent: 0
+
+The Packet Copying Functions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In order to perform SW packet copy, there are user-defined functions to first copy
+the packet metadata (``pktmbuf_metadata_copy()``) and then the packet data
+(``pktmbuf_sw_copy()``):
+
+.. literalinclude:: ../../../examples/dma/dmafwd.c
+ :language: c
+ :start-after: Perform packet copy there is a user-defined function. 8<
+ :end-before: >8 End of perform packet copy there is a user-defined function.
+ :dedent: 0
+
+The metadata in this example is copied from ``rx_descriptor_fields1`` marker of
+``rte_mbuf`` struct up to ``buf_len`` member.
+
+In order to understand why software packet copying is done as shown
+above please refer to the "Mbuf Library" section of the
+*DPDK Programmer's Guide*.
ip_reassembly
kernel_nic_interface
keep_alive
- ioat
+ dma
l2_forward_crypto
l2_forward_job_stats
l2_forward_real_virtual
forwarding Graph, or ``l3fwd_graph`` application does forwarding based on IPv4
like a simple router with DPDK Graph framework.
-* :doc:`Hardware packet copying<ioat>`: The Hardware packet copying,
- or ``ioatfwd`` application demonstrates how to use IOAT rawdev driver for
+* :doc:`Hardware packet copying<dma>`: The Hardware packet copying,
+ or ``dmafwd`` application demonstrates how to use DMAdev library for
copying packets between two threads.
* :doc:`Packet Distributor<dist_app>`: The Packet Distributor
+++ /dev/null
-.. SPDX-License-Identifier: BSD-3-Clause
- Copyright(c) 2019 Intel Corporation.
-
-.. include:: <isonum.txt>
-
-Packet copying using Intel\ |reg| QuickData Technology
-======================================================
-
-Overview
---------
-
-This sample is intended as a demonstration of the basic components of a DPDK
-forwarding application and example of how to use IOAT driver API to make
-packets copies.
-
-Also while forwarding, the MAC addresses are affected as follows:
-
-* The source MAC address is replaced by the TX port MAC address
-
-* The destination MAC address is replaced by 02:00:00:00:00:TX_PORT_ID
-
-This application can be used to compare performance of using software packet
-copy with copy done using a DMA device for different sizes of packets.
-The example will print out statistics each second. The stats shows
-received/send packets and packets dropped or failed to copy.
-
-Compiling the Application
--------------------------
-
-To compile the sample application see :doc:`compiling`.
-
-The application is located in the ``ioat`` sub-directory.
-
-
-Running the Application
------------------------
-
-In order to run the hardware copy application, the copying device
-needs to be bound to user-space IO driver.
-
-Refer to the "IOAT Rawdev Driver" chapter in the "Rawdev Drivers" document
-for information on using the driver.
-
-The application requires a number of command line options:
-
-.. code-block:: console
-
- ./<build_dir>/examples/dpdk-ioat [EAL options] -- [-p MASK] [-q NQ] [-s RS] [-c <sw|hw>]
- [--[no-]mac-updating] [-b BS] [-f FS] [-i SI]
-
-where,
-
-* p MASK: A hexadecimal bitmask of the ports to configure (default is all)
-
-* q NQ: Number of Rx queues used per port equivalent to CBDMA channels
- per port (default is 1)
-
-* c CT: Performed packet copy type: software (sw) or hardware using
- DMA (hw) (default is hw)
-
-* s RS: Size of IOAT rawdev ring for hardware copy mode or rte_ring for
- software copy mode (default is 2048)
-
-* --[no-]mac-updating: Whether MAC address of packets should be changed
- or not (default is mac-updating)
-
-* b BS: set the DMA batch size
-
-* f FS: set the max frame size
-
-* i SI: set the interval, in second, between statistics prints (default is 1)
-
-The application can be launched in various configurations depending on
-provided parameters. The app can use up to 2 lcores: one of them receives
-incoming traffic and makes a copy of each packet. The second lcore then
-updates MAC address and sends the copy. If one lcore per port is used,
-both operations are done sequentially. For each configuration an additional
-lcore is needed since the main lcore does not handle traffic but is
-responsible for configuration, statistics printing and safe shutdown of
-all ports and devices.
-
-The application can use a maximum of 8 ports.
-
-To run the application in a Linux environment with 3 lcores (the main lcore,
-plus two forwarding cores), a single port (port 0), software copying and MAC
-updating issue the command:
-
-.. code-block:: console
-
- $ ./<build_dir>/examples/dpdk-ioat -l 0-2 -n 2 -- -p 0x1 --mac-updating -c sw
-
-To run the application in a Linux environment with 2 lcores (the main lcore,
-plus one forwarding core), 2 ports (ports 0 and 1), hardware copying and no MAC
-updating issue the command:
-
-.. code-block:: console
-
- $ ./<build_dir>/examples/dpdk-ioat -l 0-1 -n 1 -- -p 0x3 --no-mac-updating -c hw
-
-Refer to the *DPDK Getting Started Guide* for general information on
-running applications and the Environment Abstraction Layer (EAL) options.
-
-Explanation
------------
-
-The following sections provide an explanation of the main components of the
-code.
-
-All DPDK library functions used in the sample code are prefixed with
-``rte_`` and are explained in detail in the *DPDK API Documentation*.
-
-
-The Main Function
-~~~~~~~~~~~~~~~~~
-
-The ``main()`` function performs the initialization and calls the execution
-threads for each lcore.
-
-The first task is to initialize the Environment Abstraction Layer (EAL).
-The ``argc`` and ``argv`` arguments are provided to the ``rte_eal_init()``
-function. The value returned is the number of parsed arguments:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Init EAL. 8<
- :end-before: >8 End of init EAL.
- :dedent: 1
-
-
-The ``main()`` also allocates a mempool to hold the mbufs (Message Buffers)
-used by the application:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Allocates mempool to hold the mbufs. 8<
- :end-before: >8 End of allocates mempool to hold the mbufs.
- :dedent: 1
-
-Mbufs are the packet buffer structure used by DPDK. They are explained in
-detail in the "Mbuf Library" section of the *DPDK Programmer's Guide*.
-
-The ``main()`` function also initializes the ports:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Initialize each port. 8<
- :end-before: >8 End of initializing each port.
- :dedent: 1
-
-Each port is configured using ``port_init()`` function. The Ethernet
-ports are configured with local settings using the ``rte_eth_dev_configure()``
-function and the ``port_conf`` struct. The RSS is enabled so that
-multiple Rx queues could be used for packet receiving and copying by
-multiple CBDMA channels per port:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Configuring port to use RSS for multiple RX queues. 8<
- :end-before: >8 End of configuring port to use RSS for multiple RX queues.
- :dedent: 1
-
-For this example the ports are set up with the number of Rx queues provided
-with -q option and 1 Tx queue using the ``rte_eth_rx_queue_setup()``
-and ``rte_eth_tx_queue_setup()`` functions.
-
-The Ethernet port is then started:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Start device. 8<
- :end-before: >8 End of starting device.
- :dedent: 1
-
-
-Finally the Rx port is set in promiscuous mode:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: RX port is set in promiscuous mode. 8<
- :end-before: >8 End of RX port is set in promiscuous mode.
- :dedent: 1
-
-
-After that each port application assigns resources needed.
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Assigning each port resources. 8<
- :end-before: >8 End of assigning each port resources.
- :dedent: 1
-
-Ring structures are assigned for exchanging packets between lcores for both SW
-and HW copy modes.
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Assign ring structures for packet exchanging. 8<
- :end-before: >8 End of assigning ring structures for packet exchanging.
- :dedent: 0
-
-
-When using hardware copy each Rx queue of the port is assigned an
-IOAT device (``assign_rawdevs()``) using IOAT Rawdev Driver API
-functions:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Using IOAT rawdev API functions. 8<
- :end-before: >8 End of using IOAT rawdev API functions.
- :dedent: 0
-
-
-The initialization of hardware device is done by ``rte_rawdev_configure()``
-function using ``rte_rawdev_info`` struct. After configuration the device is
-started using ``rte_rawdev_start()`` function. Each of the above operations
-is done in ``configure_rawdev_queue()``.
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Configuration of device. 8<
- :end-before: >8 End of configuration of device.
- :dedent: 0
-
-If initialization is successful, memory for hardware device
-statistics is allocated.
-
-Finally ``main()`` function starts all packet handling lcores and starts
-printing stats in a loop on the main lcore. The application can be
-interrupted and closed using ``Ctrl-C``. The main lcore waits for
-all worker lcores to finish, deallocates resources and exits.
-
-The processing lcores launching function are described below.
-
-The Lcores Launching Functions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-As described above, ``main()`` function invokes ``start_forwarding_cores()``
-function in order to start processing for each lcore:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Start processing for each lcore. 8<
- :end-before: >8 End of starting to processfor each lcore.
- :dedent: 0
-
-The function launches Rx/Tx processing functions on configured lcores
-using ``rte_eal_remote_launch()``. The configured ports, their number
-and number of assigned lcores are stored in user-defined
-``rxtx_transmission_config`` struct:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Configuring ports and number of assigned lcores in struct. 8<
- :end-before: >8 End of configuration of ports and number of assigned lcores.
- :dedent: 0
-
-The structure is initialized in 'main()' function with the values
-corresponding to ports and lcores configuration provided by the user.
-
-The Lcores Processing Functions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-For receiving packets on each port, the ``ioat_rx_port()`` function is used.
-The function receives packets on each configured Rx queue. Depending on the
-mode the user chose, it will enqueue packets to IOAT rawdev channels and
-then invoke copy process (hardware copy), or perform software copy of each
-packet using ``pktmbuf_sw_copy()`` function and enqueue them to an rte_ring:
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Receive packets on one port and enqueue to IOAT rawdev or rte_ring. 8<
- :end-before: >8 End of receive packets on one port and enqueue to IOAT rawdev or rte_ring.
- :dedent: 0
-
-The packets are received in burst mode using ``rte_eth_rx_burst()``
-function. When using hardware copy mode the packets are enqueued in
-copying device's buffer using ``ioat_enqueue_packets()`` which calls
-``rte_ioat_enqueue_copy()``. When all received packets are in the
-buffer the copy operations are started by calling ``rte_ioat_perform_ops()``.
-Function ``rte_ioat_enqueue_copy()`` operates on physical address of
-the packet. Structure ``rte_mbuf`` contains only physical address to
-start of the data buffer (``buf_iova``). Thus the ``rte_pktmbuf_iova()`` API is
-used to get the address of the start of the data within the mbuf.
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Receive packets on one port and enqueue to IOAT rawdev or rte_ring. 8<
- :end-before: >8 End of receive packets on one port and enqueue to IOAT rawdev or rte_ring.
- :dedent: 0
-
-
-Once the copies have been completed (this includes gathering the completions in
-HW copy mode), the copied packets are enqueued to the ``rx_to_tx_ring``, which
-is used to pass the packets to the TX function.
-
-All completed copies are processed by ``ioat_tx_port()`` function. This function
-dequeues copied packets from the ``rx_to_tx_ring``. Then each packet MAC address is changed
-if it was enabled. After that copies are sent in burst mode using ``rte_eth_tx_burst()``.
-
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Transmit packets from IOAT rawdev/rte_ring for one port. 8<
- :end-before: >8 End of transmitting packets from IOAT.
- :dedent: 0
-
-The Packet Copying Functions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-In order to perform SW packet copy, there are user-defined functions to first copy
-the packet metadata (``pktmbuf_metadata_copy()``) and then the packet data
-(``pktmbuf_sw_copy()``):
-
-.. literalinclude:: ../../../examples/ioat/ioatfwd.c
- :language: c
- :start-after: Perform packet copy there is a user-defined function. 8<
- :end-before: >8 End of perform packet copy there is a user-defined function.
- :dedent: 0
-
-The metadata in this example is copied from ``rx_descriptor_fields1`` marker of
-``rte_mbuf`` struct up to ``buf_len`` member.
-
-In order to understand why software packet copying is done as shown
-above please refer to the "Mbuf Library" section of the
-*DPDK Programmer's Guide*.
--- /dev/null
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright(c) 2019 Intel Corporation
+
+# binary name
+APP = dmafwd
+
+# all source are stored in SRCS-y
+SRCS-y := dmafwd.c
+
+PKGCONF ?= pkg-config
+
+# Build using pkg-config variables if possible
+ifneq ($(shell $(PKGCONF) --exists libdpdk && echo 0),0)
+$(error "no installation of DPDK found")
+endif
+
+all: shared
+.PHONY: shared static
+shared: build/$(APP)-shared
+ ln -sf $(APP)-shared build/$(APP)
+static: build/$(APP)-static
+ ln -sf $(APP)-static build/$(APP)
+
+PC_FILE := $(shell $(PKGCONF) --path libdpdk 2>/dev/null)
+CFLAGS += -O3 $(shell $(PKGCONF) --cflags libdpdk)
+LDFLAGS_SHARED = $(shell $(PKGCONF) --libs libdpdk)
+LDFLAGS_STATIC = $(shell $(PKGCONF) --static --libs libdpdk)
+
+ifeq ($(MAKECMDGOALS),static)
+# check for broken pkg-config
+ifeq ($(shell echo $(LDFLAGS_STATIC) | grep 'whole-archive.*l:lib.*no-whole-archive'),)
+$(warning "pkg-config output list does not contain drivers between 'whole-archive'/'no-whole-archive' flags.")
+$(error "Cannot generate statically-linked binaries with this version of pkg-config")
+endif
+endif
+
+CFLAGS += -DALLOW_EXPERIMENTAL_API
+
+build/$(APP)-shared: $(SRCS-y) Makefile $(PC_FILE) | build
+ $(CC) $(CFLAGS) $(SRCS-y) -o $@ $(LDFLAGS) $(LDFLAGS_SHARED)
+
+build/$(APP)-static: $(SRCS-y) Makefile $(PC_FILE) | build
+ $(CC) $(CFLAGS) $(SRCS-y) -o $@ $(LDFLAGS) $(LDFLAGS_STATIC)
+
+build:
+ @mkdir -p $@
+
+.PHONY: clean
+clean:
+ rm -f build/$(APP) build/$(APP)-static build/$(APP)-shared
+ test -d build && rmdir -p build || true
--- /dev/null
+/* SPDX-License-Identifier: BSD-3-Clause
+ * Copyright(c) 2019-2021 Intel Corporation
+ */
+
+#include <stdint.h>
+#include <getopt.h>
+#include <signal.h>
+#include <stdbool.h>
+#include <unistd.h>
+
+#include <rte_malloc.h>
+#include <rte_ethdev.h>
+#include <rte_dmadev.h>
+
+/* size of ring used for software copying between rx and tx. */
+#define RTE_LOGTYPE_DMA RTE_LOGTYPE_USER1
+#define MAX_PKT_BURST 32
+#define MEMPOOL_CACHE_SIZE 512
+#define MIN_POOL_SIZE 65536U
+#define CMD_LINE_OPT_MAC_UPDATING "mac-updating"
+#define CMD_LINE_OPT_NO_MAC_UPDATING "no-mac-updating"
+#define CMD_LINE_OPT_PORTMASK "portmask"
+#define CMD_LINE_OPT_NB_QUEUE "nb-queue"
+#define CMD_LINE_OPT_COPY_TYPE "copy-type"
+#define CMD_LINE_OPT_RING_SIZE "ring-size"
+#define CMD_LINE_OPT_BATCH_SIZE "dma-batch-size"
+#define CMD_LINE_OPT_FRAME_SIZE "max-frame-size"
+#define CMD_LINE_OPT_STATS_INTERVAL "stats-interval"
+
+/* configurable number of RX/TX ring descriptors */
+#define RX_DEFAULT_RINGSIZE 1024
+#define TX_DEFAULT_RINGSIZE 1024
+
+/* max number of RX queues per port */
+#define MAX_RX_QUEUES_COUNT 8
+
+struct rxtx_port_config {
+ /* common config */
+ uint16_t rxtx_port;
+ uint16_t nb_queues;
+ /* for software copy mode */
+ struct rte_ring *rx_to_tx_ring;
+ /* for dmadev HW copy mode */
+ uint16_t dmadev_ids[MAX_RX_QUEUES_COUNT];
+};
+
+/* Configuring ports and number of assigned lcores in struct. 8< */
+struct rxtx_transmission_config {
+ struct rxtx_port_config ports[RTE_MAX_ETHPORTS];
+ uint16_t nb_ports;
+ uint16_t nb_lcores;
+};
+/* >8 End of configuration of ports and number of assigned lcores. */
+
+/* per-port statistics struct */
+struct dma_port_statistics {
+ uint64_t rx[RTE_MAX_ETHPORTS];
+ uint64_t tx[RTE_MAX_ETHPORTS];
+ uint64_t tx_dropped[RTE_MAX_ETHPORTS];
+ uint64_t copy_dropped[RTE_MAX_ETHPORTS];
+};
+struct dma_port_statistics port_statistics;
+struct total_statistics {
+ uint64_t total_packets_dropped;
+ uint64_t total_packets_tx;
+ uint64_t total_packets_rx;
+ uint64_t total_submitted;
+ uint64_t total_completed;
+ uint64_t total_failed;
+};
+
+typedef enum copy_mode_t {
+#define COPY_MODE_SW "sw"
+ COPY_MODE_SW_NUM,
+#define COPY_MODE_DMA "hw"
+ COPY_MODE_DMA_NUM,
+ COPY_MODE_INVALID_NUM,
+ COPY_MODE_SIZE_NUM = COPY_MODE_INVALID_NUM
+} copy_mode_t;
+
+/* mask of enabled ports */
+static uint32_t dma_enabled_port_mask;
+
+/* number of RX queues per port */
+static uint16_t nb_queues = 1;
+
+/* MAC updating enabled by default. */
+static int mac_updating = 1;
+
+/* hardare copy mode enabled by default. */
+static copy_mode_t copy_mode = COPY_MODE_DMA_NUM;
+
+/* size of descriptor ring for hardware copy mode or
+ * rte_ring for software copy mode
+ */
+static unsigned short ring_size = 2048;
+
+/* interval, in seconds, between stats prints */
+static unsigned short stats_interval = 1;
+/* global mbuf arrays for tracking DMA bufs */
+#define MBUF_RING_SIZE 2048
+#define MBUF_RING_MASK (MBUF_RING_SIZE - 1)
+struct dma_bufs {
+ struct rte_mbuf *bufs[MBUF_RING_SIZE];
+ struct rte_mbuf *copies[MBUF_RING_SIZE];
+ uint16_t sent;
+};
+static struct dma_bufs dma_bufs[RTE_DMADEV_DEFAULT_MAX];
+
+/* global transmission config */
+struct rxtx_transmission_config cfg;
+
+/* configurable number of RX/TX ring descriptors */
+static uint16_t nb_rxd = RX_DEFAULT_RINGSIZE;
+static uint16_t nb_txd = TX_DEFAULT_RINGSIZE;
+
+static volatile bool force_quit;
+
+static uint32_t dma_batch_sz = MAX_PKT_BURST;
+static uint32_t max_frame_size = RTE_ETHER_MAX_LEN;
+
+/* ethernet addresses of ports */
+static struct rte_ether_addr dma_ports_eth_addr[RTE_MAX_ETHPORTS];
+
+static struct rte_eth_dev_tx_buffer *tx_buffer[RTE_MAX_ETHPORTS];
+struct rte_mempool *dma_pktmbuf_pool;
+
+/* Print out statistics for one port. */
+static void
+print_port_stats(uint16_t port_id)
+{
+ printf("\nStatistics for port %u ------------------------------"
+ "\nPackets sent: %34"PRIu64
+ "\nPackets received: %30"PRIu64
+ "\nPackets dropped on tx: %25"PRIu64
+ "\nPackets dropped on copy: %23"PRIu64,
+ port_id,
+ port_statistics.tx[port_id],
+ port_statistics.rx[port_id],
+ port_statistics.tx_dropped[port_id],
+ port_statistics.copy_dropped[port_id]);
+}
+
+/* Print out statistics for one dmadev device. */
+static void
+print_dmadev_stats(uint32_t dev_id, struct rte_dma_stats stats)
+{
+ printf("\nDMA channel %u", dev_id);
+ printf("\n\t Total submitted ops: %"PRIu64"", stats.submitted);
+ printf("\n\t Total completed ops: %"PRIu64"", stats.completed);
+ printf("\n\t Total failed ops: %"PRIu64"", stats.errors);
+}
+
+static void
+print_total_stats(struct total_statistics *ts)
+{
+ printf("\nAggregate statistics ==============================="
+ "\nTotal packets Tx: %22"PRIu64" [pkt/s]"
+ "\nTotal packets Rx: %22"PRIu64" [pkt/s]"
+ "\nTotal packets dropped: %17"PRIu64" [pkt/s]",
+ ts->total_packets_tx / stats_interval,
+ ts->total_packets_rx / stats_interval,
+ ts->total_packets_dropped / stats_interval);
+
+ if (copy_mode == COPY_MODE_DMA_NUM) {
+ printf("\nTotal submitted ops: %19"PRIu64" [ops/s]"
+ "\nTotal completed ops: %19"PRIu64" [ops/s]"
+ "\nTotal failed ops: %22"PRIu64" [ops/s]",
+ ts->total_submitted / stats_interval,
+ ts->total_completed / stats_interval,
+ ts->total_failed / stats_interval);
+ }
+
+ printf("\n====================================================\n");
+}
+
+/* Print out statistics on packets dropped. */
+static void
+print_stats(char *prgname)
+{
+ struct total_statistics ts, delta_ts;
+ struct rte_dma_stats stats = {0};
+ uint32_t i, port_id, dev_id;
+ char status_string[255]; /* to print at the top of the output */
+ int status_strlen;
+
+ const char clr[] = { 27, '[', '2', 'J', '\0' };
+ const char topLeft[] = { 27, '[', '1', ';', '1', 'H', '\0' };
+
+ status_strlen = snprintf(status_string, sizeof(status_string),
+ "%s, ", prgname);
+ status_strlen += snprintf(status_string + status_strlen,
+ sizeof(status_string) - status_strlen,
+ "Worker Threads = %d, ",
+ rte_lcore_count() > 2 ? 2 : 1);
+ status_strlen += snprintf(status_string + status_strlen,
+ sizeof(status_string) - status_strlen,
+ "Copy Mode = %s,\n", copy_mode == COPY_MODE_SW_NUM ?
+ COPY_MODE_SW : COPY_MODE_DMA);
+ status_strlen += snprintf(status_string + status_strlen,
+ sizeof(status_string) - status_strlen,
+ "Updating MAC = %s, ", mac_updating ?
+ "enabled" : "disabled");
+ status_strlen += snprintf(status_string + status_strlen,
+ sizeof(status_string) - status_strlen,
+ "Rx Queues = %d, ", nb_queues);
+ status_strlen += snprintf(status_string + status_strlen,
+ sizeof(status_string) - status_strlen,
+ "Ring Size = %d", ring_size);
+
+ memset(&ts, 0, sizeof(struct total_statistics));
+
+ while (!force_quit) {
+ /* Sleep for "stats_interval" seconds each round - init sleep allows reading
+ * messages from app startup.
+ */
+ sleep(stats_interval);
+
+ /* Clear screen and move to top left */
+ printf("%s%s", clr, topLeft);
+
+ memset(&delta_ts, 0, sizeof(struct total_statistics));
+
+ printf("%s\n", status_string);
+
+ for (i = 0; i < cfg.nb_ports; i++) {
+ port_id = cfg.ports[i].rxtx_port;
+ print_port_stats(port_id);
+
+ delta_ts.total_packets_dropped +=
+ port_statistics.tx_dropped[port_id]
+ + port_statistics.copy_dropped[port_id];
+ delta_ts.total_packets_tx +=
+ port_statistics.tx[port_id];
+ delta_ts.total_packets_rx +=
+ port_statistics.rx[port_id];
+
+ if (copy_mode == COPY_MODE_DMA_NUM) {
+ uint32_t j;
+
+ for (j = 0; j < cfg.ports[i].nb_queues; j++) {
+ dev_id = cfg.ports[i].dmadev_ids[j];
+ rte_dma_stats_get(dev_id, 0, &stats);
+ print_dmadev_stats(dev_id, stats);
+
+ delta_ts.total_submitted += stats.submitted;
+ delta_ts.total_completed += stats.completed;
+ delta_ts.total_failed += stats.errors;
+ }
+ }
+ }
+
+ delta_ts.total_packets_tx -= ts.total_packets_tx;
+ delta_ts.total_packets_rx -= ts.total_packets_rx;
+ delta_ts.total_packets_dropped -= ts.total_packets_dropped;
+ delta_ts.total_submitted -= ts.total_submitted;
+ delta_ts.total_completed -= ts.total_completed;
+ delta_ts.total_failed -= ts.total_failed;
+
+ printf("\n");
+ print_total_stats(&delta_ts);
+
+ fflush(stdout);
+
+ ts.total_packets_tx += delta_ts.total_packets_tx;
+ ts.total_packets_rx += delta_ts.total_packets_rx;
+ ts.total_packets_dropped += delta_ts.total_packets_dropped;
+ ts.total_submitted += delta_ts.total_submitted;
+ ts.total_completed += delta_ts.total_completed;
+ ts.total_failed += delta_ts.total_failed;
+ }
+}
+
+static void
+update_mac_addrs(struct rte_mbuf *m, uint32_t dest_portid)
+{
+ struct rte_ether_hdr *eth;
+ void *tmp;
+
+ eth = rte_pktmbuf_mtod(m, struct rte_ether_hdr *);
+
+ /* 02:00:00:00:00:xx - overwriting 2 bytes of source address but
+ * it's acceptable cause it gets overwritten by rte_ether_addr_copy
+ */
+ tmp = ð->dst_addr.addr_bytes[0];
+ *((uint64_t *)tmp) = 0x000000000002 + ((uint64_t)dest_portid << 40);
+
+ /* src addr */
+ rte_ether_addr_copy(&dma_ports_eth_addr[dest_portid], ð->src_addr);
+}
+
+/* Perform packet copy there is a user-defined function. 8< */
+static inline void
+pktmbuf_metadata_copy(const struct rte_mbuf *src, struct rte_mbuf *dst)
+{
+ dst->data_off = src->data_off;
+ memcpy(&dst->rx_descriptor_fields1, &src->rx_descriptor_fields1,
+ offsetof(struct rte_mbuf, buf_len) -
+ offsetof(struct rte_mbuf, rx_descriptor_fields1));
+}
+
+/* Copy packet data */
+static inline void
+pktmbuf_sw_copy(struct rte_mbuf *src, struct rte_mbuf *dst)
+{
+ rte_memcpy(rte_pktmbuf_mtod(dst, char *),
+ rte_pktmbuf_mtod(src, char *), src->data_len);
+}
+/* >8 End of perform packet copy there is a user-defined function. */
+
+static uint32_t
+dma_enqueue_packets(struct rte_mbuf *pkts[], struct rte_mbuf *pkts_copy[],
+ uint32_t nb_rx, uint16_t dev_id)
+{
+ struct dma_bufs *dma = &dma_bufs[dev_id];
+ int ret;
+ uint32_t i;
+
+ for (i = 0; i < nb_rx; i++) {
+ /* Perform data copy */
+ ret = rte_dma_copy(dev_id, 0,
+ rte_pktmbuf_iova(pkts[i]),
+ rte_pktmbuf_iova(pkts_copy[i]),
+ rte_pktmbuf_data_len(pkts[i]), 0);
+
+ if (ret < 0)
+ break;
+
+ dma->bufs[ret & MBUF_RING_MASK] = pkts[i];
+ dma->copies[ret & MBUF_RING_MASK] = pkts_copy[i];
+ }
+
+ ret = i;
+ return ret;
+}
+
+static inline uint32_t
+dma_enqueue(struct rte_mbuf *pkts[], struct rte_mbuf *pkts_copy[],
+ uint32_t num, uint32_t step, uint16_t dev_id)
+{
+ uint32_t i, k, m, n;
+
+ k = 0;
+ for (i = 0; i < num; i += m) {
+
+ m = RTE_MIN(step, num - i);
+ n = dma_enqueue_packets(pkts + i, pkts_copy + i, m, dev_id);
+ k += n;
+ if (n > 0)
+ rte_dma_submit(dev_id, 0);
+
+ /* don't try to enqueue more if HW queue is full */
+ if (n != m)
+ break;
+ }
+
+ return k;
+}
+
+static inline uint32_t
+dma_dequeue(struct rte_mbuf *src[], struct rte_mbuf *dst[], uint32_t num,
+ uint16_t dev_id)
+{
+ struct dma_bufs *dma = &dma_bufs[dev_id];
+ uint16_t nb_dq, filled;
+ /* Dequeue the mbufs from DMA device. Since all memory
+ * is DPDK pinned memory and therefore all addresses should
+ * be valid, we don't check for copy errors
+ */
+ nb_dq = rte_dma_completed(dev_id, 0, num, NULL, NULL);
+
+ /* Return early if no work to do */
+ if (unlikely(nb_dq == 0))
+ return nb_dq;
+
+ /* Populate pkts_copy with the copies bufs from dma->copies for tx */
+ for (filled = 0; filled < nb_dq; filled++) {
+ src[filled] = dma->bufs[(dma->sent + filled) & MBUF_RING_MASK];
+ dst[filled] = dma->copies[(dma->sent + filled) & MBUF_RING_MASK];
+ }
+ dma->sent += nb_dq;
+
+ return filled;
+
+}
+
+/* Receive packets on one port and enqueue to dmadev or rte_ring. 8< */
+static void
+dma_rx_port(struct rxtx_port_config *rx_config)
+{
+ int32_t ret;
+ uint32_t nb_rx, nb_enq, i, j;
+ struct rte_mbuf *pkts_burst[MAX_PKT_BURST];
+ struct rte_mbuf *pkts_burst_copy[MAX_PKT_BURST];
+
+ for (i = 0; i < rx_config->nb_queues; i++) {
+
+ nb_rx = rte_eth_rx_burst(rx_config->rxtx_port, i,
+ pkts_burst, MAX_PKT_BURST);
+
+ if (nb_rx == 0)
+ continue;
+
+ port_statistics.rx[rx_config->rxtx_port] += nb_rx;
+
+ ret = rte_mempool_get_bulk(dma_pktmbuf_pool,
+ (void *)pkts_burst_copy, nb_rx);
+
+ if (unlikely(ret < 0))
+ rte_exit(EXIT_FAILURE,
+ "Unable to allocate memory.\n");
+
+ for (j = 0; j < nb_rx; j++)
+ pktmbuf_metadata_copy(pkts_burst[j],
+ pkts_burst_copy[j]);
+
+ if (copy_mode == COPY_MODE_DMA_NUM) {
+ /* enqueue packets for hardware copy */
+ nb_enq = dma_enqueue(pkts_burst, pkts_burst_copy,
+ nb_rx, dma_batch_sz, rx_config->dmadev_ids[i]);
+
+ /* free any not enqueued packets. */
+ rte_mempool_put_bulk(dma_pktmbuf_pool,
+ (void *)&pkts_burst[nb_enq],
+ nb_rx - nb_enq);
+ rte_mempool_put_bulk(dma_pktmbuf_pool,
+ (void *)&pkts_burst_copy[nb_enq],
+ nb_rx - nb_enq);
+
+ port_statistics.copy_dropped[rx_config->rxtx_port] +=
+ (nb_rx - nb_enq);
+
+ /* get completed copies */
+ nb_rx = dma_dequeue(pkts_burst, pkts_burst_copy,
+ MAX_PKT_BURST, rx_config->dmadev_ids[i]);
+ } else {
+ /* Perform packet software copy, free source packets */
+ for (j = 0; j < nb_rx; j++)
+ pktmbuf_sw_copy(pkts_burst[j],
+ pkts_burst_copy[j]);
+ }
+
+ rte_mempool_put_bulk(dma_pktmbuf_pool,
+ (void *)pkts_burst, nb_rx);
+
+ nb_enq = rte_ring_enqueue_burst(rx_config->rx_to_tx_ring,
+ (void *)pkts_burst_copy, nb_rx, NULL);
+
+ /* Free any not enqueued packets. */
+ rte_mempool_put_bulk(dma_pktmbuf_pool,
+ (void *)&pkts_burst_copy[nb_enq],
+ nb_rx - nb_enq);
+
+ port_statistics.copy_dropped[rx_config->rxtx_port] +=
+ (nb_rx - nb_enq);
+ }
+}
+/* >8 End of receive packets on one port and enqueue to dmadev or rte_ring. */
+
+/* Transmit packets from dmadev/rte_ring for one port. 8< */
+static void
+dma_tx_port(struct rxtx_port_config *tx_config)
+{
+ uint32_t i, j, nb_dq, nb_tx;
+ struct rte_mbuf *mbufs[MAX_PKT_BURST];
+
+ for (i = 0; i < tx_config->nb_queues; i++) {
+
+ /* Dequeue the mbufs from rx_to_tx_ring. */
+ nb_dq = rte_ring_dequeue_burst(tx_config->rx_to_tx_ring,
+ (void *)mbufs, MAX_PKT_BURST, NULL);
+ if (nb_dq == 0)
+ continue;
+
+ /* Update macs if enabled */
+ if (mac_updating) {
+ for (j = 0; j < nb_dq; j++)
+ update_mac_addrs(mbufs[j],
+ tx_config->rxtx_port);
+ }
+
+ nb_tx = rte_eth_tx_burst(tx_config->rxtx_port, 0,
+ (void *)mbufs, nb_dq);
+
+ port_statistics.tx[tx_config->rxtx_port] += nb_tx;
+
+ /* Free any unsent packets. */
+ if (unlikely(nb_tx < nb_dq))
+ rte_mempool_put_bulk(dma_pktmbuf_pool,
+ (void *)&mbufs[nb_tx], nb_dq - nb_tx);
+ }
+}
+/* >8 End of transmitting packets from dmadev. */
+
+/* Main rx processing loop for dmadev. */
+static void
+rx_main_loop(void)
+{
+ uint16_t i;
+ uint16_t nb_ports = cfg.nb_ports;
+
+ RTE_LOG(INFO, DMA, "Entering main rx loop for copy on lcore %u\n",
+ rte_lcore_id());
+
+ while (!force_quit)
+ for (i = 0; i < nb_ports; i++)
+ dma_rx_port(&cfg.ports[i]);
+}
+
+/* Main tx processing loop for hardware copy. */
+static void
+tx_main_loop(void)
+{
+ uint16_t i;
+ uint16_t nb_ports = cfg.nb_ports;
+
+ RTE_LOG(INFO, DMA, "Entering main tx loop for copy on lcore %u\n",
+ rte_lcore_id());
+
+ while (!force_quit)
+ for (i = 0; i < nb_ports; i++)
+ dma_tx_port(&cfg.ports[i]);
+}
+
+/* Main rx and tx loop if only one worker lcore available */
+static void
+rxtx_main_loop(void)
+{
+ uint16_t i;
+ uint16_t nb_ports = cfg.nb_ports;
+
+ RTE_LOG(INFO, DMA, "Entering main rx and tx loop for copy on"
+ " lcore %u\n", rte_lcore_id());
+
+ while (!force_quit)
+ for (i = 0; i < nb_ports; i++) {
+ dma_rx_port(&cfg.ports[i]);
+ dma_tx_port(&cfg.ports[i]);
+ }
+}
+
+/* Start processing for each lcore. 8< */
+static void start_forwarding_cores(void)
+{
+ uint32_t lcore_id = rte_lcore_id();
+
+ RTE_LOG(INFO, DMA, "Entering %s on lcore %u\n",
+ __func__, rte_lcore_id());
+
+ if (cfg.nb_lcores == 1) {
+ lcore_id = rte_get_next_lcore(lcore_id, true, true);
+ rte_eal_remote_launch((lcore_function_t *)rxtx_main_loop,
+ NULL, lcore_id);
+ } else if (cfg.nb_lcores > 1) {
+ lcore_id = rte_get_next_lcore(lcore_id, true, true);
+ rte_eal_remote_launch((lcore_function_t *)rx_main_loop,
+ NULL, lcore_id);
+
+ lcore_id = rte_get_next_lcore(lcore_id, true, true);
+ rte_eal_remote_launch((lcore_function_t *)tx_main_loop, NULL,
+ lcore_id);
+ }
+}
+/* >8 End of starting to processfor each lcore. */
+
+/* Display usage */
+static void
+dma_usage(const char *prgname)
+{
+ printf("%s [EAL options] -- -p PORTMASK [-q NQ]\n"
+ " -b --dma-batch-size: number of requests per DMA batch\n"
+ " -f --max-frame-size: max frame size\n"
+ " -p --portmask: hexadecimal bitmask of ports to configure\n"
+ " -q NQ: number of RX queues per port (default is 1)\n"
+ " --[no-]mac-updating: Enable or disable MAC addresses updating (enabled by default)\n"
+ " When enabled:\n"
+ " - The source MAC address is replaced by the TX port MAC address\n"
+ " - The destination MAC address is replaced by 02:00:00:00:00:TX_PORT_ID\n"
+ " -c --copy-type CT: type of copy: sw|hw\n"
+ " -s --ring-size RS: size of dmadev descriptor ring for hardware copy mode or rte_ring for software copy mode\n"
+ " -i --stats-interval SI: interval, in seconds, between stats prints (default is 1)\n",
+ prgname);
+}
+
+static int
+dma_parse_portmask(const char *portmask)
+{
+ char *end = NULL;
+ unsigned long pm;
+
+ /* Parse hexadecimal string */
+ pm = strtoul(portmask, &end, 16);
+ if ((portmask[0] == '\0') || (end == NULL) || (*end != '\0'))
+ return 0;
+
+ return pm;
+}
+
+static copy_mode_t
+dma_parse_copy_mode(const char *copy_mode)
+{
+ if (strcmp(copy_mode, COPY_MODE_SW) == 0)
+ return COPY_MODE_SW_NUM;
+ else if (strcmp(copy_mode, COPY_MODE_DMA) == 0)
+ return COPY_MODE_DMA_NUM;
+
+ return COPY_MODE_INVALID_NUM;
+}
+
+/* Parse the argument given in the command line of the application */
+static int
+dma_parse_args(int argc, char **argv, unsigned int nb_ports)
+{
+ static const char short_options[] =
+ "b:" /* dma batch size */
+ "c:" /* copy type (sw|hw) */
+ "f:" /* max frame size */
+ "p:" /* portmask */
+ "q:" /* number of RX queues per port */
+ "s:" /* ring size */
+ "i:" /* interval, in seconds, between stats prints */
+ ;
+
+ static const struct option lgopts[] = {
+ {CMD_LINE_OPT_MAC_UPDATING, no_argument, &mac_updating, 1},
+ {CMD_LINE_OPT_NO_MAC_UPDATING, no_argument, &mac_updating, 0},
+ {CMD_LINE_OPT_PORTMASK, required_argument, NULL, 'p'},
+ {CMD_LINE_OPT_NB_QUEUE, required_argument, NULL, 'q'},
+ {CMD_LINE_OPT_COPY_TYPE, required_argument, NULL, 'c'},
+ {CMD_LINE_OPT_RING_SIZE, required_argument, NULL, 's'},
+ {CMD_LINE_OPT_BATCH_SIZE, required_argument, NULL, 'b'},
+ {CMD_LINE_OPT_FRAME_SIZE, required_argument, NULL, 'f'},
+ {CMD_LINE_OPT_STATS_INTERVAL, required_argument, NULL, 'i'},
+ {NULL, 0, 0, 0}
+ };
+
+ const unsigned int default_port_mask = (1 << nb_ports) - 1;
+ int opt, ret;
+ char **argvopt;
+ int option_index;
+ char *prgname = argv[0];
+
+ dma_enabled_port_mask = default_port_mask;
+ argvopt = argv;
+
+ while ((opt = getopt_long(argc, argvopt, short_options,
+ lgopts, &option_index)) != EOF) {
+
+ switch (opt) {
+ case 'b':
+ dma_batch_sz = atoi(optarg);
+ if (dma_batch_sz > MAX_PKT_BURST) {
+ printf("Invalid dma batch size, %s.\n", optarg);
+ dma_usage(prgname);
+ return -1;
+ }
+ break;
+ case 'f':
+ max_frame_size = atoi(optarg);
+ if (max_frame_size > RTE_ETHER_MAX_JUMBO_FRAME_LEN) {
+ printf("Invalid max frame size, %s.\n", optarg);
+ dma_usage(prgname);
+ return -1;
+ }
+ break;
+
+ /* portmask */
+ case 'p':
+ dma_enabled_port_mask = dma_parse_portmask(optarg);
+ if (dma_enabled_port_mask & ~default_port_mask ||
+ dma_enabled_port_mask <= 0) {
+ printf("Invalid portmask, %s, suggest 0x%x\n",
+ optarg, default_port_mask);
+ dma_usage(prgname);
+ return -1;
+ }
+ break;
+
+ case 'q':
+ nb_queues = atoi(optarg);
+ if (nb_queues == 0 || nb_queues > MAX_RX_QUEUES_COUNT) {
+ printf("Invalid RX queues number %s. Max %u\n",
+ optarg, MAX_RX_QUEUES_COUNT);
+ dma_usage(prgname);
+ return -1;
+ }
+ break;
+
+ case 'c':
+ copy_mode = dma_parse_copy_mode(optarg);
+ if (copy_mode == COPY_MODE_INVALID_NUM) {
+ printf("Invalid copy type. Use: sw, hw\n");
+ dma_usage(prgname);
+ return -1;
+ }
+ break;
+
+ case 's':
+ ring_size = atoi(optarg);
+ if (ring_size == 0) {
+ printf("Invalid ring size, %s.\n", optarg);
+ dma_usage(prgname);
+ return -1;
+ }
+ /* ring_size must be less-than or equal to MBUF_RING_SIZE
+ * to avoid overwriting bufs
+ */
+ if (ring_size > MBUF_RING_SIZE) {
+ printf("Max ring_size is %d, setting ring_size to max",
+ MBUF_RING_SIZE);
+ ring_size = MBUF_RING_SIZE;
+ }
+ break;
+
+ case 'i':
+ stats_interval = atoi(optarg);
+ if (stats_interval == 0) {
+ printf("Invalid stats interval, setting to 1\n");
+ stats_interval = 1; /* set to default */
+ }
+ break;
+
+ /* long options */
+ case 0:
+ break;
+
+ default:
+ dma_usage(prgname);
+ return -1;
+ }
+ }
+
+ printf("MAC updating %s\n", mac_updating ? "enabled" : "disabled");
+ if (optind >= 0)
+ argv[optind - 1] = prgname;
+
+ ret = optind - 1;
+ optind = 1; /* reset getopt lib */
+ return ret;
+}
+
+/* check link status, return true if at least one port is up */
+static int
+check_link_status(uint32_t port_mask)
+{
+ uint16_t portid;
+ struct rte_eth_link link;
+ int ret, link_status = 0;
+ char link_status_text[RTE_ETH_LINK_MAX_STR_LEN];
+
+ printf("\nChecking link status\n");
+ RTE_ETH_FOREACH_DEV(portid) {
+ if ((port_mask & (1 << portid)) == 0)
+ continue;
+
+ memset(&link, 0, sizeof(link));
+ ret = rte_eth_link_get(portid, &link);
+ if (ret < 0) {
+ printf("Port %u link get failed: err=%d\n",
+ portid, ret);
+ continue;
+ }
+
+ /* Print link status */
+ rte_eth_link_to_str(link_status_text,
+ sizeof(link_status_text), &link);
+ printf("Port %d %s\n", portid, link_status_text);
+
+ if (link.link_status)
+ link_status = 1;
+ }
+ return link_status;
+}
+
+/* Configuration of device. 8< */
+static void
+configure_dmadev_queue(uint32_t dev_id)
+{
+ struct rte_dma_info info;
+ struct rte_dma_conf dev_config = { .nb_vchans = 1 };
+ struct rte_dma_vchan_conf qconf = {
+ .direction = RTE_DMA_DIR_MEM_TO_MEM,
+ .nb_desc = ring_size
+ };
+ uint16_t vchan = 0;
+
+ if (rte_dma_configure(dev_id, &dev_config) != 0)
+ rte_exit(EXIT_FAILURE, "Error with rte_dma_configure()\n");
+
+ if (rte_dma_vchan_setup(dev_id, vchan, &qconf) != 0) {
+ printf("Error with queue configuration\n");
+ rte_panic();
+ }
+ rte_dma_info_get(dev_id, &info);
+ if (info.nb_vchans != 1) {
+ printf("Error, no configured queues reported on device id %u\n", dev_id);
+ rte_panic();
+ }
+ if (rte_dma_start(dev_id) != 0)
+ rte_exit(EXIT_FAILURE, "Error with rte_dma_start()\n");
+}
+/* >8 End of configuration of device. */
+
+/* Using dmadev API functions. 8< */
+static void
+assign_dmadevs(void)
+{
+ uint16_t nb_dmadev = 0;
+ int16_t dev_id = rte_dma_next_dev(0);
+ uint32_t i, j;
+
+ for (i = 0; i < cfg.nb_ports; i++) {
+ for (j = 0; j < cfg.ports[i].nb_queues; j++) {
+ if (dev_id == -1)
+ goto end;
+
+ cfg.ports[i].dmadev_ids[j] = dev_id;
+ configure_dmadev_queue(cfg.ports[i].dmadev_ids[j]);
+ dev_id = rte_dma_next_dev(dev_id + 1);
+ ++nb_dmadev;
+ }
+ }
+end:
+ if (nb_dmadev < cfg.nb_ports * cfg.ports[0].nb_queues)
+ rte_exit(EXIT_FAILURE,
+ "Not enough dmadevs (%u) for all queues (%u).\n",
+ nb_dmadev, cfg.nb_ports * cfg.ports[0].nb_queues);
+ RTE_LOG(INFO, DMA, "Number of used dmadevs: %u.\n", nb_dmadev);
+}
+/* >8 End of using dmadev API functions. */
+
+/* Assign ring structures for packet exchanging. 8< */
+static void
+assign_rings(void)
+{
+ uint32_t i;
+
+ for (i = 0; i < cfg.nb_ports; i++) {
+ char ring_name[RTE_RING_NAMESIZE];
+
+ snprintf(ring_name, sizeof(ring_name), "rx_to_tx_ring_%u", i);
+ /* Create ring for inter core communication */
+ cfg.ports[i].rx_to_tx_ring = rte_ring_create(
+ ring_name, ring_size,
+ rte_socket_id(), RING_F_SP_ENQ | RING_F_SC_DEQ);
+
+ if (cfg.ports[i].rx_to_tx_ring == NULL)
+ rte_exit(EXIT_FAILURE, "Ring create failed: %s\n",
+ rte_strerror(rte_errno));
+ }
+}
+/* >8 End of assigning ring structures for packet exchanging. */
+
+/*
+ * Initializes a given port using global settings and with the RX buffers
+ * coming from the mbuf_pool passed as a parameter.
+ */
+static inline void
+port_init(uint16_t portid, struct rte_mempool *mbuf_pool, uint16_t nb_queues)
+{
+ /* Configuring port to use RSS for multiple RX queues. 8< */
+ static const struct rte_eth_conf port_conf = {
+ .rxmode = {
+ .mq_mode = RTE_ETH_MQ_RX_RSS,
+ },
+ .rx_adv_conf = {
+ .rss_conf = {
+ .rss_key = NULL,
+ .rss_hf = RTE_ETH_RSS_PROTO_MASK,
+ }
+ }
+ };
+ /* >8 End of configuring port to use RSS for multiple RX queues. */
+
+ struct rte_eth_rxconf rxq_conf;
+ struct rte_eth_txconf txq_conf;
+ struct rte_eth_conf local_port_conf = port_conf;
+ struct rte_eth_dev_info dev_info;
+ int ret, i;
+
+ if (max_frame_size > local_port_conf.rxmode.mtu)
+ local_port_conf.rxmode.mtu = max_frame_size;
+
+ /* Skip ports that are not enabled */
+ if ((dma_enabled_port_mask & (1 << portid)) == 0) {
+ printf("Skipping disabled port %u\n", portid);
+ return;
+ }
+
+ /* Init port */
+ printf("Initializing port %u... ", portid);
+ fflush(stdout);
+ ret = rte_eth_dev_info_get(portid, &dev_info);
+ if (ret < 0)
+ rte_exit(EXIT_FAILURE, "Cannot get device info: %s, port=%u\n",
+ rte_strerror(-ret), portid);
+
+ local_port_conf.rx_adv_conf.rss_conf.rss_hf &=
+ dev_info.flow_type_rss_offloads;
+ ret = rte_eth_dev_configure(portid, nb_queues, 1, &local_port_conf);
+ if (ret < 0)
+ rte_exit(EXIT_FAILURE, "Cannot configure device:"
+ " err=%d, port=%u\n", ret, portid);
+
+ ret = rte_eth_dev_adjust_nb_rx_tx_desc(portid, &nb_rxd,
+ &nb_txd);
+ if (ret < 0)
+ rte_exit(EXIT_FAILURE,
+ "Cannot adjust number of descriptors: err=%d, port=%u\n",
+ ret, portid);
+
+ rte_eth_macaddr_get(portid, &dma_ports_eth_addr[portid]);
+
+ /* Init RX queues */
+ rxq_conf = dev_info.default_rxconf;
+ rxq_conf.offloads = local_port_conf.rxmode.offloads;
+ for (i = 0; i < nb_queues; i++) {
+ ret = rte_eth_rx_queue_setup(portid, i, nb_rxd,
+ rte_eth_dev_socket_id(portid), &rxq_conf,
+ mbuf_pool);
+ if (ret < 0)
+ rte_exit(EXIT_FAILURE,
+ "rte_eth_rx_queue_setup:err=%d,port=%u, queue_id=%u\n",
+ ret, portid, i);
+ }
+
+ /* Init one TX queue on each port */
+ txq_conf = dev_info.default_txconf;
+ txq_conf.offloads = local_port_conf.txmode.offloads;
+ ret = rte_eth_tx_queue_setup(portid, 0, nb_txd,
+ rte_eth_dev_socket_id(portid),
+ &txq_conf);
+ if (ret < 0)
+ rte_exit(EXIT_FAILURE,
+ "rte_eth_tx_queue_setup:err=%d,port=%u\n",
+ ret, portid);
+
+ /* Initialize TX buffers */
+ tx_buffer[portid] = rte_zmalloc_socket("tx_buffer",
+ RTE_ETH_TX_BUFFER_SIZE(MAX_PKT_BURST), 0,
+ rte_eth_dev_socket_id(portid));
+ if (tx_buffer[portid] == NULL)
+ rte_exit(EXIT_FAILURE,
+ "Cannot allocate buffer for tx on port %u\n",
+ portid);
+
+ rte_eth_tx_buffer_init(tx_buffer[portid], MAX_PKT_BURST);
+
+ ret = rte_eth_tx_buffer_set_err_callback(tx_buffer[portid],
+ rte_eth_tx_buffer_count_callback,
+ &port_statistics.tx_dropped[portid]);
+ if (ret < 0)
+ rte_exit(EXIT_FAILURE,
+ "Cannot set error callback for tx buffer on port %u\n",
+ portid);
+
+ /* Start device. 8< */
+ ret = rte_eth_dev_start(portid);
+ if (ret < 0)
+ rte_exit(EXIT_FAILURE,
+ "rte_eth_dev_start:err=%d, port=%u\n",
+ ret, portid);
+ /* >8 End of starting device. */
+
+ /* RX port is set in promiscuous mode. 8< */
+ rte_eth_promiscuous_enable(portid);
+ /* >8 End of RX port is set in promiscuous mode. */
+
+ printf("Port %u, MAC address: " RTE_ETHER_ADDR_PRT_FMT "\n\n",
+ portid,
+ RTE_ETHER_ADDR_BYTES(&dma_ports_eth_addr[portid]));
+
+ cfg.ports[cfg.nb_ports].rxtx_port = portid;
+ cfg.ports[cfg.nb_ports++].nb_queues = nb_queues;
+}
+
+/* Get a device dump for each device being used by the application */
+static void
+dmadev_dump(void)
+{
+ uint32_t i, j;
+
+ if (copy_mode != COPY_MODE_DMA_NUM)
+ return;
+
+ for (i = 0; i < cfg.nb_ports; i++)
+ for (j = 0; j < cfg.ports[i].nb_queues; j++)
+ rte_dma_dump(cfg.ports[i].dmadev_ids[j], stdout);
+}
+
+static void
+signal_handler(int signum)
+{
+ if (signum == SIGINT || signum == SIGTERM) {
+ printf("\n\nSignal %d received, preparing to exit...\n",
+ signum);
+ force_quit = true;
+ } else if (signum == SIGUSR1) {
+ dmadev_dump();
+ }
+}
+
+int
+main(int argc, char **argv)
+{
+ int ret;
+ uint16_t nb_ports, portid;
+ uint32_t i;
+ unsigned int nb_mbufs;
+ size_t sz;
+
+ /* Init EAL. 8< */
+ ret = rte_eal_init(argc, argv);
+ if (ret < 0)
+ rte_exit(EXIT_FAILURE, "Invalid EAL arguments\n");
+ /* >8 End of init EAL. */
+ argc -= ret;
+ argv += ret;
+
+ force_quit = false;
+ signal(SIGINT, signal_handler);
+ signal(SIGTERM, signal_handler);
+ signal(SIGUSR1, signal_handler);
+
+ nb_ports = rte_eth_dev_count_avail();
+ if (nb_ports == 0)
+ rte_exit(EXIT_FAILURE, "No Ethernet ports - bye\n");
+
+ /* Parse application arguments (after the EAL ones) */
+ ret = dma_parse_args(argc, argv, nb_ports);
+ if (ret < 0)
+ rte_exit(EXIT_FAILURE, "Invalid DMA arguments\n");
+
+ /* Allocates mempool to hold the mbufs. 8< */
+ nb_mbufs = RTE_MAX(nb_ports * (nb_queues * (nb_rxd + nb_txd +
+ 4 * MAX_PKT_BURST + ring_size) + ring_size +
+ rte_lcore_count() * MEMPOOL_CACHE_SIZE),
+ MIN_POOL_SIZE);
+
+ /* Create the mbuf pool */
+ sz = max_frame_size + RTE_PKTMBUF_HEADROOM;
+ sz = RTE_MAX(sz, (size_t)RTE_MBUF_DEFAULT_BUF_SIZE);
+ dma_pktmbuf_pool = rte_pktmbuf_pool_create("mbuf_pool", nb_mbufs,
+ MEMPOOL_CACHE_SIZE, 0, sz, rte_socket_id());
+ if (dma_pktmbuf_pool == NULL)
+ rte_exit(EXIT_FAILURE, "Cannot init mbuf pool\n");
+ /* >8 End of allocates mempool to hold the mbufs. */
+
+ /* Initialize each port. 8< */
+ cfg.nb_ports = 0;
+ RTE_ETH_FOREACH_DEV(portid)
+ port_init(portid, dma_pktmbuf_pool, nb_queues);
+ /* >8 End of initializing each port. */
+
+ /* Initialize port xstats */
+ memset(&port_statistics, 0, sizeof(port_statistics));
+
+ /* Assigning each port resources. 8< */
+ while (!check_link_status(dma_enabled_port_mask) && !force_quit)
+ sleep(1);
+
+ /* Check if there is enough lcores for all ports. */
+ cfg.nb_lcores = rte_lcore_count() - 1;
+ if (cfg.nb_lcores < 1)
+ rte_exit(EXIT_FAILURE,
+ "There should be at least one worker lcore.\n");
+
+ if (copy_mode == COPY_MODE_DMA_NUM)
+ assign_dmadevs();
+
+ assign_rings();
+ /* >8 End of assigning each port resources. */
+
+ start_forwarding_cores();
+ /* main core prints stats while other cores forward */
+ print_stats(argv[0]);
+
+ /* force_quit is true when we get here */
+ rte_eal_mp_wait_lcore();
+
+ uint32_t j;
+ for (i = 0; i < cfg.nb_ports; i++) {
+ printf("Closing port %d\n", cfg.ports[i].rxtx_port);
+ ret = rte_eth_dev_stop(cfg.ports[i].rxtx_port);
+ if (ret != 0)
+ RTE_LOG(ERR, DMA, "rte_eth_dev_stop: err=%s, port=%u\n",
+ rte_strerror(-ret), cfg.ports[i].rxtx_port);
+
+ rte_eth_dev_close(cfg.ports[i].rxtx_port);
+ if (copy_mode == COPY_MODE_DMA_NUM) {
+ for (j = 0; j < cfg.ports[i].nb_queues; j++) {
+ printf("Stopping dmadev %d\n",
+ cfg.ports[i].dmadev_ids[j]);
+ rte_dma_stop(cfg.ports[i].dmadev_ids[j]);
+ }
+ } else /* copy_mode == COPY_MODE_SW_NUM */
+ rte_ring_free(cfg.ports[i].rx_to_tx_ring);
+ }
+
+ /* clean up the EAL */
+ rte_eal_cleanup();
+
+ printf("Bye...\n");
+ return 0;
+}
--- /dev/null
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright(c) 2019-2021 Intel Corporation
+
+# 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'
+
+allow_experimental_apis = true
+
+deps += ['dmadev']
+
+sources = files(
+ 'dmafwd.c',
+)
+++ /dev/null
-# SPDX-License-Identifier: BSD-3-Clause
-# Copyright(c) 2019 Intel Corporation
-
-# binary name
-APP = ioatfwd
-
-# all source are stored in SRCS-y
-SRCS-y := ioatfwd.c
-
-PKGCONF ?= pkg-config
-
-# Build using pkg-config variables if possible
-ifneq ($(shell $(PKGCONF) --exists libdpdk && echo 0),0)
-$(error "no installation of DPDK found")
-endif
-
-all: shared
-.PHONY: shared static
-shared: build/$(APP)-shared
- ln -sf $(APP)-shared build/$(APP)
-static: build/$(APP)-static
- ln -sf $(APP)-static build/$(APP)
-
-PC_FILE := $(shell $(PKGCONF) --path libdpdk 2>/dev/null)
-CFLAGS += -O3 $(shell $(PKGCONF) --cflags libdpdk)
-LDFLAGS_SHARED = $(shell $(PKGCONF) --libs libdpdk)
-LDFLAGS_STATIC = $(shell $(PKGCONF) --static --libs libdpdk)
-
-ifeq ($(MAKECMDGOALS),static)
-# check for broken pkg-config
-ifeq ($(shell echo $(LDFLAGS_STATIC) | grep 'whole-archive.*l:lib.*no-whole-archive'),)
-$(warning "pkg-config output list does not contain drivers between 'whole-archive'/'no-whole-archive' flags.")
-$(error "Cannot generate statically-linked binaries with this version of pkg-config")
-endif
-endif
-
-CFLAGS += -DALLOW_EXPERIMENTAL_API
-
-build/$(APP)-shared: $(SRCS-y) Makefile $(PC_FILE) | build
- $(CC) $(CFLAGS) $(SRCS-y) -o $@ $(LDFLAGS) $(LDFLAGS_SHARED)
-
-build/$(APP)-static: $(SRCS-y) Makefile $(PC_FILE) | build
- $(CC) $(CFLAGS) $(SRCS-y) -o $@ $(LDFLAGS) $(LDFLAGS_STATIC)
-
-build:
- @mkdir -p $@
-
-.PHONY: clean
-clean:
- rm -f build/$(APP) build/$(APP)-static build/$(APP)-shared
- test -d build && rmdir -p build || true
+++ /dev/null
-/* SPDX-License-Identifier: BSD-3-Clause
- * Copyright(c) 2019-2021 Intel Corporation
- */
-
-#include <stdint.h>
-#include <getopt.h>
-#include <signal.h>
-#include <stdbool.h>
-#include <unistd.h>
-
-#include <rte_malloc.h>
-#include <rte_ethdev.h>
-#include <rte_dmadev.h>
-
-/* size of ring used for software copying between rx and tx. */
-#define RTE_LOGTYPE_DMA RTE_LOGTYPE_USER1
-#define MAX_PKT_BURST 32
-#define MEMPOOL_CACHE_SIZE 512
-#define MIN_POOL_SIZE 65536U
-#define CMD_LINE_OPT_MAC_UPDATING "mac-updating"
-#define CMD_LINE_OPT_NO_MAC_UPDATING "no-mac-updating"
-#define CMD_LINE_OPT_PORTMASK "portmask"
-#define CMD_LINE_OPT_NB_QUEUE "nb-queue"
-#define CMD_LINE_OPT_COPY_TYPE "copy-type"
-#define CMD_LINE_OPT_RING_SIZE "ring-size"
-#define CMD_LINE_OPT_BATCH_SIZE "dma-batch-size"
-#define CMD_LINE_OPT_FRAME_SIZE "max-frame-size"
-#define CMD_LINE_OPT_STATS_INTERVAL "stats-interval"
-
-/* configurable number of RX/TX ring descriptors */
-#define RX_DEFAULT_RINGSIZE 1024
-#define TX_DEFAULT_RINGSIZE 1024
-
-/* max number of RX queues per port */
-#define MAX_RX_QUEUES_COUNT 8
-
-struct rxtx_port_config {
- /* common config */
- uint16_t rxtx_port;
- uint16_t nb_queues;
- /* for software copy mode */
- struct rte_ring *rx_to_tx_ring;
- /* for dmadev HW copy mode */
- uint16_t dmadev_ids[MAX_RX_QUEUES_COUNT];
-};
-
-/* Configuring ports and number of assigned lcores in struct. 8< */
-struct rxtx_transmission_config {
- struct rxtx_port_config ports[RTE_MAX_ETHPORTS];
- uint16_t nb_ports;
- uint16_t nb_lcores;
-};
-/* >8 End of configuration of ports and number of assigned lcores. */
-
-/* per-port statistics struct */
-struct dma_port_statistics {
- uint64_t rx[RTE_MAX_ETHPORTS];
- uint64_t tx[RTE_MAX_ETHPORTS];
- uint64_t tx_dropped[RTE_MAX_ETHPORTS];
- uint64_t copy_dropped[RTE_MAX_ETHPORTS];
-};
-struct dma_port_statistics port_statistics;
-struct total_statistics {
- uint64_t total_packets_dropped;
- uint64_t total_packets_tx;
- uint64_t total_packets_rx;
- uint64_t total_submitted;
- uint64_t total_completed;
- uint64_t total_failed;
-};
-
-typedef enum copy_mode_t {
-#define COPY_MODE_SW "sw"
- COPY_MODE_SW_NUM,
-#define COPY_MODE_DMA "hw"
- COPY_MODE_DMA_NUM,
- COPY_MODE_INVALID_NUM,
- COPY_MODE_SIZE_NUM = COPY_MODE_INVALID_NUM
-} copy_mode_t;
-
-/* mask of enabled ports */
-static uint32_t dma_enabled_port_mask;
-
-/* number of RX queues per port */
-static uint16_t nb_queues = 1;
-
-/* MAC updating enabled by default. */
-static int mac_updating = 1;
-
-/* hardare copy mode enabled by default. */
-static copy_mode_t copy_mode = COPY_MODE_DMA_NUM;
-
-/* size of descriptor ring for hardware copy mode or
- * rte_ring for software copy mode
- */
-static unsigned short ring_size = 2048;
-
-/* interval, in seconds, between stats prints */
-static unsigned short stats_interval = 1;
-/* global mbuf arrays for tracking DMA bufs */
-#define MBUF_RING_SIZE 2048
-#define MBUF_RING_MASK (MBUF_RING_SIZE - 1)
-struct dma_bufs {
- struct rte_mbuf *bufs[MBUF_RING_SIZE];
- struct rte_mbuf *copies[MBUF_RING_SIZE];
- uint16_t sent;
-};
-static struct dma_bufs dma_bufs[RTE_DMADEV_DEFAULT_MAX];
-
-/* global transmission config */
-struct rxtx_transmission_config cfg;
-
-/* configurable number of RX/TX ring descriptors */
-static uint16_t nb_rxd = RX_DEFAULT_RINGSIZE;
-static uint16_t nb_txd = TX_DEFAULT_RINGSIZE;
-
-static volatile bool force_quit;
-
-static uint32_t dma_batch_sz = MAX_PKT_BURST;
-static uint32_t max_frame_size = RTE_ETHER_MAX_LEN;
-
-/* ethernet addresses of ports */
-static struct rte_ether_addr dma_ports_eth_addr[RTE_MAX_ETHPORTS];
-
-static struct rte_eth_dev_tx_buffer *tx_buffer[RTE_MAX_ETHPORTS];
-struct rte_mempool *dma_pktmbuf_pool;
-
-/* Print out statistics for one port. */
-static void
-print_port_stats(uint16_t port_id)
-{
- printf("\nStatistics for port %u ------------------------------"
- "\nPackets sent: %34"PRIu64
- "\nPackets received: %30"PRIu64
- "\nPackets dropped on tx: %25"PRIu64
- "\nPackets dropped on copy: %23"PRIu64,
- port_id,
- port_statistics.tx[port_id],
- port_statistics.rx[port_id],
- port_statistics.tx_dropped[port_id],
- port_statistics.copy_dropped[port_id]);
-}
-
-/* Print out statistics for one dmadev device. */
-static void
-print_dmadev_stats(uint32_t dev_id, struct rte_dma_stats stats)
-{
- printf("\nDMA channel %u", dev_id);
- printf("\n\t Total submitted ops: %"PRIu64"", stats.submitted);
- printf("\n\t Total completed ops: %"PRIu64"", stats.completed);
- printf("\n\t Total failed ops: %"PRIu64"", stats.errors);
-}
-
-static void
-print_total_stats(struct total_statistics *ts)
-{
- printf("\nAggregate statistics ==============================="
- "\nTotal packets Tx: %22"PRIu64" [pkt/s]"
- "\nTotal packets Rx: %22"PRIu64" [pkt/s]"
- "\nTotal packets dropped: %17"PRIu64" [pkt/s]",
- ts->total_packets_tx / stats_interval,
- ts->total_packets_rx / stats_interval,
- ts->total_packets_dropped / stats_interval);
-
- if (copy_mode == COPY_MODE_DMA_NUM) {
- printf("\nTotal submitted ops: %19"PRIu64" [ops/s]"
- "\nTotal completed ops: %19"PRIu64" [ops/s]"
- "\nTotal failed ops: %22"PRIu64" [ops/s]",
- ts->total_submitted / stats_interval,
- ts->total_completed / stats_interval,
- ts->total_failed / stats_interval);
- }
-
- printf("\n====================================================\n");
-}
-
-/* Print out statistics on packets dropped. */
-static void
-print_stats(char *prgname)
-{
- struct total_statistics ts, delta_ts;
- struct rte_dma_stats stats = {0};
- uint32_t i, port_id, dev_id;
- char status_string[255]; /* to print at the top of the output */
- int status_strlen;
-
- const char clr[] = { 27, '[', '2', 'J', '\0' };
- const char topLeft[] = { 27, '[', '1', ';', '1', 'H', '\0' };
-
- status_strlen = snprintf(status_string, sizeof(status_string),
- "%s, ", prgname);
- status_strlen += snprintf(status_string + status_strlen,
- sizeof(status_string) - status_strlen,
- "Worker Threads = %d, ",
- rte_lcore_count() > 2 ? 2 : 1);
- status_strlen += snprintf(status_string + status_strlen,
- sizeof(status_string) - status_strlen,
- "Copy Mode = %s,\n", copy_mode == COPY_MODE_SW_NUM ?
- COPY_MODE_SW : COPY_MODE_DMA);
- status_strlen += snprintf(status_string + status_strlen,
- sizeof(status_string) - status_strlen,
- "Updating MAC = %s, ", mac_updating ?
- "enabled" : "disabled");
- status_strlen += snprintf(status_string + status_strlen,
- sizeof(status_string) - status_strlen,
- "Rx Queues = %d, ", nb_queues);
- status_strlen += snprintf(status_string + status_strlen,
- sizeof(status_string) - status_strlen,
- "Ring Size = %d", ring_size);
-
- memset(&ts, 0, sizeof(struct total_statistics));
-
- while (!force_quit) {
- /* Sleep for "stats_interval" seconds each round - init sleep allows reading
- * messages from app startup.
- */
- sleep(stats_interval);
-
- /* Clear screen and move to top left */
- printf("%s%s", clr, topLeft);
-
- memset(&delta_ts, 0, sizeof(struct total_statistics));
-
- printf("%s\n", status_string);
-
- for (i = 0; i < cfg.nb_ports; i++) {
- port_id = cfg.ports[i].rxtx_port;
- print_port_stats(port_id);
-
- delta_ts.total_packets_dropped +=
- port_statistics.tx_dropped[port_id]
- + port_statistics.copy_dropped[port_id];
- delta_ts.total_packets_tx +=
- port_statistics.tx[port_id];
- delta_ts.total_packets_rx +=
- port_statistics.rx[port_id];
-
- if (copy_mode == COPY_MODE_DMA_NUM) {
- uint32_t j;
-
- for (j = 0; j < cfg.ports[i].nb_queues; j++) {
- dev_id = cfg.ports[i].dmadev_ids[j];
- rte_dma_stats_get(dev_id, 0, &stats);
- print_dmadev_stats(dev_id, stats);
-
- delta_ts.total_submitted += stats.submitted;
- delta_ts.total_completed += stats.completed;
- delta_ts.total_failed += stats.errors;
- }
- }
- }
-
- delta_ts.total_packets_tx -= ts.total_packets_tx;
- delta_ts.total_packets_rx -= ts.total_packets_rx;
- delta_ts.total_packets_dropped -= ts.total_packets_dropped;
- delta_ts.total_submitted -= ts.total_submitted;
- delta_ts.total_completed -= ts.total_completed;
- delta_ts.total_failed -= ts.total_failed;
-
- printf("\n");
- print_total_stats(&delta_ts);
-
- fflush(stdout);
-
- ts.total_packets_tx += delta_ts.total_packets_tx;
- ts.total_packets_rx += delta_ts.total_packets_rx;
- ts.total_packets_dropped += delta_ts.total_packets_dropped;
- ts.total_submitted += delta_ts.total_submitted;
- ts.total_completed += delta_ts.total_completed;
- ts.total_failed += delta_ts.total_failed;
- }
-}
-
-static void
-update_mac_addrs(struct rte_mbuf *m, uint32_t dest_portid)
-{
- struct rte_ether_hdr *eth;
- void *tmp;
-
- eth = rte_pktmbuf_mtod(m, struct rte_ether_hdr *);
-
- /* 02:00:00:00:00:xx - overwriting 2 bytes of source address but
- * it's acceptable cause it gets overwritten by rte_ether_addr_copy
- */
- tmp = ð->dst_addr.addr_bytes[0];
- *((uint64_t *)tmp) = 0x000000000002 + ((uint64_t)dest_portid << 40);
-
- /* src addr */
- rte_ether_addr_copy(&dma_ports_eth_addr[dest_portid], ð->src_addr);
-}
-
-/* Perform packet copy there is a user-defined function. 8< */
-static inline void
-pktmbuf_metadata_copy(const struct rte_mbuf *src, struct rte_mbuf *dst)
-{
- dst->data_off = src->data_off;
- memcpy(&dst->rx_descriptor_fields1, &src->rx_descriptor_fields1,
- offsetof(struct rte_mbuf, buf_len) -
- offsetof(struct rte_mbuf, rx_descriptor_fields1));
-}
-
-/* Copy packet data */
-static inline void
-pktmbuf_sw_copy(struct rte_mbuf *src, struct rte_mbuf *dst)
-{
- rte_memcpy(rte_pktmbuf_mtod(dst, char *),
- rte_pktmbuf_mtod(src, char *), src->data_len);
-}
-/* >8 End of perform packet copy there is a user-defined function. */
-
-static uint32_t
-dma_enqueue_packets(struct rte_mbuf *pkts[], struct rte_mbuf *pkts_copy[],
- uint32_t nb_rx, uint16_t dev_id)
-{
- struct dma_bufs *dma = &dma_bufs[dev_id];
- int ret;
- uint32_t i;
-
- for (i = 0; i < nb_rx; i++) {
- /* Perform data copy */
- ret = rte_dma_copy(dev_id, 0,
- rte_pktmbuf_iova(pkts[i]),
- rte_pktmbuf_iova(pkts_copy[i]),
- rte_pktmbuf_data_len(pkts[i]), 0);
-
- if (ret < 0)
- break;
-
- dma->bufs[ret & MBUF_RING_MASK] = pkts[i];
- dma->copies[ret & MBUF_RING_MASK] = pkts_copy[i];
- }
-
- ret = i;
- return ret;
-}
-
-static inline uint32_t
-dma_enqueue(struct rte_mbuf *pkts[], struct rte_mbuf *pkts_copy[],
- uint32_t num, uint32_t step, uint16_t dev_id)
-{
- uint32_t i, k, m, n;
-
- k = 0;
- for (i = 0; i < num; i += m) {
-
- m = RTE_MIN(step, num - i);
- n = dma_enqueue_packets(pkts + i, pkts_copy + i, m, dev_id);
- k += n;
- if (n > 0)
- rte_dma_submit(dev_id, 0);
-
- /* don't try to enqueue more if HW queue is full */
- if (n != m)
- break;
- }
-
- return k;
-}
-
-static inline uint32_t
-dma_dequeue(struct rte_mbuf *src[], struct rte_mbuf *dst[], uint32_t num,
- uint16_t dev_id)
-{
- struct dma_bufs *dma = &dma_bufs[dev_id];
- uint16_t nb_dq, filled;
- /* Dequeue the mbufs from DMA device. Since all memory
- * is DPDK pinned memory and therefore all addresses should
- * be valid, we don't check for copy errors
- */
- nb_dq = rte_dma_completed(dev_id, 0, num, NULL, NULL);
-
- /* Return early if no work to do */
- if (unlikely(nb_dq == 0))
- return nb_dq;
-
- /* Populate pkts_copy with the copies bufs from dma->copies for tx */
- for (filled = 0; filled < nb_dq; filled++) {
- src[filled] = dma->bufs[(dma->sent + filled) & MBUF_RING_MASK];
- dst[filled] = dma->copies[(dma->sent + filled) & MBUF_RING_MASK];
- }
- dma->sent += nb_dq;
-
- return filled;
-
-}
-
-/* Receive packets on one port and enqueue to dmadev or rte_ring. 8< */
-static void
-dma_rx_port(struct rxtx_port_config *rx_config)
-{
- int32_t ret;
- uint32_t nb_rx, nb_enq, i, j;
- struct rte_mbuf *pkts_burst[MAX_PKT_BURST];
- struct rte_mbuf *pkts_burst_copy[MAX_PKT_BURST];
-
- for (i = 0; i < rx_config->nb_queues; i++) {
-
- nb_rx = rte_eth_rx_burst(rx_config->rxtx_port, i,
- pkts_burst, MAX_PKT_BURST);
-
- if (nb_rx == 0)
- continue;
-
- port_statistics.rx[rx_config->rxtx_port] += nb_rx;
-
- ret = rte_mempool_get_bulk(dma_pktmbuf_pool,
- (void *)pkts_burst_copy, nb_rx);
-
- if (unlikely(ret < 0))
- rte_exit(EXIT_FAILURE,
- "Unable to allocate memory.\n");
-
- for (j = 0; j < nb_rx; j++)
- pktmbuf_metadata_copy(pkts_burst[j],
- pkts_burst_copy[j]);
-
- if (copy_mode == COPY_MODE_DMA_NUM) {
- /* enqueue packets for hardware copy */
- nb_enq = dma_enqueue(pkts_burst, pkts_burst_copy,
- nb_rx, dma_batch_sz, rx_config->dmadev_ids[i]);
-
- /* free any not enqueued packets. */
- rte_mempool_put_bulk(dma_pktmbuf_pool,
- (void *)&pkts_burst[nb_enq],
- nb_rx - nb_enq);
- rte_mempool_put_bulk(dma_pktmbuf_pool,
- (void *)&pkts_burst_copy[nb_enq],
- nb_rx - nb_enq);
-
- port_statistics.copy_dropped[rx_config->rxtx_port] +=
- (nb_rx - nb_enq);
-
- /* get completed copies */
- nb_rx = dma_dequeue(pkts_burst, pkts_burst_copy,
- MAX_PKT_BURST, rx_config->dmadev_ids[i]);
- } else {
- /* Perform packet software copy, free source packets */
- for (j = 0; j < nb_rx; j++)
- pktmbuf_sw_copy(pkts_burst[j],
- pkts_burst_copy[j]);
- }
-
- rte_mempool_put_bulk(dma_pktmbuf_pool,
- (void *)pkts_burst, nb_rx);
-
- nb_enq = rte_ring_enqueue_burst(rx_config->rx_to_tx_ring,
- (void *)pkts_burst_copy, nb_rx, NULL);
-
- /* Free any not enqueued packets. */
- rte_mempool_put_bulk(dma_pktmbuf_pool,
- (void *)&pkts_burst_copy[nb_enq],
- nb_rx - nb_enq);
-
- port_statistics.copy_dropped[rx_config->rxtx_port] +=
- (nb_rx - nb_enq);
- }
-}
-/* >8 End of receive packets on one port and enqueue to dmadev or rte_ring. */
-
-/* Transmit packets from dmadev/rte_ring for one port. 8< */
-static void
-dma_tx_port(struct rxtx_port_config *tx_config)
-{
- uint32_t i, j, nb_dq, nb_tx;
- struct rte_mbuf *mbufs[MAX_PKT_BURST];
-
- for (i = 0; i < tx_config->nb_queues; i++) {
-
- /* Dequeue the mbufs from rx_to_tx_ring. */
- nb_dq = rte_ring_dequeue_burst(tx_config->rx_to_tx_ring,
- (void *)mbufs, MAX_PKT_BURST, NULL);
- if (nb_dq == 0)
- continue;
-
- /* Update macs if enabled */
- if (mac_updating) {
- for (j = 0; j < nb_dq; j++)
- update_mac_addrs(mbufs[j],
- tx_config->rxtx_port);
- }
-
- nb_tx = rte_eth_tx_burst(tx_config->rxtx_port, 0,
- (void *)mbufs, nb_dq);
-
- port_statistics.tx[tx_config->rxtx_port] += nb_tx;
-
- /* Free any unsent packets. */
- if (unlikely(nb_tx < nb_dq))
- rte_mempool_put_bulk(dma_pktmbuf_pool,
- (void *)&mbufs[nb_tx], nb_dq - nb_tx);
- }
-}
-/* >8 End of transmitting packets from dmadev. */
-
-/* Main rx processing loop for dmadev. */
-static void
-rx_main_loop(void)
-{
- uint16_t i;
- uint16_t nb_ports = cfg.nb_ports;
-
- RTE_LOG(INFO, DMA, "Entering main rx loop for copy on lcore %u\n",
- rte_lcore_id());
-
- while (!force_quit)
- for (i = 0; i < nb_ports; i++)
- dma_rx_port(&cfg.ports[i]);
-}
-
-/* Main tx processing loop for hardware copy. */
-static void
-tx_main_loop(void)
-{
- uint16_t i;
- uint16_t nb_ports = cfg.nb_ports;
-
- RTE_LOG(INFO, DMA, "Entering main tx loop for copy on lcore %u\n",
- rte_lcore_id());
-
- while (!force_quit)
- for (i = 0; i < nb_ports; i++)
- dma_tx_port(&cfg.ports[i]);
-}
-
-/* Main rx and tx loop if only one worker lcore available */
-static void
-rxtx_main_loop(void)
-{
- uint16_t i;
- uint16_t nb_ports = cfg.nb_ports;
-
- RTE_LOG(INFO, DMA, "Entering main rx and tx loop for copy on"
- " lcore %u\n", rte_lcore_id());
-
- while (!force_quit)
- for (i = 0; i < nb_ports; i++) {
- dma_rx_port(&cfg.ports[i]);
- dma_tx_port(&cfg.ports[i]);
- }
-}
-
-/* Start processing for each lcore. 8< */
-static void start_forwarding_cores(void)
-{
- uint32_t lcore_id = rte_lcore_id();
-
- RTE_LOG(INFO, DMA, "Entering %s on lcore %u\n",
- __func__, rte_lcore_id());
-
- if (cfg.nb_lcores == 1) {
- lcore_id = rte_get_next_lcore(lcore_id, true, true);
- rte_eal_remote_launch((lcore_function_t *)rxtx_main_loop,
- NULL, lcore_id);
- } else if (cfg.nb_lcores > 1) {
- lcore_id = rte_get_next_lcore(lcore_id, true, true);
- rte_eal_remote_launch((lcore_function_t *)rx_main_loop,
- NULL, lcore_id);
-
- lcore_id = rte_get_next_lcore(lcore_id, true, true);
- rte_eal_remote_launch((lcore_function_t *)tx_main_loop, NULL,
- lcore_id);
- }
-}
-/* >8 End of starting to processfor each lcore. */
-
-/* Display usage */
-static void
-dma_usage(const char *prgname)
-{
- printf("%s [EAL options] -- -p PORTMASK [-q NQ]\n"
- " -b --dma-batch-size: number of requests per DMA batch\n"
- " -f --max-frame-size: max frame size\n"
- " -p --portmask: hexadecimal bitmask of ports to configure\n"
- " -q NQ: number of RX queues per port (default is 1)\n"
- " --[no-]mac-updating: Enable or disable MAC addresses updating (enabled by default)\n"
- " When enabled:\n"
- " - The source MAC address is replaced by the TX port MAC address\n"
- " - The destination MAC address is replaced by 02:00:00:00:00:TX_PORT_ID\n"
- " -c --copy-type CT: type of copy: sw|hw\n"
- " -s --ring-size RS: size of dmadev descriptor ring for hardware copy mode or rte_ring for software copy mode\n"
- " -i --stats-interval SI: interval, in seconds, between stats prints (default is 1)\n",
- prgname);
-}
-
-static int
-dma_parse_portmask(const char *portmask)
-{
- char *end = NULL;
- unsigned long pm;
-
- /* Parse hexadecimal string */
- pm = strtoul(portmask, &end, 16);
- if ((portmask[0] == '\0') || (end == NULL) || (*end != '\0'))
- return 0;
-
- return pm;
-}
-
-static copy_mode_t
-dma_parse_copy_mode(const char *copy_mode)
-{
- if (strcmp(copy_mode, COPY_MODE_SW) == 0)
- return COPY_MODE_SW_NUM;
- else if (strcmp(copy_mode, COPY_MODE_DMA) == 0)
- return COPY_MODE_DMA_NUM;
-
- return COPY_MODE_INVALID_NUM;
-}
-
-/* Parse the argument given in the command line of the application */
-static int
-dma_parse_args(int argc, char **argv, unsigned int nb_ports)
-{
- static const char short_options[] =
- "b:" /* dma batch size */
- "c:" /* copy type (sw|hw) */
- "f:" /* max frame size */
- "p:" /* portmask */
- "q:" /* number of RX queues per port */
- "s:" /* ring size */
- "i:" /* interval, in seconds, between stats prints */
- ;
-
- static const struct option lgopts[] = {
- {CMD_LINE_OPT_MAC_UPDATING, no_argument, &mac_updating, 1},
- {CMD_LINE_OPT_NO_MAC_UPDATING, no_argument, &mac_updating, 0},
- {CMD_LINE_OPT_PORTMASK, required_argument, NULL, 'p'},
- {CMD_LINE_OPT_NB_QUEUE, required_argument, NULL, 'q'},
- {CMD_LINE_OPT_COPY_TYPE, required_argument, NULL, 'c'},
- {CMD_LINE_OPT_RING_SIZE, required_argument, NULL, 's'},
- {CMD_LINE_OPT_BATCH_SIZE, required_argument, NULL, 'b'},
- {CMD_LINE_OPT_FRAME_SIZE, required_argument, NULL, 'f'},
- {CMD_LINE_OPT_STATS_INTERVAL, required_argument, NULL, 'i'},
- {NULL, 0, 0, 0}
- };
-
- const unsigned int default_port_mask = (1 << nb_ports) - 1;
- int opt, ret;
- char **argvopt;
- int option_index;
- char *prgname = argv[0];
-
- dma_enabled_port_mask = default_port_mask;
- argvopt = argv;
-
- while ((opt = getopt_long(argc, argvopt, short_options,
- lgopts, &option_index)) != EOF) {
-
- switch (opt) {
- case 'b':
- dma_batch_sz = atoi(optarg);
- if (dma_batch_sz > MAX_PKT_BURST) {
- printf("Invalid dma batch size, %s.\n", optarg);
- dma_usage(prgname);
- return -1;
- }
- break;
- case 'f':
- max_frame_size = atoi(optarg);
- if (max_frame_size > RTE_ETHER_MAX_JUMBO_FRAME_LEN) {
- printf("Invalid max frame size, %s.\n", optarg);
- dma_usage(prgname);
- return -1;
- }
- break;
-
- /* portmask */
- case 'p':
- dma_enabled_port_mask = dma_parse_portmask(optarg);
- if (dma_enabled_port_mask & ~default_port_mask ||
- dma_enabled_port_mask <= 0) {
- printf("Invalid portmask, %s, suggest 0x%x\n",
- optarg, default_port_mask);
- dma_usage(prgname);
- return -1;
- }
- break;
-
- case 'q':
- nb_queues = atoi(optarg);
- if (nb_queues == 0 || nb_queues > MAX_RX_QUEUES_COUNT) {
- printf("Invalid RX queues number %s. Max %u\n",
- optarg, MAX_RX_QUEUES_COUNT);
- dma_usage(prgname);
- return -1;
- }
- break;
-
- case 'c':
- copy_mode = dma_parse_copy_mode(optarg);
- if (copy_mode == COPY_MODE_INVALID_NUM) {
- printf("Invalid copy type. Use: sw, hw\n");
- dma_usage(prgname);
- return -1;
- }
- break;
-
- case 's':
- ring_size = atoi(optarg);
- if (ring_size == 0) {
- printf("Invalid ring size, %s.\n", optarg);
- dma_usage(prgname);
- return -1;
- }
- /* ring_size must be less-than or equal to MBUF_RING_SIZE
- * to avoid overwriting bufs
- */
- if (ring_size > MBUF_RING_SIZE) {
- printf("Max ring_size is %d, setting ring_size to max",
- MBUF_RING_SIZE);
- ring_size = MBUF_RING_SIZE;
- }
- break;
-
- case 'i':
- stats_interval = atoi(optarg);
- if (stats_interval == 0) {
- printf("Invalid stats interval, setting to 1\n");
- stats_interval = 1; /* set to default */
- }
- break;
-
- /* long options */
- case 0:
- break;
-
- default:
- dma_usage(prgname);
- return -1;
- }
- }
-
- printf("MAC updating %s\n", mac_updating ? "enabled" : "disabled");
- if (optind >= 0)
- argv[optind - 1] = prgname;
-
- ret = optind - 1;
- optind = 1; /* reset getopt lib */
- return ret;
-}
-
-/* check link status, return true if at least one port is up */
-static int
-check_link_status(uint32_t port_mask)
-{
- uint16_t portid;
- struct rte_eth_link link;
- int ret, link_status = 0;
- char link_status_text[RTE_ETH_LINK_MAX_STR_LEN];
-
- printf("\nChecking link status\n");
- RTE_ETH_FOREACH_DEV(portid) {
- if ((port_mask & (1 << portid)) == 0)
- continue;
-
- memset(&link, 0, sizeof(link));
- ret = rte_eth_link_get(portid, &link);
- if (ret < 0) {
- printf("Port %u link get failed: err=%d\n",
- portid, ret);
- continue;
- }
-
- /* Print link status */
- rte_eth_link_to_str(link_status_text,
- sizeof(link_status_text), &link);
- printf("Port %d %s\n", portid, link_status_text);
-
- if (link.link_status)
- link_status = 1;
- }
- return link_status;
-}
-
-/* Configuration of device. 8< */
-static void
-configure_dmadev_queue(uint32_t dev_id)
-{
- struct rte_dma_info info;
- struct rte_dma_conf dev_config = { .nb_vchans = 1 };
- struct rte_dma_vchan_conf qconf = {
- .direction = RTE_DMA_DIR_MEM_TO_MEM,
- .nb_desc = ring_size
- };
- uint16_t vchan = 0;
-
- if (rte_dma_configure(dev_id, &dev_config) != 0)
- rte_exit(EXIT_FAILURE, "Error with rte_dma_configure()\n");
-
- if (rte_dma_vchan_setup(dev_id, vchan, &qconf) != 0) {
- printf("Error with queue configuration\n");
- rte_panic();
- }
- rte_dma_info_get(dev_id, &info);
- if (info.nb_vchans != 1) {
- printf("Error, no configured queues reported on device id %u\n", dev_id);
- rte_panic();
- }
- if (rte_dma_start(dev_id) != 0)
- rte_exit(EXIT_FAILURE, "Error with rte_dma_start()\n");
-}
-/* >8 End of configuration of device. */
-
-/* Using dmadev API functions. 8< */
-static void
-assign_dmadevs(void)
-{
- uint16_t nb_dmadev = 0;
- int16_t dev_id = rte_dma_next_dev(0);
- uint32_t i, j;
-
- for (i = 0; i < cfg.nb_ports; i++) {
- for (j = 0; j < cfg.ports[i].nb_queues; j++) {
- if (dev_id == -1)
- goto end;
-
- cfg.ports[i].dmadev_ids[j] = dev_id;
- configure_dmadev_queue(cfg.ports[i].dmadev_ids[j]);
- dev_id = rte_dma_next_dev(dev_id + 1);
- ++nb_dmadev;
- }
- }
-end:
- if (nb_dmadev < cfg.nb_ports * cfg.ports[0].nb_queues)
- rte_exit(EXIT_FAILURE,
- "Not enough dmadevs (%u) for all queues (%u).\n",
- nb_dmadev, cfg.nb_ports * cfg.ports[0].nb_queues);
- RTE_LOG(INFO, DMA, "Number of used dmadevs: %u.\n", nb_dmadev);
-}
-/* >8 End of using dmadev API functions. */
-
-/* Assign ring structures for packet exchanging. 8< */
-static void
-assign_rings(void)
-{
- uint32_t i;
-
- for (i = 0; i < cfg.nb_ports; i++) {
- char ring_name[RTE_RING_NAMESIZE];
-
- snprintf(ring_name, sizeof(ring_name), "rx_to_tx_ring_%u", i);
- /* Create ring for inter core communication */
- cfg.ports[i].rx_to_tx_ring = rte_ring_create(
- ring_name, ring_size,
- rte_socket_id(), RING_F_SP_ENQ | RING_F_SC_DEQ);
-
- if (cfg.ports[i].rx_to_tx_ring == NULL)
- rte_exit(EXIT_FAILURE, "Ring create failed: %s\n",
- rte_strerror(rte_errno));
- }
-}
-/* >8 End of assigning ring structures for packet exchanging. */
-
-/*
- * Initializes a given port using global settings and with the RX buffers
- * coming from the mbuf_pool passed as a parameter.
- */
-static inline void
-port_init(uint16_t portid, struct rte_mempool *mbuf_pool, uint16_t nb_queues)
-{
- /* Configuring port to use RSS for multiple RX queues. 8< */
- static const struct rte_eth_conf port_conf = {
- .rxmode = {
- .mq_mode = RTE_ETH_MQ_RX_RSS,
- },
- .rx_adv_conf = {
- .rss_conf = {
- .rss_key = NULL,
- .rss_hf = RTE_ETH_RSS_PROTO_MASK,
- }
- }
- };
- /* >8 End of configuring port to use RSS for multiple RX queues. */
-
- struct rte_eth_rxconf rxq_conf;
- struct rte_eth_txconf txq_conf;
- struct rte_eth_conf local_port_conf = port_conf;
- struct rte_eth_dev_info dev_info;
- int ret, i;
-
- if (max_frame_size > local_port_conf.rxmode.mtu)
- local_port_conf.rxmode.mtu = max_frame_size;
-
- /* Skip ports that are not enabled */
- if ((dma_enabled_port_mask & (1 << portid)) == 0) {
- printf("Skipping disabled port %u\n", portid);
- return;
- }
-
- /* Init port */
- printf("Initializing port %u... ", portid);
- fflush(stdout);
- ret = rte_eth_dev_info_get(portid, &dev_info);
- if (ret < 0)
- rte_exit(EXIT_FAILURE, "Cannot get device info: %s, port=%u\n",
- rte_strerror(-ret), portid);
-
- local_port_conf.rx_adv_conf.rss_conf.rss_hf &=
- dev_info.flow_type_rss_offloads;
- ret = rte_eth_dev_configure(portid, nb_queues, 1, &local_port_conf);
- if (ret < 0)
- rte_exit(EXIT_FAILURE, "Cannot configure device:"
- " err=%d, port=%u\n", ret, portid);
-
- ret = rte_eth_dev_adjust_nb_rx_tx_desc(portid, &nb_rxd,
- &nb_txd);
- if (ret < 0)
- rte_exit(EXIT_FAILURE,
- "Cannot adjust number of descriptors: err=%d, port=%u\n",
- ret, portid);
-
- rte_eth_macaddr_get(portid, &dma_ports_eth_addr[portid]);
-
- /* Init RX queues */
- rxq_conf = dev_info.default_rxconf;
- rxq_conf.offloads = local_port_conf.rxmode.offloads;
- for (i = 0; i < nb_queues; i++) {
- ret = rte_eth_rx_queue_setup(portid, i, nb_rxd,
- rte_eth_dev_socket_id(portid), &rxq_conf,
- mbuf_pool);
- if (ret < 0)
- rte_exit(EXIT_FAILURE,
- "rte_eth_rx_queue_setup:err=%d,port=%u, queue_id=%u\n",
- ret, portid, i);
- }
-
- /* Init one TX queue on each port */
- txq_conf = dev_info.default_txconf;
- txq_conf.offloads = local_port_conf.txmode.offloads;
- ret = rte_eth_tx_queue_setup(portid, 0, nb_txd,
- rte_eth_dev_socket_id(portid),
- &txq_conf);
- if (ret < 0)
- rte_exit(EXIT_FAILURE,
- "rte_eth_tx_queue_setup:err=%d,port=%u\n",
- ret, portid);
-
- /* Initialize TX buffers */
- tx_buffer[portid] = rte_zmalloc_socket("tx_buffer",
- RTE_ETH_TX_BUFFER_SIZE(MAX_PKT_BURST), 0,
- rte_eth_dev_socket_id(portid));
- if (tx_buffer[portid] == NULL)
- rte_exit(EXIT_FAILURE,
- "Cannot allocate buffer for tx on port %u\n",
- portid);
-
- rte_eth_tx_buffer_init(tx_buffer[portid], MAX_PKT_BURST);
-
- ret = rte_eth_tx_buffer_set_err_callback(tx_buffer[portid],
- rte_eth_tx_buffer_count_callback,
- &port_statistics.tx_dropped[portid]);
- if (ret < 0)
- rte_exit(EXIT_FAILURE,
- "Cannot set error callback for tx buffer on port %u\n",
- portid);
-
- /* Start device. 8< */
- ret = rte_eth_dev_start(portid);
- if (ret < 0)
- rte_exit(EXIT_FAILURE,
- "rte_eth_dev_start:err=%d, port=%u\n",
- ret, portid);
- /* >8 End of starting device. */
-
- /* RX port is set in promiscuous mode. 8< */
- rte_eth_promiscuous_enable(portid);
- /* >8 End of RX port is set in promiscuous mode. */
-
- printf("Port %u, MAC address: " RTE_ETHER_ADDR_PRT_FMT "\n\n",
- portid,
- RTE_ETHER_ADDR_BYTES(&dma_ports_eth_addr[portid]));
-
- cfg.ports[cfg.nb_ports].rxtx_port = portid;
- cfg.ports[cfg.nb_ports++].nb_queues = nb_queues;
-}
-
-/* Get a device dump for each device being used by the application */
-static void
-dmadev_dump(void)
-{
- uint32_t i, j;
-
- if (copy_mode != COPY_MODE_DMA_NUM)
- return;
-
- for (i = 0; i < cfg.nb_ports; i++)
- for (j = 0; j < cfg.ports[i].nb_queues; j++)
- rte_dma_dump(cfg.ports[i].dmadev_ids[j], stdout);
-}
-
-static void
-signal_handler(int signum)
-{
- if (signum == SIGINT || signum == SIGTERM) {
- printf("\n\nSignal %d received, preparing to exit...\n",
- signum);
- force_quit = true;
- } else if (signum == SIGUSR1) {
- dmadev_dump();
- }
-}
-
-int
-main(int argc, char **argv)
-{
- int ret;
- uint16_t nb_ports, portid;
- uint32_t i;
- unsigned int nb_mbufs;
- size_t sz;
-
- /* Init EAL. 8< */
- ret = rte_eal_init(argc, argv);
- if (ret < 0)
- rte_exit(EXIT_FAILURE, "Invalid EAL arguments\n");
- /* >8 End of init EAL. */
- argc -= ret;
- argv += ret;
-
- force_quit = false;
- signal(SIGINT, signal_handler);
- signal(SIGTERM, signal_handler);
- signal(SIGUSR1, signal_handler);
-
- nb_ports = rte_eth_dev_count_avail();
- if (nb_ports == 0)
- rte_exit(EXIT_FAILURE, "No Ethernet ports - bye\n");
-
- /* Parse application arguments (after the EAL ones) */
- ret = dma_parse_args(argc, argv, nb_ports);
- if (ret < 0)
- rte_exit(EXIT_FAILURE, "Invalid DMA arguments\n");
-
- /* Allocates mempool to hold the mbufs. 8< */
- nb_mbufs = RTE_MAX(nb_ports * (nb_queues * (nb_rxd + nb_txd +
- 4 * MAX_PKT_BURST + ring_size) + ring_size +
- rte_lcore_count() * MEMPOOL_CACHE_SIZE),
- MIN_POOL_SIZE);
-
- /* Create the mbuf pool */
- sz = max_frame_size + RTE_PKTMBUF_HEADROOM;
- sz = RTE_MAX(sz, (size_t)RTE_MBUF_DEFAULT_BUF_SIZE);
- dma_pktmbuf_pool = rte_pktmbuf_pool_create("mbuf_pool", nb_mbufs,
- MEMPOOL_CACHE_SIZE, 0, sz, rte_socket_id());
- if (dma_pktmbuf_pool == NULL)
- rte_exit(EXIT_FAILURE, "Cannot init mbuf pool\n");
- /* >8 End of allocates mempool to hold the mbufs. */
-
- /* Initialize each port. 8< */
- cfg.nb_ports = 0;
- RTE_ETH_FOREACH_DEV(portid)
- port_init(portid, dma_pktmbuf_pool, nb_queues);
- /* >8 End of initializing each port. */
-
- /* Initialize port xstats */
- memset(&port_statistics, 0, sizeof(port_statistics));
-
- /* Assigning each port resources. 8< */
- while (!check_link_status(dma_enabled_port_mask) && !force_quit)
- sleep(1);
-
- /* Check if there is enough lcores for all ports. */
- cfg.nb_lcores = rte_lcore_count() - 1;
- if (cfg.nb_lcores < 1)
- rte_exit(EXIT_FAILURE,
- "There should be at least one worker lcore.\n");
-
- if (copy_mode == COPY_MODE_DMA_NUM)
- assign_dmadevs();
-
- assign_rings();
- /* >8 End of assigning each port resources. */
-
- start_forwarding_cores();
- /* main core prints stats while other cores forward */
- print_stats(argv[0]);
-
- /* force_quit is true when we get here */
- rte_eal_mp_wait_lcore();
-
- uint32_t j;
- for (i = 0; i < cfg.nb_ports; i++) {
- printf("Closing port %d\n", cfg.ports[i].rxtx_port);
- ret = rte_eth_dev_stop(cfg.ports[i].rxtx_port);
- if (ret != 0)
- RTE_LOG(ERR, DMA, "rte_eth_dev_stop: err=%s, port=%u\n",
- rte_strerror(-ret), cfg.ports[i].rxtx_port);
-
- rte_eth_dev_close(cfg.ports[i].rxtx_port);
- if (copy_mode == COPY_MODE_DMA_NUM) {
- for (j = 0; j < cfg.ports[i].nb_queues; j++) {
- printf("Stopping dmadev %d\n",
- cfg.ports[i].dmadev_ids[j]);
- rte_dma_stop(cfg.ports[i].dmadev_ids[j]);
- }
- } else /* copy_mode == COPY_MODE_SW_NUM */
- rte_ring_free(cfg.ports[i].rx_to_tx_ring);
- }
-
- /* clean up the EAL */
- rte_eal_cleanup();
-
- printf("Bye...\n");
- return 0;
-}
+++ /dev/null
-# SPDX-License-Identifier: BSD-3-Clause
-# Copyright(c) 2019-2021 Intel Corporation
-
-# 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'
-
-allow_experimental_apis = true
-
-deps += ['dmadev']
-
-sources = files(
- 'ioatfwd.c',
-)
'bond',
'cmdline',
'distributor',
+ 'dma',
'ethtool',
'eventdev_pipeline',
'fips_validation',
'flow_classify',
'flow_filtering',
'helloworld',
- 'ioat',
'ip_fragmentation',
'ip_pipeline',
'ip_reassembly',