1 /* SPDX-License-Identifier: GPL-2.0-only */
48  * gva:    |--       64k      --|--       64k      --| ... |
59  * gva:    |-- 64k --|--       64k      --| ... |-- 64k --|-- 64k --| ... |
69  * index:  0    1    2   ...    16   ...       n-15 n-14 n-13  ...  2n-30
76 /* Single-page buffer */
83 /* Multiple-page buffer */
92  * Multiple-page buffer array; the pfn array is variable size:
123 	 * WS2012/Win8 and later versions of Hyper-V implement interrupt
125 	 * is set by the host on the host->guest ring buffer, and by the
126 	 * guest on the guest->host ring buffer.
130 	 * the feature bit in the guest->host ring buffer, the guest is
132 	 * 1) It will set the pending_send_sz field in the guest->host ring
134 	 * 2) It will read the pending_send_sz field in the host->guest
137 	 * Similarly, if the host sets the feature bit in the host->guest
139 	 * 1) It will set the pending_send_sz field in the host->guest ring
141 	 * 2) It will read the pending_send_sz field in the guest->host
158 	u8	reserved2[PAGE_SIZE - 68];
175  * relatively small header (4 Kbytes on x86) to a large-ish power-of-2 ring
187 /* Calculate the proper size of a ringbuffer, it must be page-aligned */
215 	dsize = rbi->ring_datasize;  in hv_get_bytes_to_read()
216 	read_loc = rbi->ring_buffer->read_index;  in hv_get_bytes_to_read()
217 	write_loc = READ_ONCE(rbi->ring_buffer->write_index);  in hv_get_bytes_to_read()
219 	read = write_loc >= read_loc ? (write_loc - read_loc) :  in hv_get_bytes_to_read()
220 		(dsize - read_loc) + write_loc;  in hv_get_bytes_to_read()
229 	dsize = rbi->ring_datasize;  in hv_get_bytes_to_write()
230 	read_loc = READ_ONCE(rbi->ring_buffer->read_index);  in hv_get_bytes_to_write()
231 	write_loc = rbi->ring_buffer->write_index;  in hv_get_bytes_to_write()
233 	write = write_loc >= read_loc ? dsize - (write_loc - read_loc) :  in hv_get_bytes_to_write()
234 		read_loc - write_loc;  in hv_get_bytes_to_write()
245 			rbi->ring_size_div10_reciprocal);  in hv_get_avail_to_write_percent()
286 /* The size of the user defined data buffer for non-pipe offers. */
310 		/* Non-pipes: The user has MAX_USER_DEFINED_BYTES bytes. */
318 		 * is implemented on top of standard user-defined data. Pipe
329 	 * primary channel and a value of non-zero means a sub-channel.
385  * This is the format for a GPA-Direct packet, which contains a set of GPA
397 	 ((struct vmpacket_descriptor)__packet)->offset8 * 8)
400 	((((struct vmpacket_descriptor)__packet)->len8 -	\
401 	  ((struct vmpacket_descriptor)__packet)->offset8) * 8)
404 	(((struct IMPACT)__packet)->type)
456 /* Hyper-V supports about 2048 channels, and the RELIDs start with 1. */
510  * Request Offer -- no parameters, SynIC message contains the partition ID
511  * Set Snoop -- no parameters, SynIC message contains the partition ID
512  * Clear Snoop -- no parameters, SynIC message contains the partition ID
513  * All Offers Delivered -- no parameters, SynIC message contains the partition
515  * Flush Client -- no parameters, SynIC message contains the partition ID
548 	/* User-specific data to be passed along to the server endpoint. */
573 /* Channel Message GPADL */
579  * The number of PFNs in a GPADL message is defined by the number of
582  * follow-up packet that contains more.
640 /* Hyper-V socket: guest's connect()-ing to host */
663 	 * VMBUS_MESSAGE_CONNECTION_ID_4 for the Initiate Contact Message,
664 	 * and for subsequent messages, we must use the Message Connection ID
665 	 * field in the host-returned Version Response Message.
681  * variable-size data structure depending on the msg type itself
687 	/* So far, this is only used to handle gpadl body message */
704 	 * The channel message that goes out on the "wire".
749 #define VMBUS_RQST_ERROR (U64_MAX - 1)
751 /* NetVSC-specific */
752 #define VMBUS_RQST_ID_NO_RESPONSE (U64_MAX - 2)
753 /* StorVSC-specific */
754 #define VMBUS_RQST_INIT (U64_MAX - 2)
755 #define VMBUS_RQST_RESET (U64_MAX - 3)
838 	 *   BATCHED - callback called from taslket and should read
841 	 *   DIRECT - callback called from tasklet (softirq).
842 	 *   ISR - callback called in interrupt context and must
844 	 *         Host interrupts are disabled and must be re-enabled
867 	 * Support for sub-channels. For high performance devices,
868 	 * it will be useful to have multiple sub-channels to support
870 	 * The support for sub-channels is implemented as an extension
873 	 * offer message will indicate if the host supports sub-channels.
874 	 * The guest is free to ask for sub-channels to be offered and can
875 	 * open these sub-channels as a normal "primary" channel. However,
876 	 * all sub-channels will have the same type and instance guids as the
882 	 * Sub-channel creation callback. This callback will be called in
883 	 * process context when a sub-channel offer is received from the host.
884 	 * The guest can open the sub-channel in the context of this callback.
895 	 * All Sub-channels of a primary channel are linked here.
899 	 * The primary channel this sub-channel belongs to.
904 	 * Support per-channel state for use by vmbus drivers.
915 	 * For sysfs per-channel properties.
921 	 * etc,), Hyper-V has a mechanism to enhance the throughput
926 	 * of time is the monitor latency - currently around 100 usecs. This
929 	 * A) Making the host more efficient - each time it wakes up,
955 	 * We must offload the handling of the primary/sub channels
956 	 * from the single-threaded vmbus_connection.work_queue to
987 	 * The  Message delay will delay guest reading on a per message basis
1015 	struct vmbus_requestor *rqstor = &(channel)->requestor;		\
1017 	spin_lock_irqsave(&rqstor->req_lock, flags);			\
1023 	struct vmbus_requestor *rqstor = &channel->requestor;  in unlock_requestor()
1025 	spin_unlock_irqrestore(&rqstor->req_lock, flags);  in unlock_requestor()
1037 	return !!(o->offer.chn_flags & VMBUS_CHANNEL_TLNPI_PROVIDER_OFFER);  in is_hvsock_offer()
1042 	return is_hvsock_offer(&c->offermsg);  in is_hvsock_channel()
1047 	return c->offermsg.offer.sub_channel_index != 0;  in is_sub_channel()
1053 	c->callback_mode = mode;  in set_channel_read_mode()
1058 	c->per_channel_state = s;  in set_per_channel_state()
1063 	return c->per_channel_state;  in get_per_channel_state()
1072 		spin_lock_irqsave(&c->outbound.ring_lock, flags);  in set_channel_pending_send_size()
1073 		++c->out_full_total;  in set_channel_pending_send_size()
1075 		if (!c->out_full_flag) {  in set_channel_pending_send_size()
1076 			++c->out_full_first;  in set_channel_pending_send_size()
1077 			c->out_full_flag = true;  in set_channel_pending_send_size()
1079 		spin_unlock_irqrestore(&c->outbound.ring_lock, flags);  in set_channel_pending_send_size()
1081 		c->out_full_flag = false;  in set_channel_pending_send_size()
1084 	c->outbound.ring_buffer->pending_send_sz = size;  in set_channel_pending_send_size()
1092  * APIs for managing sub-channels.
1209 	 * However, to facilitate the notification of new-offer/rescind-offer
1271 	dev_set_drvdata(&dev->device, data);  in hv_set_drvdata()
1276 	return dev_get_drvdata(&dev->device);  in hv_get_drvdata()
1310  * GUID definitions of various offer types - services offered to the guest.
1315  * {f8615163-df3e-46c5-913f-f2d2f965ed0e}
1323  * {32412632-86cb-44a2-9b5c-50d1417354f5}
1331  * {ba6163d9-04a1-4d29-b605-72e2ffb1dc7f}
1339  * {0e0b6031-5213-4934-818b-38d90ced39db}
1347  * {9527E630-D0AE-497b-ADCE-E80AB0175CAF}
1355  * {57164f39-9115-4e78-ab55-382f3bd5422d}
1363  * {a9a0f4e7-5a45-4d96-b827-8a841e8c03e6}
1371  * {525074dc-8985-46e2-8057-a307dc18a502}
1379  * {cfa8b69e-5b4a-4cc0-b98b-8ba1a1f3f95a}
1387  * {f912ad6d-2b17-48ea-bd65-f927a61c7684}
1401  * {DA0A7802-E377-4aac-8E77-0558EB1073F8}
1409  * {2f9bcc4a-0069-4af3-b76b-6fd0be528cda}
1417  * {34D14BE3-DEE4-41c8-9AE7-6B174977C192}
1426  * {8c2eaf3d-32a7-4b09-ab99-bd1f1c86b501}
1434  * {44C4F61D-4444-4400-9D52-802E27EDE19F}
1446  * {f8e65716-3cb3-4a06-9a60-1889c5cccab5}
1447  * {3375baf4-9e15-4b30-b765-67acb10d607b}
1448  * {276aacf4-ac15-426c-98dd-7521ad3f01fe}
1449  * {c376c1c3-d276-48d2-90a9-c04748072c60}
1469  * Common header for Hyper-V ICs
1613 	return ring_info->ring_buffer->buffer;  in hv_get_ring_buffer()
1621 	rbi->ring_buffer->interrupt_mask = 1;  in hv_begin_read()
1628  * Re-enable host callback and return number of outstanding bytes
1633 	rbi->ring_buffer->interrupt_mask = 0;  in hv_end_read()
1647  * An API to support in-place processing of incoming VMBUS packets.
1653 	return (void *)((unsigned long)desc + (desc->offset8 << 3));  in hv_pkt_data()
1659 	return (desc->len8 << 3) - (desc->offset8 << 3);  in hv_pkt_datalen()
1665 	return desc->len8 << 3;  in hv_pkt_len()
1695  * Interface for passing data between SR-IOV PF and VF drivers. The VF driver
1738 #define HVPFN_UP(x)	(((x) + HV_HYP_PAGE_SIZE-1) >> HV_HYP_PAGE_SHIFT)