app/testpmd: add flow queue pull operation
[dpdk.git] / doc / guides / prog_guide / build_app.rst
1 ..  SPDX-License-Identifier: BSD-3-Clause
2     Copyright(c) 2010-2014 Intel Corporation.
3
4 .. _Building_Your_Own_Application:
5
6 Building Your Own Application
7 =============================
8
9 Compiling a Sample Application in the Development Kit Directory
10 ---------------------------------------------------------------
11
12 To compile a sample application with make (for example, hello world):
13
14 .. code-block:: console
15
16     ~/DPDK$ cd examples/helloworld/
17     ~/DPDK/examples/helloworld$ make
18
19 The binary is generated in the build directory by default:
20
21 .. code-block:: console
22
23     ~/DPDK/examples/helloworld$ ls build/app
24     helloworld helloworld.map
25
26 Please refer to :doc:`../linux_gsg/build_dpdk` for details on compiling with meson.
27
28 Build Your Own Application Outside the Development Kit
29 ------------------------------------------------------
30
31 The sample application (Hello World) can be duplicated in a new directory as a starting point for your development:
32
33 .. code-block:: console
34
35     ~$ cp -r DPDK/examples/helloworld my_rte_app
36     ~$ cd my_rte_app/
37     ~/my_rte_app$ make
38
39 Customizing Makefiles
40 ---------------------
41
42 Application Makefile
43 ~~~~~~~~~~~~~~~~~~~~
44
45 The default makefile provided with the Hello World sample application is a good starting point.
46
47 The user must define several variables:
48
49 *   APP: Contains the name of the application.
50
51 *   SRCS-y: List of source files (\*.c, \*.S).