Commit | Line | Data |
---|---|---|
0f2a6619 S |
1 | /* |
2 | * | |
3 | * Copyright (c) 2011, Microsoft Corporation. | |
4 | * | |
5 | * This program is free software; you can redistribute it and/or modify it | |
6 | * under the terms and conditions of the GNU General Public License, | |
7 | * version 2, as published by the Free Software Foundation. | |
8 | * | |
9 | * This program is distributed in the hope it will be useful, but WITHOUT | |
10 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
11 | * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for | |
12 | * more details. | |
13 | * | |
14 | * You should have received a copy of the GNU General Public License along with | |
15 | * this program; if not, write to the Free Software Foundation, Inc., 59 Temple | |
16 | * Place - Suite 330, Boston, MA 02111-1307 USA. | |
17 | * | |
18 | * Authors: | |
19 | * Haiyang Zhang <haiyangz@microsoft.com> | |
20 | * Hank Janssen <hjanssen@microsoft.com> | |
21 | * K. Y. Srinivasan <kys@microsoft.com> | |
22 | * | |
23 | */ | |
24 | ||
25 | #ifndef _HYPERV_VMBUS_H | |
26 | #define _HYPERV_VMBUS_H | |
27 | ||
43c698b9 S |
28 | #include <linux/list.h> |
29 | #include <asm/sync_bitops.h> | |
30 | #include <linux/atomic.h> | |
46a97191 | 31 | #include <linux/hyperv.h> |
37cdd991 | 32 | #include <linux/interrupt.h> |
43c698b9 | 33 | |
c0b200cf S |
34 | /* |
35 | * Timeout for services such as KVP and fcopy. | |
36 | */ | |
37 | #define HV_UTIL_TIMEOUT 30 | |
38 | ||
4dbfc2e6 VK |
39 | /* |
40 | * Timeout for guest-host handshake for services. | |
41 | */ | |
d7edd31b | 42 | #define HV_UTIL_NEGO_TIMEOUT 55 |
4dbfc2e6 | 43 | |
5c1bec61 SH |
44 | /* Define synthetic interrupt controller flag constants. */ |
45 | #define HV_EVENT_FLAGS_COUNT (256 * 8) | |
46 | #define HV_EVENT_FLAGS_LONG_COUNT (256 / sizeof(unsigned long)) | |
afbdc4a9 | 47 | |
4061ed9e S |
48 | /* |
49 | * Timer configuration register. | |
50 | */ | |
51 | union hv_timer_config { | |
52 | u64 as_uint64; | |
53 | struct { | |
54 | u64 enable:1; | |
55 | u64 periodic:1; | |
56 | u64 lazy:1; | |
57 | u64 auto_enable:1; | |
58 | u64 reserved_z0:12; | |
59 | u64 sintx:4; | |
60 | u64 reserved_z1:44; | |
61 | }; | |
62 | }; | |
63 | ||
afbdc4a9 | 64 | |
afbdc4a9 S |
65 | /* Define the synthetic interrupt controller event flags format. */ |
66 | union hv_synic_event_flags { | |
5c1bec61 | 67 | unsigned long flags[HV_EVENT_FLAGS_LONG_COUNT]; |
afbdc4a9 S |
68 | }; |
69 | ||
afbdc4a9 S |
70 | /* Define SynIC control register. */ |
71 | union hv_synic_scontrol { | |
72 | u64 as_uint64; | |
73 | struct { | |
74 | u64 enable:1; | |
75 | u64 reserved:63; | |
76 | }; | |
77 | }; | |
78 | ||
79 | /* Define synthetic interrupt source. */ | |
80 | union hv_synic_sint { | |
81 | u64 as_uint64; | |
82 | struct { | |
83 | u64 vector:8; | |
84 | u64 reserved1:8; | |
85 | u64 masked:1; | |
86 | u64 auto_eoi:1; | |
87 | u64 reserved2:46; | |
88 | }; | |
89 | }; | |
90 | ||
91 | /* Define the format of the SIMP register */ | |
92 | union hv_synic_simp { | |
93 | u64 as_uint64; | |
94 | struct { | |
95 | u64 simp_enabled:1; | |
96 | u64 preserved:11; | |
97 | u64 base_simp_gpa:52; | |
98 | }; | |
99 | }; | |
100 | ||
101 | /* Define the format of the SIEFP register */ | |
102 | union hv_synic_siefp { | |
103 | u64 as_uint64; | |
104 | struct { | |
105 | u64 siefp_enabled:1; | |
106 | u64 preserved:11; | |
107 | u64 base_siefp_gpa:52; | |
108 | }; | |
109 | }; | |
110 | ||
111 | /* Definitions for the monitored notification facility */ | |
112 | union hv_monitor_trigger_group { | |
113 | u64 as_uint64; | |
114 | struct { | |
115 | u32 pending; | |
116 | u32 armed; | |
117 | }; | |
118 | }; | |
119 | ||
120 | struct hv_monitor_parameter { | |
121 | union hv_connection_id connectionid; | |
122 | u16 flagnumber; | |
123 | u16 rsvdz; | |
124 | }; | |
125 | ||
126 | union hv_monitor_trigger_state { | |
127 | u32 asu32; | |
128 | ||
129 | struct { | |
130 | u32 group_enable:4; | |
131 | u32 rsvdz:28; | |
132 | }; | |
133 | }; | |
134 | ||
135 | /* struct hv_monitor_page Layout */ | |
136 | /* ------------------------------------------------------ */ | |
137 | /* | 0 | TriggerState (4 bytes) | Rsvd1 (4 bytes) | */ | |
138 | /* | 8 | TriggerGroup[0] | */ | |
139 | /* | 10 | TriggerGroup[1] | */ | |
140 | /* | 18 | TriggerGroup[2] | */ | |
141 | /* | 20 | TriggerGroup[3] | */ | |
142 | /* | 28 | Rsvd2[0] | */ | |
143 | /* | 30 | Rsvd2[1] | */ | |
144 | /* | 38 | Rsvd2[2] | */ | |
145 | /* | 40 | NextCheckTime[0][0] | NextCheckTime[0][1] | */ | |
146 | /* | ... | */ | |
147 | /* | 240 | Latency[0][0..3] | */ | |
148 | /* | 340 | Rsvz3[0] | */ | |
149 | /* | 440 | Parameter[0][0] | */ | |
150 | /* | 448 | Parameter[0][1] | */ | |
151 | /* | ... | */ | |
152 | /* | 840 | Rsvd4[0] | */ | |
153 | /* ------------------------------------------------------ */ | |
154 | struct hv_monitor_page { | |
155 | union hv_monitor_trigger_state trigger_state; | |
156 | u32 rsvdz1; | |
157 | ||
158 | union hv_monitor_trigger_group trigger_group[4]; | |
159 | u64 rsvdz2[3]; | |
160 | ||
161 | s32 next_checktime[4][32]; | |
162 | ||
163 | u16 latency[4][32]; | |
164 | u64 rsvdz3[32]; | |
165 | ||
166 | struct hv_monitor_parameter parameter[4][32]; | |
167 | ||
168 | u8 rsvdz4[1984]; | |
169 | }; | |
170 | ||
8e27a236 S |
171 | #define HV_HYPERCALL_PARAM_ALIGN sizeof(u64) |
172 | ||
afbdc4a9 S |
173 | /* Definition of the hv_post_message hypercall input structure. */ |
174 | struct hv_input_post_message { | |
175 | union hv_connection_id connectionid; | |
176 | u32 reserved; | |
7797dcf6 | 177 | u32 message_type; |
afbdc4a9 S |
178 | u32 payload_size; |
179 | u64 payload[HV_MESSAGE_PAYLOAD_QWORD_COUNT]; | |
180 | }; | |
181 | ||
afbdc4a9 | 182 | |
3645a917 S |
183 | enum { |
184 | VMBUS_MESSAGE_CONNECTION_ID = 1, | |
185 | VMBUS_MESSAGE_PORT_ID = 1, | |
186 | VMBUS_EVENT_CONNECTION_ID = 2, | |
187 | VMBUS_EVENT_PORT_ID = 2, | |
188 | VMBUS_MONITOR_CONNECTION_ID = 3, | |
189 | VMBUS_MONITOR_PORT_ID = 3, | |
190 | VMBUS_MESSAGE_SINT = 2, | |
191 | }; | |
192 | ||
37cdd991 SH |
193 | /* |
194 | * Per cpu state for channel handling | |
195 | */ | |
196 | struct hv_per_cpu_context { | |
197 | void *synic_message_page; | |
198 | void *synic_event_page; | |
199 | /* | |
200 | * buffer to post messages to the host. | |
201 | */ | |
202 | void *post_msg_page; | |
203 | ||
204 | /* | |
205 | * Starting with win8, we can take channel interrupts on any CPU; | |
206 | * we will manage the tasklet that handles events messages on a per CPU | |
207 | * basis. | |
208 | */ | |
37cdd991 SH |
209 | struct tasklet_struct msg_dpc; |
210 | ||
211 | /* | |
212 | * To optimize the mapping of relid to channel, maintain | |
213 | * per-cpu list of the channels based on their CPU affinity. | |
214 | */ | |
215 | struct list_head chan_list; | |
216 | struct clock_event_device *clk_evt; | |
217 | }; | |
218 | ||
3645a917 S |
219 | struct hv_context { |
220 | /* We only support running on top of Hyper-V | |
2a9d7de2 SH |
221 | * So at this point this really can only contain the Hyper-V ID |
222 | */ | |
3645a917 S |
223 | u64 guestid; |
224 | ||
ca9357bd | 225 | void *tsc_page; |
3645a917 S |
226 | |
227 | bool synic_initialized; | |
228 | ||
37cdd991 SH |
229 | struct hv_per_cpu_context __percpu *cpu_context; |
230 | ||
917ea427 S |
231 | /* |
232 | * Hypervisor's notion of virtual processor ID is different from | |
233 | * Linux' notion of CPU ID. This information can only be retrieved | |
234 | * in the context of the calling CPU. Setup a map for easy access | |
235 | * to this information: | |
236 | * | |
237 | * vp_index[a] is the Hyper-V's processor ID corresponding to | |
238 | * Linux cpuid 'a'. | |
239 | */ | |
240 | u32 vp_index[NR_CPUS]; | |
37cdd991 | 241 | |
9f01ec53 S |
242 | /* |
243 | * To manage allocations in a NUMA node. | |
244 | * Array indexed by numa node ID. | |
245 | */ | |
246 | struct cpumask *hv_numa_map; | |
3645a917 S |
247 | }; |
248 | ||
249 | extern struct hv_context hv_context; | |
250 | ||
3645a917 S |
251 | /* Hv Interface */ |
252 | ||
253 | extern int hv_init(void); | |
254 | ||
415f0a02 | 255 | extern int hv_post_message(union hv_connection_id connection_id, |
3645a917 S |
256 | enum hv_message_type message_type, |
257 | void *payload, size_t payload_size); | |
258 | ||
2608fb65 JW |
259 | extern int hv_synic_alloc(void); |
260 | ||
261 | extern void hv_synic_free(void); | |
262 | ||
76d36ab7 | 263 | extern int hv_synic_init(unsigned int cpu); |
3645a917 | 264 | |
76d36ab7 | 265 | extern int hv_synic_cleanup(unsigned int cpu); |
3645a917 | 266 | |
e086748c VK |
267 | extern void hv_synic_clockevents_cleanup(void); |
268 | ||
940655c1 S |
269 | /* Interface */ |
270 | ||
271 | ||
9988ce68 VK |
272 | int hv_ringbuffer_init(struct hv_ring_buffer_info *ring_info, |
273 | struct page *pages, u32 pagecnt); | |
940655c1 S |
274 | |
275 | void hv_ringbuffer_cleanup(struct hv_ring_buffer_info *ring_info); | |
276 | ||
1f6ee4e7 | 277 | int hv_ringbuffer_write(struct vmbus_channel *channel, |
e4165a0f | 278 | const struct kvec *kv_list, u32 kv_count); |
940655c1 | 279 | |
3372592a | 280 | int hv_ringbuffer_read(struct vmbus_channel *channel, |
940b68e2 | 281 | void *buffer, u32 buflen, u32 *buffer_actual_len, |
3372592a | 282 | u64 *requestid, bool raw); |
940655c1 | 283 | |
89b2ca47 S |
284 | /* |
285 | * Maximum channels is determined by the size of the interrupt page | |
286 | * which is PAGE_SIZE. 1/2 of PAGE_SIZE is for send endpoint interrupt | |
287 | * and the other is receive endpoint interrupt | |
288 | */ | |
289 | #define MAX_NUM_CHANNELS ((PAGE_SIZE >> 1) << 3) /* 16348 channels */ | |
290 | ||
291 | /* The value here must be in multiple of 32 */ | |
292 | /* TODO: Need to make this configurable */ | |
293 | #define MAX_NUM_CHANNELS_SUPPORTED 256 | |
294 | ||
295 | ||
296 | enum vmbus_connect_state { | |
297 | DISCONNECTED, | |
298 | CONNECTING, | |
299 | CONNECTED, | |
300 | DISCONNECTING | |
301 | }; | |
302 | ||
303 | #define MAX_SIZE_CHANNEL_MESSAGE HV_MESSAGE_PAYLOAD_BYTE_COUNT | |
304 | ||
305 | struct vmbus_connection { | |
306 | enum vmbus_connect_state conn_state; | |
307 | ||
308 | atomic_t next_gpadl_handle; | |
309 | ||
2db84eff | 310 | struct completion unload_event; |
89b2ca47 S |
311 | /* |
312 | * Represents channel interrupts. Each bit position represents a | |
313 | * channel. When a channel sends an interrupt via VMBUS, it finds its | |
314 | * bit in the sendInterruptPage, set it and calls Hv to generate a port | |
315 | * event. The other end receives the port event and parse the | |
316 | * recvInterruptPage to see which bit is set | |
317 | */ | |
318 | void *int_page; | |
319 | void *send_int_page; | |
320 | void *recv_int_page; | |
321 | ||
322 | /* | |
323 | * 2 pages - 1st page for parent->child notification and 2nd | |
324 | * is child->parent notification | |
325 | */ | |
8681db44 | 326 | struct hv_monitor_page *monitor_pages[2]; |
89b2ca47 S |
327 | struct list_head chn_msg_list; |
328 | spinlock_t channelmsg_lock; | |
329 | ||
330 | /* List of channels */ | |
331 | struct list_head chn_list; | |
d6f591e3 | 332 | struct mutex channel_mutex; |
89b2ca47 S |
333 | |
334 | struct workqueue_struct *work_queue; | |
335 | }; | |
336 | ||
337 | ||
338 | struct vmbus_msginfo { | |
339 | /* Bookkeeping stuff */ | |
340 | struct list_head msglist_entry; | |
341 | ||
342 | /* The message itself */ | |
343 | unsigned char msg[0]; | |
344 | }; | |
345 | ||
346 | ||
347 | extern struct vmbus_connection vmbus_connection; | |
348 | ||
5c1bec61 SH |
349 | static inline void vmbus_send_interrupt(u32 relid) |
350 | { | |
351 | sync_set_bit(relid, vmbus_connection.send_int_page); | |
352 | } | |
353 | ||
652594c7 DC |
354 | enum vmbus_message_handler_type { |
355 | /* The related handler can sleep. */ | |
356 | VMHT_BLOCKING = 0, | |
357 | ||
358 | /* The related handler must NOT sleep. */ | |
359 | VMHT_NON_BLOCKING = 1, | |
360 | }; | |
361 | ||
362 | struct vmbus_channel_message_table_entry { | |
363 | enum vmbus_channel_message_type message_type; | |
364 | enum vmbus_message_handler_type handler_type; | |
365 | void (*message_handler)(struct vmbus_channel_message_header *msg); | |
366 | }; | |
367 | ||
e6242fa0 | 368 | extern const struct vmbus_channel_message_table_entry |
652594c7 DC |
369 | channel_message_table[CHANNELMSG_COUNT]; |
370 | ||
0f70b669 | 371 | |
89b2ca47 S |
372 | /* General vmbus interface */ |
373 | ||
1b9d48f2 | 374 | struct hv_device *vmbus_device_create(const uuid_le *type, |
375 | const uuid_le *instance, | |
376 | struct vmbus_channel *channel); | |
89b2ca47 | 377 | |
22794281 | 378 | int vmbus_device_register(struct hv_device *child_device_obj); |
696453ba | 379 | void vmbus_device_unregister(struct hv_device *device_obj); |
89b2ca47 | 380 | |
d43e2fe7 | 381 | struct vmbus_channel *relid2channel(u32 relid); |
89b2ca47 | 382 | |
93e5bd06 | 383 | void vmbus_free_channels(void); |
89b2ca47 S |
384 | |
385 | /* Connection interface */ | |
386 | ||
387 | int vmbus_connect(void); | |
09a19628 | 388 | void vmbus_disconnect(void); |
89b2ca47 | 389 | |
c0bb0392 | 390 | int vmbus_post_msg(void *buffer, size_t buflen, bool can_sleep); |
89b2ca47 | 391 | |
89b2ca47 | 392 | void vmbus_on_event(unsigned long data); |
d81274aa | 393 | void vmbus_on_msg_dpc(unsigned long data); |
89b2ca47 | 394 | |
2a9d7de2 | 395 | int hv_kvp_init(struct hv_util_service *srv); |
3647a83d | 396 | void hv_kvp_deinit(void); |
2a9d7de2 | 397 | void hv_kvp_onchannelcallback(void *context); |
3647a83d | 398 | |
2a9d7de2 | 399 | int hv_vss_init(struct hv_util_service *srv); |
3647a83d | 400 | void hv_vss_deinit(void); |
2a9d7de2 | 401 | void hv_vss_onchannelcallback(void *context); |
3647a83d | 402 | |
2a9d7de2 | 403 | int hv_fcopy_init(struct hv_util_service *srv); |
01325476 | 404 | void hv_fcopy_deinit(void); |
2a9d7de2 | 405 | void hv_fcopy_onchannelcallback(void *context); |
75ff3a8a | 406 | void vmbus_initiate_unload(bool crash); |
01325476 | 407 | |
8efe78fd VK |
408 | static inline void hv_poll_channel(struct vmbus_channel *channel, |
409 | void (*cb)(void *)) | |
410 | { | |
411 | if (!channel) | |
412 | return; | |
413 | ||
3cace4a6 | 414 | smp_call_function_single(channel->target_cpu, cb, channel, true); |
8efe78fd | 415 | } |
89b2ca47 | 416 | |
636c88da VK |
417 | enum hvutil_device_state { |
418 | HVUTIL_DEVICE_INIT = 0, /* driver is loaded, waiting for userspace */ | |
419 | HVUTIL_READY, /* userspace is registered */ | |
420 | HVUTIL_HOSTMSG_RECEIVED, /* message from the host was received */ | |
421 | HVUTIL_USERSPACE_REQ, /* request to userspace was sent */ | |
422 | HVUTIL_USERSPACE_RECV, /* reply from userspace was received */ | |
423 | HVUTIL_DEVICE_DYING, /* driver unload is in progress */ | |
424 | }; | |
425 | ||
0f2a6619 | 426 | #endif /* _HYPERV_VMBUS_H */ |