hw/virtio-serial-bus.c

   1 /*
   2  * A bus for connecting virtio serial and console ports
   3  *
   4  * Copyright (C) 2009 Red Hat, Inc.
   5  *
   6  * Author(s):
   7  *  Amit Shah <amit.shah@redhat.com>
   8  *
   9  * Some earlier parts are:
  10  *  Copyright IBM, Corp. 2008
  11  * authored by
  12  *  Christian Ehrhardt <ehrhardt@linux.vnet.ibm.com>
  13  *
  14  * This work is licensed under the terms of the GNU GPL, version 2.  See
  15  * the COPYING file in the top-level directory.
  16  */
  17
  18 #include "monitor.h"
  19 #include "qemu-queue.h"
  20 #include "sysbus.h"
  21 #include "virtio-serial.h"
  22
  23 /* The virtio-serial bus on top of which the ports will ride as devices */
  24 struct VirtIOSerialBus {
  25     BusState qbus;
  26
  27     /* This is the parent device that provides the bus for ports. */
  28     VirtIOSerial *vser;
  29
  30     /* The maximum number of ports that can ride on top of this bus */
  31     uint32_t max_nr_ports;
  32 };
  33
  34 struct VirtIOSerial {
  35     VirtIODevice vdev;
  36
  37     VirtQueue *c_ivq, *c_ovq;
  38     /* Arrays of ivqs and ovqs: one per port */
  39     VirtQueue **ivqs, **ovqs;
  40
  41     VirtIOSerialBus *bus;
  42
  43     QTAILQ_HEAD(, VirtIOSerialPort) ports;
  44     struct virtio_console_config config;
  45 };
  46
  47 static VirtIOSerialPort *find_port_by_id(VirtIOSerial *vser, uint32_t id)
  48 {
  49     VirtIOSerialPort *port;
  50
  51     QTAILQ_FOREACH(port, &vser->ports, next) {
  52         if (port->id == id)
  53             return port;
  54     }
  55     return NULL;
  56 }
  57
  58 static VirtIOSerialPort *find_port_by_vq(VirtIOSerial *vser, VirtQueue *vq)
  59 {
  60     VirtIOSerialPort *port;
  61
  62     QTAILQ_FOREACH(port, &vser->ports, next) {
  63         if (port->ivq == vq || port->ovq == vq)
  64             return port;
  65     }
  66     return NULL;
  67 }
  68
  69 static bool use_multiport(VirtIOSerial *vser)
  70 {
  71     return vser->vdev.guest_features & (1 << VIRTIO_CONSOLE_F_MULTIPORT);
  72 }
  73
  74 static size_t write_to_port(VirtIOSerialPort *port,
  75                             const uint8_t *buf, size_t size)
  76 {
  77     VirtQueueElement elem;
  78     VirtQueue *vq;
  79     size_t offset = 0;
  80     size_t len = 0;
  81
  82     vq = port->ivq;
  83     if (!virtio_queue_ready(vq)) {
  84         return 0;
  85     }
  86     if (!size) {
  87         return 0;
  88     }
  89
  90     while (offset < size) {
  91         int i;
  92
  93         if (!virtqueue_pop(vq, &elem)) {
  94             break;
  95         }
  96
  97         for (i = 0; offset < size && i < elem.in_num; i++) {
  98             len = MIN(elem.in_sg[i].iov_len, size - offset);
  99
 100             memcpy(elem.in_sg[i].iov_base, buf + offset, len);
 101             offset += len;
 102         }
 103         virtqueue_push(vq, &elem, len);
 104     }
 105
 106     virtio_notify(&port->vser->vdev, vq);
 107     return offset;
 108 }
 109
 110 static size_t send_control_msg(VirtIOSerialPort *port, void *buf, size_t len)
 111 {
 112     VirtQueueElement elem;
 113     VirtQueue *vq;
 114     struct virtio_console_control *cpkt;
 115
 116     vq = port->vser->c_ivq;
 117     if (!virtio_queue_ready(vq)) {
 118         return 0;
 119     }
 120     if (!virtqueue_pop(vq, &elem)) {
 121         return 0;
 122     }
 123
 124     cpkt = (struct virtio_console_control *)buf;
 125     stl_p(&cpkt->id, port->id);
 126     memcpy(elem.in_sg[0].iov_base, buf, len);
 127
 128     virtqueue_push(vq, &elem, len);
 129     virtio_notify(&port->vser->vdev, vq);
 130     return len;
 131 }
 132
 133 static size_t send_control_event(VirtIOSerialPort *port, uint16_t event,
 134                                  uint16_t value)
 135 {
 136     struct virtio_console_control cpkt;
 137
 138     stw_p(&cpkt.event, event);
 139     stw_p(&cpkt.value, value);
 140
 141     return send_control_msg(port, &cpkt, sizeof(cpkt));
 142 }
 143
 144 /* Functions for use inside qemu to open and read from/write to ports */
 145 int virtio_serial_open(VirtIOSerialPort *port)
 146 {
 147     /* Don't allow opening an already-open port */
 148     if (port->host_connected) {
 149         return 0;
 150     }
 151     /* Send port open notification to the guest */
 152     port->host_connected = true;
 153     send_control_event(port, VIRTIO_CONSOLE_PORT_OPEN, 1);
 154
 155     return 0;
 156 }
 157
 158 int virtio_serial_close(VirtIOSerialPort *port)
 159 {
 160     port->host_connected = false;
 161     send_control_event(port, VIRTIO_CONSOLE_PORT_OPEN, 0);
 162
 163     return 0;
 164 }
 165
 166 /* Individual ports/apps call this function to write to the guest. */
 167 ssize_t virtio_serial_write(VirtIOSerialPort *port, const uint8_t *buf,
 168                             size_t size)
 169 {
 170     if (!port || !port->host_connected || !port->guest_connected) {
 171         return 0;
 172     }
 173     return write_to_port(port, buf, size);
 174 }
 175
 176 /*
 177  * Readiness of the guest to accept data on a port.
 178  * Returns max. data the guest can receive
 179  */
 180 size_t virtio_serial_guest_ready(VirtIOSerialPort *port)
 181 {
 182     VirtQueue *vq = port->ivq;
 183
 184     if (!virtio_queue_ready(vq) ||
 185         !(port->vser->vdev.status & VIRTIO_CONFIG_S_DRIVER_OK) ||
 186         virtio_queue_empty(vq)) {
 187         return 0;
 188     }
 189     if (use_multiport(port->vser) && !port->guest_connected) {
 190         return 0;
 191     }
 192
 193     if (virtqueue_avail_bytes(vq, 4096, 0)) {
 194         return 4096;
 195     }
 196     if (virtqueue_avail_bytes(vq, 1, 0)) {
 197         return 1;
 198     }
 199     return 0;
 200 }
 201
 202 /* Guest wants to notify us of some event */
 203 static void handle_control_message(VirtIOSerial *vser, void *buf)
 204 {
 205     struct VirtIOSerialPort *port;
 206     struct virtio_console_control cpkt, *gcpkt;
 207     uint8_t *buffer;
 208     size_t buffer_len;
 209
 210     gcpkt = buf;
 211     port = find_port_by_id(vser, ldl_p(&gcpkt->id));
 212     if (!port)
 213         return;
 214
 215     cpkt.event = lduw_p(&gcpkt->event);
 216     cpkt.value = lduw_p(&gcpkt->value);
 217
 218     switch(cpkt.event) {
 219     case VIRTIO_CONSOLE_PORT_READY:
 220         /*
 221          * Now that we know the guest asked for the port name, we're
 222          * sure the guest has initialised whatever state is necessary
 223          * for this port. Now's a good time to let the guest know if
 224          * this port is a console port so that the guest can hook it
 225          * up to hvc.
 226          */
 227         if (port->is_console) {
 228             send_control_event(port, VIRTIO_CONSOLE_CONSOLE_PORT, 1);
 229         }
 230
 231         if (port->name) {
 232             stw_p(&cpkt.event, VIRTIO_CONSOLE_PORT_NAME);
 233             stw_p(&cpkt.value, 1);
 234
 235             buffer_len = sizeof(cpkt) + strlen(port->name) + 1;
 236             buffer = qemu_malloc(buffer_len);
 237
 238             memcpy(buffer, &cpkt, sizeof(cpkt));
 239             memcpy(buffer + sizeof(cpkt), port->name, strlen(port->name));
 240             buffer[buffer_len - 1] = 0;
 241
 242             send_control_msg(port, buffer, buffer_len);
 243             qemu_free(buffer);
 244         }
 245
 246         if (port->host_connected) {
 247             send_control_event(port, VIRTIO_CONSOLE_PORT_OPEN, 1);
 248         }
 249
 250         /*
 251          * When the guest has asked us for this information it means
 252          * the guest is all setup and has its virtqueues
 253          * initialised. If some app is interested in knowing about
 254          * this event, let it know.
 255          */
 256         if (port->info->guest_ready) {
 257             port->info->guest_ready(port);
 258         }
 259         break;
 260
 261     case VIRTIO_CONSOLE_PORT_OPEN:
 262         port->guest_connected = cpkt.value;
 263         if (cpkt.value && port->info->guest_open) {
 264             /* Send the guest opened notification if an app is interested */
 265             port->info->guest_open(port);
 266         }
 267
 268         if (!cpkt.value && port->info->guest_close) {
 269             /* Send the guest closed notification if an app is interested */
 270             port->info->guest_close(port);
 271         }
 272         break;
 273     }
 274 }
 275
 276 static void control_in(VirtIODevice *vdev, VirtQueue *vq)
 277 {
 278 }
 279
 280 static void control_out(VirtIODevice *vdev, VirtQueue *vq)
 281 {
 282     VirtQueueElement elem;
 283     VirtIOSerial *vser;
 284
 285     vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
 286
 287     while (virtqueue_pop(vq, &elem)) {
 288         handle_control_message(vser, elem.out_sg[0].iov_base);
 289         virtqueue_push(vq, &elem, elem.out_sg[0].iov_len);
 290     }
 291     virtio_notify(vdev, vq);
 292 }
 293
 294 /* Guest wrote something to some port. */
 295 static void handle_output(VirtIODevice *vdev, VirtQueue *vq)
 296 {
 297     VirtIOSerial *vser;
 298     VirtQueueElement elem;
 299
 300     vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
 301
 302     while (virtqueue_pop(vq, &elem)) {
 303         VirtIOSerialPort *port;
 304         size_t ret;
 305
 306         port = find_port_by_vq(vser, vq);
 307         if (!port) {
 308             ret = 0;
 309             goto next_buf;
 310         }
 311
 312         /*
 313          * A port may not have any handler registered for consuming the
 314          * data that the guest sends or it may not have a chardev associated
 315          * with it. Just ignore the data in that case.
 316          */
 317         if (!port->info->have_data) {
 318             ret = 0;
 319             goto next_buf;
 320         }
 321
 322         /* The guest always sends only one sg */
 323         ret = port->info->have_data(port, elem.out_sg[0].iov_base,
 324                                     elem.out_sg[0].iov_len);
 325
 326     next_buf:
 327         virtqueue_push(vq, &elem, ret);
 328     }
 329     virtio_notify(vdev, vq);
 330 }
 331
 332 static void handle_input(VirtIODevice *vdev, VirtQueue *vq)
 333 {
 334 }
 335
 336 static uint32_t get_features(VirtIODevice *vdev, uint32_t features)
 337 {
 338     VirtIOSerial *vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
 339     if (vser->bus->max_nr_ports > 1) {
 340         features |= (1 << VIRTIO_CONSOLE_F_MULTIPORT);
 341     }
 342     return features;
 343 }
 344
 345 /* Guest requested config info */
 346 static void get_config(VirtIODevice *vdev, uint8_t *config_data)
 347 {
 348     VirtIOSerial *vser;
 349
 350     vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
 351     memcpy(config_data, &vser->config, sizeof(struct virtio_console_config));
 352 }
 353
 354 static void set_config(VirtIODevice *vdev, const uint8_t *config_data)
 355 {
 356     struct virtio_console_config config;
 357
 358     memcpy(&config, config_data, sizeof(config));
 359 }
 360
 361 static void virtio_serial_save(QEMUFile *f, void *opaque)
 362 {
 363     VirtIOSerial *s = opaque;
 364     VirtIOSerialPort *port;
 365     uint32_t nr_active_ports;
 366
 367     /* The virtio device */
 368     virtio_save(&s->vdev, f);
 369
 370     /* The config space */
 371     qemu_put_be16s(f, &s->config.cols);
 372     qemu_put_be16s(f, &s->config.rows);
 373     qemu_put_be32s(f, &s->config.nr_ports);
 374
 375     /* Items in struct VirtIOSerial */
 376
 377     qemu_put_be32s(f, &s->bus->max_nr_ports);
 378
 379     /* Do this because we might have hot-unplugged some ports */
 380     nr_active_ports = 0;
 381     QTAILQ_FOREACH(port, &s->ports, next) {
 382         nr_active_ports++;
 383     }
 384
 385     qemu_put_be32s(f, &nr_active_ports);
 386
 387     /*
 388      * Items in struct VirtIOSerialPort.
 389      */
 390     QTAILQ_FOREACH(port, &s->ports, next) {
 391         /*
 392          * We put the port number because we may not have an active
 393          * port at id 0 that's reserved for a console port, or in case
 394          * of ports that might have gotten unplugged
 395          */
 396         qemu_put_be32s(f, &port->id);
 397         qemu_put_byte(f, port->guest_connected);
 398         qemu_put_byte(f, port->host_connected);
 399     }
 400 }
 401
 402 static int virtio_serial_load(QEMUFile *f, void *opaque, int version_id)
 403 {
 404     VirtIOSerial *s = opaque;
 405     VirtIOSerialPort *port;
 406     uint32_t max_nr_ports, nr_active_ports, nr_ports;
 407     unsigned int i;
 408
 409     if (version_id > 2) {
 410         return -EINVAL;
 411     }
 412
 413     /* The virtio device */
 414     virtio_load(&s->vdev, f);
 415
 416     if (version_id < 2) {
 417         return 0;
 418     }
 419
 420     /* The config space */
 421     qemu_get_be16s(f, &s->config.cols);
 422     qemu_get_be16s(f, &s->config.rows);
 423     nr_ports = qemu_get_be32(f);
 424
 425     if (nr_ports != s->config.nr_ports) {
 426         /*
 427          * Source hot-plugged/unplugged ports and we don't have all of
 428          * them here.
 429          *
 430          * Note: This condition cannot check for all hotplug/unplug
 431          * events: eg, if one port was hot-plugged and one was
 432          * unplugged, the nr_ports remains the same but the port id's
 433          * would have changed and we won't catch it here. A later
 434          * check for !find_port_by_id() will confirm if this happened.
 435          */
 436         return -EINVAL;
 437     }
 438
 439     /* Items in struct VirtIOSerial */
 440
 441     qemu_get_be32s(f, &max_nr_ports);
 442     if (max_nr_ports > s->bus->max_nr_ports) {
 443         /* Source could have more ports than us. Fail migration. */
 444         return -EINVAL;
 445     }
 446
 447     qemu_get_be32s(f, &nr_active_ports);
 448
 449     /* Items in struct VirtIOSerialPort */
 450     for (i = 0; i < nr_active_ports; i++) {
 451         uint32_t id;
 452         bool host_connected;
 453
 454         id = qemu_get_be32(f);
 455         port = find_port_by_id(s, id);
 456         if (!port) {
 457             /*
 458              * The requested port was hot-plugged on the source but we
 459              * don't have it
 460              */
 461             return -EINVAL;
 462         }
 463
 464         port->guest_connected = qemu_get_byte(f);
 465         host_connected = qemu_get_byte(f);
 466         if (host_connected != port->host_connected) {
 467             /*
 468              * We have to let the guest know of the host connection
 469              * status change
 470              */
 471             send_control_event(port, VIRTIO_CONSOLE_PORT_OPEN,
 472                                port->host_connected);
 473         }
 474     }
 475
 476     return 0;
 477 }
 478
 479 static void virtser_bus_dev_print(Monitor *mon, DeviceState *qdev, int indent);
 480
 481 static struct BusInfo virtser_bus_info = {
 482     .name      = "virtio-serial-bus",
 483     .size      = sizeof(VirtIOSerialBus),
 484     .print_dev = virtser_bus_dev_print,
 485 };
 486
 487 static VirtIOSerialBus *virtser_bus_new(DeviceState *dev)
 488 {
 489     VirtIOSerialBus *bus;
 490
 491     bus = FROM_QBUS(VirtIOSerialBus, qbus_create(&virtser_bus_info, dev, NULL));
 492     bus->qbus.allow_hotplug = 1;
 493
 494     return bus;
 495 }
 496
 497 static void virtser_bus_dev_print(Monitor *mon, DeviceState *qdev, int indent)
 498 {
 499     VirtIOSerialDevice *dev = DO_UPCAST(VirtIOSerialDevice, qdev, qdev);
 500     VirtIOSerialPort *port = DO_UPCAST(VirtIOSerialPort, dev, &dev->qdev);
 501
 502     monitor_printf(mon, "%*s dev-prop-int: id: %u\n",
 503                    indent, "", port->id);
 504     monitor_printf(mon, "%*s dev-prop-int: guest_connected: %d\n",
 505                    indent, "", port->guest_connected);
 506     monitor_printf(mon, "%*s dev-prop-int: host_connected: %d\n",
 507                    indent, "", port->host_connected);
 508 }
 509
 510 static int virtser_port_qdev_init(DeviceState *qdev, DeviceInfo *base)
 511 {
 512     VirtIOSerialDevice *dev = DO_UPCAST(VirtIOSerialDevice, qdev, qdev);
 513     VirtIOSerialPortInfo *info = DO_UPCAST(VirtIOSerialPortInfo, qdev, base);
 514     VirtIOSerialPort *port = DO_UPCAST(VirtIOSerialPort, dev, &dev->qdev);
 515     VirtIOSerialBus *bus = DO_UPCAST(VirtIOSerialBus, qbus, qdev->parent_bus);
 516     int ret;
 517     bool plugging_port0;
 518
 519     port->vser = bus->vser;
 520
 521     /*
 522      * Is the first console port we're seeing? If so, put it up at
 523      * location 0. This is done for backward compatibility (old
 524      * kernel, new qemu).
 525      */
 526     plugging_port0 = port->is_console && !find_port_by_id(port->vser, 0);
 527
 528     if (port->vser->config.nr_ports == bus->max_nr_ports && !plugging_port0) {
 529         error_report("virtio-serial-bus: Maximum device limit reached");
 530         return -1;
 531     }
 532     dev->info = info;
 533
 534     ret = info->init(dev);
 535     if (ret) {
 536         return ret;
 537     }
 538
 539     port->id = plugging_port0 ? 0 : port->vser->config.nr_ports++;
 540
 541     if (!use_multiport(port->vser)) {
 542         /*
 543          * Allow writes to guest in this case; we have no way of
 544          * knowing if a guest port is connected.
 545          */
 546         port->guest_connected = true;
 547     }
 548
 549     QTAILQ_INSERT_TAIL(&port->vser->ports, port, next);
 550     port->ivq = port->vser->ivqs[port->id];
 551     port->ovq = port->vser->ovqs[port->id];
 552
 553     /* Send an update to the guest about this new port added */
 554     virtio_notify_config(&port->vser->vdev);
 555
 556     return ret;
 557 }
 558
 559 static int virtser_port_qdev_exit(DeviceState *qdev)
 560 {
 561     VirtIOSerialDevice *dev = DO_UPCAST(VirtIOSerialDevice, qdev, qdev);
 562     VirtIOSerialPort *port = DO_UPCAST(VirtIOSerialPort, dev, &dev->qdev);
 563     VirtIOSerial *vser = port->vser;
 564
 565     send_control_event(port, VIRTIO_CONSOLE_PORT_REMOVE, 1);
 566
 567     /*
 568      * Don't decrement nr_ports here; thus we keep a linearly
 569      * increasing port id. Not utilising an id again saves us a couple
 570      * of complications:
 571      *
 572      * - Not having to bother about sending the port id to the guest
 573      *   kernel on hotplug or on addition of new ports; the guest can
 574      *   also linearly increment the port number. This is preferable
 575      *   because the config space won't have the need to store a
 576      *   ports_map.
 577      *
 578      * - Extra state to be stored for all the "holes" that got created
 579      *   so that we keep filling in the ids from the least available
 580      *   index.
 581      *
 582      * When such a functionality is desired, a control message to add
 583      * a port can be introduced.
 584      */
 585     QTAILQ_REMOVE(&vser->ports, port, next);
 586
 587     if (port->info->exit)
 588         port->info->exit(dev);
 589
 590     return 0;
 591 }
 592
 593 void virtio_serial_port_qdev_register(VirtIOSerialPortInfo *info)
 594 {
 595     info->qdev.init = virtser_port_qdev_init;
 596     info->qdev.bus_info = &virtser_bus_info;
 597     info->qdev.exit = virtser_port_qdev_exit;
 598     info->qdev.unplug = qdev_simple_unplug_cb;
 599     qdev_register(&info->qdev);
 600 }
 601
 602 VirtIODevice *virtio_serial_init(DeviceState *dev, uint32_t max_nr_ports)
 603 {
 604     VirtIOSerial *vser;
 605     VirtIODevice *vdev;
 606     uint32_t i;
 607
 608     if (!max_nr_ports)
 609         return NULL;
 610
 611     vdev = virtio_common_init("virtio-serial", VIRTIO_ID_CONSOLE,
 612                               sizeof(struct virtio_console_config),
 613                               sizeof(VirtIOSerial));
 614
 615     vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
 616
 617     /* Spawn a new virtio-serial bus on which the ports will ride as devices */
 618     vser->bus = virtser_bus_new(dev);
 619     vser->bus->vser = vser;
 620     QTAILQ_INIT(&vser->ports);
 621
 622     vser->bus->max_nr_ports = max_nr_ports;
 623     vser->ivqs = qemu_malloc(max_nr_ports * sizeof(VirtQueue *));
 624     vser->ovqs = qemu_malloc(max_nr_ports * sizeof(VirtQueue *));
 625
 626     /* Add a queue for host to guest transfers for port 0 (backward compat) */
 627     vser->ivqs[0] = virtio_add_queue(vdev, 128, handle_input);
 628     /* Add a queue for guest to host transfers for port 0 (backward compat) */
 629     vser->ovqs[0] = virtio_add_queue(vdev, 128, handle_output);
 630
 631     /* control queue: host to guest */
 632     vser->c_ivq = virtio_add_queue(vdev, 16, control_in);
 633     /* control queue: guest to host */
 634     vser->c_ovq = virtio_add_queue(vdev, 16, control_out);
 635
 636     for (i = 1; i < vser->bus->max_nr_ports; i++) {
 637         /* Add a per-port queue for host to guest transfers */
 638         vser->ivqs[i] = virtio_add_queue(vdev, 128, handle_input);
 639         /* Add a per-per queue for guest to host transfers */
 640         vser->ovqs[i] = virtio_add_queue(vdev, 128, handle_output);
 641     }
 642
 643     vser->config.max_nr_ports = max_nr_ports;
 644     /*
 645      * Reserve location 0 for a console port for backward compat
 646      * (old kernel, new qemu)
 647      */
 648     vser->config.nr_ports = 1;
 649
 650     vser->vdev.get_features = get_features;
 651     vser->vdev.get_config = get_config;
 652     vser->vdev.set_config = set_config;
 653
 654     /*
 655      * Register for the savevm section with the virtio-console name
 656      * to preserve backward compat
 657      */
 658     register_savevm("virtio-console", -1, 2, virtio_serial_save,
 659                     virtio_serial_load, vser);
 660
 661     return vdev;
 662 }