Something went wrong. Try again.
(I'm so sorry!) Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457/* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) */#ifndef _UAPI_VDUSE_H_#define _UAPI_VDUSE_H_
#include <linux/types.h>
#define VDUSE_BASE 0x81
/* The ioctls for control device (/dev/vduse/control) */
#define VDUSE_API_VERSION 0
/* VQ groups and ASID support */
#define VDUSE_API_VERSION_1 1
/* The VDUSE instance expects a request for vq ready */#define VDUSE_F_QUEUE_READY 0
/* The VDUSE instance expects a request for suspend */#define VDUSE_F_SUSPEND 1
/* * Get the version of VDUSE API that kernel supported (VDUSE_API_VERSION). * This is used for future extension. */#define VDUSE_GET_API_VERSION _IOR(VDUSE_BASE, 0x00, __u64)
/* Set the version of VDUSE API that userspace supported. */#define VDUSE_SET_API_VERSION _IOW(VDUSE_BASE, 0x01, __u64)
/** * struct vduse_dev_config - basic configuration of a VDUSE device * @name: VDUSE device name, needs to be NUL terminated * @vendor_id: virtio vendor id * @device_id: virtio device id * @features: virtio features * @vq_num: the number of virtqueues * @vq_align: the allocation alignment of virtqueue's metadata * @ngroups: number of vq groups that VDUSE device declares * @nas: number of address spaces that VDUSE device declares * @reserved: for future use, needs to be initialized to zero * @config_size: the size of the configuration space * @config: the buffer of the configuration space * * Structure used by VDUSE_CREATE_DEV ioctl to create VDUSE device. */struct vduse_dev_config {#define VDUSE_NAME_MAX 256 char name[VDUSE_NAME_MAX]; __u32 vendor_id; __u32 device_id; __u64 features; __u32 vq_num; __u32 vq_align; __u32 ngroups; /* if VDUSE_API_VERSION >= 1 */ __u32 nas; /* if VDUSE_API_VERSION >= 1 */ __u32 reserved[11]; __u32 config_size; __u8 config[];};
/* Create a VDUSE device which is represented by a char device (/dev/vduse/$NAME) */#define VDUSE_CREATE_DEV _IOW(VDUSE_BASE, 0x02, struct vduse_dev_config)
/* * Destroy a VDUSE device. Make sure there are no more references * to the char device (/dev/vduse/$NAME). */#define VDUSE_DESTROY_DEV _IOW(VDUSE_BASE, 0x03, char[VDUSE_NAME_MAX])
/* Get the VDUSE supported features */#define VDUSE_GET_FEATURES _IOR(VDUSE_BASE, 0x04, __u64)
/* Set the VDUSE features */#define VDUSE_SET_FEATURES _IOW(VDUSE_BASE, 0x05, __u64)
/* The ioctls for VDUSE device (/dev/vduse/$NAME) */
/** * struct vduse_iotlb_entry - entry of IOTLB to describe one IOVA region [start, last] * @offset: the mmap offset on returned file descriptor * @start: start of the IOVA region * @last: last of the IOVA region * @perm: access permission of the IOVA region * * Structure used by VDUSE_IOTLB_GET_FD ioctl to find an overlapped IOVA region. */struct vduse_iotlb_entry { __u64 offset; __u64 start; __u64 last;#define VDUSE_ACCESS_RO 0x1#define VDUSE_ACCESS_WO 0x2#define VDUSE_ACCESS_RW 0x3 __u8 perm;};
/* * Find the first IOVA region that overlaps with the range [start, last] * and return the corresponding file descriptor. Return -EINVAL means the * IOVA region doesn't exist. Caller should set start and last fields. */#define VDUSE_IOTLB_GET_FD _IOWR(VDUSE_BASE, 0x10, struct vduse_iotlb_entry)
/* * Get the negotiated virtio features. It's a subset of the features in * struct vduse_dev_config which can be accepted by virtio driver. It's * only valid after FEATURES_OK status bit is set. */#define VDUSE_DEV_GET_FEATURES _IOR(VDUSE_BASE, 0x11, __u64)
/** * struct vduse_config_data - data used to update configuration space * @offset: the offset from the beginning of configuration space * @length: the length to write to configuration space * @buffer: the buffer used to write from * * Structure used by VDUSE_DEV_SET_CONFIG ioctl to update device * configuration space. */struct vduse_config_data { __u32 offset; __u32 length; __u8 buffer[];};
/* Set device configuration space */#define VDUSE_DEV_SET_CONFIG _IOW(VDUSE_BASE, 0x12, struct vduse_config_data)
/* * Inject a config interrupt. It's usually used to notify virtio driver * that device configuration space has changed. */#define VDUSE_DEV_INJECT_CONFIG_IRQ _IO(VDUSE_BASE, 0x13)
/** * struct vduse_vq_config - basic configuration of a virtqueue * @index: virtqueue index * @max_size: the max size of virtqueue * @reserved1: for future use, needs to be initialized to zero * @group: virtqueue group * @reserved2: for future use, needs to be initialized to zero * * Structure used by VDUSE_VQ_SETUP ioctl to setup a virtqueue. */struct vduse_vq_config { __u32 index; __u16 max_size; __u16 reserved1; __u32 group; __u16 reserved2[10];};
/* * Setup the specified virtqueue. Make sure all virtqueues have been * configured before the device is attached to vDPA bus. */#define VDUSE_VQ_SETUP _IOW(VDUSE_BASE, 0x14, struct vduse_vq_config)
/** * struct vduse_vq_state_split - split virtqueue state * @avail_index: available index */struct vduse_vq_state_split { __u16 avail_index;};
/** * struct vduse_vq_state_packed - packed virtqueue state * @last_avail_counter: last driver ring wrap counter observed by device * @last_avail_idx: device available index * @last_used_counter: device ring wrap counter * @last_used_idx: used index */struct vduse_vq_state_packed { __u16 last_avail_counter; __u16 last_avail_idx; __u16 last_used_counter; __u16 last_used_idx;};
/** * struct vduse_vq_group_asid - virtqueue group ASID * @group: Index of the virtqueue group * @asid: Address space ID of the group */struct vduse_vq_group_asid { __u32 group; __u32 asid;};
/** * struct vduse_vq_info - information of a virtqueue * @index: virtqueue index * @num: the size of virtqueue * @desc_addr: address of desc area * @driver_addr: address of driver area * @device_addr: address of device area * @split: split virtqueue state * @packed: packed virtqueue state * @ready: ready status of virtqueue * * Structure used by VDUSE_VQ_GET_INFO ioctl to get virtqueue's information. */struct vduse_vq_info { __u32 index; __u32 num; __u64 desc_addr; __u64 driver_addr; __u64 device_addr; union { struct vduse_vq_state_split split; struct vduse_vq_state_packed packed; }; __u8 ready;};
/* Get the specified virtqueue's information. Caller should set index field. */#define VDUSE_VQ_GET_INFO _IOWR(VDUSE_BASE, 0x15, struct vduse_vq_info)
/** * struct vduse_vq_eventfd - eventfd configuration for a virtqueue * @index: virtqueue index * @fd: eventfd, -1 means de-assigning the eventfd * * Structure used by VDUSE_VQ_SETUP_KICKFD ioctl to setup kick eventfd. */struct vduse_vq_eventfd { __u32 index;#define VDUSE_EVENTFD_DEASSIGN -1 int fd;};
/* * Setup kick eventfd for specified virtqueue. The kick eventfd is used * by VDUSE kernel module to notify userspace to consume the avail vring. */#define VDUSE_VQ_SETUP_KICKFD _IOW(VDUSE_BASE, 0x16, struct vduse_vq_eventfd)
/* * Inject an interrupt for specific virtqueue. It's used to notify virtio driver * to consume the used vring. */#define VDUSE_VQ_INJECT_IRQ _IOW(VDUSE_BASE, 0x17, __u32)
/** * struct vduse_iova_umem - userspace memory configuration for one IOVA region * @uaddr: start address of userspace memory, it must be aligned to page size * @iova: start of the IOVA region * @size: size of the IOVA region * @asid: Address space ID of the IOVA region * @reserved: for future use, needs to be initialized to zero * * Structure used by VDUSE_IOTLB_REG_UMEM and VDUSE_IOTLB_DEREG_UMEM * ioctls to register/de-register userspace memory for IOVA regions */struct vduse_iova_umem { __u64 uaddr; __u64 iova; __u64 size; __u32 asid; __u32 reserved[5];};
/* Register userspace memory for IOVA regions */#define VDUSE_IOTLB_REG_UMEM _IOW(VDUSE_BASE, 0x18, struct vduse_iova_umem)
/* De-register the userspace memory. Caller should set iova and size field. */#define VDUSE_IOTLB_DEREG_UMEM _IOW(VDUSE_BASE, 0x19, struct vduse_iova_umem)
/** * struct vduse_iova_info - information of one IOVA region * @start: start of the IOVA region * @last: last of the IOVA region * @capability: capability of the IOVA region * @asid: Address space ID of the IOVA region, only if device API version >= 1 * @reserved: for future use, needs to be initialized to zero * * Structure used by VDUSE_IOTLB_GET_INFO ioctl to get information of * one IOVA region. */struct vduse_iova_info { __u64 start; __u64 last;#define VDUSE_IOVA_CAP_UMEM (1 << 0) __u64 capability; __u32 asid; /* Only if device API version >= 1 */ __u32 reserved[5];};
/* * Find the first IOVA region that overlaps with the range [start, last] * and return some information on it. Caller should set start and last fields. */#define VDUSE_IOTLB_GET_INFO _IOWR(VDUSE_BASE, 0x1a, struct vduse_iova_info)
/** * struct vduse_iotlb_entry_v2 - entry of IOTLB to describe one IOVA region * * @v1: the original vduse_iotlb_entry * @asid: address space ID of the IOVA region * @reserved: for future use, needs to be initialized to zero * * Structure used by VDUSE_IOTLB_GET_FD2 ioctl to find an overlapped IOVA region. */struct vduse_iotlb_entry_v2 { __u64 offset; __u64 start; __u64 last; __u8 perm; __u8 padding[7]; __u32 asid; __u32 reserved[11];};
/* * Same as VDUSE_IOTLB_GET_FD but with vduse_iotlb_entry_v2 argument that * support extra fields. */#define VDUSE_IOTLB_GET_FD2 _IOWR(VDUSE_BASE, 0x1b, struct vduse_iotlb_entry_v2)
/* The control messages definition for read(2)/write(2) on /dev/vduse/$NAME */
/** * enum vduse_req_type - request type * @VDUSE_GET_VQ_STATE: get the state for specified virtqueue from userspace * @VDUSE_SET_STATUS: set the device status * @VDUSE_UPDATE_IOTLB: Notify userspace to update the memory mapping for * specified IOVA range via VDUSE_IOTLB_GET_FD ioctl * @VDUSE_SET_VQ_GROUP_ASID: Notify userspace to update the address space of a * virtqueue group. */enum vduse_req_type { VDUSE_GET_VQ_STATE, VDUSE_SET_STATUS, VDUSE_UPDATE_IOTLB, VDUSE_SET_VQ_GROUP_ASID, VDUSE_SET_VQ_READY, VDUSE_SUSPEND,};
/** * struct vduse_vq_state - virtqueue state * @index: virtqueue index * @split: split virtqueue state * @packed: packed virtqueue state */struct vduse_vq_state { __u32 index; union { struct vduse_vq_state_split split; struct vduse_vq_state_packed packed; };};
/** * struct vduse_dev_status - device status * @status: device status */struct vduse_dev_status { __u8 status;};
/** * struct vduse_iova_range - IOVA range [start, last] * @start: start of the IOVA range * @last: last of the IOVA range */struct vduse_iova_range { __u64 start; __u64 last;};
/** * struct vduse_iova_range_v2 - IOVA range [start, last] if API_VERSION >= 1 * @start: start of the IOVA range * @last: last of the IOVA range * @asid: address space ID of the IOVA range */struct vduse_iova_range_v2 { __u64 start; __u64 last; __u32 asid; __u32 padding;};
/** * struct vduse_vq_ready - Virtqueue ready request message * @num: Virtqueue number */struct vduse_vq_ready { __u32 num; __u32 ready;};
/** * struct vduse_dev_request - control request * @type: request type * @request_id: request id * @reserved: for future use * @vq_state: virtqueue state, only index field is available * @s: device status * @iova: IOVA range for updating * @iova_v2: IOVA range for updating if API_VERSION >= 1 * @vq_group_asid: ASID of a virtqueue group * @vq_ready: Virtqueue ready request * @padding: padding * * Structure used by read(2) on /dev/vduse/$NAME. */struct vduse_dev_request { __u32 type; __u32 request_id; __u32 reserved[4]; union { struct vduse_vq_state vq_state; struct vduse_dev_status s; struct vduse_iova_range iova; /* Following members but padding exist only if vduse api * version >= 1 */ struct vduse_iova_range_v2 iova_v2; struct vduse_vq_group_asid vq_group_asid;
/* Only if VDUSE_F_QUEUE_READY is negotiated */ struct vduse_vq_ready vq_ready;
__u32 padding[32]; };};
/** * struct vduse_dev_response - response to control request * @request_id: corresponding request id * @result: the result of request * @reserved: for future use, needs to be initialized to zero * @vq_state: virtqueue state * @padding: padding * * Structure used by write(2) on /dev/vduse/$NAME. */struct vduse_dev_response { __u32 request_id;#define VDUSE_REQ_RESULT_OK 0x00#define VDUSE_REQ_RESULT_FAILED 0x01 __u32 result; __u32 reserved[4]; union { struct vduse_vq_state vq_state; __u32 padding[32]; };};
#endif /* _UAPI_VDUSE_H_ */