sys/dev/hyperv/vmbus/hv_channel.c

   1 /*-
   2  * Copyright (c) 2009-2012 Microsoft Corp.
   3  * Copyright (c) 2012 NetApp Inc.
   4  * Copyright (c) 2012 Citrix Inc.
   5  * All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  * 1. Redistributions of source code must retain the above copyright
  11  *    notice unmodified, this list of conditions, and the following
  12  *    disclaimer.
  13  * 2. Redistributions in binary form must reproduce the above copyright
  14  *    notice, this list of conditions and the following disclaimer in the
  15  *    documentation and/or other materials provided with the distribution.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  27  */
  28
  29 #include <sys/cdefs.h>
  30 __FBSDID("$FreeBSD$");
  31
  32 #include <sys/param.h>
  33 #include <sys/kernel.h>
  34 #include <sys/malloc.h>
  35 #include <sys/systm.h>
  36 #include <sys/mbuf.h>
  37 #include <sys/lock.h>
  38 #include <sys/mutex.h>
  39 #include <machine/bus.h>
  40 #include <vm/vm.h>
  41 #include <vm/vm_param.h>
  42 #include <vm/pmap.h>
  43
  44 #include "hv_vmbus_priv.h"
  45
  46 static int      vmbus_channel_create_gpadl_header(
  47                         /* must be phys and virt contiguous*/
  48                         void*                           contig_buffer,
  49                         /* page-size multiple */
  50                         uint32_t                        size,
  51                         hv_vmbus_channel_msg_info**     msg_info,
  52                         uint32_t*                       message_count);
  53
  54 static void     vmbus_channel_set_event(hv_vmbus_channel* channel);
  55 static void     VmbusProcessChannelEvent(void* channel, int pending);
  56
  57 /**
  58  *  @brief Trigger an event notification on the specified channel
  59  */
  60 static void
  61 vmbus_channel_set_event(hv_vmbus_channel *channel)
  62 {
  63         hv_vmbus_monitor_page *monitor_page;
  64
  65         if (channel->offer_msg.monitor_allocated) {
  66                 /* Each uint32_t represents 32 channels */
  67                 synch_set_bit((channel->offer_msg.child_rel_id & 31),
  68                         ((uint32_t *)hv_vmbus_g_connection.send_interrupt_page
  69                                 + ((channel->offer_msg.child_rel_id >> 5))));
  70
  71                 monitor_page = (hv_vmbus_monitor_page *)
  72                         hv_vmbus_g_connection.monitor_page_2;
  73
  74                 synch_set_bit(channel->monitor_bit,
  75                         (uint32_t *)&monitor_page->
  76                                 trigger_group[channel->monitor_group].u.pending);
  77         } else {
  78                 hv_vmbus_set_event(channel);
  79         }
  80
  81 }
  82
  83 /**
  84  * @brief Open the specified channel
  85  */
  86 int
  87 hv_vmbus_channel_open(
  88         hv_vmbus_channel*               new_channel,
  89         uint32_t                        send_ring_buffer_size,
  90         uint32_t                        recv_ring_buffer_size,
  91         void*                           user_data,
  92         uint32_t                        user_data_len,
  93         hv_vmbus_pfn_channel_callback   pfn_on_channel_callback,
  94         void*                           context)
  95 {
  96
  97         int ret = 0;
  98         void *in, *out;
  99         hv_vmbus_channel_open_channel*  open_msg;
 100         hv_vmbus_channel_msg_info*      open_info;
 101
 102         mtx_lock(&new_channel->sc_lock);
 103         if (new_channel->state == HV_CHANNEL_OPEN_STATE) {
 104             new_channel->state = HV_CHANNEL_OPENING_STATE;
 105         } else {
 106             mtx_unlock(&new_channel->sc_lock);
 107             if(bootverbose)
 108                 printf("VMBUS: Trying to open channel <%p> which in "
 109                     "%d state.\n", new_channel, new_channel->state);
 110             return (EINVAL);
 111         }
 112         mtx_unlock(&new_channel->sc_lock);
 113
 114         new_channel->on_channel_callback = pfn_on_channel_callback;
 115         new_channel->channel_callback_context = context;
 116
 117         new_channel->rxq = hv_vmbus_g_context.hv_event_queue[new_channel->target_cpu];
 118         TASK_INIT(&new_channel->channel_task, 0, VmbusProcessChannelEvent, new_channel);
 119
 120         /* Allocate the ring buffer */
 121         out = contigmalloc((send_ring_buffer_size + recv_ring_buffer_size),
 122             M_DEVBUF, M_ZERO, 0UL, BUS_SPACE_MAXADDR, PAGE_SIZE, 0);
 123         KASSERT(out != NULL,
 124             ("Error VMBUS: contigmalloc failed to allocate Ring Buffer!"));
 125         if (out == NULL)
 126                 return (ENOMEM);
 127
 128         in = ((uint8_t *) out + send_ring_buffer_size);
 129
 130         new_channel->ring_buffer_pages = out;
 131         new_channel->ring_buffer_page_count = (send_ring_buffer_size +
 132             recv_ring_buffer_size) >> PAGE_SHIFT;
 133         new_channel->ring_buffer_size = send_ring_buffer_size +
 134             recv_ring_buffer_size;
 135
 136         hv_vmbus_ring_buffer_init(
 137                 &new_channel->outbound,
 138                 out,
 139                 send_ring_buffer_size);
 140
 141         hv_vmbus_ring_buffer_init(
 142                 &new_channel->inbound,
 143                 in,
 144                 recv_ring_buffer_size);
 145
 146         /**
 147          * Establish the gpadl for the ring buffer
 148          */
 149         new_channel->ring_buffer_gpadl_handle = 0;
 150
 151         ret = hv_vmbus_channel_establish_gpadl(new_channel,
 152                 new_channel->outbound.ring_buffer,
 153                 send_ring_buffer_size + recv_ring_buffer_size,
 154                 &new_channel->ring_buffer_gpadl_handle);
 155
 156         /**
 157          * Create and init the channel open message
 158          */
 159         open_info = (hv_vmbus_channel_msg_info*) malloc(
 160                 sizeof(hv_vmbus_channel_msg_info) +
 161                         sizeof(hv_vmbus_channel_open_channel),
 162                 M_DEVBUF,
 163                 M_NOWAIT);
 164         KASSERT(open_info != NULL,
 165             ("Error VMBUS: malloc failed to allocate Open Channel message!"));
 166
 167         if (open_info == NULL)
 168                 return (ENOMEM);
 169
 170         sema_init(&open_info->wait_sema, 0, "Open Info Sema");
 171
 172         open_msg = (hv_vmbus_channel_open_channel*) open_info->msg;
 173         open_msg->header.message_type = HV_CHANNEL_MESSAGE_OPEN_CHANNEL;
 174         open_msg->open_id = new_channel->offer_msg.child_rel_id;
 175         open_msg->child_rel_id = new_channel->offer_msg.child_rel_id;
 176         open_msg->ring_buffer_gpadl_handle =
 177                 new_channel->ring_buffer_gpadl_handle;
 178         open_msg->downstream_ring_buffer_page_offset = send_ring_buffer_size
 179                 >> PAGE_SHIFT;
 180         open_msg->target_vcpu = new_channel->target_vcpu;
 181
 182         if (user_data_len)
 183                 memcpy(open_msg->user_data, user_data, user_data_len);
 184
 185         mtx_lock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 186         TAILQ_INSERT_TAIL(
 187                 &hv_vmbus_g_connection.channel_msg_anchor,
 188                 open_info,
 189                 msg_list_entry);
 190         mtx_unlock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 191
 192         ret = hv_vmbus_post_message(
 193                 open_msg, sizeof(hv_vmbus_channel_open_channel));
 194
 195         if (ret != 0)
 196             goto cleanup;
 197
 198         ret = sema_timedwait(&open_info->wait_sema, 5 * hz); /* KYS 5 seconds */
 199
 200         if (ret) {
 201             if(bootverbose)
 202                 printf("VMBUS: channel <%p> open timeout.\n", new_channel);
 203             goto cleanup;
 204         }
 205
 206         if (open_info->response.open_result.status == 0) {
 207             new_channel->state = HV_CHANNEL_OPENED_STATE;
 208             if(bootverbose)
 209                 printf("VMBUS: channel <%p> open success.\n", new_channel);
 210         } else {
 211             if(bootverbose)
 212                 printf("Error VMBUS: channel <%p> open failed - %d!\n",
 213                         new_channel, open_info->response.open_result.status);
 214         }
 215
 216         cleanup:
 217         mtx_lock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 218         TAILQ_REMOVE(
 219                 &hv_vmbus_g_connection.channel_msg_anchor,
 220                 open_info,
 221                 msg_list_entry);
 222         mtx_unlock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 223         sema_destroy(&open_info->wait_sema);
 224         free(open_info, M_DEVBUF);
 225
 226         return (ret);
 227 }
 228
 229 /**
 230  * @brief Create a gpadl for the specified buffer
 231  */
 232 static int
 233 vmbus_channel_create_gpadl_header(
 234         void*                           contig_buffer,
 235         uint32_t                        size,   /* page-size multiple */
 236         hv_vmbus_channel_msg_info**     msg_info,
 237         uint32_t*                       message_count)
 238 {
 239         int                             i;
 240         int                             page_count;
 241         unsigned long long              pfn;
 242         uint32_t                        msg_size;
 243         hv_vmbus_channel_gpadl_header*  gpa_header;
 244         hv_vmbus_channel_gpadl_body*    gpadl_body;
 245         hv_vmbus_channel_msg_info*      msg_header;
 246         hv_vmbus_channel_msg_info*      msg_body;
 247
 248         int pfnSum, pfnCount, pfnLeft, pfnCurr, pfnSize;
 249
 250         page_count = size >> PAGE_SHIFT;
 251         pfn = hv_get_phys_addr(contig_buffer) >> PAGE_SHIFT;
 252
 253         /*do we need a gpadl body msg */
 254         pfnSize = HV_MAX_SIZE_CHANNEL_MESSAGE
 255             - sizeof(hv_vmbus_channel_gpadl_header)
 256             - sizeof(hv_gpa_range);
 257         pfnCount = pfnSize / sizeof(uint64_t);
 258
 259         if (page_count > pfnCount) { /* if(we need a gpadl body)        */
 260             /* fill in the header               */
 261             msg_size = sizeof(hv_vmbus_channel_msg_info)
 262                 + sizeof(hv_vmbus_channel_gpadl_header)
 263                 + sizeof(hv_gpa_range)
 264                 + pfnCount * sizeof(uint64_t);
 265             msg_header = malloc(msg_size, M_DEVBUF, M_NOWAIT | M_ZERO);
 266             KASSERT(
 267                 msg_header != NULL,
 268                 ("Error VMBUS: malloc failed to allocate Gpadl Message!"));
 269             if (msg_header == NULL)
 270                 return (ENOMEM);
 271
 272             TAILQ_INIT(&msg_header->sub_msg_list_anchor);
 273             msg_header->message_size = msg_size;
 274
 275             gpa_header = (hv_vmbus_channel_gpadl_header*) msg_header->msg;
 276             gpa_header->range_count = 1;
 277             gpa_header->range_buf_len = sizeof(hv_gpa_range)
 278                 + page_count * sizeof(uint64_t);
 279             gpa_header->range[0].byte_offset = 0;
 280             gpa_header->range[0].byte_count = size;
 281             for (i = 0; i < pfnCount; i++) {
 282                 gpa_header->range[0].pfn_array[i] = pfn + i;
 283             }
 284             *msg_info = msg_header;
 285             *message_count = 1;
 286
 287             pfnSum = pfnCount;
 288             pfnLeft = page_count - pfnCount;
 289
 290             /*
 291              *  figure out how many pfns we can fit
 292              */
 293             pfnSize = HV_MAX_SIZE_CHANNEL_MESSAGE
 294                 - sizeof(hv_vmbus_channel_gpadl_body);
 295             pfnCount = pfnSize / sizeof(uint64_t);
 296
 297             /*
 298              * fill in the body
 299              */
 300             while (pfnLeft) {
 301                 if (pfnLeft > pfnCount) {
 302                     pfnCurr = pfnCount;
 303                 } else {
 304                     pfnCurr = pfnLeft;
 305                 }
 306
 307                 msg_size = sizeof(hv_vmbus_channel_msg_info) +
 308                     sizeof(hv_vmbus_channel_gpadl_body) +
 309                     pfnCurr * sizeof(uint64_t);
 310                 msg_body = malloc(msg_size, M_DEVBUF, M_NOWAIT | M_ZERO);
 311                 KASSERT(
 312                     msg_body != NULL,
 313                     ("Error VMBUS: malloc failed to allocate Gpadl msg_body!"));
 314                 if (msg_body == NULL)
 315                     return (ENOMEM);
 316
 317                 msg_body->message_size = msg_size;
 318                 (*message_count)++;
 319                 gpadl_body =
 320                     (hv_vmbus_channel_gpadl_body*) msg_body->msg;
 321                 /*
 322                  * gpadl_body->gpadl = kbuffer;
 323                  */
 324                 for (i = 0; i < pfnCurr; i++) {
 325                     gpadl_body->pfn[i] = pfn + pfnSum + i;
 326                 }
 327
 328                 TAILQ_INSERT_TAIL(
 329                     &msg_header->sub_msg_list_anchor,
 330                     msg_body,
 331                     msg_list_entry);
 332                 pfnSum += pfnCurr;
 333                 pfnLeft -= pfnCurr;
 334             }
 335         } else { /* else everything fits in a header */
 336
 337             msg_size = sizeof(hv_vmbus_channel_msg_info) +
 338                 sizeof(hv_vmbus_channel_gpadl_header) +
 339                 sizeof(hv_gpa_range) +
 340                 page_count * sizeof(uint64_t);
 341             msg_header = malloc(msg_size, M_DEVBUF, M_NOWAIT | M_ZERO);
 342             KASSERT(
 343                 msg_header != NULL,
 344                 ("Error VMBUS: malloc failed to allocate Gpadl Message!"));
 345             if (msg_header == NULL)
 346                 return (ENOMEM);
 347
 348             msg_header->message_size = msg_size;
 349
 350             gpa_header = (hv_vmbus_channel_gpadl_header*) msg_header->msg;
 351             gpa_header->range_count = 1;
 352             gpa_header->range_buf_len = sizeof(hv_gpa_range) +
 353                 page_count * sizeof(uint64_t);
 354             gpa_header->range[0].byte_offset = 0;
 355             gpa_header->range[0].byte_count = size;
 356             for (i = 0; i < page_count; i++) {
 357                 gpa_header->range[0].pfn_array[i] = pfn + i;
 358             }
 359
 360             *msg_info = msg_header;
 361             *message_count = 1;
 362         }
 363
 364         return (0);
 365 }
 366
 367 /**
 368  * @brief Establish a GPADL for the specified buffer
 369  */
 370 int
 371 hv_vmbus_channel_establish_gpadl(
 372         hv_vmbus_channel*       channel,
 373         void*                   contig_buffer,
 374         uint32_t                size, /* page-size multiple */
 375         uint32_t*               gpadl_handle)
 376
 377 {
 378         int ret = 0;
 379         hv_vmbus_channel_gpadl_header*  gpadl_msg;
 380         hv_vmbus_channel_gpadl_body*    gpadl_body;
 381         hv_vmbus_channel_msg_info*      msg_info;
 382         hv_vmbus_channel_msg_info*      sub_msg_info;
 383         uint32_t                        msg_count;
 384         hv_vmbus_channel_msg_info*      curr;
 385         uint32_t                        next_gpadl_handle;
 386
 387         next_gpadl_handle = atomic_fetchadd_int(
 388             &hv_vmbus_g_connection.next_gpadl_handle, 1);
 389
 390         ret = vmbus_channel_create_gpadl_header(
 391                 contig_buffer, size, &msg_info, &msg_count);
 392
 393         if(ret != 0) {
 394                 /*
 395                  * XXX
 396                  * We can _not_ even revert the above incremental,
 397                  * if multiple GPADL establishments are running
 398                  * parallelly, decrement the global next_gpadl_handle
 399                  * is calling for _big_ trouble.  A better solution
 400                  * is to have a 0-based GPADL id bitmap ...
 401                  */
 402                 return ret;
 403         }
 404
 405         sema_init(&msg_info->wait_sema, 0, "Open Info Sema");
 406         gpadl_msg = (hv_vmbus_channel_gpadl_header*) msg_info->msg;
 407         gpadl_msg->header.message_type = HV_CHANNEL_MESSAGEL_GPADL_HEADER;
 408         gpadl_msg->child_rel_id = channel->offer_msg.child_rel_id;
 409         gpadl_msg->gpadl = next_gpadl_handle;
 410
 411         mtx_lock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 412         TAILQ_INSERT_TAIL(
 413                 &hv_vmbus_g_connection.channel_msg_anchor,
 414                 msg_info,
 415                 msg_list_entry);
 416
 417         mtx_unlock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 418
 419         ret = hv_vmbus_post_message(
 420                 gpadl_msg,
 421                 msg_info->message_size -
 422                     (uint32_t) sizeof(hv_vmbus_channel_msg_info));
 423
 424         if (ret != 0)
 425             goto cleanup;
 426
 427         if (msg_count > 1) {
 428             TAILQ_FOREACH(curr,
 429                     &msg_info->sub_msg_list_anchor, msg_list_entry) {
 430                 sub_msg_info = curr;
 431                 gpadl_body =
 432                     (hv_vmbus_channel_gpadl_body*) sub_msg_info->msg;
 433
 434                 gpadl_body->header.message_type =
 435                     HV_CHANNEL_MESSAGE_GPADL_BODY;
 436                 gpadl_body->gpadl = next_gpadl_handle;
 437
 438                 ret = hv_vmbus_post_message(
 439                         gpadl_body,
 440                         sub_msg_info->message_size
 441                             - (uint32_t) sizeof(hv_vmbus_channel_msg_info));
 442                  /* if (the post message failed) give up and clean up */
 443                 if(ret != 0)
 444                     goto cleanup;
 445             }
 446         }
 447
 448         ret = sema_timedwait(&msg_info->wait_sema, 5 * hz); /* KYS 5 seconds*/
 449         if (ret != 0)
 450             goto cleanup;
 451
 452         *gpadl_handle = gpadl_msg->gpadl;
 453
 454 cleanup:
 455
 456         mtx_lock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 457         TAILQ_REMOVE(&hv_vmbus_g_connection.channel_msg_anchor,
 458                 msg_info, msg_list_entry);
 459         mtx_unlock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 460
 461         sema_destroy(&msg_info->wait_sema);
 462         free(msg_info, M_DEVBUF);
 463
 464         return (ret);
 465 }
 466
 467 /**
 468  * @brief Teardown the specified GPADL handle
 469  */
 470 int
 471 hv_vmbus_channel_teardown_gpdal(
 472         hv_vmbus_channel*       channel,
 473         uint32_t                gpadl_handle)
 474 {
 475         int                                     ret = 0;
 476         hv_vmbus_channel_gpadl_teardown*        msg;
 477         hv_vmbus_channel_msg_info*              info;
 478
 479         info = (hv_vmbus_channel_msg_info *)
 480                 malloc( sizeof(hv_vmbus_channel_msg_info) +
 481                         sizeof(hv_vmbus_channel_gpadl_teardown),
 482                                 M_DEVBUF, M_NOWAIT);
 483         KASSERT(info != NULL,
 484             ("Error VMBUS: malloc failed to allocate Gpadl Teardown Msg!"));
 485         if (info == NULL) {
 486             ret = ENOMEM;
 487             goto cleanup;
 488         }
 489
 490         sema_init(&info->wait_sema, 0, "Open Info Sema");
 491
 492         msg = (hv_vmbus_channel_gpadl_teardown*) info->msg;
 493
 494         msg->header.message_type = HV_CHANNEL_MESSAGE_GPADL_TEARDOWN;
 495         msg->child_rel_id = channel->offer_msg.child_rel_id;
 496         msg->gpadl = gpadl_handle;
 497
 498         mtx_lock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 499         TAILQ_INSERT_TAIL(&hv_vmbus_g_connection.channel_msg_anchor,
 500                         info, msg_list_entry);
 501         mtx_unlock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 502
 503         ret = hv_vmbus_post_message(msg,
 504                         sizeof(hv_vmbus_channel_gpadl_teardown));
 505         if (ret != 0)
 506             goto cleanup;
 507
 508         ret = sema_timedwait(&info->wait_sema, 5 * hz); /* KYS 5 seconds */
 509
 510 cleanup:
 511         /*
 512          * Received a torndown response
 513          */
 514         mtx_lock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 515         TAILQ_REMOVE(&hv_vmbus_g_connection.channel_msg_anchor,
 516                         info, msg_list_entry);
 517         mtx_unlock_spin(&hv_vmbus_g_connection.channel_msg_lock);
 518         sema_destroy(&info->wait_sema);
 519         free(info, M_DEVBUF);
 520
 521         return (ret);
 522 }
 523
 524 static void
 525 hv_vmbus_channel_close_internal(hv_vmbus_channel *channel)
 526 {
 527         int ret = 0;
 528         struct taskqueue *rxq = channel->rxq;
 529         hv_vmbus_channel_close_channel* msg;
 530         hv_vmbus_channel_msg_info* info;
 531
 532         channel->state = HV_CHANNEL_OPEN_STATE;
 533         channel->sc_creation_callback = NULL;
 534
 535         /*
 536          * set rxq to NULL to avoid more requests be scheduled
 537          */
 538         channel->rxq = NULL;
 539         taskqueue_drain(rxq, &channel->channel_task);
 540         channel->on_channel_callback = NULL;
 541
 542         /**
 543          * Send a closing message
 544          */
 545         info = (hv_vmbus_channel_msg_info *)
 546                 malloc( sizeof(hv_vmbus_channel_msg_info) +
 547                         sizeof(hv_vmbus_channel_close_channel),
 548                                 M_DEVBUF, M_NOWAIT);
 549         KASSERT(info != NULL, ("VMBUS: malloc failed hv_vmbus_channel_close!"));
 550         if(info == NULL)
 551             return;
 552
 553         msg = (hv_vmbus_channel_close_channel*) info->msg;
 554         msg->header.message_type = HV_CHANNEL_MESSAGE_CLOSE_CHANNEL;
 555         msg->child_rel_id = channel->offer_msg.child_rel_id;
 556
 557         ret = hv_vmbus_post_message(
 558                 msg, sizeof(hv_vmbus_channel_close_channel));
 559
 560         /* Tear down the gpadl for the channel's ring buffer */
 561         if (channel->ring_buffer_gpadl_handle) {
 562                 hv_vmbus_channel_teardown_gpdal(channel,
 563                         channel->ring_buffer_gpadl_handle);
 564         }
 565
 566         /* TODO: Send a msg to release the childRelId */
 567
 568         /* cleanup the ring buffers for this channel */
 569         hv_ring_buffer_cleanup(&channel->outbound);
 570         hv_ring_buffer_cleanup(&channel->inbound);
 571
 572         contigfree(channel->ring_buffer_pages, channel->ring_buffer_size,
 573             M_DEVBUF);
 574
 575         free(info, M_DEVBUF);
 576 }
 577
 578 /**
 579  * @brief Close the specified channel
 580  */
 581 void
 582 hv_vmbus_channel_close(hv_vmbus_channel *channel)
 583 {
 584         hv_vmbus_channel*       sub_channel;
 585
 586         if (channel->primary_channel != NULL) {
 587                 /*
 588                  * We only close multi-channels when the primary is
 589                  * closed.
 590                  */
 591                 return;
 592         }
 593
 594         /*
 595          * Close all multi-channels first.
 596          */
 597         TAILQ_FOREACH(sub_channel, &channel->sc_list_anchor,
 598             sc_list_entry) {
 599                 if (sub_channel->state != HV_CHANNEL_OPENED_STATE)
 600                         continue;
 601                 hv_vmbus_channel_close_internal(sub_channel);
 602         }
 603         /*
 604          * Then close the primary channel.
 605          */
 606         hv_vmbus_channel_close_internal(channel);
 607 }
 608
 609 /**
 610  * @brief Send the specified buffer on the given channel
 611  */
 612 int
 613 hv_vmbus_channel_send_packet(
 614         hv_vmbus_channel*       channel,
 615         void*                   buffer,
 616         uint32_t                buffer_len,
 617         uint64_t                request_id,
 618         hv_vmbus_packet_type    type,
 619         uint32_t                flags)
 620 {
 621         int                     ret = 0;
 622         hv_vm_packet_descriptor desc;
 623         uint32_t                packet_len;
 624         uint64_t                aligned_data;
 625         uint32_t                packet_len_aligned;
 626         boolean_t               need_sig;
 627         hv_vmbus_sg_buffer_list buffer_list[3];
 628
 629         packet_len = sizeof(hv_vm_packet_descriptor) + buffer_len;
 630         packet_len_aligned = HV_ALIGN_UP(packet_len, sizeof(uint64_t));
 631         aligned_data = 0;
 632
 633         /* Setup the descriptor */
 634         desc.type = type;   /* HV_VMBUS_PACKET_TYPE_DATA_IN_BAND;             */
 635         desc.flags = flags; /* HV_VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED */
 636                             /* in 8-bytes granularity */
 637         desc.data_offset8 = sizeof(hv_vm_packet_descriptor) >> 3;
 638         desc.length8 = (uint16_t) (packet_len_aligned >> 3);
 639         desc.transaction_id = request_id;
 640
 641         buffer_list[0].data = &desc;
 642         buffer_list[0].length = sizeof(hv_vm_packet_descriptor);
 643
 644         buffer_list[1].data = buffer;
 645         buffer_list[1].length = buffer_len;
 646
 647         buffer_list[2].data = &aligned_data;
 648         buffer_list[2].length = packet_len_aligned - packet_len;
 649
 650         ret = hv_ring_buffer_write(&channel->outbound, buffer_list, 3,
 651             &need_sig);
 652
 653         /* TODO: We should determine if this is optional */
 654         if (ret == 0 && need_sig) {
 655                 vmbus_channel_set_event(channel);
 656         }
 657
 658         return (ret);
 659 }
 660
 661 /**
 662  * @brief Send a range of single-page buffer packets using
 663  * a GPADL Direct packet type
 664  */
 665 int
 666 hv_vmbus_channel_send_packet_pagebuffer(
 667         hv_vmbus_channel*       channel,
 668         hv_vmbus_page_buffer    page_buffers[],
 669         uint32_t                page_count,
 670         void*                   buffer,
 671         uint32_t                buffer_len,
 672         uint64_t                request_id)
 673 {
 674
 675         int                                     ret = 0;
 676         boolean_t                               need_sig;
 677         uint32_t                                packet_len;
 678         uint32_t                                page_buflen;
 679         uint32_t                                packetLen_aligned;
 680         hv_vmbus_sg_buffer_list                 buffer_list[4];
 681         hv_vmbus_channel_packet_page_buffer     desc;
 682         uint32_t                                descSize;
 683         uint64_t                                alignedData = 0;
 684
 685         if (page_count > HV_MAX_PAGE_BUFFER_COUNT)
 686                 return (EINVAL);
 687
 688         /*
 689          * Adjust the size down since hv_vmbus_channel_packet_page_buffer
 690          *  is the largest size we support
 691          */
 692         descSize = __offsetof(hv_vmbus_channel_packet_page_buffer, range);
 693         page_buflen = sizeof(hv_vmbus_page_buffer) * page_count;
 694         packet_len = descSize + page_buflen + buffer_len;
 695         packetLen_aligned = HV_ALIGN_UP(packet_len, sizeof(uint64_t));
 696
 697         /* Setup the descriptor */
 698         desc.type = HV_VMBUS_PACKET_TYPE_DATA_USING_GPA_DIRECT;
 699         desc.flags = HV_VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED;
 700         /* in 8-bytes granularity */
 701         desc.data_offset8 = (descSize + page_buflen) >> 3;
 702         desc.length8 = (uint16_t) (packetLen_aligned >> 3);
 703         desc.transaction_id = request_id;
 704         desc.range_count = page_count;
 705
 706         buffer_list[0].data = &desc;
 707         buffer_list[0].length = descSize;
 708
 709         buffer_list[1].data = page_buffers;
 710         buffer_list[1].length = page_buflen;
 711
 712         buffer_list[2].data = buffer;
 713         buffer_list[2].length = buffer_len;
 714
 715         buffer_list[3].data = &alignedData;
 716         buffer_list[3].length = packetLen_aligned - packet_len;
 717
 718         ret = hv_ring_buffer_write(&channel->outbound, buffer_list, 4,
 719             &need_sig);
 720
 721         /* TODO: We should determine if this is optional */
 722         if (ret == 0 && need_sig) {
 723                 vmbus_channel_set_event(channel);
 724         }
 725
 726         return (ret);
 727 }
 728
 729 /**
 730  * @brief Send a multi-page buffer packet using a GPADL Direct packet type
 731  */
 732 int
 733 hv_vmbus_channel_send_packet_multipagebuffer(
 734         hv_vmbus_channel*               channel,
 735         hv_vmbus_multipage_buffer*      multi_page_buffer,
 736         void*                           buffer,
 737         uint32_t                        buffer_len,
 738         uint64_t                        request_id)
 739 {
 740
 741         int                     ret = 0;
 742         uint32_t                desc_size;
 743         boolean_t               need_sig;
 744         uint32_t                packet_len;
 745         uint32_t                packet_len_aligned;
 746         uint32_t                pfn_count;
 747         uint64_t                aligned_data = 0;
 748         hv_vmbus_sg_buffer_list buffer_list[3];
 749         hv_vmbus_channel_packet_multipage_buffer desc;
 750
 751         pfn_count =
 752             HV_NUM_PAGES_SPANNED(
 753                     multi_page_buffer->offset,
 754                     multi_page_buffer->length);
 755
 756         if ((pfn_count == 0) || (pfn_count > HV_MAX_MULTIPAGE_BUFFER_COUNT))
 757             return (EINVAL);
 758         /*
 759          * Adjust the size down since hv_vmbus_channel_packet_multipage_buffer
 760          * is the largest size we support
 761          */
 762         desc_size =
 763             sizeof(hv_vmbus_channel_packet_multipage_buffer) -
 764                     ((HV_MAX_MULTIPAGE_BUFFER_COUNT - pfn_count) *
 765                         sizeof(uint64_t));
 766         packet_len = desc_size + buffer_len;
 767         packet_len_aligned = HV_ALIGN_UP(packet_len, sizeof(uint64_t));
 768
 769         /*
 770          * Setup the descriptor
 771          */
 772         desc.type = HV_VMBUS_PACKET_TYPE_DATA_USING_GPA_DIRECT;
 773         desc.flags = HV_VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED;
 774         desc.data_offset8 = desc_size >> 3; /* in 8-bytes granularity */
 775         desc.length8 = (uint16_t) (packet_len_aligned >> 3);
 776         desc.transaction_id = request_id;
 777         desc.range_count = 1;
 778
 779         desc.range.length = multi_page_buffer->length;
 780         desc.range.offset = multi_page_buffer->offset;
 781
 782         memcpy(desc.range.pfn_array, multi_page_buffer->pfn_array,
 783                 pfn_count * sizeof(uint64_t));
 784
 785         buffer_list[0].data = &desc;
 786         buffer_list[0].length = desc_size;
 787
 788         buffer_list[1].data = buffer;
 789         buffer_list[1].length = buffer_len;
 790
 791         buffer_list[2].data = &aligned_data;
 792         buffer_list[2].length = packet_len_aligned - packet_len;
 793
 794         ret = hv_ring_buffer_write(&channel->outbound, buffer_list, 3,
 795             &need_sig);
 796
 797         /* TODO: We should determine if this is optional */
 798         if (ret == 0 && need_sig) {
 799             vmbus_channel_set_event(channel);
 800         }
 801
 802         return (ret);
 803 }
 804
 805 /**
 806  * @brief Retrieve the user packet on the specified channel
 807  */
 808 int
 809 hv_vmbus_channel_recv_packet(
 810         hv_vmbus_channel*       channel,
 811         void*                   Buffer,
 812         uint32_t                buffer_len,
 813         uint32_t*               buffer_actual_len,
 814         uint64_t*               request_id)
 815 {
 816         int                     ret;
 817         uint32_t                user_len;
 818         uint32_t                packet_len;
 819         hv_vm_packet_descriptor desc;
 820
 821         *buffer_actual_len = 0;
 822         *request_id = 0;
 823
 824         ret = hv_ring_buffer_peek(&channel->inbound, &desc,
 825                 sizeof(hv_vm_packet_descriptor));
 826         if (ret != 0)
 827                 return (0);
 828
 829         packet_len = desc.length8 << 3;
 830         user_len = packet_len - (desc.data_offset8 << 3);
 831
 832         *buffer_actual_len = user_len;
 833
 834         if (user_len > buffer_len)
 835                 return (EINVAL);
 836
 837         *request_id = desc.transaction_id;
 838
 839         /* Copy over the packet to the user buffer */
 840         ret = hv_ring_buffer_read(&channel->inbound, Buffer, user_len,
 841                 (desc.data_offset8 << 3));
 842
 843         return (0);
 844 }
 845
 846 /**
 847  * @brief Retrieve the raw packet on the specified channel
 848  */
 849 int
 850 hv_vmbus_channel_recv_packet_raw(
 851         hv_vmbus_channel*       channel,
 852         void*                   buffer,
 853         uint32_t                buffer_len,
 854         uint32_t*               buffer_actual_len,
 855         uint64_t*               request_id)
 856 {
 857         int             ret;
 858         uint32_t        packetLen;
 859         uint32_t        userLen;
 860         hv_vm_packet_descriptor desc;
 861
 862         *buffer_actual_len = 0;
 863         *request_id = 0;
 864
 865         ret = hv_ring_buffer_peek(
 866                 &channel->inbound, &desc,
 867                 sizeof(hv_vm_packet_descriptor));
 868
 869         if (ret != 0)
 870             return (0);
 871
 872         packetLen = desc.length8 << 3;
 873         userLen = packetLen - (desc.data_offset8 << 3);
 874
 875         *buffer_actual_len = packetLen;
 876
 877         if (packetLen > buffer_len)
 878             return (ENOBUFS);
 879
 880         *request_id = desc.transaction_id;
 881
 882         /* Copy over the entire packet to the user buffer */
 883         ret = hv_ring_buffer_read(&channel->inbound, buffer, packetLen, 0);
 884
 885         return (0);
 886 }
 887
 888
 889 /**
 890  * Process a channel event notification
 891  */
 892 static void
 893 VmbusProcessChannelEvent(void* context, int pending)
 894 {
 895         void* arg;
 896         uint32_t bytes_to_read;
 897         hv_vmbus_channel* channel = (hv_vmbus_channel*)context;
 898         boolean_t is_batched_reading;
 899
 900         /**
 901          * Find the channel based on this relid and invokes
 902          * the channel callback to process the event
 903          */
 904
 905         if (channel == NULL) {
 906                 return;
 907         }
 908         /**
 909          * To deal with the race condition where we might
 910          * receive a packet while the relevant driver is
 911          * being unloaded, dispatch the callback while
 912          * holding the channel lock. The unloading driver
 913          * will acquire the same channel lock to set the
 914          * callback to NULL. This closes the window.
 915          */
 916
 917         if (channel->on_channel_callback != NULL) {
 918                 arg = channel->channel_callback_context;
 919                 is_batched_reading = channel->batched_reading;
 920                 /*
 921                  * Optimize host to guest signaling by ensuring:
 922                  * 1. While reading the channel, we disable interrupts from
 923                  *    host.
 924                  * 2. Ensure that we process all posted messages from the host
 925                  *    before returning from this callback.
 926                  * 3. Once we return, enable signaling from the host. Once this
 927                  *    state is set we check to see if additional packets are
 928                  *    available to read. In this case we repeat the process.
 929                  */
 930                 do {
 931                         if (is_batched_reading)
 932                                 hv_ring_buffer_read_begin(&channel->inbound);
 933
 934                         channel->on_channel_callback(arg);
 935
 936                         if (is_batched_reading)
 937                                 bytes_to_read =
 938                                     hv_ring_buffer_read_end(&channel->inbound);
 939                         else
 940                                 bytes_to_read = 0;
 941                 } while (is_batched_reading && (bytes_to_read != 0));
 942         }
 943 }