X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Frel_notes%2Frelease_18_08.rst;h=8a09dee95c583e7b2315eb86d9d9a6a2a1dd45f5;hb=0ef246a7e8df824d8cab041ffabf8b363904862e;hp=3e461afd4c9b643ced904cd166623bec4173e691;hpb=c982c513f96bb5a530c4566074b68ba9b1e7fe6d;p=dpdk.git diff --git a/doc/guides/rel_notes/release_18_08.rst b/doc/guides/rel_notes/release_18_08.rst index 3e461afd4c..8a09dee95c 100644 --- a/doc/guides/rel_notes/release_18_08.rst +++ b/doc/guides/rel_notes/release_18_08.rst @@ -1,3 +1,6 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright 2018 The DPDK contributors + DPDK Release 18.08 ================== @@ -51,6 +54,7 @@ New Features Flow API support has been added to CXGBE Poll Mode Driver to offload flows to Chelsio T5/T6 NICs. Support added for: + * Wildcard (LE-TCAM) and Exact (HASH) match filters. * Match items: physical ingress port, IPv4, IPv6, TCP and UDP. * Action items: queue, drop, count, and physical egress port redirect. @@ -65,8 +69,8 @@ New Features * **Added descriptor status check support for fm10k.** - ``rte_eth_rx_descritpr_status`` and ``rte_eth_tx_descriptor_status`` - are supported by fm10K. + The ``rte_eth_rx_descriptor_status`` and ``rte_eth_tx_descriptor_status`` + APIs are now supported by fm10K. * **Updated the enic driver.** @@ -82,20 +86,20 @@ New Features * Added port representors support. * Added Flow API support for e-switch rules. - Supported ACTION_PORT_ID, ACTION_DROP, ACTION_OF_POP_VLAN, + Added support for ACTION_PORT_ID, ACTION_DROP, ACTION_OF_POP_VLAN, ACTION_OF_PUSH_VLAN, ACTION_OF_SET_VLAN_VID, ACTION_OF_SET_VLAN_PCP and ITEM_PORT_ID. - * Supported 32-bit compilation. + * Added support for 32-bit compilation. -* **Added TSO support for mlx4 driver.** +* **Added TSO support for the mlx4 driver.** - The support is from MLNX_OFED_4.4 and above. + Added TSO support for the mlx4 drivers from MLNX_OFED_4.4 and above. * **SoftNIC PMD rework.** - The SoftNIC PMD infrastructure is restructured to use the Packet Framework, - which makes it more flexible, modular and easier to add new functionality - in future. + The SoftNIC PMD infrastructure has been restructured to use the Packet + Framework, which makes it more flexible, modular and easier to add new + functionality in the future. * **Updated the AESNI MB PMD.** @@ -127,8 +131,8 @@ API Changes Also, make sure to start the actual text at the margin. ========================================================= -* Path to runtime config file has changed. The new path is determined as - follows: +* The path to the runtime config file has changed. The new path is determined + as follows: - If DPDK is running as root, ``/var/run/dpdk//config`` - If DPDK is not running as root: @@ -136,6 +140,10 @@ API Changes * If ``$XDG_RUNTIME_DIR`` is set, ``${XDG_RUNTIME_DIR}/dpdk//config`` * Otherwise, ``/tmp/dpdk//config`` +* eal: The function ``rte_eal_mbuf_default_mempool_ops`` was deprecated + and is removed in 18.08. It shall be replaced by + ``rte_mbuf_best_mempool_ops``. + * mempool: Following functions were deprecated and are removed in 18.08: - ``rte_mempool_populate_iova_tab`` @@ -157,24 +165,26 @@ API Changes - ``rte_eth_conf.rxmode.ignore_offload_bitfield`` - ``ETH_TXQ_FLAGS_IGNORE`` -* cryptodev: In struct ``struct rte_cryptodev_info``, field ``rte_pci_device *pci_dev`` - has been replaced with field ``struct rte_device *device``. - Value 0 is accepted in ``sym.max_nb_sessions``, meaning that a device - supports an unlimited number of sessions. - Two new fields of type ``uint16_t`` have been added: - ``min_mbuf_headroom_req`` and ``min_mbuf_tailroom_req``. - These parameters specify the recommended headroom and tailroom for mbufs - to be processed by the PMD. +* cryptodev: The following API changes have been made in 18.08: + + - In struct ``struct rte_cryptodev_info``, field ``rte_pci_device *pci_dev`` + has been replaced with field ``struct rte_device *device``. + - Value 0 is accepted in ``sym.max_nb_sessions``, meaning that a device + supports an unlimited number of sessions. + - Two new fields of type ``uint16_t`` have been added: + ``min_mbuf_headroom_req`` and ``min_mbuf_tailroom_req``. These parameters + specify the recommended headroom and tailroom for mbufs to be processed by + the PMD. -* cryptodev: Following functions were deprecated and are removed in 18.08: +* cryptodev: The following functions were deprecated and are removed in 18.08: - ``rte_cryptodev_queue_pair_start`` - ``rte_cryptodev_queue_pair_stop`` - ``rte_cryptodev_queue_pair_attach_sym_session`` - ``rte_cryptodev_queue_pair_detach_sym_session`` -* cryptodev: Following functions were deprecated and are replaced by - other functions in 18.08: +* cryptodev: The following functions were deprecated and are replaced by other + functions in 18.08: - ``rte_cryptodev_get_header_session_size`` is replaced with ``rte_cryptodev_sym_get_header_session_size`` @@ -208,34 +218,6 @@ API Changes - ``RTE_COMP_FF_OOP_LB_IN_SGL_OUT`` -ABI Changes ------------ - -.. This section should contain ABI changes. Sample format: - - * Add a short 1-2 sentence description of the ABI change - that was announced in the previous releases and made in this release. - Use fixed width quotes for ``function_names`` or ``struct_names``. - Use the past tense. - - This section is a comment. Do not overwrite or remove it. - Also, make sure to start the actual text at the margin. - ========================================================= - - -Removed Items -------------- - -.. This section should contain removed items in this release. Sample format: - - * Add a short 1-2 sentence description of the removed item - in the past tense. - - This section is a comment. Do not overwrite or remove it. - Also, make sure to start the actual text at the margin. - ========================================================= - - Shared Library Versions ----------------------- @@ -268,9 +250,9 @@ The libraries prepended with a plus sign were incremented in this version. librte_compressdev.so.1 + librte_cryptodev.so.5 librte_distributor.so.1 - librte_eal.so.7 + + librte_eal.so.8 + librte_ethdev.so.10 - librte_eventdev.so.4 + + librte_eventdev.so.5 librte_flow_classify.so.1 librte_gro.so.1 librte_gso.so.1 @@ -310,21 +292,6 @@ The libraries prepended with a plus sign were incremented in this version. librte_vhost.so.3 -Known Issues ------------- - -.. This section should contain new known issues in this release. Sample format: - - * **Add title in present tense with full stop.** - - Add a short 1-2 sentence description of the known issue - in the present tense. Add information on any known workarounds. - - This section is a comment. Do not overwrite or remove it. - Also, make sure to start the actual text at the margin. - ========================================================= - - Tested Platforms ---------------- @@ -344,6 +311,80 @@ Tested Platforms Also, make sure to start the actual text at the margin. ========================================================= +* Intel(R) platforms with Intel(R) NICs combinations + + * CPU + + * Intel(R) Atom(TM) CPU C3858 @ 2.00GHz + * Intel(R) Xeon(R) CPU D-1541 @ 2.10GHz + * Intel(R) Xeon(R) CPU E5-4667 v3 @ 2.00GHz + * Intel(R) Xeon(R) CPU E5-2680 v2 @ 2.80GHz + * Intel(R) Xeon(R) CPU E5-2699 v4 @ 2.20GHz + * Intel(R) Xeon(R) CPU E5-2695 v4 @ 2.10GHz + * Intel(R) Xeon(R) CPU E5-2658 v2 @ 2.40GHz + * Intel(R) Xeon(R) CPU E5-2658 v3 @ 2.20GHz + * Intel(R) Xeon(R) Platinum 8180 CPU @ 2.50GHz + + * OS: + + * CentOS 7.4 + * Fedora 25 + * Fedora 27 + * Fedora 28 + * FreeBSD 11.1 + * Red Hat Enterprise Linux Server release 7.5 + * SUSE Enterprise Linux 12 + * Wind River Linux 8 + * Ubuntu 14.04 + * Ubuntu 16.04 + * Ubuntu 16.10 + * Ubuntu 17.10 + * Ubuntu 18.04 + + * NICs: + + * Intel(R) 82599ES 10 Gigabit Ethernet Controller + + * Firmware version: 0x61bf0001 + * Device id (pf/vf): 8086:10fb / 8086:10ed + * Driver version: 5.2.3 (ixgbe) + + * Intel(R) Corporation Ethernet Connection X552/X557-AT 10GBASE-T + + * Firmware version: 0x800003e7 + * Device id (pf/vf): 8086:15ad / 8086:15a8 + * Driver version: 4.4.6 (ixgbe) + + * Intel(R) Ethernet Converged Network Adapter X710-DA4 (4x10G) + + * Firmware version: 6.01 0x80003221 + * Device id (pf/vf): 8086:1572 / 8086:154c + * Driver version: 2.4.6 (i40e) + + * Intel Corporation Ethernet Connection X722 for 10GbE SFP+ (4x10G) + + * Firmware version: 3.33 0x80000fd5 0.0.0 + * Device id (pf/vf): 8086:37d0 / 8086:37cd + * Driver version: 2.4.3 (i40e) + + * Intel(R) Ethernet Converged Network Adapter XXV710-DA2 (2x25G) + + * Firmware version: 6.01 0x80003221 + * Device id (pf/vf): 8086:158b / 8086:154c + * Driver version: 2.4.6 (i40e) + + * Intel(R) Ethernet Converged Network Adapter XL710-QDA2 (2X40G) + + * Firmware version: 6.01 0x8000321c + * Device id (pf/vf): 8086:1583 / 8086:154c + * Driver version: 2.4.6 (i40e) + + * Intel(R) Corporation I350 Gigabit Network Connection + + * Firmware version: 1.63, 0x80000dda + * Device id (pf/vf): 8086:1521 / 8086:1520 + * Driver version: 5.4.0-k (igb) + * Intel(R) platforms with Mellanox(R) NICs combinations * CPU: