2 * A bus for connecting virtio serial and console ports
4 * Copyright (C) 2009, 2010 Red Hat, Inc.
9 * Some earlier parts are:
10 * Copyright IBM, Corp. 2008
14 * This work is licensed under the terms of the GNU GPL, version 2. See
15 * the COPYING file in the top-level directory.
20 #include "qemu-queue.h"
22 #include "virtio-serial.h"
24 /* The virtio-serial bus on top of which the ports will ride as devices */
25 struct VirtIOSerialBus {
28 /* This is the parent device that provides the bus for ports. */
31 /* The maximum number of ports that can ride on top of this bus */
32 uint32_t max_nr_ports;
38 VirtQueue *c_ivq, *c_ovq;
39 /* Arrays of ivqs and ovqs: one per port */
40 VirtQueue **ivqs, **ovqs;
46 QTAILQ_HEAD(, VirtIOSerialPort) ports;
48 /* bitmap for identifying active ports */
51 struct virtio_console_config config;
54 static VirtIOSerialPort *find_port_by_id(VirtIOSerial *vser, uint32_t id)
56 VirtIOSerialPort *port;
58 if (id == VIRTIO_CONSOLE_BAD_ID) {
62 QTAILQ_FOREACH(port, &vser->ports, next) {
69 static VirtIOSerialPort *find_port_by_vq(VirtIOSerial *vser, VirtQueue *vq)
71 VirtIOSerialPort *port;
73 QTAILQ_FOREACH(port, &vser->ports, next) {
74 if (port->ivq == vq || port->ovq == vq)
80 static bool use_multiport(VirtIOSerial *vser)
82 return vser->vdev.guest_features & (1 << VIRTIO_CONSOLE_F_MULTIPORT);
85 static size_t write_to_port(VirtIOSerialPort *port,
86 const uint8_t *buf, size_t size)
88 VirtQueueElement elem;
93 if (!virtio_queue_ready(vq)) {
98 while (offset < size) {
101 if (!virtqueue_pop(vq, &elem)) {
105 len = iov_from_buf(elem.in_sg, elem.in_num,
106 buf + offset, size - offset);
109 virtqueue_push(vq, &elem, len);
112 virtio_notify(&port->vser->vdev, vq);
116 static void discard_vq_data(VirtQueue *vq, VirtIODevice *vdev)
118 VirtQueueElement elem;
120 if (!virtio_queue_ready(vq)) {
123 while (virtqueue_pop(vq, &elem)) {
124 virtqueue_push(vq, &elem, 0);
126 virtio_notify(vdev, vq);
129 static void do_flush_queued_data(VirtIOSerialPort *port, VirtQueue *vq,
132 VirtIOSerialPortInfo *info;
135 assert(virtio_queue_ready(vq));
137 info = DO_UPCAST(VirtIOSerialPortInfo, qdev, port->dev.info);
139 while (!port->throttled) {
142 /* Pop an elem only if we haven't left off a previous one mid-way */
143 if (!port->elem.out_num) {
144 if (!virtqueue_pop(vq, &port->elem)) {
148 port->iov_offset = 0;
151 for (i = port->iov_idx; i < port->elem.out_num; i++) {
155 buf_size = port->elem.out_sg[i].iov_len - port->iov_offset;
156 ret = info->have_data(port,
157 port->elem.out_sg[i].iov_base
160 if (ret < 0 && ret != -EAGAIN) {
161 /* We don't handle any other type of errors here */
164 if (ret == -EAGAIN || (ret >= 0 && ret < buf_size)) {
165 virtio_serial_throttle_port(port, true);
168 port->iov_offset += ret;
172 port->iov_offset = 0;
174 if (port->throttled) {
177 virtqueue_push(vq, &port->elem, 0);
178 port->elem.out_num = 0;
180 virtio_notify(vdev, vq);
183 static void flush_queued_data(VirtIOSerialPort *port)
187 if (!virtio_queue_ready(port->ovq)) {
190 do_flush_queued_data(port, port->ovq, &port->vser->vdev);
193 static size_t send_control_msg(VirtIOSerialPort *port, void *buf, size_t len)
195 VirtQueueElement elem;
197 struct virtio_console_control *cpkt;
199 vq = port->vser->c_ivq;
200 if (!virtio_queue_ready(vq)) {
203 if (!virtqueue_pop(vq, &elem)) {
207 cpkt = (struct virtio_console_control *)buf;
208 stl_p(&cpkt->id, port->id);
209 memcpy(elem.in_sg[0].iov_base, buf, len);
211 virtqueue_push(vq, &elem, len);
212 virtio_notify(&port->vser->vdev, vq);
216 static size_t send_control_event(VirtIOSerialPort *port, uint16_t event,
219 struct virtio_console_control cpkt;
221 stw_p(&cpkt.event, event);
222 stw_p(&cpkt.value, value);
224 return send_control_msg(port, &cpkt, sizeof(cpkt));
227 /* Functions for use inside qemu to open and read from/write to ports */
228 int virtio_serial_open(VirtIOSerialPort *port)
230 /* Don't allow opening an already-open port */
231 if (port->host_connected) {
234 /* Send port open notification to the guest */
235 port->host_connected = true;
236 send_control_event(port, VIRTIO_CONSOLE_PORT_OPEN, 1);
241 int virtio_serial_close(VirtIOSerialPort *port)
243 port->host_connected = false;
245 * If there's any data the guest sent which the app didn't
246 * consume, reset the throttling flag and discard the data.
248 port->throttled = false;
249 discard_vq_data(port->ovq, &port->vser->vdev);
251 send_control_event(port, VIRTIO_CONSOLE_PORT_OPEN, 0);
256 /* Individual ports/apps call this function to write to the guest. */
257 ssize_t virtio_serial_write(VirtIOSerialPort *port, const uint8_t *buf,
260 if (!port || !port->host_connected || !port->guest_connected) {
263 return write_to_port(port, buf, size);
267 * Readiness of the guest to accept data on a port.
268 * Returns max. data the guest can receive
270 size_t virtio_serial_guest_ready(VirtIOSerialPort *port)
272 VirtQueue *vq = port->ivq;
274 if (!virtio_queue_ready(vq) ||
275 !(port->vser->vdev.status & VIRTIO_CONFIG_S_DRIVER_OK) ||
276 virtio_queue_empty(vq)) {
279 if (use_multiport(port->vser) && !port->guest_connected) {
283 if (virtqueue_avail_bytes(vq, 4096, 0)) {
286 if (virtqueue_avail_bytes(vq, 1, 0)) {
292 static void flush_queued_data_bh(void *opaque)
294 VirtIOSerialPort *port = opaque;
296 flush_queued_data(port);
299 void virtio_serial_throttle_port(VirtIOSerialPort *port, bool throttle)
305 port->throttled = throttle;
309 qemu_bh_schedule(port->bh);
312 /* Guest wants to notify us of some event */
313 static void handle_control_message(VirtIOSerial *vser, void *buf, size_t len)
315 struct VirtIOSerialPort *port;
316 struct VirtIOSerialPortInfo *info;
317 struct virtio_console_control cpkt, *gcpkt;
323 if (len < sizeof(cpkt)) {
324 /* The guest sent an invalid control packet */
328 cpkt.event = lduw_p(&gcpkt->event);
329 cpkt.value = lduw_p(&gcpkt->value);
331 port = find_port_by_id(vser, ldl_p(&gcpkt->id));
332 if (!port && cpkt.event != VIRTIO_CONSOLE_DEVICE_READY)
335 info = DO_UPCAST(VirtIOSerialPortInfo, qdev, port->dev.info);
338 case VIRTIO_CONSOLE_DEVICE_READY:
340 error_report("virtio-serial-bus: Guest failure in adding device %s\n",
341 vser->bus.qbus.name);
345 * The device is up, we can now tell the device about all the
346 * ports we have here.
348 QTAILQ_FOREACH(port, &vser->ports, next) {
349 send_control_event(port, VIRTIO_CONSOLE_PORT_ADD, 1);
353 case VIRTIO_CONSOLE_PORT_READY:
355 error_report("virtio-serial-bus: Guest failure in adding port %u for device %s\n",
356 port->id, vser->bus.qbus.name);
360 * Now that we know the guest asked for the port name, we're
361 * sure the guest has initialised whatever state is necessary
362 * for this port. Now's a good time to let the guest know if
363 * this port is a console port so that the guest can hook it
366 if (info->is_console) {
367 send_control_event(port, VIRTIO_CONSOLE_CONSOLE_PORT, 1);
371 stw_p(&cpkt.event, VIRTIO_CONSOLE_PORT_NAME);
372 stw_p(&cpkt.value, 1);
374 buffer_len = sizeof(cpkt) + strlen(port->name) + 1;
375 buffer = qemu_malloc(buffer_len);
377 memcpy(buffer, &cpkt, sizeof(cpkt));
378 memcpy(buffer + sizeof(cpkt), port->name, strlen(port->name));
379 buffer[buffer_len - 1] = 0;
381 send_control_msg(port, buffer, buffer_len);
385 if (port->host_connected) {
386 send_control_event(port, VIRTIO_CONSOLE_PORT_OPEN, 1);
390 * When the guest has asked us for this information it means
391 * the guest is all setup and has its virtqueues
392 * initialised. If some app is interested in knowing about
393 * this event, let it know.
395 if (info->guest_ready) {
396 info->guest_ready(port);
400 case VIRTIO_CONSOLE_PORT_OPEN:
401 port->guest_connected = cpkt.value;
402 if (cpkt.value && info->guest_open) {
403 /* Send the guest opened notification if an app is interested */
404 info->guest_open(port);
407 if (!cpkt.value && info->guest_close) {
408 /* Send the guest closed notification if an app is interested */
409 info->guest_close(port);
415 static void control_in(VirtIODevice *vdev, VirtQueue *vq)
419 static void control_out(VirtIODevice *vdev, VirtQueue *vq)
421 VirtQueueElement elem;
426 vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
430 while (virtqueue_pop(vq, &elem)) {
431 size_t cur_len, copied;
433 cur_len = iov_size(elem.out_sg, elem.out_num);
435 * Allocate a new buf only if we didn't have one previously or
436 * if the size of the buf differs
441 buf = qemu_malloc(cur_len);
444 copied = iov_to_buf(elem.out_sg, elem.out_num, buf, 0, len);
446 handle_control_message(vser, buf, copied);
447 virtqueue_push(vq, &elem, 0);
450 virtio_notify(vdev, vq);
453 /* Guest wrote something to some port. */
454 static void handle_output(VirtIODevice *vdev, VirtQueue *vq)
457 VirtIOSerialPort *port;
458 VirtIOSerialPortInfo *info;
460 vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
461 port = find_port_by_vq(vser, vq);
462 info = port ? DO_UPCAST(VirtIOSerialPortInfo, qdev, port->dev.info) : NULL;
464 if (!port || !port->host_connected || !info->have_data) {
465 discard_vq_data(vq, vdev);
469 if (!port->throttled) {
470 do_flush_queued_data(port, vq, vdev);
475 static void handle_input(VirtIODevice *vdev, VirtQueue *vq)
479 static uint32_t get_features(VirtIODevice *vdev, uint32_t features)
483 vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
485 if (vser->bus.max_nr_ports > 1) {
486 features |= (1 << VIRTIO_CONSOLE_F_MULTIPORT);
491 /* Guest requested config info */
492 static void get_config(VirtIODevice *vdev, uint8_t *config_data)
496 vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
497 memcpy(config_data, &vser->config, sizeof(struct virtio_console_config));
500 static void set_config(VirtIODevice *vdev, const uint8_t *config_data)
502 struct virtio_console_config config;
504 memcpy(&config, config_data, sizeof(config));
507 static void virtio_serial_save(QEMUFile *f, void *opaque)
509 VirtIOSerial *s = opaque;
510 VirtIOSerialPort *port;
511 uint32_t nr_active_ports;
512 unsigned int i, max_nr_ports;
514 /* The virtio device */
515 virtio_save(&s->vdev, f);
517 /* The config space */
518 qemu_put_be16s(f, &s->config.cols);
519 qemu_put_be16s(f, &s->config.rows);
521 qemu_put_be32s(f, &s->config.max_nr_ports);
524 max_nr_ports = tswap32(s->config.max_nr_ports);
525 for (i = 0; i < (max_nr_ports + 31) / 32; i++) {
526 qemu_put_be32s(f, &s->ports_map[i]);
532 QTAILQ_FOREACH(port, &s->ports, next) {
536 qemu_put_be32s(f, &nr_active_ports);
539 * Items in struct VirtIOSerialPort.
541 QTAILQ_FOREACH(port, &s->ports, next) {
542 uint32_t elem_popped;
544 qemu_put_be32s(f, &port->id);
545 qemu_put_byte(f, port->guest_connected);
546 qemu_put_byte(f, port->host_connected);
549 if (port->elem.out_num) {
552 qemu_put_be32s(f, &elem_popped);
554 qemu_put_be32s(f, &port->iov_idx);
555 qemu_put_be64s(f, &port->iov_offset);
557 qemu_put_buffer(f, (unsigned char *)&port->elem,
563 static int virtio_serial_load(QEMUFile *f, void *opaque, int version_id)
565 VirtIOSerial *s = opaque;
566 VirtIOSerialPort *port;
567 uint32_t max_nr_ports, nr_active_ports, ports_map;
570 if (version_id > 3) {
574 /* The virtio device */
575 virtio_load(&s->vdev, f);
577 if (version_id < 2) {
581 /* The config space */
582 qemu_get_be16s(f, &s->config.cols);
583 qemu_get_be16s(f, &s->config.rows);
585 qemu_get_be32s(f, &max_nr_ports);
586 tswap32s(&max_nr_ports);
587 if (max_nr_ports > tswap32(s->config.max_nr_ports)) {
588 /* Source could have had more ports than us. Fail migration. */
592 for (i = 0; i < (max_nr_ports + 31) / 32; i++) {
593 qemu_get_be32s(f, &ports_map);
595 if (ports_map != s->ports_map[i]) {
597 * Ports active on source and destination don't
598 * match. Fail migration.
604 qemu_get_be32s(f, &nr_active_ports);
606 /* Items in struct VirtIOSerialPort */
607 for (i = 0; i < nr_active_ports; i++) {
611 id = qemu_get_be32(f);
612 port = find_port_by_id(s, id);
617 port->guest_connected = qemu_get_byte(f);
618 host_connected = qemu_get_byte(f);
619 if (host_connected != port->host_connected) {
621 * We have to let the guest know of the host connection
624 send_control_event(port, VIRTIO_CONSOLE_PORT_OPEN,
625 port->host_connected);
628 if (version_id > 2) {
629 uint32_t elem_popped;
631 qemu_get_be32s(f, &elem_popped);
633 qemu_get_be32s(f, &port->iov_idx);
634 qemu_get_be64s(f, &port->iov_offset);
636 qemu_get_buffer(f, (unsigned char *)&port->elem,
638 virtqueue_map_sg(port->elem.in_sg, port->elem.in_addr,
639 port->elem.in_num, 1);
640 virtqueue_map_sg(port->elem.out_sg, port->elem.out_addr,
641 port->elem.out_num, 1);
644 * Port was throttled on source machine. Let's
645 * unthrottle it here so data starts flowing again.
647 virtio_serial_throttle_port(port, false);
654 static void virtser_bus_dev_print(Monitor *mon, DeviceState *qdev, int indent);
656 static struct BusInfo virtser_bus_info = {
657 .name = "virtio-serial-bus",
658 .size = sizeof(VirtIOSerialBus),
659 .print_dev = virtser_bus_dev_print,
662 static void virtser_bus_dev_print(Monitor *mon, DeviceState *qdev, int indent)
664 VirtIOSerialPort *port = DO_UPCAST(VirtIOSerialPort, dev, qdev);
666 monitor_printf(mon, "%*s dev-prop-int: id: %u\n",
667 indent, "", port->id);
668 monitor_printf(mon, "%*s dev-prop-int: guest_connected: %d\n",
669 indent, "", port->guest_connected);
670 monitor_printf(mon, "%*s dev-prop-int: host_connected: %d\n",
671 indent, "", port->host_connected);
672 monitor_printf(mon, "%*s dev-prop-int: throttled: %d\n",
673 indent, "", port->throttled);
676 /* This function is only used if a port id is not provided by the user */
677 static uint32_t find_free_port_id(VirtIOSerial *vser)
679 unsigned int i, max_nr_ports;
681 max_nr_ports = tswap32(vser->config.max_nr_ports);
682 for (i = 0; i < (max_nr_ports + 31) / 32; i++) {
685 map = vser->ports_map[i];
688 return (bit - 1) + i * 32;
691 return VIRTIO_CONSOLE_BAD_ID;
694 static void mark_port_added(VirtIOSerial *vser, uint32_t port_id)
699 vser->ports_map[i] |= 1U << (port_id % 32);
702 static void add_port(VirtIOSerial *vser, uint32_t port_id)
704 mark_port_added(vser, port_id);
706 send_control_event(find_port_by_id(vser, port_id),
707 VIRTIO_CONSOLE_PORT_ADD, 1);
710 static void remove_port(VirtIOSerial *vser, uint32_t port_id)
712 VirtIOSerialPort *port;
716 vser->ports_map[i] &= ~(1U << (port_id % 32));
718 port = find_port_by_id(vser, port_id);
719 /* Flush out any unconsumed buffers first */
720 discard_vq_data(port->ovq, &port->vser->vdev);
722 send_control_event(port, VIRTIO_CONSOLE_PORT_REMOVE, 1);
725 static int virtser_port_qdev_init(DeviceState *qdev, DeviceInfo *base)
727 VirtIOSerialPort *port = DO_UPCAST(VirtIOSerialPort, dev, qdev);
728 VirtIOSerialPortInfo *info = DO_UPCAST(VirtIOSerialPortInfo, qdev, base);
729 VirtIOSerialBus *bus = DO_UPCAST(VirtIOSerialBus, qbus, qdev->parent_bus);
730 int ret, max_nr_ports;
733 port->vser = bus->vser;
734 port->bh = qemu_bh_new(flush_queued_data_bh, port);
737 * Is the first console port we're seeing? If so, put it up at
738 * location 0. This is done for backward compatibility (old
741 plugging_port0 = info->is_console && !find_port_by_id(port->vser, 0);
743 if (find_port_by_id(port->vser, port->id)) {
744 error_report("virtio-serial-bus: A port already exists at id %u\n",
749 if (port->id == VIRTIO_CONSOLE_BAD_ID) {
750 if (plugging_port0) {
753 port->id = find_free_port_id(port->vser);
754 if (port->id == VIRTIO_CONSOLE_BAD_ID) {
755 error_report("virtio-serial-bus: Maximum port limit for this device reached\n");
761 max_nr_ports = tswap32(port->vser->config.max_nr_ports);
762 if (port->id >= max_nr_ports) {
763 error_report("virtio-serial-bus: Out-of-range port id specified, max. allowed: %u\n",
768 ret = info->init(port);
773 if (!use_multiport(port->vser)) {
775 * Allow writes to guest in this case; we have no way of
776 * knowing if a guest port is connected.
778 port->guest_connected = true;
781 port->elem.out_num = 0;
783 QTAILQ_INSERT_TAIL(&port->vser->ports, port, next);
784 port->ivq = port->vser->ivqs[port->id];
785 port->ovq = port->vser->ovqs[port->id];
787 add_port(port->vser, port->id);
789 /* Send an update to the guest about this new port added */
790 virtio_notify_config(&port->vser->vdev);
795 static int virtser_port_qdev_exit(DeviceState *qdev)
797 VirtIOSerialPort *port = DO_UPCAST(VirtIOSerialPort, dev, qdev);
798 VirtIOSerialPortInfo *info = DO_UPCAST(VirtIOSerialPortInfo, qdev,
800 VirtIOSerial *vser = port->vser;
802 qemu_bh_delete(port->bh);
803 remove_port(port->vser, port->id);
805 QTAILQ_REMOVE(&vser->ports, port, next);
813 void virtio_serial_port_qdev_register(VirtIOSerialPortInfo *info)
815 info->qdev.init = virtser_port_qdev_init;
816 info->qdev.bus_info = &virtser_bus_info;
817 info->qdev.exit = virtser_port_qdev_exit;
818 info->qdev.unplug = qdev_simple_unplug_cb;
819 qdev_register(&info->qdev);
822 VirtIODevice *virtio_serial_init(DeviceState *dev, virtio_serial_conf *conf)
826 uint32_t i, max_supported_ports;
828 if (!conf->max_virtserial_ports)
831 /* Each port takes 2 queues, and one pair is for the control queue */
832 max_supported_ports = VIRTIO_PCI_QUEUE_MAX / 2 - 1;
834 if (conf->max_virtserial_ports > max_supported_ports) {
835 error_report("maximum ports supported: %u", max_supported_ports);
839 vdev = virtio_common_init("virtio-serial", VIRTIO_ID_CONSOLE,
840 sizeof(struct virtio_console_config),
841 sizeof(VirtIOSerial));
843 vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
845 /* Spawn a new virtio-serial bus on which the ports will ride as devices */
846 qbus_create_inplace(&vser->bus.qbus, &virtser_bus_info, dev, NULL);
847 vser->bus.qbus.allow_hotplug = 1;
848 vser->bus.vser = vser;
849 QTAILQ_INIT(&vser->ports);
851 vser->bus.max_nr_ports = conf->max_virtserial_ports;
852 vser->ivqs = qemu_malloc(conf->max_virtserial_ports * sizeof(VirtQueue *));
853 vser->ovqs = qemu_malloc(conf->max_virtserial_ports * sizeof(VirtQueue *));
855 /* Add a queue for host to guest transfers for port 0 (backward compat) */
856 vser->ivqs[0] = virtio_add_queue(vdev, 128, handle_input);
857 /* Add a queue for guest to host transfers for port 0 (backward compat) */
858 vser->ovqs[0] = virtio_add_queue(vdev, 128, handle_output);
860 /* TODO: host to guest notifications can get dropped
861 * if the queue fills up. Implement queueing in host,
862 * this might also make it possible to reduce the control
863 * queue size: as guest preposts buffers there,
864 * this will save 4Kbyte of guest memory per entry. */
866 /* control queue: host to guest */
867 vser->c_ivq = virtio_add_queue(vdev, 32, control_in);
868 /* control queue: guest to host */
869 vser->c_ovq = virtio_add_queue(vdev, 32, control_out);
871 for (i = 1; i < vser->bus.max_nr_ports; i++) {
872 /* Add a per-port queue for host to guest transfers */
873 vser->ivqs[i] = virtio_add_queue(vdev, 128, handle_input);
874 /* Add a per-per queue for guest to host transfers */
875 vser->ovqs[i] = virtio_add_queue(vdev, 128, handle_output);
878 vser->config.max_nr_ports = tswap32(conf->max_virtserial_ports);
879 vser->ports_map = qemu_mallocz(((conf->max_virtserial_ports + 31) / 32)
880 * sizeof(vser->ports_map[0]));
882 * Reserve location 0 for a console port for backward compat
883 * (old kernel, new qemu)
885 mark_port_added(vser, 0);
887 vser->vdev.get_features = get_features;
888 vser->vdev.get_config = get_config;
889 vser->vdev.set_config = set_config;
894 * Register for the savevm section with the virtio-console name
895 * to preserve backward compat
897 register_savevm(dev, "virtio-console", -1, 3, virtio_serial_save,
898 virtio_serial_load, vser);
903 void virtio_serial_exit(VirtIODevice *vdev)
905 VirtIOSerial *vser = DO_UPCAST(VirtIOSerial, vdev, vdev);
907 unregister_savevm(vser->qdev, "virtio-console", vser);
909 qemu_free(vser->ivqs);
910 qemu_free(vser->ovqs);
911 qemu_free(vser->ports_map);
913 virtio_cleanup(vdev);