xref: /linux/arch/x86/kvm/ioapic.h (revision ab93e0dd72c37d378dd936f031ffb83ff2bd87ce)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __KVM_IO_APIC_H
3 #define __KVM_IO_APIC_H
4 
5 #include <linux/kvm_host.h>
6 #include <kvm/iodev.h>
7 #include "irq.h"
8 
9 struct kvm;
10 struct kvm_vcpu;
11 
12 #define IOAPIC_NUM_PINS  KVM_IOAPIC_NUM_PINS
13 #define MAX_NR_RESERVED_IOAPIC_PINS KVM_MAX_IRQ_ROUTES
14 #define IOAPIC_VERSION_ID 0x11	/* IOAPIC version */
15 #define IOAPIC_EDGE_TRIG  0
16 #define IOAPIC_LEVEL_TRIG 1
17 
18 #define IOAPIC_DEFAULT_BASE_ADDRESS  0xfec00000
19 #define IOAPIC_MEM_LENGTH            0x100
20 
21 /* Direct registers. */
22 #define IOAPIC_REG_SELECT  0x00
23 #define IOAPIC_REG_WINDOW  0x10
24 
25 /* Indirect registers. */
26 #define IOAPIC_REG_APIC_ID 0x00	/* x86 IOAPIC only */
27 #define IOAPIC_REG_VERSION 0x01
28 #define IOAPIC_REG_ARB_ID  0x02	/* x86 IOAPIC only */
29 
30 /*ioapic delivery mode*/
31 #define	IOAPIC_FIXED			0x0
32 #define	IOAPIC_LOWEST_PRIORITY		0x1
33 #define	IOAPIC_PMI			0x2
34 #define	IOAPIC_NMI			0x4
35 #define	IOAPIC_INIT			0x5
36 #define	IOAPIC_EXTINT			0x7
37 
38 #define RTC_GSI 8
39 
40 struct dest_map {
41 	/* vcpu bitmap where IRQ has been sent */
42 	DECLARE_BITMAP(map, KVM_MAX_VCPU_IDS);
43 
44 	/*
45 	 * Vector sent to a given vcpu, only valid when
46 	 * the vcpu's bit in map is set
47 	 */
48 	u8 vectors[KVM_MAX_VCPU_IDS];
49 };
50 
51 
52 struct rtc_status {
53 	int pending_eoi;
54 	struct dest_map dest_map;
55 };
56 
57 union kvm_ioapic_redirect_entry {
58 	u64 bits;
59 	struct {
60 		u8 vector;
61 		u8 delivery_mode:3;
62 		u8 dest_mode:1;
63 		u8 delivery_status:1;
64 		u8 polarity:1;
65 		u8 remote_irr:1;
66 		u8 trig_mode:1;
67 		u8 mask:1;
68 		u8 reserve:7;
69 		u8 reserved[4];
70 		u8 dest_id;
71 	} fields;
72 };
73 
74 struct kvm_ioapic {
75 	u64 base_address;
76 	u32 ioregsel;
77 	u32 id;
78 	u32 irr;
79 	u32 pad;
80 	union kvm_ioapic_redirect_entry redirtbl[IOAPIC_NUM_PINS];
81 	unsigned long irq_states[IOAPIC_NUM_PINS];
82 	struct kvm_io_device dev;
83 	struct kvm *kvm;
84 	spinlock_t lock;
85 	struct rtc_status rtc_status;
86 	struct delayed_work eoi_inject;
87 	u32 irq_eoi[IOAPIC_NUM_PINS];
88 	u32 irr_delivered;
89 
90 	/* reads protected by irq_srcu, writes by irq_lock */
91 	struct hlist_head mask_notifier_list;
92 };
93 
94 struct kvm_irq_mask_notifier {
95 	void (*func)(struct kvm_irq_mask_notifier *kimn, bool masked);
96 	int irq;
97 	struct hlist_node link;
98 };
99 
100 void kvm_register_irq_mask_notifier(struct kvm *kvm, int irq,
101 				    struct kvm_irq_mask_notifier *kimn);
102 void kvm_unregister_irq_mask_notifier(struct kvm *kvm, int irq,
103 				      struct kvm_irq_mask_notifier *kimn);
104 void kvm_fire_mask_notifiers(struct kvm *kvm, unsigned irqchip, unsigned pin,
105 			     bool mask);
106 
107 #ifdef DEBUG
108 #define ASSERT(x)  							\
109 do {									\
110 	if (!(x)) {							\
111 		printk(KERN_EMERG "assertion failed %s: %d: %s\n",	\
112 		       __FILE__, __LINE__, #x);				\
113 		BUG();							\
114 	}								\
115 } while (0)
116 #else
117 #define ASSERT(x) do { } while (0)
118 #endif
119 
ioapic_in_kernel(struct kvm * kvm)120 static inline int ioapic_in_kernel(struct kvm *kvm)
121 {
122 	return irqchip_full(kvm);
123 }
124 
125 void kvm_rtc_eoi_tracking_restore_one(struct kvm_vcpu *vcpu);
126 void kvm_ioapic_update_eoi(struct kvm_vcpu *vcpu, int vector,
127 			int trigger_mode);
128 int kvm_ioapic_init(struct kvm *kvm);
129 void kvm_ioapic_destroy(struct kvm *kvm);
130 int kvm_ioapic_set_irq(struct kvm_kernel_irq_routing_entry *e, struct kvm *kvm,
131 		       int irq_source_id, int level, bool line_status);
132 
133 void kvm_get_ioapic(struct kvm *kvm, struct kvm_ioapic_state *state);
134 void kvm_set_ioapic(struct kvm *kvm, struct kvm_ioapic_state *state);
135 void kvm_ioapic_scan_entry(struct kvm_vcpu *vcpu,
136 			   ulong *ioapic_handled_vectors);
137 void kvm_scan_ioapic_routes(struct kvm_vcpu *vcpu,
138 			    ulong *ioapic_handled_vectors);
139 void kvm_scan_ioapic_irq(struct kvm_vcpu *vcpu, u32 dest_id, u16 dest_mode,
140 			 u8 vector, unsigned long *ioapic_handled_vectors);
141 #endif
142