Linux 2.6.34-rc3
[pohmelfs.git] / drivers / char / virtio_console.c
blob44288ce0cb45520b144d9eec98a942c7812025c7
1 /*
2 * Copyright (C) 2006, 2007, 2009 Rusty Russell, IBM Corporation
3 * Copyright (C) 2009, 2010 Red Hat, Inc.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, write to the Free Software
17 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 #include <linux/cdev.h>
20 #include <linux/debugfs.h>
21 #include <linux/device.h>
22 #include <linux/err.h>
23 #include <linux/fs.h>
24 #include <linux/init.h>
25 #include <linux/list.h>
26 #include <linux/poll.h>
27 #include <linux/sched.h>
28 #include <linux/spinlock.h>
29 #include <linux/virtio.h>
30 #include <linux/virtio_console.h>
31 #include <linux/wait.h>
32 #include <linux/workqueue.h>
33 #include "hvc_console.h"
36 * This is a global struct for storing common data for all the devices
37 * this driver handles.
39 * Mainly, it has a linked list for all the consoles in one place so
40 * that callbacks from hvc for get_chars(), put_chars() work properly
41 * across multiple devices and multiple ports per device.
43 struct ports_driver_data {
44 /* Used for registering chardevs */
45 struct class *class;
47 /* Used for exporting per-port information to debugfs */
48 struct dentry *debugfs_dir;
50 /* Number of devices this driver is handling */
51 unsigned int index;
54 * This is used to keep track of the number of hvc consoles
55 * spawned by this driver. This number is given as the first
56 * argument to hvc_alloc(). To correctly map an initial
57 * console spawned via hvc_instantiate to the console being
58 * hooked up via hvc_alloc, we need to pass the same vtermno.
60 * We also just assume the first console being initialised was
61 * the first one that got used as the initial console.
63 unsigned int next_vtermno;
65 /* All the console devices handled by this driver */
66 struct list_head consoles;
68 static struct ports_driver_data pdrvdata;
70 DEFINE_SPINLOCK(pdrvdata_lock);
72 /* This struct holds information that's relevant only for console ports */
73 struct console {
74 /* We'll place all consoles in a list in the pdrvdata struct */
75 struct list_head list;
77 /* The hvc device associated with this console port */
78 struct hvc_struct *hvc;
81 * This number identifies the number that we used to register
82 * with hvc in hvc_instantiate() and hvc_alloc(); this is the
83 * number passed on by the hvc callbacks to us to
84 * differentiate between the other console ports handled by
85 * this driver
87 u32 vtermno;
90 struct port_buffer {
91 char *buf;
93 /* size of the buffer in *buf above */
94 size_t size;
96 /* used length of the buffer */
97 size_t len;
98 /* offset in the buf from which to consume data */
99 size_t offset;
103 * This is a per-device struct that stores data common to all the
104 * ports for that device (vdev->priv).
106 struct ports_device {
108 * Workqueue handlers where we process deferred work after
109 * notification
111 struct work_struct control_work;
112 struct work_struct config_work;
114 struct list_head ports;
116 /* To protect the list of ports */
117 spinlock_t ports_lock;
119 /* To protect the vq operations for the control channel */
120 spinlock_t cvq_lock;
122 /* The current config space is stored here */
123 struct virtio_console_config config;
125 /* The virtio device we're associated with */
126 struct virtio_device *vdev;
129 * A couple of virtqueues for the control channel: one for
130 * guest->host transfers, one for host->guest transfers
132 struct virtqueue *c_ivq, *c_ovq;
134 /* Array of per-port IO virtqueues */
135 struct virtqueue **in_vqs, **out_vqs;
137 /* Used for numbering devices for sysfs and debugfs */
138 unsigned int drv_index;
140 /* Major number for this device. Ports will be created as minors. */
141 int chr_major;
144 /* This struct holds the per-port data */
145 struct port {
146 /* Next port in the list, head is in the ports_device */
147 struct list_head list;
149 /* Pointer to the parent virtio_console device */
150 struct ports_device *portdev;
152 /* The current buffer from which data has to be fed to readers */
153 struct port_buffer *inbuf;
156 * To protect the operations on the in_vq associated with this
157 * port. Has to be a spinlock because it can be called from
158 * interrupt context (get_char()).
160 spinlock_t inbuf_lock;
162 /* The IO vqs for this port */
163 struct virtqueue *in_vq, *out_vq;
165 /* File in the debugfs directory that exposes this port's information */
166 struct dentry *debugfs_file;
169 * The entries in this struct will be valid if this port is
170 * hooked up to an hvc console
172 struct console cons;
174 /* Each port associates with a separate char device */
175 struct cdev cdev;
176 struct device *dev;
178 /* A waitqueue for poll() or blocking read operations */
179 wait_queue_head_t waitqueue;
181 /* The 'name' of the port that we expose via sysfs properties */
182 char *name;
184 /* The 'id' to identify the port with the Host */
185 u32 id;
187 /* Is the host device open */
188 bool host_connected;
190 /* We should allow only one process to open a port */
191 bool guest_connected;
194 /* This is the very early arch-specified put chars function. */
195 static int (*early_put_chars)(u32, const char *, int);
197 static struct port *find_port_by_vtermno(u32 vtermno)
199 struct port *port;
200 struct console *cons;
201 unsigned long flags;
203 spin_lock_irqsave(&pdrvdata_lock, flags);
204 list_for_each_entry(cons, &pdrvdata.consoles, list) {
205 if (cons->vtermno == vtermno) {
206 port = container_of(cons, struct port, cons);
207 goto out;
210 port = NULL;
211 out:
212 spin_unlock_irqrestore(&pdrvdata_lock, flags);
213 return port;
216 static struct port *find_port_by_id(struct ports_device *portdev, u32 id)
218 struct port *port;
219 unsigned long flags;
221 spin_lock_irqsave(&portdev->ports_lock, flags);
222 list_for_each_entry(port, &portdev->ports, list)
223 if (port->id == id)
224 goto out;
225 port = NULL;
226 out:
227 spin_unlock_irqrestore(&portdev->ports_lock, flags);
229 return port;
232 static struct port *find_port_by_vq(struct ports_device *portdev,
233 struct virtqueue *vq)
235 struct port *port;
236 unsigned long flags;
238 spin_lock_irqsave(&portdev->ports_lock, flags);
239 list_for_each_entry(port, &portdev->ports, list)
240 if (port->in_vq == vq || port->out_vq == vq)
241 goto out;
242 port = NULL;
243 out:
244 spin_unlock_irqrestore(&portdev->ports_lock, flags);
245 return port;
248 static bool is_console_port(struct port *port)
250 if (port->cons.hvc)
251 return true;
252 return false;
255 static inline bool use_multiport(struct ports_device *portdev)
258 * This condition can be true when put_chars is called from
259 * early_init
261 if (!portdev->vdev)
262 return 0;
263 return portdev->vdev->features[0] & (1 << VIRTIO_CONSOLE_F_MULTIPORT);
266 static void free_buf(struct port_buffer *buf)
268 kfree(buf->buf);
269 kfree(buf);
272 static struct port_buffer *alloc_buf(size_t buf_size)
274 struct port_buffer *buf;
276 buf = kmalloc(sizeof(*buf), GFP_KERNEL);
277 if (!buf)
278 goto fail;
279 buf->buf = kzalloc(buf_size, GFP_KERNEL);
280 if (!buf->buf)
281 goto free_buf;
282 buf->len = 0;
283 buf->offset = 0;
284 buf->size = buf_size;
285 return buf;
287 free_buf:
288 kfree(buf);
289 fail:
290 return NULL;
293 /* Callers should take appropriate locks */
294 static void *get_inbuf(struct port *port)
296 struct port_buffer *buf;
297 struct virtqueue *vq;
298 unsigned int len;
300 vq = port->in_vq;
301 buf = vq->vq_ops->get_buf(vq, &len);
302 if (buf) {
303 buf->len = len;
304 buf->offset = 0;
306 return buf;
310 * Create a scatter-gather list representing our input buffer and put
311 * it in the queue.
313 * Callers should take appropriate locks.
315 static int add_inbuf(struct virtqueue *vq, struct port_buffer *buf)
317 struct scatterlist sg[1];
318 int ret;
320 sg_init_one(sg, buf->buf, buf->size);
322 ret = vq->vq_ops->add_buf(vq, sg, 0, 1, buf);
323 vq->vq_ops->kick(vq);
324 return ret;
327 /* Discard any unread data this port has. Callers lockers. */
328 static void discard_port_data(struct port *port)
330 struct port_buffer *buf;
331 struct virtqueue *vq;
332 unsigned int len;
333 int ret;
335 vq = port->in_vq;
336 if (port->inbuf)
337 buf = port->inbuf;
338 else
339 buf = vq->vq_ops->get_buf(vq, &len);
341 ret = 0;
342 while (buf) {
343 if (add_inbuf(vq, buf) < 0) {
344 ret++;
345 free_buf(buf);
347 buf = vq->vq_ops->get_buf(vq, &len);
349 port->inbuf = NULL;
350 if (ret)
351 dev_warn(port->dev, "Errors adding %d buffers back to vq\n",
352 ret);
355 static bool port_has_data(struct port *port)
357 unsigned long flags;
358 bool ret;
360 spin_lock_irqsave(&port->inbuf_lock, flags);
361 if (port->inbuf) {
362 ret = true;
363 goto out;
365 port->inbuf = get_inbuf(port);
366 if (port->inbuf) {
367 ret = true;
368 goto out;
370 ret = false;
371 out:
372 spin_unlock_irqrestore(&port->inbuf_lock, flags);
373 return ret;
376 static ssize_t send_control_msg(struct port *port, unsigned int event,
377 unsigned int value)
379 struct scatterlist sg[1];
380 struct virtio_console_control cpkt;
381 struct virtqueue *vq;
382 unsigned int len;
384 if (!use_multiport(port->portdev))
385 return 0;
387 cpkt.id = port->id;
388 cpkt.event = event;
389 cpkt.value = value;
391 vq = port->portdev->c_ovq;
393 sg_init_one(sg, &cpkt, sizeof(cpkt));
394 if (vq->vq_ops->add_buf(vq, sg, 1, 0, &cpkt) >= 0) {
395 vq->vq_ops->kick(vq);
396 while (!vq->vq_ops->get_buf(vq, &len))
397 cpu_relax();
399 return 0;
402 static ssize_t send_buf(struct port *port, void *in_buf, size_t in_count)
404 struct scatterlist sg[1];
405 struct virtqueue *out_vq;
406 ssize_t ret;
407 unsigned int len;
409 out_vq = port->out_vq;
411 sg_init_one(sg, in_buf, in_count);
412 ret = out_vq->vq_ops->add_buf(out_vq, sg, 1, 0, in_buf);
414 /* Tell Host to go! */
415 out_vq->vq_ops->kick(out_vq);
417 if (ret < 0) {
418 len = 0;
419 goto fail;
423 * Wait till the host acknowledges it pushed out the data we
424 * sent. Also ensure we return to userspace the number of
425 * bytes that were successfully consumed by the host.
427 while (!out_vq->vq_ops->get_buf(out_vq, &len))
428 cpu_relax();
429 fail:
430 /* We're expected to return the amount of data we wrote */
431 return len;
435 * Give out the data that's requested from the buffer that we have
436 * queued up.
438 static ssize_t fill_readbuf(struct port *port, char *out_buf, size_t out_count,
439 bool to_user)
441 struct port_buffer *buf;
442 unsigned long flags;
444 if (!out_count || !port_has_data(port))
445 return 0;
447 buf = port->inbuf;
448 out_count = min(out_count, buf->len - buf->offset);
450 if (to_user) {
451 ssize_t ret;
453 ret = copy_to_user(out_buf, buf->buf + buf->offset, out_count);
454 if (ret)
455 return -EFAULT;
456 } else {
457 memcpy(out_buf, buf->buf + buf->offset, out_count);
460 buf->offset += out_count;
462 if (buf->offset == buf->len) {
464 * We're done using all the data in this buffer.
465 * Re-queue so that the Host can send us more data.
467 spin_lock_irqsave(&port->inbuf_lock, flags);
468 port->inbuf = NULL;
470 if (add_inbuf(port->in_vq, buf) < 0)
471 dev_warn(port->dev, "failed add_buf\n");
473 spin_unlock_irqrestore(&port->inbuf_lock, flags);
475 /* Return the number of bytes actually copied */
476 return out_count;
479 /* The condition that must be true for polling to end */
480 static bool wait_is_over(struct port *port)
482 return port_has_data(port) || !port->host_connected;
485 static ssize_t port_fops_read(struct file *filp, char __user *ubuf,
486 size_t count, loff_t *offp)
488 struct port *port;
489 ssize_t ret;
491 port = filp->private_data;
493 if (!port_has_data(port)) {
495 * If nothing's connected on the host just return 0 in
496 * case of list_empty; this tells the userspace app
497 * that there's no connection
499 if (!port->host_connected)
500 return 0;
501 if (filp->f_flags & O_NONBLOCK)
502 return -EAGAIN;
504 ret = wait_event_interruptible(port->waitqueue,
505 wait_is_over(port));
506 if (ret < 0)
507 return ret;
510 * We could've received a disconnection message while we were
511 * waiting for more data.
513 * This check is not clubbed in the if() statement above as we
514 * might receive some data as well as the host could get
515 * disconnected after we got woken up from our wait. So we
516 * really want to give off whatever data we have and only then
517 * check for host_connected.
519 if (!port_has_data(port) && !port->host_connected)
520 return 0;
522 return fill_readbuf(port, ubuf, count, true);
525 static ssize_t port_fops_write(struct file *filp, const char __user *ubuf,
526 size_t count, loff_t *offp)
528 struct port *port;
529 char *buf;
530 ssize_t ret;
532 port = filp->private_data;
534 count = min((size_t)(32 * 1024), count);
536 buf = kmalloc(count, GFP_KERNEL);
537 if (!buf)
538 return -ENOMEM;
540 ret = copy_from_user(buf, ubuf, count);
541 if (ret) {
542 ret = -EFAULT;
543 goto free_buf;
546 ret = send_buf(port, buf, count);
547 free_buf:
548 kfree(buf);
549 return ret;
552 static unsigned int port_fops_poll(struct file *filp, poll_table *wait)
554 struct port *port;
555 unsigned int ret;
557 port = filp->private_data;
558 poll_wait(filp, &port->waitqueue, wait);
560 ret = 0;
561 if (port->inbuf)
562 ret |= POLLIN | POLLRDNORM;
563 if (port->host_connected)
564 ret |= POLLOUT;
565 if (!port->host_connected)
566 ret |= POLLHUP;
568 return ret;
571 static int port_fops_release(struct inode *inode, struct file *filp)
573 struct port *port;
575 port = filp->private_data;
577 /* Notify host of port being closed */
578 send_control_msg(port, VIRTIO_CONSOLE_PORT_OPEN, 0);
580 spin_lock_irq(&port->inbuf_lock);
581 port->guest_connected = false;
583 discard_port_data(port);
585 spin_unlock_irq(&port->inbuf_lock);
587 return 0;
590 static int port_fops_open(struct inode *inode, struct file *filp)
592 struct cdev *cdev = inode->i_cdev;
593 struct port *port;
595 port = container_of(cdev, struct port, cdev);
596 filp->private_data = port;
599 * Don't allow opening of console port devices -- that's done
600 * via /dev/hvc
602 if (is_console_port(port))
603 return -ENXIO;
605 /* Allow only one process to open a particular port at a time */
606 spin_lock_irq(&port->inbuf_lock);
607 if (port->guest_connected) {
608 spin_unlock_irq(&port->inbuf_lock);
609 return -EMFILE;
612 port->guest_connected = true;
613 spin_unlock_irq(&port->inbuf_lock);
615 /* Notify host of port being opened */
616 send_control_msg(filp->private_data, VIRTIO_CONSOLE_PORT_OPEN, 1);
618 return 0;
622 * The file operations that we support: programs in the guest can open
623 * a console device, read from it, write to it, poll for data and
624 * close it. The devices are at
625 * /dev/vport<device number>p<port number>
627 static const struct file_operations port_fops = {
628 .owner = THIS_MODULE,
629 .open = port_fops_open,
630 .read = port_fops_read,
631 .write = port_fops_write,
632 .poll = port_fops_poll,
633 .release = port_fops_release,
637 * The put_chars() callback is pretty straightforward.
639 * We turn the characters into a scatter-gather list, add it to the
640 * output queue and then kick the Host. Then we sit here waiting for
641 * it to finish: inefficient in theory, but in practice
642 * implementations will do it immediately (lguest's Launcher does).
644 static int put_chars(u32 vtermno, const char *buf, int count)
646 struct port *port;
648 port = find_port_by_vtermno(vtermno);
649 if (!port)
650 return 0;
652 if (unlikely(early_put_chars))
653 return early_put_chars(vtermno, buf, count);
655 return send_buf(port, (void *)buf, count);
659 * get_chars() is the callback from the hvc_console infrastructure
660 * when an interrupt is received.
662 * We call out to fill_readbuf that gets us the required data from the
663 * buffers that are queued up.
665 static int get_chars(u32 vtermno, char *buf, int count)
667 struct port *port;
669 port = find_port_by_vtermno(vtermno);
670 if (!port)
671 return 0;
673 /* If we don't have an input queue yet, we can't get input. */
674 BUG_ON(!port->in_vq);
676 return fill_readbuf(port, buf, count, false);
679 static void resize_console(struct port *port)
681 struct virtio_device *vdev;
682 struct winsize ws;
684 /* The port could have been hot-unplugged */
685 if (!port)
686 return;
688 vdev = port->portdev->vdev;
689 if (virtio_has_feature(vdev, VIRTIO_CONSOLE_F_SIZE)) {
690 vdev->config->get(vdev,
691 offsetof(struct virtio_console_config, cols),
692 &ws.ws_col, sizeof(u16));
693 vdev->config->get(vdev,
694 offsetof(struct virtio_console_config, rows),
695 &ws.ws_row, sizeof(u16));
696 hvc_resize(port->cons.hvc, ws);
700 /* We set the configuration at this point, since we now have a tty */
701 static int notifier_add_vio(struct hvc_struct *hp, int data)
703 struct port *port;
705 port = find_port_by_vtermno(hp->vtermno);
706 if (!port)
707 return -EINVAL;
709 hp->irq_requested = 1;
710 resize_console(port);
712 return 0;
715 static void notifier_del_vio(struct hvc_struct *hp, int data)
717 hp->irq_requested = 0;
720 /* The operations for console ports. */
721 static const struct hv_ops hv_ops = {
722 .get_chars = get_chars,
723 .put_chars = put_chars,
724 .notifier_add = notifier_add_vio,
725 .notifier_del = notifier_del_vio,
726 .notifier_hangup = notifier_del_vio,
730 * Console drivers are initialized very early so boot messages can go
731 * out, so we do things slightly differently from the generic virtio
732 * initialization of the net and block drivers.
734 * At this stage, the console is output-only. It's too early to set
735 * up a virtqueue, so we let the drivers do some boutique early-output
736 * thing.
738 int __init virtio_cons_early_init(int (*put_chars)(u32, const char *, int))
740 early_put_chars = put_chars;
741 return hvc_instantiate(0, 0, &hv_ops);
744 int init_port_console(struct port *port)
746 int ret;
749 * The Host's telling us this port is a console port. Hook it
750 * up with an hvc console.
752 * To set up and manage our virtual console, we call
753 * hvc_alloc().
755 * The first argument of hvc_alloc() is the virtual console
756 * number. The second argument is the parameter for the
757 * notification mechanism (like irq number). We currently
758 * leave this as zero, virtqueues have implicit notifications.
760 * The third argument is a "struct hv_ops" containing the
761 * put_chars() get_chars(), notifier_add() and notifier_del()
762 * pointers. The final argument is the output buffer size: we
763 * can do any size, so we put PAGE_SIZE here.
765 port->cons.vtermno = pdrvdata.next_vtermno;
767 port->cons.hvc = hvc_alloc(port->cons.vtermno, 0, &hv_ops, PAGE_SIZE);
768 if (IS_ERR(port->cons.hvc)) {
769 ret = PTR_ERR(port->cons.hvc);
770 dev_err(port->dev,
771 "error %d allocating hvc for port\n", ret);
772 port->cons.hvc = NULL;
773 return ret;
775 spin_lock_irq(&pdrvdata_lock);
776 pdrvdata.next_vtermno++;
777 list_add_tail(&port->cons.list, &pdrvdata.consoles);
778 spin_unlock_irq(&pdrvdata_lock);
779 port->guest_connected = true;
781 /* Notify host of port being opened */
782 send_control_msg(port, VIRTIO_CONSOLE_PORT_OPEN, 1);
784 return 0;
787 static ssize_t show_port_name(struct device *dev,
788 struct device_attribute *attr, char *buffer)
790 struct port *port;
792 port = dev_get_drvdata(dev);
794 return sprintf(buffer, "%s\n", port->name);
797 static DEVICE_ATTR(name, S_IRUGO, show_port_name, NULL);
799 static struct attribute *port_sysfs_entries[] = {
800 &dev_attr_name.attr,
801 NULL
804 static struct attribute_group port_attribute_group = {
805 .name = NULL, /* put in device directory */
806 .attrs = port_sysfs_entries,
809 static int debugfs_open(struct inode *inode, struct file *filp)
811 filp->private_data = inode->i_private;
812 return 0;
815 static ssize_t debugfs_read(struct file *filp, char __user *ubuf,
816 size_t count, loff_t *offp)
818 struct port *port;
819 char *buf;
820 ssize_t ret, out_offset, out_count;
822 out_count = 1024;
823 buf = kmalloc(out_count, GFP_KERNEL);
824 if (!buf)
825 return -ENOMEM;
827 port = filp->private_data;
828 out_offset = 0;
829 out_offset += snprintf(buf + out_offset, out_count,
830 "name: %s\n", port->name ? port->name : "");
831 out_offset += snprintf(buf + out_offset, out_count - out_offset,
832 "guest_connected: %d\n", port->guest_connected);
833 out_offset += snprintf(buf + out_offset, out_count - out_offset,
834 "host_connected: %d\n", port->host_connected);
835 out_offset += snprintf(buf + out_offset, out_count - out_offset,
836 "is_console: %s\n",
837 is_console_port(port) ? "yes" : "no");
838 out_offset += snprintf(buf + out_offset, out_count - out_offset,
839 "console_vtermno: %u\n", port->cons.vtermno);
841 ret = simple_read_from_buffer(ubuf, count, offp, buf, out_offset);
842 kfree(buf);
843 return ret;
846 static const struct file_operations port_debugfs_ops = {
847 .owner = THIS_MODULE,
848 .open = debugfs_open,
849 .read = debugfs_read,
852 /* Remove all port-specific data. */
853 static int remove_port(struct port *port)
855 struct port_buffer *buf;
857 spin_lock_irq(&port->portdev->ports_lock);
858 list_del(&port->list);
859 spin_unlock_irq(&port->portdev->ports_lock);
861 if (is_console_port(port)) {
862 spin_lock_irq(&pdrvdata_lock);
863 list_del(&port->cons.list);
864 spin_unlock_irq(&pdrvdata_lock);
865 hvc_remove(port->cons.hvc);
867 if (port->guest_connected)
868 send_control_msg(port, VIRTIO_CONSOLE_PORT_OPEN, 0);
870 sysfs_remove_group(&port->dev->kobj, &port_attribute_group);
871 device_destroy(pdrvdata.class, port->dev->devt);
872 cdev_del(&port->cdev);
874 /* Remove unused data this port might have received. */
875 discard_port_data(port);
877 /* Remove buffers we queued up for the Host to send us data in. */
878 while ((buf = port->in_vq->vq_ops->detach_unused_buf(port->in_vq)))
879 free_buf(buf);
881 kfree(port->name);
883 debugfs_remove(port->debugfs_file);
885 kfree(port);
886 return 0;
889 /* Any private messages that the Host and Guest want to share */
890 static void handle_control_message(struct ports_device *portdev,
891 struct port_buffer *buf)
893 struct virtio_console_control *cpkt;
894 struct port *port;
895 size_t name_size;
896 int err;
898 cpkt = (struct virtio_console_control *)(buf->buf + buf->offset);
900 port = find_port_by_id(portdev, cpkt->id);
901 if (!port) {
902 /* No valid header at start of buffer. Drop it. */
903 dev_dbg(&portdev->vdev->dev,
904 "Invalid index %u in control packet\n", cpkt->id);
905 return;
908 switch (cpkt->event) {
909 case VIRTIO_CONSOLE_CONSOLE_PORT:
910 if (!cpkt->value)
911 break;
912 if (is_console_port(port))
913 break;
915 init_port_console(port);
917 * Could remove the port here in case init fails - but
918 * have to notify the host first.
920 break;
921 case VIRTIO_CONSOLE_RESIZE:
922 if (!is_console_port(port))
923 break;
924 port->cons.hvc->irq_requested = 1;
925 resize_console(port);
926 break;
927 case VIRTIO_CONSOLE_PORT_OPEN:
928 port->host_connected = cpkt->value;
929 wake_up_interruptible(&port->waitqueue);
930 break;
931 case VIRTIO_CONSOLE_PORT_NAME:
933 * Skip the size of the header and the cpkt to get the size
934 * of the name that was sent
936 name_size = buf->len - buf->offset - sizeof(*cpkt) + 1;
938 port->name = kmalloc(name_size, GFP_KERNEL);
939 if (!port->name) {
940 dev_err(port->dev,
941 "Not enough space to store port name\n");
942 break;
944 strncpy(port->name, buf->buf + buf->offset + sizeof(*cpkt),
945 name_size - 1);
946 port->name[name_size - 1] = 0;
949 * Since we only have one sysfs attribute, 'name',
950 * create it only if we have a name for the port.
952 err = sysfs_create_group(&port->dev->kobj,
953 &port_attribute_group);
954 if (err) {
955 dev_err(port->dev,
956 "Error %d creating sysfs device attributes\n",
957 err);
958 } else {
960 * Generate a udev event so that appropriate
961 * symlinks can be created based on udev
962 * rules.
964 kobject_uevent(&port->dev->kobj, KOBJ_CHANGE);
966 break;
967 case VIRTIO_CONSOLE_PORT_REMOVE:
969 * Hot unplug the port. We don't decrement nr_ports
970 * since we don't want to deal with extra complexities
971 * of using the lowest-available port id: We can just
972 * pick up the nr_ports number as the id and not have
973 * userspace send it to us. This helps us in two
974 * ways:
976 * - We don't need to have a 'port_id' field in the
977 * config space when a port is hot-added. This is a
978 * good thing as we might queue up multiple hotplug
979 * requests issued in our workqueue.
981 * - Another way to deal with this would have been to
982 * use a bitmap of the active ports and select the
983 * lowest non-active port from that map. That
984 * bloats the already tight config space and we
985 * would end up artificially limiting the
986 * max. number of ports to sizeof(bitmap). Right
987 * now we can support 2^32 ports (as the port id is
988 * stored in a u32 type).
991 remove_port(port);
992 break;
996 static void control_work_handler(struct work_struct *work)
998 struct ports_device *portdev;
999 struct virtqueue *vq;
1000 struct port_buffer *buf;
1001 unsigned int len;
1003 portdev = container_of(work, struct ports_device, control_work);
1004 vq = portdev->c_ivq;
1006 spin_lock(&portdev->cvq_lock);
1007 while ((buf = vq->vq_ops->get_buf(vq, &len))) {
1008 spin_unlock(&portdev->cvq_lock);
1010 buf->len = len;
1011 buf->offset = 0;
1013 handle_control_message(portdev, buf);
1015 spin_lock(&portdev->cvq_lock);
1016 if (add_inbuf(portdev->c_ivq, buf) < 0) {
1017 dev_warn(&portdev->vdev->dev,
1018 "Error adding buffer to queue\n");
1019 free_buf(buf);
1022 spin_unlock(&portdev->cvq_lock);
1025 static void in_intr(struct virtqueue *vq)
1027 struct port *port;
1028 unsigned long flags;
1030 port = find_port_by_vq(vq->vdev->priv, vq);
1031 if (!port)
1032 return;
1034 spin_lock_irqsave(&port->inbuf_lock, flags);
1035 if (!port->inbuf)
1036 port->inbuf = get_inbuf(port);
1039 * Don't queue up data when port is closed. This condition
1040 * can be reached when a console port is not yet connected (no
1041 * tty is spawned) and the host sends out data to console
1042 * ports. For generic serial ports, the host won't
1043 * (shouldn't) send data till the guest is connected.
1045 if (!port->guest_connected)
1046 discard_port_data(port);
1048 spin_unlock_irqrestore(&port->inbuf_lock, flags);
1050 wake_up_interruptible(&port->waitqueue);
1052 if (is_console_port(port) && hvc_poll(port->cons.hvc))
1053 hvc_kick();
1056 static void control_intr(struct virtqueue *vq)
1058 struct ports_device *portdev;
1060 portdev = vq->vdev->priv;
1061 schedule_work(&portdev->control_work);
1064 static void config_intr(struct virtio_device *vdev)
1066 struct ports_device *portdev;
1068 portdev = vdev->priv;
1069 if (use_multiport(portdev)) {
1070 /* Handle port hot-add */
1071 schedule_work(&portdev->config_work);
1074 * We'll use this way of resizing only for legacy support.
1075 * For newer userspace (VIRTIO_CONSOLE_F_MULTPORT+), use
1076 * control messages to indicate console size changes so that
1077 * it can be done per-port
1079 resize_console(find_port_by_id(portdev, 0));
1082 static unsigned int fill_queue(struct virtqueue *vq, spinlock_t *lock)
1084 struct port_buffer *buf;
1085 unsigned int nr_added_bufs;
1086 int ret;
1088 nr_added_bufs = 0;
1089 do {
1090 buf = alloc_buf(PAGE_SIZE);
1091 if (!buf)
1092 break;
1094 spin_lock_irq(lock);
1095 ret = add_inbuf(vq, buf);
1096 if (ret < 0) {
1097 spin_unlock_irq(lock);
1098 free_buf(buf);
1099 break;
1101 nr_added_bufs++;
1102 spin_unlock_irq(lock);
1103 } while (ret > 0);
1105 return nr_added_bufs;
1108 static int add_port(struct ports_device *portdev, u32 id)
1110 char debugfs_name[16];
1111 struct port *port;
1112 struct port_buffer *buf;
1113 dev_t devt;
1114 unsigned int nr_added_bufs;
1115 int err;
1117 port = kmalloc(sizeof(*port), GFP_KERNEL);
1118 if (!port) {
1119 err = -ENOMEM;
1120 goto fail;
1123 port->portdev = portdev;
1124 port->id = id;
1126 port->name = NULL;
1127 port->inbuf = NULL;
1128 port->cons.hvc = NULL;
1130 port->host_connected = port->guest_connected = false;
1132 port->in_vq = portdev->in_vqs[port->id];
1133 port->out_vq = portdev->out_vqs[port->id];
1135 cdev_init(&port->cdev, &port_fops);
1137 devt = MKDEV(portdev->chr_major, id);
1138 err = cdev_add(&port->cdev, devt, 1);
1139 if (err < 0) {
1140 dev_err(&port->portdev->vdev->dev,
1141 "Error %d adding cdev for port %u\n", err, id);
1142 goto free_port;
1144 port->dev = device_create(pdrvdata.class, &port->portdev->vdev->dev,
1145 devt, port, "vport%up%u",
1146 port->portdev->drv_index, id);
1147 if (IS_ERR(port->dev)) {
1148 err = PTR_ERR(port->dev);
1149 dev_err(&port->portdev->vdev->dev,
1150 "Error %d creating device for port %u\n",
1151 err, id);
1152 goto free_cdev;
1155 spin_lock_init(&port->inbuf_lock);
1156 init_waitqueue_head(&port->waitqueue);
1158 /* Fill the in_vq with buffers so the host can send us data. */
1159 nr_added_bufs = fill_queue(port->in_vq, &port->inbuf_lock);
1160 if (!nr_added_bufs) {
1161 dev_err(port->dev, "Error allocating inbufs\n");
1162 err = -ENOMEM;
1163 goto free_device;
1167 * If we're not using multiport support, this has to be a console port
1169 if (!use_multiport(port->portdev)) {
1170 err = init_port_console(port);
1171 if (err)
1172 goto free_inbufs;
1175 spin_lock_irq(&portdev->ports_lock);
1176 list_add_tail(&port->list, &port->portdev->ports);
1177 spin_unlock_irq(&portdev->ports_lock);
1180 * Tell the Host we're set so that it can send us various
1181 * configuration parameters for this port (eg, port name,
1182 * caching, whether this is a console port, etc.)
1184 send_control_msg(port, VIRTIO_CONSOLE_PORT_READY, 1);
1186 if (pdrvdata.debugfs_dir) {
1188 * Finally, create the debugfs file that we can use to
1189 * inspect a port's state at any time
1191 sprintf(debugfs_name, "vport%up%u",
1192 port->portdev->drv_index, id);
1193 port->debugfs_file = debugfs_create_file(debugfs_name, 0444,
1194 pdrvdata.debugfs_dir,
1195 port,
1196 &port_debugfs_ops);
1198 return 0;
1200 free_inbufs:
1201 while ((buf = port->in_vq->vq_ops->detach_unused_buf(port->in_vq)))
1202 free_buf(buf);
1203 free_device:
1204 device_destroy(pdrvdata.class, port->dev->devt);
1205 free_cdev:
1206 cdev_del(&port->cdev);
1207 free_port:
1208 kfree(port);
1209 fail:
1210 return err;
1214 * The workhandler for config-space updates.
1216 * This is called when ports are hot-added.
1218 static void config_work_handler(struct work_struct *work)
1220 struct virtio_console_config virtconconf;
1221 struct ports_device *portdev;
1222 struct virtio_device *vdev;
1223 int err;
1225 portdev = container_of(work, struct ports_device, config_work);
1227 vdev = portdev->vdev;
1228 vdev->config->get(vdev,
1229 offsetof(struct virtio_console_config, nr_ports),
1230 &virtconconf.nr_ports,
1231 sizeof(virtconconf.nr_ports));
1233 if (portdev->config.nr_ports == virtconconf.nr_ports) {
1235 * Port 0 got hot-added. Since we already did all the
1236 * other initialisation for it, just tell the Host
1237 * that the port is ready if we find the port. In
1238 * case the port was hot-removed earlier, we call
1239 * add_port to add the port.
1241 struct port *port;
1243 port = find_port_by_id(portdev, 0);
1244 if (!port)
1245 add_port(portdev, 0);
1246 else
1247 send_control_msg(port, VIRTIO_CONSOLE_PORT_READY, 1);
1248 return;
1250 if (virtconconf.nr_ports > portdev->config.max_nr_ports) {
1251 dev_warn(&vdev->dev,
1252 "More ports specified (%u) than allowed (%u)",
1253 portdev->config.nr_ports + 1,
1254 portdev->config.max_nr_ports);
1255 return;
1257 if (virtconconf.nr_ports < portdev->config.nr_ports)
1258 return;
1260 /* Hot-add ports */
1261 while (virtconconf.nr_ports - portdev->config.nr_ports) {
1262 err = add_port(portdev, portdev->config.nr_ports);
1263 if (err)
1264 break;
1265 portdev->config.nr_ports++;
1269 static int init_vqs(struct ports_device *portdev)
1271 vq_callback_t **io_callbacks;
1272 char **io_names;
1273 struct virtqueue **vqs;
1274 u32 i, j, nr_ports, nr_queues;
1275 int err;
1277 nr_ports = portdev->config.max_nr_ports;
1278 nr_queues = use_multiport(portdev) ? (nr_ports + 1) * 2 : 2;
1280 vqs = kmalloc(nr_queues * sizeof(struct virtqueue *), GFP_KERNEL);
1281 if (!vqs) {
1282 err = -ENOMEM;
1283 goto fail;
1285 io_callbacks = kmalloc(nr_queues * sizeof(vq_callback_t *), GFP_KERNEL);
1286 if (!io_callbacks) {
1287 err = -ENOMEM;
1288 goto free_vqs;
1290 io_names = kmalloc(nr_queues * sizeof(char *), GFP_KERNEL);
1291 if (!io_names) {
1292 err = -ENOMEM;
1293 goto free_callbacks;
1295 portdev->in_vqs = kmalloc(nr_ports * sizeof(struct virtqueue *),
1296 GFP_KERNEL);
1297 if (!portdev->in_vqs) {
1298 err = -ENOMEM;
1299 goto free_names;
1301 portdev->out_vqs = kmalloc(nr_ports * sizeof(struct virtqueue *),
1302 GFP_KERNEL);
1303 if (!portdev->out_vqs) {
1304 err = -ENOMEM;
1305 goto free_invqs;
1309 * For backward compat (newer host but older guest), the host
1310 * spawns a console port first and also inits the vqs for port
1311 * 0 before others.
1313 j = 0;
1314 io_callbacks[j] = in_intr;
1315 io_callbacks[j + 1] = NULL;
1316 io_names[j] = "input";
1317 io_names[j + 1] = "output";
1318 j += 2;
1320 if (use_multiport(portdev)) {
1321 io_callbacks[j] = control_intr;
1322 io_callbacks[j + 1] = NULL;
1323 io_names[j] = "control-i";
1324 io_names[j + 1] = "control-o";
1326 for (i = 1; i < nr_ports; i++) {
1327 j += 2;
1328 io_callbacks[j] = in_intr;
1329 io_callbacks[j + 1] = NULL;
1330 io_names[j] = "input";
1331 io_names[j + 1] = "output";
1334 /* Find the queues. */
1335 err = portdev->vdev->config->find_vqs(portdev->vdev, nr_queues, vqs,
1336 io_callbacks,
1337 (const char **)io_names);
1338 if (err)
1339 goto free_outvqs;
1341 j = 0;
1342 portdev->in_vqs[0] = vqs[0];
1343 portdev->out_vqs[0] = vqs[1];
1344 j += 2;
1345 if (use_multiport(portdev)) {
1346 portdev->c_ivq = vqs[j];
1347 portdev->c_ovq = vqs[j + 1];
1349 for (i = 1; i < nr_ports; i++) {
1350 j += 2;
1351 portdev->in_vqs[i] = vqs[j];
1352 portdev->out_vqs[i] = vqs[j + 1];
1355 kfree(io_callbacks);
1356 kfree(io_names);
1357 kfree(vqs);
1359 return 0;
1361 free_names:
1362 kfree(io_names);
1363 free_callbacks:
1364 kfree(io_callbacks);
1365 free_outvqs:
1366 kfree(portdev->out_vqs);
1367 free_invqs:
1368 kfree(portdev->in_vqs);
1369 free_vqs:
1370 kfree(vqs);
1371 fail:
1372 return err;
1375 static const struct file_operations portdev_fops = {
1376 .owner = THIS_MODULE,
1380 * Once we're further in boot, we get probed like any other virtio
1381 * device.
1383 * If the host also supports multiple console ports, we check the
1384 * config space to see how many ports the host has spawned. We
1385 * initialize each port found.
1387 static int __devinit virtcons_probe(struct virtio_device *vdev)
1389 struct ports_device *portdev;
1390 u32 i;
1391 int err;
1392 bool multiport;
1394 portdev = kmalloc(sizeof(*portdev), GFP_KERNEL);
1395 if (!portdev) {
1396 err = -ENOMEM;
1397 goto fail;
1400 /* Attach this portdev to this virtio_device, and vice-versa. */
1401 portdev->vdev = vdev;
1402 vdev->priv = portdev;
1404 spin_lock_irq(&pdrvdata_lock);
1405 portdev->drv_index = pdrvdata.index++;
1406 spin_unlock_irq(&pdrvdata_lock);
1408 portdev->chr_major = register_chrdev(0, "virtio-portsdev",
1409 &portdev_fops);
1410 if (portdev->chr_major < 0) {
1411 dev_err(&vdev->dev,
1412 "Error %d registering chrdev for device %u\n",
1413 portdev->chr_major, portdev->drv_index);
1414 err = portdev->chr_major;
1415 goto free;
1418 multiport = false;
1419 portdev->config.nr_ports = 1;
1420 portdev->config.max_nr_ports = 1;
1421 if (virtio_has_feature(vdev, VIRTIO_CONSOLE_F_MULTIPORT)) {
1422 multiport = true;
1423 vdev->features[0] |= 1 << VIRTIO_CONSOLE_F_MULTIPORT;
1425 vdev->config->get(vdev, offsetof(struct virtio_console_config,
1426 nr_ports),
1427 &portdev->config.nr_ports,
1428 sizeof(portdev->config.nr_ports));
1429 vdev->config->get(vdev, offsetof(struct virtio_console_config,
1430 max_nr_ports),
1431 &portdev->config.max_nr_ports,
1432 sizeof(portdev->config.max_nr_ports));
1433 if (portdev->config.nr_ports > portdev->config.max_nr_ports) {
1434 dev_warn(&vdev->dev,
1435 "More ports (%u) specified than allowed (%u). Will init %u ports.",
1436 portdev->config.nr_ports,
1437 portdev->config.max_nr_ports,
1438 portdev->config.max_nr_ports);
1440 portdev->config.nr_ports = portdev->config.max_nr_ports;
1444 /* Let the Host know we support multiple ports.*/
1445 vdev->config->finalize_features(vdev);
1447 err = init_vqs(portdev);
1448 if (err < 0) {
1449 dev_err(&vdev->dev, "Error %d initializing vqs\n", err);
1450 goto free_chrdev;
1453 spin_lock_init(&portdev->ports_lock);
1454 INIT_LIST_HEAD(&portdev->ports);
1456 if (multiport) {
1457 unsigned int nr_added_bufs;
1459 spin_lock_init(&portdev->cvq_lock);
1460 INIT_WORK(&portdev->control_work, &control_work_handler);
1461 INIT_WORK(&portdev->config_work, &config_work_handler);
1463 nr_added_bufs = fill_queue(portdev->c_ivq, &portdev->cvq_lock);
1464 if (!nr_added_bufs) {
1465 dev_err(&vdev->dev,
1466 "Error allocating buffers for control queue\n");
1467 err = -ENOMEM;
1468 goto free_vqs;
1472 for (i = 0; i < portdev->config.nr_ports; i++)
1473 add_port(portdev, i);
1475 /* Start using the new console output. */
1476 early_put_chars = NULL;
1477 return 0;
1479 free_vqs:
1480 vdev->config->del_vqs(vdev);
1481 kfree(portdev->in_vqs);
1482 kfree(portdev->out_vqs);
1483 free_chrdev:
1484 unregister_chrdev(portdev->chr_major, "virtio-portsdev");
1485 free:
1486 kfree(portdev);
1487 fail:
1488 return err;
1491 static void virtcons_remove(struct virtio_device *vdev)
1493 struct ports_device *portdev;
1494 struct port *port, *port2;
1495 struct port_buffer *buf;
1496 unsigned int len;
1498 portdev = vdev->priv;
1500 cancel_work_sync(&portdev->control_work);
1501 cancel_work_sync(&portdev->config_work);
1503 list_for_each_entry_safe(port, port2, &portdev->ports, list)
1504 remove_port(port);
1506 unregister_chrdev(portdev->chr_major, "virtio-portsdev");
1508 while ((buf = portdev->c_ivq->vq_ops->get_buf(portdev->c_ivq, &len)))
1509 free_buf(buf);
1511 while ((buf = portdev->c_ivq->vq_ops->detach_unused_buf(portdev->c_ivq)))
1512 free_buf(buf);
1514 vdev->config->del_vqs(vdev);
1515 kfree(portdev->in_vqs);
1516 kfree(portdev->out_vqs);
1518 kfree(portdev);
1521 static struct virtio_device_id id_table[] = {
1522 { VIRTIO_ID_CONSOLE, VIRTIO_DEV_ANY_ID },
1523 { 0 },
1526 static unsigned int features[] = {
1527 VIRTIO_CONSOLE_F_SIZE,
1528 VIRTIO_CONSOLE_F_MULTIPORT,
1531 static struct virtio_driver virtio_console = {
1532 .feature_table = features,
1533 .feature_table_size = ARRAY_SIZE(features),
1534 .driver.name = KBUILD_MODNAME,
1535 .driver.owner = THIS_MODULE,
1536 .id_table = id_table,
1537 .probe = virtcons_probe,
1538 .remove = virtcons_remove,
1539 .config_changed = config_intr,
1542 static int __init init(void)
1544 int err;
1546 pdrvdata.class = class_create(THIS_MODULE, "virtio-ports");
1547 if (IS_ERR(pdrvdata.class)) {
1548 err = PTR_ERR(pdrvdata.class);
1549 pr_err("Error %d creating virtio-ports class\n", err);
1550 return err;
1553 pdrvdata.debugfs_dir = debugfs_create_dir("virtio-ports", NULL);
1554 if (!pdrvdata.debugfs_dir) {
1555 pr_warning("Error %ld creating debugfs dir for virtio-ports\n",
1556 PTR_ERR(pdrvdata.debugfs_dir));
1558 INIT_LIST_HEAD(&pdrvdata.consoles);
1560 return register_virtio_driver(&virtio_console);
1563 static void __exit fini(void)
1565 unregister_virtio_driver(&virtio_console);
1567 class_destroy(pdrvdata.class);
1568 if (pdrvdata.debugfs_dir)
1569 debugfs_remove_recursive(pdrvdata.debugfs_dir);
1571 module_init(init);
1572 module_exit(fini);
1574 MODULE_DEVICE_TABLE(virtio, id_table);
1575 MODULE_DESCRIPTION("Virtio console driver");
1576 MODULE_LICENSE("GPL");