doc: announce hiding interrupt handle structure
authorHarman Kalra <hkalra@marvell.com>
Mon, 2 Aug 2021 16:03:52 +0000 (21:33 +0530)
committerThomas Monjalon <thomas@monjalon.net>
Wed, 4 Aug 2021 14:20:32 +0000 (16:20 +0200)
commitba8a263696bbe9e27a61cdbe36ae3a1f7b142329
tree22edcd5f6ae2c3369cea1da80b9a9fceeec29f8f
parentd7595795b760003986635dc3111887d8ec7bd7cc
doc: announce hiding interrupt handle structure

Moving struct rte_intr_handle as an internal structure to
avoid any ABI breakages in future. Since this structure defines
some static arrays and changing respective macros breaks the ABI.
Eg:
Currently RTE_MAX_RXTX_INTR_VEC_ID imposes a limit of maximum 512
MSI-X interrupts that can be defined for a PCI device, while PCI
specification allows maximum 2048 MSI-X interrupts that can be used.
If some PCI device requires more than 512 vectors, either change the
RTE_MAX_RXTX_INTR_VEC_ID limit or dynamically allocate based on
PCI device MSI-X size on probe time. Either way its an ABI breakage.

Discussion thread:
https://mails.dpdk.org/archives/dev/2021-March/202959.html

Signed-off-by: Harman Kalra <hkalra@marvell.com>
Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>
Acked-by: Chenbo Xia <chenbo.xia@intel.com>
Acked-by: Jerin Jacob <jerinj@marvell.com>
doc/guides/rel_notes/deprecation.rst