vduse: Introduce VDUSE - vDPA Device in Userspace
authorXie Yongji <xieyongji@bytedance.com>
Tue, 31 Aug 2021 10:36:33 +0000 (18:36 +0800)
committerMichael S. Tsirkin <mst@redhat.com>
Mon, 6 Sep 2021 11:20:58 +0000 (07:20 -0400)
commitc8a6153b6c59d95c0e091f053f6f180952ade91e
tree549e205443878613acbc8a4f989a24c61fa540d9
parent8c773d53fb7b64267b0f55c1d3517cb8c5e29b3c
vduse: Introduce VDUSE - vDPA Device in Userspace

This VDUSE driver enables implementing software-emulated vDPA
devices in userspace. The vDPA device is created by
ioctl(VDUSE_CREATE_DEV) on /dev/vduse/control. Then a char device
interface (/dev/vduse/$NAME) is exported to userspace for device
emulation.

In order to make the device emulation more secure, the device's
control path is handled in kernel. A message mechnism is introduced
to forward some dataplane related control messages to userspace.

And in the data path, the DMA buffer will be mapped into userspace
address space through different ways depending on the vDPA bus to
which the vDPA device is attached. In virtio-vdpa case, the MMU-based
software IOTLB is used to achieve that. And in vhost-vdpa case, the
DMA buffer is reside in a userspace memory region which can be shared
to the VDUSE userspace processs via transferring the shmfd.

For more details on VDUSE design and usage, please see the follow-on
Documentation commit.

NB(mst): when merging this with
b542e383d8c0 ("eventfd: Make signal recursion protection a task bit")
replace eventfd_signal_count with eventfd_signal_allowed,
and drop the previous
("eventfd: Export eventfd_wake_count to modules").

Signed-off-by: Xie Yongji <xieyongji@bytedance.com>
Acked-by: Jason Wang <jasowang@redhat.com>
Link: https://lore.kernel.org/r/20210831103634.33-13-xieyongji@bytedance.com
Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
Documentation/userspace-api/ioctl/ioctl-number.rst
drivers/vdpa/Kconfig
drivers/vdpa/Makefile
drivers/vdpa/vdpa_user/Makefile [new file with mode: 0644]
drivers/vdpa/vdpa_user/vduse_dev.c [new file with mode: 0644]
include/uapi/linux/vduse.h [new file with mode: 0644]