#kvm

kvm-bindings

Rust FFI bindings to KVM generated using bindgen

8 releases (5 breaking)

Uses old Rust 2015

0.6.0 Nov 10, 2022
0.5.0 Aug 24, 2021
0.4.0 Mar 8, 2021
0.3.1 Mar 4, 2021
0.1.1 Jan 24, 2019

#83 in Unix APIs

Download history 4865/week @ 2022-10-10 3436/week @ 2022-10-17 3510/week @ 2022-10-24 2147/week @ 2022-10-31 4506/week @ 2022-11-07 4858/week @ 2022-11-14 3547/week @ 2022-11-21 3308/week @ 2022-11-28 3124/week @ 2022-12-05 4139/week @ 2022-12-12 5277/week @ 2022-12-19 1124/week @ 2022-12-26 2456/week @ 2023-01-02 5054/week @ 2023-01-09 3726/week @ 2023-01-16 4505/week @ 2023-01-23

15,804 downloads per month
Used in 11 crates (9 directly)

Apache-2.0

685KB
23K SLoC

Build Status Crates.io

kvm-bindings

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

  • x86
  • x86_64
  • arm
  • arm64

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.

Usage

First, add the following to your Cargo.toml:

kvm-bindings = "0.3"

Next, add this to your crate root:

extern crate kvm_bindings;

This crate also 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. Example:

kvm-bindings = { version = "0.3", features = ["fam-wrappers"]}

Dependencies

The crate has an optional dependency to vmm-sys-util when enabling the fam-wrappers feature.

Dependencies