doc/guides/rel_notes/deprecation.rst

   1 ABI and API Deprecation
   2 =======================
   3
   4 See the :doc:`guidelines document for details of the ABI policy </contributing/versioning>`.
   5 API and ABI deprecation notices are to be posted here.
   6
   7
   8 Deprecation Notices
   9 -------------------
  10
  11 * Significant ABI changes are planned for struct rte_eth_dev to support up to
  12   1024 queues per port. This change will be in release 2.2.
  13   There is no backward compatibility planned from release 2.2.
  14   All binaries will need to be rebuilt from release 2.2.
  15
  16 * The Macros RTE_HASH_BUCKET_ENTRIES_MAX and RTE_HASH_KEY_LENGTH_MAX are
  17   deprecated and will be removed with version 2.2.
  18
  19 * The function rte_jhash2 is deprecated and should be removed.
  20
  21 * The following fields have been deprecated in rte_eth_stats:
  22   imissed, ibadcrc, ibadlen, imcasts, fdirmatch, fdirmiss,
  23   tx_pause_xon, rx_pause_xon, tx_pause_xoff, rx_pause_xoff
  24
  25 * API for flow director filters has been replaced by rte_eth_dev_filter_ctrl.
  26   Following old API is deprecated and will be removed with version 2.2 without
  27   backward compatibility.
  28   Functions: rte_eth_dev_fdir_*.
  29   Structures: rte_fdir_*, rte_eth_fdir.
  30   Enums: rte_l4type, rte_iptype.
  31
  32 * ABI changes are planned for struct rte_eth_fdir_flow_ext in order to support
  33   flow director filtering in VF. The release 2.1 does not contain these ABI
  34   changes, but release 2.2 will, and no backwards compatibility is planned.
  35
  36 * ABI changes are planned for struct rte_eth_fdir_filter and
  37   rte_eth_fdir_masks in order to support new flow director modes,
  38   MAC VLAN and Cloud, on x550. The MAC VLAN mode means the MAC and
  39   VLAN are monitored. The Cloud mode is for VxLAN and NVGRE, and
  40   the tunnel type, TNI/VNI, inner MAC and inner VLAN are monitored.
  41   The release 2.2 will contain these changes without backwards compatibility.
  42
  43 * librte_kni: Functions based on port id are deprecated for a long time and
  44   should be removed (rte_kni_create, rte_kni_get_port_id and rte_kni_info_get).
  45
  46 * librte_pmd_ring: The deprecated functions rte_eth_ring_pair_create and
  47   rte_eth_ring_pair_attach should be removed.
  48
  49 * ABI changes are planned for struct virtio_net in order to support vhost-user
  50   multiple queues feature.
  51   It should be integrated in release 2.2 without backward compatibility.
  52
  53 * The scheduler hierarchy structure (rte_sched_port_hierarchy) will change to
  54   allow for a larger number of subport entries.
  55   The number of available traffic_classes and queues may also change.
  56   The mbuf structure element for sched hierarchy will also change from a single
  57   32 bit to a 64 bit structure.
  58
  59 * The scheduler statistics structure will change to allow keeping track of
  60   RED actions.
  61
  62 * librte_acl: The structure rte_acl_ipv4vlan_rule is deprecated and should
  63   be removed as well as the associated functions rte_acl_ipv4vlan_add_rules
  64   and rte_acl_ipv4vlan_build.
  65
  66 * librte_cfgfile: In order to allow for longer names and values,
  67   the value of macros CFG_NAME_LEN and CFG_NAME_VAL will be increased.
  68   Most likely, the new values will be 64 and 256, respectively.
  69
  70 * librte_port: Macros to access the packet meta-data stored within the
  71   packet buffer will be adjusted to cover the packet mbuf structure as well,
  72   as currently they are able to access any packet buffer location except the
  73   packet mbuf structure.
  74
  75 * librte_table LPM: A new parameter to hold the table name will be added to
  76   the LPM table parameter structure.
  77
  78 * librte_table: New functions for table entry bulk add/delete will be added
  79   to the table operations structure.
  80
  81 * librte_table hash: Key mask parameter will be added to the hash table
  82   parameter structure for 8-byte key and 16-byte key extendible bucket and
  83   LRU tables.
  84
  85 * librte_pipeline: The prototype for the pipeline input port, output port
  86   and table action handlers will be updated:
  87   the pipeline parameter will be added, the packets mask parameter will be
  88   either removed (for input port action handler) or made input-only.