7 The text below explains how to update the release notes.
9 Use proper spelling, capitalization and punctuation in all sections.
11 Variable and config names should be quoted as fixed width text: ``LIKE_THIS``.
13 Build the docs and view the output file to ensure the changes are correct::
17 firefox build/doc/html/guides/rel_notes/release_16_04.html
23 This section should contain new features added in this release. Sample format:
25 * **Add a title in the past tense with a full stop.**
27 Add a short 1-2 sentence description in the past tense. The description
28 should be enough to allow someone scanning the release notes to understand
31 If the feature adds a lot of sub-features you can use a bullet list like this.
33 * Added feature foo to do something.
34 * Enhanced feature bar to do something else.
36 Refer to the previous release notes for examples.
38 * **Added function to check primary process state.**
40 A new function ``rte_eal_primary_proc_alive()`` has been added
41 to allow the user to detect if a primary process is running.
42 Use cases for this feature include fault detection, and monitoring
43 using secondary processes.
45 * **Enabled bulk allocation of mbufs.**
47 A new function ``rte_pktmbuf_alloc_bulk()`` has been added to allow the user
48 to allocate a bulk of mbufs.
52 Enabled virtio 1.0 support for virtio pmd driver.
54 * **Supported virtio for ARM.**
56 Enabled virtio support for armv7/v8. Tested for arm64.
57 Virtio for arm support VFIO-noiommu mode only.
58 Virtio can work with other non-x86 arch too like powerpc.
60 * **Supported virtio offload in vhost-user.**
62 Add the offload and negotiation of checksum and TSO between vhost-user and
63 vanilla Linux virtio guest.
65 * **Added vhost-user live migration support.**
67 * **Enabled PCI extended tag for i40e.**
69 It enabled extended tag by checking and writing corresponding PCI config
70 space bytes, to boost the performance. In the meanwhile, it deprecated the
71 legacy way via reading/writing sysfile supported by kernel module igb_uio.
73 * **Increased number of next hops for LPM IPv4 to 2^24.**
75 The next_hop field is extended from 8 bits to 24 bits for IPv4.
77 * **Added support of SNOW 3G (UEA2 and UIA2) for Intel Quick Assist devices.**
79 Enabled support for SNOW 3G wireless algorithm for Intel Quick Assist devices.
80 Support for cipher only, hash only is also provided
81 along with alg-chaining operations.
83 * **Added SNOW3G SW PMD.**
85 A new Crypto PMD has been added, which provides SNOW 3G UEA2 ciphering
86 and SNOW3G UIA2 hashing.
88 * **Added AES GCM PMD.**
90 Added new Crypto PMD to support AES-GCM authenticated encryption and
91 authenticated decryption in SW.
93 * **Added NULL Crypto PMD**
95 Added new Crypto PMD to support null crypto operations in SW.
100 This section should contain bug fixes added to the relevant sections. Sample format:
102 * **code/section: Fixed issue in the past tense with a full stop.**
104 Add a short 1-2 sentence description of the resolved issue in the past tense.
105 The title should contain the code/lib section like a commit message.
106 Add the entries in alphabetic order in the relevant sections below.
116 * **ethdev: Fixed byte order consistency between fdir flow and mask.**
118 Fixed issue in ethdev library that the structure for setting
119 fdir's mask and flow entry was not consistent in byte ordering.
121 * **aesni_mb: Fixed wrong return value when creating a device.**
123 cryptodev_aesni_mb_init() was returning the device id of the device created,
124 instead of 0 (when success), that rte_eal_vdev_init() expects.
125 This made impossible the creation of more than one aesni_mb device
128 * **qat: Fixed AES GCM decryption.**
130 Allowed AES GCM on the cryptodev API, but in some cases gave invalid results
131 due to incorrect IV setting.
137 * **hash: Fixed CRC32c hash computation for non multiple of 4 bytes sizes.**
139 Fix crc32c hash functions to return a valid crc32c value for data lengths
140 not multiple of 4 bytes.
146 * **examples/vhost: Fixed frequent mbuf allocation failure.**
148 vhost-switch often fails to allocate mbuf when dequeue from vring because it
149 wrongly calculates the number of mbufs needed.
151 * **examples/ipsec-secgw: ipsec security gateway**
153 New application implementing an IPsec Security Gateway.
162 This section should contain new known issues in this release. Sample format:
164 * **Add title in present tense with full stop.**
166 Add a short 1-2 sentence description of the known issue in the present
167 tense. Add information on any known workarounds.
173 This section should contain API changes. Sample format:
175 * Add a short 1-2 sentence description of the API change. Use fixed width
176 quotes for ``rte_function_names`` or ``rte_struct_names``. Use the past tense.
178 * The fields in ethdev structure ``rte_eth_fdir_masks`` were changed
181 * The LPM ``next_hop`` field is extended from 8 bits to 24 bits for IPv4
182 while keeping ABI compatibility.
184 * A new ``rte_lpm_config`` structure is used so LPM library will allocate
185 exactly the amount of memory which is necessary to hold application’s rules.
186 The previous ABI is kept for compatibility.
188 * The prototype for the pipeline input port, output port and table action
189 handlers are updated: the pipeline parameter is added,
190 the packets mask parameter has been either removed or made input-only.
196 * Add a short 1-2 sentence description of the ABI change that was announced in
197 the previous releases and made in this release. Use fixed width quotes for
198 ``rte_function_names`` or ``rte_struct_names``. Use the past tense.
200 * The RETA entry size in ``rte_eth_rss_reta_entry64`` has been increased
201 from 8-bit to 16-bit.
203 * The cmdline buffer size has been increase from 256 to 512.
206 Shared Library Versions
207 -----------------------
209 Update any library version updated in this release and prepend with a ``+`` sign.
211 The libraries prepended with a plus sign were incremented in this version.
218 + librte_cmdline.so.2
219 librte_distributor.so.1
231 + librte_pipeline.so.3