From patchwork Wed Nov 24 12:56:42 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Monjalon X-Patchwork-Id: 104667 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.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 ; 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: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvuddrgeekgdegjecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvffufffkofgjfhgggfestdekredtredttdenucfhrhhomhepvfhhohhmrghs ucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenucggtf frrghtthgvrhhnpedvhefgiedvjeegtdevheefhfetleefgfeivefgffevfeejgedtgfeu tdehtdegveenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhroh hmpehthhhomhgrshesmhhonhhjrghlohhnrdhnvght X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 24 Nov 2021 07:56:46 -0500 (EST) From: Thomas Monjalon To: dev@dpdk.org Cc: Bruce Richardson 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 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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 --- 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-', 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.')