Struct vmw_backdoor::EnhancedChan

pub struct EnhancedChan<'a> { /* private fields */ }

Channel for enhanced-RPC transfers.

This can be acquired via BackdoorGuard::open_enhanced_chan.

Implementations

impl<'a> EnhancedChan<'a>

pub fn open(guard: &'a mut BackdoorGuard) -> Result<Self, VmwError>

Open an enhanced-RPC channel.

pub fn close(self) -> Result<(), Self>

Close the channel.

On error, this returns back the channel.

pub fn get_guestinfo(&mut self, key: &[u8]) -> Result<Option<Vec<u8>>, VmwError>

Retrieve a guestinfo property.

Examples found in repository

examples/get-guestinfo.rs (line 23)

fn main() {
    let key = match env::args().collect::<Vec<_>>().get(1) {
        Some(val) => val.clone(),
        None => panic!("missing argument: key name"),
    };

    let is_vmw = vmw::is_vmware_cpu();
    eprintln!("VMware CPU detected: {}.", is_vmw);
    if !is_vmw {
        panic!("Hypervisor not present");
    }

    let mut backdoor = vmw::probe_backdoor_privileged().unwrap();
    eprintln!("Got backdoor access.");

    let mut erpc = backdoor.open_enhanced_chan().unwrap();
    eprintln!("Got ERPC channel: {:?}.", erpc);

    match erpc.get_guestinfo(key.as_bytes()).unwrap() {
        Some(val) => {
            eprintln!("Got value for key '{}'.", key);
            println!("{}", String::from_utf8_lossy(&val));
        }
        None => panic!("Guestinfo property not found."),
    };
}

pub fn log(&mut self, msg: &str) -> Result<(), VmwError>

Log a message.

Examples found in repository

examples/log.rs (line 23)

fn main() {
    let msg = match env::args().collect::<Vec<_>>().get(1) {
        Some(val) => val.clone(),
        None => "Hello world (from vmw_backdoor)".to_string(),
    };

    let is_vmw = vmw::is_vmware_cpu();
    eprintln!("VMware CPU detected: {}.", is_vmw);
    if !is_vmw {
        panic!("Hypervisor not present");
    }

    let mut backdoor = vmw::probe_backdoor_privileged().unwrap();
    eprintln!("Got backdoor access.");

    let mut erpc = backdoor.open_enhanced_chan().unwrap();
    eprintln!("Got ERPC channel: {:?}.", erpc);

    erpc.log(&msg).unwrap();
    eprintln!("Sent log message: {}.", msg);
}

pub fn report_agent(&mut self) -> Result<(), VmwError>

Report agent (unmanaged) type.

Examples found in repository

examples/report-agent.rs (line 17)

fn main() {
    let is_vmw = vmw::is_vmware_cpu();
    eprintln!("VMware CPU detected: {}.", is_vmw);
    if !is_vmw {
        panic!("Hypervisor not present");
    }

    let mut backdoor = vmw::probe_backdoor_privileged().unwrap();
    eprintln!("Got backdoor access.");

    let mut erpc = backdoor.open_enhanced_chan().unwrap();
    eprintln!("Got ERPC channel: {:?}.", erpc);

    erpc.report_agent().unwrap();
    eprintln!("Reported agent.");
}

Trait Implementations

impl<'a> Debug for EnhancedChan<'a>

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

Formats the value using the given formatter.

impl<'a> Drop for EnhancedChan<'a>

fn drop(&mut self)

Executes the destructor for this type.