1/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ 2#ifndef _LINUX_VHOST_TYPES_H 3#define _LINUX_VHOST_TYPES_H 4/* Userspace interface for in-kernel virtio accelerators. */ 5 6/* vhost is used to reduce the number of system calls involved in virtio. 7 * 8 * Existing virtio net code is used in the guest without modification. 9 * 10 * This header includes interface used by userspace hypervisor for 11 * device configuration. 12 */ 13 14#include <linux/types.h> 15#include <linux/compiler.h> 16#include <linux/virtio_config.h> 17#include <linux/virtio_ring.h> 18 19struct vhost_vring_state { 20 unsigned int index; 21 unsigned int num; 22}; 23 24struct vhost_vring_file { 25 unsigned int index; 26 int fd; /* Pass -1 to unbind from file. */ 27 28}; 29 30struct vhost_vring_addr { 31 unsigned int index; 32 /* Option flags. */ 33 unsigned int flags; 34 /* Flag values: */ 35 /* Whether log address is valid. If set enables logging. */ 36#define VHOST_VRING_F_LOG 0 37 38 /* Start of array of descriptors (virtually contiguous) */ 39 __u64 desc_user_addr; 40 /* Used structure address. Must be 32 bit aligned */ 41 __u64 used_user_addr; 42 /* Available structure address. Must be 16 bit aligned */ 43 __u64 avail_user_addr; 44 /* Logging support. */ 45 /* Log writes to used structure, at offset calculated from specified 46 * address. Address must be 32 bit aligned. */ 47 __u64 log_guest_addr; 48}; 49 50struct vhost_worker_state { 51 /* 52 * For VHOST_NEW_WORKER the kernel will return the new vhost_worker id. 53 * For VHOST_FREE_WORKER this must be set to the id of the vhost_worker 54 * to free. 55 */ 56 unsigned int worker_id; 57}; 58 59struct vhost_vring_worker { 60 /* vring index */ 61 unsigned int index; 62 /* The id of the vhost_worker returned from VHOST_NEW_WORKER */ 63 unsigned int worker_id; 64}; 65 66/* no alignment requirement */ 67struct vhost_iotlb_msg { 68 __u64 iova; 69 __u64 size; 70 __u64 uaddr; 71#define VHOST_ACCESS_RO 0x1 72#define VHOST_ACCESS_WO 0x2 73#define VHOST_ACCESS_RW 0x3 74 __u8 perm; 75#define VHOST_IOTLB_MISS 1 76#define VHOST_IOTLB_UPDATE 2 77#define VHOST_IOTLB_INVALIDATE 3 78#define VHOST_IOTLB_ACCESS_FAIL 4 79/* 80 * VHOST_IOTLB_BATCH_BEGIN and VHOST_IOTLB_BATCH_END allow modifying 81 * multiple mappings in one go: beginning with 82 * VHOST_IOTLB_BATCH_BEGIN, followed by any number of 83 * VHOST_IOTLB_UPDATE messages, and ending with VHOST_IOTLB_BATCH_END. 84 * When one of these two values is used as the message type, the rest 85 * of the fields in the message are ignored. There's no guarantee that 86 * these changes take place automatically in the device. 87 */ 88#define VHOST_IOTLB_BATCH_BEGIN 5 89#define VHOST_IOTLB_BATCH_END 6 90 __u8 type; 91}; 92 93#define VHOST_IOTLB_MSG 0x1 94#define VHOST_IOTLB_MSG_V2 0x2 95 96struct vhost_msg { 97 int type; 98 union { 99 struct vhost_iotlb_msg iotlb; 100 __u8 padding[64]; 101 }; 102}; 103 104struct vhost_msg_v2 { 105 __u32 type; 106 __u32 asid; 107 union { 108 struct vhost_iotlb_msg iotlb; 109 __u8 padding[64]; 110 }; 111}; 112 113struct vhost_memory_region { 114 __u64 guest_phys_addr; 115 __u64 memory_size; /* bytes */ 116 __u64 userspace_addr; 117 __u64 flags_padding; /* No flags are currently specified. */ 118}; 119 120/* All region addresses and sizes must be 4K aligned. */ 121#define VHOST_PAGE_SIZE 0x1000 122 123struct vhost_memory { 124 __u32 nregions; 125 __u32 padding; 126 struct vhost_memory_region regions[]; 127}; 128 129/* VHOST_SCSI specific definitions */ 130 131/* 132 * Used by QEMU userspace to ensure a consistent vhost-scsi ABI. 133 * 134 * ABI Rev 0: July 2012 version starting point for v3.6-rc merge candidate + 135 * RFC-v2 vhost-scsi userspace. Add GET_ABI_VERSION ioctl usage 136 * ABI Rev 1: January 2013. Ignore vhost_tpgt field in struct vhost_scsi_target. 137 * All the targets under vhost_wwpn can be seen and used by guset. 138 */ 139 140#define VHOST_SCSI_ABI_VERSION 1 141 142struct vhost_scsi_target { 143 int abi_version; 144 char vhost_wwpn[224]; /* TRANSPORT_IQN_LEN */ 145 unsigned short vhost_tpgt; 146 unsigned short reserved; 147}; 148 149/* VHOST_VDPA specific definitions */ 150 151struct vhost_vdpa_config { 152 __u32 off; 153 __u32 len; 154 __u8 buf[]; 155}; 156 157/* vhost vdpa IOVA range 158 * @first: First address that can be mapped by vhost-vDPA 159 * @last: Last address that can be mapped by vhost-vDPA 160 */ 161struct vhost_vdpa_iova_range { 162 __u64 first; 163 __u64 last; 164}; 165 166/* Feature bits */ 167/* Log all write descriptors. Can be changed while device is active. */ 168#define VHOST_F_LOG_ALL 26 169/* vhost-net should add virtio_net_hdr for RX, and strip for TX packets. */ 170#define VHOST_NET_F_VIRTIO_NET_HDR 27 171 172/* Use message type V2 */ 173#define VHOST_BACKEND_F_IOTLB_MSG_V2 0x1 174/* IOTLB can accept batching hints */ 175#define VHOST_BACKEND_F_IOTLB_BATCH 0x2 176/* IOTLB can accept address space identifier through V2 type of IOTLB 177 * message 178 */ 179#define VHOST_BACKEND_F_IOTLB_ASID 0x3 180/* Device can be suspended */ 181#define VHOST_BACKEND_F_SUSPEND 0x4 182/* Device can be resumed */ 183#define VHOST_BACKEND_F_RESUME 0x5 184/* Device supports the driver enabling virtqueues both before and after 185 * DRIVER_OK 186 */ 187#define VHOST_BACKEND_F_ENABLE_AFTER_DRIVER_OK 0x6 188/* Device may expose the virtqueue's descriptor area, driver area and 189 * device area to a different group for ASID binding than where its 190 * buffers may reside. Requires VHOST_BACKEND_F_IOTLB_ASID. 191 */ 192#define VHOST_BACKEND_F_DESC_ASID 0x7 193/* IOTLB don't flush memory mapping across device reset */ 194#define VHOST_BACKEND_F_IOTLB_PERSIST 0x8 195 196#endif 197