1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

use linux_io::fd::ioctl::{
    ioctl_write, ioctl_write_val, IoctlReqWrite, IoctlReqWriteVal, _IO, _IOW,
};
use linux_unsafe::{int, ulong};

use super::system::KVMIO;
use linux_io::File;

/// The device type marker for the a KVM virtual machine file descriptor.
#[derive(Debug)]
pub struct KvmVm;

impl linux_io::fd::ioctl::IoDevice for KvmVm {}

/// Query whether the KVM subsystem in the current kernel supports a particular
/// extension for a specific VM.
///
/// A result of zero indicates a lack of support while nonzero indicates
/// support. The nonzero value may carry additional meanings for some
/// extensions.
pub const KVM_CHECK_EXTENSION: IoctlReqWrite<KvmVm, int, int> =
    unsafe { ioctl_write(_IOW(KVMIO, 0x03, core::mem::size_of::<int>() as ulong)) };

/// Create a new virtual CPU for an existing virtual machine and obtain the
/// file that represents it.
///
/// The argument is a VCPU ID, which ranges from zero to the maximum number of
/// supported VCPUs per VM, which is a kernel-decided limit.
///
/// The resulting file accepts the `ioctl` requests defined in [`super::vcpu`].
pub const KVM_CREATE_VCPU: IoctlReqWriteVal<KvmVm, int, File<super::vcpu::KvmVcpu>> =
    unsafe { ioctl_write_val(_IO(KVMIO, 0x41)) };

/// Create, modify or delete a guest physical memory slot.
pub const KVM_SET_USER_MEMORY_REGION: IoctlReqWrite<
    KvmVm,
    crate::raw::kvm_userspace_memory_region,
    int,
> = unsafe {
    ioctl_write(_IOW(
        KVMIO,
        0x46,
        core::mem::size_of::<crate::raw::kvm_userspace_memory_region>() as ulong,
    ))
};

/// Track writes to this region if set in [`KVM_SET_USER_MEMORY_REGION`]'s
/// `flags` field.
pub const KVM_MEM_LOG_DIRTY_PAGES: u32 = 1 << 0;

/// Marks a memory region as read-only in [`KVM_SET_USER_MEMORY_REGION`]'s
/// `flags` field.
pub const KVM_MEM_READONLY: u32 = 1 << 1;