f1f6ebc0ea
Currently there are some public headers that include 'sys/queue.h', which is not POSIX, but usually provided by the Linux/BSD system library. (Not in POSIX.1, POSIX.1-2001, or POSIX.1-2008. Present on the BSDs.) The file is missing on Windows. During the Windows build, DPDK uses a bundled copy, so building a DPDK library works fine. But when OVS or other applications use DPDK as a library, because some DPDK public headers include 'sys/queue.h', on Windows, it triggers an error due to no such file. One solution is to install the 'lib/eal/windows/include/sys/queue.h' into Windows environment, such as [1]. However, this means DPDK exports the functionalities of 'sys/queue.h' into the environment, which might cause symbols, macros, headers clashing with other applications. The patch fixes it by removing the "#include <sys/queue.h>" from DPDK public headers, so programs including DPDK headers don't depend on the system to provide 'sys/queue.h'. When these public headers use macros such as TAILQ_xxx, we replace it by the ones with RTE_ prefix. For Windows, we copy the definitions from <sys/queue.h> to rte_os.h in Windows EAL. Note that these RTE_ macros are compatible with <sys/queue.h>, both at the level of API (to use with <sys/queue.h> macros in C files) and ABI (to avoid breaking it). Additionally, the TAILQ_FOREACH_SAFE is not part of <sys/queue.h>, the patch replaces it with RTE_TAILQ_FOREACH_SAFE. [1] http://mails.dpdk.org/archives/dev/2021-August/216304.html Suggested-by: Nick Connolly <nick.connolly@mayadata.io> Suggested-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com> Signed-off-by: William Tu <u9012063@gmail.com> Acked-by: Dmitry Kozlyuk <dmitry.kozliuk@gmail.com> Acked-by: Narcisa Vasile <navasile@linux.microsoft.com>
139 lines
3.4 KiB
C
139 lines
3.4 KiB
C
/* SPDX-License-Identifier: BSD-3-Clause
|
|
* Copyright(c) 2018 Intel Corporation
|
|
*/
|
|
|
|
#ifndef _RTE_VDPA_H_DEV_
|
|
#define _RTE_VDPA_H_DEV_
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include "rte_vhost.h"
|
|
#include "rte_vdpa.h"
|
|
|
|
#define RTE_VHOST_QUEUE_ALL UINT16_MAX
|
|
|
|
/**
|
|
* vdpa device operations
|
|
*/
|
|
struct rte_vdpa_dev_ops {
|
|
/** Get capabilities of this device (Mandatory) */
|
|
int (*get_queue_num)(struct rte_vdpa_device *dev, uint32_t *queue_num);
|
|
|
|
/** Get supported features of this device (Mandatory) */
|
|
int (*get_features)(struct rte_vdpa_device *dev, uint64_t *features);
|
|
|
|
/** Get supported protocol features of this device (Mandatory) */
|
|
int (*get_protocol_features)(struct rte_vdpa_device *dev,
|
|
uint64_t *protocol_features);
|
|
|
|
/** Driver configure the device (Mandatory) */
|
|
int (*dev_conf)(int vid);
|
|
|
|
/** Driver close the device (Mandatory) */
|
|
int (*dev_close)(int vid);
|
|
|
|
/** Enable/disable this vring (Mandatory) */
|
|
int (*set_vring_state)(int vid, int vring, int state);
|
|
|
|
/** Set features when changed (Mandatory) */
|
|
int (*set_features)(int vid);
|
|
|
|
/** Destination operations when migration done */
|
|
int (*migration_done)(int vid);
|
|
|
|
/** Get the vfio group fd */
|
|
int (*get_vfio_group_fd)(int vid);
|
|
|
|
/** Get the vfio device fd */
|
|
int (*get_vfio_device_fd)(int vid);
|
|
|
|
/** Get the notify area info of the queue */
|
|
int (*get_notify_area)(int vid, int qid,
|
|
uint64_t *offset, uint64_t *size);
|
|
|
|
/** Get statistics name */
|
|
int (*get_stats_names)(struct rte_vdpa_device *dev,
|
|
struct rte_vdpa_stat_name *stats_names,
|
|
unsigned int size);
|
|
|
|
/** Get statistics of the queue */
|
|
int (*get_stats)(struct rte_vdpa_device *dev, int qid,
|
|
struct rte_vdpa_stat *stats, unsigned int n);
|
|
|
|
/** Reset statistics of the queue */
|
|
int (*reset_stats)(struct rte_vdpa_device *dev, int qid);
|
|
|
|
/** Reserved for future extension */
|
|
void *reserved[2];
|
|
};
|
|
|
|
/**
|
|
* vdpa device structure includes device address and device operations.
|
|
*/
|
|
struct rte_vdpa_device {
|
|
RTE_TAILQ_ENTRY(rte_vdpa_device) next;
|
|
/** Generic device information */
|
|
struct rte_device *device;
|
|
/** vdpa device operations */
|
|
struct rte_vdpa_dev_ops *ops;
|
|
};
|
|
|
|
/**
|
|
* Register a vdpa device
|
|
*
|
|
* @param rte_dev
|
|
* the generic device pointer
|
|
* @param ops
|
|
* the vdpa device operations
|
|
* @return
|
|
* vDPA device pointer on success, NULL on failure
|
|
*/
|
|
struct rte_vdpa_device *
|
|
rte_vdpa_register_device(struct rte_device *rte_dev,
|
|
struct rte_vdpa_dev_ops *ops);
|
|
|
|
/**
|
|
* Unregister a vdpa device
|
|
*
|
|
* @param dev
|
|
* vDPA device pointer
|
|
* @return
|
|
* device id on success, -1 on failure
|
|
*/
|
|
int
|
|
rte_vdpa_unregister_device(struct rte_vdpa_device *dev);
|
|
|
|
/**
|
|
* Enable/Disable host notifier mapping for a vdpa port.
|
|
*
|
|
* @param vid
|
|
* vhost device id
|
|
* @param enable
|
|
* true for host notifier map, false for host notifier unmap
|
|
* @param qid
|
|
* vhost queue id, RTE_VHOST_QUEUE_ALL to configure all the device queues
|
|
* @return
|
|
* 0 on success, -1 on failure
|
|
*/
|
|
int
|
|
rte_vhost_host_notifier_ctrl(int vid, uint16_t qid, bool enable);
|
|
|
|
/**
|
|
* Synchronize the used ring from mediated ring to guest, log dirty
|
|
* page for each writeable buffer, caller should handle the used
|
|
* ring logging before device stop.
|
|
*
|
|
* @param vid
|
|
* vhost device id
|
|
* @param qid
|
|
* vhost queue id
|
|
* @param vring_m
|
|
* mediated virtio ring pointer
|
|
* @return
|
|
* number of synced used entries on success, -1 on failure
|
|
*/
|
|
int
|
|
rte_vdpa_relay_vring_used(int vid, uint16_t qid, void *vring_m);
|
|
|
|
#endif /* _RTE_VDPA_DEV_H_ */
|