1 /* Copyright (C) 2009 Red Hat, Inc.
2 * Copyright (C) 2006 Rusty Russell IBM Corporation
4 * Author: Michael S. Tsirkin <mst@redhat.com>
6 * Inspiration, some code, and most witty comments come from
7 * Documentation/virtual/lguest/lguest.c, by Rusty Russell
9 * This work is licensed under the terms of the GNU GPL, version 2.
11 * Generic code for virtio server in host kernel.
14 #include <linux/eventfd.h>
15 #include <linux/vhost.h>
16 #include <linux/uio.h>
18 #include <linux/mmu_context.h>
19 #include <linux/miscdevice.h>
20 #include <linux/mutex.h>
21 #include <linux/poll.h>
22 #include <linux/file.h>
23 #include <linux/highmem.h>
24 #include <linux/slab.h>
25 #include <linux/vmalloc.h>
26 #include <linux/kthread.h>
27 #include <linux/cgroup.h>
28 #include <linux/module.h>
29 #include <linux/sort.h>
30 #include <linux/sched/mm.h>
31 #include <linux/sched/signal.h>
32 #include <linux/interval_tree_generic.h>
36 static ushort max_mem_regions
= 64;
37 module_param(max_mem_regions
, ushort
, 0444);
38 MODULE_PARM_DESC(max_mem_regions
,
39 "Maximum number of memory regions in memory map. (default: 64)");
40 static int max_iotlb_entries
= 2048;
41 module_param(max_iotlb_entries
, int, 0444);
42 MODULE_PARM_DESC(max_iotlb_entries
,
43 "Maximum number of iotlb entries. (default: 2048)");
46 VHOST_MEMORY_F_LOG
= 0x1,
49 #define vhost_used_event(vq) ((__virtio16 __user *)&vq->avail->ring[vq->num])
50 #define vhost_avail_event(vq) ((__virtio16 __user *)&vq->used->ring[vq->num])
52 INTERVAL_TREE_DEFINE(struct vhost_umem_node
,
53 rb
, __u64
, __subtree_last
,
54 START
, LAST
, static inline, vhost_umem_interval_tree
);
56 #ifdef CONFIG_VHOST_CROSS_ENDIAN_LEGACY
57 static void vhost_disable_cross_endian(struct vhost_virtqueue
*vq
)
59 vq
->user_be
= !virtio_legacy_is_little_endian();
62 static void vhost_enable_cross_endian_big(struct vhost_virtqueue
*vq
)
67 static void vhost_enable_cross_endian_little(struct vhost_virtqueue
*vq
)
72 static long vhost_set_vring_endian(struct vhost_virtqueue
*vq
, int __user
*argp
)
74 struct vhost_vring_state s
;
79 if (copy_from_user(&s
, argp
, sizeof(s
)))
82 if (s
.num
!= VHOST_VRING_LITTLE_ENDIAN
&&
83 s
.num
!= VHOST_VRING_BIG_ENDIAN
)
86 if (s
.num
== VHOST_VRING_BIG_ENDIAN
)
87 vhost_enable_cross_endian_big(vq
);
89 vhost_enable_cross_endian_little(vq
);
94 static long vhost_get_vring_endian(struct vhost_virtqueue
*vq
, u32 idx
,
97 struct vhost_vring_state s
= {
102 if (copy_to_user(argp
, &s
, sizeof(s
)))
108 static void vhost_init_is_le(struct vhost_virtqueue
*vq
)
110 /* Note for legacy virtio: user_be is initialized at reset time
111 * according to the host endianness. If userspace does not set an
112 * explicit endianness, the default behavior is native endian, as
113 * expected by legacy virtio.
115 vq
->is_le
= vhost_has_feature(vq
, VIRTIO_F_VERSION_1
) || !vq
->user_be
;
118 static void vhost_disable_cross_endian(struct vhost_virtqueue
*vq
)
122 static long vhost_set_vring_endian(struct vhost_virtqueue
*vq
, int __user
*argp
)
127 static long vhost_get_vring_endian(struct vhost_virtqueue
*vq
, u32 idx
,
133 static void vhost_init_is_le(struct vhost_virtqueue
*vq
)
135 vq
->is_le
= vhost_has_feature(vq
, VIRTIO_F_VERSION_1
)
136 || virtio_legacy_is_little_endian();
138 #endif /* CONFIG_VHOST_CROSS_ENDIAN_LEGACY */
140 static void vhost_reset_is_le(struct vhost_virtqueue
*vq
)
142 vhost_init_is_le(vq
);
145 struct vhost_flush_struct
{
146 struct vhost_work work
;
147 struct completion wait_event
;
150 static void vhost_flush_work(struct vhost_work
*work
)
152 struct vhost_flush_struct
*s
;
154 s
= container_of(work
, struct vhost_flush_struct
, work
);
155 complete(&s
->wait_event
);
158 static void vhost_poll_func(struct file
*file
, wait_queue_head_t
*wqh
,
161 struct vhost_poll
*poll
;
163 poll
= container_of(pt
, struct vhost_poll
, table
);
165 add_wait_queue(wqh
, &poll
->wait
);
168 static int vhost_poll_wakeup(wait_queue_t
*wait
, unsigned mode
, int sync
,
171 struct vhost_poll
*poll
= container_of(wait
, struct vhost_poll
, wait
);
173 if (!((unsigned long)key
& poll
->mask
))
176 vhost_poll_queue(poll
);
180 void vhost_work_init(struct vhost_work
*work
, vhost_work_fn_t fn
)
182 clear_bit(VHOST_WORK_QUEUED
, &work
->flags
);
184 init_waitqueue_head(&work
->done
);
186 EXPORT_SYMBOL_GPL(vhost_work_init
);
188 /* Init poll structure */
189 void vhost_poll_init(struct vhost_poll
*poll
, vhost_work_fn_t fn
,
190 unsigned long mask
, struct vhost_dev
*dev
)
192 init_waitqueue_func_entry(&poll
->wait
, vhost_poll_wakeup
);
193 init_poll_funcptr(&poll
->table
, vhost_poll_func
);
198 vhost_work_init(&poll
->work
, fn
);
200 EXPORT_SYMBOL_GPL(vhost_poll_init
);
202 /* Start polling a file. We add ourselves to file's wait queue. The caller must
203 * keep a reference to a file until after vhost_poll_stop is called. */
204 int vhost_poll_start(struct vhost_poll
*poll
, struct file
*file
)
212 mask
= file
->f_op
->poll(file
, &poll
->table
);
214 vhost_poll_wakeup(&poll
->wait
, 0, 0, (void *)mask
);
215 if (mask
& POLLERR
) {
217 remove_wait_queue(poll
->wqh
, &poll
->wait
);
223 EXPORT_SYMBOL_GPL(vhost_poll_start
);
225 /* Stop polling a file. After this function returns, it becomes safe to drop the
226 * file reference. You must also flush afterwards. */
227 void vhost_poll_stop(struct vhost_poll
*poll
)
230 remove_wait_queue(poll
->wqh
, &poll
->wait
);
234 EXPORT_SYMBOL_GPL(vhost_poll_stop
);
236 void vhost_work_flush(struct vhost_dev
*dev
, struct vhost_work
*work
)
238 struct vhost_flush_struct flush
;
241 init_completion(&flush
.wait_event
);
242 vhost_work_init(&flush
.work
, vhost_flush_work
);
244 vhost_work_queue(dev
, &flush
.work
);
245 wait_for_completion(&flush
.wait_event
);
248 EXPORT_SYMBOL_GPL(vhost_work_flush
);
250 /* Flush any work that has been scheduled. When calling this, don't hold any
251 * locks that are also used by the callback. */
252 void vhost_poll_flush(struct vhost_poll
*poll
)
254 vhost_work_flush(poll
->dev
, &poll
->work
);
256 EXPORT_SYMBOL_GPL(vhost_poll_flush
);
258 void vhost_work_queue(struct vhost_dev
*dev
, struct vhost_work
*work
)
263 if (!test_and_set_bit(VHOST_WORK_QUEUED
, &work
->flags
)) {
264 /* We can only add the work to the list after we're
265 * sure it was not in the list.
266 * test_and_set_bit() implies a memory barrier.
268 llist_add(&work
->node
, &dev
->work_list
);
269 wake_up_process(dev
->worker
);
272 EXPORT_SYMBOL_GPL(vhost_work_queue
);
274 /* A lockless hint for busy polling code to exit the loop */
275 bool vhost_has_work(struct vhost_dev
*dev
)
277 return !llist_empty(&dev
->work_list
);
279 EXPORT_SYMBOL_GPL(vhost_has_work
);
281 void vhost_poll_queue(struct vhost_poll
*poll
)
283 vhost_work_queue(poll
->dev
, &poll
->work
);
285 EXPORT_SYMBOL_GPL(vhost_poll_queue
);
287 static void __vhost_vq_meta_reset(struct vhost_virtqueue
*vq
)
291 for (j
= 0; j
< VHOST_NUM_ADDRS
; j
++)
292 vq
->meta_iotlb
[j
] = NULL
;
295 static void vhost_vq_meta_reset(struct vhost_dev
*d
)
299 for (i
= 0; i
< d
->nvqs
; ++i
)
300 __vhost_vq_meta_reset(d
->vqs
[i
]);
303 static void vhost_vq_reset(struct vhost_dev
*dev
,
304 struct vhost_virtqueue
*vq
)
310 vq
->last_avail_idx
= 0;
311 vq
->last_used_event
= 0;
313 vq
->last_used_idx
= 0;
314 vq
->signalled_used
= 0;
315 vq
->signalled_used_valid
= false;
317 vq
->log_used
= false;
318 vq
->log_addr
= -1ull;
319 vq
->private_data
= NULL
;
320 vq
->acked_features
= 0;
322 vq
->error_ctx
= NULL
;
328 vhost_reset_is_le(vq
);
329 vhost_disable_cross_endian(vq
);
330 vq
->busyloop_timeout
= 0;
333 __vhost_vq_meta_reset(vq
);
336 static int vhost_worker(void *data
)
338 struct vhost_dev
*dev
= data
;
339 struct vhost_work
*work
, *work_next
;
340 struct llist_node
*node
;
341 mm_segment_t oldfs
= get_fs();
347 /* mb paired w/ kthread_stop */
348 set_current_state(TASK_INTERRUPTIBLE
);
350 if (kthread_should_stop()) {
351 __set_current_state(TASK_RUNNING
);
355 node
= llist_del_all(&dev
->work_list
);
359 node
= llist_reverse_order(node
);
360 /* make sure flag is seen after deletion */
362 llist_for_each_entry_safe(work
, work_next
, node
, node
) {
363 clear_bit(VHOST_WORK_QUEUED
, &work
->flags
);
364 __set_current_state(TASK_RUNNING
);
375 static void vhost_vq_free_iovecs(struct vhost_virtqueue
*vq
)
385 /* Helper to allocate iovec buffers for all vqs. */
386 static long vhost_dev_alloc_iovecs(struct vhost_dev
*dev
)
388 struct vhost_virtqueue
*vq
;
391 for (i
= 0; i
< dev
->nvqs
; ++i
) {
393 vq
->indirect
= kmalloc(sizeof *vq
->indirect
* UIO_MAXIOV
,
395 vq
->log
= kmalloc(sizeof *vq
->log
* UIO_MAXIOV
, GFP_KERNEL
);
396 vq
->heads
= kmalloc(sizeof *vq
->heads
* UIO_MAXIOV
, GFP_KERNEL
);
397 if (!vq
->indirect
|| !vq
->log
|| !vq
->heads
)
404 vhost_vq_free_iovecs(dev
->vqs
[i
]);
408 static void vhost_dev_free_iovecs(struct vhost_dev
*dev
)
412 for (i
= 0; i
< dev
->nvqs
; ++i
)
413 vhost_vq_free_iovecs(dev
->vqs
[i
]);
416 void vhost_dev_init(struct vhost_dev
*dev
,
417 struct vhost_virtqueue
**vqs
, int nvqs
)
419 struct vhost_virtqueue
*vq
;
424 mutex_init(&dev
->mutex
);
426 dev
->log_file
= NULL
;
431 init_llist_head(&dev
->work_list
);
432 init_waitqueue_head(&dev
->wait
);
433 INIT_LIST_HEAD(&dev
->read_list
);
434 INIT_LIST_HEAD(&dev
->pending_list
);
435 spin_lock_init(&dev
->iotlb_lock
);
438 for (i
= 0; i
< dev
->nvqs
; ++i
) {
444 mutex_init(&vq
->mutex
);
445 vhost_vq_reset(dev
, vq
);
447 vhost_poll_init(&vq
->poll
, vq
->handle_kick
,
451 EXPORT_SYMBOL_GPL(vhost_dev_init
);
453 /* Caller should have device mutex */
454 long vhost_dev_check_owner(struct vhost_dev
*dev
)
456 /* Are you the owner? If not, I don't think you mean to do that */
457 return dev
->mm
== current
->mm
? 0 : -EPERM
;
459 EXPORT_SYMBOL_GPL(vhost_dev_check_owner
);
461 struct vhost_attach_cgroups_struct
{
462 struct vhost_work work
;
463 struct task_struct
*owner
;
467 static void vhost_attach_cgroups_work(struct vhost_work
*work
)
469 struct vhost_attach_cgroups_struct
*s
;
471 s
= container_of(work
, struct vhost_attach_cgroups_struct
, work
);
472 s
->ret
= cgroup_attach_task_all(s
->owner
, current
);
475 static int vhost_attach_cgroups(struct vhost_dev
*dev
)
477 struct vhost_attach_cgroups_struct attach
;
479 attach
.owner
= current
;
480 vhost_work_init(&attach
.work
, vhost_attach_cgroups_work
);
481 vhost_work_queue(dev
, &attach
.work
);
482 vhost_work_flush(dev
, &attach
.work
);
486 /* Caller should have device mutex */
487 bool vhost_dev_has_owner(struct vhost_dev
*dev
)
491 EXPORT_SYMBOL_GPL(vhost_dev_has_owner
);
493 /* Caller should have device mutex */
494 long vhost_dev_set_owner(struct vhost_dev
*dev
)
496 struct task_struct
*worker
;
499 /* Is there an owner already? */
500 if (vhost_dev_has_owner(dev
)) {
505 /* No owner, become one */
506 dev
->mm
= get_task_mm(current
);
507 worker
= kthread_create(vhost_worker
, dev
, "vhost-%d", current
->pid
);
508 if (IS_ERR(worker
)) {
509 err
= PTR_ERR(worker
);
513 dev
->worker
= worker
;
514 wake_up_process(worker
); /* avoid contributing to loadavg */
516 err
= vhost_attach_cgroups(dev
);
520 err
= vhost_dev_alloc_iovecs(dev
);
526 kthread_stop(worker
);
535 EXPORT_SYMBOL_GPL(vhost_dev_set_owner
);
537 static void *vhost_kvzalloc(unsigned long size
)
539 void *n
= kzalloc(size
, GFP_KERNEL
| __GFP_NOWARN
| __GFP_REPEAT
);
546 struct vhost_umem
*vhost_dev_reset_owner_prepare(void)
548 return vhost_kvzalloc(sizeof(struct vhost_umem
));
550 EXPORT_SYMBOL_GPL(vhost_dev_reset_owner_prepare
);
552 /* Caller should have device mutex */
553 void vhost_dev_reset_owner(struct vhost_dev
*dev
, struct vhost_umem
*umem
)
557 vhost_dev_cleanup(dev
, true);
559 /* Restore memory to default empty mapping. */
560 INIT_LIST_HEAD(&umem
->umem_list
);
562 /* We don't need VQ locks below since vhost_dev_cleanup makes sure
563 * VQs aren't running.
565 for (i
= 0; i
< dev
->nvqs
; ++i
)
566 dev
->vqs
[i
]->umem
= umem
;
568 EXPORT_SYMBOL_GPL(vhost_dev_reset_owner
);
570 void vhost_dev_stop(struct vhost_dev
*dev
)
574 for (i
= 0; i
< dev
->nvqs
; ++i
) {
575 if (dev
->vqs
[i
]->kick
&& dev
->vqs
[i
]->handle_kick
) {
576 vhost_poll_stop(&dev
->vqs
[i
]->poll
);
577 vhost_poll_flush(&dev
->vqs
[i
]->poll
);
581 EXPORT_SYMBOL_GPL(vhost_dev_stop
);
583 static void vhost_umem_free(struct vhost_umem
*umem
,
584 struct vhost_umem_node
*node
)
586 vhost_umem_interval_tree_remove(node
, &umem
->umem_tree
);
587 list_del(&node
->link
);
592 static void vhost_umem_clean(struct vhost_umem
*umem
)
594 struct vhost_umem_node
*node
, *tmp
;
599 list_for_each_entry_safe(node
, tmp
, &umem
->umem_list
, link
)
600 vhost_umem_free(umem
, node
);
605 static void vhost_clear_msg(struct vhost_dev
*dev
)
607 struct vhost_msg_node
*node
, *n
;
609 spin_lock(&dev
->iotlb_lock
);
611 list_for_each_entry_safe(node
, n
, &dev
->read_list
, node
) {
612 list_del(&node
->node
);
616 list_for_each_entry_safe(node
, n
, &dev
->pending_list
, node
) {
617 list_del(&node
->node
);
621 spin_unlock(&dev
->iotlb_lock
);
624 /* Caller should have device mutex if and only if locked is set */
625 void vhost_dev_cleanup(struct vhost_dev
*dev
, bool locked
)
629 for (i
= 0; i
< dev
->nvqs
; ++i
) {
630 if (dev
->vqs
[i
]->error_ctx
)
631 eventfd_ctx_put(dev
->vqs
[i
]->error_ctx
);
632 if (dev
->vqs
[i
]->error
)
633 fput(dev
->vqs
[i
]->error
);
634 if (dev
->vqs
[i
]->kick
)
635 fput(dev
->vqs
[i
]->kick
);
636 if (dev
->vqs
[i
]->call_ctx
)
637 eventfd_ctx_put(dev
->vqs
[i
]->call_ctx
);
638 if (dev
->vqs
[i
]->call
)
639 fput(dev
->vqs
[i
]->call
);
640 vhost_vq_reset(dev
, dev
->vqs
[i
]);
642 vhost_dev_free_iovecs(dev
);
644 eventfd_ctx_put(dev
->log_ctx
);
648 dev
->log_file
= NULL
;
649 /* No one will access memory at this point */
650 vhost_umem_clean(dev
->umem
);
652 vhost_umem_clean(dev
->iotlb
);
654 vhost_clear_msg(dev
);
655 wake_up_interruptible_poll(&dev
->wait
, POLLIN
| POLLRDNORM
);
656 WARN_ON(!llist_empty(&dev
->work_list
));
658 kthread_stop(dev
->worker
);
665 EXPORT_SYMBOL_GPL(vhost_dev_cleanup
);
667 static int log_access_ok(void __user
*log_base
, u64 addr
, unsigned long sz
)
669 u64 a
= addr
/ VHOST_PAGE_SIZE
/ 8;
671 /* Make sure 64 bit math will not overflow. */
672 if (a
> ULONG_MAX
- (unsigned long)log_base
||
673 a
+ (unsigned long)log_base
> ULONG_MAX
)
676 return access_ok(VERIFY_WRITE
, log_base
+ a
,
677 (sz
+ VHOST_PAGE_SIZE
* 8 - 1) / VHOST_PAGE_SIZE
/ 8);
680 static bool vhost_overflow(u64 uaddr
, u64 size
)
682 /* Make sure 64 bit math will not overflow. */
683 return uaddr
> ULONG_MAX
|| size
> ULONG_MAX
|| uaddr
> ULONG_MAX
- size
;
686 /* Caller should have vq mutex and device mutex. */
687 static int vq_memory_access_ok(void __user
*log_base
, struct vhost_umem
*umem
,
690 struct vhost_umem_node
*node
;
695 list_for_each_entry(node
, &umem
->umem_list
, link
) {
696 unsigned long a
= node
->userspace_addr
;
698 if (vhost_overflow(node
->userspace_addr
, node
->size
))
702 if (!access_ok(VERIFY_WRITE
, (void __user
*)a
,
705 else if (log_all
&& !log_access_ok(log_base
,
713 static inline void __user
*vhost_vq_meta_fetch(struct vhost_virtqueue
*vq
,
714 u64 addr
, unsigned int size
,
717 const struct vhost_umem_node
*node
= vq
->meta_iotlb
[type
];
722 return (void *)(uintptr_t)(node
->userspace_addr
+ addr
- node
->start
);
725 /* Can we switch to this memory table? */
726 /* Caller should have device mutex but not vq mutex */
727 static int memory_access_ok(struct vhost_dev
*d
, struct vhost_umem
*umem
,
732 for (i
= 0; i
< d
->nvqs
; ++i
) {
736 mutex_lock(&d
->vqs
[i
]->mutex
);
737 log
= log_all
|| vhost_has_feature(d
->vqs
[i
], VHOST_F_LOG_ALL
);
738 /* If ring is inactive, will check when it's enabled. */
739 if (d
->vqs
[i
]->private_data
)
740 ok
= vq_memory_access_ok(d
->vqs
[i
]->log_base
,
744 mutex_unlock(&d
->vqs
[i
]->mutex
);
751 static int translate_desc(struct vhost_virtqueue
*vq
, u64 addr
, u32 len
,
752 struct iovec iov
[], int iov_size
, int access
);
754 static int vhost_copy_to_user(struct vhost_virtqueue
*vq
, void __user
*to
,
755 const void *from
, unsigned size
)
760 return __copy_to_user(to
, from
, size
);
762 /* This function should be called after iotlb
763 * prefetch, which means we're sure that all vq
764 * could be access through iotlb. So -EAGAIN should
765 * not happen in this case.
768 void __user
*uaddr
= vhost_vq_meta_fetch(vq
,
769 (u64
)(uintptr_t)to
, size
,
773 return __copy_to_user(uaddr
, from
, size
);
775 ret
= translate_desc(vq
, (u64
)(uintptr_t)to
, size
, vq
->iotlb_iov
,
776 ARRAY_SIZE(vq
->iotlb_iov
),
780 iov_iter_init(&t
, WRITE
, vq
->iotlb_iov
, ret
, size
);
781 ret
= copy_to_iter(from
, size
, &t
);
789 static int vhost_copy_from_user(struct vhost_virtqueue
*vq
, void *to
,
790 void __user
*from
, unsigned size
)
795 return __copy_from_user(to
, from
, size
);
797 /* This function should be called after iotlb
798 * prefetch, which means we're sure that vq
799 * could be access through iotlb. So -EAGAIN should
800 * not happen in this case.
802 void __user
*uaddr
= vhost_vq_meta_fetch(vq
,
803 (u64
)(uintptr_t)from
, size
,
808 return __copy_from_user(to
, uaddr
, size
);
810 ret
= translate_desc(vq
, (u64
)(uintptr_t)from
, size
, vq
->iotlb_iov
,
811 ARRAY_SIZE(vq
->iotlb_iov
),
814 vq_err(vq
, "IOTLB translation failure: uaddr "
815 "%p size 0x%llx\n", from
,
816 (unsigned long long) size
);
819 iov_iter_init(&f
, READ
, vq
->iotlb_iov
, ret
, size
);
820 ret
= copy_from_iter(to
, size
, &f
);
829 static void __user
*__vhost_get_user_slow(struct vhost_virtqueue
*vq
,
830 void __user
*addr
, unsigned int size
,
835 ret
= translate_desc(vq
, (u64
)(uintptr_t)addr
, size
, vq
->iotlb_iov
,
836 ARRAY_SIZE(vq
->iotlb_iov
),
839 vq_err(vq
, "IOTLB translation failure: uaddr "
840 "%p size 0x%llx\n", addr
,
841 (unsigned long long) size
);
845 if (ret
!= 1 || vq
->iotlb_iov
[0].iov_len
!= size
) {
846 vq_err(vq
, "Non atomic userspace memory access: uaddr "
847 "%p size 0x%llx\n", addr
,
848 (unsigned long long) size
);
852 return vq
->iotlb_iov
[0].iov_base
;
855 /* This function should be called after iotlb
856 * prefetch, which means we're sure that vq
857 * could be access through iotlb. So -EAGAIN should
858 * not happen in this case.
860 static inline void __user
*__vhost_get_user(struct vhost_virtqueue
*vq
,
861 void *addr
, unsigned int size
,
864 void __user
*uaddr
= vhost_vq_meta_fetch(vq
,
865 (u64
)(uintptr_t)addr
, size
, type
);
869 return __vhost_get_user_slow(vq
, addr
, size
, type
);
872 #define vhost_put_user(vq, x, ptr) \
876 ret = __put_user(x, ptr); \
878 __typeof__(ptr) to = \
879 (__typeof__(ptr)) __vhost_get_user(vq, ptr, \
880 sizeof(*ptr), VHOST_ADDR_USED); \
882 ret = __put_user(x, to); \
889 #define vhost_get_user(vq, x, ptr, type) \
893 ret = __get_user(x, ptr); \
895 __typeof__(ptr) from = \
896 (__typeof__(ptr)) __vhost_get_user(vq, ptr, \
900 ret = __get_user(x, from); \
907 #define vhost_get_avail(vq, x, ptr) \
908 vhost_get_user(vq, x, ptr, VHOST_ADDR_AVAIL)
910 #define vhost_get_used(vq, x, ptr) \
911 vhost_get_user(vq, x, ptr, VHOST_ADDR_USED)
913 static void vhost_dev_lock_vqs(struct vhost_dev
*d
)
916 for (i
= 0; i
< d
->nvqs
; ++i
)
917 mutex_lock(&d
->vqs
[i
]->mutex
);
920 static void vhost_dev_unlock_vqs(struct vhost_dev
*d
)
923 for (i
= 0; i
< d
->nvqs
; ++i
)
924 mutex_unlock(&d
->vqs
[i
]->mutex
);
927 static int vhost_new_umem_range(struct vhost_umem
*umem
,
928 u64 start
, u64 size
, u64 end
,
929 u64 userspace_addr
, int perm
)
931 struct vhost_umem_node
*tmp
, *node
= kmalloc(sizeof(*node
), GFP_ATOMIC
);
936 if (umem
->numem
== max_iotlb_entries
) {
937 tmp
= list_first_entry(&umem
->umem_list
, typeof(*tmp
), link
);
938 vhost_umem_free(umem
, tmp
);
944 node
->userspace_addr
= userspace_addr
;
946 INIT_LIST_HEAD(&node
->link
);
947 list_add_tail(&node
->link
, &umem
->umem_list
);
948 vhost_umem_interval_tree_insert(node
, &umem
->umem_tree
);
954 static void vhost_del_umem_range(struct vhost_umem
*umem
,
957 struct vhost_umem_node
*node
;
959 while ((node
= vhost_umem_interval_tree_iter_first(&umem
->umem_tree
,
961 vhost_umem_free(umem
, node
);
964 static void vhost_iotlb_notify_vq(struct vhost_dev
*d
,
965 struct vhost_iotlb_msg
*msg
)
967 struct vhost_msg_node
*node
, *n
;
969 spin_lock(&d
->iotlb_lock
);
971 list_for_each_entry_safe(node
, n
, &d
->pending_list
, node
) {
972 struct vhost_iotlb_msg
*vq_msg
= &node
->msg
.iotlb
;
973 if (msg
->iova
<= vq_msg
->iova
&&
974 msg
->iova
+ msg
->size
- 1 > vq_msg
->iova
&&
975 vq_msg
->type
== VHOST_IOTLB_MISS
) {
976 vhost_poll_queue(&node
->vq
->poll
);
977 list_del(&node
->node
);
982 spin_unlock(&d
->iotlb_lock
);
985 static int umem_access_ok(u64 uaddr
, u64 size
, int access
)
987 unsigned long a
= uaddr
;
989 /* Make sure 64 bit math will not overflow. */
990 if (vhost_overflow(uaddr
, size
))
993 if ((access
& VHOST_ACCESS_RO
) &&
994 !access_ok(VERIFY_READ
, (void __user
*)a
, size
))
996 if ((access
& VHOST_ACCESS_WO
) &&
997 !access_ok(VERIFY_WRITE
, (void __user
*)a
, size
))
1002 static int vhost_process_iotlb_msg(struct vhost_dev
*dev
,
1003 struct vhost_iotlb_msg
*msg
)
1007 vhost_dev_lock_vqs(dev
);
1008 switch (msg
->type
) {
1009 case VHOST_IOTLB_UPDATE
:
1014 if (umem_access_ok(msg
->uaddr
, msg
->size
, msg
->perm
)) {
1018 vhost_vq_meta_reset(dev
);
1019 if (vhost_new_umem_range(dev
->iotlb
, msg
->iova
, msg
->size
,
1020 msg
->iova
+ msg
->size
- 1,
1021 msg
->uaddr
, msg
->perm
)) {
1025 vhost_iotlb_notify_vq(dev
, msg
);
1027 case VHOST_IOTLB_INVALIDATE
:
1028 vhost_vq_meta_reset(dev
);
1029 vhost_del_umem_range(dev
->iotlb
, msg
->iova
,
1030 msg
->iova
+ msg
->size
- 1);
1037 vhost_dev_unlock_vqs(dev
);
1040 ssize_t
vhost_chr_write_iter(struct vhost_dev
*dev
,
1041 struct iov_iter
*from
)
1043 struct vhost_msg_node node
;
1044 unsigned size
= sizeof(struct vhost_msg
);
1048 if (iov_iter_count(from
) < size
)
1050 ret
= copy_from_iter(&node
.msg
, size
, from
);
1054 switch (node
.msg
.type
) {
1055 case VHOST_IOTLB_MSG
:
1056 err
= vhost_process_iotlb_msg(dev
, &node
.msg
.iotlb
);
1068 EXPORT_SYMBOL(vhost_chr_write_iter
);
1070 unsigned int vhost_chr_poll(struct file
*file
, struct vhost_dev
*dev
,
1073 unsigned int mask
= 0;
1075 poll_wait(file
, &dev
->wait
, wait
);
1077 if (!list_empty(&dev
->read_list
))
1078 mask
|= POLLIN
| POLLRDNORM
;
1082 EXPORT_SYMBOL(vhost_chr_poll
);
1084 ssize_t
vhost_chr_read_iter(struct vhost_dev
*dev
, struct iov_iter
*to
,
1088 struct vhost_msg_node
*node
;
1090 unsigned size
= sizeof(struct vhost_msg
);
1092 if (iov_iter_count(to
) < size
)
1097 prepare_to_wait(&dev
->wait
, &wait
,
1098 TASK_INTERRUPTIBLE
);
1100 node
= vhost_dequeue_msg(dev
, &dev
->read_list
);
1107 if (signal_pending(current
)) {
1120 finish_wait(&dev
->wait
, &wait
);
1123 ret
= copy_to_iter(&node
->msg
, size
, to
);
1125 if (ret
!= size
|| node
->msg
.type
!= VHOST_IOTLB_MISS
) {
1130 vhost_enqueue_msg(dev
, &dev
->pending_list
, node
);
1135 EXPORT_SYMBOL_GPL(vhost_chr_read_iter
);
1137 static int vhost_iotlb_miss(struct vhost_virtqueue
*vq
, u64 iova
, int access
)
1139 struct vhost_dev
*dev
= vq
->dev
;
1140 struct vhost_msg_node
*node
;
1141 struct vhost_iotlb_msg
*msg
;
1143 node
= vhost_new_msg(vq
, VHOST_IOTLB_MISS
);
1147 msg
= &node
->msg
.iotlb
;
1148 msg
->type
= VHOST_IOTLB_MISS
;
1152 vhost_enqueue_msg(dev
, &dev
->read_list
, node
);
1157 static int vq_access_ok(struct vhost_virtqueue
*vq
, unsigned int num
,
1158 struct vring_desc __user
*desc
,
1159 struct vring_avail __user
*avail
,
1160 struct vring_used __user
*used
)
1163 size_t s
= vhost_has_feature(vq
, VIRTIO_RING_F_EVENT_IDX
) ? 2 : 0;
1165 return access_ok(VERIFY_READ
, desc
, num
* sizeof *desc
) &&
1166 access_ok(VERIFY_READ
, avail
,
1167 sizeof *avail
+ num
* sizeof *avail
->ring
+ s
) &&
1168 access_ok(VERIFY_WRITE
, used
,
1169 sizeof *used
+ num
* sizeof *used
->ring
+ s
);
1172 static void vhost_vq_meta_update(struct vhost_virtqueue
*vq
,
1173 const struct vhost_umem_node
*node
,
1176 int access
= (type
== VHOST_ADDR_USED
) ?
1177 VHOST_ACCESS_WO
: VHOST_ACCESS_RO
;
1179 if (likely(node
->perm
& access
))
1180 vq
->meta_iotlb
[type
] = node
;
1183 static int iotlb_access_ok(struct vhost_virtqueue
*vq
,
1184 int access
, u64 addr
, u64 len
, int type
)
1186 const struct vhost_umem_node
*node
;
1187 struct vhost_umem
*umem
= vq
->iotlb
;
1188 u64 s
= 0, size
, orig_addr
= addr
;
1190 if (vhost_vq_meta_fetch(vq
, addr
, len
, type
))
1194 node
= vhost_umem_interval_tree_iter_first(&umem
->umem_tree
,
1197 if (node
== NULL
|| node
->start
> addr
) {
1198 vhost_iotlb_miss(vq
, addr
, access
);
1200 } else if (!(node
->perm
& access
)) {
1201 /* Report the possible access violation by
1202 * request another translation from userspace.
1207 size
= node
->size
- addr
+ node
->start
;
1209 if (orig_addr
== addr
&& size
>= len
)
1210 vhost_vq_meta_update(vq
, node
, type
);
1219 int vq_iotlb_prefetch(struct vhost_virtqueue
*vq
)
1221 size_t s
= vhost_has_feature(vq
, VIRTIO_RING_F_EVENT_IDX
) ? 2 : 0;
1222 unsigned int num
= vq
->num
;
1227 return iotlb_access_ok(vq
, VHOST_ACCESS_RO
, (u64
)(uintptr_t)vq
->desc
,
1228 num
* sizeof(*vq
->desc
), VHOST_ADDR_DESC
) &&
1229 iotlb_access_ok(vq
, VHOST_ACCESS_RO
, (u64
)(uintptr_t)vq
->avail
,
1231 num
* sizeof(*vq
->avail
->ring
) + s
,
1232 VHOST_ADDR_AVAIL
) &&
1233 iotlb_access_ok(vq
, VHOST_ACCESS_WO
, (u64
)(uintptr_t)vq
->used
,
1235 num
* sizeof(*vq
->used
->ring
) + s
,
1238 EXPORT_SYMBOL_GPL(vq_iotlb_prefetch
);
1240 /* Can we log writes? */
1241 /* Caller should have device mutex but not vq mutex */
1242 int vhost_log_access_ok(struct vhost_dev
*dev
)
1244 return memory_access_ok(dev
, dev
->umem
, 1);
1246 EXPORT_SYMBOL_GPL(vhost_log_access_ok
);
1248 /* Verify access for write logging. */
1249 /* Caller should have vq mutex and device mutex */
1250 static int vq_log_access_ok(struct vhost_virtqueue
*vq
,
1251 void __user
*log_base
)
1253 size_t s
= vhost_has_feature(vq
, VIRTIO_RING_F_EVENT_IDX
) ? 2 : 0;
1255 return vq_memory_access_ok(log_base
, vq
->umem
,
1256 vhost_has_feature(vq
, VHOST_F_LOG_ALL
)) &&
1257 (!vq
->log_used
|| log_access_ok(log_base
, vq
->log_addr
,
1259 vq
->num
* sizeof *vq
->used
->ring
+ s
));
1262 /* Can we start vq? */
1263 /* Caller should have vq mutex and device mutex */
1264 int vhost_vq_access_ok(struct vhost_virtqueue
*vq
)
1267 /* When device IOTLB was used, the access validation
1268 * will be validated during prefetching.
1272 return vq_access_ok(vq
, vq
->num
, vq
->desc
, vq
->avail
, vq
->used
) &&
1273 vq_log_access_ok(vq
, vq
->log_base
);
1275 EXPORT_SYMBOL_GPL(vhost_vq_access_ok
);
1277 static struct vhost_umem
*vhost_umem_alloc(void)
1279 struct vhost_umem
*umem
= vhost_kvzalloc(sizeof(*umem
));
1284 umem
->umem_tree
= RB_ROOT
;
1286 INIT_LIST_HEAD(&umem
->umem_list
);
1291 static long vhost_set_memory(struct vhost_dev
*d
, struct vhost_memory __user
*m
)
1293 struct vhost_memory mem
, *newmem
;
1294 struct vhost_memory_region
*region
;
1295 struct vhost_umem
*newumem
, *oldumem
;
1296 unsigned long size
= offsetof(struct vhost_memory
, regions
);
1299 if (copy_from_user(&mem
, m
, size
))
1303 if (mem
.nregions
> max_mem_regions
)
1305 newmem
= vhost_kvzalloc(size
+ mem
.nregions
* sizeof(*m
->regions
));
1309 memcpy(newmem
, &mem
, size
);
1310 if (copy_from_user(newmem
->regions
, m
->regions
,
1311 mem
.nregions
* sizeof *m
->regions
)) {
1316 newumem
= vhost_umem_alloc();
1322 for (region
= newmem
->regions
;
1323 region
< newmem
->regions
+ mem
.nregions
;
1325 if (vhost_new_umem_range(newumem
,
1326 region
->guest_phys_addr
,
1327 region
->memory_size
,
1328 region
->guest_phys_addr
+
1329 region
->memory_size
- 1,
1330 region
->userspace_addr
,
1335 if (!memory_access_ok(d
, newumem
, 0))
1341 /* All memory accesses are done under some VQ mutex. */
1342 for (i
= 0; i
< d
->nvqs
; ++i
) {
1343 mutex_lock(&d
->vqs
[i
]->mutex
);
1344 d
->vqs
[i
]->umem
= newumem
;
1345 mutex_unlock(&d
->vqs
[i
]->mutex
);
1349 vhost_umem_clean(oldumem
);
1353 vhost_umem_clean(newumem
);
1358 long vhost_vring_ioctl(struct vhost_dev
*d
, int ioctl
, void __user
*argp
)
1360 struct file
*eventfp
, *filep
= NULL
;
1361 bool pollstart
= false, pollstop
= false;
1362 struct eventfd_ctx
*ctx
= NULL
;
1363 u32 __user
*idxp
= argp
;
1364 struct vhost_virtqueue
*vq
;
1365 struct vhost_vring_state s
;
1366 struct vhost_vring_file f
;
1367 struct vhost_vring_addr a
;
1371 r
= get_user(idx
, idxp
);
1379 mutex_lock(&vq
->mutex
);
1382 case VHOST_SET_VRING_NUM
:
1383 /* Resizing ring with an active backend?
1384 * You don't want to do that. */
1385 if (vq
->private_data
) {
1389 if (copy_from_user(&s
, argp
, sizeof s
)) {
1393 if (!s
.num
|| s
.num
> 0xffff || (s
.num
& (s
.num
- 1))) {
1399 case VHOST_SET_VRING_BASE
:
1400 /* Moving base with an active backend?
1401 * You don't want to do that. */
1402 if (vq
->private_data
) {
1406 if (copy_from_user(&s
, argp
, sizeof s
)) {
1410 if (s
.num
> 0xffff) {
1414 vq
->last_avail_idx
= vq
->last_used_event
= s
.num
;
1415 /* Forget the cached index value. */
1416 vq
->avail_idx
= vq
->last_avail_idx
;
1418 case VHOST_GET_VRING_BASE
:
1420 s
.num
= vq
->last_avail_idx
;
1421 if (copy_to_user(argp
, &s
, sizeof s
))
1424 case VHOST_SET_VRING_ADDR
:
1425 if (copy_from_user(&a
, argp
, sizeof a
)) {
1429 if (a
.flags
& ~(0x1 << VHOST_VRING_F_LOG
)) {
1433 /* For 32bit, verify that the top 32bits of the user
1434 data are set to zero. */
1435 if ((u64
)(unsigned long)a
.desc_user_addr
!= a
.desc_user_addr
||
1436 (u64
)(unsigned long)a
.used_user_addr
!= a
.used_user_addr
||
1437 (u64
)(unsigned long)a
.avail_user_addr
!= a
.avail_user_addr
) {
1442 /* Make sure it's safe to cast pointers to vring types. */
1443 BUILD_BUG_ON(__alignof__
*vq
->avail
> VRING_AVAIL_ALIGN_SIZE
);
1444 BUILD_BUG_ON(__alignof__
*vq
->used
> VRING_USED_ALIGN_SIZE
);
1445 if ((a
.avail_user_addr
& (VRING_AVAIL_ALIGN_SIZE
- 1)) ||
1446 (a
.used_user_addr
& (VRING_USED_ALIGN_SIZE
- 1)) ||
1447 (a
.log_guest_addr
& (VRING_USED_ALIGN_SIZE
- 1))) {
1452 /* We only verify access here if backend is configured.
1453 * If it is not, we don't as size might not have been setup.
1454 * We will verify when backend is configured. */
1455 if (vq
->private_data
) {
1456 if (!vq_access_ok(vq
, vq
->num
,
1457 (void __user
*)(unsigned long)a
.desc_user_addr
,
1458 (void __user
*)(unsigned long)a
.avail_user_addr
,
1459 (void __user
*)(unsigned long)a
.used_user_addr
)) {
1464 /* Also validate log access for used ring if enabled. */
1465 if ((a
.flags
& (0x1 << VHOST_VRING_F_LOG
)) &&
1466 !log_access_ok(vq
->log_base
, a
.log_guest_addr
,
1468 vq
->num
* sizeof *vq
->used
->ring
)) {
1474 vq
->log_used
= !!(a
.flags
& (0x1 << VHOST_VRING_F_LOG
));
1475 vq
->desc
= (void __user
*)(unsigned long)a
.desc_user_addr
;
1476 vq
->avail
= (void __user
*)(unsigned long)a
.avail_user_addr
;
1477 vq
->log_addr
= a
.log_guest_addr
;
1478 vq
->used
= (void __user
*)(unsigned long)a
.used_user_addr
;
1480 case VHOST_SET_VRING_KICK
:
1481 if (copy_from_user(&f
, argp
, sizeof f
)) {
1485 eventfp
= f
.fd
== -1 ? NULL
: eventfd_fget(f
.fd
);
1486 if (IS_ERR(eventfp
)) {
1487 r
= PTR_ERR(eventfp
);
1490 if (eventfp
!= vq
->kick
) {
1491 pollstop
= (filep
= vq
->kick
) != NULL
;
1492 pollstart
= (vq
->kick
= eventfp
) != NULL
;
1496 case VHOST_SET_VRING_CALL
:
1497 if (copy_from_user(&f
, argp
, sizeof f
)) {
1501 eventfp
= f
.fd
== -1 ? NULL
: eventfd_fget(f
.fd
);
1502 if (IS_ERR(eventfp
)) {
1503 r
= PTR_ERR(eventfp
);
1506 if (eventfp
!= vq
->call
) {
1510 vq
->call_ctx
= eventfp
?
1511 eventfd_ctx_fileget(eventfp
) : NULL
;
1515 case VHOST_SET_VRING_ERR
:
1516 if (copy_from_user(&f
, argp
, sizeof f
)) {
1520 eventfp
= f
.fd
== -1 ? NULL
: eventfd_fget(f
.fd
);
1521 if (IS_ERR(eventfp
)) {
1522 r
= PTR_ERR(eventfp
);
1525 if (eventfp
!= vq
->error
) {
1527 vq
->error
= eventfp
;
1528 ctx
= vq
->error_ctx
;
1529 vq
->error_ctx
= eventfp
?
1530 eventfd_ctx_fileget(eventfp
) : NULL
;
1534 case VHOST_SET_VRING_ENDIAN
:
1535 r
= vhost_set_vring_endian(vq
, argp
);
1537 case VHOST_GET_VRING_ENDIAN
:
1538 r
= vhost_get_vring_endian(vq
, idx
, argp
);
1540 case VHOST_SET_VRING_BUSYLOOP_TIMEOUT
:
1541 if (copy_from_user(&s
, argp
, sizeof(s
))) {
1545 vq
->busyloop_timeout
= s
.num
;
1547 case VHOST_GET_VRING_BUSYLOOP_TIMEOUT
:
1549 s
.num
= vq
->busyloop_timeout
;
1550 if (copy_to_user(argp
, &s
, sizeof(s
)))
1557 if (pollstop
&& vq
->handle_kick
)
1558 vhost_poll_stop(&vq
->poll
);
1561 eventfd_ctx_put(ctx
);
1565 if (pollstart
&& vq
->handle_kick
)
1566 r
= vhost_poll_start(&vq
->poll
, vq
->kick
);
1568 mutex_unlock(&vq
->mutex
);
1570 if (pollstop
&& vq
->handle_kick
)
1571 vhost_poll_flush(&vq
->poll
);
1574 EXPORT_SYMBOL_GPL(vhost_vring_ioctl
);
1576 int vhost_init_device_iotlb(struct vhost_dev
*d
, bool enabled
)
1578 struct vhost_umem
*niotlb
, *oiotlb
;
1581 niotlb
= vhost_umem_alloc();
1588 for (i
= 0; i
< d
->nvqs
; ++i
) {
1589 mutex_lock(&d
->vqs
[i
]->mutex
);
1590 d
->vqs
[i
]->iotlb
= niotlb
;
1591 mutex_unlock(&d
->vqs
[i
]->mutex
);
1594 vhost_umem_clean(oiotlb
);
1598 EXPORT_SYMBOL_GPL(vhost_init_device_iotlb
);
1600 /* Caller must have device mutex */
1601 long vhost_dev_ioctl(struct vhost_dev
*d
, unsigned int ioctl
, void __user
*argp
)
1603 struct file
*eventfp
, *filep
= NULL
;
1604 struct eventfd_ctx
*ctx
= NULL
;
1609 /* If you are not the owner, you can become one */
1610 if (ioctl
== VHOST_SET_OWNER
) {
1611 r
= vhost_dev_set_owner(d
);
1615 /* You must be the owner to do anything else */
1616 r
= vhost_dev_check_owner(d
);
1621 case VHOST_SET_MEM_TABLE
:
1622 r
= vhost_set_memory(d
, argp
);
1624 case VHOST_SET_LOG_BASE
:
1625 if (copy_from_user(&p
, argp
, sizeof p
)) {
1629 if ((u64
)(unsigned long)p
!= p
) {
1633 for (i
= 0; i
< d
->nvqs
; ++i
) {
1634 struct vhost_virtqueue
*vq
;
1635 void __user
*base
= (void __user
*)(unsigned long)p
;
1637 mutex_lock(&vq
->mutex
);
1638 /* If ring is inactive, will check when it's enabled. */
1639 if (vq
->private_data
&& !vq_log_access_ok(vq
, base
))
1642 vq
->log_base
= base
;
1643 mutex_unlock(&vq
->mutex
);
1646 case VHOST_SET_LOG_FD
:
1647 r
= get_user(fd
, (int __user
*)argp
);
1650 eventfp
= fd
== -1 ? NULL
: eventfd_fget(fd
);
1651 if (IS_ERR(eventfp
)) {
1652 r
= PTR_ERR(eventfp
);
1655 if (eventfp
!= d
->log_file
) {
1656 filep
= d
->log_file
;
1657 d
->log_file
= eventfp
;
1659 d
->log_ctx
= eventfp
?
1660 eventfd_ctx_fileget(eventfp
) : NULL
;
1663 for (i
= 0; i
< d
->nvqs
; ++i
) {
1664 mutex_lock(&d
->vqs
[i
]->mutex
);
1665 d
->vqs
[i
]->log_ctx
= d
->log_ctx
;
1666 mutex_unlock(&d
->vqs
[i
]->mutex
);
1669 eventfd_ctx_put(ctx
);
1680 EXPORT_SYMBOL_GPL(vhost_dev_ioctl
);
1682 /* TODO: This is really inefficient. We need something like get_user()
1683 * (instruction directly accesses the data, with an exception table entry
1684 * returning -EFAULT). See Documentation/x86/exception-tables.txt.
1686 static int set_bit_to_user(int nr
, void __user
*addr
)
1688 unsigned long log
= (unsigned long)addr
;
1691 int bit
= nr
+ (log
% PAGE_SIZE
) * 8;
1694 r
= get_user_pages_fast(log
, 1, 1, &page
);
1698 base
= kmap_atomic(page
);
1700 kunmap_atomic(base
);
1701 set_page_dirty_lock(page
);
1706 static int log_write(void __user
*log_base
,
1707 u64 write_address
, u64 write_length
)
1709 u64 write_page
= write_address
/ VHOST_PAGE_SIZE
;
1714 write_length
+= write_address
% VHOST_PAGE_SIZE
;
1716 u64 base
= (u64
)(unsigned long)log_base
;
1717 u64 log
= base
+ write_page
/ 8;
1718 int bit
= write_page
% 8;
1719 if ((u64
)(unsigned long)log
!= log
)
1721 r
= set_bit_to_user(bit
, (void __user
*)(unsigned long)log
);
1724 if (write_length
<= VHOST_PAGE_SIZE
)
1726 write_length
-= VHOST_PAGE_SIZE
;
1732 int vhost_log_write(struct vhost_virtqueue
*vq
, struct vhost_log
*log
,
1733 unsigned int log_num
, u64 len
)
1737 /* Make sure data written is seen before log. */
1739 for (i
= 0; i
< log_num
; ++i
) {
1740 u64 l
= min(log
[i
].len
, len
);
1741 r
= log_write(vq
->log_base
, log
[i
].addr
, l
);
1747 eventfd_signal(vq
->log_ctx
, 1);
1751 /* Length written exceeds what we have stored. This is a bug. */
1755 EXPORT_SYMBOL_GPL(vhost_log_write
);
1757 static int vhost_update_used_flags(struct vhost_virtqueue
*vq
)
1760 if (vhost_put_user(vq
, cpu_to_vhost16(vq
, vq
->used_flags
),
1761 &vq
->used
->flags
) < 0)
1763 if (unlikely(vq
->log_used
)) {
1764 /* Make sure the flag is seen before log. */
1766 /* Log used flag write. */
1767 used
= &vq
->used
->flags
;
1768 log_write(vq
->log_base
, vq
->log_addr
+
1769 (used
- (void __user
*)vq
->used
),
1770 sizeof vq
->used
->flags
);
1772 eventfd_signal(vq
->log_ctx
, 1);
1777 static int vhost_update_avail_event(struct vhost_virtqueue
*vq
, u16 avail_event
)
1779 if (vhost_put_user(vq
, cpu_to_vhost16(vq
, vq
->avail_idx
),
1780 vhost_avail_event(vq
)))
1782 if (unlikely(vq
->log_used
)) {
1784 /* Make sure the event is seen before log. */
1786 /* Log avail event write */
1787 used
= vhost_avail_event(vq
);
1788 log_write(vq
->log_base
, vq
->log_addr
+
1789 (used
- (void __user
*)vq
->used
),
1790 sizeof *vhost_avail_event(vq
));
1792 eventfd_signal(vq
->log_ctx
, 1);
1797 int vhost_vq_init_access(struct vhost_virtqueue
*vq
)
1799 __virtio16 last_used_idx
;
1801 bool is_le
= vq
->is_le
;
1803 if (!vq
->private_data
)
1806 vhost_init_is_le(vq
);
1808 r
= vhost_update_used_flags(vq
);
1811 vq
->signalled_used_valid
= false;
1813 !access_ok(VERIFY_READ
, &vq
->used
->idx
, sizeof vq
->used
->idx
)) {
1817 r
= vhost_get_used(vq
, last_used_idx
, &vq
->used
->idx
);
1819 vq_err(vq
, "Can't access used idx at %p\n",
1823 vq
->last_used_idx
= vhost16_to_cpu(vq
, last_used_idx
);
1830 EXPORT_SYMBOL_GPL(vhost_vq_init_access
);
1832 static int translate_desc(struct vhost_virtqueue
*vq
, u64 addr
, u32 len
,
1833 struct iovec iov
[], int iov_size
, int access
)
1835 const struct vhost_umem_node
*node
;
1836 struct vhost_dev
*dev
= vq
->dev
;
1837 struct vhost_umem
*umem
= dev
->iotlb
? dev
->iotlb
: dev
->umem
;
1842 while ((u64
)len
> s
) {
1844 if (unlikely(ret
>= iov_size
)) {
1849 node
= vhost_umem_interval_tree_iter_first(&umem
->umem_tree
,
1850 addr
, addr
+ len
- 1);
1851 if (node
== NULL
|| node
->start
> addr
) {
1852 if (umem
!= dev
->iotlb
) {
1858 } else if (!(node
->perm
& access
)) {
1864 size
= node
->size
- addr
+ node
->start
;
1865 _iov
->iov_len
= min((u64
)len
- s
, size
);
1866 _iov
->iov_base
= (void __user
*)(unsigned long)
1867 (node
->userspace_addr
+ addr
- node
->start
);
1874 vhost_iotlb_miss(vq
, addr
, access
);
1878 /* Each buffer in the virtqueues is actually a chain of descriptors. This
1879 * function returns the next descriptor in the chain,
1880 * or -1U if we're at the end. */
1881 static unsigned next_desc(struct vhost_virtqueue
*vq
, struct vring_desc
*desc
)
1885 /* If this descriptor says it doesn't chain, we're done. */
1886 if (!(desc
->flags
& cpu_to_vhost16(vq
, VRING_DESC_F_NEXT
)))
1889 /* Check they're not leading us off end of descriptors. */
1890 next
= vhost16_to_cpu(vq
, desc
->next
);
1891 /* Make sure compiler knows to grab that: we don't want it changing! */
1892 /* We will use the result as an index in an array, so most
1893 * architectures only need a compiler barrier here. */
1894 read_barrier_depends();
1899 static int get_indirect(struct vhost_virtqueue
*vq
,
1900 struct iovec iov
[], unsigned int iov_size
,
1901 unsigned int *out_num
, unsigned int *in_num
,
1902 struct vhost_log
*log
, unsigned int *log_num
,
1903 struct vring_desc
*indirect
)
1905 struct vring_desc desc
;
1906 unsigned int i
= 0, count
, found
= 0;
1907 u32 len
= vhost32_to_cpu(vq
, indirect
->len
);
1908 struct iov_iter from
;
1912 if (unlikely(len
% sizeof desc
)) {
1913 vq_err(vq
, "Invalid length in indirect descriptor: "
1914 "len 0x%llx not multiple of 0x%zx\n",
1915 (unsigned long long)len
,
1920 ret
= translate_desc(vq
, vhost64_to_cpu(vq
, indirect
->addr
), len
, vq
->indirect
,
1921 UIO_MAXIOV
, VHOST_ACCESS_RO
);
1922 if (unlikely(ret
< 0)) {
1924 vq_err(vq
, "Translation failure %d in indirect.\n", ret
);
1927 iov_iter_init(&from
, READ
, vq
->indirect
, ret
, len
);
1929 /* We will use the result as an address to read from, so most
1930 * architectures only need a compiler barrier here. */
1931 read_barrier_depends();
1933 count
= len
/ sizeof desc
;
1934 /* Buffers are chained via a 16 bit next field, so
1935 * we can have at most 2^16 of these. */
1936 if (unlikely(count
> USHRT_MAX
+ 1)) {
1937 vq_err(vq
, "Indirect buffer length too big: %d\n",
1943 unsigned iov_count
= *in_num
+ *out_num
;
1944 if (unlikely(++found
> count
)) {
1945 vq_err(vq
, "Loop detected: last one at %u "
1946 "indirect size %u\n",
1950 if (unlikely(!copy_from_iter_full(&desc
, sizeof(desc
), &from
))) {
1951 vq_err(vq
, "Failed indirect descriptor: idx %d, %zx\n",
1952 i
, (size_t)vhost64_to_cpu(vq
, indirect
->addr
) + i
* sizeof desc
);
1955 if (unlikely(desc
.flags
& cpu_to_vhost16(vq
, VRING_DESC_F_INDIRECT
))) {
1956 vq_err(vq
, "Nested indirect descriptor: idx %d, %zx\n",
1957 i
, (size_t)vhost64_to_cpu(vq
, indirect
->addr
) + i
* sizeof desc
);
1961 if (desc
.flags
& cpu_to_vhost16(vq
, VRING_DESC_F_WRITE
))
1962 access
= VHOST_ACCESS_WO
;
1964 access
= VHOST_ACCESS_RO
;
1966 ret
= translate_desc(vq
, vhost64_to_cpu(vq
, desc
.addr
),
1967 vhost32_to_cpu(vq
, desc
.len
), iov
+ iov_count
,
1968 iov_size
- iov_count
, access
);
1969 if (unlikely(ret
< 0)) {
1971 vq_err(vq
, "Translation failure %d indirect idx %d\n",
1975 /* If this is an input descriptor, increment that count. */
1976 if (access
== VHOST_ACCESS_WO
) {
1978 if (unlikely(log
)) {
1979 log
[*log_num
].addr
= vhost64_to_cpu(vq
, desc
.addr
);
1980 log
[*log_num
].len
= vhost32_to_cpu(vq
, desc
.len
);
1984 /* If it's an output descriptor, they're all supposed
1985 * to come before any input descriptors. */
1986 if (unlikely(*in_num
)) {
1987 vq_err(vq
, "Indirect descriptor "
1988 "has out after in: idx %d\n", i
);
1993 } while ((i
= next_desc(vq
, &desc
)) != -1);
1997 /* This looks in the virtqueue and for the first available buffer, and converts
1998 * it to an iovec for convenient access. Since descriptors consist of some
1999 * number of output then some number of input descriptors, it's actually two
2000 * iovecs, but we pack them into one and note how many of each there were.
2002 * This function returns the descriptor number found, or vq->num (which is
2003 * never a valid descriptor number) if none was found. A negative code is
2004 * returned on error. */
2005 int vhost_get_vq_desc(struct vhost_virtqueue
*vq
,
2006 struct iovec iov
[], unsigned int iov_size
,
2007 unsigned int *out_num
, unsigned int *in_num
,
2008 struct vhost_log
*log
, unsigned int *log_num
)
2010 struct vring_desc desc
;
2011 unsigned int i
, head
, found
= 0;
2013 __virtio16 avail_idx
;
2014 __virtio16 ring_head
;
2017 /* Check it isn't doing very strange things with descriptor numbers. */
2018 last_avail_idx
= vq
->last_avail_idx
;
2020 if (vq
->avail_idx
== vq
->last_avail_idx
) {
2021 if (unlikely(vhost_get_avail(vq
, avail_idx
, &vq
->avail
->idx
))) {
2022 vq_err(vq
, "Failed to access avail idx at %p\n",
2026 vq
->avail_idx
= vhost16_to_cpu(vq
, avail_idx
);
2028 if (unlikely((u16
)(vq
->avail_idx
- last_avail_idx
) > vq
->num
)) {
2029 vq_err(vq
, "Guest moved used index from %u to %u",
2030 last_avail_idx
, vq
->avail_idx
);
2034 /* If there's nothing new since last we looked, return
2037 if (vq
->avail_idx
== last_avail_idx
)
2040 /* Only get avail ring entries after they have been
2046 /* Grab the next descriptor number they're advertising, and increment
2047 * the index we've seen. */
2048 if (unlikely(vhost_get_avail(vq
, ring_head
,
2049 &vq
->avail
->ring
[last_avail_idx
& (vq
->num
- 1)]))) {
2050 vq_err(vq
, "Failed to read head: idx %d address %p\n",
2052 &vq
->avail
->ring
[last_avail_idx
% vq
->num
]);
2056 head
= vhost16_to_cpu(vq
, ring_head
);
2058 /* If their number is silly, that's an error. */
2059 if (unlikely(head
>= vq
->num
)) {
2060 vq_err(vq
, "Guest says index %u > %u is available",
2065 /* When we start there are none of either input nor output. */
2066 *out_num
= *in_num
= 0;
2072 unsigned iov_count
= *in_num
+ *out_num
;
2073 if (unlikely(i
>= vq
->num
)) {
2074 vq_err(vq
, "Desc index is %u > %u, head = %u",
2078 if (unlikely(++found
> vq
->num
)) {
2079 vq_err(vq
, "Loop detected: last one at %u "
2080 "vq size %u head %u\n",
2084 ret
= vhost_copy_from_user(vq
, &desc
, vq
->desc
+ i
,
2086 if (unlikely(ret
)) {
2087 vq_err(vq
, "Failed to get descriptor: idx %d addr %p\n",
2091 if (desc
.flags
& cpu_to_vhost16(vq
, VRING_DESC_F_INDIRECT
)) {
2092 ret
= get_indirect(vq
, iov
, iov_size
,
2094 log
, log_num
, &desc
);
2095 if (unlikely(ret
< 0)) {
2097 vq_err(vq
, "Failure detected "
2098 "in indirect descriptor at idx %d\n", i
);
2104 if (desc
.flags
& cpu_to_vhost16(vq
, VRING_DESC_F_WRITE
))
2105 access
= VHOST_ACCESS_WO
;
2107 access
= VHOST_ACCESS_RO
;
2108 ret
= translate_desc(vq
, vhost64_to_cpu(vq
, desc
.addr
),
2109 vhost32_to_cpu(vq
, desc
.len
), iov
+ iov_count
,
2110 iov_size
- iov_count
, access
);
2111 if (unlikely(ret
< 0)) {
2113 vq_err(vq
, "Translation failure %d descriptor idx %d\n",
2117 if (access
== VHOST_ACCESS_WO
) {
2118 /* If this is an input descriptor,
2119 * increment that count. */
2121 if (unlikely(log
)) {
2122 log
[*log_num
].addr
= vhost64_to_cpu(vq
, desc
.addr
);
2123 log
[*log_num
].len
= vhost32_to_cpu(vq
, desc
.len
);
2127 /* If it's an output descriptor, they're all supposed
2128 * to come before any input descriptors. */
2129 if (unlikely(*in_num
)) {
2130 vq_err(vq
, "Descriptor has out after in: "
2136 } while ((i
= next_desc(vq
, &desc
)) != -1);
2138 /* On success, increment avail index. */
2139 vq
->last_avail_idx
++;
2141 /* Assume notifications from guest are disabled at this point,
2142 * if they aren't we would need to update avail_event index. */
2143 BUG_ON(!(vq
->used_flags
& VRING_USED_F_NO_NOTIFY
));
2146 EXPORT_SYMBOL_GPL(vhost_get_vq_desc
);
2148 /* Reverse the effect of vhost_get_vq_desc. Useful for error handling. */
2149 void vhost_discard_vq_desc(struct vhost_virtqueue
*vq
, int n
)
2151 vq
->last_avail_idx
-= n
;
2153 EXPORT_SYMBOL_GPL(vhost_discard_vq_desc
);
2155 /* After we've used one of their buffers, we tell them about it. We'll then
2156 * want to notify the guest, using eventfd. */
2157 int vhost_add_used(struct vhost_virtqueue
*vq
, unsigned int head
, int len
)
2159 struct vring_used_elem heads
= {
2160 cpu_to_vhost32(vq
, head
),
2161 cpu_to_vhost32(vq
, len
)
2164 return vhost_add_used_n(vq
, &heads
, 1);
2166 EXPORT_SYMBOL_GPL(vhost_add_used
);
2168 static int __vhost_add_used_n(struct vhost_virtqueue
*vq
,
2169 struct vring_used_elem
*heads
,
2172 struct vring_used_elem __user
*used
;
2176 start
= vq
->last_used_idx
& (vq
->num
- 1);
2177 used
= vq
->used
->ring
+ start
;
2179 if (vhost_put_user(vq
, heads
[0].id
, &used
->id
)) {
2180 vq_err(vq
, "Failed to write used id");
2183 if (vhost_put_user(vq
, heads
[0].len
, &used
->len
)) {
2184 vq_err(vq
, "Failed to write used len");
2187 } else if (vhost_copy_to_user(vq
, used
, heads
, count
* sizeof *used
)) {
2188 vq_err(vq
, "Failed to write used");
2191 if (unlikely(vq
->log_used
)) {
2192 /* Make sure data is seen before log. */
2194 /* Log used ring entry write. */
2195 log_write(vq
->log_base
,
2197 ((void __user
*)used
- (void __user
*)vq
->used
),
2198 count
* sizeof *used
);
2200 old
= vq
->last_used_idx
;
2201 new = (vq
->last_used_idx
+= count
);
2202 /* If the driver never bothers to signal in a very long while,
2203 * used index might wrap around. If that happens, invalidate
2204 * signalled_used index we stored. TODO: make sure driver
2205 * signals at least once in 2^16 and remove this. */
2206 if (unlikely((u16
)(new - vq
->signalled_used
) < (u16
)(new - old
)))
2207 vq
->signalled_used_valid
= false;
2211 /* After we've used one of their buffers, we tell them about it. We'll then
2212 * want to notify the guest, using eventfd. */
2213 int vhost_add_used_n(struct vhost_virtqueue
*vq
, struct vring_used_elem
*heads
,
2218 start
= vq
->last_used_idx
& (vq
->num
- 1);
2219 n
= vq
->num
- start
;
2221 r
= __vhost_add_used_n(vq
, heads
, n
);
2227 r
= __vhost_add_used_n(vq
, heads
, count
);
2229 /* Make sure buffer is written before we update index. */
2231 if (vhost_put_user(vq
, cpu_to_vhost16(vq
, vq
->last_used_idx
),
2233 vq_err(vq
, "Failed to increment used idx");
2236 if (unlikely(vq
->log_used
)) {
2237 /* Log used index update. */
2238 log_write(vq
->log_base
,
2239 vq
->log_addr
+ offsetof(struct vring_used
, idx
),
2240 sizeof vq
->used
->idx
);
2242 eventfd_signal(vq
->log_ctx
, 1);
2246 EXPORT_SYMBOL_GPL(vhost_add_used_n
);
2248 static bool vhost_notify(struct vhost_dev
*dev
, struct vhost_virtqueue
*vq
)
2254 if (vhost_has_feature(vq
, VIRTIO_F_NOTIFY_ON_EMPTY
) &&
2255 unlikely(vq
->avail_idx
== vq
->last_avail_idx
))
2258 if (!vhost_has_feature(vq
, VIRTIO_RING_F_EVENT_IDX
)) {
2260 /* Flush out used index updates. This is paired
2261 * with the barrier that the Guest executes when enabling
2264 if (vhost_get_avail(vq
, flags
, &vq
->avail
->flags
)) {
2265 vq_err(vq
, "Failed to get flags");
2268 return !(flags
& cpu_to_vhost16(vq
, VRING_AVAIL_F_NO_INTERRUPT
));
2270 old
= vq
->signalled_used
;
2271 v
= vq
->signalled_used_valid
;
2272 new = vq
->signalled_used
= vq
->last_used_idx
;
2273 vq
->signalled_used_valid
= true;
2278 /* We're sure if the following conditions are met, there's no
2279 * need to notify guest:
2280 * 1) cached used event is ahead of new
2281 * 2) old to new updating does not cross cached used event. */
2282 if (vring_need_event(vq
->last_used_event
, new + vq
->num
, new) &&
2283 !vring_need_event(vq
->last_used_event
, new, old
))
2286 /* Flush out used index updates. This is paired
2287 * with the barrier that the Guest executes when enabling
2291 if (vhost_get_avail(vq
, event
, vhost_used_event(vq
))) {
2292 vq_err(vq
, "Failed to get used event idx");
2295 vq
->last_used_event
= vhost16_to_cpu(vq
, event
);
2297 return vring_need_event(vq
->last_used_event
, new, old
);
2300 /* This actually signals the guest, using eventfd. */
2301 void vhost_signal(struct vhost_dev
*dev
, struct vhost_virtqueue
*vq
)
2303 /* Signal the Guest tell them we used something up. */
2304 if (vq
->call_ctx
&& vhost_notify(dev
, vq
))
2305 eventfd_signal(vq
->call_ctx
, 1);
2307 EXPORT_SYMBOL_GPL(vhost_signal
);
2309 /* And here's the combo meal deal. Supersize me! */
2310 void vhost_add_used_and_signal(struct vhost_dev
*dev
,
2311 struct vhost_virtqueue
*vq
,
2312 unsigned int head
, int len
)
2314 vhost_add_used(vq
, head
, len
);
2315 vhost_signal(dev
, vq
);
2317 EXPORT_SYMBOL_GPL(vhost_add_used_and_signal
);
2319 /* multi-buffer version of vhost_add_used_and_signal */
2320 void vhost_add_used_and_signal_n(struct vhost_dev
*dev
,
2321 struct vhost_virtqueue
*vq
,
2322 struct vring_used_elem
*heads
, unsigned count
)
2324 vhost_add_used_n(vq
, heads
, count
);
2325 vhost_signal(dev
, vq
);
2327 EXPORT_SYMBOL_GPL(vhost_add_used_and_signal_n
);
2329 /* return true if we're sure that avaiable ring is empty */
2330 bool vhost_vq_avail_empty(struct vhost_dev
*dev
, struct vhost_virtqueue
*vq
)
2332 __virtio16 avail_idx
;
2335 if (vq
->avail_idx
!= vq
->last_avail_idx
)
2338 r
= vhost_get_avail(vq
, avail_idx
, &vq
->avail
->idx
);
2341 vq
->avail_idx
= vhost16_to_cpu(vq
, avail_idx
);
2343 return vq
->avail_idx
== vq
->last_avail_idx
;
2345 EXPORT_SYMBOL_GPL(vhost_vq_avail_empty
);
2347 /* OK, now we need to know about added descriptors. */
2348 bool vhost_enable_notify(struct vhost_dev
*dev
, struct vhost_virtqueue
*vq
)
2350 __virtio16 avail_idx
;
2353 if (!(vq
->used_flags
& VRING_USED_F_NO_NOTIFY
))
2355 vq
->used_flags
&= ~VRING_USED_F_NO_NOTIFY
;
2356 if (!vhost_has_feature(vq
, VIRTIO_RING_F_EVENT_IDX
)) {
2357 r
= vhost_update_used_flags(vq
);
2359 vq_err(vq
, "Failed to enable notification at %p: %d\n",
2360 &vq
->used
->flags
, r
);
2364 r
= vhost_update_avail_event(vq
, vq
->avail_idx
);
2366 vq_err(vq
, "Failed to update avail event index at %p: %d\n",
2367 vhost_avail_event(vq
), r
);
2371 /* They could have slipped one in as we were doing that: make
2372 * sure it's written, then check again. */
2374 r
= vhost_get_avail(vq
, avail_idx
, &vq
->avail
->idx
);
2376 vq_err(vq
, "Failed to check avail idx at %p: %d\n",
2377 &vq
->avail
->idx
, r
);
2381 return vhost16_to_cpu(vq
, avail_idx
) != vq
->avail_idx
;
2383 EXPORT_SYMBOL_GPL(vhost_enable_notify
);
2385 /* We don't need to be notified again. */
2386 void vhost_disable_notify(struct vhost_dev
*dev
, struct vhost_virtqueue
*vq
)
2390 if (vq
->used_flags
& VRING_USED_F_NO_NOTIFY
)
2392 vq
->used_flags
|= VRING_USED_F_NO_NOTIFY
;
2393 if (!vhost_has_feature(vq
, VIRTIO_RING_F_EVENT_IDX
)) {
2394 r
= vhost_update_used_flags(vq
);
2396 vq_err(vq
, "Failed to enable notification at %p: %d\n",
2397 &vq
->used
->flags
, r
);
2400 EXPORT_SYMBOL_GPL(vhost_disable_notify
);
2402 /* Create a new message. */
2403 struct vhost_msg_node
*vhost_new_msg(struct vhost_virtqueue
*vq
, int type
)
2405 struct vhost_msg_node
*node
= kmalloc(sizeof *node
, GFP_KERNEL
);
2409 node
->msg
.type
= type
;
2412 EXPORT_SYMBOL_GPL(vhost_new_msg
);
2414 void vhost_enqueue_msg(struct vhost_dev
*dev
, struct list_head
*head
,
2415 struct vhost_msg_node
*node
)
2417 spin_lock(&dev
->iotlb_lock
);
2418 list_add_tail(&node
->node
, head
);
2419 spin_unlock(&dev
->iotlb_lock
);
2421 wake_up_interruptible_poll(&dev
->wait
, POLLIN
| POLLRDNORM
);
2423 EXPORT_SYMBOL_GPL(vhost_enqueue_msg
);
2425 struct vhost_msg_node
*vhost_dequeue_msg(struct vhost_dev
*dev
,
2426 struct list_head
*head
)
2428 struct vhost_msg_node
*node
= NULL
;
2430 spin_lock(&dev
->iotlb_lock
);
2431 if (!list_empty(head
)) {
2432 node
= list_first_entry(head
, struct vhost_msg_node
,
2434 list_del(&node
->node
);
2436 spin_unlock(&dev
->iotlb_lock
);
2440 EXPORT_SYMBOL_GPL(vhost_dequeue_msg
);
2443 static int __init
vhost_init(void)
2448 static void __exit
vhost_exit(void)
2452 module_init(vhost_init
);
2453 module_exit(vhost_exit
);
2455 MODULE_VERSION("0.0.1");
2456 MODULE_LICENSE("GPL v2");
2457 MODULE_AUTHOR("Michael S. Tsirkin");
2458 MODULE_DESCRIPTION("Host kernel accelerator for virtio");