1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25#ifndef _HYPERV_H
26#define _HYPERV_H
27
28#include <linux/scatterlist.h>
29#include <linux/list.h>
30#include <linux/uuid.h>
31#include <linux/timer.h>
32#include <linux/workqueue.h>
33#include <linux/completion.h>
34#include <linux/device.h>
35#include <linux/mod_devicetable.h>
36
37
38#define MAX_PAGE_BUFFER_COUNT 19
39#define MAX_MULTIPAGE_BUFFER_COUNT 32
40
41#pragma pack(push, 1)
42
43
44struct hv_page_buffer {
45 u32 len;
46 u32 offset;
47 u64 pfn;
48};
49
50
51struct hv_multipage_buffer {
52
53 u32 len;
54 u32 offset;
55 u64 pfn_array[MAX_MULTIPAGE_BUFFER_COUNT];
56};
57
58
59#define MAX_PAGE_BUFFER_PACKET (0x18 + \
60 (sizeof(struct hv_page_buffer) * \
61 MAX_PAGE_BUFFER_COUNT))
62#define MAX_MULTIPAGE_BUFFER_PACKET (0x18 + \
63 sizeof(struct hv_multipage_buffer))
64
65
66#pragma pack(pop)
67
68struct hv_ring_buffer {
69
70 u32 write_index;
71
72
73 u32 read_index;
74
75 u32 interrupt_mask;
76
77
78 u8 reserved[4084];
79
80
81
82
83
84
85
86
87
88
89
90 u8 buffer[0];
91} __packed;
92
93struct hv_ring_buffer_info {
94 struct hv_ring_buffer *ring_buffer;
95 u32 ring_size;
96 spinlock_t ring_lock;
97
98 u32 ring_datasize;
99 u32 ring_data_startoffset;
100};
101
102struct hv_ring_buffer_debug_info {
103 u32 current_interrupt_mask;
104 u32 current_read_index;
105 u32 current_write_index;
106 u32 bytes_avail_toread;
107 u32 bytes_avail_towrite;
108};
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128#define HV_DRV_VERSION "3.1"
129
130
131
132
133
134
135#define VMBUS_REVISION_NUMBER 13
136
137
138#define MAX_PIPE_DATA_PAYLOAD (sizeof(u8) * 16384)
139
140
141#define VMBUS_PIPE_TYPE_BYTE 0x00000000
142#define VMBUS_PIPE_TYPE_MESSAGE 0x00000004
143
144
145#define MAX_USER_DEFINED_BYTES 120
146
147
148#define MAX_PIPE_USER_DEFINED_BYTES 116
149
150
151
152
153
154struct vmbus_channel_offer {
155 uuid_le if_type;
156 uuid_le if_instance;
157 u64 int_latency;
158 u32 if_revision;
159 u32 server_ctx_size;
160 u16 chn_flags;
161 u16 mmio_megabytes;
162
163 union {
164
165 struct {
166 unsigned char user_def[MAX_USER_DEFINED_BYTES];
167 } std;
168
169
170
171
172
173
174
175
176 struct {
177 u32 pipe_mode;
178 unsigned char user_def[MAX_PIPE_USER_DEFINED_BYTES];
179 } pipe;
180 } u;
181 u32 padding;
182} __packed;
183
184
185#define VMBUS_CHANNEL_ENUMERATE_DEVICE_INTERFACE 1
186#define VMBUS_CHANNEL_SERVER_SUPPORTS_TRANSFER_PAGES 2
187#define VMBUS_CHANNEL_SERVER_SUPPORTS_GPADLS 4
188#define VMBUS_CHANNEL_NAMED_PIPE_MODE 0x10
189#define VMBUS_CHANNEL_LOOPBACK_OFFER 0x100
190#define VMBUS_CHANNEL_PARENT_OFFER 0x200
191#define VMBUS_CHANNEL_REQUEST_MONITORED_NOTIFICATION 0x400
192
193struct vmpacket_descriptor {
194 u16 type;
195 u16 offset8;
196 u16 len8;
197 u16 flags;
198 u64 trans_id;
199} __packed;
200
201struct vmpacket_header {
202 u32 prev_pkt_start_offset;
203 struct vmpacket_descriptor descriptor;
204} __packed;
205
206struct vmtransfer_page_range {
207 u32 byte_count;
208 u32 byte_offset;
209} __packed;
210
211struct vmtransfer_page_packet_header {
212 struct vmpacket_descriptor d;
213 u16 xfer_pageset_id;
214 bool sender_owns_set;
215 u8 reserved;
216 u32 range_cnt;
217 struct vmtransfer_page_range ranges[1];
218} __packed;
219
220struct vmgpadl_packet_header {
221 struct vmpacket_descriptor d;
222 u32 gpadl;
223 u32 reserved;
224} __packed;
225
226struct vmadd_remove_transfer_page_set {
227 struct vmpacket_descriptor d;
228 u32 gpadl;
229 u16 xfer_pageset_id;
230 u16 reserved;
231} __packed;
232
233
234
235
236
237struct gpa_range {
238 u32 byte_count;
239 u32 byte_offset;
240 u64 pfn_array[0];
241};
242
243
244
245
246
247
248
249
250struct vmestablish_gpadl {
251 struct vmpacket_descriptor d;
252 u32 gpadl;
253 u32 range_cnt;
254 struct gpa_range range[1];
255} __packed;
256
257
258
259
260
261struct vmteardown_gpadl {
262 struct vmpacket_descriptor d;
263 u32 gpadl;
264 u32 reserved;
265} __packed;
266
267
268
269
270
271struct vmdata_gpa_direct {
272 struct vmpacket_descriptor d;
273 u32 reserved;
274 u32 range_cnt;
275 struct gpa_range range[1];
276} __packed;
277
278
279struct vmadditional_data {
280 struct vmpacket_descriptor d;
281 u64 total_bytes;
282 u32 offset;
283 u32 byte_cnt;
284 unsigned char data[1];
285} __packed;
286
287union vmpacket_largest_possible_header {
288 struct vmpacket_descriptor simple_hdr;
289 struct vmtransfer_page_packet_header xfer_page_hdr;
290 struct vmgpadl_packet_header gpadl_hdr;
291 struct vmadd_remove_transfer_page_set add_rm_xfer_page_hdr;
292 struct vmestablish_gpadl establish_gpadl_hdr;
293 struct vmteardown_gpadl teardown_gpadl_hdr;
294 struct vmdata_gpa_direct data_gpa_direct_hdr;
295};
296
297#define VMPACKET_DATA_START_ADDRESS(__packet) \
298 (void *)(((unsigned char *)__packet) + \
299 ((struct vmpacket_descriptor)__packet)->offset8 * 8)
300
301#define VMPACKET_DATA_LENGTH(__packet) \
302 ((((struct vmpacket_descriptor)__packet)->len8 - \
303 ((struct vmpacket_descriptor)__packet)->offset8) * 8)
304
305#define VMPACKET_TRANSFER_MODE(__packet) \
306 (((struct IMPACT)__packet)->type)
307
308enum vmbus_packet_type {
309 VM_PKT_INVALID = 0x0,
310 VM_PKT_SYNCH = 0x1,
311 VM_PKT_ADD_XFER_PAGESET = 0x2,
312 VM_PKT_RM_XFER_PAGESET = 0x3,
313 VM_PKT_ESTABLISH_GPADL = 0x4,
314 VM_PKT_TEARDOWN_GPADL = 0x5,
315 VM_PKT_DATA_INBAND = 0x6,
316 VM_PKT_DATA_USING_XFER_PAGES = 0x7,
317 VM_PKT_DATA_USING_GPADL = 0x8,
318 VM_PKT_DATA_USING_GPA_DIRECT = 0x9,
319 VM_PKT_CANCEL_REQUEST = 0xa,
320 VM_PKT_COMP = 0xb,
321 VM_PKT_DATA_USING_ADDITIONAL_PKT = 0xc,
322 VM_PKT_ADDITIONAL_DATA = 0xd
323};
324
325#define VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED 1
326
327
328
329enum vmbus_channel_message_type {
330 CHANNELMSG_INVALID = 0,
331 CHANNELMSG_OFFERCHANNEL = 1,
332 CHANNELMSG_RESCIND_CHANNELOFFER = 2,
333 CHANNELMSG_REQUESTOFFERS = 3,
334 CHANNELMSG_ALLOFFERS_DELIVERED = 4,
335 CHANNELMSG_OPENCHANNEL = 5,
336 CHANNELMSG_OPENCHANNEL_RESULT = 6,
337 CHANNELMSG_CLOSECHANNEL = 7,
338 CHANNELMSG_GPADL_HEADER = 8,
339 CHANNELMSG_GPADL_BODY = 9,
340 CHANNELMSG_GPADL_CREATED = 10,
341 CHANNELMSG_GPADL_TEARDOWN = 11,
342 CHANNELMSG_GPADL_TORNDOWN = 12,
343 CHANNELMSG_RELID_RELEASED = 13,
344 CHANNELMSG_INITIATE_CONTACT = 14,
345 CHANNELMSG_VERSION_RESPONSE = 15,
346 CHANNELMSG_UNLOAD = 16,
347#ifdef VMBUS_FEATURE_PARENT_OR_PEER_MEMORY_MAPPED_INTO_A_CHILD
348 CHANNELMSG_VIEWRANGE_ADD = 17,
349 CHANNELMSG_VIEWRANGE_REMOVE = 18,
350#endif
351 CHANNELMSG_COUNT
352};
353
354struct vmbus_channel_message_header {
355 enum vmbus_channel_message_type msgtype;
356 u32 padding;
357} __packed;
358
359
360struct vmbus_channel_query_vmbus_version {
361 struct vmbus_channel_message_header header;
362 u32 version;
363} __packed;
364
365
366struct vmbus_channel_version_supported {
367 struct vmbus_channel_message_header header;
368 bool version_supported;
369} __packed;
370
371
372struct vmbus_channel_offer_channel {
373 struct vmbus_channel_message_header header;
374 struct vmbus_channel_offer offer;
375 u32 child_relid;
376 u8 monitorid;
377 bool monitor_allocated;
378} __packed;
379
380
381struct vmbus_channel_rescind_offer {
382 struct vmbus_channel_message_header header;
383 u32 child_relid;
384} __packed;
385
386
387
388
389
390
391
392
393
394
395
396struct vmbus_channel_open_channel {
397 struct vmbus_channel_message_header header;
398
399
400 u32 child_relid;
401
402
403 u32 openid;
404
405
406 u32 ringbuffer_gpadlhandle;
407
408
409 u32 server_contextarea_gpadlhandle;
410
411
412
413
414
415
416 u32 downstream_ringbuffer_pageoffset;
417
418
419 unsigned char userdata[MAX_USER_DEFINED_BYTES];
420} __packed;
421
422
423struct vmbus_channel_open_result {
424 struct vmbus_channel_message_header header;
425 u32 child_relid;
426 u32 openid;
427 u32 status;
428} __packed;
429
430
431struct vmbus_channel_close_channel {
432 struct vmbus_channel_message_header header;
433 u32 child_relid;
434} __packed;
435
436
437#define GPADL_TYPE_RING_BUFFER 1
438#define GPADL_TYPE_SERVER_SAVE_AREA 2
439#define GPADL_TYPE_TRANSACTION 8
440
441
442
443
444
445
446
447struct vmbus_channel_gpadl_header {
448 struct vmbus_channel_message_header header;
449 u32 child_relid;
450 u32 gpadl;
451 u16 range_buflen;
452 u16 rangecount;
453 struct gpa_range range[0];
454} __packed;
455
456
457struct vmbus_channel_gpadl_body {
458 struct vmbus_channel_message_header header;
459 u32 msgnumber;
460 u32 gpadl;
461 u64 pfn[0];
462} __packed;
463
464struct vmbus_channel_gpadl_created {
465 struct vmbus_channel_message_header header;
466 u32 child_relid;
467 u32 gpadl;
468 u32 creation_status;
469} __packed;
470
471struct vmbus_channel_gpadl_teardown {
472 struct vmbus_channel_message_header header;
473 u32 child_relid;
474 u32 gpadl;
475} __packed;
476
477struct vmbus_channel_gpadl_torndown {
478 struct vmbus_channel_message_header header;
479 u32 gpadl;
480} __packed;
481
482#ifdef VMBUS_FEATURE_PARENT_OR_PEER_MEMORY_MAPPED_INTO_A_CHILD
483struct vmbus_channel_view_range_add {
484 struct vmbus_channel_message_header header;
485 PHYSICAL_ADDRESS viewrange_base;
486 u64 viewrange_length;
487 u32 child_relid;
488} __packed;
489
490struct vmbus_channel_view_range_remove {
491 struct vmbus_channel_message_header header;
492 PHYSICAL_ADDRESS viewrange_base;
493 u32 child_relid;
494} __packed;
495#endif
496
497struct vmbus_channel_relid_released {
498 struct vmbus_channel_message_header header;
499 u32 child_relid;
500} __packed;
501
502struct vmbus_channel_initiate_contact {
503 struct vmbus_channel_message_header header;
504 u32 vmbus_version_requested;
505 u32 padding2;
506 u64 interrupt_page;
507 u64 monitor_page1;
508 u64 monitor_page2;
509} __packed;
510
511struct vmbus_channel_version_response {
512 struct vmbus_channel_message_header header;
513 bool version_supported;
514} __packed;
515
516enum vmbus_channel_state {
517 CHANNEL_OFFER_STATE,
518 CHANNEL_OPENING_STATE,
519 CHANNEL_OPEN_STATE,
520};
521
522struct vmbus_channel_debug_info {
523 u32 relid;
524 enum vmbus_channel_state state;
525 uuid_le interfacetype;
526 uuid_le interface_instance;
527 u32 monitorid;
528 u32 servermonitor_pending;
529 u32 servermonitor_latency;
530 u32 servermonitor_connectionid;
531 u32 clientmonitor_pending;
532 u32 clientmonitor_latency;
533 u32 clientmonitor_connectionid;
534
535 struct hv_ring_buffer_debug_info inbound;
536 struct hv_ring_buffer_debug_info outbound;
537};
538
539
540
541
542
543struct vmbus_channel_msginfo {
544
545 struct list_head msglistentry;
546
547
548 struct list_head submsglist;
549
550
551 struct completion waitevent;
552 union {
553 struct vmbus_channel_version_supported version_supported;
554 struct vmbus_channel_open_result open_result;
555 struct vmbus_channel_gpadl_torndown gpadl_torndown;
556 struct vmbus_channel_gpadl_created gpadl_created;
557 struct vmbus_channel_version_response version_response;
558 } response;
559
560 u32 msgsize;
561
562
563
564
565 unsigned char msg[0];
566};
567
568struct vmbus_close_msg {
569 struct vmbus_channel_msginfo info;
570 struct vmbus_channel_close_channel msg;
571};
572
573struct vmbus_channel {
574 struct list_head listentry;
575
576 struct hv_device *device_obj;
577
578 struct work_struct work;
579
580 enum vmbus_channel_state state;
581
582 struct vmbus_channel_offer_channel offermsg;
583
584
585
586
587 u8 monitor_grp;
588 u8 monitor_bit;
589
590 u32 ringbuffer_gpadlhandle;
591
592
593 void *ringbuffer_pages;
594 u32 ringbuffer_pagecount;
595 struct hv_ring_buffer_info outbound;
596 struct hv_ring_buffer_info inbound;
597 spinlock_t inbound_lock;
598 struct workqueue_struct *controlwq;
599
600 struct vmbus_close_msg close_msg;
601
602
603
604
605 void (*onchannel_callback)(void *context);
606 void *channel_callback_context;
607};
608
609void vmbus_onmessage(void *context);
610
611int vmbus_request_offers(void);
612
613
614struct vmbus_channel_packet_page_buffer {
615 u16 type;
616 u16 dataoffset8;
617 u16 length8;
618 u16 flags;
619 u64 transactionid;
620 u32 reserved;
621 u32 rangecount;
622 struct hv_page_buffer range[MAX_PAGE_BUFFER_COUNT];
623} __packed;
624
625
626struct vmbus_channel_packet_multipage_buffer {
627 u16 type;
628 u16 dataoffset8;
629 u16 length8;
630 u16 flags;
631 u64 transactionid;
632 u32 reserved;
633 u32 rangecount;
634 struct hv_multipage_buffer range;
635} __packed;
636
637
638extern int vmbus_open(struct vmbus_channel *channel,
639 u32 send_ringbuffersize,
640 u32 recv_ringbuffersize,
641 void *userdata,
642 u32 userdatalen,
643 void(*onchannel_callback)(void *context),
644 void *context);
645
646extern void vmbus_close(struct vmbus_channel *channel);
647
648extern int vmbus_sendpacket(struct vmbus_channel *channel,
649 const void *buffer,
650 u32 bufferLen,
651 u64 requestid,
652 enum vmbus_packet_type type,
653 u32 flags);
654
655extern int vmbus_sendpacket_pagebuffer(struct vmbus_channel *channel,
656 struct hv_page_buffer pagebuffers[],
657 u32 pagecount,
658 void *buffer,
659 u32 bufferlen,
660 u64 requestid);
661
662extern int vmbus_sendpacket_multipagebuffer(struct vmbus_channel *channel,
663 struct hv_multipage_buffer *mpb,
664 void *buffer,
665 u32 bufferlen,
666 u64 requestid);
667
668extern int vmbus_establish_gpadl(struct vmbus_channel *channel,
669 void *kbuffer,
670 u32 size,
671 u32 *gpadl_handle);
672
673extern int vmbus_teardown_gpadl(struct vmbus_channel *channel,
674 u32 gpadl_handle);
675
676extern int vmbus_recvpacket(struct vmbus_channel *channel,
677 void *buffer,
678 u32 bufferlen,
679 u32 *buffer_actual_len,
680 u64 *requestid);
681
682extern int vmbus_recvpacket_raw(struct vmbus_channel *channel,
683 void *buffer,
684 u32 bufferlen,
685 u32 *buffer_actual_len,
686 u64 *requestid);
687
688
689extern void vmbus_get_debug_info(struct vmbus_channel *channel,
690 struct vmbus_channel_debug_info *debug);
691
692extern void vmbus_ontimer(unsigned long data);
693
694struct hv_dev_port_info {
695 u32 int_mask;
696 u32 read_idx;
697 u32 write_idx;
698 u32 bytes_avail_toread;
699 u32 bytes_avail_towrite;
700};
701
702
703struct hv_driver {
704 const char *name;
705
706
707 uuid_le dev_type;
708 const struct hv_vmbus_device_id *id_table;
709
710 struct device_driver driver;
711
712 int (*probe)(struct hv_device *, const struct hv_vmbus_device_id *);
713 int (*remove)(struct hv_device *);
714 void (*shutdown)(struct hv_device *);
715
716};
717
718
719struct hv_device {
720
721 uuid_le dev_type;
722
723
724 uuid_le dev_instance;
725
726 struct device device;
727
728 struct vmbus_channel *channel;
729};
730
731
732static inline struct hv_device *device_to_hv_device(struct device *d)
733{
734 return container_of(d, struct hv_device, device);
735}
736
737static inline struct hv_driver *drv_to_hv_drv(struct device_driver *d)
738{
739 return container_of(d, struct hv_driver, driver);
740}
741
742static inline void hv_set_drvdata(struct hv_device *dev, void *data)
743{
744 dev_set_drvdata(&dev->device, data);
745}
746
747static inline void *hv_get_drvdata(struct hv_device *dev)
748{
749 return dev_get_drvdata(&dev->device);
750}
751
752
753#define vmbus_driver_register(driver) \
754 __vmbus_driver_register(driver, THIS_MODULE, KBUILD_MODNAME)
755int __must_check __vmbus_driver_register(struct hv_driver *hv_driver,
756 struct module *owner,
757 const char *mod_name);
758void vmbus_driver_unregister(struct hv_driver *hv_driver);
759
760
761
762
763
764
765
766#define VMBUS_DEVICE(g0, g1, g2, g3, g4, g5, g6, g7, \
767 g8, g9, ga, gb, gc, gd, ge, gf) \
768 .guid = { g0, g1, g2, g3, g4, g5, g6, g7, \
769 g8, g9, ga, gb, gc, gd, ge, gf },
770
771
772
773
774
775#define ICMSGTYPE_NEGOTIATE 0
776#define ICMSGTYPE_HEARTBEAT 1
777#define ICMSGTYPE_KVPEXCHANGE 2
778#define ICMSGTYPE_SHUTDOWN 3
779#define ICMSGTYPE_TIMESYNC 4
780#define ICMSGTYPE_VSS 5
781
782#define ICMSGHDRFLAG_TRANSACTION 1
783#define ICMSGHDRFLAG_REQUEST 2
784#define ICMSGHDRFLAG_RESPONSE 4
785
786#define HV_S_OK 0x00000000
787#define HV_E_FAIL 0x80004005
788#define HV_ERROR_NOT_SUPPORTED 0x80070032
789#define HV_ERROR_MACHINE_LOCKED 0x800704F7
790
791
792
793
794
795
796
797struct hv_util_service {
798 u8 *recv_buffer;
799 void (*util_cb)(void *);
800 int (*util_init)(struct hv_util_service *);
801 void (*util_deinit)(void);
802};
803
804struct vmbuspipe_hdr {
805 u32 flags;
806 u32 msgsize;
807} __packed;
808
809struct ic_version {
810 u16 major;
811 u16 minor;
812} __packed;
813
814struct icmsg_hdr {
815 struct ic_version icverframe;
816 u16 icmsgtype;
817 struct ic_version icvermsg;
818 u16 icmsgsize;
819 u32 status;
820 u8 ictransaction_id;
821 u8 icflags;
822 u8 reserved[2];
823} __packed;
824
825struct icmsg_negotiate {
826 u16 icframe_vercnt;
827 u16 icmsg_vercnt;
828 u32 reserved;
829 struct ic_version icversion_data[1];
830} __packed;
831
832struct shutdown_msg_data {
833 u32 reason_code;
834 u32 timeout_seconds;
835 u32 flags;
836 u8 display_message[2048];
837} __packed;
838
839struct heartbeat_msg_data {
840 u64 seq_num;
841 u32 reserved[8];
842} __packed;
843
844
845#define ICTIMESYNCFLAG_PROBE 0
846#define ICTIMESYNCFLAG_SYNC 1
847#define ICTIMESYNCFLAG_SAMPLE 2
848
849#ifdef __x86_64__
850#define WLTIMEDELTA 116444736000000000L
851#else
852#define WLTIMEDELTA 116444736000000000LL
853#endif
854
855struct ictimesync_data {
856 u64 parenttime;
857 u64 childtime;
858 u64 roundtriptime;
859 u8 flags;
860} __packed;
861
862struct hyperv_service_callback {
863 u8 msg_type;
864 char *log_msg;
865 uuid_le data;
866 struct vmbus_channel *channel;
867 void (*callback) (void *context);
868};
869
870extern void vmbus_prep_negotiate_resp(struct icmsg_hdr *,
871 struct icmsg_negotiate *, u8 *);
872
873#endif
874