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 1DC03438FC; Fri, 19 Jan 2024 08:48:42 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id D5198402D9; Fri, 19 Jan 2024 08:48:41 +0100 (CET) Received: from mgamail.intel.com (mgamail.intel.com [192.55.52.88]) by mails.dpdk.org (Postfix) with ESMTP id A0EA140EDF for ; Thu, 18 Jan 2024 09:58:19 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1705568299; x=1737104299; h=from:to:cc:subject:date:message-id:mime-version; bh=OgFuwT/xv+d1Q+jLz/njKE11B+jPcOG4cOP+G+dMKP4=; b=Wdv9CG/8kkC13HGkzjZJBqLxM8cEoLUkHTCNUicThFJHOok7X7ikXfRR GU+2cxEehVLR0Oi0qFySNKdtSpxFKRrSi3u2eoDy05jQczLWe5K1w73tP 5InrLVCT7J0Z+TJQnl6sHkjojBd2xCEbLZPoLgBBcv09yfptbwGyzQDd4 iVotMnnpyk3CvSCHpnqnUiksdxKGKYGVtuFOS8H2NEdZulafPuZxHZOeV 2IUiKLOAfO08bY+GebwUM0+RCU97HHAHiDkvBEzpN5f2zjlxtzA0qmkUJ xM+lRVvJ9/hodGwyL9H1sA62yv7tH6eSiJ6ueZjYyBhgMdZJR24LRkbNT w==; X-IronPort-AV: E=McAfee;i="6600,9927,10956"; a="431548063" X-IronPort-AV: E=Sophos;i="6.05,201,1701158400"; d="scan'208,217";a="431548063" Received: from orviesa005.jf.intel.com ([10.64.159.145]) by fmsmga101.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 18 Jan 2024 00:58:18 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.05,201,1701158400"; d="scan'208,217";a="256440" Received: from fmsmsx601.amr.corp.intel.com ([10.18.126.81]) by orviesa005.jf.intel.com with ESMTP/TLS/AES256-GCM-SHA384; 18 Jan 2024 00:58:18 -0800 Received: from fmsmsx610.amr.corp.intel.com (10.18.126.90) by fmsmsx601.amr.corp.intel.com (10.18.126.81) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35; Thu, 18 Jan 2024 00:58:17 -0800 Received: from fmsedg601.ED.cps.intel.com (10.1.192.135) by fmsmsx610.amr.corp.intel.com (10.18.126.90) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35 via Frontend Transport; Thu, 18 Jan 2024 00:58:17 -0800 Received: from NAM11-CO1-obe.outbound.protection.outlook.com (104.47.56.169) by edgegateway.intel.com (192.55.55.70) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2507.35; Thu, 18 Jan 2024 00:58:17 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=NVYeLvfkcNtNa0UemNLJThucQxmvlp5tloZp+9HEwbsjCwXiy2/hG7OOcbgbsQVIoy3qos+RQq+FD1rZyN02sofBsZ07RkNfuLEb2e85Exd5lKh9hlvgApd9gx0B676LjF4UOgmorzAD77e6oqkGPb3uJYymRaeL2iMOlK78lKj+jtbwNqlA1rAvVR0vPHSGsl7dRa8HqfkqaHAxU8V/+K+1+sBLGjhXrtVEn5SvXXYqHUqbdZU/oPqvJ6rWwH5RTNSoPUI8Zgpz3vI7zRBs4dB3HoMaP0wAjUkEZulpCvC3Bub9ez5RZPru7qt8kssFVPJaFTkXKhXT7diRi5zUUw== 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=87UW4hiteYyq491uD4GU0+dnFBylel8CMcnEWB6rHUk=; b=V/BBya6hqea3l53n7VEG+fYv2SzATxOGZl0gngdzIndjX8Mhx59F764S/iCuhjkI8nZFwSkii+O9kL5lxhlaXeUuVOBN8cHEfVl61wyG4oLKe7wad3wwIiseoquEhiuOxWruxj6HWNwUyThQZ86iTodfhMeHt03Uf4v9Rp3oKsmIuowmqfwFHBkoENOtWWzkK6ogskpVuppFNmiaNw/+07MsljABkj4cmx03s5htLFeWKz3xYvhjhaquWFPeUY0THruJZ2tJaw3SGeM6+oybJB9X+bVUao+S+zZEN5FzgDwKXJ1M2ovCaE5pWHxfWfP2/tzKRjd4JSId3GkalarfYQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none Received: from DM6PR11MB4444.namprd11.prod.outlook.com (2603:10b6:5:1de::19) by PH7PR11MB8011.namprd11.prod.outlook.com (2603:10b6:510:24a::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7202.23; Thu, 18 Jan 2024 08:58:15 +0000 Received: from DM6PR11MB4444.namprd11.prod.outlook.com ([fe80::909d:c1cb:f770:a13c]) by DM6PR11MB4444.namprd11.prod.outlook.com ([fe80::909d:c1cb:f770:a13c%4]) with mapi id 15.20.7202.024; Thu, 18 Jan 2024 08:58:14 +0000 From: "Wang, Songyi" To: "dev@dpdk.org" CC: "Dong, Yao" Subject: Comments/Doc error for CRYPTODEV of DPDK Thread-Topic: Comments/Doc error for CRYPTODEV of DPDK Thread-Index: AdpJ61fyDdqaHUkmQo67regIPipcJw== Date: Thu, 18 Jan 2024 08:58:14 +0000 Message-ID: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: DM6PR11MB4444:EE_|PH7PR11MB8011:EE_ x-ms-office365-filtering-correlation-id: a59c950c-744e-4f1d-042c-08dc18039b2c x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: iw3zWXLBEYKsrEPGV9+UkbmuAPXAJh2zGinMK8wKiIr2brQDZgFRWIv8Rf61/hbsAYum7wz6kT4RRiTPoFGFkdq5VDcKZwupmmMI8ucKgxOoxCvC/cEo4XythH/TKF7vGj2OETQuncNMZh3mXoWfFggaS01YY4FeVFlsjXLC6nCuV9wBml/AVmIh801BCTSKsBQBrtU0RFJD02UNQmOUwTXOsPeFFRfAlMVxBw3wCTZExGJCbWoz97HMecywzyH9D9eY05UoJ+JlKSU2koooAwReg3jFjRyofKcIEELVtL+6tF1hsDV6kQu+zm32UcFWSL/dhhnowuQ90SRRZg97nua71cYFBcKrLxsGfnUbnvXlnDCj6CjgTxVoX02AxJvcNh7dmkniLeoli2tszjDucDOrQmU6Qj+WghClGJHo8oU4HyhBcJk8CZRvSMcf9o40IuReqFes3j2nvaczZKhfOXHrx95fHUVKuInhRLWHBDTQf9YdPbxkwH2tgfKUF7el9QQEAGT/Tm0u5UVHO5yrHnTMDFkB1SDfHcEgx7ZoBHqgkK6Gkf9e3u1rUOGG4DxjuNkf2nHx61VnM6R1tyhOfcO1VSh2n3S4Nwsl68zHRblMmgyR53PM7FQSZacQ477k x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM6PR11MB4444.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(366004)(346002)(136003)(376002)(39860400002)(396003)(230922051799003)(64100799003)(186009)(451199024)(1800799012)(4326008)(26005)(52536014)(5660300002)(9686003)(2906002)(71200400001)(6506007)(7696005)(107886003)(64756008)(66556008)(66446008)(6916009)(66946007)(316002)(76116006)(8936002)(8676002)(41300700001)(66476007)(86362001)(478600001)(38070700009)(33656002)(82960400001)(38100700002)(122000001)(83380400001)(55016003); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?yo12vOXgq8At4A4Bm7VfZjYRvHUTYCvyS3rU4XZY6cSFe3QlM0j+XYCQyI2w?= =?us-ascii?Q?U8D+QJEny4NePsi+95nfBbw20Z1MM5/eG6HnqzOG0BGheIaferclXS59FOS9?= =?us-ascii?Q?couY+lVp+ZYjecCYOmkwPdjCLu1s3I54HJlzVuKjiWdMbo0/dg3Infrjmskq?= =?us-ascii?Q?HsfCbEGht2VRT/4vPyaC9GcNyNEscmyP588zfyNaeLPkk39r3oqS2TYAFSpB?= =?us-ascii?Q?IT4y/7MaO7oGoWhDTPCbD5pV8+5Cfb0KnoleW7gH/qha0QvFoLpKNcfezc/m?= =?us-ascii?Q?OQUMZ87p+4sNlL0XKUFD1eflKfibSSJrYbgoJ53+A8tZzR09IRTK6U5R47Or?= =?us-ascii?Q?qHHFO+PLlD7lCZSfP88IWS+8x4uLuFaEnKWuQK4aTgxNfZ0GfdpFqHA6Oinv?= =?us-ascii?Q?YmmP9esri/2Mk33xi/Dt/onF0HKPHUQ81wgbMOJNc0ySBLNns3fcPu007e6x?= =?us-ascii?Q?vnXDdiocekV/GzFD4zDaOzAA/F1qRBRwtSVpP0cvSrKHd1IbeeB/05tPBQ39?= =?us-ascii?Q?5IngFGW5EppqCLqR+kel17JJ5Zad1dlGt1pp0J4gzcCO4nJWy64ruKToRH2r?= =?us-ascii?Q?WcO40PkRssOAq13bI7PLV8lQZwlnT5LOyHiTgMEpB7qVe6NHs2TZ/FTzc8WC?= =?us-ascii?Q?K5VzBnFS69QtS0/HbwzGpV+29Jworj5J7P7R12iMq/U5JP/eI8Uebg9b4qJV?= =?us-ascii?Q?xdvSnSZRRr/S47YxJKtW51jbpbYthGnbORgg95O25Oj00volW/WS3Hp3OexE?= =?us-ascii?Q?QcWULTgRDl7NbR3J1GG8Elqs88u6IAdnGKqvzrnW0o8F303PEA60IJKsFrSj?= =?us-ascii?Q?lgdk7DDnmaPqTNxLOfheKUFdSBlA0ki5s1yX5qhODtLgQVjQU378PMPyeL+0?= =?us-ascii?Q?Vz5gd584Ibl4hLuAhlkU3dPi0hXE1JAP/bnCiWjB/EsZivKTtVahH3CFhQfp?= =?us-ascii?Q?m9PNFMkmUM1oTrSqHLxooldsawoNb1siSGcAoGCXw8vheK9Br6e6p4k2dnUM?= =?us-ascii?Q?7naRWYSkttdIT50E8qiCLT0Pcudf8P8UztqObG7ArPB8nB3s0WVapdkctEFF?= =?us-ascii?Q?kE6mXhHfRFIGPoV2uGUyGBmCs0avstK7SxXY8HVng7qD/kK/fUB0T0m5JLRz?= =?us-ascii?Q?cD/G4K+KS4hGj7UP7mnOj5/mo3RG990olowPJkbggohRoKIxzBfIKwvincR4?= =?us-ascii?Q?dcz7DxIDFkqwjA/BfB9f9+Gtsh7r45SV8BwsYAyUMiWjwJh3NwWVgkNSpLhs?= =?us-ascii?Q?Ej/Fv03ixiiaI8i8UCi1QembaS/+hNjJdYYx5CBDRh3wDdOULeloJpm7RQM1?= =?us-ascii?Q?1a+RNWkD6QuDm2brtDgw5kBCZru4ZqjohPLjBYjL98B3W5PLRxyiqNazUpjd?= =?us-ascii?Q?4SQkvVQaqaH3J3wEbtsbqtBs3py9UzV0eNAC7M2AAS1x1sqxiS+0DrWt3MFj?= =?us-ascii?Q?RgS25jjYfht1jq/A8YzGzcHD3aFQtTMRH+Pwlv2eBxeuY25wkxATgwrY8+PC?= =?us-ascii?Q?7+VItLxRLlde3O1iUKrmTTMYS/RWbn3Wvyb7w2onjsgTMjDXSNDUeTeJ0o5N?= =?us-ascii?Q?bTe+zi6f9UM6H0mVzsjjYc7/EK/jWqtWDIdb2IJH?= Content-Type: multipart/alternative; boundary="_000_DM6PR11MB4444EC66205D293200A10ECCFB712DM6PR11MB4444namp_" MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DM6PR11MB4444.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: a59c950c-744e-4f1d-042c-08dc18039b2c X-MS-Exchange-CrossTenant-originalarrivaltime: 18 Jan 2024 08:58:14.6457 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: p9ulEREW15MfYHitO69qZ+7C7zJFvXyh+S826VF+OKb+Gc8S27A03jRqOrGwOfFTQZGN0P8xsZfETcXfX5R1gQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH7PR11MB8011 X-OriginatorOrg: intel.com X-Mailman-Approved-At: Fri, 19 Jan 2024 08:48:40 +0100 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 --_000_DM6PR11MB4444EC66205D293200A10ECCFB712DM6PR11MB4444namp_ Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Hi maintainer of DPDK, I've noticed an error on comment of DPDK version 23.11 rte_cryptodev.h: 928= -930 /** * Create a symmetric session mempool. * * @param name * The unique mempool name. * @param nb_elts * The number of elements in the mempool. * @param elt_size * The size of the element. This value will be ignored if it is smaller t= han * the minimum session header size required for the system. For the user = who * want to use the same mempool for sym session and session private data = it * can be the maximum value of all existing devices' private data and ses= sion * header sizes. * @param cache_size * The number of per-lcore cache elements * @param priv_size * The private data size of each session. * @param socket_id * The *socket_id* argument is the socket identifier in the case of * NUMA. The value can be *SOCKET_ID_ANY* if there is no NUMA * constraint for the reserved zone. * * @return * - On success return size of the session * - On failure returns 0 */ __rte_experimental struct rte_mempool * rte_cryptodev_sym_session_pool_create(const char *name, uint32_t nb_elts, uint32_t elt_size, uint32_t cache_size, uint16_t priv_size, int socket_id); But the return value of this function seems to be a pointer to the mempool = created or NULL pointer, instead of the mempool size. Could you please check it? Thank you and BR, Songyi --_000_DM6PR11MB4444EC66205D293200A10ECCFB712DM6PR11MB4444namp_ Content-Type: text/html; charset="us-ascii" Content-Transfer-Encoding: quoted-printable

Hi maintainer of DPDK,

 

I’ve noticed an error on comment of DPDK versi= on 23.11 rte_cryptodev.h: 928-930

 

/**

 * Create a symmetric session mempool.=

 *

 * @param name

 *   The unique mempool name.

 * @param nb_elts=

 *   The number of elements in the mempool.<= o:p>

 * @param elt_size

 *   The size of the element. This value will be ignored if i= t is smaller than

 *   the minimum session header size required for the system.= For the user who

 *   want to use the same mempool for sym session and session= private data it

 *   can be the maximum value of all existing devices' privat= e data and session

 *   header sizes.

 * @param cache_size

 *   The number of per-lcore cache elements<= o:p>

 * @param priv_size

 *   The private data size of each session.<= o:p>

 * @param socket_id

 *   The *socket_id* argument is the socket identifier in the= case of

 *   NUMA. The value can be *SOCKET_ID_ANY* if there is no NU= MA

 *   constraint for the reserved zone.<= /o:p>

 *

 * @return

 *  - On success return size of the session<= span style=3D"font-size:16.0pt;font-family:Consolas;color:black;mso-ligatur= es:none">

 *  - On failure returns 0

 */

__rte_experimental

struct rte_mempool *

rte_cryptodev_sym_session_pool_create(const char *name, uint32_t nb_elts,

    uint32_t elt_size, uint32_t cache_size, uint16_t priv_size,

    int socket_id);

 

 

But the return value of this function seems to be a pointer to the memp= ool created or NULL pointer, instead of the mempool size.

 

Could you please check it?

 

Thank you and BR,

Songyi

--_000_DM6PR11MB4444EC66205D293200A10ECCFB712DM6PR11MB4444namp_--