mbuf: support dynamic fields and flags
authorOlivier Matz <olivier.matz@6wind.com>
Sat, 26 Oct 2019 12:39:01 +0000 (14:39 +0200)
committerThomas Monjalon <thomas@monjalon.net>
Sat, 26 Oct 2019 17:08:50 +0000 (19:08 +0200)
commit4958ca3a443a33ed49b2601232349037dbb7124f
tree2bc02dc665720c4dfad3571dd5fc2ab87b574062
parent6d3f9917ff73c5149bc0926928dbfd808ea57011
mbuf: support dynamic fields and flags

Many features require to store data inside the mbuf. As the room in mbuf
structure is limited, it is not possible to have a field for each
feature. Also, changing fields in the mbuf structure can break the API
or ABI.

This commit addresses these issues, by enabling the dynamic registration
of fields or flags:

- a dynamic field is a named area in the rte_mbuf structure, with a
  given size (>= 1 byte) and alignment constraint.
- a dynamic flag is a named bit in the rte_mbuf structure.

The typical use case is a PMD that registers space for an offload
feature, when the application requests to enable this feature.  As
the space in mbuf is limited, the space should only be reserved if it
is going to be used (i.e when the application explicitly asks for it).

The registration can be done at any moment, but it is not possible
to unregister fields or flags.

Signed-off-by: Olivier Matz <olivier.matz@6wind.com>
Acked-by: Thomas Monjalon <thomas@monjalon.net>
Acked-by: Konstantin Ananyev <konstantin.ananyev@intel.com>
app/test/test_mbuf.c
doc/guides/rel_notes/release_19_11.rst
lib/librte_eal/common/include/rte_common.h
lib/librte_mbuf/Makefile
lib/librte_mbuf/meson.build
lib/librte_mbuf/rte_mbuf.h
lib/librte_mbuf/rte_mbuf_core.h
lib/librte_mbuf/rte_mbuf_dyn.c [new file with mode: 0644]
lib/librte_mbuf/rte_mbuf_dyn.h [new file with mode: 0644]
lib/librte_mbuf/rte_mbuf_version.map