sphinx/qapidoc: Drop code to generate doc for simple union tag
[qemu/kevin.git] / linux-headers / asm-s390 / kvm.h
blob023a2763a97cee85f58b006acb0e6f6f4b784619
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 #ifndef __LINUX_KVM_S390_H
3 #define __LINUX_KVM_S390_H
4 /*
5 * KVM s390 specific structures and definitions
7 * Copyright IBM Corp. 2008, 2018
9 * Author(s): Carsten Otte <cotte@de.ibm.com>
10 * Christian Borntraeger <borntraeger@de.ibm.com>
12 #include <linux/types.h>
14 #define __KVM_S390
15 #define __KVM_HAVE_GUEST_DEBUG
17 /* Device control API: s390-specific devices */
18 #define KVM_DEV_FLIC_GET_ALL_IRQS 1
19 #define KVM_DEV_FLIC_ENQUEUE 2
20 #define KVM_DEV_FLIC_CLEAR_IRQS 3
21 #define KVM_DEV_FLIC_APF_ENABLE 4
22 #define KVM_DEV_FLIC_APF_DISABLE_WAIT 5
23 #define KVM_DEV_FLIC_ADAPTER_REGISTER 6
24 #define KVM_DEV_FLIC_ADAPTER_MODIFY 7
25 #define KVM_DEV_FLIC_CLEAR_IO_IRQ 8
26 #define KVM_DEV_FLIC_AISM 9
27 #define KVM_DEV_FLIC_AIRQ_INJECT 10
28 #define KVM_DEV_FLIC_AISM_ALL 11
30 * We can have up to 4*64k pending subchannels + 8 adapter interrupts,
31 * as well as up to ASYNC_PF_PER_VCPU*KVM_MAX_VCPUS pfault done interrupts.
32 * There are also sclp and machine checks. This gives us
33 * sizeof(kvm_s390_irq)*(4*65536+8+64*64+1+1) = 72 * 266250 = 19170000
34 * Lets round up to 8192 pages.
36 #define KVM_S390_MAX_FLOAT_IRQS 266250
37 #define KVM_S390_FLIC_MAX_BUFFER 0x2000000
39 struct kvm_s390_io_adapter {
40 __u32 id;
41 __u8 isc;
42 __u8 maskable;
43 __u8 swap;
44 __u8 flags;
47 #define KVM_S390_ADAPTER_SUPPRESSIBLE 0x01
49 struct kvm_s390_ais_req {
50 __u8 isc;
51 __u16 mode;
54 struct kvm_s390_ais_all {
55 __u8 simm;
56 __u8 nimm;
59 #define KVM_S390_IO_ADAPTER_MASK 1
60 #define KVM_S390_IO_ADAPTER_MAP 2
61 #define KVM_S390_IO_ADAPTER_UNMAP 3
63 struct kvm_s390_io_adapter_req {
64 __u32 id;
65 __u8 type;
66 __u8 mask;
67 __u16 pad0;
68 __u64 addr;
71 /* kvm attr_group on vm fd */
72 #define KVM_S390_VM_MEM_CTRL 0
73 #define KVM_S390_VM_TOD 1
74 #define KVM_S390_VM_CRYPTO 2
75 #define KVM_S390_VM_CPU_MODEL 3
76 #define KVM_S390_VM_MIGRATION 4
77 #define KVM_S390_VM_CPU_TOPOLOGY 5
79 /* kvm attributes for mem_ctrl */
80 #define KVM_S390_VM_MEM_ENABLE_CMMA 0
81 #define KVM_S390_VM_MEM_CLR_CMMA 1
82 #define KVM_S390_VM_MEM_LIMIT_SIZE 2
84 #define KVM_S390_NO_MEM_LIMIT U64_MAX
86 /* kvm attributes for KVM_S390_VM_TOD */
87 #define KVM_S390_VM_TOD_LOW 0
88 #define KVM_S390_VM_TOD_HIGH 1
89 #define KVM_S390_VM_TOD_EXT 2
91 struct kvm_s390_vm_tod_clock {
92 __u8 epoch_idx;
93 __u64 tod;
96 /* kvm attributes for KVM_S390_VM_CPU_MODEL */
97 /* processor related attributes are r/w */
98 #define KVM_S390_VM_CPU_PROCESSOR 0
99 struct kvm_s390_vm_cpu_processor {
100 __u64 cpuid;
101 __u16 ibc;
102 __u8 pad[6];
103 __u64 fac_list[256];
106 /* machine related attributes are r/o */
107 #define KVM_S390_VM_CPU_MACHINE 1
108 struct kvm_s390_vm_cpu_machine {
109 __u64 cpuid;
110 __u32 ibc;
111 __u8 pad[4];
112 __u64 fac_mask[256];
113 __u64 fac_list[256];
116 #define KVM_S390_VM_CPU_PROCESSOR_FEAT 2
117 #define KVM_S390_VM_CPU_MACHINE_FEAT 3
119 #define KVM_S390_VM_CPU_FEAT_NR_BITS 1024
120 #define KVM_S390_VM_CPU_FEAT_ESOP 0
121 #define KVM_S390_VM_CPU_FEAT_SIEF2 1
122 #define KVM_S390_VM_CPU_FEAT_64BSCAO 2
123 #define KVM_S390_VM_CPU_FEAT_SIIF 3
124 #define KVM_S390_VM_CPU_FEAT_GPERE 4
125 #define KVM_S390_VM_CPU_FEAT_GSLS 5
126 #define KVM_S390_VM_CPU_FEAT_IB 6
127 #define KVM_S390_VM_CPU_FEAT_CEI 7
128 #define KVM_S390_VM_CPU_FEAT_IBS 8
129 #define KVM_S390_VM_CPU_FEAT_SKEY 9
130 #define KVM_S390_VM_CPU_FEAT_CMMA 10
131 #define KVM_S390_VM_CPU_FEAT_PFMFI 11
132 #define KVM_S390_VM_CPU_FEAT_SIGPIF 12
133 #define KVM_S390_VM_CPU_FEAT_KSS 13
134 struct kvm_s390_vm_cpu_feat {
135 __u64 feat[16];
138 #define KVM_S390_VM_CPU_PROCESSOR_SUBFUNC 4
139 #define KVM_S390_VM_CPU_MACHINE_SUBFUNC 5
140 /* for "test bit" instructions MSB 0 bit ordering, for "query" raw blocks */
141 struct kvm_s390_vm_cpu_subfunc {
142 __u8 plo[32]; /* always */
143 __u8 ptff[16]; /* with TOD-clock steering */
144 __u8 kmac[16]; /* with MSA */
145 __u8 kmc[16]; /* with MSA */
146 __u8 km[16]; /* with MSA */
147 __u8 kimd[16]; /* with MSA */
148 __u8 klmd[16]; /* with MSA */
149 __u8 pckmo[16]; /* with MSA3 */
150 __u8 kmctr[16]; /* with MSA4 */
151 __u8 kmf[16]; /* with MSA4 */
152 __u8 kmo[16]; /* with MSA4 */
153 __u8 pcc[16]; /* with MSA4 */
154 __u8 ppno[16]; /* with MSA5 */
155 __u8 kma[16]; /* with MSA8 */
156 __u8 kdsa[16]; /* with MSA9 */
157 __u8 sortl[32]; /* with STFLE.150 */
158 __u8 dfltcc[32]; /* with STFLE.151 */
159 __u8 reserved[1728];
162 #define KVM_S390_VM_CPU_PROCESSOR_UV_FEAT_GUEST 6
163 #define KVM_S390_VM_CPU_MACHINE_UV_FEAT_GUEST 7
165 #define KVM_S390_VM_CPU_UV_FEAT_NR_BITS 64
166 struct kvm_s390_vm_cpu_uv_feat {
167 union {
168 struct {
169 __u64 : 4;
170 __u64 ap : 1; /* bit 4 */
171 __u64 ap_intr : 1; /* bit 5 */
172 __u64 : 58;
174 __u64 feat;
178 /* kvm attributes for crypto */
179 #define KVM_S390_VM_CRYPTO_ENABLE_AES_KW 0
180 #define KVM_S390_VM_CRYPTO_ENABLE_DEA_KW 1
181 #define KVM_S390_VM_CRYPTO_DISABLE_AES_KW 2
182 #define KVM_S390_VM_CRYPTO_DISABLE_DEA_KW 3
183 #define KVM_S390_VM_CRYPTO_ENABLE_APIE 4
184 #define KVM_S390_VM_CRYPTO_DISABLE_APIE 5
186 /* kvm attributes for migration mode */
187 #define KVM_S390_VM_MIGRATION_STOP 0
188 #define KVM_S390_VM_MIGRATION_START 1
189 #define KVM_S390_VM_MIGRATION_STATUS 2
191 /* for KVM_GET_REGS and KVM_SET_REGS */
192 struct kvm_regs {
193 /* general purpose regs for s390 */
194 __u64 gprs[16];
197 /* for KVM_GET_SREGS and KVM_SET_SREGS */
198 struct kvm_sregs {
199 __u32 acrs[16];
200 __u64 crs[16];
203 /* for KVM_GET_FPU and KVM_SET_FPU */
204 struct kvm_fpu {
205 __u32 fpc;
206 __u64 fprs[16];
209 #define KVM_GUESTDBG_USE_HW_BP 0x00010000
211 #define KVM_HW_BP 1
212 #define KVM_HW_WP_WRITE 2
213 #define KVM_SINGLESTEP 4
215 struct kvm_debug_exit_arch {
216 __u64 addr;
217 __u8 type;
218 __u8 pad[7]; /* Should be set to 0 */
221 struct kvm_hw_breakpoint {
222 __u64 addr;
223 __u64 phys_addr;
224 __u64 len;
225 __u8 type;
226 __u8 pad[7]; /* Should be set to 0 */
229 /* for KVM_SET_GUEST_DEBUG */
230 struct kvm_guest_debug_arch {
231 __u32 nr_hw_bp;
232 __u32 pad; /* Should be set to 0 */
233 struct kvm_hw_breakpoint *hw_bp;
236 /* for KVM_SYNC_PFAULT and KVM_REG_S390_PFTOKEN */
237 #define KVM_S390_PFAULT_TOKEN_INVALID 0xffffffffffffffffULL
239 #define KVM_SYNC_PREFIX (1UL << 0)
240 #define KVM_SYNC_GPRS (1UL << 1)
241 #define KVM_SYNC_ACRS (1UL << 2)
242 #define KVM_SYNC_CRS (1UL << 3)
243 #define KVM_SYNC_ARCH0 (1UL << 4)
244 #define KVM_SYNC_PFAULT (1UL << 5)
245 #define KVM_SYNC_VRS (1UL << 6)
246 #define KVM_SYNC_RICCB (1UL << 7)
247 #define KVM_SYNC_FPRS (1UL << 8)
248 #define KVM_SYNC_GSCB (1UL << 9)
249 #define KVM_SYNC_BPBC (1UL << 10)
250 #define KVM_SYNC_ETOKEN (1UL << 11)
251 #define KVM_SYNC_DIAG318 (1UL << 12)
253 #define KVM_SYNC_S390_VALID_FIELDS \
254 (KVM_SYNC_PREFIX | KVM_SYNC_GPRS | KVM_SYNC_ACRS | KVM_SYNC_CRS | \
255 KVM_SYNC_ARCH0 | KVM_SYNC_PFAULT | KVM_SYNC_VRS | KVM_SYNC_RICCB | \
256 KVM_SYNC_FPRS | KVM_SYNC_GSCB | KVM_SYNC_BPBC | KVM_SYNC_ETOKEN | \
257 KVM_SYNC_DIAG318)
259 /* length and alignment of the sdnx as a power of two */
260 #define SDNXC 8
261 #define SDNXL (1UL << SDNXC)
262 /* definition of registers in kvm_run */
263 struct kvm_sync_regs {
264 __u64 prefix; /* prefix register */
265 __u64 gprs[16]; /* general purpose registers */
266 __u32 acrs[16]; /* access registers */
267 __u64 crs[16]; /* control registers */
268 __u64 todpr; /* tod programmable register [ARCH0] */
269 __u64 cputm; /* cpu timer [ARCH0] */
270 __u64 ckc; /* clock comparator [ARCH0] */
271 __u64 pp; /* program parameter [ARCH0] */
272 __u64 gbea; /* guest breaking-event address [ARCH0] */
273 __u64 pft; /* pfault token [PFAULT] */
274 __u64 pfs; /* pfault select [PFAULT] */
275 __u64 pfc; /* pfault compare [PFAULT] */
276 union {
277 __u64 vrs[32][2]; /* vector registers (KVM_SYNC_VRS) */
278 __u64 fprs[16]; /* fp registers (KVM_SYNC_FPRS) */
280 __u8 reserved[512]; /* for future vector expansion */
281 __u32 fpc; /* valid on KVM_SYNC_VRS or KVM_SYNC_FPRS */
282 __u8 bpbc : 1; /* bp mode */
283 __u8 reserved2 : 7;
284 __u8 padding1[51]; /* riccb needs to be 64byte aligned */
285 __u8 riccb[64]; /* runtime instrumentation controls block */
286 __u64 diag318; /* diagnose 0x318 info */
287 __u8 padding2[184]; /* sdnx needs to be 256byte aligned */
288 union {
289 __u8 sdnx[SDNXL]; /* state description annex */
290 struct {
291 __u64 reserved1[2];
292 __u64 gscb[4];
293 __u64 etoken;
294 __u64 etoken_extension;
299 #define KVM_REG_S390_TODPR (KVM_REG_S390 | KVM_REG_SIZE_U32 | 0x1)
300 #define KVM_REG_S390_EPOCHDIFF (KVM_REG_S390 | KVM_REG_SIZE_U64 | 0x2)
301 #define KVM_REG_S390_CPU_TIMER (KVM_REG_S390 | KVM_REG_SIZE_U64 | 0x3)
302 #define KVM_REG_S390_CLOCK_COMP (KVM_REG_S390 | KVM_REG_SIZE_U64 | 0x4)
303 #define KVM_REG_S390_PFTOKEN (KVM_REG_S390 | KVM_REG_SIZE_U64 | 0x5)
304 #define KVM_REG_S390_PFCOMPARE (KVM_REG_S390 | KVM_REG_SIZE_U64 | 0x6)
305 #define KVM_REG_S390_PFSELECT (KVM_REG_S390 | KVM_REG_SIZE_U64 | 0x7)
306 #define KVM_REG_S390_PP (KVM_REG_S390 | KVM_REG_SIZE_U64 | 0x8)
307 #define KVM_REG_S390_GBEA (KVM_REG_S390 | KVM_REG_SIZE_U64 | 0x9)
308 #endif