2019-02-07 15:53:18 +00:00
# Please keep these options sorted alphabetically.
build: add infrastructure for meson and ninja builds
To build with meson and ninja, we need some initial infrastructure in
place. The build files for meson always need to be called "meson.build",
and options get placed in meson_options.txt
This commit adds a top-level meson.build file, which sets up the global
variables for tracking drivers, libraries, etc., and then includes other
build files, before finishing by writing the global build configuration
header file and a DPDK pkgconfig file at the end, using some of those same
globals.
From the top level build file, the only include file thus far is for the
config folder, which does some other setup of global configuration
parameters, including pulling in architecture specific parameters from an
architectural subdirectory. A number of configuration build options are
provided for the project to tune a number of global variables which will be
used later e.g. max numa nodes, max cores, etc. These settings all make
their way to the global build config header "rte_build_config.h". There is
also a file "rte_config.h", which includes "rte_build_config.h", and this
file is meant to hold other build-time values which are present in our
current static build configuration but are not normally meant for
user-configuration. Ideally, over time, the values placed here should be
moved to the individual libraries or drivers which want those values.
Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
Reviewed-by: Harry van Haaren <harry.van.haaren@intel.com>
Acked-by: Keith Wiles <keith.wiles@intel.com>
Acked-by: Luca Boccassi <luca.boccassi@gmail.com>
2017-08-28 10:57:12 +00:00
option ( 'allow_invalid_socket_id' , type : 'boolean' , value : false ,
description : 'allow out-of-range NUMA socket id\'s for platforms that don\'t report the value correctly' )
2019-09-25 14:55:31 +00:00
option ( 'disable_drivers' , type : 'string' , value : '' ,
description : 'Comma-separated list of drivers to explicitly disable.' )
2018-10-02 16:20:46 +00:00
option ( 'drivers_install_subdir' , type : 'string' , value : 'dpdk/pmds-<VERSION>' ,
description : 'Subdirectory of libdir where to install PMDs. Defaults to using a versioned subdirectory.' )
2018-09-11 20:42:36 +00:00
option ( 'enable_docs' , type : 'boolean' , value : false ,
description : 'build documentation' )
2019-02-07 15:53:18 +00:00
option ( 'enable_kmods' , type : 'boolean' , value : true ,
description : 'build kernel modules' )
examples: build some samples with meson
Add support for having selected example apps built as part of a meson,
ninja build. By default none are built, and those to be built should be
named directly in the -Dexamples='' meson configuration argument.
This is useful for developers working on a feature who want to use a
suitable example, or examples, to test that feature, as they can compile
everything up in one go, and run the example without having to do a ninja
install first.
This commit adds examples which don't consist of multiple apps in
subdirectories to the meson build, so they can be built by default by
passing -Dexamples parameter to meson.
Not included are the following examples:
* ethtool
* multi-process
* netmap_compat
* performance-thread
* quota_watermark
* server_node_efd
* vm_power_manager
To test the apps added here, use the following command, merged to one line,
to add them to your meson build (command to be run inside the build
directory):
meson configure -Dexamples=bbdev_app,bond,cmdline,distributor,\
eventdev_pipeline_sw_pmd, exception_path,helloworld,\
ip_fragmentation,ip_pipeline,ip_reassembly, ipsec-secgw,\
ipv4_multicast,kni,l2fwd-cat,l2fwd-crypto,l2fwd-jobstats,\
l2fwd-keepalive,l2fwd,l3fwd-acl,l3fwd-power,l3fwd-vf,l3fwd,\
link_status_interrupt,load_balancer,packet_ordering,ptpclient,\
qos_meter,qos_sched,rxtx_callbacks,skeleton,tep_termination,\
timer,vhost,vhost_scsi,vmdq,vmdq_dcb
Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
Reviewed-by: Luca Boccassi <bluca@debian.org>
2017-09-12 15:42:02 +00:00
option ( 'examples' , type : 'string' , value : '' ,
description : 'Comma-separated list of examples to build by default' )
2019-06-19 17:48:38 +00:00
option ( 'flexran_sdk' , type : 'string' , value : '' ,
description : 'Path to FlexRAN SDK optional Libraries for BBDEV device' )
2019-02-07 15:53:18 +00:00
option ( 'ibverbs_link' , type : 'combo' , choices : [ 'shared' , 'dlopen' ] , value : 'shared' ,
description : 'Linkage method (shared/dlopen) for Mellanox PMDs with ibverbs dependencies.' )
2017-09-20 10:28:55 +00:00
option ( 'include_subdir_arch' , type : 'string' , value : '' ,
description : 'subdirectory where to install arch-dependent headers' )
option ( 'kernel_dir' , type : 'string' , value : '' ,
2019-06-11 08:49:34 +00:00
description : 'Path to the kernel for building kernel modules. Headers must be in $kernel_dir/build. Modules will be installed in $DEST_DIR/$kernel_dir/extra/dpdk.' )
2018-04-11 11:45:07 +00:00
option ( 'lib_musdk_dir' , type : 'string' , value : '' ,
description : 'path to the MUSDK library installation directory' )
2017-09-20 10:28:55 +00:00
option ( 'machine' , type : 'string' , value : 'native' ,
description : 'set the target machine type' )
2019-03-01 15:46:51 +00:00
option ( 'max_ethports' , type : 'integer' , value : 32 ,
2019-02-07 15:53:17 +00:00
description : 'maximum number of Ethernet devices' )
2019-02-26 17:46:36 +00:00
option ( 'max_lcores' , type : 'integer' , value : 128 ,
2017-09-20 10:28:55 +00:00
description : 'maximum number of cores/threads supported by EAL' )
2019-02-26 17:46:36 +00:00
option ( 'max_numa_nodes' , type : 'integer' , value : 4 ,
2017-09-20 10:28:55 +00:00
description : 'maximum number of NUMA nodes supported by EAL' )
option ( 'per_library_versions' , type : 'boolean' , value : true ,
description : 'true: each lib gets its own version number, false: DPDK version used for each lib' )
2017-12-20 11:16:32 +00:00
option ( 'tests' , type : 'boolean' , value : true ,
description : 'build unit tests' )
2019-02-07 15:53:18 +00:00
option ( 'use_hpet' , type : 'boolean' , value : false ,
description : 'use HPET timer in EAL' )
