1 /* SPDX-License-Identifier: GPL-2.0 */
3 * definition for kvm on s390
5 * Copyright IBM Corp. 2008, 2020
12 #ifndef ARCH_S390_KVM_S390_H
13 #define ARCH_S390_KVM_S390_H
15 #include <linux/hrtimer.h>
16 #include <linux/kvm.h>
17 #include <linux/kvm_host.h>
18 #include <linux/lockdep.h>
19 #include <asm/facility.h>
20 #include <asm/processor.h>
23 /* Transactional Memory Execution related macros */
24 #define IS_TE_ENABLED(vcpu) ((vcpu->arch.sie_block->ecb & ECB_TE))
26 #define IS_ITDB_VALID(vcpu) \
27 ((*(char *)phys_to_virt((vcpu)->arch.sie_block->itdba) == TDB_FORMAT1))
29 extern debug_info_t *kvm_s390_dbf;
30 extern debug_info_t *kvm_s390_dbf_uv;
32 #define KVM_UV_EVENT(d_kvm, d_loglevel, d_string, d_args...)\
34 debug_sprintf_event((d_kvm)->arch.dbf, d_loglevel, d_string "\n", \
36 debug_sprintf_event(kvm_s390_dbf_uv, d_loglevel, \
37 "%d: " d_string "\n", (d_kvm)->userspace_pid, \
41 #define KVM_EVENT(d_loglevel, d_string, d_args...)\
43 debug_sprintf_event(kvm_s390_dbf, d_loglevel, d_string "\n", \
47 #define VM_EVENT(d_kvm, d_loglevel, d_string, d_args...)\
49 debug_sprintf_event(d_kvm->arch.dbf, d_loglevel, d_string "\n", \
53 #define VCPU_EVENT(d_vcpu, d_loglevel, d_string, d_args...)\
55 debug_sprintf_event(d_vcpu->kvm->arch.dbf, d_loglevel, \
56 "%02d[%016lx-%016lx]: " d_string "\n", d_vcpu->vcpu_id, \
57 d_vcpu->arch.sie_block->gpsw.mask, d_vcpu->arch.sie_block->gpsw.addr,\
61 static inline void kvm_s390_set_cpuflags(struct kvm_vcpu *vcpu, u32 flags)
63 atomic_or(flags, &vcpu->arch.sie_block->cpuflags);
66 static inline void kvm_s390_clear_cpuflags(struct kvm_vcpu *vcpu, u32 flags)
68 atomic_andnot(flags, &vcpu->arch.sie_block->cpuflags);
71 static inline bool kvm_s390_test_cpuflags(struct kvm_vcpu *vcpu, u32 flags)
73 return (atomic_read(&vcpu->arch.sie_block->cpuflags) & flags) == flags;
76 static inline int is_vcpu_stopped(struct kvm_vcpu *vcpu)
78 return kvm_s390_test_cpuflags(vcpu, CPUSTAT_STOPPED);
81 static inline int is_vcpu_idle(struct kvm_vcpu *vcpu)
83 return test_bit(vcpu->vcpu_idx, vcpu->kvm->arch.idle_mask);
86 static inline int kvm_is_ucontrol(struct kvm *kvm)
88 #ifdef CONFIG_KVM_S390_UCONTROL
97 #define GUEST_PREFIX_SHIFT 13
98 static inline u32 kvm_s390_get_prefix(struct kvm_vcpu *vcpu)
100 return vcpu->arch.sie_block->prefix << GUEST_PREFIX_SHIFT;
103 static inline void kvm_s390_set_prefix(struct kvm_vcpu *vcpu, u32 prefix)
105 VCPU_EVENT(vcpu, 3, "set prefix of cpu %03u to 0x%x", vcpu->vcpu_id,
107 vcpu->arch.sie_block->prefix = prefix >> GUEST_PREFIX_SHIFT;
108 kvm_make_request(KVM_REQ_TLB_FLUSH, vcpu);
109 kvm_make_request(KVM_REQ_REFRESH_GUEST_PREFIX, vcpu);
112 static inline u64 kvm_s390_get_base_disp_s(struct kvm_vcpu *vcpu, u8 *ar)
114 u32 base2 = vcpu->arch.sie_block->ipb >> 28;
115 u32 disp2 = ((vcpu->arch.sie_block->ipb & 0x0fff0000) >> 16);
120 return (base2 ? vcpu->run->s.regs.gprs[base2] : 0) + disp2;
123 static inline void kvm_s390_get_base_disp_sse(struct kvm_vcpu *vcpu,
124 u64 *address1, u64 *address2,
125 u8 *ar_b1, u8 *ar_b2)
127 u32 base1 = (vcpu->arch.sie_block->ipb & 0xf0000000) >> 28;
128 u32 disp1 = (vcpu->arch.sie_block->ipb & 0x0fff0000) >> 16;
129 u32 base2 = (vcpu->arch.sie_block->ipb & 0xf000) >> 12;
130 u32 disp2 = vcpu->arch.sie_block->ipb & 0x0fff;
132 *address1 = (base1 ? vcpu->run->s.regs.gprs[base1] : 0) + disp1;
133 *address2 = (base2 ? vcpu->run->s.regs.gprs[base2] : 0) + disp2;
141 static inline void kvm_s390_get_regs_rre(struct kvm_vcpu *vcpu, int *r1, int *r2)
144 *r1 = (vcpu->arch.sie_block->ipb & 0x00f00000) >> 20;
146 *r2 = (vcpu->arch.sie_block->ipb & 0x000f0000) >> 16;
149 static inline u64 kvm_s390_get_base_disp_rsy(struct kvm_vcpu *vcpu, u8 *ar)
151 u32 base2 = vcpu->arch.sie_block->ipb >> 28;
152 u32 disp2 = ((vcpu->arch.sie_block->ipb & 0x0fff0000) >> 16) +
153 ((vcpu->arch.sie_block->ipb & 0xff00) << 4);
154 /* The displacement is a 20bit _SIGNED_ value */
161 return (base2 ? vcpu->run->s.regs.gprs[base2] : 0) + (long)(int)disp2;
164 static inline u64 kvm_s390_get_base_disp_rs(struct kvm_vcpu *vcpu, u8 *ar)
166 u32 base2 = vcpu->arch.sie_block->ipb >> 28;
167 u32 disp2 = ((vcpu->arch.sie_block->ipb & 0x0fff0000) >> 16);
172 return (base2 ? vcpu->run->s.regs.gprs[base2] : 0) + disp2;
175 /* Set the condition code in the guest program status word */
176 static inline void kvm_s390_set_psw_cc(struct kvm_vcpu *vcpu, unsigned long cc)
178 vcpu->arch.sie_block->gpsw.mask &= ~(3UL << 44);
179 vcpu->arch.sie_block->gpsw.mask |= cc << 44;
182 /* test availability of facility in a kvm instance */
183 static inline int test_kvm_facility(struct kvm *kvm, unsigned long nr)
185 return __test_facility(nr, kvm->arch.model.fac_mask) &&
186 __test_facility(nr, kvm->arch.model.fac_list);
189 static inline int set_kvm_facility(u64 *fac_list, unsigned long nr)
193 if (nr >= MAX_FACILITY_BIT)
195 ptr = (unsigned char *) fac_list + (nr >> 3);
196 *ptr |= (0x80UL >> (nr & 7));
200 static inline int test_kvm_cpu_feat(struct kvm *kvm, unsigned long nr)
202 WARN_ON_ONCE(nr >= KVM_S390_VM_CPU_FEAT_NR_BITS);
203 return test_bit_inv(nr, kvm->arch.cpu_feat);
206 /* are cpu states controlled by user space */
207 static inline int kvm_s390_user_cpu_state_ctrl(struct kvm *kvm)
209 return kvm->arch.user_cpu_state_ctrl != 0;
212 static inline void kvm_s390_set_user_cpu_state_ctrl(struct kvm *kvm)
214 if (kvm->arch.user_cpu_state_ctrl)
217 VM_EVENT(kvm, 3, "%s", "ENABLE: Userspace CPU state control");
218 kvm->arch.user_cpu_state_ctrl = 1;
221 /* get the end gfn of the last (highest gfn) memslot */
222 static inline unsigned long kvm_s390_get_gfn_end(struct kvm_memslots *slots)
224 struct rb_node *node;
225 struct kvm_memory_slot *ms;
227 if (WARN_ON(kvm_memslots_empty(slots)))
230 node = rb_last(&slots->gfn_tree);
231 ms = container_of(node, struct kvm_memory_slot, gfn_node[slots->node_idx]);
232 return ms->base_gfn + ms->npages;
235 static inline u32 kvm_s390_get_gisa_desc(struct kvm *kvm)
237 u32 gd = virt_to_phys(kvm->arch.gisa_int.origin);
239 if (gd && sclp.has_gisaf)
244 /* implemented in pv.c */
245 int kvm_s390_pv_destroy_cpu(struct kvm_vcpu *vcpu, u16 *rc, u16 *rrc);
246 int kvm_s390_pv_create_cpu(struct kvm_vcpu *vcpu, u16 *rc, u16 *rrc);
247 int kvm_s390_pv_set_aside(struct kvm *kvm, u16 *rc, u16 *rrc);
248 int kvm_s390_pv_deinit_aside_vm(struct kvm *kvm, u16 *rc, u16 *rrc);
249 int kvm_s390_pv_deinit_cleanup_all(struct kvm *kvm, u16 *rc, u16 *rrc);
250 int kvm_s390_pv_deinit_vm(struct kvm *kvm, u16 *rc, u16 *rrc);
251 int kvm_s390_pv_init_vm(struct kvm *kvm, u16 *rc, u16 *rrc);
252 int kvm_s390_pv_set_sec_parms(struct kvm *kvm, void *hdr, u64 length, u16 *rc,
254 int kvm_s390_pv_unpack(struct kvm *kvm, unsigned long addr, unsigned long size,
255 unsigned long tweak, u16 *rc, u16 *rrc);
256 int kvm_s390_pv_set_cpu_state(struct kvm_vcpu *vcpu, u8 state);
257 int kvm_s390_pv_dump_cpu(struct kvm_vcpu *vcpu, void *buff, u16 *rc, u16 *rrc);
258 int kvm_s390_pv_dump_stor_state(struct kvm *kvm, void __user *buff_user,
259 u64 *gaddr, u64 buff_user_len, u16 *rc, u16 *rrc);
260 int kvm_s390_pv_dump_complete(struct kvm *kvm, void __user *buff_user,
263 static inline u64 kvm_s390_pv_get_handle(struct kvm *kvm)
265 return kvm->arch.pv.handle;
268 static inline u64 kvm_s390_pv_cpu_get_handle(struct kvm_vcpu *vcpu)
270 return vcpu->arch.pv.handle;
273 static inline bool kvm_s390_pv_is_protected(struct kvm *kvm)
275 lockdep_assert_held(&kvm->lock);
276 return !!kvm_s390_pv_get_handle(kvm);
279 static inline bool kvm_s390_pv_cpu_is_protected(struct kvm_vcpu *vcpu)
281 lockdep_assert_held(&vcpu->mutex);
282 return !!kvm_s390_pv_cpu_get_handle(vcpu);
285 /* implemented in interrupt.c */
286 int kvm_s390_handle_wait(struct kvm_vcpu *vcpu);
287 void kvm_s390_vcpu_wakeup(struct kvm_vcpu *vcpu);
288 enum hrtimer_restart kvm_s390_idle_wakeup(struct hrtimer *timer);
289 int __must_check kvm_s390_deliver_pending_interrupts(struct kvm_vcpu *vcpu);
290 void kvm_s390_clear_local_irqs(struct kvm_vcpu *vcpu);
291 void kvm_s390_clear_float_irqs(struct kvm *kvm);
292 int __must_check kvm_s390_inject_vm(struct kvm *kvm,
293 struct kvm_s390_interrupt *s390int);
294 int __must_check kvm_s390_inject_vcpu(struct kvm_vcpu *vcpu,
295 struct kvm_s390_irq *irq);
296 static inline int kvm_s390_inject_prog_irq(struct kvm_vcpu *vcpu,
297 struct kvm_s390_pgm_info *pgm_info)
299 struct kvm_s390_irq irq = {
300 .type = KVM_S390_PROGRAM_INT,
304 return kvm_s390_inject_vcpu(vcpu, &irq);
306 static inline int kvm_s390_inject_program_int(struct kvm_vcpu *vcpu, u16 code)
308 struct kvm_s390_irq irq = {
309 .type = KVM_S390_PROGRAM_INT,
313 return kvm_s390_inject_vcpu(vcpu, &irq);
315 struct kvm_s390_interrupt_info *kvm_s390_get_io_int(struct kvm *kvm,
316 u64 isc_mask, u32 schid);
317 int kvm_s390_reinject_io_int(struct kvm *kvm,
318 struct kvm_s390_interrupt_info *inti);
319 int kvm_s390_mask_adapter(struct kvm *kvm, unsigned int id, bool masked);
321 /* implemented in intercept.c */
322 u8 kvm_s390_get_ilen(struct kvm_vcpu *vcpu);
323 int kvm_handle_sie_intercept(struct kvm_vcpu *vcpu);
324 static inline void kvm_s390_rewind_psw(struct kvm_vcpu *vcpu, int ilen)
326 struct kvm_s390_sie_block *sie_block = vcpu->arch.sie_block;
328 sie_block->gpsw.addr = __rewind_psw(sie_block->gpsw, ilen);
330 static inline void kvm_s390_forward_psw(struct kvm_vcpu *vcpu, int ilen)
332 kvm_s390_rewind_psw(vcpu, -ilen);
334 static inline void kvm_s390_retry_instr(struct kvm_vcpu *vcpu)
336 /* don't inject PER events if we re-execute the instruction */
337 vcpu->arch.sie_block->icptstatus &= ~0x02;
338 kvm_s390_rewind_psw(vcpu, kvm_s390_get_ilen(vcpu));
341 int handle_sthyi(struct kvm_vcpu *vcpu);
343 /* implemented in priv.c */
344 int is_valid_psw(psw_t *psw);
345 int kvm_s390_handle_aa(struct kvm_vcpu *vcpu);
346 int kvm_s390_handle_b2(struct kvm_vcpu *vcpu);
347 int kvm_s390_handle_e3(struct kvm_vcpu *vcpu);
348 int kvm_s390_handle_e5(struct kvm_vcpu *vcpu);
349 int kvm_s390_handle_01(struct kvm_vcpu *vcpu);
350 int kvm_s390_handle_b9(struct kvm_vcpu *vcpu);
351 int kvm_s390_handle_lpsw(struct kvm_vcpu *vcpu);
352 int kvm_s390_handle_stctl(struct kvm_vcpu *vcpu);
353 int kvm_s390_handle_lctl(struct kvm_vcpu *vcpu);
354 int kvm_s390_handle_eb(struct kvm_vcpu *vcpu);
355 int kvm_s390_skey_check_enable(struct kvm_vcpu *vcpu);
357 /* implemented in vsie.c */
358 int kvm_s390_handle_vsie(struct kvm_vcpu *vcpu);
359 void kvm_s390_vsie_kick(struct kvm_vcpu *vcpu);
360 void kvm_s390_vsie_gmap_notifier(struct gmap *gmap, unsigned long start,
362 void kvm_s390_vsie_init(struct kvm *kvm);
363 void kvm_s390_vsie_destroy(struct kvm *kvm);
365 /* implemented in sigp.c */
366 int kvm_s390_handle_sigp(struct kvm_vcpu *vcpu);
367 int kvm_s390_handle_sigp_pei(struct kvm_vcpu *vcpu);
369 /* implemented in kvm-s390.c */
370 int kvm_s390_try_set_tod_clock(struct kvm *kvm, const struct kvm_s390_vm_tod_clock *gtod);
371 long kvm_arch_fault_in_page(struct kvm_vcpu *vcpu, gpa_t gpa, int writable);
372 int kvm_s390_store_status_unloaded(struct kvm_vcpu *vcpu, unsigned long addr);
373 int kvm_s390_vcpu_store_status(struct kvm_vcpu *vcpu, unsigned long addr);
374 int kvm_s390_vcpu_start(struct kvm_vcpu *vcpu);
375 int kvm_s390_vcpu_stop(struct kvm_vcpu *vcpu);
376 void kvm_s390_vcpu_block(struct kvm_vcpu *vcpu);
377 void kvm_s390_vcpu_unblock(struct kvm_vcpu *vcpu);
378 bool kvm_s390_vcpu_sie_inhibited(struct kvm_vcpu *vcpu);
379 void exit_sie(struct kvm_vcpu *vcpu);
380 void kvm_s390_sync_request(int req, struct kvm_vcpu *vcpu);
381 int kvm_s390_vcpu_setup_cmma(struct kvm_vcpu *vcpu);
382 void kvm_s390_vcpu_unsetup_cmma(struct kvm_vcpu *vcpu);
383 void kvm_s390_set_cpu_timer(struct kvm_vcpu *vcpu, __u64 cputm);
384 __u64 kvm_s390_get_cpu_timer(struct kvm_vcpu *vcpu);
385 int kvm_s390_cpus_from_pv(struct kvm *kvm, u16 *rc, u16 *rrc);
387 /* implemented in diag.c */
388 int kvm_s390_handle_diag(struct kvm_vcpu *vcpu);
390 static inline void kvm_s390_vcpu_block_all(struct kvm *kvm)
393 struct kvm_vcpu *vcpu;
395 WARN_ON(!mutex_is_locked(&kvm->lock));
396 kvm_for_each_vcpu(i, vcpu, kvm)
397 kvm_s390_vcpu_block(vcpu);
400 static inline void kvm_s390_vcpu_unblock_all(struct kvm *kvm)
403 struct kvm_vcpu *vcpu;
405 kvm_for_each_vcpu(i, vcpu, kvm)
406 kvm_s390_vcpu_unblock(vcpu);
409 static inline u64 kvm_s390_get_tod_clock_fast(struct kvm *kvm)
414 rc = get_tod_clock_fast() + kvm->arch.epoch;
420 * kvm_s390_inject_prog_cond - conditionally inject a program check
422 * @rc: original return/error code
424 * This function is supposed to be used after regular guest access functions
425 * failed, to conditionally inject a program check to a vcpu. The typical
426 * pattern would look like
428 * rc = write_guest(vcpu, addr, data, len);
430 * return kvm_s390_inject_prog_cond(vcpu, rc);
432 * A negative return code from guest access functions implies an internal error
433 * like e.g. out of memory. In these cases no program check should be injected
435 * A positive value implies that an exception happened while accessing a guest's
436 * memory. In this case all data belonging to the corresponding program check
437 * has been stored in vcpu->arch.pgm and can be injected with
438 * kvm_s390_inject_prog_irq().
440 * Returns: - the original @rc value if @rc was negative (internal error)
441 * - zero if @rc was already zero
442 * - zero or error code from injecting if @rc was positive
443 * (program check injected to @vcpu)
445 static inline int kvm_s390_inject_prog_cond(struct kvm_vcpu *vcpu, int rc)
449 return kvm_s390_inject_prog_irq(vcpu, &vcpu->arch.pgm);
452 int s390int_to_s390irq(struct kvm_s390_interrupt *s390int,
453 struct kvm_s390_irq *s390irq);
455 /* implemented in interrupt.c */
456 int kvm_s390_vcpu_has_irq(struct kvm_vcpu *vcpu, int exclude_stop);
457 int psw_extint_disabled(struct kvm_vcpu *vcpu);
458 void kvm_s390_destroy_adapters(struct kvm *kvm);
459 int kvm_s390_ext_call_pending(struct kvm_vcpu *vcpu);
460 extern struct kvm_device_ops kvm_flic_ops;
461 int kvm_s390_is_stop_irq_pending(struct kvm_vcpu *vcpu);
462 int kvm_s390_is_restart_irq_pending(struct kvm_vcpu *vcpu);
463 void kvm_s390_clear_stop_irq(struct kvm_vcpu *vcpu);
464 int kvm_s390_set_irq_state(struct kvm_vcpu *vcpu,
465 void __user *buf, int len);
466 int kvm_s390_get_irq_state(struct kvm_vcpu *vcpu,
467 __u8 __user *buf, int len);
468 void kvm_s390_gisa_init(struct kvm *kvm);
469 void kvm_s390_gisa_clear(struct kvm *kvm);
470 void kvm_s390_gisa_destroy(struct kvm *kvm);
471 void kvm_s390_gisa_disable(struct kvm *kvm);
472 void kvm_s390_gisa_enable(struct kvm *kvm);
473 int kvm_s390_gib_init(u8 nisc);
474 void kvm_s390_gib_destroy(void);
476 /* implemented in guestdbg.c */
477 void kvm_s390_backup_guest_per_regs(struct kvm_vcpu *vcpu);
478 void kvm_s390_restore_guest_per_regs(struct kvm_vcpu *vcpu);
479 void kvm_s390_patch_guest_per_regs(struct kvm_vcpu *vcpu);
480 int kvm_s390_import_bp_data(struct kvm_vcpu *vcpu,
481 struct kvm_guest_debug *dbg);
482 void kvm_s390_clear_bp_data(struct kvm_vcpu *vcpu);
483 void kvm_s390_prepare_debug_exit(struct kvm_vcpu *vcpu);
484 int kvm_s390_handle_per_ifetch_icpt(struct kvm_vcpu *vcpu);
485 int kvm_s390_handle_per_event(struct kvm_vcpu *vcpu);
487 /* support for Basic/Extended SCA handling */
488 static inline union ipte_control *kvm_s390_get_ipte_control(struct kvm *kvm)
490 struct bsca_block *sca = kvm->arch.sca; /* SCA version doesn't matter */
492 return &sca->ipte_control;
494 static inline int kvm_s390_use_sca_entries(void)
497 * Without SIGP interpretation, only SRS interpretation (if available)
498 * might use the entries. By not setting the entries and keeping them
499 * invalid, hardware will not access them but intercept.
501 return sclp.has_sigpif;
503 void kvm_s390_reinject_machine_check(struct kvm_vcpu *vcpu,
504 struct mcck_volatile_info *mcck_info);
507 * kvm_s390_vcpu_crypto_reset_all
509 * Reset the crypto attributes for each vcpu. This can be done while the vcpus
510 * are running as each vcpu will be removed from SIE before resetting the crypt
511 * attributes and restored to SIE afterward.
513 * Note: The kvm->lock must be held while calling this function
515 * @kvm: the KVM guest
517 void kvm_s390_vcpu_crypto_reset_all(struct kvm *kvm);
520 * kvm_s390_vcpu_pci_enable_interp
522 * Set the associated PCI attributes for each vcpu to allow for zPCI Load/Store
523 * interpretation as well as adapter interruption forwarding.
525 * @kvm: the KVM guest
527 void kvm_s390_vcpu_pci_enable_interp(struct kvm *kvm);
530 * diag9c_forwarding_hz
532 * Set the maximum number of diag9c forwarding per second
534 extern unsigned int diag9c_forwarding_hz;