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 E4E35428F8 for ; Sun, 9 Apr 2023 17:30:48 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id DBC9C427F2; Sun, 9 Apr 2023 17:30:48 +0200 (CEST) Received: from NAM04-DM6-obe.outbound.protection.outlook.com (mail-dm6nam04on2050.outbound.protection.outlook.com [40.107.102.50]) by mails.dpdk.org (Postfix) with ESMTP id 5BF3A4067E for ; Sun, 9 Apr 2023 17:30:47 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=FaZG6MaatfDBIpwVphmjxH1PNw5iMst9smffx3pV9UteRhr+WVNJii45xMIiFGCB7nL+betTEEUgnGWlg8QJFhFYmUCZsRLBcXz3V6b7roDPQD2kco7CYr1VdYCkWJsTZBs8dcupJE7Nn2eqIgEDxFzv9yfYhJpIR28+pPKuUvOadhHTH21yeDdHk30giIjZi9eNqqajFHwwLlowfgiUAFfcovdeyxWDfU+hQhSGoJi0nmul5JLUak3kYBQcQiqsZ88kmVn6sTRL7Qu5OaylL7kGHtLLx9zYwwxWfyzYKQMIMyl2XXAzRn5YnYh+xo6bYxeucwB2ZI6+4eaSUJaGdg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=XmtVhg4jVsKC7Mr/kw1ojv1y6Yvixb4H8ceqYVkmdAY=; b=RaZ4MLaSgeCNMTWzVhkdZ9da9yC4IXPIgA5PRhDbe0fymMc/Lq77T51g6VITA/RPLsyIG6uLWBt2Z3GfuVswHaSwS4gvmvYz8RVCSAxikBAVvKRYk2L8EzgUHarGuURzHNQRRNqZzuLDYHhfQleQhaY+BOjnrGFBMMXERJQv0HUlZdwl9lVVnoiGGC1IJM8/hR6vRMh0dvMi+rLVp79tKAPuOkNjaU9sGWEqA9M3bUEszJBs7TKKT5dA1J+C4UyyIFq3iiBUqxhlpkP3EIVml/reOAroeiw30nSQd/mMxdL1oKWtmdCYZCC+s6kmdi9+FuAcockTopl3gHyeTLXniQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) smtp.rcpttodomain=huawei.com smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=XmtVhg4jVsKC7Mr/kw1ojv1y6Yvixb4H8ceqYVkmdAY=; b=LQ/j53G/ViiB3XqHKQWcsXuuFDVP1GFspLENQAUc6wFHCVXPycqKQOtDnXr5ZsMkx63hvGvY3znolyMjYxh4wu+QiZqQnCgeFm1dIQF08HJhqqju10OtjNyKoS7KvmjPrtC4ENAc6C+Y7IMQGaqwC2tuVzGQJThu4I144ZKOb75NlosVwHfxinZUbLM+i6f+2auiGV8VdodeAn2t0RJvtj2LBCEHinNXKYMPHA/mDmyxQRVCeeOwWSCmuhasNoY0Y8xIGXECDn0z8JLa5oH2nwueVGAviSlfHTFVWAjY1IjBJ5yO5D/Yx627JUS9Gvg/P5nBg3Nnq0Zr1qEM0lLHoA== Received: from DM6PR08CA0022.namprd08.prod.outlook.com (2603:10b6:5:80::35) by IA1PR12MB7710.namprd12.prod.outlook.com (2603:10b6:208:422::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6254.35; Sun, 9 Apr 2023 15:30:45 +0000 Received: from DM6NAM11FT072.eop-nam11.prod.protection.outlook.com (2603:10b6:5:80:cafe::ce) by DM6PR08CA0022.outlook.office365.com (2603:10b6:5:80::35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6277.38 via Frontend Transport; Sun, 9 Apr 2023 15:30:45 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.161) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.117.161 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.161; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.161) by DM6NAM11FT072.mail.protection.outlook.com (10.13.173.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6298.25 via Frontend Transport; Sun, 9 Apr 2023 15:30:44 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.67) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Sun, 9 Apr 2023 08:30:26 -0700 Received: from nvidia.com (10.126.231.37) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.37; Sun, 9 Apr 2023 08:30:25 -0700 From: Xueming Li To: Chengwen Feng CC: Olivier Matz , dpdk stable Subject: patch 'kvargs: add API documentation for process callback' has been queued to stable release 22.11.2 Date: Sun, 9 Apr 2023 23:24:03 +0800 Message-ID: <20230409152529.5308-56-xuemingl@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230409152529.5308-1-xuemingl@nvidia.com> References: <20230227062349.13764-1-xuemingl@nvidia.com> <20230409152529.5308-1-xuemingl@nvidia.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.126.231.37] X-ClientProxiedBy: rnnvmail203.nvidia.com (10.129.68.9) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: DM6NAM11FT072:EE_|IA1PR12MB7710:EE_ X-MS-Office365-Filtering-Correlation-Id: 0362fa3b-4545-4c71-c880-08db390f6284 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: +ccuS8r1ow4Q2iW56pFRfFYebaAR7/YzrBJTwLnJcJaPYDeKRi+GYLy4fIyPREt9hJXNOnE3cOCAThXjNq5yYo4XX4iwt3FK3Dv6kdK4Ozd1vL6KLa6FaXxftTcDjser5jLM5/PsoCi3vz+s04Uy+09oxAPWQ1f3PHmmVHGdG/KIQ0/SQMje1vjL79qZh8YSsHr/7EW2rR0pVzxVqmsOmzI9hQBxcUFqYVjsfb0Cf48+q6Cf/fOoDwHKUJLOQL9vi/0QKMOC1Lc36SOkmGM24ueCjh33jWBq676goXOG9tVk5voQU1TFHCHTdfH3mzK4klDh0IWI1JkeVbmGqNT8WSh+BYofSdAVt/CwqGgoYqFl9qqWdFJH3H26yixezv5PJuyafT4hfCSaLQLgmLCvB6rQ6qed9M7uPTMiJcKCp15YseZHRnVFLInG65LG8DUZqwKKRlhTqzsVCoCZbiXnyuVw7yCxBrU8guE+ejyGGCbBUwT6r/JK6O/4TOSYrvVn8NbfznMcQ6uCy78jiglfTcXPrRHUJrhFhMvwukmjzZdQJnX57Pl0dL6yC+NHqn5h3ZiGlm/n6UPOzMuV5yUJXY1yGTSxvPRtyOFvlWFyHUJETyDXlBfZ0ve/p1cSUoauFujUEAVEXOXBeI4GD/7kV9aDhlqG74LeFucQa6rc/SKrDsjqPZf7EEXhHzBa8q1JzH9dA/SRAtRG3EP+JSRKFDwxQ+pBNpe+cTMNMmEPPax4uigdbVQDKl0V8aNzkZuFF6BNUqkOkpEnbkMHL/ji+QcU/PcGgdL71qbDM/BhBFYmrwZYTilz52amCq5vJVq6knEwPHhD2vFc8+9ihgavCA== X-Forefront-Antispam-Report: CIP:216.228.117.161; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge2.nvidia.com; CAT:NONE; SFS:(13230028)(4636009)(346002)(376002)(136003)(39860400002)(396003)(451199021)(46966006)(36840700001)(40470700004)(316002)(336012)(36860700001)(966005)(82740400003)(47076005)(2616005)(426003)(83380400001)(6286002)(478600001)(1076003)(16526019)(53546011)(7696005)(186003)(6666004)(26005)(54906003)(6916009)(40480700001)(5660300002)(2906002)(40460700003)(36756003)(55016003)(4326008)(41300700001)(70586007)(8936002)(86362001)(70206006)(7636003)(356005)(8676002)(82310400005); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Apr 2023 15:30:44.1812 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 0362fa3b-4545-4c71-c880-08db390f6284 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.161]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: DM6NAM11FT072.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: IA1PR12MB7710 X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org Hi, FYI, your patch has been queued to stable release 22.11.2 Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet. It will be pushed if I get no objections before 04/11/23. So please shout if anyone has objections. Also note that after the patch there's a diff of the upstream commit vs the patch applied to the branch. This will indicate if there was any rebasing needed to apply to the stable branch. If there were code changes for rebasing (ie: not only metadata diffs), please double check that the rebase was correctly done. Queued patches are on a temporary branch at: https://git.dpdk.org/dpdk-stable/log/?h=22.11-staging This queued commit can be viewed at: https://git.dpdk.org/dpdk-stable/log/?h=22.11-staging/commit/6567e0cf763b4a317e2c97ee1d342f1ced4fca88 Thanks. Xueming Li --- >From 6567e0cf763b4a317e2c97ee1d342f1ced4fca88 Mon Sep 17 00:00:00 2001 From: Chengwen Feng Date: Thu, 2 Mar 2023 07:50:04 +0000 Subject: [PATCH] kvargs: add API documentation for process callback Cc: Xueming Li [ upstream commit 52ab17efdecf935792ee1d0cb749c0dbd536c083 ] The rte_kvargs_process() is used to parse KV pairs, it also supports to parse 'only keys' (e.g. socket_id) type. And the callback function (which prototype is arg_handler_t) parameter 'value' is NULL when parsing 'only keys'. But there is no detailed definition of 'value' may be NULL, so this patch adds it. Signed-off-by: Chengwen Feng Acked-by: Olivier Matz --- lib/kvargs/rte_kvargs.h | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/lib/kvargs/rte_kvargs.h b/lib/kvargs/rte_kvargs.h index 359a9f5b09..4900b750bc 100644 --- a/lib/kvargs/rte_kvargs.h +++ b/lib/kvargs/rte_kvargs.h @@ -36,7 +36,19 @@ extern "C" { /** separator character used between key and value */ #define RTE_KVARGS_KV_DELIM "=" -/** Type of callback function used by rte_kvargs_process() */ +/** + * Callback prototype used by rte_kvargs_process(). + * + * @param key + * The key to consider, it will not be NULL. + * @param value + * The value corresponding to the key, it may be NULL (e.g. only with key) + * @param opaque + * An opaque pointer coming from the caller. + * @return + * - >=0 handle key success. + * - <0 on error. + */ typedef int (*arg_handler_t)(const char *key, const char *value, void *opaque); /** A key/value association */ -- 2.25.1 --- Diff of the applied patch vs upstream commit (please double-check if non-empty: --- --- - 2023-04-09 21:45:40.205453500 +0800 +++ 0055-kvargs-add-API-documentation-for-process-callback.patch 2023-04-09 21:45:38.669042200 +0800 @@ -1 +1 @@ -From 52ab17efdecf935792ee1d0cb749c0dbd536c083 Mon Sep 17 00:00:00 2001 +From 6567e0cf763b4a317e2c97ee1d342f1ced4fca88 Mon Sep 17 00:00:00 2001 @@ -4,0 +5,3 @@ +Cc: Xueming Li + +[ upstream commit 52ab17efdecf935792ee1d0cb749c0dbd536c083 ] @@ -13,2 +15,0 @@ - -Cc: stable@dpdk.org