mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-27 03:10:12 +00:00
4c8cf31885
This patch introduces a vDPA-based vhost backend. This backend is built on top of the same interface defined in virtio-vDPA and provides a generic vhost interface for userspace to accelerate the virtio devices in guest. This backend is implemented as a vDPA device driver on top of the same ops used in virtio-vDPA. It will create char device entry named vhost-vdpa-$index for userspace to use. Userspace can use vhost ioctls on top of this char device to setup the backend. Vhost ioctls are extended to make it type agnostic and behave like a virtio device, this help to eliminate type specific API like what vhost_net/scsi/vsock did: - VHOST_VDPA_GET_DEVICE_ID: get the virtio device ID which is defined by virtio specification to differ from different type of devices - VHOST_VDPA_GET_VRING_NUM: get the maximum size of virtqueue supported by the vDPA device - VHSOT_VDPA_SET/GET_STATUS: set and get virtio status of vDPA device - VHOST_VDPA_SET/GET_CONFIG: access virtio config space - VHOST_VDPA_SET_VRING_ENABLE: enable a specific virtqueue For memory mapping, IOTLB API is mandated for vhost-vDPA which means userspace drivers are required to use VHOST_IOTLB_UPDATE/VHOST_IOTLB_INVALIDATE to add or remove mapping for a specific userspace memory region. The vhost-vDPA API is designed to be type agnostic, but it allows net device only in current stage. Due to the lacking of control virtqueue support, some features were filter out by vhost-vdpa. We will enable more features and devices in the near future. Signed-off-by: Tiwei Bie <tiwei.bie@intel.com> Signed-off-by: Eugenio Pérez <eperezma@redhat.com> Signed-off-by: Jason Wang <jasowang@redhat.com> Link: https://lore.kernel.org/r/20200326140125.19794-8-jasowang@redhat.com Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
136 lines
3.2 KiB
C
136 lines
3.2 KiB
C
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
|
#ifndef _LINUX_VHOST_TYPES_H
|
|
#define _LINUX_VHOST_TYPES_H
|
|
/* Userspace interface for in-kernel virtio accelerators. */
|
|
|
|
/* vhost is used to reduce the number of system calls involved in virtio.
|
|
*
|
|
* Existing virtio net code is used in the guest without modification.
|
|
*
|
|
* This header includes interface used by userspace hypervisor for
|
|
* device configuration.
|
|
*/
|
|
|
|
#include <linux/types.h>
|
|
#include <linux/compiler.h>
|
|
#include <linux/virtio_config.h>
|
|
#include <linux/virtio_ring.h>
|
|
|
|
struct vhost_vring_state {
|
|
unsigned int index;
|
|
unsigned int num;
|
|
};
|
|
|
|
struct vhost_vring_file {
|
|
unsigned int index;
|
|
int fd; /* Pass -1 to unbind from file. */
|
|
|
|
};
|
|
|
|
struct vhost_vring_addr {
|
|
unsigned int index;
|
|
/* Option flags. */
|
|
unsigned int flags;
|
|
/* Flag values: */
|
|
/* Whether log address is valid. If set enables logging. */
|
|
#define VHOST_VRING_F_LOG 0
|
|
|
|
/* Start of array of descriptors (virtually contiguous) */
|
|
__u64 desc_user_addr;
|
|
/* Used structure address. Must be 32 bit aligned */
|
|
__u64 used_user_addr;
|
|
/* Available structure address. Must be 16 bit aligned */
|
|
__u64 avail_user_addr;
|
|
/* Logging support. */
|
|
/* Log writes to used structure, at offset calculated from specified
|
|
* address. Address must be 32 bit aligned. */
|
|
__u64 log_guest_addr;
|
|
};
|
|
|
|
/* no alignment requirement */
|
|
struct vhost_iotlb_msg {
|
|
__u64 iova;
|
|
__u64 size;
|
|
__u64 uaddr;
|
|
#define VHOST_ACCESS_RO 0x1
|
|
#define VHOST_ACCESS_WO 0x2
|
|
#define VHOST_ACCESS_RW 0x3
|
|
__u8 perm;
|
|
#define VHOST_IOTLB_MISS 1
|
|
#define VHOST_IOTLB_UPDATE 2
|
|
#define VHOST_IOTLB_INVALIDATE 3
|
|
#define VHOST_IOTLB_ACCESS_FAIL 4
|
|
__u8 type;
|
|
};
|
|
|
|
#define VHOST_IOTLB_MSG 0x1
|
|
#define VHOST_IOTLB_MSG_V2 0x2
|
|
|
|
struct vhost_msg {
|
|
int type;
|
|
union {
|
|
struct vhost_iotlb_msg iotlb;
|
|
__u8 padding[64];
|
|
};
|
|
};
|
|
|
|
struct vhost_msg_v2 {
|
|
__u32 type;
|
|
__u32 reserved;
|
|
union {
|
|
struct vhost_iotlb_msg iotlb;
|
|
__u8 padding[64];
|
|
};
|
|
};
|
|
|
|
struct vhost_memory_region {
|
|
__u64 guest_phys_addr;
|
|
__u64 memory_size; /* bytes */
|
|
__u64 userspace_addr;
|
|
__u64 flags_padding; /* No flags are currently specified. */
|
|
};
|
|
|
|
/* All region addresses and sizes must be 4K aligned. */
|
|
#define VHOST_PAGE_SIZE 0x1000
|
|
|
|
struct vhost_memory {
|
|
__u32 nregions;
|
|
__u32 padding;
|
|
struct vhost_memory_region regions[0];
|
|
};
|
|
|
|
/* VHOST_SCSI specific definitions */
|
|
|
|
/*
|
|
* Used by QEMU userspace to ensure a consistent vhost-scsi ABI.
|
|
*
|
|
* ABI Rev 0: July 2012 version starting point for v3.6-rc merge candidate +
|
|
* RFC-v2 vhost-scsi userspace. Add GET_ABI_VERSION ioctl usage
|
|
* ABI Rev 1: January 2013. Ignore vhost_tpgt field in struct vhost_scsi_target.
|
|
* All the targets under vhost_wwpn can be seen and used by guset.
|
|
*/
|
|
|
|
#define VHOST_SCSI_ABI_VERSION 1
|
|
|
|
struct vhost_scsi_target {
|
|
int abi_version;
|
|
char vhost_wwpn[224]; /* TRANSPORT_IQN_LEN */
|
|
unsigned short vhost_tpgt;
|
|
unsigned short reserved;
|
|
};
|
|
|
|
/* VHOST_VDPA specific definitions */
|
|
|
|
struct vhost_vdpa_config {
|
|
__u32 off;
|
|
__u32 len;
|
|
__u8 buf[0];
|
|
};
|
|
|
|
/* Feature bits */
|
|
/* Log all write descriptors. Can be changed while device is active. */
|
|
#define VHOST_F_LOG_ALL 26
|
|
/* vhost-net should add virtio_net_hdr for RX, and strip for TX packets. */
|
|
#define VHOST_NET_F_VIRTIO_NET_HDR 27
|
|
|
|
#endif
|