16 releases (10 breaking)

Uses old Rust 2015

0.11.0 Jan 17, 2025
0.10.0 Sep 23, 2024
0.9.1 Sep 5, 2024
0.9.0 Jul 24, 2024
0.1.1 Jan 24, 2019

#130 in Unix APIs

Download history 9854/week @ 2024-10-27 10712/week @ 2024-11-03 9838/week @ 2024-11-10 8768/week @ 2024-11-17 8148/week @ 2024-11-24 9393/week @ 2024-12-01 10463/week @ 2024-12-08 7785/week @ 2024-12-15 3219/week @ 2024-12-22 4863/week @ 2024-12-29 7304/week @ 2025-01-05 8875/week @ 2025-01-12 8560/week @ 2025-01-19 9162/week @ 2025-01-26 11466/week @ 2025-02-02 9107/week @ 2025-02-09

38,794 downloads per month
Used in 12 crates (10 directly)

Apache-2.0

625KB
13K SLoC

[Crates.io]

kvm-bindings

Rust FFI bindings to KVM, generated using bindgen. It currently has support for the following target architectures:

  • x86_64
  • arm64
  • riscv64

The bindings exported by this crate are statically generated using header files associated with a specific kernel version, and are not automatically synced with the kernel version running on a particular host. The user must ensure that specific structures, members, or constants are supported and valid for the kernel version they are using. For example, the immediate_exit field from the kvm_run structure is only meaningful if the KVM_CAP_IMMEDIATE_EXIT capability is available. Using invalid fields or features may lead to undefined behaviour.

Flexible Array Members (FAM structs)

This crate optionally offers safe wrappers over FAM structs - FFI structs that have a Flexible Array Member in their definition. These safe wrappers can be used if the fam-wrappers feature is enabled for this crate. Note that enabling the fam-wrappers feature enables the vmm-sys-util dependency.

Serialization

It has an optional dependency on serde when enabling the serde feature, to allow serialization of bindings. Serialization of bindings happens as opaque binary blobs via zerocopy. Due to the kernel's ABI compatibility, this means that bindings serialized in version x of kvm-bindings can be deserialized in version y of the crate, even if the bindings have had been regenerated in the meantime.

Regenerating Bindings

Please see CONTRIBUTING.md for details on how to generate the bindings or add support for new architectures.

Dependencies

~0–435KB