[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] Re: virtio-serial: A guest <-> host interface for simple co
|
From: |
Amit Shah |
|
Subject: |
[Qemu-devel] Re: virtio-serial: A guest <-> host interface for simple communication |
|
Date: |
Fri, 26 Jun 2009 02:19:04 +0530 |
|
User-agent: |
Mutt/1.5.19 (2009-01-05) |
On (Thu) Jun 25 2009 [21:03:02], Rusty Russell wrote:
> On Wed, 24 Jun 2009 10:09:37 pm Amit Shah wrote:
> > On (Wed) Jun 24 2009 [13:45:01], Rusty Russell wrote:
> > > On Tue, 23 Jun 2009 10:12:31 pm Amit Shah wrote:
> > > > Hello,
> > > >
> > > > Here are two patches. One implements a virtio-serial device in qemu
> > > > and the other is the driver for a guest kernel.
> > > >
> > > > While working on a vmchannel interface that is needed for communication
> > > > between guest userspace and host userspace, I saw that most of the
> > > > interface can be abstracted out as a "serial" device with "ports".
> > >
> > > OK, I don't think the "naming" idea works though. A userspace user would
> > > have to open each one in turn to get its name. I'd stick with numbers.
> >
> > What if an ioctl were added to get the port number from the port name?
> > Userspace would do
> > ioctl(fd, VIRTIO_SERIAL_GET_PORT_FROM_NAME, &nr);
> > sprintf(port, "/dev/vmch%s", nr);
> > fd2 = open(port, ...);
>
> Yep, pretty ugly tho. If you use the "Amit Shah is in charge of port
> numbering approach", then it's just:
>
> fd = open("/dev/vmch<my-assigned-number>", ...);
>
> Since you need to control names anyway, why not just use numbers?
That's a very interesting idea.
(But do we need such formal naming? Are the apps going to need such an
elaborate arrangement?)
> > > You also don't have dynamic creation and removal, except by hotpluging
> > > the entire device (which was on your requirements page).
> >
> > Actually we're more interested in hotplugging ports than the device
> > itself ("Dynamic channel creation").
>
> Exactly, which you don't seem to have.
You just challenged my laziness and todo list. See the new patch below ;-)
> > > what ports exist. Register on the change interrupt to get updates. Drop
> > > the control vq entirely.
> >
> > If the ioctl mentioned above were added, it would justify the control
> > vq, right?
>
> Yes. Or put another way, simplifying the interface to use assigned port
> numbers would simplify the implementation, use, and specification of the
> device
I agree. Let me think over this more. I'll also invite comments from
others.
Amit
diff --git a/drivers/char/Kconfig b/drivers/char/Kconfig
index 0bd01f4..4af76c7 100644
--- a/drivers/char/Kconfig
+++ b/drivers/char/Kconfig
@@ -679,6 +679,12 @@ config VIRTIO_CONSOLE
help
Virtio console for use with lguest and other hypervisors.
+config VIRTIO_SERIAL
+ tristate "Virtio serial"
+ select VIRTIO
+ select VIRTIO_RING
+ help
+ Virtio serial device driver for simple guest and host communication
config HVCS
tristate "IBM Hypervisor Virtual Console Server support"
diff --git a/drivers/char/Makefile b/drivers/char/Makefile
index 189efcf..0b6c71e 100644
--- a/drivers/char/Makefile
+++ b/drivers/char/Makefile
@@ -54,6 +54,7 @@ obj-$(CONFIG_HVC_XEN) += hvc_xen.o
obj-$(CONFIG_HVC_IUCV) += hvc_iucv.o
obj-$(CONFIG_HVC_UDBG) += hvc_udbg.o
obj-$(CONFIG_VIRTIO_CONSOLE) += virtio_console.o
+obj-$(CONFIG_VIRTIO_SERIAL) += virtio_serial.o
obj-$(CONFIG_RAW_DRIVER) += raw.o
obj-$(CONFIG_SGI_SNSC) += snsc.o snsc_event.o
obj-$(CONFIG_MSPEC) += mspec.o
diff --git a/drivers/char/virtio_serial.c b/drivers/char/virtio_serial.c
new file mode 100644
index 0000000..4439697
--- /dev/null
+++ b/drivers/char/virtio_serial.c
@@ -0,0 +1,645 @@
+/*
+ * VirtIO Serial driver
+ *
+ * This is paravirtualised serial guest<->host communication channel
+ * for relaying short messages and events in either direction.
+ *
+ * One PCI device can have multiple serial ports so that different
+ * applications can communicate without polluting the PCI device space
+ * in the guest.
+ *
+ * Copyright (C) 2009, Red Hat, Inc.
+ *
+ * Author(s): Amit Shah <address@hidden>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
+ */
+
+#include <linux/cdev.h>
+#include <linux/completion.h>
+#include <linux/err.h>
+#include <linux/fs.h>
+#include <linux/init.h>
+#include <linux/poll.h>
+#include <linux/virtio.h>
+#include <linux/virtio_serial.h>
+#include <linux/workqueue.h>
+
+struct virtio_serial_struct {
+ struct work_struct rx_work;
+ struct work_struct tx_work;
+ struct work_struct queue_work;
+
+ struct list_head port_head;
+
+ struct virtio_device *vdev;
+ struct virtqueue *ctrl_vq;
+ struct virtqueue *in_vq, *out_vq;
+
+ u32 nr_ports;
+};
+
+/* This struct holds individual buffers received for each port */
+struct virtio_serial_port_buffer {
+ struct list_head list;
+
+ unsigned int len; /* length of the buffer */
+ unsigned int offset; /* offset in the buf from which to consume data */
+
+ char *buf;
+};
+
+/* This struct is put in each buffer that gets passed to userspace and
+ * vice-versa
+ */
+struct virtio_serial_id {
+ u32 id; /* Port number */
+};
+
+struct virtio_serial_port {
+ /* The name given to this channel, if any. NOT zero-terminated */
+ char *name;
+
+ /* Next port in the list */
+ struct list_head next;
+
+ /* Buffer management */
+ struct virtio_serial_port_buffer read_buf;
+ struct list_head readbuf_head;
+ struct completion have_data;
+
+ /* Each port associates with a separate char device */
+ dev_t dev;
+ struct cdev cdev;
+
+ /* The number of this port */
+ u32 nr;
+};
+
+static struct virtio_serial_struct virtserial;
+
+static int major = 60; /* from the experimental range */
+
+static int request_control_info(struct virtio_serial_control *ser_control);
+
+static struct virtio_serial_port *get_port_from_id(u32 id)
+{
+ struct virtio_serial_port *port;
+ struct list_head *ptr;
+
+ list_for_each(ptr, &virtserial.port_head) {
+ port = list_entry(ptr, struct virtio_serial_port, next);
+
+ if (port->nr == id)
+ return port;
+ }
+ return NULL;
+}
+
+static int get_id_from_port(struct virtio_serial_port *port)
+{
+ struct virtio_serial_port *match;
+ struct list_head *ptr;
+
+ list_for_each(ptr, &virtserial.port_head) {
+ match = list_entry(ptr, struct virtio_serial_port, next);
+
+ if (match == port)
+ return port->nr;
+ }
+ return VIRTIO_SERIAL_BAD_ID;
+}
+
+static struct virtio_serial_port *get_port_from_buf(char *buf)
+{
+ u32 id;
+
+ memcpy(&id, buf, sizeof(id));
+
+ return get_port_from_id(id);
+}
+
+
+static ssize_t virtserial_read(struct file *filp, char __user *ubuf,
+ size_t count, loff_t *offp)
+{
+ struct list_head *ptr, *ptr2;
+ struct virtio_serial_port *port;
+ struct virtio_serial_port_buffer *buf;
+ ssize_t ret;
+
+ port = filp->private_data;
+
+ ret = -EINTR;
+ if (list_empty(&port->readbuf_head)) {
+ if (filp->f_flags & O_NONBLOCK)
+ return -EAGAIN;
+
+ if (wait_for_completion_interruptible(&port->have_data) < 0)
+ return ret;
+ }
+ list_for_each_safe(ptr, ptr2, &port->readbuf_head) {
+ buf = list_entry(ptr, struct virtio_serial_port_buffer, list);
+
+ /* FIXME: other buffers further in this list might
+ * have data too
+ */
+ if (count > buf->len - buf->offset)
+ count = buf->len - buf->offset;
+
+ ret = copy_to_user(ubuf, buf->buf + buf->offset, count);
+
+ /* Return the number of bytes actually copied */
+ ret = count - ret;
+
+ buf->offset += ret;
+
+ if (buf->len - buf->offset == 0) {
+ list_del(&buf->list);
+ kfree(buf->buf);
+ kfree(buf);
+ }
+ /* FIXME: if there's more data requested and more data
+ * available, return it.
+ */
+ break;
+ }
+ return ret;
+}
+
+static ssize_t virtserial_write(struct file *filp, const char __user *ubuf,
+ size_t count, loff_t *offp)
+{
+ struct virtqueue *out_vq;
+ struct virtio_serial_port *port;
+ struct virtio_serial_id id;
+ struct scatterlist sg[1];
+ char *vbuf;
+ ssize_t ret;
+ unsigned int size;
+
+ port = filp->private_data;
+
+ id.id = get_id_from_port(port);
+
+ size = min(count + sizeof(id), PAGE_SIZE);
+ vbuf = kmalloc(size, GFP_KERNEL);
+ if (!vbuf)
+ return -EFBIG;
+
+ memcpy(vbuf, &id, sizeof(id));
+ size -= sizeof(id);
+
+ ret = copy_from_user(vbuf + sizeof(id), ubuf, size);
+
+ /* Return the number of bytes actually written */
+ ret = size - ret;
+
+ out_vq = virtserial.out_vq;
+
+ sg_init_one(sg, vbuf, ret + sizeof(id));
+
+ /* add_buf wants a token to identify this buffer: we hand it any
+ * non-NULL pointer, since there's only ever one buffer.
+ */
+ if (out_vq->vq_ops->add_buf(out_vq, sg, 1, 0, vbuf)) {
+ /* XXX: We can't send the buffer. Report failure */
+ ret = 0;
+ }
+ /* Tell Host to go! */
+ out_vq->vq_ops->kick(out_vq);
+
+ /* FIXME: Write out the complete data in more buffers,
+ * don't just bail out after one
+ */
+
+ /* We're expected to return the amount of data we wrote */
+ return ret;
+}
+
+static long virtserial_ioctl(struct file *filp, unsigned int ioctl,
+ unsigned long arg)
+{
+ struct virtio_serial_port *port;
+ struct virtio_serial_port_name *port_name;
+ struct virtio_serial_control ser_control;
+ long ret;
+
+ port = filp->private_data;
+ ser_control.port_nr = get_id_from_port(port);
+
+ ret = -EINVAL;
+ switch (ioctl) {
+ case VIRTIO_SERIAL_IOCTL_GET_PORT_NAME:
+
+ port_name = (struct virtio_serial_port_name *)arg;
+
+ if (!port->name) {
+ if (ser_control.port_nr == VIRTIO_SERIAL_BAD_ID) {
+ ret = -EINVAL;
+ break;
+ }
+ ser_control.key = VIRTIO_SERIAL_GET_PORT_NAME;
+ ret = request_control_info(&ser_control);
+ if (ret < 0) {
+ /* Of IOCTL error return codes, only
+ * this one comes close to what has
+ * happened: either out of memory or
+ * the virtio-serial backend didn't
+ * have the associated name for the
+ * port
+ */
+ ret = -EINVAL;
+ break;
+ }
+ }
+ ret = copy_to_user(port_name->name,
+ port->name, VIRTIO_SERIAL_NAME_MAX_LEN);
+ if (ret < 0) {
+ ret = -EINVAL;
+ break;
+ }
+ if (ret > 0) {
+ /* Do something? There still is data to be
+ * copied to userspace
+ */
+ ret = 0;
+ }
+ break;
+ }
+ return ret;
+}
+
+static int virtserial_release(struct inode *inode, struct file *filp)
+{
+ pr_notice("%s\n", __func__);
+ return 0;
+}
+
+static int virtserial_open(struct inode *inode, struct file *filp)
+{
+ struct cdev *cdev = inode->i_cdev;
+ struct virtio_serial_port *port;
+
+ port = container_of(cdev, struct virtio_serial_port,
+ cdev);
+
+ filp->private_data = port;
+ return 0;
+}
+
+static unsigned int virtserial_poll(struct file *filp, poll_table *wait)
+{
+ pr_notice("%s\n", __func__);
+ return 0;
+}
+
+static const struct file_operations virtserial_fops = {
+ .owner = THIS_MODULE,
+ .open = virtserial_open,
+ .read = virtserial_read,
+ .write = virtserial_write,
+ .compat_ioctl = virtserial_ioctl,
+ .unlocked_ioctl = virtserial_ioctl,
+ .poll = virtserial_poll,
+ .release = virtserial_release,
+};
+
+static void virtio_serial_queue_work_handler(struct work_struct *work)
+{
+ struct scatterlist sg[1];
+ struct virtqueue *vq;
+ char *buf;
+
+ vq = virtserial.in_vq;
+ while (1) {
+ buf = kzalloc(PAGE_SIZE, GFP_KERNEL);
+ if (!buf)
+ break;
+
+ sg_init_one(sg, buf, PAGE_SIZE);
+
+ if (vq->vq_ops->add_buf(vq, sg, 0, 1, buf) < 0) {
+ kfree(buf);
+ break;
+ }
+ }
+ vq->vq_ops->kick(vq);
+}
+
+static void virtio_serial_rx_work_handler(struct work_struct *work)
+{
+ struct virtio_serial_port *port = NULL;
+ struct virtio_serial_port_buffer *buf;
+ struct virtqueue *vq;
+ char *tmpbuf;
+ unsigned int tmplen;
+
+ vq = virtserial.in_vq;
+ while ((tmpbuf = vq->vq_ops->get_buf(vq, &tmplen))) {
+ port = get_port_from_buf(tmpbuf);
+ if (!port) {
+ /* No valid index at start of
+ * buffer. Drop it.
+ */
+ pr_debug("%s: invalid index in buffer, %c %d\n",
+ __func__, tmpbuf[0], tmpbuf[0]);
+ break;
+ }
+ buf = kzalloc(sizeof(struct virtio_serial_port_buffer),
+ GFP_KERNEL);
+ if (!buf)
+ break;
+
+ buf->buf = tmpbuf;
+ buf->len = tmplen;
+ buf->offset = sizeof(struct virtio_serial_id);
+ list_add_tail(&buf->list, &port->readbuf_head);
+
+ complete(&port->have_data);
+ }
+ /* Allocate buffers for all the ones that got used up */
+ schedule_work(&virtserial.queue_work);
+}
+
+static void virtio_serial_tx_work_handler(struct work_struct *work)
+{
+ struct virtqueue *vq;
+ char *tmpbuf;
+ unsigned int tmplen;
+
+ vq = virtserial.out_vq;
+ while ((tmpbuf = vq->vq_ops->get_buf(vq, &tmplen)))
+ kfree(tmpbuf);
+}
+
+static void rx_intr(struct virtqueue *vq)
+{
+ schedule_work(&virtserial.rx_work);
+}
+
+static void tx_intr(struct virtqueue *vq)
+{
+ schedule_work(&virtserial.tx_work);
+}
+
+static int receive_control_response(struct virtqueue *vq)
+{
+ struct virtio_serial_port *port;
+ struct virtio_serial_control ser_control;
+ char *data;
+ unsigned int len;
+ int ret;
+
+ /* We can get spurious callbacks, e.g. shared IRQs + virtio_pci. */
+ data = vq->vq_ops->get_buf(vq, &len);
+ if (!data)
+ return 0;
+
+ /* Not enough data for the ioctl:
+ * key + id + data
+ */
+ /* XXX: return something else? */
+ if (len < sizeof(ser_control) + 1)
+ return -EIO;
+
+ memcpy(&ser_control, data, sizeof(ser_control));
+ len -= sizeof(ser_control);
+
+ ret = -EINVAL;
+ switch (ser_control.key) {
+ case VIRTIO_SERIAL_GET_PORT_NAME:
+ port = get_port_from_id(ser_control.port_nr);
+ if (!port) {
+ ret = -EINVAL;
+ break;
+ }
+
+ if (len > VIRTIO_SERIAL_NAME_MAX_LEN)
+ len = VIRTIO_SERIAL_NAME_MAX_LEN;
+
+ /* If the port is getting renamed */
+ kfree(port->name);
+
+ port->name = kzalloc(len, GFP_KERNEL);
+ if (!port->name) {
+ ret = -ENOMEM;
+ break;
+ }
+ memcpy(port->name, data + sizeof(ser_control), len);
+ ret = len;
+ break;
+ }
+ return ret;
+}
+
+static int request_control_info(struct virtio_serial_control *ser_control)
+{
+ struct scatterlist sg[2];
+ char *vbuf, *obuf;
+ int ret;
+
+ vbuf = kmalloc(PAGE_SIZE, GFP_KERNEL);
+ if (!vbuf)
+ return -ENOMEM;
+ obuf = kmalloc(PAGE_SIZE, GFP_KERNEL);
+ if (!obuf)
+ return -ENOMEM;
+
+ memcpy(vbuf, ser_control, sizeof(struct virtio_serial_control));
+
+ sg_init_table(sg, 2);
+ sg_set_buf(&sg[0], vbuf, PAGE_SIZE);
+ sg_set_buf(&sg[1], obuf, PAGE_SIZE);
+
+ if (virtserial.ctrl_vq->vq_ops->add_buf(virtserial.ctrl_vq, sg, 1, 1,
+ obuf) == 0) {
+ /* Tell Host to go! */
+ virtserial.ctrl_vq->vq_ops->kick(virtserial.ctrl_vq);
+
+ /* Chill out until it's done with the buffer. */
+ while (!(ret = receive_control_response(virtserial.ctrl_vq)))
+ cpu_relax();
+ }
+ kfree(vbuf);
+ kfree(obuf);
+
+ return ret;
+}
+
+static int virtserial_add_port(u32 port_nr)
+{
+ struct virtio_serial_port *port;
+ int ret;
+
+ port = kzalloc(sizeof(struct virtio_serial_port), GFP_KERNEL);
+ if (!port)
+ return -ENOMEM;
+
+ port->nr = port_nr;
+
+ cdev_init(&port->cdev, &virtserial_fops);
+ port->dev = MKDEV(major, port_nr);
+
+ ret = register_chrdev_region(port->dev, 1, "virtio-serial");
+ if (ret < 0) {
+ pr_err("%s: can't register chrdev region\n", __func__);
+ goto free_cdev;
+ }
+ ret = cdev_add(&port->cdev, port->dev, 1);
+ if (ret < 0) {
+ pr_err("%s: can't add cdev\n", __func__);
+ goto free_cdev;
+ }
+ INIT_LIST_HEAD(&port->readbuf_head);
+ init_completion(&port->have_data);
+
+ list_add_tail(&port->next, &virtserial.port_head);
+
+ return 0;
+free_cdev:
+ unregister_chrdev(major, "virtio-serial");
+ return ret;
+}
+
+static int virtserial_probe(struct virtio_device *vdev)
+{
+ struct virtqueue *vqs[3];
+ struct virtio_serial_config virtsercfg;
+
+ const char *vq_names[] = { "control", "input", "output" };
+ vq_callback_t *vq_callbacks[] = { NULL, rx_intr, tx_intr };
+
+ u32 i;
+ int ret;
+
+ vdev->config->get(vdev, offsetof(struct virtio_serial_config, nr_ports),
+ &virtsercfg.nr_ports, sizeof(virtsercfg.nr_ports));
+
+ virtserial.vdev = vdev;
+ virtserial.nr_ports = virtsercfg.nr_ports;
+
+ ret = vdev->config->find_vqs(vdev, 3, vqs, vq_callbacks, vq_names);
+ if (ret)
+ goto fail;
+
+ virtserial.ctrl_vq = vqs[0];
+ virtserial.in_vq = vqs[1];
+ virtserial.out_vq = vqs[2];
+
+ INIT_LIST_HEAD(&virtserial.port_head);
+
+ for (i = 0; i < virtserial.nr_ports; i++)
+ virtserial_add_port(i);
+
+ INIT_WORK(&virtserial.rx_work, &virtio_serial_rx_work_handler);
+ INIT_WORK(&virtserial.tx_work, &virtio_serial_tx_work_handler);
+ INIT_WORK(&virtserial.queue_work, &virtio_serial_queue_work_handler);
+
+ /* Allocate pages to fill the receive queue */
+ schedule_work(&virtserial.queue_work);
+
+ return 0;
+
+fail:
+ return ret;
+}
+
+
+static void virtserial_remove_port_data(struct virtio_serial_port *port)
+{
+ struct list_head *ptr, *ptr2;
+
+ /* Remove the buffers in which we have unconsumed data */
+ list_for_each_safe(ptr, ptr2, &port->readbuf_head) {
+ struct virtio_serial_port_buffer *buf;
+
+ buf = list_entry(ptr, struct virtio_serial_port_buffer, list);
+
+ list_del(&buf->list);
+ kfree(buf->buf);
+ kfree(buf);
+ }
+ kfree(port->name);
+}
+
+static void virtserial_remove(struct virtio_device *vdev)
+{
+ struct list_head *ptr, *ptr2;
+ char *buf;
+ int len;
+
+ unregister_chrdev(major, "virtio-serial");
+
+ cancel_work_sync(&virtserial.rx_work);
+
+ /* Free up the unused buffers in the receive queue */
+ while ((buf = virtserial.in_vq->vq_ops->get_buf(virtserial.in_vq,
&len)))
+ kfree(buf);
+
+ vdev->config->del_vqs(vdev);
+
+ list_for_each_safe(ptr, ptr2, &virtserial.port_head) {
+ struct virtio_serial_port *port;
+
+ port = list_entry(ptr, struct virtio_serial_port, next);
+
+ list_del(&port->next);
+ virtserial_remove_port_data(port);
+ kfree(port);
+ }
+}
+
+static void virtserial_apply_config(struct virtio_device *vdev)
+{
+ struct virtio_serial_config virtserconf;
+
+ vdev->config->get(vdev, offsetof(struct virtio_serial_config, nr_ports),
+ &virtserconf.nr_ports, sizeof(virtserconf.nr_ports));
+ /* FIXME: hot-add or remove ports */
+}
+
+
+static struct virtio_device_id id_table[] = {
+ { VIRTIO_ID_SERIAL, VIRTIO_DEV_ANY_ID },
+ { 0 },
+};
+
+static struct virtio_driver virtio_serial = {
+ // .feature_table = features,
+ // .feature_table_size = ARRAY_SIZE(features),
+ .driver.name = KBUILD_MODNAME,
+ .driver.owner = THIS_MODULE,
+ .id_table = id_table,
+ .probe = virtserial_probe,
+ .remove = virtserial_remove,
+ .config_changed = virtserial_apply_config,
+};
+
+static int __init init(void)
+{
+ return register_virtio_driver(&virtio_serial);
+}
+
+static void __exit fini(void)
+{
+ unregister_virtio_driver(&virtio_serial);
+}
+module_init(init);
+module_exit(fini);
+
+MODULE_DEVICE_TABLE(virtio, id_table);
+MODULE_DESCRIPTION("Virtio serial driver");
+MODULE_LICENSE("GPL");
diff --git a/include/linux/virtio_serial.h b/include/linux/virtio_serial.h
new file mode 100644
index 0000000..3435f8b
--- /dev/null
+++ b/include/linux/virtio_serial.h
@@ -0,0 +1,42 @@
+#ifndef _LINUX_VIRTIO_SERIAL_H
+#define _LINUX_VIRTIO_SERIAL_H
+#include <linux/types.h>
+#include <linux/virtio_config.h>
+
+/* Guest kernel - Host interface */
+
+/* The ID for virtio serial */
+#define VIRTIO_ID_SERIAL 7
+#define VIRTIO_SERIAL_BAD_ID (~(u32)0)
+
+struct virtio_serial_config {
+ __u32 nr_ports;
+ __u32 padding;
+};
+
+struct virtio_serial_control
+{
+ __u32 port_nr;
+ __u32 key;
+};
+
+/* Some defines for the control channel key */
+#define VIRTIO_SERIAL_GET_PORT_NAME 1
+
+#ifdef __KERNEL__
+
+/* Guest kernel - Guest userspace interface */
+
+/* IOCTL-related */
+#define VIRTIO_SERIAL_IO 0xAF
+
+#define VIRTIO_SERIAL_NAME_MAX_LEN 30
+struct virtio_serial_port_name {
+ char name[VIRTIO_SERIAL_NAME_MAX_LEN];
+};
+
+#define VIRTIO_SERIAL_IOCTL_GET_PORT_NAME _IOWR(VIRTIO_SERIAL_IO, 0x00, \
+ struct virtio_serial_port_name)
+
+#endif /* __KERNEL__ */
+#endif /* _LINUX_VIRTIO_SERIAL_H */
Re: [Qemu-devel] virtio-serial: A guest <-> host interface for simple communication, Jamie Lokier, 2009/06/24