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 8743F433D8 for ; Mon, 11 Dec 2023 11:23:24 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 7FE5940FDE; Mon, 11 Dec 2023 11:23:24 +0100 (CET) Received: from NAM10-MW2-obe.outbound.protection.outlook.com (mail-mw2nam10on2086.outbound.protection.outlook.com [40.107.94.86]) by mails.dpdk.org (Postfix) with ESMTP id 31864402E9 for ; Mon, 11 Dec 2023 11:23:23 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=M4UmTAVePAOZZFit2Bx3c59ZQjJykeFi91lnLfVrzvMvQLq9MkNwBmXeyZhlx7uAYbSRuH2JHK9bMbMiRf3BPIymS/HCvlxlJxAheAevsWbhMJ1FORvCpx4/AdLyxhybvqQzj4JvB7rky2FZSdbfbTYWa+/32zZ8YADzKupbpA+p5l/HiWyMc4/jLWA/OlFncydR+xsSBbNVguygoOx3iAvJhQ1c+xv4U9bqxeLYB4cwMJ0TUfpHhGGN7ogAa4fEd54WBa9tt49xSCmieKJLic6YJuH8/DIpZygx8QrbxauHluUR1aPyIZSpAdTRR71cyq5ygyJD5JQm/lH+Y19Zcw== 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=vln8j4INSeWK0hhwHKT6UxKQl602MBzIdR+9/eJQ1pM=; b=fjEe8iUW4VxZ/5p6ttird0MBzdNoALcGbh4vCc3iDSKft+0GtzoFlsmcrc0gq0iJm95533DEj5R8Eboo2oHacykcNV38x8SUdZAOpZ4ghu79Wz+eX/BCGPI1zXh+U43E6T3wPZqdQg4CPQu8rxhSqhi3xsIN93KoS6DLWK2rNCZ4jk5SQAXsD0HbDDwHnl9nCfRbE91x0RehOgNOmNxyALla7F0aq2Hs48UicC93MpSuE6gmGsILLI8YNEg2ghDG5DJtDzbDSDMXkAKKkSrVLGmeRzAZcrPrpzI/VVs6LKzvoRp3fsOWijlpKNdXRC756HOQeNkVjRHb+cWnJ02Mtw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.160) smtp.rcpttodomain=amd.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 (0) 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=vln8j4INSeWK0hhwHKT6UxKQl602MBzIdR+9/eJQ1pM=; b=GsPT2oK8XaKUatEszRGraUYQqBWFJ62JOK1zjhV3Kc4vnj3KLTx/XHka9tgAhISahrTdV2yHvuOKKaQU/dp7APIEzQafimR0scE9cdpjglx5/JUrApIpVBP6plY2H8N+6eukL758XGP588zIwafOh1skh20miuX+3wHj9zRhdEh/ldRo4RAh/OK57wo2J1gT1FV58OO00FB6nFg8XVZA0sKPjQc+rV2r+4ZeWIke1e37TtzeSkBNqw/+8q51OdCU5eMB9/1ZOAznz/ygf4pPqlrAGXdFuNfsi+Z7hsjo8OnZjo9BGmFlNpQB8IxvYFB+ai+crjO6pY1SRLw9syxL3A== Received: from PH8PR22CA0023.namprd22.prod.outlook.com (2603:10b6:510:2d1::21) by CH2PR12MB4309.namprd12.prod.outlook.com (2603:10b6:610:a4::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7068.25; Mon, 11 Dec 2023 10:23:20 +0000 Received: from SA2PEPF000015CB.namprd03.prod.outlook.com (2603:10b6:510:2d1:cafe::4c) by PH8PR22CA0023.outlook.office365.com (2603:10b6:510:2d1::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7068.32 via Frontend Transport; Mon, 11 Dec 2023 10:23:19 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.160) 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.160 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.160; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.160) by SA2PEPF000015CB.mail.protection.outlook.com (10.167.241.201) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7091.18 via Frontend Transport; Mon, 11 Dec 2023 10:23:19 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.66) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.41; Mon, 11 Dec 2023 02:23:04 -0800 Received: from nvidia.com (10.126.231.35) 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.41; Mon, 11 Dec 2023 02:23:02 -0800 From: Xueming Li To: Ferruh Yigit CC: =?UTF-8?q?Morten=20Br=C3=B8rup?= , dpdk stable Subject: patch 'mempool: clarify enqueue/dequeue ops documentation' has been queued to stable release 22.11.4 Date: Mon, 11 Dec 2023 18:12:21 +0800 Message-ID: <20231211101226.2122-117-xuemingl@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20231211101226.2122-1-xuemingl@nvidia.com> References: <20231022142250.10324-1-xuemingl@nvidia.com> <20231211101226.2122-1-xuemingl@nvidia.com> MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8bit X-Originating-IP: [10.126.231.35] X-ClientProxiedBy: rnnvmail201.nvidia.com (10.129.68.8) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SA2PEPF000015CB:EE_|CH2PR12MB4309:EE_ X-MS-Office365-Filtering-Correlation-Id: d31fc51a-3c09-4f28-4ce4-08dbfa33322d X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: z1IdIKmIPrG7omaQP3jDgaamVhc4xWVbzAn85y4mwoAf/8MzTmPRnuv64ePacTt9+O67FXQfdu5nefaTYASRrAqBC5UIDWfwzIbuCbm24rfk6QnwVhbsCI20IfuWIpKF0zkEiMkkaPd6QyeAsSA6RTLHQL7DbvhnHHlUm7/jUkpc/PR2jbgDpN41FNv0oc9g37nzt1dl2m2DTZ19GZsaDH5FdJboMMGxMX0czIZvx49kmDcHm0oxlR3SddfIojX9bI686npnboPWLbpdwIvOh0E0K2LSRoDrUA51RrgyswUOZs4CIT8Z1PD3n8WHcwkGoup0iBkatQP01QsX6ZfYm6vx0ZB7s+Tj2XBhlSKY0VPqa09lvtKWWLHV8rs5YWhlzqxYC7Etmp/o4kgeadueNuzX9tKuB/q2eG3LRhe9USdmh+8hHYGZK/58tZMLC6E0/5VYPLybO4vqu1yf3dO675bV7SUYWYKHAa5ayviMfx68X9IvBJsZlDCACPGbWKe4dzKI7Mij/SyBHoGdc0odw7M0FCgVdlisa/HnK5G5q7F6rsVr1yWCaeSsDdBufzRycqHFtzou66znf7Ei5KsjJwCSQ1kUNZVZRLnJvB3+7I3BmDA8liV0D7Dt7WQ06C7Z2YZoVjXpBwaFrCmsuzjbM6rEFEEvOjzT8ItygtqGt0aDhvn0y1ymr8gXgoCAtJgufb6KBQBXwZ7BwWwEuC93ZQZSeEDYUOZk9chGsMX8PCf0xm1KeMVE7OWVhhZZI3xFw2nqhODeRVYNDh+RkEwnmLtmbTy1waibn3mx2iD2GgZSnX19RU+MK8s7fykmW8qzBTrfrc/XBLjrosfcjjpmXA== X-Forefront-Antispam-Report: CIP:216.228.117.160; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge1.nvidia.com; CAT:NONE; SFS:(13230031)(4636009)(376002)(39860400002)(136003)(396003)(346002)(230173577357003)(230922051799003)(230273577357003)(186009)(82310400011)(1800799012)(451199024)(64100799003)(36840700001)(46966006)(40470700004)(2906002)(4001150100001)(5660300002)(86362001)(36756003)(8936002)(8676002)(4326008)(316002)(70206006)(54906003)(6916009)(70586007)(40480700001)(41300700001)(7636003)(36860700001)(47076005)(356005)(966005)(55016003)(82740400003)(478600001)(1076003)(40460700003)(66574015)(7696005)(83380400001)(426003)(6666004)(53546011)(16526019)(26005)(336012)(6286002)(2616005); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 11 Dec 2023 10:23:19.3756 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: d31fc51a-3c09-4f28-4ce4-08dbfa33322d 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.160]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: SA2PEPF000015CB.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR12MB4309 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.4 Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet. It will be pushed if I get no objections before 12/13/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/commit/?h=22.11-staging&id=3b67c0751162b9a287bc0bab19e83baab486bbad Thanks. Xueming Li --- >From 3b67c0751162b9a287bc0bab19e83baab486bbad Mon Sep 17 00:00:00 2001 From: Ferruh Yigit Date: Mon, 23 Oct 2023 10:38:43 +0100 Subject: [PATCH] mempool: clarify enqueue/dequeue ops documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Xueming Li [ upstream commit 37fc1db98c082d3f423c46bed7357a158abe53e9 ] API documentations doesn't clarify expected return types for enqueue and dequeue mempool_ops, clarifying it. Fixes: 449c49b93a6b ("mempool: support handler operations") Reported-by: Morten Brørup Signed-off-by: Ferruh Yigit Reviewed-by: Morten Brørup --- lib/mempool/rte_mempool.h | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/lib/mempool/rte_mempool.h b/lib/mempool/rte_mempool.h index f1eb2cd2d3..4a8a2d5dcb 100644 --- a/lib/mempool/rte_mempool.h +++ b/lib/mempool/rte_mempool.h @@ -465,13 +465,19 @@ typedef int (*rte_mempool_alloc_t)(struct rte_mempool *mp); typedef void (*rte_mempool_free_t)(struct rte_mempool *mp); /** - * Enqueue an object into the external pool. + * Enqueue 'n' objects into the external pool. + * @return + * - 0: Success + * - <0: Error */ typedef int (*rte_mempool_enqueue_t)(struct rte_mempool *mp, void * const *obj_table, unsigned int n); /** - * Dequeue an object from the external pool. + * Dequeue 'n' objects from the external pool. + * @return + * - 0: Success + * - <0: Error */ typedef int (*rte_mempool_dequeue_t)(struct rte_mempool *mp, void **obj_table, unsigned int n); -- 2.25.1 --- Diff of the applied patch vs upstream commit (please double-check if non-empty: --- --- - 2023-12-11 17:56:26.810443600 +0800 +++ 0116-mempool-clarify-enqueue-dequeue-ops-documentation.patch 2023-12-11 17:56:23.237652300 +0800 @@ -1 +1 @@ -From 37fc1db98c082d3f423c46bed7357a158abe53e9 Mon Sep 17 00:00:00 2001 +From 3b67c0751162b9a287bc0bab19e83baab486bbad Mon Sep 17 00:00:00 2001 @@ -7,0 +8,3 @@ +Cc: Xueming Li + +[ upstream commit 37fc1db98c082d3f423c46bed7357a158abe53e9 ] @@ -13 +15,0 @@ -Cc: stable@dpdk.org @@ -23 +25 @@ -index 1303eef494..95deade160 100644 +index f1eb2cd2d3..4a8a2d5dcb 100644