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