On Sat, Jan 22, 2022 at 10:44 PM Naga Harish K S V
<s.v.naga.haris...@intel.com> wrote:
>
> This patch introduces new api for retrieving event port id
> of eth rx adapter.
>
> Signed-off-by: Naga Harish K S V <s.v.naga.haris...@intel.com>
> Acked-by: Jay Jayatheerthan <jay.jayatheert...@intel.com>
>
> ---
> v3:
> * update commit message head line
Applied to dpdk-next-net-eventdev/for-main with the following changes. Thanks
1) api -> API in git commit message
2) Added following in "New Features" section in
doc/guides/rel_notes/release_22_03.rst
* **Added an API to retrieve event port id of eth rx adapter.**
A new API, ``rte_event_eth_rx_adapter_event_port_get()``, was added.
>
> v2:
> * address review comments
>
> v1:
> * initial implementation
> ---
> doc/guides/rel_notes/release_22_03.rst | 2 ++
> lib/eventdev/rte_event_eth_rx_adapter.c | 20 ++++++++++++++++++++
> lib/eventdev/rte_event_eth_rx_adapter.h | 20 ++++++++++++++++++++
> lib/eventdev/version.map | 3 +++
> 4 files changed, 45 insertions(+)
>
> diff --git a/doc/guides/rel_notes/release_22_03.rst
> b/doc/guides/rel_notes/release_22_03.rst
> index 6d99d1eaa9..288d94c0e6 100644
> --- a/doc/guides/rel_notes/release_22_03.rst
> +++ b/doc/guides/rel_notes/release_22_03.rst
> @@ -83,6 +83,8 @@ API Changes
> This section is a comment. Do not overwrite or remove it.
> Also, make sure to start the actual text at the margin.
> =======================================================
> +* eventdev: Added new API ``rte_event_eth_rx_adapter_event_port_get``,
> + to retrieve event port id of eth rx adapter.
>
>
> ABI Changes
> diff --git a/lib/eventdev/rte_event_eth_rx_adapter.c
> b/lib/eventdev/rte_event_eth_rx_adapter.c
> index f946137b25..ae1e260c08 100644
> --- a/lib/eventdev/rte_event_eth_rx_adapter.c
> +++ b/lib/eventdev/rte_event_eth_rx_adapter.c
> @@ -3123,6 +3123,26 @@ rte_event_eth_rx_adapter_service_id_get(uint8_t id,
> uint32_t *service_id)
> return rx_adapter->service_inited ? 0 : -ESRCH;
> }
>
> +int
> +rte_event_eth_rx_adapter_event_port_get(uint8_t id, uint8_t *event_port_id)
> +{
> + struct event_eth_rx_adapter *rx_adapter;
> +
> + if (rxa_memzone_lookup())
> + return -ENOMEM;
> +
> + RTE_EVENT_ETH_RX_ADAPTER_ID_VALID_OR_ERR_RET(id, -EINVAL);
> +
> + rx_adapter = rxa_id_to_adapter(id);
> + if (rx_adapter == NULL || event_port_id == NULL)
> + return -EINVAL;
> +
> + if (rx_adapter->service_inited)
> + *event_port_id = rx_adapter->event_port_id;
> +
> + return rx_adapter->service_inited ? 0 : -ESRCH;
> +}
> +
> int
> rte_event_eth_rx_adapter_cb_register(uint8_t id,
> uint16_t eth_dev_id,
> diff --git a/lib/eventdev/rte_event_eth_rx_adapter.h
> b/lib/eventdev/rte_event_eth_rx_adapter.h
> index 9546d792e9..3608a7b2cf 100644
> --- a/lib/eventdev/rte_event_eth_rx_adapter.h
> +++ b/lib/eventdev/rte_event_eth_rx_adapter.h
> @@ -37,6 +37,7 @@
> * - rte_event_eth_rx_adapter_queue_conf_get()
> * - rte_event_eth_rx_adapter_queue_stats_get()
> * - rte_event_eth_rx_adapter_queue_stats_reset()
> + * - rte_event_eth_rx_adapter_event_port_get()
> *
> * The application creates an ethernet to event adapter using
> * rte_event_eth_rx_adapter_create_ext() or rte_event_eth_rx_adapter_create()
> @@ -684,6 +685,25 @@ rte_event_eth_rx_adapter_queue_stats_reset(uint8_t id,
> uint16_t eth_dev_id,
> uint16_t rx_queue_id);
>
> +/**
> + * Retrieve the event port ID of an adapter. If the adapter doesn't use
> + * a rte_service function, this function returns -ESRCH.
> + *
> + * @param id
> + * Adapter identifier.
> + *
> + * @param [out] event_port_id
> + * A pointer to a uint8_t, to be filled in with the port id.
> + *
> + * @return
> + * - 0: Success
> + * - <0: Error code on failure, if the adapter doesn't use a rte_service
> + * function, this function returns -ESRCH.
> + */
> +__rte_experimental
> +int
> +rte_event_eth_rx_adapter_event_port_get(uint8_t id, uint8_t *event_port_id);
> +
> #ifdef __cplusplus
> }
> #endif
> diff --git a/lib/eventdev/version.map b/lib/eventdev/version.map
> index ade1f1182e..cd5dada07f 100644
> --- a/lib/eventdev/version.map
> +++ b/lib/eventdev/version.map
> @@ -105,6 +105,9 @@ EXPERIMENTAL {
> rte_event_eth_rx_adapter_queue_conf_get;
> rte_event_eth_rx_adapter_queue_stats_get;
> rte_event_eth_rx_adapter_queue_stats_reset;
> +
> + # added in 22.03
> + rte_event_eth_rx_adapter_event_port_get;
> };
>
> INTERNAL {
> --
> 2.25.1
>
