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 6A82846AF5; Sat, 5 Jul 2025 09:59:03 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 436194028C; Sat, 5 Jul 2025 09:59:03 +0200 (CEST) Received: from dkmailrelay1.smartsharesystems.com (smartserver.smartsharesystems.com [77.243.40.215]) by mails.dpdk.org (Postfix) with ESMTP id 7650140287 for ; Sat, 5 Jul 2025 09:59:01 +0200 (CEST) Received: from smartserver.smartsharesystems.com (smartserver.smartsharesys.local [192.168.4.10]) by dkmailrelay1.smartsharesystems.com (Postfix) with ESMTP id 23C0221276; Sat, 5 Jul 2025 09:59:00 +0200 (CEST) Content-class: urn:content-classes:message Subject: RE: [RFC] ethdev: TX mbuf fast release optimization MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Date: Sat, 5 Jul 2025 09:58:58 +0200 X-MimeOLE: Produced By Microsoft Exchange V6.5 Message-ID: <98CBD80474FA8B44BF855DF32C47DC35E9FD8F@smartserver.smartshare.dk> In-Reply-To: <395df6c41a554ee29b122d7f85950690@huawei.com> X-MS-Has-Attach: X-MS-TNEF-Correlator: Thread-Topic: [RFC] ethdev: TX mbuf fast release optimization Thread-Index: AdvsIqk6dXfxyQ/IQSK9FKicZXvNKwA28pmQACA/g0A= References: <98CBD80474FA8B44BF855DF32C47DC35E9FD87@smartserver.smartshare.dk> <395df6c41a554ee29b122d7f85950690@huawei.com> From: =?iso-8859-1?Q?Morten_Br=F8rup?= To: "Konstantin Ananyev" , , "Bruce Richardson" Cc: 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 > From: Konstantin Ananyev [mailto:konstantin.ananyev@huawei.com] > Sent: Friday, 4 July 2025 18.20 >=20 > > For TX mbuf fast release offload, I propose to add the mbuf mempool > > pointer to the ethdev tx queue configuration structure, > > so the ethdev TX burst operation doesn't need to fetch it from the > > first mbuf of each burst being fast free'd to the mempool. > > > > This modification of the struct rte_eth_txconf, and the requirement > > to set the mempool pointer if the RTE_ETH_TX_OFFLOAD_MBUF_FAST_FREE > > flag is set, will be an API+ABI change in 25.11. > > Should it be announced in the 25.07 release notes? > > > > Note: We could phase it in softly by letting the ethdev drivers > > check if the pointer has been set, and fall back to fetching it > > from mbuf[0] if not. > > > > /** > > * A structure used to configure a Tx ring of an Ethernet port. > > */ > > struct rte_eth_txconf { > > struct rte_eth_thresh tx_thresh; /**< Tx ring threshold registers. > */ > > uint16_t tx_rs_thresh; /**< Drives the setting of RS bit on TXDs. > */ > > uint16_t tx_free_thresh; /**< Start freeing Tx buffers if there > are > > less free descriptors than this value. */ > > > > uint8_t tx_deferred_start; /**< Do not start queue with > rte_eth_dev_start(). */ > > /** > > * Per-queue Tx offloads to be set using RTE_ETH_TX_OFFLOAD_* > flags. > > * Only offloads set on tx_queue_offload_capa or tx_offload_capa > > * fields on rte_eth_dev_info structure are allowed to be set. > > */ > > uint64_t offloads; > > > > + /** > > + * Per-queue mempool to release the mbufs to; required for > > + * RTE_ETH_TX_OFFLOAD_MBUF_FAST_FREE offload. > > + */ > > + struct rte_mempool *mp; > > + >=20 > Even though I usually recommend to use MBUF_FAST_FREE - > that's probably a good change. Correction in your other mail noted: "[...] NOT to use MBUF_FAST_FREE" > At least people will realize that they have to provide a single = mempool > per TX queue when they enable FAST_FREE flag. > One naming suggestion I have - can we name it somehow more = informative: > 'fast_free_mp' or so? I was planning to put information about the field in the comments only, = but yes, we can name it "fast_free_mp". > Also, we can update tx_queue_setup() to catch the situation when > FAST_FREE > is set but mp is NULL, or visa-versa. Yes, that was the plan. (Although I didn't think about the "vice-versa" case, which is also a = good thing to catch.) > Again drivers can probably add extra check when debug is enabled, that > all mbufs are exactly from that mempool. I recently added the rte_mbuf_raw_free_bulk() function to the mbuf API, = to emphasize the requirements that drivers must comply to when = fast-freeing mbufs. And for verification purposes, when conformance = testing drivers' fast-free implementation. Drivers should use this mbuf API instead of directly interacting with = the mempool API when bulk freeing mbufs. >=20 >=20 > > uint64_t reserved_64s[2]; /**< Reserved for future fields */ > > void *reserved_ptrs[2]; /**< Reserved for future fields */ > > }; > >