Skip to contentSkip to conversation

doc/rel_notes: updates to 26.07 doc

PATCH In review Bruce Richardson 3 participants 11 messages Jul 21 – Jul 22

lore
Share & tools
lore
#0 lore raw

cover doc/rel_notes: updates to 26.07 doc

A collection of miscellaneous updates and fixes for the 26.07 release notes.

Bruce Richardson (6):
doc/rel_notes: remove bullets for single items doc/rel_notes: move mempool change to first item doc/rel_notes: keep library updates together doc/rel_notes: fix driver ordering doc/rel_notes: fix style of API changes section doc/rel_notes: minor style fixes

 doc/guides/rel_notes/release_26_07.rst | 143 ++++++++++++-------------
 1 file changed, 69 insertions(+), 74 deletions(-)

--
2.53.0

#1 lore raw

PATCH 1/6 doc/rel_notes: remove bullets for single items

For release note component updates where only a single item is called out, remove the bullet point character.

---
 doc/guides/rel_notes/release_26_07.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)
doc/guides/rel_notes/release_26_07.rst +12 -12
index 6badd6d91b..83610938bd 100644
@@ -137,7 +137,7 @@ New Features
 
 * **Updated Google gve driver.**
 
-  * Added hardware timestamping support on DQO queues.
+  Added hardware timestamping support on DQO queues.
 
 * **Updated Intel iavf driver.**
 
@@ -147,18 +147,18 @@ New Features
 
 * **Updated Intel ice driver.**
 
-  * Added ``rl_burst_size`` devarg to configure the scheduler rate-limiter
-    burst size, reducing Tx latency jitter for time-sensitive traffic.
+  Added ``rl_burst_size`` devarg to configure the scheduler rate-limiter
+  burst size, reducing Tx latency jitter for time-sensitive traffic.
 
 * **Updated Microsoft mana driver.**
 
-  * Added device reset support to the MANA PMD,
-    doing automatic recovery from hardware service reset events,
-    and notification to upper layers of the reset lifecycle.
+  Added device reset support to the MANA PMD,
+  doing automatic recovery from hardware service reset events,
+  and notification to upper layers of the reset lifecycle.
 
 * **Updated NVIDIA mlx5 ethernet driver.**
 
-  * Added support for selective Rx in scalar SPRQ Rx path.
+  Added support for selective Rx in scalar SPRQ Rx path.
 
 * **Updated NXP dpaa2 driver.**
 
@@ -192,14 +192,14 @@ New Features
 
 * **Updated Marvell cnxk crypto driver.**
 
-  * Added support for ML-KEM and ML-DSA on CN20K platform.
+  Added support for ML-KEM and ML-DSA on CN20K platform.
 
 * **Updated Wangxun ngbe driver.**
 
-  * Implemented UDP Segmentation Offload (USO) in the transmit path.
-    The ``RTE_ETH_TX_OFFLOAD_UDP_TSO`` capability was advertised
-    since the driver's initial integration but the data path was missing;
-    it is now functional.
+  Implemented UDP Segmentation Offload (USO) in the transmit path.
+  The ``RTE_ETH_TX_OFFLOAD_UDP_TSO`` capability was advertised
+  since the driver's initial integration but the data path was missing;
+  it is now functional.
 
 * **Updated Wangxun txgbe driver.**
 
Signature · 1 line
2.53.0
#2 lore raw

PATCH 2/6 doc/rel_notes: move mempool change to first item

In reply to Bruce Richardson

The change in mempool behaviour is the change in this release with the largest impact, so call that out first in the release notes, so as to get maximum visibility for it.

---
 doc/guides/rel_notes/release_26_07.rst | 28 +++++++++++++-------------
 1 file changed, 14 insertions(+), 14 deletions(-)
doc/guides/rel_notes/release_26_07.rst +14 -14
index 83610938bd..f301a8444c 100644
@@ -55,20 +55,6 @@ New Features
      Also, make sure to start the actual text at the margin.
      =======================================================
 
-* **Added option to change memory limits per page size.**
-
-  Added the EAL option ``--pagesz-mem``
-  to override the default per-page-size memory limits.
-  Each maximum can be configured with a pair ``<pagesz>:<limit>``.
-
-* **Added option to disable auto probing.**
-
-  Added EAL options affecting the initial bus probing.
-
-  * ``-A`` or ``--no-auto-probing`` disable the initial bus probing: no device is probed during
-    ``rte_eal_init`` and the application is responsible for probing each device,
-  * ``--auto-probing`` enables the initial bus probing, which is the current default behavior.
-
 * **Changed mempool cache behaviour.**
 
   * The mempool cache flush/refill algorithm was improved,
@@ -83,6 +69,20 @@ New Features
   * The size of the ``struct rte_mempool_cache`` was kept
     for API/ABI compatibility purposes.
 
+* **Added option to change memory limits per page size.**
+
+  Added the EAL option ``--pagesz-mem``
+  to override the default per-page-size memory limits.
+  Each maximum can be configured with a pair ``<pagesz>:<limit>``.
+
+* **Added option to disable device auto probing.**
+
+  Added EAL options affecting the initial bus probing to find devices.
+
+  * ``-A`` or ``--no-auto-probing`` disables the initial bus probing: no device is probed during
+    ``rte_eal_init`` and the application is responsible for probing each device,
+  * ``--auto-probing`` enables the initial bus probing, which is the current default behavior.
+
 * **Added RISC-V vector paths.**
 
   * Increased the default SIMD bitwidth to allow using the vector extension.
Signature · 1 line
2.53.0
#3 lore raw

PATCH 3/6 doc/rel_notes: keep library updates together

In reply to Bruce Richardson

Group all library updates and enhancements together before driver updates in the release notes.

---
 doc/guides/rel_notes/release_26_07.rst | 64 +++++++++++++-------------
 1 file changed, 32 insertions(+), 32 deletions(-)
doc/guides/rel_notes/release_26_07.rst +32 -32
index f301a8444c..63693159fd 100644
@@ -97,6 +97,38 @@ New Features
   This allows the user to inspect objects in the ring without removing them
   (aka MT safe peek).
 
+* **Updated lcore validation in power library.**
+
+  Lcore ID validation was moved into the cpufreq framework before driver dispatch.
+  Power QoS API was updated to accept service lcores.
+
+* **Extended BPF API.**
+
+  * Added an extensible BPF loading API comprising the function
+    ``rte_bpf_load_ex`` and struct ``rte_bpf_prm_ex``.
+    This enables new features such as loading classic BPF (cBPF),
+    loading ELF images directly from memory buffers,
+    and executing multi-argument programs, while avoiding future ABI breakages.
+  * Added support for loading and executing BPF programs with up to 5 arguments.
+    This introduces new API functions ``rte_bpf_exec_ex``,
+    ``rte_bpf_exec_burst_ex``, and ``rte_bpf_get_jit_ex``.
+  * Added API functions ``rte_bpf_eth_rx_install`` and ``rte_bpf_eth_tx_install``
+    for installing already loaded BPF programs as port callbacks
+    (as opposed to loading them directly from ELF files).
+
+* **Added BPF validation debugging API and hardened BPF validator.**
+
+  * Introduced a new API (prefixed with ``rte_bpf_validate_debug_``)
+    to introspect the BPF validator.
+    This provides a mechanism to set breakpoints or catchpoints during validation
+    and inspect the verifier's internal state (such as tracked register bounds).
+    This API is crucial primarily for writing comprehensive tests for the validator,
+    but also serves as a foundation for a future interactive eBPF validation debugger.
+  * Fixed numerous bugs in the BPF validator's abstract interpretation logic,
+    including incorrect bounds tracking for jumps and arithmetic operations,
+    as well as fixing several instances of undefined behavior (UB)
+    when verifying malicious or corrupt programs.
+
 * **Added PTP protocol definitions.**
 
   Added IEEE 1588 Precision Time Protocol header structures, constants,
@@ -224,38 +256,6 @@ New Features
 
   On ARM, both IPsec MB and OpenSSL are required for full functionality.
 
-* **Updated lcore validation in power library.**
-
-  Lcore ID validation was moved into the cpufreq framework before driver dispatch.
-  Power QoS API was updated to accept service lcores.
-
-* **Extended BPF API.**
-
-  * Added an extensible BPF loading API comprising the function
-    ``rte_bpf_load_ex`` and struct ``rte_bpf_prm_ex``.
-    This enables new features such as loading classic BPF (cBPF),
-    loading ELF images directly from memory buffers,
-    and executing multi-argument programs, while avoiding future ABI breakages.
-  * Added support for loading and executing BPF programs with up to 5 arguments.
-    This introduces new API functions ``rte_bpf_exec_ex``,
-    ``rte_bpf_exec_burst_ex``, and ``rte_bpf_get_jit_ex``.
-  * Added API functions ``rte_bpf_eth_rx_install`` and ``rte_bpf_eth_tx_install``
-    for installing already loaded BPF programs as port callbacks
-    (as opposed to loading them directly from ELF files).
-
-* **Added BPF validation debugging API and hardened BPF validator.**
-
-  * Introduced a new API (prefixed with ``rte_bpf_validate_debug_``)
-    to introspect the BPF validator.
-    This provides a mechanism to set breakpoints or catchpoints during validation
-    and inspect the verifier's internal state (such as tracked register bounds).
-    This API is crucial primarily for writing comprehensive tests for the validator,
-    but also serves as a foundation for a future interactive eBPF validation debugger.
-  * Fixed numerous bugs in the BPF validator's abstract interpretation logic,
-    including incorrect bounds tracking for jumps and arithmetic operations,
-    as well as fixing several instances of undefined behavior (UB)
-    when verifying malicious or corrupt programs.
-
 * **Updated testpmd application.**
 
   Added support for setting VLAN priority and CFI/DEI bits
Signature · 1 line
2.53.0
#4 lore raw

Re: [PATCH 3/6] doc/rel_notes: keep library updates together

21/07/2026 17:13, Bruce Richardson:

Quoted 2 lines

Group all library updates and enhancements together before driver updates in the release notes.

The suggested order in the release notes is:
* Core libs (EAL, mempool, ring, mbuf, buses)
* Device abstraction libs and PMDs (ordered alphabetically by vendor name)
- ethdev (lib, PMDs)
- cryptodev (lib, PMDs)
- eventdev (lib, PMDs)
- etc
* Other libs
* Apps, Examples, Tools (if significant)

So it was placed here on purpose.

#5 lore raw

Re: [PATCH 3/6] doc/rel_notes: keep library updates together

Quoted 14 lines · Thomas Monjalon

21/07/2026 17:13, Bruce Richardson:

Quoted 2 lines

Group all library updates and enhancements together before driver updates in the release notes.

The suggested order in the release notes is:
* Core libs (EAL, mempool, ring, mbuf, buses)
* Device abstraction libs and PMDs (ordered alphabetically by vendor name)
- ethdev (lib, PMDs)
- cryptodev (lib, PMDs)
- eventdev (lib, PMDs)
- etc
* Other libs
* Apps, Examples, Tools (if significant)

Quoted 2 lines

So it was placed here on purpose.

Ok, my bad. Drop this patch so.

/Bruce

#6 lore raw

PATCH 4/6 doc/rel_notes: fix driver ordering

In reply to Bruce Richardson

The drivers should be in alphabetical order by category in the release notes, so move two drivers to give correct ordering.

---
 doc/guides/rel_notes/release_26_07.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)
doc/guides/rel_notes/release_26_07.rst +8 -8
index 63693159fd..b3c23b73a1 100644
@@ -163,10 +163,6 @@ New Features
   to support adding and removing memory regions without resetting
   the whole guest memory map.
 
-* **Added LinkData sxe2 ethernet driver.**
-
-  Added network driver for the LinkData network adapters.
-
 * **Updated Google gve driver.**
 
   Added hardware timestamping support on DQO queues.
@@ -182,6 +178,10 @@ New Features
   Added ``rl_burst_size`` devarg to configure the scheduler rate-limiter
   burst size, reducing Tx latency jitter for time-sensitive traffic.
 
+* **Added LinkData sxe2 ethernet driver.**
+
+  Added network driver for the LinkData network adapters.
+
 * **Updated Microsoft mana driver.**
 
   Added device reset support to the MANA PMD,
@@ -222,10 +222,6 @@ New Features
   * Added ``eof`` devarg to use link state to signal end of receive file input.
   * Added unit test suite.
 
-* **Updated Marvell cnxk crypto driver.**
-
-  Added support for ML-KEM and ML-DSA on CN20K platform.
-
 * **Updated Wangxun ngbe driver.**
 
   Implemented UDP Segmentation Offload (USO) in the transmit path.
@@ -256,6 +252,10 @@ New Features
 
   On ARM, both IPsec MB and OpenSSL are required for full functionality.
 
+* **Updated Marvell cnxk crypto driver.**
+
+  Added support for ML-KEM and ML-DSA on CN20K platform.
+
 * **Updated testpmd application.**
 
   Added support for setting VLAN priority and CFI/DEI bits
Signature · 1 line
2.53.0
#7 lore raw

PATCH 5/6 doc/rel_notes: fix style of API changes section

In reply to Bruce Richardson

The format of the API section as documented does not have headings in bold. This simpler format is also what is used for the 25.11 and previous release notes. Update text for 26.07 to match the documented and previously used style.

---
 doc/guides/rel_notes/release_26_07.rst | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)
doc/guides/rel_notes/release_26_07.rst +5 -10
index b3c23b73a1..fca135569f 100644
@@ -317,13 +317,9 @@ API Changes
    Also, make sure to start the actual text at the margin.
    =======================================================
 
-* **eal: promoted timing-safe memory comparison from experimental to stable.**
+* eal: Promoted ``rte_memeq_timingsafe()`` from experimental to stable.
 
-  The inline function ``rte_memeq_timingsafe()`` is no longer marked experimental.
-
-* **ethdev: promoted flow metadata API from experimental to stable.**
-
-  The following ethdev symbols are no longer marked experimental:
+* ethdev: Promoted the following flow metadata symbols from experimental to stable:
 
   - ``rte_flow_dynf_metadata_register``
   - ``rte_flow_dynf_metadata_offs``
@@ -332,16 +328,15 @@ API Changes
   - ``rte_flow_dynf_metadata_get``
   - ``rte_flow_dynf_metadata_set``
 
-* **mlx5: promoted driver event and steering management APIs from experimental to stable.**
-
-  The following mlx5 functions are no longer marked experimental:
+* mlx5: Promoted the following driver event and steering management functions
+  from experimental to stable:
 
   - ``rte_pmd_mlx5_driver_event_cb_register``
   - ``rte_pmd_mlx5_driver_event_cb_unregister``
   - ``rte_pmd_mlx5_enable_steering``
   - ``rte_pmd_mlx5_disable_steering``
 
-* **ip_frag: changed handling of malformed fragments.**
+* ip_frag: Changed handling of malformed fragments.
 
   - Duplicate fragments are tolerated instead of failing reassembly.
   - Overlapping fragments are rejected on arrival rather than during reassembly.
Signature · 1 line
2.53.0
#8 lore raw

PATCH 6/6 doc/rel_notes: minor style fixes

In reply to Bruce Richardson

Some minor fixes for the release note text.

---
 doc/guides/rel_notes/release_26_07.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
doc/guides/rel_notes/release_26_07.rst +2 -2
index fca135569f..47cf73e825 100644
@@ -80,7 +80,7 @@ New Features
   Added EAL options affecting the initial bus probing to find devices.
 
   * ``-A`` or ``--no-auto-probing`` disables the initial bus probing: no device is probed during
-    ``rte_eal_init`` and the application is responsible for probing each device,
+    ``rte_eal_init`` and the application is responsible for probing each device.
   * ``--auto-probing`` enables the initial bus probing, which is the current default behavior.
 
 * **Added RISC-V vector paths.**
@@ -144,7 +144,7 @@ New Features
 
 * **Added no-IOMMU mode to UACCE bus.**
 
-  Added no-IOMMU mode for devices without or not enabling IOMMU/SVA.
+  Added no-IOMMU mode for devices that do not have or do not enable IOMMU/SVA support.
 
 * **Added unplug operation support to VMBUS bus.**
 
Signature · 1 line
2.53.0
#9 lore raw
In reply to Bruce Richardson
Quoted 11 lines

A collection of miscellaneous updates and fixes for the 26.07 release notes.

Bruce Richardson (6):
doc/rel_notes: remove bullets for single items doc/rel_notes: move mempool change to first item doc/rel_notes: keep library updates together doc/rel_notes: fix driver ordering doc/rel_notes: fix style of API changes section doc/rel_notes: minor style fixes

Quoted 2 lines
 doc/guides/rel_notes/release_26_07.rst | 143 ++++++++++++-------------
 1 file changed, 69 insertions(+), 74 deletions(-)
#10 lore raw
In reply to Bruce Richardson

21/07/2026 17:13, Bruce Richardson:

Quoted 10 lines

A collection of miscellaneous updates and fixes for the 26.07 release notes.

Bruce Richardson (6):
doc/rel_notes: remove bullets for single items doc/rel_notes: move mempool change to first item doc/rel_notes: keep library updates together doc/rel_notes: fix driver ordering doc/rel_notes: fix style of API changes section doc/rel_notes: minor style fixes

Quoted 2 lines
 doc/guides/rel_notes/release_26_07.rst | 143 ++++++++++++-------------
 1 file changed, 69 insertions(+), 74 deletions(-)

Applied without patch 3 as discussed,
and squashed with comments removal, thanks.