From: Stephen Hemminger Date: Fri, 19 Jul 2019 16:56:31 +0000 (-0700) Subject: doc: announce ethernet structures alignment changes X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=9c8a4aba02a2860cced933c38b7d0ec956a88715;p=dpdk.git 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 --- 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,