Struct TestVm

pub struct TestVm {
    sys: TestVmSys,
    ready: bool,
    sudo: bool,
}

Test fixture to spin up a VM running a guest that can be communicated with.

After creation, commands can be sent via exec_in_guest. The VM is stopped when this instance is dropped.

Fields

sys: TestVmSys

ready: bool

sudo: bool

Implementations

impl TestVm

fn initialize_once()

Downloads prebuilts if needed.

fn initiailize_artifacts(cfg: &Config)

pub fn new_generic<F>(f: F, cfg: Config, sudo: bool) -> Result<TestVm>

where F: FnOnce(&mut Command, &Path, &Config) -> Result<()>,

Instanciate a new crosvm instance. The first call will trigger the download of prebuilt files if necessary.

This generic method takes a FnOnce argument which is in charge of completing the Command with all the relevant options needed to boot the VM.

pub fn new_generic_restore<F>(f: F, cfg: Config, sudo: bool) -> Result<TestVm>

where F: FnOnce(&mut Command, &Path, &Config) -> Result<()>,

pub fn new(cfg: Config) -> Result<TestVm>

pub fn new_restore(cfg: Config) -> Result<TestVm>

Create TestVm from a snapshot, using --restore but NOT --suspended.

pub fn new_restore_suspended(cfg: Config) -> Result<TestVm>

Create TestVm from a snapshot, using --restore AND --suspended.

pub fn new_sudo(cfg: Config) -> Result<TestVm>

pub fn exec_in_guest(&mut self, command: &str) -> Result<ProgramExit>

Executes the provided command in the guest. Returns command output as Ok(ProgramExit), or an Error if the program did not exit with 0.

pub fn exec_in_guest_unchecked(&mut self, command: &str) -> Result<ProgramExit>

Same as exec_in_guest but will return Ok(ProgramExit) instead of failing on a non-zero exit code.

pub fn exec_in_guest_async(&mut self, command: &str) -> Result<GuestProcess>

Executes the provided command in the guest asynchronously. The command will be run in the guest, but output will not be read until GuestProcess::wait_ok() or GuestProcess::wait_result() is called.

fn wait_for_guest_ready(&mut self, timeout: Duration) -> Result<()>

fn read_message_from_guest( &mut self, timeout: Duration, ) -> Result<GuestToHostMessage>

Reads one line via the from_guest pipe from the guest delegate.

fn write_message_to_guest( &mut self, data: &HostToGuestMessage, timeout: Duration, ) -> Result<()>

Send one line via the to_guest pipe to the guest delegate.

pub fn hotplug_tap(&mut self, tap_name: &str) -> Result<()>

Hotplug a tap device.

pub fn remove_pci_device(&mut self, bus_num: u8) -> Result<()>

Remove hotplugged device on bus.

pub fn stop(&mut self) -> Result<()>

pub fn suspend(&mut self) -> Result<()>

pub fn suspend_full(&mut self) -> Result<()>

pub fn resume(&mut self) -> Result<()>

pub fn resume_full(&mut self) -> Result<()>

pub fn disk(&mut self, args: Vec<String>) -> Result<()>

pub fn snapshot(&mut self, filename: &Path) -> Result<()>

pub fn restore(&mut self, filename: &Path) -> Result<()>

pub fn swap_command(&mut self, command: &str) -> Result<Vec<u8>>

pub fn guest_clock_values(&mut self) -> Result<ClockValues>

Trait Implementations

impl Drop for TestVm

fn drop(&mut self)

Executes the destructor for this type.