Struct GuestProgramSpec 

pub struct GuestProgramSpec {
    pub program_path: String,
    pub arguments: String,
    pub working_directory: Option<String>,
    pub env_variables: Option<Vec<String>>,
}

This describes the arguments to GuestProcessManager.StartProgramInGuest.

How to access

• GuestProcessManager::start_program_in_guest(spec)

Fields

program_path: String

The absolute path to the program to start.

For Linux guest operating systems, /bin/bash is used to start the program.

For Solaris guest operating systems, /bin/bash is used to start the program if it exists. Otherwise /bin/sh is used. If /bin/sh is used, then the process ID returned by GuestProcessManager.StartProgramInGuest will be that of the shell used to start the program, rather than the program itself, due to the differences in how /bin/sh and /bin/bash work. This PID will still be usable for watching the process with GuestProcessManager.ListProcessesInGuest to find its exit code and elapsed time.

arguments: String

The arguments to the program.

In Linux and Solaris guest operating systems, the program will be executed by a guest shell. This allows stdio redirection, but may also require that characters which must be escaped to the shell also be escaped on the command line provided.

For Windows guest operating systems, prefixing the command with “cmd /c” can provide stdio redirection.

working_directory: Option<String>

The absolute path of the working directory for the program to be run.

VMware recommends explicitly setting the working directory for the program to be run. If this value is unset or is an empty string, the behavior depends on the guest operating system. For Linux guest operating systems, if this value is unset or is an empty string, the working directory will be the home directory of the user associated with the guest authentication. For other guest operating systems, if this value is unset, the behavior is unspecified.

env_variables: Option<Vec<String>>

An array of environment variables, specified in the guest OS notation (eg PATH=c:\bin;c:\windows\system32 or LD_LIBRARY_PATH=/usr/lib:/lib), to be set for the program being run.

Note that these are not additions to the default environment variables; they define the complete set available to the program. If none are specified the values are guest dependent.

Trait Implementations

impl Debug for GuestProgramSpec

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

Formats the value using the given formatter.

impl Deserialize for GuestProgramSpec

fn begin(out: &mut Option<Self>) -> &mut dyn Visitor

The only correct implementation of this method is:

impl GuestProgramSpecTrait for GuestProgramSpec

fn get_guest_program_spec(&self) -> &GuestProgramSpec

Get a reference to the GuestProgramSpec parent struct

fn get_guest_program_spec_mut(&mut self) -> &mut GuestProgramSpec

Get a mutable reference to the GuestProgramSpec parent struct

impl Serialize for GuestProgramSpec

fn begin(&self) -> Fragment<'_>

impl VimObjectTrait for GuestProgramSpec

fn as_vim_object_ref<'a>(&'a self) -> &'a dyn VimObjectTrait

fn data_type(&self) -> StructType

impl DataObjectTrait for GuestProgramSpec