looking-glass/module
Quantum b447b78b17 [module] support in-memory kvmfr devices
Added an array option static_size_mb to the kvmfr module to create a
list of in-memory kvmfr devices. These devices support dmabuf just like
normal kvmfr devices. Additionally, they can be mmap'd, which allows
them to be passed to qemu as ivshmem devices.
2021-02-21 10:31:48 +11:00
..
dkms.conf [module] bump the version 2021-01-03 23:42:43 +11:00
kvmfr.c [module] support in-memory kvmfr devices 2021-02-21 10:31:48 +11:00
kvmfr.h [module] added missing kvmfr.h, fixes #253 2020-03-22 09:20:09 +11:00
Makefile [kvmfr] stop the module building the test application by default 2020-01-29 14:01:52 +11:00
README.md [doc] update devicenames in module/README.md 2021-01-01 16:22:30 +11:00
test.c [all] use explicit void parameter lists 2021-01-14 17:29:37 +11:00

This kernel module implements a basic interface to the IVSHMEM device for LookingGlass when using LookingGlass in VM->VM mode.

Compiling (Manual)

Make sure you have your kernel headers installed first, on Debian/Ubuntu use the following command.

apt-get install linux-headers-$(uname -r)

Then simply run make and you're done.

Loading

This module requires the uio module to be loaded first, loading it is as simple as:

modprobe uio
insmod kvmfr.ko

Compiling & Installing (DKMS)

You can install this module into DKMS so that it persists across kernel upgrades. Simply run:

dkms install .

Loading

Simply modprobe the module:

modprobe kvmfr

Usage

This will create the /dev/kvmfr0 node that represents the KVMFR interface. To use the interface you need permission to access it by either creating a udev rule to ensure your user can read and write to it, or simply change it's ownership manually, ie:

sudo chown user:user /dev/kvmfr0

Usage with looking glass is simple, you only need to specify the path to the device node, for example:

./looking-glass-client -f /dev/kvmfr0