2 * Copyright (c) 2009, Microsoft Corporation.
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms and conditions of the GNU General Public License,
6 * version 2, as published by the Free Software Foundation.
8 * This program is distributed in the hope it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * You should have received a copy of the GNU General Public License along with
14 * this program; if not, write to the Free Software Foundation, Inc., 59 Temple
15 * Place - Suite 330, Boston, MA 02111-1307 USA.
18 * Haiyang Zhang <haiyangz@microsoft.com>
19 * Hank Janssen <hjanssen@microsoft.com>
21 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
23 #include <linux/kernel.h>
24 #include <linux/sched.h>
25 #include <linux/wait.h>
27 #include <linux/slab.h>
28 #include <linux/list.h>
29 #include <linux/module.h>
30 #include <linux/completion.h>
31 #include <linux/hyperv.h>
33 #include "hyperv_vmbus.h"
35 static void init_vp_index(struct vmbus_channel *channel,
36 const uuid_le *type_guid);
39 * vmbus_prep_negotiate_resp() - Create default response for Hyper-V Negotiate message
40 * @icmsghdrp: Pointer to msg header structure
41 * @icmsg_negotiate: Pointer to negotiate message structure
42 * @buf: Raw buffer channel data
44 * @icmsghdrp is of type &struct icmsg_hdr.
45 * @negop is of type &struct icmsg_negotiate.
46 * Set up and fill in default negotiate response message.
48 * The fw_version specifies the framework version that
49 * we can support and srv_version specifies the service
50 * version we can support.
52 * Mainly used by Hyper-V drivers.
54 bool vmbus_prep_negotiate_resp(struct icmsg_hdr *icmsghdrp,
55 struct icmsg_negotiate *negop, u8 *buf,
56 int fw_version, int srv_version)
58 int icframe_major, icframe_minor;
59 int icmsg_major, icmsg_minor;
60 int fw_major, fw_minor;
61 int srv_major, srv_minor;
63 bool found_match = false;
65 icmsghdrp->icmsgsize = 0x10;
66 fw_major = (fw_version >> 16);
67 fw_minor = (fw_version & 0xFFFF);
69 srv_major = (srv_version >> 16);
70 srv_minor = (srv_version & 0xFFFF);
72 negop = (struct icmsg_negotiate *)&buf[
73 sizeof(struct vmbuspipe_hdr) +
74 sizeof(struct icmsg_hdr)];
76 icframe_major = negop->icframe_vercnt;
79 icmsg_major = negop->icmsg_vercnt;
83 * Select the framework version number we will
87 for (i = 0; i < negop->icframe_vercnt; i++) {
88 if ((negop->icversion_data[i].major == fw_major) &&
89 (negop->icversion_data[i].minor == fw_minor)) {
90 icframe_major = negop->icversion_data[i].major;
91 icframe_minor = negop->icversion_data[i].minor;
101 for (i = negop->icframe_vercnt;
102 (i < negop->icframe_vercnt + negop->icmsg_vercnt); i++) {
103 if ((negop->icversion_data[i].major == srv_major) &&
104 (negop->icversion_data[i].minor == srv_minor)) {
105 icmsg_major = negop->icversion_data[i].major;
106 icmsg_minor = negop->icversion_data[i].minor;
112 * Respond with the framework and service
113 * version numbers we can support.
118 negop->icframe_vercnt = 0;
119 negop->icmsg_vercnt = 0;
121 negop->icframe_vercnt = 1;
122 negop->icmsg_vercnt = 1;
125 negop->icversion_data[0].major = icframe_major;
126 negop->icversion_data[0].minor = icframe_minor;
127 negop->icversion_data[1].major = icmsg_major;
128 negop->icversion_data[1].minor = icmsg_minor;
132 EXPORT_SYMBOL_GPL(vmbus_prep_negotiate_resp);
135 * alloc_channel - Allocate and initialize a vmbus channel object
137 static struct vmbus_channel *alloc_channel(void)
139 static atomic_t chan_num = ATOMIC_INIT(0);
140 struct vmbus_channel *channel;
142 channel = kzalloc(sizeof(*channel), GFP_ATOMIC);
146 channel->id = atomic_inc_return(&chan_num);
147 spin_lock_init(&channel->inbound_lock);
148 spin_lock_init(&channel->lock);
150 INIT_LIST_HEAD(&channel->sc_list);
151 INIT_LIST_HEAD(&channel->percpu_list);
157 * free_channel - Release the resources used by the vmbus channel object
159 static void free_channel(struct vmbus_channel *channel)
164 static void percpu_channel_enq(void *arg)
166 struct vmbus_channel *channel = arg;
167 int cpu = smp_processor_id();
169 list_add_tail(&channel->percpu_list, &hv_context.percpu_list[cpu]);
172 static void percpu_channel_deq(void *arg)
174 struct vmbus_channel *channel = arg;
176 list_del(&channel->percpu_list);
180 void hv_process_channel_removal(struct vmbus_channel *channel, u32 relid)
182 struct vmbus_channel_relid_released msg;
184 struct vmbus_channel *primary_channel;
186 memset(&msg, 0, sizeof(struct vmbus_channel_relid_released));
187 msg.child_relid = relid;
188 msg.header.msgtype = CHANNELMSG_RELID_RELEASED;
189 vmbus_post_msg(&msg, sizeof(struct vmbus_channel_relid_released));
194 if (channel->target_cpu != get_cpu()) {
196 smp_call_function_single(channel->target_cpu,
197 percpu_channel_deq, channel, true);
199 percpu_channel_deq(channel);
203 if (channel->primary_channel == NULL) {
204 spin_lock_irqsave(&vmbus_connection.channel_lock, flags);
205 list_del(&channel->listentry);
206 spin_unlock_irqrestore(&vmbus_connection.channel_lock, flags);
208 primary_channel = channel->primary_channel;
209 spin_lock_irqsave(&primary_channel->lock, flags);
210 list_del(&channel->sc_list);
211 primary_channel->num_sc--;
212 spin_unlock_irqrestore(&primary_channel->lock, flags);
214 free_channel(channel);
217 void vmbus_free_channels(void)
219 struct vmbus_channel *channel, *tmp;
221 list_for_each_entry_safe(channel, tmp, &vmbus_connection.chn_list,
223 /* if we don't set rescind to true, vmbus_close_internal()
224 * won't invoke hv_process_channel_removal().
226 channel->rescind = true;
228 vmbus_device_unregister(channel->device_obj);
233 * vmbus_process_offer - Process the offer by creating a channel/device
234 * associated with this offer
236 static void vmbus_process_offer(struct vmbus_channel *newchannel)
238 struct vmbus_channel *channel;
242 /* Make sure this is a new offer */
243 spin_lock_irqsave(&vmbus_connection.channel_lock, flags);
245 list_for_each_entry(channel, &vmbus_connection.chn_list, listentry) {
246 if (!uuid_le_cmp(channel->offermsg.offer.if_type,
247 newchannel->offermsg.offer.if_type) &&
248 !uuid_le_cmp(channel->offermsg.offer.if_instance,
249 newchannel->offermsg.offer.if_instance)) {
256 list_add_tail(&newchannel->listentry,
257 &vmbus_connection.chn_list);
259 spin_unlock_irqrestore(&vmbus_connection.channel_lock, flags);
263 * Check to see if this is a sub-channel.
265 if (newchannel->offermsg.offer.sub_channel_index != 0) {
267 * Process the sub-channel.
269 newchannel->primary_channel = channel;
270 spin_lock_irqsave(&channel->lock, flags);
271 list_add_tail(&newchannel->sc_list, &channel->sc_list);
273 spin_unlock_irqrestore(&channel->lock, flags);
278 init_vp_index(newchannel, &newchannel->offermsg.offer.if_type);
280 if (newchannel->target_cpu != get_cpu()) {
282 smp_call_function_single(newchannel->target_cpu,
286 percpu_channel_enq(newchannel);
291 * This state is used to indicate a successful open
292 * so that when we do close the channel normally, we
293 * can cleanup properly
295 newchannel->state = CHANNEL_OPEN_STATE;
298 if (channel->sc_creation_callback != NULL)
299 channel->sc_creation_callback(newchannel);
304 * Start the process of binding this offer to the driver
305 * We need to set the DeviceObject field before calling
306 * vmbus_child_dev_add()
308 newchannel->device_obj = vmbus_device_create(
309 &newchannel->offermsg.offer.if_type,
310 &newchannel->offermsg.offer.if_instance,
312 if (!newchannel->device_obj)
316 * Add the new device to the bus. This will kick off device-driver
317 * binding which eventually invokes the device driver's AddDevice()
320 if (vmbus_device_register(newchannel->device_obj) != 0) {
321 pr_err("unable to add child device object (relid %d)\n",
322 newchannel->offermsg.child_relid);
323 kfree(newchannel->device_obj);
329 spin_lock_irqsave(&vmbus_connection.channel_lock, flags);
330 list_del(&newchannel->listentry);
331 spin_unlock_irqrestore(&vmbus_connection.channel_lock, flags);
333 if (newchannel->target_cpu != get_cpu()) {
335 smp_call_function_single(newchannel->target_cpu,
336 percpu_channel_deq, newchannel, true);
338 percpu_channel_deq(newchannel);
343 free_channel(newchannel);
354 * This is an array of device_ids (device types) that are performance critical.
355 * We attempt to distribute the interrupt load for these devices across
356 * all available CPUs.
358 static const struct hv_vmbus_device_id hp_devs[] = {
365 /* NetworkDirect Guest RDMA */
371 * We use this state to statically distribute the channel interrupt load.
376 * Starting with Win8, we can statically distribute the incoming
377 * channel interrupt load by binding a channel to VCPU. We
378 * implement here a simple round robin scheme for distributing
379 * the interrupt load.
380 * We will bind channels that are not performance critical to cpu 0 and
381 * performance critical channels (IDE, SCSI and Network) will be uniformly
382 * distributed across all available CPUs.
384 static void init_vp_index(struct vmbus_channel *channel, const uuid_le *type_guid)
388 bool perf_chn = false;
389 u32 max_cpus = num_online_cpus();
391 for (i = IDE; i < MAX_PERF_CHN; i++) {
392 if (!memcmp(type_guid->b, hp_devs[i].guid,
398 if ((vmbus_proto_version == VERSION_WS2008) ||
399 (vmbus_proto_version == VERSION_WIN7) || (!perf_chn)) {
401 * Prior to win8, all channel interrupts are
402 * delivered on cpu 0.
403 * Also if the channel is not a performance critical
404 * channel, bind it to cpu 0.
406 channel->target_cpu = 0;
407 channel->target_vp = 0;
410 cur_cpu = (++next_vp % max_cpus);
411 channel->target_cpu = cur_cpu;
412 channel->target_vp = hv_context.vp_index[cur_cpu];
416 * vmbus_unload_response - Handler for the unload response.
418 static void vmbus_unload_response(struct vmbus_channel_message_header *hdr)
421 * This is a global event; just wakeup the waiting thread.
422 * Once we successfully unload, we can cleanup the monitor state.
424 complete(&vmbus_connection.unload_event);
427 void vmbus_initiate_unload(void)
429 struct vmbus_channel_message_header hdr;
431 init_completion(&vmbus_connection.unload_event);
432 memset(&hdr, 0, sizeof(struct vmbus_channel_message_header));
433 hdr.msgtype = CHANNELMSG_UNLOAD;
434 vmbus_post_msg(&hdr, sizeof(struct vmbus_channel_message_header));
436 wait_for_completion(&vmbus_connection.unload_event);
440 * vmbus_onoffer - Handler for channel offers from vmbus in parent partition.
443 static void vmbus_onoffer(struct vmbus_channel_message_header *hdr)
445 struct vmbus_channel_offer_channel *offer;
446 struct vmbus_channel *newchannel;
448 offer = (struct vmbus_channel_offer_channel *)hdr;
450 /* Allocate the channel object and save this offer. */
451 newchannel = alloc_channel();
453 pr_err("Unable to allocate channel object\n");
458 * By default we setup state to enable batched
459 * reading. A specific service can choose to
460 * disable this prior to opening the channel.
462 newchannel->batched_reading = true;
465 * Setup state for signalling the host.
467 newchannel->sig_event = (struct hv_input_signal_event *)
468 (ALIGN((unsigned long)
469 &newchannel->sig_buf,
470 HV_HYPERCALL_PARAM_ALIGN));
472 newchannel->sig_event->connectionid.asu32 = 0;
473 newchannel->sig_event->connectionid.u.id = VMBUS_EVENT_CONNECTION_ID;
474 newchannel->sig_event->flag_number = 0;
475 newchannel->sig_event->rsvdz = 0;
477 if (vmbus_proto_version != VERSION_WS2008) {
478 newchannel->is_dedicated_interrupt =
479 (offer->is_dedicated_interrupt != 0);
480 newchannel->sig_event->connectionid.u.id =
481 offer->connection_id;
484 memcpy(&newchannel->offermsg, offer,
485 sizeof(struct vmbus_channel_offer_channel));
486 newchannel->monitor_grp = (u8)offer->monitorid / 32;
487 newchannel->monitor_bit = (u8)offer->monitorid % 32;
489 vmbus_process_offer(newchannel);
493 * vmbus_onoffer_rescind - Rescind offer handler.
495 * We queue a work item to process this offer synchronously
497 static void vmbus_onoffer_rescind(struct vmbus_channel_message_header *hdr)
499 struct vmbus_channel_rescind_offer *rescind;
500 struct vmbus_channel *channel;
504 rescind = (struct vmbus_channel_rescind_offer *)hdr;
505 channel = relid2channel(rescind->child_relid);
507 if (channel == NULL) {
508 hv_process_channel_removal(NULL, rescind->child_relid);
512 spin_lock_irqsave(&channel->lock, flags);
513 channel->rescind = true;
514 spin_unlock_irqrestore(&channel->lock, flags);
516 if (channel->device_obj) {
518 * We will have to unregister this device from the
521 dev = get_device(&channel->device_obj->device);
523 vmbus_device_unregister(channel->device_obj);
527 hv_process_channel_removal(channel,
528 channel->offermsg.child_relid);
533 * vmbus_onoffers_delivered -
534 * This is invoked when all offers have been delivered.
536 * Nothing to do here.
538 static void vmbus_onoffers_delivered(
539 struct vmbus_channel_message_header *hdr)
544 * vmbus_onopen_result - Open result handler.
546 * This is invoked when we received a response to our channel open request.
547 * Find the matching request, copy the response and signal the requesting
550 static void vmbus_onopen_result(struct vmbus_channel_message_header *hdr)
552 struct vmbus_channel_open_result *result;
553 struct vmbus_channel_msginfo *msginfo;
554 struct vmbus_channel_message_header *requestheader;
555 struct vmbus_channel_open_channel *openmsg;
558 result = (struct vmbus_channel_open_result *)hdr;
561 * Find the open msg, copy the result and signal/unblock the wait event
563 spin_lock_irqsave(&vmbus_connection.channelmsg_lock, flags);
565 list_for_each_entry(msginfo, &vmbus_connection.chn_msg_list,
568 (struct vmbus_channel_message_header *)msginfo->msg;
570 if (requestheader->msgtype == CHANNELMSG_OPENCHANNEL) {
572 (struct vmbus_channel_open_channel *)msginfo->msg;
573 if (openmsg->child_relid == result->child_relid &&
574 openmsg->openid == result->openid) {
575 memcpy(&msginfo->response.open_result,
578 struct vmbus_channel_open_result));
579 complete(&msginfo->waitevent);
584 spin_unlock_irqrestore(&vmbus_connection.channelmsg_lock, flags);
588 * vmbus_ongpadl_created - GPADL created handler.
590 * This is invoked when we received a response to our gpadl create request.
591 * Find the matching request, copy the response and signal the requesting
594 static void vmbus_ongpadl_created(struct vmbus_channel_message_header *hdr)
596 struct vmbus_channel_gpadl_created *gpadlcreated;
597 struct vmbus_channel_msginfo *msginfo;
598 struct vmbus_channel_message_header *requestheader;
599 struct vmbus_channel_gpadl_header *gpadlheader;
602 gpadlcreated = (struct vmbus_channel_gpadl_created *)hdr;
605 * Find the establish msg, copy the result and signal/unblock the wait
608 spin_lock_irqsave(&vmbus_connection.channelmsg_lock, flags);
610 list_for_each_entry(msginfo, &vmbus_connection.chn_msg_list,
613 (struct vmbus_channel_message_header *)msginfo->msg;
615 if (requestheader->msgtype == CHANNELMSG_GPADL_HEADER) {
617 (struct vmbus_channel_gpadl_header *)requestheader;
619 if ((gpadlcreated->child_relid ==
620 gpadlheader->child_relid) &&
621 (gpadlcreated->gpadl == gpadlheader->gpadl)) {
622 memcpy(&msginfo->response.gpadl_created,
625 struct vmbus_channel_gpadl_created));
626 complete(&msginfo->waitevent);
631 spin_unlock_irqrestore(&vmbus_connection.channelmsg_lock, flags);
635 * vmbus_ongpadl_torndown - GPADL torndown handler.
637 * This is invoked when we received a response to our gpadl teardown request.
638 * Find the matching request, copy the response and signal the requesting
641 static void vmbus_ongpadl_torndown(
642 struct vmbus_channel_message_header *hdr)
644 struct vmbus_channel_gpadl_torndown *gpadl_torndown;
645 struct vmbus_channel_msginfo *msginfo;
646 struct vmbus_channel_message_header *requestheader;
647 struct vmbus_channel_gpadl_teardown *gpadl_teardown;
650 gpadl_torndown = (struct vmbus_channel_gpadl_torndown *)hdr;
653 * Find the open msg, copy the result and signal/unblock the wait event
655 spin_lock_irqsave(&vmbus_connection.channelmsg_lock, flags);
657 list_for_each_entry(msginfo, &vmbus_connection.chn_msg_list,
660 (struct vmbus_channel_message_header *)msginfo->msg;
662 if (requestheader->msgtype == CHANNELMSG_GPADL_TEARDOWN) {
664 (struct vmbus_channel_gpadl_teardown *)requestheader;
666 if (gpadl_torndown->gpadl == gpadl_teardown->gpadl) {
667 memcpy(&msginfo->response.gpadl_torndown,
670 struct vmbus_channel_gpadl_torndown));
671 complete(&msginfo->waitevent);
676 spin_unlock_irqrestore(&vmbus_connection.channelmsg_lock, flags);
680 * vmbus_onversion_response - Version response handler
682 * This is invoked when we received a response to our initiate contact request.
683 * Find the matching request, copy the response and signal the requesting
686 static void vmbus_onversion_response(
687 struct vmbus_channel_message_header *hdr)
689 struct vmbus_channel_msginfo *msginfo;
690 struct vmbus_channel_message_header *requestheader;
691 struct vmbus_channel_version_response *version_response;
694 version_response = (struct vmbus_channel_version_response *)hdr;
695 spin_lock_irqsave(&vmbus_connection.channelmsg_lock, flags);
697 list_for_each_entry(msginfo, &vmbus_connection.chn_msg_list,
700 (struct vmbus_channel_message_header *)msginfo->msg;
702 if (requestheader->msgtype ==
703 CHANNELMSG_INITIATE_CONTACT) {
704 memcpy(&msginfo->response.version_response,
706 sizeof(struct vmbus_channel_version_response));
707 complete(&msginfo->waitevent);
710 spin_unlock_irqrestore(&vmbus_connection.channelmsg_lock, flags);
713 /* Channel message dispatch table */
714 struct vmbus_channel_message_table_entry
715 channel_message_table[CHANNELMSG_COUNT] = {
716 {CHANNELMSG_INVALID, 0, NULL},
717 {CHANNELMSG_OFFERCHANNEL, 0, vmbus_onoffer},
718 {CHANNELMSG_RESCIND_CHANNELOFFER, 0, vmbus_onoffer_rescind},
719 {CHANNELMSG_REQUESTOFFERS, 0, NULL},
720 {CHANNELMSG_ALLOFFERS_DELIVERED, 1, vmbus_onoffers_delivered},
721 {CHANNELMSG_OPENCHANNEL, 0, NULL},
722 {CHANNELMSG_OPENCHANNEL_RESULT, 1, vmbus_onopen_result},
723 {CHANNELMSG_CLOSECHANNEL, 0, NULL},
724 {CHANNELMSG_GPADL_HEADER, 0, NULL},
725 {CHANNELMSG_GPADL_BODY, 0, NULL},
726 {CHANNELMSG_GPADL_CREATED, 1, vmbus_ongpadl_created},
727 {CHANNELMSG_GPADL_TEARDOWN, 0, NULL},
728 {CHANNELMSG_GPADL_TORNDOWN, 1, vmbus_ongpadl_torndown},
729 {CHANNELMSG_RELID_RELEASED, 0, NULL},
730 {CHANNELMSG_INITIATE_CONTACT, 0, NULL},
731 {CHANNELMSG_VERSION_RESPONSE, 1, vmbus_onversion_response},
732 {CHANNELMSG_UNLOAD, 0, NULL},
733 {CHANNELMSG_UNLOAD_RESPONSE, 1, vmbus_unload_response},
737 * vmbus_onmessage - Handler for channel protocol messages.
739 * This is invoked in the vmbus worker thread context.
741 void vmbus_onmessage(void *context)
743 struct hv_message *msg = context;
744 struct vmbus_channel_message_header *hdr;
747 hdr = (struct vmbus_channel_message_header *)msg->u.payload;
748 size = msg->header.payload_size;
750 if (hdr->msgtype >= CHANNELMSG_COUNT) {
751 pr_err("Received invalid channel message type %d size %d\n",
753 print_hex_dump_bytes("", DUMP_PREFIX_NONE,
754 (unsigned char *)msg->u.payload, size);
758 if (channel_message_table[hdr->msgtype].message_handler)
759 channel_message_table[hdr->msgtype].message_handler(hdr);
761 pr_err("Unhandled channel message type %d\n", hdr->msgtype);
765 * vmbus_request_offers - Send a request to get all our pending offers.
767 int vmbus_request_offers(void)
769 struct vmbus_channel_message_header *msg;
770 struct vmbus_channel_msginfo *msginfo;
773 msginfo = kmalloc(sizeof(*msginfo) +
774 sizeof(struct vmbus_channel_message_header),
779 msg = (struct vmbus_channel_message_header *)msginfo->msg;
781 msg->msgtype = CHANNELMSG_REQUESTOFFERS;
784 ret = vmbus_post_msg(msg,
785 sizeof(struct vmbus_channel_message_header));
787 pr_err("Unable to request offers - %d\n", ret);
799 * Retrieve the (sub) channel on which to send an outgoing request.
800 * When a primary channel has multiple sub-channels, we try to
801 * distribute the load equally amongst all available channels.
803 struct vmbus_channel *vmbus_get_outgoing_channel(struct vmbus_channel *primary)
805 struct list_head *cur, *tmp;
807 struct vmbus_channel *cur_channel;
808 struct vmbus_channel *outgoing_channel = primary;
812 if (list_empty(&primary->sc_list))
813 return outgoing_channel;
815 next_channel = primary->next_oc++;
817 if (next_channel > (primary->num_sc)) {
818 primary->next_oc = 0;
819 return outgoing_channel;
822 cur_cpu = hv_context.vp_index[get_cpu()];
824 list_for_each_safe(cur, tmp, &primary->sc_list) {
825 cur_channel = list_entry(cur, struct vmbus_channel, sc_list);
826 if (cur_channel->state != CHANNEL_OPENED_STATE)
829 if (cur_channel->target_vp == cur_cpu)
832 if (i == next_channel)
838 return outgoing_channel;
840 EXPORT_SYMBOL_GPL(vmbus_get_outgoing_channel);
842 static void invoke_sc_cb(struct vmbus_channel *primary_channel)
844 struct list_head *cur, *tmp;
845 struct vmbus_channel *cur_channel;
847 if (primary_channel->sc_creation_callback == NULL)
850 list_for_each_safe(cur, tmp, &primary_channel->sc_list) {
851 cur_channel = list_entry(cur, struct vmbus_channel, sc_list);
853 primary_channel->sc_creation_callback(cur_channel);
857 void vmbus_set_sc_create_callback(struct vmbus_channel *primary_channel,
858 void (*sc_cr_cb)(struct vmbus_channel *new_sc))
860 primary_channel->sc_creation_callback = sc_cr_cb;
862 EXPORT_SYMBOL_GPL(vmbus_set_sc_create_callback);
864 bool vmbus_are_subchannels_present(struct vmbus_channel *primary)
868 ret = !list_empty(&primary->sc_list);
872 * Invoke the callback on sub-channel creation.
873 * This will present a uniform interface to the
876 invoke_sc_cb(primary);
881 EXPORT_SYMBOL_GPL(vmbus_are_subchannels_present);