From patchwork Mon Oct 23 09:38:43 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Ferruh Yigit X-Patchwork-Id: 133169 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id EEE28431E0; Mon, 23 Oct 2023 11:39:09 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 94AE141149; Mon, 23 Oct 2023 11:39:06 +0200 (CEST) Received: from NAM02-DM3-obe.outbound.protection.outlook.com (mail-dm3nam02on2044.outbound.protection.outlook.com [40.107.95.44]) by mails.dpdk.org (Postfix) with ESMTP id 767B541140; Mon, 23 Oct 2023 11:39:05 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=c9Z53e3tBM0bGqR2LiQnpG24scV44qISiG8LP9/PQFvJlkTkn0+0hcdfYtUDLkLFBwR1Fx9Ore79eIheiHSguj5BiSM1+1paDYjz9zdZTxj6a6UYtsPlFBMvccytad50wXQCUFd5a76tgv96i5jjpXa5V+LNsiI9/rDwMImh0r8R19B27UgDMiLuidcIyGxojQCckcD9dVx9i2OmRXIaWXvzpQIiSks0Oe22pF69DTscPvmY+nuOowzM9Ya01U1RQVsc68Mfy2H3K8vo6/YnwLxCE75XLMDjp+IR+4rMl4Jtatwv/aBv/v3ICjv+FrIdWVzGmARtzK8nnLsFHX/I+w== 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=dXz3YthO36nzQ5yFDuOgFSdqE8JWmKRnTSoaiJ+Pl9w=; b=N8I4S9ML17V13VYTiirfwO7pWdiH03ZwEW4GV2hm/KzYuxui7wQ5xi7vF2t2QsI4VCVEzbCsfEf4ju+iShXH+z2NMUnjUfwxjAeblW8ZijrDpKOorcTbR+Iqw5TI7RZfLLxKFlniX5CM5StRheld5h6AFSnpmWj29I0q1YPgfua83cQvdgsn4wwFtm0X3gbMe6Y0RcaAyvOBM5fSGHGq9qT/Es8yw3jHzSSLQuqQxwIZG4WFfk7HWMxoJXcqRMI34HXEry6JAAq9frIPaf/nC5XCYKTABQ9x1DxaN1ZFu+pPAHHwaoicSCO26Pmyj58yq8urX5Nc0O1VsEsmbzfjMg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 165.204.84.17) smtp.rcpttodomain=oktetlabs.ru smtp.mailfrom=amd.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=amd.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amd.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=dXz3YthO36nzQ5yFDuOgFSdqE8JWmKRnTSoaiJ+Pl9w=; b=pgeEFMNdc/A+rRdQaUGKGaN7uiMuhCb822B83VxYrbhRmA05g4la1tJKIqlopFFoxzIxowHZQTDl2bR4K26b8F1tzSS/BFCcQfNJV+iyh0S8nak29QEK2E9QNaVnxUZW9S9KaWRQhrp744LOvorzM287Ga5YQ1RUin3dDJxoTAk= Received: from DM6PR06CA0040.namprd06.prod.outlook.com (2603:10b6:5:54::17) by SJ1PR12MB6148.namprd12.prod.outlook.com (2603:10b6:a03:459::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6907.26; Mon, 23 Oct 2023 09:39:01 +0000 Received: from CY4PEPF0000EE34.namprd05.prod.outlook.com (2603:10b6:5:54:cafe::ed) by DM6PR06CA0040.outlook.office365.com (2603:10b6:5:54::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6907.33 via Frontend Transport; Mon, 23 Oct 2023 09:39:01 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=amd.com; Received-SPF: Pass (protection.outlook.com: domain of amd.com designates 165.204.84.17 as permitted sender) receiver=protection.outlook.com; client-ip=165.204.84.17; helo=SATLEXMB04.amd.com; pr=C Received: from SATLEXMB04.amd.com (165.204.84.17) by CY4PEPF0000EE34.mail.protection.outlook.com (10.167.242.40) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6933.15 via Frontend Transport; Mon, 23 Oct 2023 09:38:59 +0000 Received: from telcodpdk.amd.com (10.180.168.240) by SATLEXMB04.amd.com (10.181.40.145) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.27; Mon, 23 Oct 2023 04:38:58 -0500 From: Ferruh Yigit To: Andrew Rybchenko , Olivier Matz , David Hunt , Shreyansh Jain CC: , , =?utf-8?q?Morten_Br=C3=B8rup?= Subject: [PATCH v2 2/2] mempool: clarify enqueue and dequeue ops return type Date: Mon, 23 Oct 2023 10:38:43 +0100 Message-ID: <20231023093844.4150572-2-ferruh.yigit@amd.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231023093844.4150572-1-ferruh.yigit@amd.com> References: <20231020144647.1682698-1-ferruh.yigit@amd.com> <20231023093844.4150572-1-ferruh.yigit@amd.com> MIME-Version: 1.0 X-Originating-IP: [10.180.168.240] X-ClientProxiedBy: SATLEXMB03.amd.com (10.181.40.144) To SATLEXMB04.amd.com (10.181.40.145) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: CY4PEPF0000EE34:EE_|SJ1PR12MB6148:EE_ X-MS-Office365-Filtering-Correlation-Id: 3108d700-979b-4590-5785-08dbd3abe2bf X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: x6KwS5oSbvYaEVRfnmwYCbegy28g+BGHxaNVGhxNlTA8dyjPBxaaaX3GLC2XJ3wVExqbgzO5ayq1zON/xR/mbiMZFRIesMNnaScX7hB+Q/E7h+JXMuVpe8CIqjh7Uo25TWRhYjpEFbzwSNy/8PdGNkW7Azg+SrN2V7dn+A7+2JL1lJtWdTVqWTvTSEaU0tgwso0g4DsQzhYkrohOTXqQC4C2RKzNKTztKny3zbTJMCaaSZvxpdI8Q5xTcMVcmZudfrgBSjUrNLv/ouVqfycP9jg6E2qWq5ntG2AB9g0MK2e+//C+UO5ZINHMgvrC2WDYaE2cH8enmjvakNrXlQ9dpjJFJGo5iRqHgb++E4Jj3tKDeKJwl2iAetIHboJW5wv0CmHZvCtFpB5zF6Rbkku9ZrM0mVTvKSMI4X7vde7hrSPAskvgGnUQxkfxFrx7EIsbfA0pAhA/KHB71voC+MzIHJGO2m6ogfHSv1OKuBlWx/6uJy5c846lIY+SStn0ild+mWqy36NlnVp+yTM0mF/ISwDhVpfLFh/z9KNdWWEXzYzZsuRfH5h8fAE53YHR9zyUAsR1YmV1Mr+pYR0ARS9wP7cJYLTzUyVS+In2vf8rmW59KqKXQbjD+WoRbG9M4s75IEYjbrMq0Ces93xQKSmyaoOZdxuj+olsvvQVuOuKnvMf+WRDAwo55dUZu1NoJQAF6bq/dICFYes+srwXIOuNEem5ZvhkaxbYaoT74LosqH3N1DXHDFarg0OaKKO8KurATjQ53n7XnhXV1lNiboerRA== X-Forefront-Antispam-Report: CIP:165.204.84.17; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:SATLEXMB04.amd.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230031)(4636009)(346002)(136003)(39860400002)(376002)(396003)(230922051799003)(451199024)(82310400011)(64100799003)(186009)(1800799009)(46966006)(36840700001)(40470700004)(40460700003)(40480700001)(86362001)(110136005)(70586007)(70206006)(54906003)(41300700001)(5660300002)(316002)(6666004)(7696005)(478600001)(36756003)(8936002)(4326008)(44832011)(8676002)(36860700001)(2906002)(356005)(81166007)(26005)(16526019)(2616005)(426003)(336012)(1076003)(47076005)(82740400003)(83380400001)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Oct 2023 09:38:59.9178 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 3108d700-979b-4590-5785-08dbd3abe2bf X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d; Ip=[165.204.84.17]; Helo=[SATLEXMB04.amd.com] X-MS-Exchange-CrossTenant-AuthSource: CY4PEPF0000EE34.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ1PR12MB6148 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 API documentations doesn't clarify expected return types for enqueue and dequeue mempool_ops, clarifying it. Fixes: 449c49b93a6b ("mempool: support handler operations") Cc: stable@dpdk.org 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 86598bc639e6..8ed0386ba3f1 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);