From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 4068C4369D; Thu, 7 Dec 2023 17:18:38 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id C5EFC42F04; Thu, 7 Dec 2023 17:18:37 +0100 (CET) Received: from mgamail.intel.com (mgamail.intel.com [134.134.136.24]) by mails.dpdk.org (Postfix) with ESMTP id 1F52542E2D for ; Thu, 7 Dec 2023 17:18:36 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1701965917; x=1733501917; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=grT6CChLLVUp9zOs6HBcXoaFqGqNvYvOqyAnrz/eF7k=; b=VBRlIGLvkNJCfz3CnotZ0I6vIDwcIKCvW80ZnfVtzeMFcShOx4TrddkS 7tN1tGAGh8GhYg+eSpag4g4Z05ZO35LKiabmGmypRjL68TbxN7TmOSo+Z 5Kg4ItH7kbg4iMhbCFMNZH2xFwlydaXAEXYszL15rtTE/7IyYbQJD95HE HwO3IkfpPGs+u51Q3N525G7n9GrmVXB6+gV2/sNXzpSQwS7aooCaiFOmU su1K+ZKH1X7makk16mpADL5u4M/HE1rzpnYTIrcA43VFM5is2Z863fBXQ 5jxSiwrYpDDP7/8doLaq4WklH/q3ev2Fku1UD0rTxTYcMyQF0RRVkAJGy A==; X-IronPort-AV: E=McAfee;i="6600,9927,10917"; a="397048598" X-IronPort-AV: E=Sophos;i="6.04,256,1695711600"; d="scan'208";a="397048598" Received: from orsmga007.jf.intel.com ([10.7.209.58]) by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 07 Dec 2023 08:18:35 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10917"; a="765153943" X-IronPort-AV: E=Sophos;i="6.04,256,1695711600"; d="scan'208";a="765153943" Received: from unknown (HELO silpixa00400630.ir.intel.com) ([10.237.213.151]) by orsmga007.jf.intel.com with ESMTP; 07 Dec 2023 08:18:33 -0800 From: Euan Bourke To: dev@dpdk.org Cc: Euan Bourke Subject: [PATCH v3 0/8] add new command line argument parsing library Date: Thu, 7 Dec 2023 16:18:10 +0000 Message-Id: <20231207161818.2590661-1-euan.bourke@intel.com> X-Mailer: git-send-email 2.34.1 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org A recent thread on the mailing list[1] discussed corelist and coremask parsing and the idea of a new library dedicated to command line parsing was mentioned[2]. This patchset adds the library, along with the new APIs, and edits the existing EAL, DLB2 driver and some example application functions to use these APIs, rather than each implementing their own copies. The new APIs work similar to the existing functions in EAL, however instead of filling a core array like this: [1, -1, -1, 2, 3] (a non -1 refers to an 'active core' at that index) It fills it like this: [0, 3, 4] (with the value at each index being an 'active core'). The new APIs will also return the number of cores contained in the passed corelist/coremask, so in the above example, 3 would be returned. New in the v3, is a heuristic parser which searches for key markers in the core string, returning a enum value based off this search to indicate if a parameter is likely a coremask or a corelist. This heuristic function is also wrapped in a parser function allowing apps to handle both coremasks and corelists simultaneously. [1] https://mails.dpdk.org/archives/dev/2023-November/280957.html [2] https://mails.dpdk.org/archives/dev/2023-November/280966.html v3: * new 'combined core string parser' and 'heuristic parser' * changes to eventdev_pipeline and l3fwd-power example applications * various struct optimisations in arg_parser.c * fix for windows build relating to RTE_SWAP() * minor changes for issues flagged during review v2: * changes to EAL service core related parsers to call API. * various optimisations in core_bit related functions in arg_parser.c. * add lib to list for windows build. * minor changes for issues flagged during review. Euan Bourke (8): arg_parser: new library for command line parsing arg_parser: add new coremask parsing API eal: add support for new arg parsing library eal: update to service core related parsers event/dlb2: add new arg parsing library API support arg_parser: added common core string and heuristic parsers examples/eventdev_pipeline: update to call arg parser API examples/l3fwd-power: update to call arg parser API .mailmap | 1 + MAINTAINERS | 4 + doc/api/doxy-api-index.md | 3 +- doc/api/doxy-api.conf.in | 1 + drivers/event/dlb2/dlb2_priv.h | 4 +- drivers/event/dlb2/pf/base/dlb2_resource.c | 51 ++-- examples/eventdev_pipeline/main.c | 65 +---- examples/eventdev_pipeline/pipeline_common.h | 1 + examples/l3fwd-power/perf_core.c | 51 +--- lib/arg_parser/arg_parser.c | 229 +++++++++++++++ lib/arg_parser/meson.build | 7 + lib/arg_parser/rte_arg_parser.h | 160 +++++++++++ lib/arg_parser/version.map | 13 + lib/eal/common/eal_common_options.c | 285 ++++--------------- lib/eal/meson.build | 2 +- lib/meson.build | 2 + 16 files changed, 513 insertions(+), 366 deletions(-) create mode 100644 lib/arg_parser/arg_parser.c create mode 100644 lib/arg_parser/meson.build create mode 100644 lib/arg_parser/rte_arg_parser.h create mode 100644 lib/arg_parser/version.map -- 2.34.1