Enable an example for rawdev ntb. Support interactive mode to send file on one host and receive file from another host. The command line would be 'send [filepath]' and 'receive [filepath]'. But since the FIFO is not enabled right now, use rte_memcpy as the enqueue and dequeue functions and only support transmitting file no more than 4M. Signed-off-by: Xiaoyun Li <xiaoyun.li@intel.com> Acked-by: Jingjing Wu <jingjing.wu@intel.com> Reviewed-by: Xiaolong Ye <xiaolong.ye@intel.com>
48 lines
1.2 KiB
ReStructuredText
48 lines
1.2 KiB
ReStructuredText
.. SPDX-License-Identifier: BSD-3-Clause
|
|
Copyright(c) 2019 Intel Corporation.
|
|
|
|
NTB Sample Application
|
|
======================
|
|
|
|
The ntb sample application shows how to use ntb rawdev driver.
|
|
This sample provides interactive mode to transmit file between
|
|
two hosts.
|
|
|
|
Compiling the Application
|
|
-------------------------
|
|
|
|
To compile the sample application see :doc:`compiling`.
|
|
|
|
The application is located in the ``ntb`` sub-directory.
|
|
|
|
Running the Application
|
|
-----------------------
|
|
|
|
The application requires an available core for each port, plus one.
|
|
The only available options are the standard ones for the EAL:
|
|
|
|
.. code-block:: console
|
|
|
|
./build/ntb_fwd -c 0xf -n 6 -- -i
|
|
|
|
Refer to the *DPDK Getting Started Guide* for general information on
|
|
running applications and the Environment Abstraction Layer (EAL)
|
|
options.
|
|
|
|
Using the application
|
|
---------------------
|
|
|
|
The application is console-driven using the cmdline DPDK interface:
|
|
|
|
.. code-block:: console
|
|
|
|
ntb>
|
|
|
|
From this interface the available commands and descriptions of what
|
|
they do as as follows:
|
|
|
|
* ``send [filepath]``: Send file to the peer host.
|
|
* ``receive [filepath]``: Receive file to [filepath]. Need the peer
|
|
to send file successfully first.
|
|
* ``quit``: Exit program
|