rte_event_vector_adapter.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2025 Marvell International Ltd.
 * All rights reserved.
 */
 
#ifndef _RTE_EVENT_VECTOR_ADAPTER_H_
#define _RTE_EVENT_VECTOR_ADAPTER_H_

 
#include <rte_eventdev.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define RTE_EVENT_VECTOR_ADAPTER_CAP_SOV_EOV RTE_BIT64(0)
 
#define RTE_EVENT_VECTOR_ENQ_SOV RTE_BIT64(0)
#define RTE_EVENT_VECTOR_ENQ_EOV RTE_BIT64(1)
#define RTE_EVENT_VECTOR_ENQ_FLUSH RTE_BIT64(2)

struct rte_event_vector_adapter_conf {
    uint8_t event_dev_id;
    uint32_t socket_id;
    struct rte_event ev;
    struct rte_event ev_fallback;
    uint16_t vector_sz;
    uint64_t vector_timeout_ns;
    struct rte_mempool *vector_mp;
};

struct rte_event_vector_adapter_info {
    uint8_t max_vector_adapters_per_event_queue;
    uint16_t min_vector_sz;
    uint16_t max_vector_sz;
    uint64_t min_vector_timeout_ns;
    uint64_t max_vector_timeout_ns;
    uint8_t log2_sz;
};

struct rte_event_vector_adapter_stats {
    uint64_t vectorized;
    uint64_t vectors_timedout;
    uint64_t vectors_flushed;
    uint64_t alloc_failures;
};
 
struct rte_event_vector_adapter;
 
typedef int (*rte_event_vector_adapter_enqueue_t)(struct rte_event_vector_adapter *adapter,
                          uint64_t objs[], uint16_t num_elem,
                          uint64_t flags);

struct __rte_cache_aligned rte_event_vector_adapter {
    rte_event_vector_adapter_enqueue_t enqueue;
    struct rte_event_vector_adapter_data *data;
    const struct event_vector_adapter_ops *ops;
 
    uint32_t adapter_id;
    uint8_t used : 1;
};

typedef int (*rte_event_vector_adapter_port_conf_cb_t)(uint8_t event_dev_id, uint8_t *event_port_id,
                               void *conf_arg);

__rte_experimental
struct rte_event_vector_adapter *
rte_event_vector_adapter_create(const struct rte_event_vector_adapter_conf *conf);

__rte_experimental
struct rte_event_vector_adapter *
rte_event_vector_adapter_create_ext(const struct rte_event_vector_adapter_conf *conf,
                    rte_event_vector_adapter_port_conf_cb_t conf_cb,
                    void *conf_arg);

__rte_experimental
struct rte_event_vector_adapter *
rte_event_vector_adapter_lookup(uint32_t adapter_id);

__rte_experimental
int
rte_event_vector_adapter_destroy(struct rte_event_vector_adapter *adapter);

__rte_experimental
int
rte_event_vector_adapter_info_get(uint8_t event_dev_id,
                  struct rte_event_vector_adapter_info *info);

__rte_experimental
int
rte_event_vector_adapter_conf_get(struct rte_event_vector_adapter *adapter,
                  struct rte_event_vector_adapter_conf *conf);

__rte_experimental
uint8_t
rte_event_vector_adapter_remaining(uint8_t event_dev_id, uint8_t event_queue_id);

__rte_experimental
int
rte_event_vector_adapter_stats_get(struct rte_event_vector_adapter *adapter,
                   struct rte_event_vector_adapter_stats *stats);

__rte_experimental
int
rte_event_vector_adapter_stats_reset(struct rte_event_vector_adapter *adapter);

__rte_experimental
int
rte_event_vector_adapter_service_id_get(struct rte_event_vector_adapter *adapter,
                    uint32_t *service_id);

__rte_experimental
static inline int
rte_event_vector_adapter_enqueue(struct rte_event_vector_adapter *adapter, uint64_t objs[],
                 uint16_t num_elem, uint64_t flags)
{
#ifdef RTE_LIBRTE_EVENTDEV_DEBUG
    if (adapter == NULL) {
        rte_errno = EINVAL;
        return 0;
    }
 
    if (adapter->used == false) {
        rte_errno = EINVAL;
        return 0;
    }
#endif
    return adapter->enqueue(adapter, objs, num_elem, flags);
}
 
#ifdef __cplusplus
}
#endif
 
#endif /* _RTE_EVENT_VECTOR_ADAPTER_H_ */