From 9c8a4aba02a2860cced933c38b7d0ec956a88715 Mon Sep 17 00:00:00 2001 From: Stephen Hemminger Date: Fri, 19 Jul 2019 09:56:31 -0700 Subject: [PATCH] doc: announce ethernet structures alignment changes Tell users about upcoming changes to rte_ether_addr and rte_ether_header. Signed-off-by: Stephen Hemminger Acked-by: Bruce Richardson Acked-by: Andrew Rybchenko Acked-by: Ferruh Yigit Acked-by: Thomas Monjalon --- doc/guides/rel_notes/deprecation.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index b1aa6a880a..bbe8090fbb 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -61,6 +61,16 @@ Deprecation Notices structure would be made internal (or removed if all dependencies are cleared) in future releases. +* net: The Ethernet address and header definitions will change + attributes. The Ethernet address struct will no longer be marked as + packed since the packed attribute is meaningless on a byte + array. The Ethernet header will be marked as aligned on a 2-byte + boundary and will no longer have the packed attribute. This allows + for efficient access on CPU architectures where unaligned access is + expensive. These changes should not impact normal usage because drivers + naturally align the Ethernet header on receive and all known + encapsulations preserve the alignment of the header. + * ethdev: the legacy filter API, including ``rte_eth_dev_filter_supported()``, ``rte_eth_dev_filter_ctrl()`` as well as filter types MACVLAN, ETHERTYPE, FLEXIBLE, SYN, NTUPLE, TUNNEL, FDIR, -- 2.20.1