[PATCH] doc: add link to mbuf layout history

Morten Brørup mb at smartsharesystems.com
Tue Apr 7 10:44:45 CEST 2026


> From: Thomas Monjalon [mailto:thomas at monjalon.net]
> Sent: Tuesday, 7 April 2026 10.06
> 
> In order to illustrate how mbuf is kept small,
> add a link to a page showing the mbuf layout for each version.
> 
> Signed-off-by: Thomas Monjalon <thomas at monjalon.net>
> ---
>  doc/guides/prog_guide/mbuf_lib.rst | 11 ++++++-----
>  1 file changed, 6 insertions(+), 5 deletions(-)
> 
> diff --git a/doc/guides/prog_guide/mbuf_lib.rst
> b/doc/guides/prog_guide/mbuf_lib.rst
> index 382bfbdca4..97f8e72356 100644
> --- a/doc/guides/prog_guide/mbuf_lib.rst
> +++ b/doc/guides/prog_guide/mbuf_lib.rst
> @@ -8,11 +8,12 @@ The Packet (MBuf) library provides the ability to
> allocate and free buffers (mbu
>  that may be used by the DPDK application to store message buffers.
>  The message buffers are stored in a mempool, using the
> :doc:`mempool_lib`.
> 
> -A rte_mbuf struct generally carries network packet buffers, but it can
> actually
> -be any data (control data, events, ...).
> -The rte_mbuf header structure is kept as small as possible and
> currently uses
> -just two cache lines, with the most frequently used fields being on
> the first
> -of the two cache lines.
> +A ``struct rte_mbuf`` generally carries network packet buffers,
> +but it can actually be any data (control data, events, etc).
> +The ``rte_mbuf`` header structure is
> +`kept as small as possible
> <https://doc.dpdk.org/struct/mbuf/history.html>`_
> +and currently uses just two 64-byte cache lines,
> +with the most frequently used fields being on the first of the two
> cache lines.
> 
>  Design of Packet Buffers
>  ------------------------
> --
> 2.53.0

Hadn't noticed that illustration before, so good idea linking to it here.

Acked-by: Morten Brørup <mb at smartsharesystems.com>



More information about the dev mailing list