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 * eal: both declaring and identifying devices will be streamlined in v18.05.
  12   New functions will appear to query a specific port from buses, classes of
  13   device and device drivers. Device declaration will be made coherent with the
  14   new scheme of device identification.
  15   As such, ``rte_devargs`` device representation will change.
  16
  17   - removal of ``name`` and ``args`` fields.
  18   - The enum ``rte_devtype`` was used to identify a bus and will disappear.
  19   - The ``rte_devargs_list`` will be made private.
  20   - Functions previously deprecated will change or disappear:
  21
  22     + ``rte_eal_devargs_add``
  23     + ``rte_eal_devargs_type_count``
  24     + ``rte_eal_parse_devargs_str``, replaced by ``rte_eal_devargs_parse``
  25     + ``rte_eal_devargs_parse`` will change its format and use.
  26     + all ``rte_devargs`` related functions will be renamed, changing the
  27       ``rte_eal_devargs_`` prefix to ``rte_devargs_``.
  28
  29 * pci: Several exposed functions are misnamed.
  30   The following functions are deprecated starting from v17.11 and are replaced:
  31
  32   - ``eal_parse_pci_BDF`` replaced by ``rte_pci_addr_parse``
  33   - ``eal_parse_pci_DomBDF`` replaced by ``rte_pci_addr_parse``
  34   - ``rte_eal_compare_pci_addr`` replaced by ``rte_pci_addr_cmp``
  35
  36 * eal: The semantics of the return value for the ``rte_lcore_has_role`` function
  37   are planned to change in v18.05. The function currently returns 0 and <0 for
  38   success and failure, respectively.  This will change to 1 and 0 for true and
  39   false, respectively, to make use of the function more intuitive.
  40
  41 * eal: new ``numa_node_count`` member will be added to ``rte_config`` structure
  42   in v18.05.
  43
  44 * ethdev: a new Tx and Rx offload API was introduced on 17.11.
  45   In the new API, offloads are divided into per-port and per-queue offloads.
  46   Offloads are disabled by default and enabled per application request.
  47   The old offloads API is target to be deprecated on 18.05. This includes:
  48
  49   - removal of ``ETH_TXQ_FLAGS_NO*`` flags.
  50   - removal of ``txq_flags`` field from ``rte_eth_txconf`` struct.
  51   - removal of the offloads bit-field from ``rte_eth_rxmode`` struct.
  52
  53 * ethdev: the legacy filter API, including
  54   ``rte_eth_dev_filter_supported()``, ``rte_eth_dev_filter_ctrl()`` as well
  55   as filter types MACVLAN, ETHERTYPE, FLEXIBLE, SYN, NTUPLE, TUNNEL, FDIR,
  56   HASH and L2_TUNNEL, is superseded by the generic flow API (rte_flow) in
  57   PMDs that implement the latter.
  58   Target release for removal of the legacy API will be defined once most
  59   PMDs have switched to rte_flow.
  60
  61 * i40e: The default flexible payload configuration which extracts the first 16
  62   bytes of the payload for RSS will be deprecated starting from 18.02. If
  63   required the previous behavior can be configured using existing flow
  64   director APIs. There is no ABI/API break. This change will just remove a
  65   global configuration setting and require explicit configuration.
  66
  67 * librte_meter: The API will change to accommodate configuration profiles.
  68   Most of the API functions will have an additional opaque parameter.
  69
  70 * ring: The alignment constraints on the ring structure will be relaxed
  71   to one cache line instead of two, and an empty cache line padding will
  72   be added between the producer and consumer structures. The size of the
  73   structure and the offset of the fields will remain the same on
  74   platforms with 64B cache line, but will change on other platforms.