xref: /dpdk/doc/guides/sample_app_ug/compiling.rst (revision e2a94f9ad3ef949c0df3e63699bd4e381b5003d9)
15630257fSFerruh Yigit..  SPDX-License-Identifier: BSD-3-Clause
25630257fSFerruh Yigit    Copyright(c) 2015 Intel Corporation.
37cacb056SHerakliusz Lipiec
47cacb056SHerakliusz LipiecCompiling the Sample Applications
57cacb056SHerakliusz Lipiec=================================
67cacb056SHerakliusz Lipiec
77cacb056SHerakliusz LipiecThis section explains how to compile the DPDK sample applications.
87cacb056SHerakliusz Lipiec
97cacb056SHerakliusz LipiecTo compile all the sample applications
107cacb056SHerakliusz Lipiec--------------------------------------
117cacb056SHerakliusz Lipiec
12*e2a94f9aSCiara PowerGo to DPDK build directory:
137cacb056SHerakliusz Lipiec
147cacb056SHerakliusz Lipiec    .. code-block:: console
157cacb056SHerakliusz Lipiec
16*e2a94f9aSCiara Power       cd dpdk/<build_dir>
177cacb056SHerakliusz Lipiec
18*e2a94f9aSCiara PowerEnable examples compilation:
197cacb056SHerakliusz Lipiec
207cacb056SHerakliusz Lipiec   .. code-block:: console
217cacb056SHerakliusz Lipiec
22*e2a94f9aSCiara Power      meson configure -Dexamples=all
237cacb056SHerakliusz Lipiec
24*e2a94f9aSCiara PowerBuild:
257cacb056SHerakliusz Lipiec
267cacb056SHerakliusz Lipiec   .. code-block:: console
277cacb056SHerakliusz Lipiec
28*e2a94f9aSCiara Power      ninja
297cacb056SHerakliusz Lipiec
30*e2a94f9aSCiara PowerFor additional information on compiling see
317cacb056SHerakliusz Lipiec:ref:`Compiling DPDK on Linux <linux_gsg_compiling_dpdk>` or
327cacb056SHerakliusz Lipiec:ref:`Compiling DPDK on FreeBSD <building_from_source>`.
33*e2a94f9aSCiara PowerApplications are output to: ``dpdk/<build_dir>/examples``.
347cacb056SHerakliusz Lipiec
357cacb056SHerakliusz Lipiec
36*e2a94f9aSCiara PowerTo compile a single application
37*e2a94f9aSCiara Power-------------------------------
38*e2a94f9aSCiara Power
39*e2a94f9aSCiara Power
40*e2a94f9aSCiara PowerUsing meson
41*e2a94f9aSCiara Power~~~~~~~~~~~
42*e2a94f9aSCiara Power
43*e2a94f9aSCiara PowerGo to DPDK build directory:
447cacb056SHerakliusz Lipiec
457cacb056SHerakliusz Lipiec    .. code-block:: console
467cacb056SHerakliusz Lipiec
47*e2a94f9aSCiara Power       cd dpdk/<build_dir>
487cacb056SHerakliusz Lipiec
49*e2a94f9aSCiara PowerEnable example app compilation:
50*e2a94f9aSCiara Power
51*e2a94f9aSCiara Power   .. code-block:: console
52*e2a94f9aSCiara Power
53*e2a94f9aSCiara Power      meson configure -Dexamples=helloworld
54*e2a94f9aSCiara Power
55*e2a94f9aSCiara PowerBuild:
56*e2a94f9aSCiara Power
57*e2a94f9aSCiara Power   .. code-block:: console
58*e2a94f9aSCiara Power
59*e2a94f9aSCiara Power      ninja
60*e2a94f9aSCiara Power
61*e2a94f9aSCiara Power
62*e2a94f9aSCiara PowerUsing Make
63*e2a94f9aSCiara Power~~~~~~~~~~
64*e2a94f9aSCiara Power
65*e2a94f9aSCiara PowerPkg-config is used when building an example app standalone using make, please
66*e2a94f9aSCiara Powersee :ref:`building_app_using_installed_dpdk` for more information.
67*e2a94f9aSCiara Power
68*e2a94f9aSCiara PowerGo to the sample application directory. Unless otherwise specified the sample
69*e2a94f9aSCiara Powerapplications are located in ``dpdk/examples/``.
70*e2a94f9aSCiara Power
71*e2a94f9aSCiara PowerBuild the application:
72*e2a94f9aSCiara Power
73*e2a94f9aSCiara Power    .. code-block:: console
74*e2a94f9aSCiara Power
75*e2a94f9aSCiara Power        make
76*e2a94f9aSCiara Power
77*e2a94f9aSCiara PowerTo build the application for debugging use the ``DEBUG`` option.
787cacb056SHerakliusz LipiecThis option adds some extra flags, disables compiler optimizations and
797cacb056SHerakliusz Lipiecsets verbose output.
807cacb056SHerakliusz Lipiec
817cacb056SHerakliusz Lipiec    .. code-block:: console
827cacb056SHerakliusz Lipiec
837cacb056SHerakliusz Lipiec       make DEBUG=1
84