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     features |= (1 << VIRTIO_CONSOLE_F_MULTIPORT);
 339
 340     return features;
 341 }
 342
 343 /* Guest requested config info */
 344 static void get_config(VirtIODevice *vdev, uint8_t *config_data)
 345 {
 346     VirtIOSerial *vser;
 347
 348     vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
 349     memcpy(config_data, &vser->config, sizeof(struct virtio_console_config));
 350 }
 351
 352 static void set_config(VirtIODevice *vdev, const uint8_t *config_data)
 353 {
 354     struct virtio_console_config config;
 355
 356     memcpy(&config, config_data, sizeof(config));
 357 }
 358
 359 static void virtio_serial_save(QEMUFile *f, void *opaque)
 360 {
 361     VirtIOSerial *s = opaque;
 362     VirtIOSerialPort *port;
 363     uint32_t nr_active_ports;
 364
 365     /* The virtio device */
 366     virtio_save(&s->vdev, f);
 367
 368     /* The config space */
 369     qemu_put_be16s(f, &s->config.cols);
 370     qemu_put_be16s(f, &s->config.rows);
 371     qemu_put_be32s(f, &s->config.nr_ports);
 372
 373     /* Items in struct VirtIOSerial */
 374
 375     /* Do this because we might have hot-unplugged some ports */
 376     nr_active_ports = 0;
 377     QTAILQ_FOREACH(port, &s->ports, next)
 378         nr_active_ports++;
 379
 380     qemu_put_be32s(f, &nr_active_ports);
 381
 382     /*
 383      * Items in struct VirtIOSerialPort.
 384      */
 385     QTAILQ_FOREACH(port, &s->ports, next) {
 386         /*
 387          * We put the port number because we may not have an active
 388          * port at id 0 that's reserved for a console port, or in case
 389          * of ports that might have gotten unplugged
 390          */
 391         qemu_put_be32s(f, &port->id);
 392         qemu_put_byte(f, port->guest_connected);
 393     }
 394 }
 395
 396 static int virtio_serial_load(QEMUFile *f, void *opaque, int version_id)
 397 {
 398     VirtIOSerial *s = opaque;
 399     VirtIOSerialPort *port;
 400     uint32_t nr_active_ports;
 401     unsigned int i;
 402
 403     if (version_id > 2) {
 404         return -EINVAL;
 405     }
 406
 407     /* The virtio device */
 408     virtio_load(&s->vdev, f);
 409
 410     if (version_id < 2) {
 411         return 0;
 412     }
 413
 414     /* The config space */
 415     qemu_get_be16s(f, &s->config.cols);
 416     qemu_get_be16s(f, &s->config.rows);
 417     s->config.nr_ports = qemu_get_be32(f);
 418
 419     /* Items in struct VirtIOSerial */
 420
 421     qemu_get_be32s(f, &nr_active_ports);
 422
 423     /* Items in struct VirtIOSerialPort */
 424     for (i = 0; i < nr_active_ports; i++) {
 425         uint32_t id;
 426
 427         id = qemu_get_be32(f);
 428         port = find_port_by_id(s, id);
 429
 430         port->guest_connected = qemu_get_byte(f);
 431     }
 432
 433     return 0;
 434 }
 435
 436 static void virtser_bus_dev_print(Monitor *mon, DeviceState *qdev, int indent);
 437
 438 static struct BusInfo virtser_bus_info = {
 439     .name      = "virtio-serial-bus",
 440     .size      = sizeof(VirtIOSerialBus),
 441     .print_dev = virtser_bus_dev_print,
 442 };
 443
 444 static VirtIOSerialBus *virtser_bus_new(DeviceState *dev)
 445 {
 446     VirtIOSerialBus *bus;
 447
 448     bus = FROM_QBUS(VirtIOSerialBus, qbus_create(&virtser_bus_info, dev, NULL));
 449     bus->qbus.allow_hotplug = 1;
 450
 451     return bus;
 452 }
 453
 454 static void virtser_bus_dev_print(Monitor *mon, DeviceState *qdev, int indent)
 455 {
 456     VirtIOSerialDevice *dev = DO_UPCAST(VirtIOSerialDevice, qdev, qdev);
 457     VirtIOSerialPort *port = DO_UPCAST(VirtIOSerialPort, dev, &dev->qdev);
 458
 459     monitor_printf(mon, "%*s dev-prop-int: id: %u\n",
 460                    indent, "", port->id);
 461     monitor_printf(mon, "%*s dev-prop-int: guest_connected: %d\n",
 462                    indent, "", port->guest_connected);
 463     monitor_printf(mon, "%*s dev-prop-int: host_connected: %d\n",
 464                    indent, "", port->host_connected);
 465 }
 466
 467 static int virtser_port_qdev_init(DeviceState *qdev, DeviceInfo *base)
 468 {
 469     VirtIOSerialDevice *dev = DO_UPCAST(VirtIOSerialDevice, qdev, qdev);
 470     VirtIOSerialPortInfo *info = DO_UPCAST(VirtIOSerialPortInfo, qdev, base);
 471     VirtIOSerialPort *port = DO_UPCAST(VirtIOSerialPort, dev, &dev->qdev);
 472     VirtIOSerialBus *bus = DO_UPCAST(VirtIOSerialBus, qbus, qdev->parent_bus);
 473     int ret;
 474     bool plugging_port0;
 475
 476     port->vser = bus->vser;
 477
 478     /*
 479      * Is the first console port we're seeing? If so, put it up at
 480      * location 0. This is done for backward compatibility (old
 481      * kernel, new qemu).
 482      */
 483     plugging_port0 = port->is_console && !find_port_by_id(port->vser, 0);
 484
 485     if (port->vser->config.nr_ports == bus->max_nr_ports && !plugging_port0) {
 486         qemu_error("virtio-serial-bus: Maximum device limit reached\n");
 487         return -1;
 488     }
 489     dev->info = info;
 490
 491     ret = info->init(dev);
 492     if (ret) {
 493         return ret;
 494     }
 495
 496     port->id = plugging_port0 ? 0 : port->vser->config.nr_ports++;
 497
 498     if (!use_multiport(port->vser)) {
 499         /*
 500          * Allow writes to guest in this case; we have no way of
 501          * knowing if a guest port is connected.
 502          */
 503         port->guest_connected = true;
 504     }
 505
 506     QTAILQ_INSERT_TAIL(&port->vser->ports, port, next);
 507     port->ivq = port->vser->ivqs[port->id];
 508     port->ovq = port->vser->ovqs[port->id];
 509
 510     /* Send an update to the guest about this new port added */
 511     virtio_notify_config(&port->vser->vdev);
 512
 513     return ret;
 514 }
 515
 516 static int virtser_port_qdev_exit(DeviceState *qdev)
 517 {
 518     VirtIOSerialDevice *dev = DO_UPCAST(VirtIOSerialDevice, qdev, qdev);
 519     VirtIOSerialPort *port = DO_UPCAST(VirtIOSerialPort, dev, &dev->qdev);
 520     VirtIOSerial *vser = port->vser;
 521
 522     send_control_event(port, VIRTIO_CONSOLE_PORT_REMOVE, 1);
 523
 524     /*
 525      * Don't decrement nr_ports here; thus we keep a linearly
 526      * increasing port id. Not utilising an id again saves us a couple
 527      * of complications:
 528      *
 529      * - Not having to bother about sending the port id to the guest
 530      *   kernel on hotplug or on addition of new ports; the guest can
 531      *   also linearly increment the port number. This is preferable
 532      *   because the config space won't have the need to store a
 533      *   ports_map.
 534      *
 535      * - Extra state to be stored for all the "holes" that got created
 536      *   so that we keep filling in the ids from the least available
 537      *   index.
 538      *
 539      * When such a functionality is desired, a control message to add
 540      * a port can be introduced.
 541      */
 542     QTAILQ_REMOVE(&vser->ports, port, next);
 543
 544     if (port->info->exit)
 545         port->info->exit(dev);
 546
 547     return 0;
 548 }
 549
 550 void virtio_serial_port_qdev_register(VirtIOSerialPortInfo *info)
 551 {
 552     info->qdev.init = virtser_port_qdev_init;
 553     info->qdev.bus_info = &virtser_bus_info;
 554     info->qdev.exit = virtser_port_qdev_exit;
 555     info->qdev.unplug = qdev_simple_unplug_cb;
 556     qdev_register(&info->qdev);
 557 }
 558
 559 VirtIODevice *virtio_serial_init(DeviceState *dev, uint32_t max_nr_ports)
 560 {
 561     VirtIOSerial *vser;
 562     VirtIODevice *vdev;
 563     uint32_t i;
 564
 565     if (!max_nr_ports)
 566         return NULL;
 567
 568     vdev = virtio_common_init("virtio-serial", VIRTIO_ID_CONSOLE,
 569                               sizeof(struct virtio_console_config),
 570                               sizeof(VirtIOSerial));
 571
 572     vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
 573
 574     /* Spawn a new virtio-serial bus on which the ports will ride as devices */
 575     vser->bus = virtser_bus_new(dev);
 576     vser->bus->vser = vser;
 577     QTAILQ_INIT(&vser->ports);
 578
 579     vser->bus->max_nr_ports = max_nr_ports;
 580     vser->ivqs = qemu_malloc(max_nr_ports * sizeof(VirtQueue *));
 581     vser->ovqs = qemu_malloc(max_nr_ports * sizeof(VirtQueue *));
 582
 583     /* Add a queue for host to guest transfers for port 0 (backward compat) */
 584     vser->ivqs[0] = virtio_add_queue(vdev, 128, handle_input);
 585     /* Add a queue for guest to host transfers for port 0 (backward compat) */
 586     vser->ovqs[0] = virtio_add_queue(vdev, 128, handle_output);
 587
 588     /* control queue: host to guest */
 589     vser->c_ivq = virtio_add_queue(vdev, 16, control_in);
 590     /* control queue: guest to host */
 591     vser->c_ovq = virtio_add_queue(vdev, 16, control_out);
 592
 593     for (i = 1; i < vser->bus->max_nr_ports; i++) {
 594         /* Add a per-port queue for host to guest transfers */
 595         vser->ivqs[i] = virtio_add_queue(vdev, 128, handle_input);
 596         /* Add a per-per queue for guest to host transfers */
 597         vser->ovqs[i] = virtio_add_queue(vdev, 128, handle_output);
 598     }
 599
 600     vser->config.max_nr_ports = max_nr_ports;
 601     /*
 602      * Reserve location 0 for a console port for backward compat
 603      * (old kernel, new qemu)
 604      */
 605     vser->config.nr_ports = 1;
 606
 607     vser->vdev.get_features = get_features;
 608     vser->vdev.get_config = get_config;
 609     vser->vdev.set_config = set_config;
 610
 611     /*
 612      * Register for the savevm section with the virtio-console name
 613      * to preserve backward compat
 614      */
 615     register_savevm("virtio-console", -1, 2, virtio_serial_save,
 616                     virtio_serial_load, vser);
 617
 618     return vdev;
 619 }