Cover Detail
Show a cover letter.
GET /api/covers/444/?format=api
{ "id": 444, "url": "http://patchwork.dpdk.org/api/covers/444/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/cover/20231128140745.595481-1-euan.bourke@intel.com/", "project": { "id": 1, "url": "http://patchwork.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20231128140745.595481-1-euan.bourke@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20231128140745.595481-1-euan.bourke@intel.com", "date": "2023-11-28T14:07:40", "name": "[24.03,v2,0/5] add new command line argument parsing library", "submitter": { "id": 3231, "url": "http://patchwork.dpdk.org/api/people/3231/?format=api", "name": "Euan Bourke", "email": "euan.bourke@intel.com" }, "mbox": "http://patchwork.dpdk.org/project/dpdk/cover/20231128140745.595481-1-euan.bourke@intel.com/mbox/", "series": [ { "id": 30412, "url": "http://patchwork.dpdk.org/api/series/30412/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=30412", "date": "2023-11-28T14:07:40", "name": "add new command line argument parsing library", "version": 2, "mbox": "http://patchwork.dpdk.org/series/30412/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/covers/444/comments/", "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "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])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 8A7D743402;\n\tWed, 29 Nov 2023 17:06:38 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 09080409FA;\n\tWed, 29 Nov 2023 17:06:38 +0100 (CET)", "from mgamail.intel.com (mgamail.intel.com [134.134.136.24])\n by mails.dpdk.org (Postfix) with ESMTP id 3844942D89\n for <dev@dpdk.org>; Tue, 28 Nov 2023 15:08:04 +0100 (CET)", "from fmsmga001.fm.intel.com ([10.253.24.23])\n by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 28 Nov 2023 06:07:48 -0800", "from unknown (HELO silpixa00400630.ir.intel.com) ([10.237.213.151])\n by fmsmga001.fm.intel.com with ESMTP; 28 Nov 2023 06:07:47 -0800" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1701180484; x=1732716484;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=xjBusURUrvjgLo+hBoTbS17BhJ49OKh53HUN3Eq+stI=;\n b=OU2/ZO4uwirjWSa/W0/OtrqsO7psHLERgUWZcLEKEdVpCV4LUZTrD1aL\n bBLgzW2AXB+AlvRiZltsqdaTVjiywgyvEAb0j9cnKHwIBHF+/m89iDk91\n awFKCzdBq+Oxn0vIYx4q2o+9aQj5QGvhwa1dFkN3cjqIx9x6UsmaZJtrS\n u25v/TrZ9u4wUDNw7D9cKxLC3rbF8v58cEmLQKF191VSlwRrB4YRiSvUV\n DRjJd18ASk58hxBDBnfJxHAcsIBvSI71tEt3+b6MGlivoViCz50z2vkuQ\n 9xFCJW0EZgaA/LKk3d9WhMHnh8+mDP+/8iZvXt5qLMbdWqyQvdjZtTg8O w==;", "X-IronPort-AV": [ "E=McAfee;i=\"6600,9927,10907\"; a=\"395747313\"", "E=Sophos;i=\"6.04,234,1695711600\"; d=\"scan'208\";a=\"395747313\"", "E=McAfee;i=\"6600,9927,10907\"; a=\"912450867\"", "E=Sophos;i=\"6.04,234,1695711600\"; d=\"scan'208\";a=\"912450867\"" ], "X-ExtLoop1": "1", "From": "Euan Bourke <euan.bourke@intel.com>", "To": "dev@dpdk.org", "Cc": "Euan Bourke <euan.bourke@intel.com>", "Subject": "[PATCH 24.03 v2 0/5] add new command line argument parsing library", "Date": "Tue, 28 Nov 2023 14:07:40 +0000", "Message-Id": "<20231128140745.595481-1-euan.bourke@intel.com>", "X-Mailer": "git-send-email 2.34.1", "In-Reply-To": "<20231122164550.3873633-1-euan.bourke@intel.com>", "References": "<20231122164550.3873633-1-euan.bourke@intel.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "X-Mailman-Approved-At": "Wed, 29 Nov 2023 17:06:36 +0100", "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>,\n <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>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "A recent thread on the mailing list[1] discussed corelist and coremask\nparsing and the idea of a new library dedicated to command line parsing\nwas mentioned[2]. This patchset adds the library, along with the new\nAPIs, edits to EAL functions to call the API instead of implementing\ntheir own, and changes to the dlb2 driver to call the API.\n\nThe new APIs work similar to existing functions in EAL, however instead\nof filling a core array like this:\n[1, -1, -1, 2, 3] (a non -1 refers to an 'active core' at that index)\nIt fills it like this:\n[0, 3, 4] (with the value at each index being an 'active core').\n\nThe new APIs will also return the number of cores contained in the\npassed corelist/coremask, so in the above example, 3 would be returned.\n\nPlanned future work for the library contains more parsing functions such\nas a \"core string parser\" which would take a string and return whether\nits a corelist or coremask based on heuristics. This could then be\npassed into the appropriate function.\n\nThere are also several example applications that implement their own\nversion of a corelist/coremask parser, so the plan is to rework those in\nfuture versions of this patch.\n\n[1] https://mails.dpdk.org/archives/dev/2023-November/280957.html\n[2] https://mails.dpdk.org/archives/dev/2023-November/280966.html\n\n\nv2:\n* changes to EAL service core related parsers to call API.\n* various optimisations in core_bit related functions in arg_parser.c.\n* add lib to list for windows build.\n* minor changes for issues flagged during review.\n\nEuan Bourke (5):\n arg_parser: new library for command line parsing\n arg_parser: add new coremask parsing API\n eal: add support for new arg parsing library\n eal: update to service core related parsers\n event/dlb2: add new arg parsing library API support\n\n .mailmap | 1 +\n MAINTAINERS | 4 +\n doc/api/doxy-api-index.md | 3 +-\n doc/api/doxy-api.conf.in | 1 +\n drivers/event/dlb2/dlb2_priv.h | 4 +-\n drivers/event/dlb2/pf/base/dlb2_resource.c | 51 ++--\n lib/arg_parser/arg_parser.c | 170 ++++++++++++\n lib/arg_parser/meson.build | 7 +\n lib/arg_parser/rte_arg_parser.h | 98 +++++++\n lib/arg_parser/version.map | 11 +\n lib/eal/common/eal_common_options.c | 291 +++++----------------\n lib/eal/meson.build | 2 +-\n lib/meson.build | 2 +\n 13 files changed, 378 insertions(+), 267 deletions(-)\n create mode 100644 lib/arg_parser/arg_parser.c\n create mode 100644 lib/arg_parser/meson.build\n create mode 100644 lib/arg_parser/rte_arg_parser.h\n create mode 100644 lib/arg_parser/version.map" }