xref: /dpdk/doc/guides/mempool/octeontx.rst (revision a3b34b1df80193f56f5fd57e9a9168193e3c97ec)
1..  SPDX-License-Identifier: BSD-3-Clause
2    Copyright(c) 2017 Cavium, Inc
3
4OCTEON TX FPAVF Mempool Driver
5==============================
6
7The OCTEON TX FPAVF PMD (**librte_mempool_octeontx**) is a mempool
8driver for offload mempool device found in **Cavium OCTEON TX** SoC
9family.
10
11More information can be found at `Cavium, Inc Official Website
12<http://www.cavium.com/OCTEON-TX_ARM_Processors.html>`_.
13
14Features
15--------
16
17Features of the OCTEON TX FPAVF PMD are:
18
19- 32 SR-IOV Virtual functions
20- 32 Pools
21- HW mempool manager
22
23Supported OCTEON TX SoCs
24------------------------
25
26- CN83xx
27
28Prerequisites
29-------------
30
31See :doc: `../platform/octeontx.rst` for setup information.
32
33Pre-Installation Configuration
34------------------------------
35
36Config File Options
37~~~~~~~~~~~~~~~~~~~
38
39The following option can be modified in the ``config/rte_config.h`` file.
40Please note that enabling debugging options may affect system performance.
41
42- ``RTE_MBUF_DEFAULT_MEMPOOL_OPS`` ( set to ``octeontx_fpavf``)
43
44  Set default mempool ops to octeontx_fpavf.
45
46Driver Compilation
47~~~~~~~~~~~~~~~~~~
48
49See :doc:`../linux_gsg/build_dpdk` for more information on compiling DPDK.
50
51
52Initialization
53--------------
54
55The OCTEON TX fpavf mempool initialization similar to other mempool
56drivers like ring. However user need to pass --base-virtaddr as
57command line input to application example test_mempool.c application.
58
59Example:
60
61.. code-block:: console
62
63    ./<build_dir>/app/test/dpdk-test -c 0xf --base-virtaddr=0x100000000000 \
64                        --mbuf-pool-ops-name="octeontx_fpavf"
65