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 C382043699 for ; Thu, 7 Dec 2023 12:21:49 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id BE8C442EFA; Thu, 7 Dec 2023 12:21:49 +0100 (CET) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mails.dpdk.org (Postfix) with ESMTP id 1D02342EF4 for ; Thu, 7 Dec 2023 12:21:48 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1701948107; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=v4wtL2t7A+sgHHxtc1RzeKg125j2VvO/NUCpsW3cHh8=; b=h3wgBhBgO+n2O0cNt96WRmE71AxkcfCcOfY5pjPIHGPbv0GCYtKNbd7mQtcZ+w71Nk707e ysGZDB2JgR98JKWDnaueCr/XXW9OAMb7qPYvoTogAUY5M3g3u963NVePnW/P7t5c88YPJq VzrzkyoVZYW+Hd9micCctzLLs0eKkf4= Received: from mimecast-mx02.redhat.com (mx-ext.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-575-1ILfR6RBPUC9A9Oz8UDsgA-1; Thu, 07 Dec 2023 06:21:46 -0500 X-MC-Unique: 1ILfR6RBPUC9A9Oz8UDsgA-1 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 6C0D829ABA34; Thu, 7 Dec 2023 11:21:45 +0000 (UTC) Received: from rh.Home (unknown [10.39.192.7]) by smtp.corp.redhat.com (Postfix) with ESMTP id 9DF81C15880; Thu, 7 Dec 2023 11:21:44 +0000 (UTC) From: Kevin Traynor 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 21.11.6 Date: Thu, 7 Dec 2023 11:21:09 +0000 Message-ID: <20231207112116.769502-17-ktraynor@redhat.com> In-Reply-To: <20231207112116.769502-1-ktraynor@redhat.com> References: <20231207112116.769502-1-ktraynor@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.4.1 on 10.11.54.8 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 21.11.6 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/12/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://github.com/kevintraynor/dpdk-stable This queued commit can be viewed at: https://github.com/kevintraynor/dpdk-stable/commit/6faf898f552b2796bfc86d888d2c8438f6c7fde0 Thanks. Kevin --- >From 6faf898f552b2796bfc86d888d2c8438f6c7fde0 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 [ 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 771a3a1e7f..9c27820b7a 100644 --- a/lib/mempool/rte_mempool.h +++ b/lib/mempool/rte_mempool.h @@ -441,5 +441,8 @@ 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, @@ -447,5 +450,8 @@ typedef int (*rte_mempool_enqueue_t)(struct rte_mempool *mp, /** - * 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, -- 2.43.0 --- Diff of the applied patch vs upstream commit (please double-check if non-empty: --- --- - 2023-12-07 11:19:00.010746366 +0000 +++ 0017-mempool-clarify-enqueue-dequeue-ops-documentation.patch 2023-12-07 11:18:59.637873961 +0000 @@ -1 +1 @@ -From 37fc1db98c082d3f423c46bed7357a158abe53e9 Mon Sep 17 00:00:00 2001 +From 6faf898f552b2796bfc86d888d2c8438f6c7fde0 Mon Sep 17 00:00:00 2001 @@ -8,0 +9,2 @@ +[ upstream commit 37fc1db98c082d3f423c46bed7357a158abe53e9 ] + @@ -13 +14,0 @@ -Cc: stable@dpdk.org @@ -23 +24 @@ -index 1303eef494..95deade160 100644 +index 771a3a1e7f..9c27820b7a 100644 @@ -26 +27 @@ -@@ -466,5 +466,8 @@ typedef void (*rte_mempool_free_t)(struct rte_mempool *mp); +@@ -441,5 +441,8 @@ typedef void (*rte_mempool_free_t)(struct rte_mempool *mp); @@ -36 +37 @@ -@@ -472,5 +475,8 @@ typedef int (*rte_mempool_enqueue_t)(struct rte_mempool *mp, +@@ -447,5 +450,8 @@ typedef int (*rte_mempool_enqueue_t)(struct rte_mempool *mp,