Struct DeviceFd 

pub struct DeviceFd { /* private fields */ }

Wrapper over the file descriptor obtained when creating an emulated device in the kernel.

Implementations

impl DeviceFd

pub fn has_device_attr( &self, device_attr: &mshv_device_attr, ) -> Result<(), MshvError>

Tests whether a device supports a particular attribute.

See the documentation for MSHV_HAS_DEVICE_ATTR.

Arguments

• device_attr - The device attribute to be tested. addr field is ignored.

pub fn set_device_attr( &self, device_attr: &mshv_device_attr, ) -> Result<(), MshvError>

Sets a specified piece of device configuration and/or state.

See the documentation for MSHV_SET_DEVICE_ATTR.

Arguments

• device_attr - The device attribute to be set.

Example

   MSHV_DEV_TYPE_VFIO,
   MSHV_DEV_VFIO_FILE, MSHV_DEV_VFIO_FILE_ADD, MSHV_CREATE_DEVICE_TEST
};
let mshv = Mshv::new().unwrap();
let vm = mshv.create_vm().unwrap();

let mut device = mshv_bindings::mshv_create_device {
    type_: MSHV_DEV_TYPE_VFIO,
    fd: 0,
    flags: MSHV_CREATE_DEVICE_TEST,
};

let device_fd = vm
    .create_device(&mut device)
    .expect("Cannot create MSHV device");

let dist_attr = mshv_bindings::mshv_device_attr {
    group: MSHV_DEV_VFIO_FILE,
    attr: u64::from(MSHV_DEV_VFIO_FILE_ADD),
    addr: 0,
    flags: 0,
};

if (device_fd.has_device_attr(&dist_attr).is_ok()) {
    device_fd.set_device_attr(&dist_attr).unwrap();
}

pub fn get_device_attr( &self, device_attr: &mut mshv_device_attr, ) -> Result<(), MshvError>

Gets a specified piece of device configuration and/or state.

See the documentation for MSHV_GET_DEVICE_ATTR.

Arguments

• device_attr - The device attribute to be get. Note: This argument serves as both input and output. When calling this function, the user should explicitly provide valid values for the group and the attr field of the mshv_device_attr structure, and a valid userspace address (i.e. the addr field) to access the returned device attribute data.

Returns

• Returns the last occured errno wrapped in an Err.
• device_attr - The addr field of the device_attr structure will point to the device attribute data.

Trait Implementations

impl AsRawFd for DeviceFd

fn as_raw_fd(&self) -> RawFd

Extracts the raw file descriptor.

impl Debug for DeviceFd

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromRawFd for DeviceFd

unsafe fn from_raw_fd(fd: RawFd) -> Self

This function is also unsafe as the primitives currently returned have the contract that they are the sole owner of the file descriptor they are wrapping. Usage of this function could accidentally allow violating this contract which can cause memory unsafety in code that relies on it being true.