From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
by inbox.dpdk.org (Postfix) with ESMTP id 1C825A0C52;
Wed, 24 Nov 2021 13:56:50 +0100 (CET)
Received: from [217.70.189.124] (localhost [127.0.0.1])
by mails.dpdk.org (Postfix) with ESMTP id D09CD411B2;
Wed, 24 Nov 2021 13:56:49 +0100 (CET)
Received: from wout1-smtp.messagingengine.com (wout1-smtp.messagingengine.com
[64.147.123.24]) by mails.dpdk.org (Postfix) with ESMTP id 819284003C
for <dev@dpdk.org>; Wed, 24 Nov 2021 13:56:48 +0100 (CET)
Received: from compute5.internal (compute5.nyi.internal [10.202.2.45])
by mailout.west.internal (Postfix) with ESMTP id 767E53200A47;
Wed, 24 Nov 2021 07:56:47 -0500 (EST)
Received: from mailfrontend2 ([10.202.2.163])
by compute5.internal (MEProxy); Wed, 24 Nov 2021 07:56:47 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h=
from:to:cc:subject:date:message-id:in-reply-to:references
:mime-version:content-transfer-encoding; s=fm2; bh=i0++OBH1L/1Qh
cnebzlqcbjEVfDsZYv0s7ERak4T3Gs=; b=CwxGiTVZTRteKD0QDygn3aehxqyq1
Me9+oUqhZa3FbG4nEHxm17TXkhS3h18De5u6eB7mK6zYEEPzZ4TWUmI+1YMHIMWY
3dpR2O6ge0u8ZHhyK5ow+w925SU1e4KUMCEqXaRkj/tkFvQjsYDinVb/dTls8J5L
gMoWZVs7h3kFieRYt+XxfZKe/Y0nWsilZXl3NbC4uyjAySsAlkM3mlyRx9f7QBfM
WISXpH1oGPibluPspVxxU1+gXK/slyEYL1jAUMuQ8rBNwn60nxXw3jrxZoYLxFLR
3NvHSoc0uo04CMpxVPgE6Q8+AIR2ZRDTSdObDL7394Tnz4eY2T9XnV9rA==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=
messagingengine.com; h=cc:content-transfer-encoding:date:from
:in-reply-to:message-id:mime-version:references:subject:to
:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=
fm1; bh=i0++OBH1L/1QhcnebzlqcbjEVfDsZYv0s7ERak4T3Gs=; b=nMysYTfH
fQ4WlTQJL/8/XO85p9tIChmMVi2Y0hUvZuHQSbGDcrGbiQYgNrqZC4ewJ9TLIAUE
dYq9iSOLjVxboIj91YTk6Ww6LCPFqZ4Y4qUacnzX3h/O41ZljiOoFgsuXBctKm2s
jhgZCofaCHOen4cvpAud8QzwASKqWuAxyRIcCeia4WKj4LfPdQKJIcxyrfMjLqdI
pzq1BEyeVBOjAly+7TAc5EpVrbUoaXJnvwFH23KvUOhjfbUhTXD9do361WO3YFrO
rE1a3UXTkeeWmUZRd4psSGIs7jtsEIiUp0Js8A0Y1kIioRoAev0xNJbcOK9bh2jF
VMO7DyC0yU839Q==
X-ME-Sender: <xms:jjaeYUNkRM9ZVsF5RhP6DmMQT0IvHcvYfzoNADwxdwPd5JN_3Huvqw>
<xme:jjaeYa_-7IEThbdu154VRabcl37BcxUqbNpEHXIvW6GDL96a-HjpNZCHzbLFYE2bE
rasR7oiXWBw6Oe09A>
X-ME-Received: <xmr:jjaeYbQCbsG8WeILav2fNkk-WoF24tllhl5znzdIAuzIxZmHzc4RMPIBXH6sMSj8RV6DsGY9pfWi0DZKLKcAB1yeveFxm14>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvuddrgeekgdegjecutefuodetggdotefrodftvf
curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu
uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc
fjughrpefhvffufffkofgjfhgggfestdekredtredttdenucfhrhhomhepvfhhohhmrghs
ucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenucggtf
frrghtthgvrhhnpedvhefgiedvjeegtdevheefhfetleefgfeivefgffevfeejgedtgfeu
tdehtdegveenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhroh
hmpehthhhomhgrshesmhhonhhjrghlohhnrdhnvght
X-ME-Proxy: <xmx:jjaeYctKGA3v-nNR9iC7ZNwZZtNLDoDUzxtcfFpQ0uJcS5G9YmPUvw>
<xmx:jjaeYcf-8Z9-9xyZ7r1lIDyDMZKjM1cD72XXMBNtoO7_D7xTgntCFw>
<xmx:jjaeYQ3hSneYHQ4W9USxl69YxpKyU_jJ4yY7VjEKAC26fwXmC00pog>
<xmx:jzaeYUlCLZtQIzR5KXGs5FuHPDpWCIoZ-WPFff3dFyna_0MdAUf3Ug>
Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed,
24 Nov 2021 07:56:46 -0500 (EST)
From: Thomas Monjalon <thomas@monjalon.net>
To: dev@dpdk.org
Cc: Bruce Richardson <bruce.richardson@intel.com>
Subject: [PATCH v2] config: sort Meson options by categories
Date: Wed, 24 Nov 2021 13:56:42 +0100
Message-Id: <20211124125642.1322551-1-thomas@monjalon.net>
X-Mailer: git-send-email 2.33.0
In-Reply-To: <20211025161736.12689-1-thomas@monjalon.net>
References: <20211025161736.12689-1-thomas@monjalon.net>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
<mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
<mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Options used to be sorted alphabetically.
It looks easier to read when major options are first,
then path tuning, libs options, and drivers options.
Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
---
v2: add blank lines for readability
---
meson_options.txt | 99 ++++++++++++++++++++++++++++++-----------------
1 file changed, 63 insertions(+), 36 deletions(-)
diff --git a/meson_options.txt b/meson_options.txt
index 7c220ad68d..b43273a27d 100644
--- a/meson_options.txt
+++ b/meson_options.txt
@@ -1,50 +1,77 @@
-# Please keep these options sorted alphabetically.
-
-option('check_includes', type: 'boolean', value: false, description:
- 'build "chkincs" to verify each header file can compile alone')
-option('cpu_instruction_set', type: 'string', value: 'auto',
- description: 'Set the target machine ISA (instruction set architecture). Will be set according to the platform option by default.')
-option('developer_mode', type: 'feature', description:
- 'turn on additional build checks relevant for DPDK developers')
-option('disable_drivers', type: 'string', value: '', description:
- 'Comma-separated list of drivers to explicitly disable.')
-option('disable_libs', type: 'string', value: '', description:
- 'Comma-separated list of libraries to explicitly disable. [NOTE: not all libs can be disabled]')
+# general compilation tuning
+
+option('platform', type: 'string', value: 'native', description:
+ 'Platform to build, either "native", "generic" or a SoC. Please refer to the Linux build guide for more information.')
+
+option('cpu_instruction_set', type: 'string', value: 'auto', description:
+ 'Set the target machine ISA (instruction set architecture). Will be set according to the platform option by default.')
+
+option('machine', type: 'string', value: 'auto', description:
+ 'Alias of cpu_instruction_set.')
+
+option('include_subdir_arch', type: 'string', value: '', description:
+ 'Subdirectory where to install arch-dependent headers.')
+
option('drivers_install_subdir', type: 'string', value: 'dpdk/pmds-<VERSION>', description:
'Subdirectory of libdir where to install PMDs. Defaults to using a versioned subdirectory.')
-option('enable_docs', type: 'boolean', value: false, description:
- 'build documentation')
+
+option('disable_libs', type: 'string', value: '', description:
+ 'Comma-separated list of libraries to explicitly disable. [NOTE: not all libs can be disabled]')
+
+option('disable_drivers', type: 'string', value: '', description:
+ 'Comma-separated list of drivers to explicitly disable.')
+
option('enable_drivers', type: 'string', value: '', description:
'Comma-separated list of drivers to build. If unspecified, build all drivers.')
+
option('enable_driver_sdk', type: 'boolean', value: false, description:
'Install headers to build drivers.')
+
option('enable_kmods', type: 'boolean', value: false, description:
- 'build kernel modules')
-option('examples', type: 'string', value: '', description:
- 'Comma-separated list of examples to build by default')
-option('flexran_sdk', type: 'string', value: '', description:
- 'Path to FlexRAN SDK optional Libraries for BBDEV device')
-option('ibverbs_link', type: 'combo', choices : ['static', 'shared', 'dlopen'], value: 'shared', description:
- 'Linkage method (static/shared/dlopen) for Mellanox PMDs with ibverbs dependencies.')
-option('include_subdir_arch', type: 'string', value: '', description:
- 'subdirectory where to install arch-dependent headers')
+ 'Build kernel modules.')
+
option('kernel_dir', type: 'string', value: '', description:
'Path to the kernel for building kernel modules. Headers must be in $kernel_dir or $kernel_dir/build. Modules will be installed in /lib/modules.')
-option('machine', type: 'string', value: 'auto', description:
- 'Alias of cpu_instruction_set.')
-option('max_ethports', type: 'integer', value: 32, description:
- 'maximum number of Ethernet devices')
-option('max_lcores', type: 'string', value: 'default', description:
- 'Set maximum number of cores/threads supported by EAL; "default" is different per-arch, "detect" detects the number of cores on the build machine.')
+
+option('enable_docs', type: 'boolean', value: false, description:
+ 'Build documentation.')
+
+option('examples', type: 'string', value: '', description:
+ 'Comma-separated list of examples to build by default.')
+
+option('tests', type: 'boolean', value: true, description:
+ 'Build unit tests.')
+
+option('developer_mode', type: 'feature', description:
+ 'Turn on additional build checks relevant for DPDK developers.')
+
+option('check_includes', type: 'boolean', value: false, description:
+ 'Build chkincs to verify each header file can compile alone.')
+
+# library-specific options
+
option('max_numa_nodes', type: 'string', value: 'default', description:
'Set the highest NUMA node supported by EAL; "default" is different per-arch, "detect" detects the highest NUMA node on the build machine.')
+
+option('max_lcores', type: 'string', value: 'default', description:
+ 'Set maximum number of cores/threads supported by EAL; "default" is different per-arch, "detect" detects the number of cores on the build machine.')
+
option('mbuf_refcnt_atomic', type: 'boolean', value: true, description:
'Atomically access the mbuf refcnt.')
-option('platform', type: 'string', value: 'native', description:
- 'Platform to build, either "native", "generic" or a SoC. Please refer to the Linux build guide for more information.')
-option('enable_trace_fp', type: 'boolean', value: false, description:
- 'enable fast path trace points.')
-option('tests', type: 'boolean', value: true, description:
- 'build unit tests')
+
+option('max_ethports', type: 'integer', value: 32, description:
+ 'Maximum number of Ethernet devices.')
+
option('use_hpet', type: 'boolean', value: false, description:
- 'use HPET timer in EAL')
+ 'Use HPET timer in EAL.')
+
+option('enable_trace_fp', type: 'boolean', value: false, description:
+ 'Enable fast path trace points.')
+
+# driver-specific options
+
+option('flexran_sdk', type: 'string', value: '', description:
+ 'Path to FlexRAN SDK optional libraries for bbdev driver.')
+
+option('ibverbs_link', type: 'combo', choices : ['static', 'shared', 'dlopen'], value: 'shared', description:
+ 'Linkage method (static/shared/dlopen) for Mellanox PMDs with ibverbs dependencies.')
--
2.33.0