The easiest way to get up and running with the DPDK on FreeBSD is to
install it from the ports collection. Details of getting and using the ports
-collection are documented in the FreeBSD Handbook at:
-
- https://www.freebsd.org/doc/handbook/ports-using.html
+collection are documented in the
+`FreeBSD Handbook <http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/index.html>`_.
.. note::
- Testing has been performed using FreeBSD* 10.0-RELEASE (x86_64) and requires the
+ Testing has been performed using FreeBSD 10.0-RELEASE (x86_64) and requires the
installation of the kernel sources, which should be included during the
- installation of FreeBSD*.
+ installation of FreeBSD.
Installing the DPDK FreeBSD Port
--------------------------------
-On a system with the ports collection installed in /usr/ports, the DPDK
+On a system with the ports collection installed in ``/usr/ports``, the DPDK
can be installed using the commands:
.. code-block:: console
- root@host:~ # cd /usr/ports/net/dpdk
+ cd /usr/ports/net/dpdk
- root@host:~ # make install
+ make install
After the installation of the DPDK port, instructions will be printed on
how to install the kernel modules required to use the DPDK. A more
complete version of these instructions can be found in the sections
:ref:`loading_contigmem` and :ref:`loading_nic_uio`. Normally, lines like
-those below would be added to the file "/boot/loader.conf".
+those below would be added to the file ``/boot/loader.conf``.
.. code-block:: console
- # reserve 2 x 1G blocks of contiguous memory using contigmem driver
+ # Reserve 2 x 1G blocks of contiguous memory using contigmem driver:
hw.contigmem.num_buffers=2
hw.contigmem.buffer_size=1073741824
contigmem_load="YES"
- # identify NIC devices for DPDK apps to use and load nic_uio driver
+
+ # Identify NIC devices for DPDK apps to use and load nic_uio driver:
hw.nic_uio.bdfs="2:0:0,2:0:1"
nic_uio_load="YES"
----------------------------------------------
When the DPDK has been installed from the ports collection it installs
-its example applications in "/usr/local/share/dpdk/examples" - also accessible via
-symlink as "/usr/local/share/examples/dpdk". These examples can be compiled and
+its example applications in ``/usr/local/share/dpdk/examples`` - also accessible via
+symlink as ``/usr/local/share/examples/dpdk``. These examples can be compiled and
run as described in :ref:`compiling_sample_apps`. In this case, the required
environmental variables should be set as below:
-* RTE_SDK=/usr/local/share/dpdk
+* ``RTE_SDK=/usr/local/share/dpdk``
-* RTE_TARGET=x86_64-native-bsdapp-clang
+* ``RTE_TARGET=x86_64-native-bsdapp-clang``
.. note::
- To install a copy of the DPDK compiled using gcc, please download the
- official DPDK package from http://dpdk.org/ and install manually using
- the instructions given in the next chapter, :ref:`building_from_source`
+ To install a copy of the DPDK compiled using gcc, please download the
+ official DPDK package from http://dpdk.org/ and install manually using
+ the instructions given in the next chapter, :ref:`building_from_source`
An example application can therefore be copied to a user's home directory and
compiled and run as below:
.. code-block:: console
- user@host:~$ export RTE_SDK=/usr/local/share/dpdk
+ export RTE_SDK=/usr/local/share/dpdk
- user@host:~$ export RTE_TARGET=x86_64-native-bsdapp-clang
+ export RTE_TARGET=x86_64-native-bsdapp-clang
- user@host:~$ cp -r /usr/local/share/dpdk/examples/helloworld .
+ cp -r /usr/local/share/dpdk/examples/helloworld .
- user@host:~$ cd helloworld/
+ cd helloworld/
- user@host:~/helloworld$ gmake
+ gmake
CC main.o
LD helloworld
INSTALL-APP helloworld
INSTALL-MAP helloworld.map
- user@host:~/helloworld$ sudo ./build/helloworld -c F -n 2
+ sudo ./build/helloworld -c F -n 2
+
EAL: Contigmem driver has 2 buffers, each of size 1GB
EAL: Sysctl reports 8 cpus
EAL: Detected lcore 0
EAL: Support maximum 64 logical core(s) by configuration.
EAL: Detected 4 lcore(s)
EAL: Setting up physically contiguous memory...
- EAL: Mapped memory segment 1 @ 0x802400000: physaddr:0x40000000, len 1073741824
- EAL: Mapped memory segment 2 @ 0x842400000: physaddr:0x100000000, len 1073741824
- EAL: WARNING: clock_gettime cannot use CLOCK_MONOTONIC_RAW and HPET is not available - clock timings may be less accurate.
+ EAL: Mapped memory segment 1 @ 0x802400000: len 1073741824
+ EAL: Mapped memory segment 2 @ 0x842400000: len 1073741824
+ EAL: WARNING: clock_gettime cannot use CLOCK_MONOTONIC_RAW and HPET
+ is not available - clock timings may be less accurate.
EAL: TSC frequency is ~3569023 KHz
EAL: PCI scan found 24 devices
EAL: Master core 0 is ready (tid=0x802006400)
.. note::
- To run a DPDK process as a non-root user, adjust the permissions on
- the /dev/contigmem and /dev/uio device nodes as described in section
- :ref:`running_non_root`
+ To run a DPDK process as a non-root user, adjust the permissions on
+ the ``/dev/contigmem`` and ``/dev/uio device`` nodes as described in section
+ :ref:`running_non_root`
.. note::
- For an explanation of the command-line parameters that can be passed to an
- DPDK application, see section :ref:`running_sample_app`.
+
+ For an explanation of the command-line parameters that can be passed to an
+ DPDK application, see section :ref:`running_sample_app`.