2 * Copyright (C) 2006, 2007, 2009 Rusty Russell, IBM Corporation
3 * Copyright (C) 2009, 2010, 2011 Red Hat, Inc.
4 * Copyright (C) 2009, 2010, 2011 Amit Shah <amit.shah@redhat.com>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 #include <linux/cdev.h>
21 #include <linux/debugfs.h>
22 #include <linux/completion.h>
23 #include <linux/device.h>
24 #include <linux/err.h>
25 #include <linux/freezer.h>
27 #include <linux/splice.h>
28 #include <linux/pagemap.h>
29 #include <linux/init.h>
30 #include <linux/list.h>
31 #include <linux/poll.h>
32 #include <linux/sched.h>
33 #include <linux/slab.h>
34 #include <linux/spinlock.h>
35 #include <linux/virtio.h>
36 #include <linux/virtio_console.h>
37 #include <linux/wait.h>
38 #include <linux/workqueue.h>
39 #include <linux/module.h>
40 #include <linux/dma-mapping.h>
41 #include <linux/kconfig.h>
42 #include "../tty/hvc/hvc_console.h"
44 #define is_rproc_enabled IS_ENABLED(CONFIG_REMOTEPROC)
47 * This is a global struct for storing common data for all the devices
48 * this driver handles.
50 * Mainly, it has a linked list for all the consoles in one place so
51 * that callbacks from hvc for get_chars(), put_chars() work properly
52 * across multiple devices and multiple ports per device.
54 struct ports_driver_data
{
55 /* Used for registering chardevs */
58 /* Used for exporting per-port information to debugfs */
59 struct dentry
*debugfs_dir
;
61 /* List of all the devices we're handling */
62 struct list_head portdevs
;
65 * This is used to keep track of the number of hvc consoles
66 * spawned by this driver. This number is given as the first
67 * argument to hvc_alloc(). To correctly map an initial
68 * console spawned via hvc_instantiate to the console being
69 * hooked up via hvc_alloc, we need to pass the same vtermno.
71 * We also just assume the first console being initialised was
72 * the first one that got used as the initial console.
74 unsigned int next_vtermno
;
76 /* All the console devices handled by this driver */
77 struct list_head consoles
;
79 static struct ports_driver_data pdrvdata
;
81 static DEFINE_SPINLOCK(pdrvdata_lock
);
82 static DECLARE_COMPLETION(early_console_added
);
84 /* This struct holds information that's relevant only for console ports */
86 /* We'll place all consoles in a list in the pdrvdata struct */
87 struct list_head list
;
89 /* The hvc device associated with this console port */
90 struct hvc_struct
*hvc
;
92 /* The size of the console */
96 * This number identifies the number that we used to register
97 * with hvc in hvc_instantiate() and hvc_alloc(); this is the
98 * number passed on by the hvc callbacks to us to
99 * differentiate between the other console ports handled by
108 /* size of the buffer in *buf above */
111 /* used length of the buffer */
113 /* offset in the buf from which to consume data */
116 /* DMA address of buffer */
119 /* Device we got DMA memory from */
122 /* List of pending dma buffers to free */
123 struct list_head list
;
125 /* If sgpages == 0 then buf is used */
126 unsigned int sgpages
;
128 /* sg is used if spages > 0. sg must be the last in is struct */
129 struct scatterlist sg
[0];
133 * This is a per-device struct that stores data common to all the
134 * ports for that device (vdev->priv).
136 struct ports_device
{
137 /* Next portdev in the list, head is in the pdrvdata struct */
138 struct list_head list
;
141 * Workqueue handlers where we process deferred work after
144 struct work_struct control_work
;
145 struct work_struct config_work
;
147 struct list_head ports
;
149 /* To protect the list of ports */
150 spinlock_t ports_lock
;
152 /* To protect the vq operations for the control channel */
153 spinlock_t c_ivq_lock
;
154 spinlock_t c_ovq_lock
;
156 /* The current config space is stored here */
157 struct virtio_console_config config
;
159 /* The virtio device we're associated with */
160 struct virtio_device
*vdev
;
163 * A couple of virtqueues for the control channel: one for
164 * guest->host transfers, one for host->guest transfers
166 struct virtqueue
*c_ivq
, *c_ovq
;
169 * A control packet buffer for guest->host requests, protected
172 struct virtio_console_control cpkt
;
174 /* Array of per-port IO virtqueues */
175 struct virtqueue
**in_vqs
, **out_vqs
;
177 /* Major number for this device. Ports will be created as minors. */
182 unsigned long bytes_sent
, bytes_received
, bytes_discarded
;
185 /* This struct holds the per-port data */
187 /* Next port in the list, head is in the ports_device */
188 struct list_head list
;
190 /* Pointer to the parent virtio_console device */
191 struct ports_device
*portdev
;
193 /* The current buffer from which data has to be fed to readers */
194 struct port_buffer
*inbuf
;
197 * To protect the operations on the in_vq associated with this
198 * port. Has to be a spinlock because it can be called from
199 * interrupt context (get_char()).
201 spinlock_t inbuf_lock
;
203 /* Protect the operations on the out_vq. */
204 spinlock_t outvq_lock
;
206 /* The IO vqs for this port */
207 struct virtqueue
*in_vq
, *out_vq
;
209 /* File in the debugfs directory that exposes this port's information */
210 struct dentry
*debugfs_file
;
213 * Keep count of the bytes sent, received and discarded for
214 * this port for accounting and debugging purposes. These
215 * counts are not reset across port open / close events.
217 struct port_stats stats
;
220 * The entries in this struct will be valid if this port is
221 * hooked up to an hvc console
225 /* Each port associates with a separate char device */
229 /* Reference-counting to handle port hot-unplugs and file operations */
232 /* A waitqueue for poll() or blocking read operations */
233 wait_queue_head_t waitqueue
;
235 /* The 'name' of the port that we expose via sysfs properties */
238 /* We can notify apps of host connect / disconnect events via SIGIO */
239 struct fasync_struct
*async_queue
;
241 /* The 'id' to identify the port with the Host */
246 /* Is the host device open */
249 /* We should allow only one process to open a port */
250 bool guest_connected
;
253 /* This is the very early arch-specified put chars function. */
254 static int (*early_put_chars
)(u32
, const char *, int);
256 static struct port
*find_port_by_vtermno(u32 vtermno
)
259 struct console
*cons
;
262 spin_lock_irqsave(&pdrvdata_lock
, flags
);
263 list_for_each_entry(cons
, &pdrvdata
.consoles
, list
) {
264 if (cons
->vtermno
== vtermno
) {
265 port
= container_of(cons
, struct port
, cons
);
271 spin_unlock_irqrestore(&pdrvdata_lock
, flags
);
275 static struct port
*find_port_by_devt_in_portdev(struct ports_device
*portdev
,
281 spin_lock_irqsave(&portdev
->ports_lock
, flags
);
282 list_for_each_entry(port
, &portdev
->ports
, list
) {
283 if (port
->cdev
->dev
== dev
) {
284 kref_get(&port
->kref
);
290 spin_unlock_irqrestore(&portdev
->ports_lock
, flags
);
295 static struct port
*find_port_by_devt(dev_t dev
)
297 struct ports_device
*portdev
;
301 spin_lock_irqsave(&pdrvdata_lock
, flags
);
302 list_for_each_entry(portdev
, &pdrvdata
.portdevs
, list
) {
303 port
= find_port_by_devt_in_portdev(portdev
, dev
);
309 spin_unlock_irqrestore(&pdrvdata_lock
, flags
);
313 static struct port
*find_port_by_id(struct ports_device
*portdev
, u32 id
)
318 spin_lock_irqsave(&portdev
->ports_lock
, flags
);
319 list_for_each_entry(port
, &portdev
->ports
, list
)
324 spin_unlock_irqrestore(&portdev
->ports_lock
, flags
);
329 static struct port
*find_port_by_vq(struct ports_device
*portdev
,
330 struct virtqueue
*vq
)
335 spin_lock_irqsave(&portdev
->ports_lock
, flags
);
336 list_for_each_entry(port
, &portdev
->ports
, list
)
337 if (port
->in_vq
== vq
|| port
->out_vq
== vq
)
341 spin_unlock_irqrestore(&portdev
->ports_lock
, flags
);
345 static bool is_console_port(struct port
*port
)
352 static bool is_rproc_serial(const struct virtio_device
*vdev
)
354 return is_rproc_enabled
&& vdev
->id
.device
== VIRTIO_ID_RPROC_SERIAL
;
357 static inline bool use_multiport(struct ports_device
*portdev
)
360 * This condition can be true when put_chars is called from
365 return __virtio_test_bit(portdev
->vdev
, VIRTIO_CONSOLE_F_MULTIPORT
);
368 static DEFINE_SPINLOCK(dma_bufs_lock
);
369 static LIST_HEAD(pending_free_dma_bufs
);
371 static void free_buf(struct port_buffer
*buf
, bool can_sleep
)
375 for (i
= 0; i
< buf
->sgpages
; i
++) {
376 struct page
*page
= sg_page(&buf
->sg
[i
]);
384 } else if (is_rproc_enabled
) {
387 /* dma_free_coherent requires interrupts to be enabled. */
389 /* queue up dma-buffers to be freed later */
390 spin_lock_irqsave(&dma_bufs_lock
, flags
);
391 list_add_tail(&buf
->list
, &pending_free_dma_bufs
);
392 spin_unlock_irqrestore(&dma_bufs_lock
, flags
);
395 dma_free_coherent(buf
->dev
, buf
->size
, buf
->buf
, buf
->dma
);
397 /* Release device refcnt and allow it to be freed */
398 put_device(buf
->dev
);
404 static void reclaim_dma_bufs(void)
407 struct port_buffer
*buf
, *tmp
;
410 if (list_empty(&pending_free_dma_bufs
))
413 /* Create a copy of the pending_free_dma_bufs while holding the lock */
414 spin_lock_irqsave(&dma_bufs_lock
, flags
);
415 list_cut_position(&tmp_list
, &pending_free_dma_bufs
,
416 pending_free_dma_bufs
.prev
);
417 spin_unlock_irqrestore(&dma_bufs_lock
, flags
);
419 /* Release the dma buffers, without irqs enabled */
420 list_for_each_entry_safe(buf
, tmp
, &tmp_list
, list
) {
421 list_del(&buf
->list
);
426 static struct port_buffer
*alloc_buf(struct virtqueue
*vq
, size_t buf_size
,
429 struct port_buffer
*buf
;
434 * Allocate buffer and the sg list. The sg list array is allocated
435 * directly after the port_buffer struct.
437 buf
= kmalloc(sizeof(*buf
) + sizeof(struct scatterlist
) * pages
,
442 buf
->sgpages
= pages
;
449 if (is_rproc_serial(vq
->vdev
)) {
451 * Allocate DMA memory from ancestor. When a virtio
452 * device is created by remoteproc, the DMA memory is
453 * associated with the grandparent device:
454 * vdev => rproc => platform-dev.
455 * The code here would have been less quirky if
456 * DMA_MEMORY_INCLUDES_CHILDREN had been supported
459 if (!vq
->vdev
->dev
.parent
|| !vq
->vdev
->dev
.parent
->parent
)
461 buf
->dev
= vq
->vdev
->dev
.parent
->parent
;
463 /* Increase device refcnt to avoid freeing it */
464 get_device(buf
->dev
);
465 buf
->buf
= dma_alloc_coherent(buf
->dev
, buf_size
, &buf
->dma
,
469 buf
->buf
= kmalloc(buf_size
, GFP_KERNEL
);
476 buf
->size
= buf_size
;
485 /* Callers should take appropriate locks */
486 static struct port_buffer
*get_inbuf(struct port
*port
)
488 struct port_buffer
*buf
;
494 buf
= virtqueue_get_buf(port
->in_vq
, &len
);
498 port
->stats
.bytes_received
+= len
;
504 * Create a scatter-gather list representing our input buffer and put
507 * Callers should take appropriate locks.
509 static int add_inbuf(struct virtqueue
*vq
, struct port_buffer
*buf
)
511 struct scatterlist sg
[1];
514 sg_init_one(sg
, buf
->buf
, buf
->size
);
516 ret
= virtqueue_add_inbuf(vq
, sg
, 1, buf
, GFP_ATOMIC
);
523 /* Discard any unread data this port has. Callers lockers. */
524 static void discard_port_data(struct port
*port
)
526 struct port_buffer
*buf
;
529 if (!port
->portdev
) {
530 /* Device has been unplugged. vqs are already gone. */
533 buf
= get_inbuf(port
);
537 port
->stats
.bytes_discarded
+= buf
->len
- buf
->offset
;
538 if (add_inbuf(port
->in_vq
, buf
) < 0) {
540 free_buf(buf
, false);
543 buf
= get_inbuf(port
);
546 dev_warn(port
->dev
, "Errors adding %d buffers back to vq\n",
550 static bool port_has_data(struct port
*port
)
556 spin_lock_irqsave(&port
->inbuf_lock
, flags
);
557 port
->inbuf
= get_inbuf(port
);
561 spin_unlock_irqrestore(&port
->inbuf_lock
, flags
);
565 static ssize_t
__send_control_msg(struct ports_device
*portdev
, u32 port_id
,
566 unsigned int event
, unsigned int value
)
568 struct scatterlist sg
[1];
569 struct virtqueue
*vq
;
572 if (!use_multiport(portdev
))
577 spin_lock(&portdev
->c_ovq_lock
);
579 portdev
->cpkt
.id
= cpu_to_virtio32(portdev
->vdev
, port_id
);
580 portdev
->cpkt
.event
= cpu_to_virtio16(portdev
->vdev
, event
);
581 portdev
->cpkt
.value
= cpu_to_virtio16(portdev
->vdev
, value
);
583 sg_init_one(sg
, &portdev
->cpkt
, sizeof(struct virtio_console_control
));
585 if (virtqueue_add_outbuf(vq
, sg
, 1, &portdev
->cpkt
, GFP_ATOMIC
) == 0) {
587 while (!virtqueue_get_buf(vq
, &len
)
588 && !virtqueue_is_broken(vq
))
592 spin_unlock(&portdev
->c_ovq_lock
);
596 static ssize_t
send_control_msg(struct port
*port
, unsigned int event
,
599 /* Did the port get unplugged before userspace closed it? */
601 return __send_control_msg(port
->portdev
, port
->id
, event
, value
);
606 /* Callers must take the port->outvq_lock */
607 static void reclaim_consumed_buffers(struct port
*port
)
609 struct port_buffer
*buf
;
612 if (!port
->portdev
) {
613 /* Device has been unplugged. vqs are already gone. */
616 while ((buf
= virtqueue_get_buf(port
->out_vq
, &len
))) {
617 free_buf(buf
, false);
618 port
->outvq_full
= false;
622 static ssize_t
__send_to_port(struct port
*port
, struct scatterlist
*sg
,
623 int nents
, size_t in_count
,
624 void *data
, bool nonblock
)
626 struct virtqueue
*out_vq
;
631 out_vq
= port
->out_vq
;
633 spin_lock_irqsave(&port
->outvq_lock
, flags
);
635 reclaim_consumed_buffers(port
);
637 err
= virtqueue_add_outbuf(out_vq
, sg
, nents
, data
, GFP_ATOMIC
);
639 /* Tell Host to go! */
640 virtqueue_kick(out_vq
);
647 if (out_vq
->num_free
== 0)
648 port
->outvq_full
= true;
654 * Wait till the host acknowledges it pushed out the data we
655 * sent. This is done for data from the hvc_console; the tty
656 * operations are performed with spinlocks held so we can't
657 * sleep here. An alternative would be to copy the data to a
658 * buffer and relax the spinning requirement. The downside is
659 * we need to kmalloc a GFP_ATOMIC buffer each time the
660 * console driver writes something out.
662 while (!virtqueue_get_buf(out_vq
, &len
)
663 && !virtqueue_is_broken(out_vq
))
666 spin_unlock_irqrestore(&port
->outvq_lock
, flags
);
668 port
->stats
.bytes_sent
+= in_count
;
670 * We're expected to return the amount of data we wrote -- all
677 * Give out the data that's requested from the buffer that we have
680 static ssize_t
fill_readbuf(struct port
*port
, char __user
*out_buf
,
681 size_t out_count
, bool to_user
)
683 struct port_buffer
*buf
;
686 if (!out_count
|| !port_has_data(port
))
690 out_count
= min(out_count
, buf
->len
- buf
->offset
);
695 ret
= copy_to_user(out_buf
, buf
->buf
+ buf
->offset
, out_count
);
699 memcpy((__force
char *)out_buf
, buf
->buf
+ buf
->offset
,
703 buf
->offset
+= out_count
;
705 if (buf
->offset
== buf
->len
) {
707 * We're done using all the data in this buffer.
708 * Re-queue so that the Host can send us more data.
710 spin_lock_irqsave(&port
->inbuf_lock
, flags
);
713 if (add_inbuf(port
->in_vq
, buf
) < 0)
714 dev_warn(port
->dev
, "failed add_buf\n");
716 spin_unlock_irqrestore(&port
->inbuf_lock
, flags
);
718 /* Return the number of bytes actually copied */
722 /* The condition that must be true for polling to end */
723 static bool will_read_block(struct port
*port
)
725 if (!port
->guest_connected
) {
726 /* Port got hot-unplugged. Let's exit. */
729 return !port_has_data(port
) && port
->host_connected
;
732 static bool will_write_block(struct port
*port
)
736 if (!port
->guest_connected
) {
737 /* Port got hot-unplugged. Let's exit. */
740 if (!port
->host_connected
)
743 spin_lock_irq(&port
->outvq_lock
);
745 * Check if the Host has consumed any buffers since we last
746 * sent data (this is only applicable for nonblocking ports).
748 reclaim_consumed_buffers(port
);
749 ret
= port
->outvq_full
;
750 spin_unlock_irq(&port
->outvq_lock
);
755 static ssize_t
port_fops_read(struct file
*filp
, char __user
*ubuf
,
756 size_t count
, loff_t
*offp
)
761 port
= filp
->private_data
;
763 /* Port is hot-unplugged. */
764 if (!port
->guest_connected
)
767 if (!port_has_data(port
)) {
769 * If nothing's connected on the host just return 0 in
770 * case of list_empty; this tells the userspace app
771 * that there's no connection
773 if (!port
->host_connected
)
775 if (filp
->f_flags
& O_NONBLOCK
)
778 ret
= wait_event_freezable(port
->waitqueue
,
779 !will_read_block(port
));
783 /* Port got hot-unplugged while we were waiting above. */
784 if (!port
->guest_connected
)
787 * We could've received a disconnection message while we were
788 * waiting for more data.
790 * This check is not clubbed in the if() statement above as we
791 * might receive some data as well as the host could get
792 * disconnected after we got woken up from our wait. So we
793 * really want to give off whatever data we have and only then
794 * check for host_connected.
796 if (!port_has_data(port
) && !port
->host_connected
)
799 return fill_readbuf(port
, ubuf
, count
, true);
802 static int wait_port_writable(struct port
*port
, bool nonblock
)
806 if (will_write_block(port
)) {
810 ret
= wait_event_freezable(port
->waitqueue
,
811 !will_write_block(port
));
815 /* Port got hot-unplugged. */
816 if (!port
->guest_connected
)
822 static ssize_t
port_fops_write(struct file
*filp
, const char __user
*ubuf
,
823 size_t count
, loff_t
*offp
)
826 struct port_buffer
*buf
;
829 struct scatterlist sg
[1];
831 /* Userspace could be out to fool us */
835 port
= filp
->private_data
;
837 nonblock
= filp
->f_flags
& O_NONBLOCK
;
839 ret
= wait_port_writable(port
, nonblock
);
843 count
= min((size_t)(32 * 1024), count
);
845 buf
= alloc_buf(port
->out_vq
, count
, 0);
849 ret
= copy_from_user(buf
->buf
, ubuf
, count
);
856 * We now ask send_buf() to not spin for generic ports -- we
857 * can re-use the same code path that non-blocking file
858 * descriptors take for blocking file descriptors since the
859 * wait is already done and we're certain the write will go
860 * through to the host.
863 sg_init_one(sg
, buf
->buf
, count
);
864 ret
= __send_to_port(port
, sg
, 1, count
, buf
, nonblock
);
866 if (nonblock
&& ret
> 0)
879 struct scatterlist
*sg
;
882 static int pipe_to_sg(struct pipe_inode_info
*pipe
, struct pipe_buffer
*buf
,
883 struct splice_desc
*sd
)
885 struct sg_list
*sgl
= sd
->u
.data
;
886 unsigned int offset
, len
;
888 if (sgl
->n
== sgl
->size
)
891 /* Try lock this page */
892 if (buf
->ops
->steal(pipe
, buf
) == 0) {
893 /* Get reference and unlock page for moving */
895 unlock_page(buf
->page
);
897 len
= min(buf
->len
, sd
->len
);
898 sg_set_page(&(sgl
->sg
[sgl
->n
]), buf
->page
, len
, buf
->offset
);
900 /* Failback to copying a page */
901 struct page
*page
= alloc_page(GFP_KERNEL
);
907 offset
= sd
->pos
& ~PAGE_MASK
;
910 if (len
+ offset
> PAGE_SIZE
)
911 len
= PAGE_SIZE
- offset
;
913 src
= kmap_atomic(buf
->page
);
914 memcpy(page_address(page
) + offset
, src
+ buf
->offset
, len
);
917 sg_set_page(&(sgl
->sg
[sgl
->n
]), page
, len
, offset
);
925 /* Faster zero-copy write by splicing */
926 static ssize_t
port_fops_splice_write(struct pipe_inode_info
*pipe
,
927 struct file
*filp
, loff_t
*ppos
,
928 size_t len
, unsigned int flags
)
930 struct port
*port
= filp
->private_data
;
933 struct port_buffer
*buf
;
934 struct splice_desc sd
= {
942 * Rproc_serial does not yet support splice. To support splice
943 * pipe_to_sg() must allocate dma-buffers and copy content from
944 * regular pages to dma pages. And alloc_buf and free_buf must
945 * support allocating and freeing such a list of dma-buffers.
947 if (is_rproc_serial(port
->out_vq
->vdev
))
951 * pipe->nrbufs == 0 means there are no data to transfer,
952 * so this returns just 0 for no data.
960 ret
= wait_port_writable(port
, filp
->f_flags
& O_NONBLOCK
);
964 buf
= alloc_buf(port
->out_vq
, 0, pipe
->nrbufs
);
972 sgl
.size
= pipe
->nrbufs
;
974 sg_init_table(sgl
.sg
, sgl
.size
);
975 ret
= __splice_from_pipe(pipe
, &sd
, pipe_to_sg
);
978 ret
= __send_to_port(port
, buf
->sg
, sgl
.n
, sgl
.len
, buf
, true);
980 if (unlikely(ret
<= 0))
989 static unsigned int port_fops_poll(struct file
*filp
, poll_table
*wait
)
994 port
= filp
->private_data
;
995 poll_wait(filp
, &port
->waitqueue
, wait
);
997 if (!port
->guest_connected
) {
998 /* Port got unplugged */
1002 if (!will_read_block(port
))
1003 ret
|= POLLIN
| POLLRDNORM
;
1004 if (!will_write_block(port
))
1006 if (!port
->host_connected
)
1012 static void remove_port(struct kref
*kref
);
1014 static int port_fops_release(struct inode
*inode
, struct file
*filp
)
1018 port
= filp
->private_data
;
1020 /* Notify host of port being closed */
1021 send_control_msg(port
, VIRTIO_CONSOLE_PORT_OPEN
, 0);
1023 spin_lock_irq(&port
->inbuf_lock
);
1024 port
->guest_connected
= false;
1026 discard_port_data(port
);
1028 spin_unlock_irq(&port
->inbuf_lock
);
1030 spin_lock_irq(&port
->outvq_lock
);
1031 reclaim_consumed_buffers(port
);
1032 spin_unlock_irq(&port
->outvq_lock
);
1036 * Locks aren't necessary here as a port can't be opened after
1037 * unplug, and if a port isn't unplugged, a kref would already
1038 * exist for the port. Plus, taking ports_lock here would
1039 * create a dependency on other locks taken by functions
1040 * inside remove_port if we're the last holder of the port,
1041 * creating many problems.
1043 kref_put(&port
->kref
, remove_port
);
1048 static int port_fops_open(struct inode
*inode
, struct file
*filp
)
1050 struct cdev
*cdev
= inode
->i_cdev
;
1054 /* We get the port with a kref here */
1055 port
= find_port_by_devt(cdev
->dev
);
1057 /* Port was unplugged before we could proceed */
1060 filp
->private_data
= port
;
1063 * Don't allow opening of console port devices -- that's done
1066 if (is_console_port(port
)) {
1071 /* Allow only one process to open a particular port at a time */
1072 spin_lock_irq(&port
->inbuf_lock
);
1073 if (port
->guest_connected
) {
1074 spin_unlock_irq(&port
->inbuf_lock
);
1079 port
->guest_connected
= true;
1080 spin_unlock_irq(&port
->inbuf_lock
);
1082 spin_lock_irq(&port
->outvq_lock
);
1084 * There might be a chance that we missed reclaiming a few
1085 * buffers in the window of the port getting previously closed
1088 reclaim_consumed_buffers(port
);
1089 spin_unlock_irq(&port
->outvq_lock
);
1091 nonseekable_open(inode
, filp
);
1093 /* Notify host of port being opened */
1094 send_control_msg(filp
->private_data
, VIRTIO_CONSOLE_PORT_OPEN
, 1);
1098 kref_put(&port
->kref
, remove_port
);
1102 static int port_fops_fasync(int fd
, struct file
*filp
, int mode
)
1106 port
= filp
->private_data
;
1107 return fasync_helper(fd
, filp
, mode
, &port
->async_queue
);
1111 * The file operations that we support: programs in the guest can open
1112 * a console device, read from it, write to it, poll for data and
1113 * close it. The devices are at
1114 * /dev/vport<device number>p<port number>
1116 static const struct file_operations port_fops
= {
1117 .owner
= THIS_MODULE
,
1118 .open
= port_fops_open
,
1119 .read
= port_fops_read
,
1120 .write
= port_fops_write
,
1121 .splice_write
= port_fops_splice_write
,
1122 .poll
= port_fops_poll
,
1123 .release
= port_fops_release
,
1124 .fasync
= port_fops_fasync
,
1125 .llseek
= no_llseek
,
1129 * The put_chars() callback is pretty straightforward.
1131 * We turn the characters into a scatter-gather list, add it to the
1132 * output queue and then kick the Host. Then we sit here waiting for
1133 * it to finish: inefficient in theory, but in practice
1134 * implementations will do it immediately (lguest's Launcher does).
1136 static int put_chars(u32 vtermno
, const char *buf
, int count
)
1139 struct scatterlist sg
[1];
1141 if (unlikely(early_put_chars
))
1142 return early_put_chars(vtermno
, buf
, count
);
1144 port
= find_port_by_vtermno(vtermno
);
1148 sg_init_one(sg
, buf
, count
);
1149 return __send_to_port(port
, sg
, 1, count
, (void *)buf
, false);
1153 * get_chars() is the callback from the hvc_console infrastructure
1154 * when an interrupt is received.
1156 * We call out to fill_readbuf that gets us the required data from the
1157 * buffers that are queued up.
1159 static int get_chars(u32 vtermno
, char *buf
, int count
)
1163 /* If we've not set up the port yet, we have no input to give. */
1164 if (unlikely(early_put_chars
))
1167 port
= find_port_by_vtermno(vtermno
);
1171 /* If we don't have an input queue yet, we can't get input. */
1172 BUG_ON(!port
->in_vq
);
1174 return fill_readbuf(port
, (__force
char __user
*)buf
, count
, false);
1177 static void resize_console(struct port
*port
)
1179 struct virtio_device
*vdev
;
1181 /* The port could have been hot-unplugged */
1182 if (!port
|| !is_console_port(port
))
1185 vdev
= port
->portdev
->vdev
;
1187 /* Don't test F_SIZE at all if we're rproc: not a valid feature! */
1188 if (!is_rproc_serial(vdev
) &&
1189 virtio_has_feature(vdev
, VIRTIO_CONSOLE_F_SIZE
))
1190 hvc_resize(port
->cons
.hvc
, port
->cons
.ws
);
1193 /* We set the configuration at this point, since we now have a tty */
1194 static int notifier_add_vio(struct hvc_struct
*hp
, int data
)
1198 port
= find_port_by_vtermno(hp
->vtermno
);
1202 hp
->irq_requested
= 1;
1203 resize_console(port
);
1208 static void notifier_del_vio(struct hvc_struct
*hp
, int data
)
1210 hp
->irq_requested
= 0;
1213 /* The operations for console ports. */
1214 static const struct hv_ops hv_ops
= {
1215 .get_chars
= get_chars
,
1216 .put_chars
= put_chars
,
1217 .notifier_add
= notifier_add_vio
,
1218 .notifier_del
= notifier_del_vio
,
1219 .notifier_hangup
= notifier_del_vio
,
1223 * Console drivers are initialized very early so boot messages can go
1224 * out, so we do things slightly differently from the generic virtio
1225 * initialization of the net and block drivers.
1227 * At this stage, the console is output-only. It's too early to set
1228 * up a virtqueue, so we let the drivers do some boutique early-output
1231 int __init
virtio_cons_early_init(int (*put_chars
)(u32
, const char *, int))
1233 early_put_chars
= put_chars
;
1234 return hvc_instantiate(0, 0, &hv_ops
);
1237 static int init_port_console(struct port
*port
)
1242 * The Host's telling us this port is a console port. Hook it
1243 * up with an hvc console.
1245 * To set up and manage our virtual console, we call
1248 * The first argument of hvc_alloc() is the virtual console
1249 * number. The second argument is the parameter for the
1250 * notification mechanism (like irq number). We currently
1251 * leave this as zero, virtqueues have implicit notifications.
1253 * The third argument is a "struct hv_ops" containing the
1254 * put_chars() get_chars(), notifier_add() and notifier_del()
1255 * pointers. The final argument is the output buffer size: we
1256 * can do any size, so we put PAGE_SIZE here.
1258 port
->cons
.vtermno
= pdrvdata
.next_vtermno
;
1260 port
->cons
.hvc
= hvc_alloc(port
->cons
.vtermno
, 0, &hv_ops
, PAGE_SIZE
);
1261 if (IS_ERR(port
->cons
.hvc
)) {
1262 ret
= PTR_ERR(port
->cons
.hvc
);
1264 "error %d allocating hvc for port\n", ret
);
1265 port
->cons
.hvc
= NULL
;
1268 spin_lock_irq(&pdrvdata_lock
);
1269 pdrvdata
.next_vtermno
++;
1270 list_add_tail(&port
->cons
.list
, &pdrvdata
.consoles
);
1271 spin_unlock_irq(&pdrvdata_lock
);
1272 port
->guest_connected
= true;
1275 * Start using the new console output if this is the first
1276 * console to come up.
1278 if (early_put_chars
)
1279 early_put_chars
= NULL
;
1281 /* Notify host of port being opened */
1282 send_control_msg(port
, VIRTIO_CONSOLE_PORT_OPEN
, 1);
1287 static ssize_t
show_port_name(struct device
*dev
,
1288 struct device_attribute
*attr
, char *buffer
)
1292 port
= dev_get_drvdata(dev
);
1294 return sprintf(buffer
, "%s\n", port
->name
);
1297 static DEVICE_ATTR(name
, S_IRUGO
, show_port_name
, NULL
);
1299 static struct attribute
*port_sysfs_entries
[] = {
1300 &dev_attr_name
.attr
,
1304 static struct attribute_group port_attribute_group
= {
1305 .name
= NULL
, /* put in device directory */
1306 .attrs
= port_sysfs_entries
,
1309 static ssize_t
debugfs_read(struct file
*filp
, char __user
*ubuf
,
1310 size_t count
, loff_t
*offp
)
1314 ssize_t ret
, out_offset
, out_count
;
1317 buf
= kmalloc(out_count
, GFP_KERNEL
);
1321 port
= filp
->private_data
;
1323 out_offset
+= snprintf(buf
+ out_offset
, out_count
,
1324 "name: %s\n", port
->name
? port
->name
: "");
1325 out_offset
+= snprintf(buf
+ out_offset
, out_count
- out_offset
,
1326 "guest_connected: %d\n", port
->guest_connected
);
1327 out_offset
+= snprintf(buf
+ out_offset
, out_count
- out_offset
,
1328 "host_connected: %d\n", port
->host_connected
);
1329 out_offset
+= snprintf(buf
+ out_offset
, out_count
- out_offset
,
1330 "outvq_full: %d\n", port
->outvq_full
);
1331 out_offset
+= snprintf(buf
+ out_offset
, out_count
- out_offset
,
1332 "bytes_sent: %lu\n", port
->stats
.bytes_sent
);
1333 out_offset
+= snprintf(buf
+ out_offset
, out_count
- out_offset
,
1334 "bytes_received: %lu\n",
1335 port
->stats
.bytes_received
);
1336 out_offset
+= snprintf(buf
+ out_offset
, out_count
- out_offset
,
1337 "bytes_discarded: %lu\n",
1338 port
->stats
.bytes_discarded
);
1339 out_offset
+= snprintf(buf
+ out_offset
, out_count
- out_offset
,
1341 is_console_port(port
) ? "yes" : "no");
1342 out_offset
+= snprintf(buf
+ out_offset
, out_count
- out_offset
,
1343 "console_vtermno: %u\n", port
->cons
.vtermno
);
1345 ret
= simple_read_from_buffer(ubuf
, count
, offp
, buf
, out_offset
);
1350 static const struct file_operations port_debugfs_ops
= {
1351 .owner
= THIS_MODULE
,
1352 .open
= simple_open
,
1353 .read
= debugfs_read
,
1356 static void set_console_size(struct port
*port
, u16 rows
, u16 cols
)
1358 if (!port
|| !is_console_port(port
))
1361 port
->cons
.ws
.ws_row
= rows
;
1362 port
->cons
.ws
.ws_col
= cols
;
1365 static unsigned int fill_queue(struct virtqueue
*vq
, spinlock_t
*lock
)
1367 struct port_buffer
*buf
;
1368 unsigned int nr_added_bufs
;
1373 buf
= alloc_buf(vq
, PAGE_SIZE
, 0);
1377 spin_lock_irq(lock
);
1378 ret
= add_inbuf(vq
, buf
);
1380 spin_unlock_irq(lock
);
1381 free_buf(buf
, true);
1385 spin_unlock_irq(lock
);
1388 return nr_added_bufs
;
1391 static void send_sigio_to_port(struct port
*port
)
1393 if (port
->async_queue
&& port
->guest_connected
)
1394 kill_fasync(&port
->async_queue
, SIGIO
, POLL_OUT
);
1397 static int add_port(struct ports_device
*portdev
, u32 id
)
1399 char debugfs_name
[16];
1401 struct port_buffer
*buf
;
1403 unsigned int nr_added_bufs
;
1406 port
= kmalloc(sizeof(*port
), GFP_KERNEL
);
1411 kref_init(&port
->kref
);
1413 port
->portdev
= portdev
;
1418 port
->cons
.hvc
= NULL
;
1419 port
->async_queue
= NULL
;
1421 port
->cons
.ws
.ws_row
= port
->cons
.ws
.ws_col
= 0;
1423 port
->host_connected
= port
->guest_connected
= false;
1424 port
->stats
= (struct port_stats
) { 0 };
1426 port
->outvq_full
= false;
1428 port
->in_vq
= portdev
->in_vqs
[port
->id
];
1429 port
->out_vq
= portdev
->out_vqs
[port
->id
];
1431 port
->cdev
= cdev_alloc();
1433 dev_err(&port
->portdev
->vdev
->dev
, "Error allocating cdev\n");
1437 port
->cdev
->ops
= &port_fops
;
1439 devt
= MKDEV(portdev
->chr_major
, id
);
1440 err
= cdev_add(port
->cdev
, devt
, 1);
1442 dev_err(&port
->portdev
->vdev
->dev
,
1443 "Error %d adding cdev for port %u\n", err
, id
);
1446 port
->dev
= device_create(pdrvdata
.class, &port
->portdev
->vdev
->dev
,
1447 devt
, port
, "vport%up%u",
1448 port
->portdev
->vdev
->index
, id
);
1449 if (IS_ERR(port
->dev
)) {
1450 err
= PTR_ERR(port
->dev
);
1451 dev_err(&port
->portdev
->vdev
->dev
,
1452 "Error %d creating device for port %u\n",
1457 spin_lock_init(&port
->inbuf_lock
);
1458 spin_lock_init(&port
->outvq_lock
);
1459 init_waitqueue_head(&port
->waitqueue
);
1461 /* Fill the in_vq with buffers so the host can send us data. */
1462 nr_added_bufs
= fill_queue(port
->in_vq
, &port
->inbuf_lock
);
1463 if (!nr_added_bufs
) {
1464 dev_err(port
->dev
, "Error allocating inbufs\n");
1469 if (is_rproc_serial(port
->portdev
->vdev
))
1471 * For rproc_serial assume remote processor is connected.
1472 * rproc_serial does not want the console port, only
1473 * the generic port implementation.
1475 port
->host_connected
= true;
1476 else if (!use_multiport(port
->portdev
)) {
1478 * If we're not using multiport support,
1479 * this has to be a console port.
1481 err
= init_port_console(port
);
1486 spin_lock_irq(&portdev
->ports_lock
);
1487 list_add_tail(&port
->list
, &port
->portdev
->ports
);
1488 spin_unlock_irq(&portdev
->ports_lock
);
1491 * Tell the Host we're set so that it can send us various
1492 * configuration parameters for this port (eg, port name,
1493 * caching, whether this is a console port, etc.)
1495 send_control_msg(port
, VIRTIO_CONSOLE_PORT_READY
, 1);
1497 if (pdrvdata
.debugfs_dir
) {
1499 * Finally, create the debugfs file that we can use to
1500 * inspect a port's state at any time
1502 snprintf(debugfs_name
, sizeof(debugfs_name
), "vport%up%u",
1503 port
->portdev
->vdev
->index
, id
);
1504 port
->debugfs_file
= debugfs_create_file(debugfs_name
, 0444,
1505 pdrvdata
.debugfs_dir
,
1512 while ((buf
= virtqueue_detach_unused_buf(port
->in_vq
)))
1513 free_buf(buf
, true);
1515 device_destroy(pdrvdata
.class, port
->dev
->devt
);
1517 cdev_del(port
->cdev
);
1521 /* The host might want to notify management sw about port add failure */
1522 __send_control_msg(portdev
, id
, VIRTIO_CONSOLE_PORT_READY
, 0);
1526 /* No users remain, remove all port-specific data. */
1527 static void remove_port(struct kref
*kref
)
1531 port
= container_of(kref
, struct port
, kref
);
1536 static void remove_port_data(struct port
*port
)
1538 struct port_buffer
*buf
;
1540 spin_lock_irq(&port
->inbuf_lock
);
1541 /* Remove unused data this port might have received. */
1542 discard_port_data(port
);
1544 /* Remove buffers we queued up for the Host to send us data in. */
1545 while ((buf
= virtqueue_detach_unused_buf(port
->in_vq
)))
1546 free_buf(buf
, true);
1547 spin_unlock_irq(&port
->inbuf_lock
);
1549 spin_lock_irq(&port
->outvq_lock
);
1550 reclaim_consumed_buffers(port
);
1552 /* Free pending buffers from the out-queue. */
1553 while ((buf
= virtqueue_detach_unused_buf(port
->out_vq
)))
1554 free_buf(buf
, true);
1555 spin_unlock_irq(&port
->outvq_lock
);
1559 * Port got unplugged. Remove port from portdev's list and drop the
1560 * kref reference. If no userspace has this port opened, it will
1561 * result in immediate removal the port.
1563 static void unplug_port(struct port
*port
)
1565 spin_lock_irq(&port
->portdev
->ports_lock
);
1566 list_del(&port
->list
);
1567 spin_unlock_irq(&port
->portdev
->ports_lock
);
1569 spin_lock_irq(&port
->inbuf_lock
);
1570 if (port
->guest_connected
) {
1571 /* Let the app know the port is going down. */
1572 send_sigio_to_port(port
);
1574 /* Do this after sigio is actually sent */
1575 port
->guest_connected
= false;
1576 port
->host_connected
= false;
1578 wake_up_interruptible(&port
->waitqueue
);
1580 spin_unlock_irq(&port
->inbuf_lock
);
1582 if (is_console_port(port
)) {
1583 spin_lock_irq(&pdrvdata_lock
);
1584 list_del(&port
->cons
.list
);
1585 spin_unlock_irq(&pdrvdata_lock
);
1586 hvc_remove(port
->cons
.hvc
);
1589 remove_port_data(port
);
1592 * We should just assume the device itself has gone off --
1593 * else a close on an open port later will try to send out a
1596 port
->portdev
= NULL
;
1598 sysfs_remove_group(&port
->dev
->kobj
, &port_attribute_group
);
1599 device_destroy(pdrvdata
.class, port
->dev
->devt
);
1600 cdev_del(port
->cdev
);
1602 debugfs_remove(port
->debugfs_file
);
1606 * Locks around here are not necessary - a port can't be
1607 * opened after we removed the port struct from ports_list
1610 kref_put(&port
->kref
, remove_port
);
1613 /* Any private messages that the Host and Guest want to share */
1614 static void handle_control_message(struct virtio_device
*vdev
,
1615 struct ports_device
*portdev
,
1616 struct port_buffer
*buf
)
1618 struct virtio_console_control
*cpkt
;
1623 cpkt
= (struct virtio_console_control
*)(buf
->buf
+ buf
->offset
);
1625 port
= find_port_by_id(portdev
, virtio32_to_cpu(vdev
, cpkt
->id
));
1627 cpkt
->event
!= cpu_to_virtio16(vdev
, VIRTIO_CONSOLE_PORT_ADD
)) {
1628 /* No valid header at start of buffer. Drop it. */
1629 dev_dbg(&portdev
->vdev
->dev
,
1630 "Invalid index %u in control packet\n", cpkt
->id
);
1634 switch (virtio16_to_cpu(vdev
, cpkt
->event
)) {
1635 case VIRTIO_CONSOLE_PORT_ADD
:
1637 dev_dbg(&portdev
->vdev
->dev
,
1638 "Port %u already added\n", port
->id
);
1639 send_control_msg(port
, VIRTIO_CONSOLE_PORT_READY
, 1);
1642 if (virtio32_to_cpu(vdev
, cpkt
->id
) >=
1643 portdev
->config
.max_nr_ports
) {
1644 dev_warn(&portdev
->vdev
->dev
,
1645 "Request for adding port with "
1646 "out-of-bound id %u, max. supported id: %u\n",
1647 cpkt
->id
, portdev
->config
.max_nr_ports
- 1);
1650 add_port(portdev
, virtio32_to_cpu(vdev
, cpkt
->id
));
1652 case VIRTIO_CONSOLE_PORT_REMOVE
:
1655 case VIRTIO_CONSOLE_CONSOLE_PORT
:
1658 if (is_console_port(port
))
1661 init_port_console(port
);
1662 complete(&early_console_added
);
1664 * Could remove the port here in case init fails - but
1665 * have to notify the host first.
1668 case VIRTIO_CONSOLE_RESIZE
: {
1674 if (!is_console_port(port
))
1677 memcpy(&size
, buf
->buf
+ buf
->offset
+ sizeof(*cpkt
),
1679 set_console_size(port
, size
.rows
, size
.cols
);
1681 port
->cons
.hvc
->irq_requested
= 1;
1682 resize_console(port
);
1685 case VIRTIO_CONSOLE_PORT_OPEN
:
1686 port
->host_connected
= virtio16_to_cpu(vdev
, cpkt
->value
);
1687 wake_up_interruptible(&port
->waitqueue
);
1689 * If the host port got closed and the host had any
1690 * unconsumed buffers, we'll be able to reclaim them
1693 spin_lock_irq(&port
->outvq_lock
);
1694 reclaim_consumed_buffers(port
);
1695 spin_unlock_irq(&port
->outvq_lock
);
1698 * If the guest is connected, it'll be interested in
1699 * knowing the host connection state changed.
1701 spin_lock_irq(&port
->inbuf_lock
);
1702 send_sigio_to_port(port
);
1703 spin_unlock_irq(&port
->inbuf_lock
);
1705 case VIRTIO_CONSOLE_PORT_NAME
:
1707 * If we woke up after hibernation, we can get this
1708 * again. Skip it in that case.
1714 * Skip the size of the header and the cpkt to get the size
1715 * of the name that was sent
1717 name_size
= buf
->len
- buf
->offset
- sizeof(*cpkt
) + 1;
1719 port
->name
= kmalloc(name_size
, GFP_KERNEL
);
1722 "Not enough space to store port name\n");
1725 strncpy(port
->name
, buf
->buf
+ buf
->offset
+ sizeof(*cpkt
),
1727 port
->name
[name_size
- 1] = 0;
1730 * Since we only have one sysfs attribute, 'name',
1731 * create it only if we have a name for the port.
1733 err
= sysfs_create_group(&port
->dev
->kobj
,
1734 &port_attribute_group
);
1737 "Error %d creating sysfs device attributes\n",
1741 * Generate a udev event so that appropriate
1742 * symlinks can be created based on udev
1745 kobject_uevent(&port
->dev
->kobj
, KOBJ_CHANGE
);
1751 static void control_work_handler(struct work_struct
*work
)
1753 struct ports_device
*portdev
;
1754 struct virtqueue
*vq
;
1755 struct port_buffer
*buf
;
1758 portdev
= container_of(work
, struct ports_device
, control_work
);
1759 vq
= portdev
->c_ivq
;
1761 spin_lock(&portdev
->c_ivq_lock
);
1762 while ((buf
= virtqueue_get_buf(vq
, &len
))) {
1763 spin_unlock(&portdev
->c_ivq_lock
);
1768 handle_control_message(vq
->vdev
, portdev
, buf
);
1770 spin_lock(&portdev
->c_ivq_lock
);
1771 if (add_inbuf(portdev
->c_ivq
, buf
) < 0) {
1772 dev_warn(&portdev
->vdev
->dev
,
1773 "Error adding buffer to queue\n");
1774 free_buf(buf
, false);
1777 spin_unlock(&portdev
->c_ivq_lock
);
1780 static void out_intr(struct virtqueue
*vq
)
1784 port
= find_port_by_vq(vq
->vdev
->priv
, vq
);
1788 wake_up_interruptible(&port
->waitqueue
);
1791 static void in_intr(struct virtqueue
*vq
)
1794 unsigned long flags
;
1796 port
= find_port_by_vq(vq
->vdev
->priv
, vq
);
1800 spin_lock_irqsave(&port
->inbuf_lock
, flags
);
1801 port
->inbuf
= get_inbuf(port
);
1804 * Normally the port should not accept data when the port is
1805 * closed. For generic serial ports, the host won't (shouldn't)
1806 * send data till the guest is connected. But this condition
1807 * can be reached when a console port is not yet connected (no
1808 * tty is spawned) and the other side sends out data over the
1809 * vring, or when a remote devices start sending data before
1810 * the ports are opened.
1812 * A generic serial port will discard data if not connected,
1813 * while console ports and rproc-serial ports accepts data at
1814 * any time. rproc-serial is initiated with guest_connected to
1815 * false because port_fops_open expects this. Console ports are
1816 * hooked up with an HVC console and is initialized with
1817 * guest_connected to true.
1820 if (!port
->guest_connected
&& !is_rproc_serial(port
->portdev
->vdev
))
1821 discard_port_data(port
);
1823 /* Send a SIGIO indicating new data in case the process asked for it */
1824 send_sigio_to_port(port
);
1826 spin_unlock_irqrestore(&port
->inbuf_lock
, flags
);
1828 wake_up_interruptible(&port
->waitqueue
);
1830 if (is_console_port(port
) && hvc_poll(port
->cons
.hvc
))
1834 static void control_intr(struct virtqueue
*vq
)
1836 struct ports_device
*portdev
;
1838 portdev
= vq
->vdev
->priv
;
1839 schedule_work(&portdev
->control_work
);
1842 static void config_intr(struct virtio_device
*vdev
)
1844 struct ports_device
*portdev
;
1846 portdev
= vdev
->priv
;
1848 if (!use_multiport(portdev
))
1849 schedule_work(&portdev
->config_work
);
1852 static void config_work_handler(struct work_struct
*work
)
1854 struct ports_device
*portdev
;
1856 portdev
= container_of(work
, struct ports_device
, control_work
);
1857 if (!use_multiport(portdev
)) {
1858 struct virtio_device
*vdev
;
1862 vdev
= portdev
->vdev
;
1863 virtio_cread(vdev
, struct virtio_console_config
, cols
, &cols
);
1864 virtio_cread(vdev
, struct virtio_console_config
, rows
, &rows
);
1866 port
= find_port_by_id(portdev
, 0);
1867 set_console_size(port
, rows
, cols
);
1870 * We'll use this way of resizing only for legacy
1871 * support. For newer userspace
1872 * (VIRTIO_CONSOLE_F_MULTPORT+), use control messages
1873 * to indicate console size changes so that it can be
1876 resize_console(port
);
1880 static int init_vqs(struct ports_device
*portdev
)
1882 vq_callback_t
**io_callbacks
;
1884 struct virtqueue
**vqs
;
1885 u32 i
, j
, nr_ports
, nr_queues
;
1888 nr_ports
= portdev
->config
.max_nr_ports
;
1889 nr_queues
= use_multiport(portdev
) ? (nr_ports
+ 1) * 2 : 2;
1891 vqs
= kmalloc(nr_queues
* sizeof(struct virtqueue
*), GFP_KERNEL
);
1892 io_callbacks
= kmalloc(nr_queues
* sizeof(vq_callback_t
*), GFP_KERNEL
);
1893 io_names
= kmalloc(nr_queues
* sizeof(char *), GFP_KERNEL
);
1894 portdev
->in_vqs
= kmalloc(nr_ports
* sizeof(struct virtqueue
*),
1896 portdev
->out_vqs
= kmalloc(nr_ports
* sizeof(struct virtqueue
*),
1898 if (!vqs
|| !io_callbacks
|| !io_names
|| !portdev
->in_vqs
||
1899 !portdev
->out_vqs
) {
1905 * For backward compat (newer host but older guest), the host
1906 * spawns a console port first and also inits the vqs for port
1910 io_callbacks
[j
] = in_intr
;
1911 io_callbacks
[j
+ 1] = out_intr
;
1912 io_names
[j
] = "input";
1913 io_names
[j
+ 1] = "output";
1916 if (use_multiport(portdev
)) {
1917 io_callbacks
[j
] = control_intr
;
1918 io_callbacks
[j
+ 1] = NULL
;
1919 io_names
[j
] = "control-i";
1920 io_names
[j
+ 1] = "control-o";
1922 for (i
= 1; i
< nr_ports
; i
++) {
1924 io_callbacks
[j
] = in_intr
;
1925 io_callbacks
[j
+ 1] = out_intr
;
1926 io_names
[j
] = "input";
1927 io_names
[j
+ 1] = "output";
1930 /* Find the queues. */
1931 err
= portdev
->vdev
->config
->find_vqs(portdev
->vdev
, nr_queues
, vqs
,
1933 (const char **)io_names
);
1938 portdev
->in_vqs
[0] = vqs
[0];
1939 portdev
->out_vqs
[0] = vqs
[1];
1941 if (use_multiport(portdev
)) {
1942 portdev
->c_ivq
= vqs
[j
];
1943 portdev
->c_ovq
= vqs
[j
+ 1];
1945 for (i
= 1; i
< nr_ports
; i
++) {
1947 portdev
->in_vqs
[i
] = vqs
[j
];
1948 portdev
->out_vqs
[i
] = vqs
[j
+ 1];
1952 kfree(io_callbacks
);
1958 kfree(portdev
->out_vqs
);
1959 kfree(portdev
->in_vqs
);
1961 kfree(io_callbacks
);
1967 static const struct file_operations portdev_fops
= {
1968 .owner
= THIS_MODULE
,
1971 static void remove_vqs(struct ports_device
*portdev
)
1973 portdev
->vdev
->config
->del_vqs(portdev
->vdev
);
1974 kfree(portdev
->in_vqs
);
1975 kfree(portdev
->out_vqs
);
1978 static void remove_controlq_data(struct ports_device
*portdev
)
1980 struct port_buffer
*buf
;
1983 if (!use_multiport(portdev
))
1986 while ((buf
= virtqueue_get_buf(portdev
->c_ivq
, &len
)))
1987 free_buf(buf
, true);
1989 while ((buf
= virtqueue_detach_unused_buf(portdev
->c_ivq
)))
1990 free_buf(buf
, true);
1994 * Once we're further in boot, we get probed like any other virtio
1997 * If the host also supports multiple console ports, we check the
1998 * config space to see how many ports the host has spawned. We
1999 * initialize each port found.
2001 static int virtcons_probe(struct virtio_device
*vdev
)
2003 struct ports_device
*portdev
;
2006 bool early
= early_put_chars
!= NULL
;
2008 /* We only need a config space if features are offered */
2009 if (!vdev
->config
->get
&&
2010 (virtio_has_feature(vdev
, VIRTIO_CONSOLE_F_SIZE
)
2011 || virtio_has_feature(vdev
, VIRTIO_CONSOLE_F_MULTIPORT
))) {
2012 dev_err(&vdev
->dev
, "%s failure: config access disabled\n",
2017 /* Ensure to read early_put_chars now */
2020 portdev
= kmalloc(sizeof(*portdev
), GFP_KERNEL
);
2026 /* Attach this portdev to this virtio_device, and vice-versa. */
2027 portdev
->vdev
= vdev
;
2028 vdev
->priv
= portdev
;
2030 portdev
->chr_major
= register_chrdev(0, "virtio-portsdev",
2032 if (portdev
->chr_major
< 0) {
2034 "Error %d registering chrdev for device %u\n",
2035 portdev
->chr_major
, vdev
->index
);
2036 err
= portdev
->chr_major
;
2041 portdev
->config
.max_nr_ports
= 1;
2043 /* Don't test MULTIPORT at all if we're rproc: not a valid feature! */
2044 if (!is_rproc_serial(vdev
) &&
2045 virtio_cread_feature(vdev
, VIRTIO_CONSOLE_F_MULTIPORT
,
2046 struct virtio_console_config
, max_nr_ports
,
2047 &portdev
->config
.max_nr_ports
) == 0) {
2051 err
= init_vqs(portdev
);
2053 dev_err(&vdev
->dev
, "Error %d initializing vqs\n", err
);
2057 spin_lock_init(&portdev
->ports_lock
);
2058 INIT_LIST_HEAD(&portdev
->ports
);
2060 virtio_device_ready(portdev
->vdev
);
2062 INIT_WORK(&portdev
->config_work
, &config_work_handler
);
2063 INIT_WORK(&portdev
->control_work
, &control_work_handler
);
2066 unsigned int nr_added_bufs
;
2068 spin_lock_init(&portdev
->c_ivq_lock
);
2069 spin_lock_init(&portdev
->c_ovq_lock
);
2071 nr_added_bufs
= fill_queue(portdev
->c_ivq
,
2072 &portdev
->c_ivq_lock
);
2073 if (!nr_added_bufs
) {
2075 "Error allocating buffers for control queue\n");
2081 * For backward compatibility: Create a console port
2082 * if we're running on older host.
2084 add_port(portdev
, 0);
2087 spin_lock_irq(&pdrvdata_lock
);
2088 list_add_tail(&portdev
->list
, &pdrvdata
.portdevs
);
2089 spin_unlock_irq(&pdrvdata_lock
);
2091 __send_control_msg(portdev
, VIRTIO_CONSOLE_BAD_ID
,
2092 VIRTIO_CONSOLE_DEVICE_READY
, 1);
2095 * If there was an early virtio console, assume that there are no
2096 * other consoles. We need to wait until the hvc_alloc matches the
2097 * hvc_instantiate, otherwise tty_open will complain, resulting in
2098 * a "Warning: unable to open an initial console" boot failure.
2099 * Without multiport this is done in add_port above. With multiport
2100 * this might take some host<->guest communication - thus we have to
2103 if (multiport
&& early
)
2104 wait_for_completion(&early_console_added
);
2109 /* The host might want to notify mgmt sw about device add failure */
2110 __send_control_msg(portdev
, VIRTIO_CONSOLE_BAD_ID
,
2111 VIRTIO_CONSOLE_DEVICE_READY
, 0);
2112 remove_vqs(portdev
);
2114 unregister_chrdev(portdev
->chr_major
, "virtio-portsdev");
2121 static void virtcons_remove(struct virtio_device
*vdev
)
2123 struct ports_device
*portdev
;
2124 struct port
*port
, *port2
;
2126 portdev
= vdev
->priv
;
2128 spin_lock_irq(&pdrvdata_lock
);
2129 list_del(&portdev
->list
);
2130 spin_unlock_irq(&pdrvdata_lock
);
2132 /* Disable interrupts for vqs */
2133 vdev
->config
->reset(vdev
);
2134 /* Finish up work that's lined up */
2135 if (use_multiport(portdev
))
2136 cancel_work_sync(&portdev
->control_work
);
2138 cancel_work_sync(&portdev
->config_work
);
2140 list_for_each_entry_safe(port
, port2
, &portdev
->ports
, list
)
2143 unregister_chrdev(portdev
->chr_major
, "virtio-portsdev");
2146 * When yanking out a device, we immediately lose the
2147 * (device-side) queues. So there's no point in keeping the
2148 * guest side around till we drop our final reference. This
2149 * also means that any ports which are in an open state will
2150 * have to just stop using the port, as the vqs are going
2153 remove_controlq_data(portdev
);
2154 remove_vqs(portdev
);
2158 static struct virtio_device_id id_table
[] = {
2159 { VIRTIO_ID_CONSOLE
, VIRTIO_DEV_ANY_ID
},
2163 static unsigned int features
[] = {
2164 VIRTIO_CONSOLE_F_SIZE
,
2165 VIRTIO_CONSOLE_F_MULTIPORT
,
2168 static struct virtio_device_id rproc_serial_id_table
[] = {
2169 #if IS_ENABLED(CONFIG_REMOTEPROC)
2170 { VIRTIO_ID_RPROC_SERIAL
, VIRTIO_DEV_ANY_ID
},
2175 static unsigned int rproc_serial_features
[] = {
2178 #ifdef CONFIG_PM_SLEEP
2179 static int virtcons_freeze(struct virtio_device
*vdev
)
2181 struct ports_device
*portdev
;
2184 portdev
= vdev
->priv
;
2186 vdev
->config
->reset(vdev
);
2188 virtqueue_disable_cb(portdev
->c_ivq
);
2189 cancel_work_sync(&portdev
->control_work
);
2190 cancel_work_sync(&portdev
->config_work
);
2192 * Once more: if control_work_handler() was running, it would
2193 * enable the cb as the last step.
2195 virtqueue_disable_cb(portdev
->c_ivq
);
2196 remove_controlq_data(portdev
);
2198 list_for_each_entry(port
, &portdev
->ports
, list
) {
2199 virtqueue_disable_cb(port
->in_vq
);
2200 virtqueue_disable_cb(port
->out_vq
);
2202 * We'll ask the host later if the new invocation has
2203 * the port opened or closed.
2205 port
->host_connected
= false;
2206 remove_port_data(port
);
2208 remove_vqs(portdev
);
2213 static int virtcons_restore(struct virtio_device
*vdev
)
2215 struct ports_device
*portdev
;
2219 portdev
= vdev
->priv
;
2221 ret
= init_vqs(portdev
);
2225 virtio_device_ready(portdev
->vdev
);
2227 if (use_multiport(portdev
))
2228 fill_queue(portdev
->c_ivq
, &portdev
->c_ivq_lock
);
2230 list_for_each_entry(port
, &portdev
->ports
, list
) {
2231 port
->in_vq
= portdev
->in_vqs
[port
->id
];
2232 port
->out_vq
= portdev
->out_vqs
[port
->id
];
2234 fill_queue(port
->in_vq
, &port
->inbuf_lock
);
2236 /* Get port open/close status on the host */
2237 send_control_msg(port
, VIRTIO_CONSOLE_PORT_READY
, 1);
2240 * If a port was open at the time of suspending, we
2241 * have to let the host know that it's still open.
2243 if (port
->guest_connected
)
2244 send_control_msg(port
, VIRTIO_CONSOLE_PORT_OPEN
, 1);
2250 static struct virtio_driver virtio_console
= {
2251 .feature_table
= features
,
2252 .feature_table_size
= ARRAY_SIZE(features
),
2253 .driver
.name
= KBUILD_MODNAME
,
2254 .driver
.owner
= THIS_MODULE
,
2255 .id_table
= id_table
,
2256 .probe
= virtcons_probe
,
2257 .remove
= virtcons_remove
,
2258 .config_changed
= config_intr
,
2259 #ifdef CONFIG_PM_SLEEP
2260 .freeze
= virtcons_freeze
,
2261 .restore
= virtcons_restore
,
2265 static struct virtio_driver virtio_rproc_serial
= {
2266 .feature_table
= rproc_serial_features
,
2267 .feature_table_size
= ARRAY_SIZE(rproc_serial_features
),
2268 .driver
.name
= "virtio_rproc_serial",
2269 .driver
.owner
= THIS_MODULE
,
2270 .id_table
= rproc_serial_id_table
,
2271 .probe
= virtcons_probe
,
2272 .remove
= virtcons_remove
,
2275 static int __init
init(void)
2279 pdrvdata
.class = class_create(THIS_MODULE
, "virtio-ports");
2280 if (IS_ERR(pdrvdata
.class)) {
2281 err
= PTR_ERR(pdrvdata
.class);
2282 pr_err("Error %d creating virtio-ports class\n", err
);
2286 pdrvdata
.debugfs_dir
= debugfs_create_dir("virtio-ports", NULL
);
2287 if (!pdrvdata
.debugfs_dir
)
2288 pr_warning("Error creating debugfs dir for virtio-ports\n");
2289 INIT_LIST_HEAD(&pdrvdata
.consoles
);
2290 INIT_LIST_HEAD(&pdrvdata
.portdevs
);
2292 err
= register_virtio_driver(&virtio_console
);
2294 pr_err("Error %d registering virtio driver\n", err
);
2297 err
= register_virtio_driver(&virtio_rproc_serial
);
2299 pr_err("Error %d registering virtio rproc serial driver\n",
2305 unregister_virtio_driver(&virtio_console
);
2307 debugfs_remove_recursive(pdrvdata
.debugfs_dir
);
2308 class_destroy(pdrvdata
.class);
2312 static void __exit
fini(void)
2316 unregister_virtio_driver(&virtio_console
);
2317 unregister_virtio_driver(&virtio_rproc_serial
);
2319 class_destroy(pdrvdata
.class);
2320 debugfs_remove_recursive(pdrvdata
.debugfs_dir
);
2325 MODULE_DEVICE_TABLE(virtio
, id_table
);
2326 MODULE_DESCRIPTION("Virtio console driver");
2327 MODULE_LICENSE("GPL");