File: null.rst

package info (click to toggle)
dpdk 24.11.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 121,148 kB
  • sloc: ansic: 2,206,055; python: 11,866; sh: 4,627; makefile: 2,025; awk: 70
file content (43 lines) | stat: -rw-r--r-- 1,185 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
..  SPDX-License-Identifier: BSD-3-Clause
    Copyright(c) 2020 Intel Corporation.

NULL Poll Mode Driver
=====================

NULL PMD is a simple virtual driver mainly for testing. It always returns success for all packets for Rx/Tx.

On Rx it returns requested number of empty packets (all zero). On Tx it just frees all sent packets.


Usage
-----

.. code-block:: console

   ./<build_dir>/app/dpdk-testpmd -l 0-3 -n 4 --vdev net_null0 --vdev net_null1 -- -i


Runtime Configuration
---------------------

- ``copy`` [optional, default disabled]

 It copies data of the packet before Rx/Tx. For Rx it uses another empty dummy mbuf for this.

.. code-block:: console

   ./<build_dir>/app/dpdk-testpmd -l 0-3 -n 4 --vdev "net_null0,copy=1" -- -i

- ``size`` [optional, default=64 bytes]

 Custom packet length value to use.r
 If ``copy`` is enabled, this is the length of copy operation.

.. code-block:: console

   ./<build_dir>/app/dpdk-testpmd -l 0-3 -n 4 --vdev "net_null0,size=256" -- -i

- ``no-rx`` [optional, default disabled]

 Makes PMD more like ``/dev/null``. On Rx no packets received, on Tx all packets are freed.
 This option can't co-exist with ``copy`` option.