vix

func (*Error) Error ¶

func (e *Error) Error() string

Error returns a description of the error along with its code and operation implementing Go's error interface.

func (*Guest) CopyFileToHost ¶

func (g *Guest) CopyFileToHost(guestpath, hostpath string) error

CopyFileToHost copies a file or directory from the guest operating system to the local system (where the VIX client is running).

Parameters:

guestpath: The path name of a file on a file system available to the guest.
hostpath: The path name of a file on a file system available to the Vix
client.

func (*Guest) FileInfo ¶

func (g *Guest) FileInfo(filepath string) (*GuestFile, error)

FileInfo returns information about a file in the guest operating system.

Parameters:

filepath: The path name of the file in the guest.

Remarks:

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

Since VMware Workstation 6.5 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) IsDir ¶

func (g *Guest) IsDir(path string) (bool, error)

IsDir tests the existence of a directory in the guest operating system.

Parameters:

path: Directory path in the guest OS to be checked.

Remarks:

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) IsFile ¶

func (g *Guest) IsFile(filepath string) (bool, error)

IsFile tests the existence of a file in the guest operating system.

Parameters:

filepath: The path to the file to be tested.

Remarks:

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

• If filepath exists as a file system object, but is not a normal file (e.g. it is a directory, device, UNIX domain socket, etc), then VIX_OK is returned, and VIX_PROPERTY_JOB_RESULT_GUEST_OBJECT_EXISTS is set to FALSE.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) Kill ¶

func (g *Guest) Kill(pid uint64) error

Kill terminates a process in the guest operating system.

Parameters:

pid: The ID of the process to be killed.

Remarks:

• Depending on the behavior of the guest operating system, there may be a short delay after the job completes before the process truly disappears.

• Because of differences in how various Operating Systems handle process IDs, Vix may return either VIX_E_INVALID_ARG or VIX_E_NO_SUCH_PROCESS for invalid process IDs.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) Logout ¶

func (g *Guest) Logout() error

Logout removes any guest operating system authentication context created by a previous call to VM.LoginInGuest().

Remarks:

• This function has no effect and returns success if VM.LoginInGuest() has not been called.
• If you call this function while guest operations are in progress, subsequent operations may fail with a permissions error. It is best to wait for guest operations to complete before logging out.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) Ls ¶

func (g *Guest) Ls(dir string) ([]*GuestFile, error)

Ls lists a directory in the guest operating system.

Parameters:

dir: The path name of a directory to be listed.

Remarks:

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) MkDir ¶

func (g *Guest) MkDir(path string) error

MkDir creates a directory in the guest operating system.

Parameters:

path: Directory path to be created in the guest OS

Remarks:

• If the parent directories for the specified path do not exist, this function will create them.

• If the directory already exists, the error will be set to VIX_E_FILE_ALREADY_EXISTS.

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

Since Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) MkTemp ¶

func (g *Guest) MkTemp() (string, error)

MkTemp creates a temporary file in the guest operating system. The user is responsible for removing the file when it is no longer needed.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) Mv ¶

func (g *Guest) Mv(path1, path2 string) error

Mv renames a file or directory in the guest operating system.

Parameters:

path1: The path to the file to be renamed.
path2: The path to the new file.

Remarks:

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

• On Windows guests, it fails on directory moves when the destination is on a different volume.

• Because of the differences in how various operating systems handle filenames, Vix may return either VIX_E_INVALID_ARG or VIX_E_FILE_NAME_TOO_LONG for filenames longer than 255 characters.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) Ps ¶

func (g *Guest) Ps() ([]*GuestProcess, error)

Ps lists the running processes in the guest operating system.

Since Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) RmDir ¶

func (g *Guest) RmDir(path string) error

RmDir deletes a directory in the guest operating system. Any files or subdirectories in the specified directory will also be deleted.

Parameters:

path: Directory path to be deleted in the guest OS

Remarks:

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) RmFile ¶

func (g *Guest) RmFile(filepath string) error

RmFile deletes a file in the guest operating system.

Parameters:

filepath: file path to be deleted in the guest OS

Remarks:

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) RunProgram ¶

func (g *Guest) RunProgram(path, args string, options RunProgramOption) (uint64, int, int, error)

RunProgram runs a program in the guest operating system. The program must be stored on a file system available to the guest before calling this function.

Parameters:

path: The path name of an executable file on the guest operating system.
args: A string to be passed as command line arguments to the executable.
options: Run options for the program. See the remarks below.

Remarks:

• This function runs a program in the guest operating system. The program must be stored on a file system available to the guest before calling this function.

• The current working directory for the program in the guest is not defined. Absolute paths should be used for files in the guest, including command-line arguments.

• If the program to run in the guest is intended to be visible to the user in the guest, such as an application with a graphical user interface, you must call VM.LoginInGuest() with LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT as the option before calling this function. This will ensure that the program is run within a graphical session that is visible to the user.

• If the options parameter is RUNPROGRAM_WAIT, this function will block and return only when the program exits in the guest operating system. Alternatively, you can pass RUNPROGRAM_RETURN_IMMEDIATELY as the value of the options parameter, and this function will return as soon as the program starts in the guest.

• For Windows guest operating systems, when running a program with a graphical user interface, you can pass RUNPROGRAM_ACTIVATE_WINDOW as the value of the options parameter. This option will ensure that the application's window is visible and not minimized on the guest's screen. This can be combined with the RUNPROGRAM_RETURN_IMMEDIATELY flag using the bitwise inclusive OR operator (|). RUNPROGRAM_ACTIVATE_WINDOW has no effect on Linux guest operating systems.

• On a Linux guest operating system, if you are running a program with a graphical user interface, it must know what X Windows display to use, for example host:0.0, so it can make the program visible on that display. Do this by passing the -display argument to the program, if it supports that argument, or by setting the DISPLAY environment variable on the guest. See documentation on VM.WriteVariable()

• This functions returns three parameters: PROCESS_ID: the process id; however, if the guest has an older version of Tools (those released with Workstation 6 and earlier) and the RUNPROGRAM_RETURN_IMMEDIATELY flag is used, then the process ID will not be returned from the guest and this property will be 0 ELAPSED_TIME: the process elapsed time in seconds; EXIT_CODE: the process exit code. If the option parameter is RUNPROGRAM_RETURN_IMMEDIATELY, the latter two will both be 0.

• Depending on the behavior of the guest operating system, there may be a short delay after the job completes before the process is visible in the guest operating system. Sometimes you may want to use a goroutine to not block your app while this finishes.

Since VMware Server 1.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) RunScript ¶

func (g *Guest) RunScript(shell, args string, options RunProgramOption) (uint64, int, int, error)

RunScript runs a script in the guest operating system.

Parameters:

shell: The path to the script interpreter, or NULL to use cmd.exe as
the interpreter on Windows.

script: The text of the script.

options: Run options for the program. See the remarks below.

Remarks:

• This function runs the script in the guest operating system.

• The current working directory for the script executed in the guest is not defined. Absolute paths should be used for files in the guest, including the path to the shell or interpreter, and any files referenced in the script text.

• If the options parameter is RUNPROGRAM_WAIT, this function will block and return only when the program exits in the guest operating system. Alternatively, you can pass RUNPROGRAM_RETURN_IMMEDIATELY as the value of the options parameter, and this makes the function to return as soon as the program starts in the guest.

• The following properties will be returned: PROCESS_ID: the process id; however, if the guest has an older version of Tools (those released with Workstation 6 and earlier) and the RUNPROGRAM_RETURN_IMMEDIATELY flag is used, then the process ID will not be returned from the guest and this property will return 0. ELAPSED_TIME: the process elapsed time; PROGRAM_EXIT_CODE: the process exit code.

• If the option parameter is RUNPROGRAM_RETURN_IMMEDIATELY, the latter two will both be 0.

• Depending on the behavior of the guest operating system, there may be a short delay after the function returns before the process is visible in the guest operating system.

• If the total size of the specified interpreter and the script text is larger than 60536 bytes, then the error VIX_E_ARGUMENT_TOO_BIG is returned.

Since VMware Workstation 6.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Guest) SharedFoldersParentDir ¶

func (g *Guest) SharedFoldersParentDir() (string, error)

SharedFoldersParentDir returns the parent dir for share folders in the Guest.

func (*Host) CopyFileToGuest ¶

func (h *Host) CopyFileToGuest(src string, guest *Guest, dest string) error

CopyFileToGuest copies a file or directory from the local system (where the Vix client is running) to the guest operating system.

Parameters:

src: The path name of a file on a file system available to the Vix client.
guest: Guest instance where the file is going to be copied to
dest: The path name of a file on a file system available to the guest.

Remarks:

• The virtual machine must be running while the file is copied from the Vix client machine to the guest operating system.

• Existing files of the same name are overwritten, and folder contents are merged.

• The copy operation requires VMware Tools to be installed and running in the guest operating system.

• You must call VM.LoginInGuest() before calling this function in order to get a Guest instance.

• The format of the file name depends on the guest or local operating system. For example, a path name for a Microsoft Windows guest or host requires backslash as a directory separator, whereas a Linux guest or host requires a forward slash. If the path name includes backslash characters, you need to precede each one with an escape character.

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

• If any file fails to be copied, Vix aborts the operation, does not attempt to copy the remaining files, and returns an error.

• In order to copy a file to a mapped network drive in a Windows guest operating system, it is necessary to call VixVM_LoginInGuest() with the LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT flag set. Using the interactive session option incurs an overhead in file transfer speed.

Since VMware Server 1.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*Host) Disconnect ¶

func (h *Host) Disconnect()

Disconnect destroys the state for a particular host instance.

Call this function to disconnect the host. After you call this function the Host object is no longer valid and you should not longer use it. Similarly, you should not use any other object instances obtained from the Host object while it was connected.

Since VMware Server 1.0

func (*Host) FindItems ¶

func (h *Host) FindItems(options SearchType) ([]string, error)

FindItems finds VIX objects. For example, when used to find all running virtual machines, Host.FindItems() returns a series of virtual machine file path names.

func (*Host) OpenVM ¶

func (h *Host) OpenVM(vmxFile, password string) (*VM, error)

OpenVM opens a virtual machine on the host and returns a VM instance.

Parameters:

VmxFile: The path name of the virtual machine configuration file on the
local host.

Password: If VM is encrypted, this is the password for VIX to be able to
open it.

Remarks:

• This function opens a virtual machine on the host instance The virtual machine is identified by vmxFile, which is a path name to the configuration file (.VMX file) for that virtual machine.

• The format of the path name depends on the host operating system. For example, a path name for a Windows host requires backslash as a directory separator, whereas a Linux host requires a forward slash. If the path name includes backslash characters, you need to precede each one with an escape character. For VMware Server 2.x, the path contains a preceeding data store, for example [storage1] vm/vm.vmx.

• For VMware Server hosts, a virtual machine must be registered before you can open it. You can register a virtual machine by opening it with the VMware Server Console, through the vmware-cmd command with the register parameter, or with Host.RegisterVM().

• For vSphere, the virtual machine opened may not be the one desired if more than one Datacenter contains VmxFile.

• To open an encrypted virtual machine, pass its correspondent password.

Since VMware Workstation 7.0

func (*Host) RegisterVM ¶

func (h *Host) RegisterVM(vmxFile string) error

RegisterVM adds a virtual machine to the host's inventory.

Parameters:

vmxFile: The path name of the .vmx file on the host.

Remarks:

• This function registers the virtual machine identified by vmxFile, which is a storage path to the configuration file (.vmx) for that virtual machine. You can register a virtual machine regardless of its power state.

• The format of the path name depends on the host operating system. If the path name includes backslash characters, you need to precede each one with an escape character. Path to storage [standard] or [storage1] may vary.

• For VMware Server 1.x, supply the full path name instead of storage path, and specify provider VMWARE_SERVER to connect.

• This function has no effect on Workstation or Player, which lack a virtual machine inventory.

• It is not a Vix error to register an already-registered virtual machine, although the VMware Server UI shows an error icon in the Task pane. Trying to register a non-existent virtual machine results in error 2000, VIX_E_NOT_FOUND.

Since VMware Server 1.0

func (*Host) UnregisterVM ¶

func (h *Host) UnregisterVM(vmxFile string) error

UnregisterVM removes a virtual machine from the host's inventory.

Parameters:

VmxFile: The path name of the .vmx file on the host.

Remarks:

• This function unregisters the virtual machine identified by vmxFile, which is a storage path to the configuration file (.vmx) for that virtual machine. A virtual machine must be powered off to unregister it.
• The format of the storage path depends on the host operating system. If the storage path includes backslash characters, you need to precede each one with an escape character. Path to storage [standard] or [storage1] may vary.
• For VMware Server 1.x, supply the full path name instead of storage path, and specify VMWARE_SERVER provider to connect.
• This function has no effect on Workstation or Player, which lack a virtual machine inventory.
• It is not a Vix error to unregister an already-unregistered virtual machine, nor is it a Vix error to unregister a non-existent virtual machine.

Since VMware Server 1.0

func (*Snapshot) Child ¶

func (s *Snapshot) Child(index int) (*Snapshot, error)

Child returns the child snapshot corresponding to the index parameter.

Parameters:

index: Index into the list of snapshots.

Remarks:

• Snapshots are indexed from 0 to n-1, where n is the number of child snapshots. Use the function Snapshot.NumChildren() to get the value of n.
• This function is not supported when using the VMWARE_PLAYER provider.

Since VMware Workstation 6.0

func (*Snapshot) Description ¶

func (s *Snapshot) Description() (string, error)

Description returns user defined description for the snapshot.

func (*Snapshot) Name ¶

func (s *Snapshot) Name() (string, error)

Name returns user defined name for the snapshot.

func (*Snapshot) NumChildren ¶

func (s *Snapshot) NumChildren() (int, error)

NumChildren returns the number of child snapshots of a specified snapshot.

Remarks:

• This function is not supported when using the VMWARE_PLAYER provider.

Since VMware Workstation 6.0.

func (*Snapshot) Parent ¶

func (s *Snapshot) Parent() (*Snapshot, error)

Parent returns the parent of a snapshot.

Remarks:

• This function is not supported when using the VMWARE_PLAYER provider

Since VMware Workstation 6.0

func (*VM) AddNetworkAdapter ¶

func (v *VM) AddNetworkAdapter(adapter *NetworkAdapter) error

AddNetworkAdapter adds a network adapter to the virtual machine.

The "adapter" parameter is optional. If not specified this function will add, by default, a network adapter with NAT support; autogenerated MAC address, and e1000 as network device.

Be aware that the adapter will not show up in the VMware Preferences user interface immediatelly. Once the virtual machine is started the UI will pick it up.

func (*VM) AddSharedFolder ¶

func (v *VM) AddSharedFolder(guestpath, hostpath string, flags SharedFolderOption) error

AddSharedFolder mounts a new shared folder in the virtual machine.

Parameters:

guestpath: Specifies the guest path name of the new shared folder.
hostpath: Specifies the host path of the shared folder.
flags: The folder options.

Remarks:

• This function creates a local mount point in the guest file system and mounts a shared folder exported by the host.

• Shared folders will only be accessible inside the guest operating system if shared folders are enabled for the virtual machine. See the documentation for VM.EnableSharedFolders().

• The folder options include: SHAREDFOLDER_WRITE_ACCESS - Allow write access.

• Only absolute paths should be used for files in the guest; the resolution of relative paths is not specified.

• The hostpath argument must specify a path to a directory that exists on the host, or an error will result.

• If a shared folder with the same name exists before calling this function, the job handle returned by this function will return VIX_E_ALREADY_EXISTS.

• It is not necessary to call VM.LoginInGuest() before calling this function.

• When creating shared folders in a Windows guest, there might be a delay before contents of a shared folder are visible to functions such as Guest.IsFile() and Guest.RunProgram().

• Shared folders are not supported for the following guest operating systems: Windows ME, Windows 98, Windows 95, Windows 3.x, and DOS.

• In this release, this function requires the virtual machine to be powered on with VMware Tools installed.

• To determine in which directory in the guest the shared folder will be, query Guest.SharedFoldersParentDir(). When the virtual machine is powered on and the VMware Tools are running, this property will contain the path to the parent directory of the shared folders for that virtual machine.

Since VMware Workstation 6.0, not available on Server 2.0.

func (*VM) Annotation ¶

func (v *VM) Annotation() (string, error)

Annotation returns the description or annotations added to the virtual machine.

func (*VM) AttachCDDVD ¶

func (v *VM) AttachCDDVD(drive *CDDVDDrive) error

AttachCDDVD attaches a CD/DVD drive to the virtual machine.

func (*VM) CDDVD ¶

func (v *VM) CDDVD(ID string) (*CDDVDDrive, error)

CDDVD returns the CD/DVD drive identified by ID. This function depends entirely on how GoVMX identifies slice's elements

func (*VM) CDDVDs ¶

func (v *VM) CDDVDs() ([]*CDDVDDrive, error)

CDDVDs returns an unordered slice of currently attached CD/DVD devices on any bus.

func (*VM) Clone ¶

func (v *VM) Clone(cloneType CloneType, destVmxFile string) (*VM, error)

Clone creates a copy of the virtual machine specified by the current VM instance.

Parameters:

cloneType: Must be either CLONETYPE_FULL or CLONETYPE_LINKED.
  * CLONETYPE_FULL: Creates a full, independent clone of the virtual machine.
  * CLONETYPE_LINKED: Creates a linked clone, which is a copy of a virtual
    machine that shares virtual disks with the parent
    virtual machine in an ongoing manner.
    This conserves disk space as long as the parent and
    clone do not change too much from their original state.

destVmxFile: The path name of the virtual machine configuration file that will
  be created for the virtual machine clone produced by this operation.
  This should be a full absolute path name, with directory names delineated
  according to host system convention: \ for Windows and / for Linux.

Remarks:

• The function returns a new VM instance which is a clone of its parent VM.

• It is not possible to create a full clone of a powered on virtual machine. You must power off or suspend a virtual machine before creating a full clone of that machine.

• With a suspended virtual machine, requesting a linked clone results in error 3007 VIX_E_VM_IS_RUNNING. Suspended virtual machines retain memory state, so proceeding with a linked clone could cause loss of data.

• A linked clone must have access to the parent's virtual disks. Without such access, you cannot use a linked clone at all because its file system will likely be incomplete or corrupt.

• Deleting a virtual machine that is the parent of a linked clone renders the linked clone useless.

• Because a full clone does not share virtual disks with the parent virtual machine, full clones generally perform better than linked clones. However, full clones take longer to create than linked clones. Creating a full clone can take several minutes if the files involved are large.

• This function is not supported when using the VMWARE_PLAYER provider.

func (*VM) CreateSnapshot ¶

func (v *VM) CreateSnapshot(name, description string, options CreateSnapshotOption) (*Snapshot, error)

CreateSnapshot saves a copy of the virtual machine state as a snapshot object.

Parameters:

name: A user-defined name for the snapshot; need not be unique.

description: A user-defined description for the snapshot.

options: Flags to specify how the snapshot should be created. Any combination of the
following or 0 to exclude memory:
  * SNAPSHOT_INCLUDE_MEMORY: Captures the full state of a running virtual
    machine, including the memory.

Remarks:

• This function creates a child snapshot of the current snapshot.

• If a virtual machine is suspended, you cannot snapshot it more than once.

• If a powered-on virtual machine gets a snapshot created with option 0 (exclude memory), the power state is not saved, so reverting to the snapshot sets powered-off state.

• The 'name' and 'description' parameters can be set but not retrieved using the VIX API.

• VMware Server supports only a single snapshot for each virtual machine. The following considerations apply to VMware Server:

• If you call this function a second time for the same virtual machine without first deleting the snapshot, the second call will overwrite the previous snapshot.

• A virtual machine imported to VMware Server from another VMware product might have more than one snapshot at the time it is imported. In that case, you can use this function to add a new snapshot to the series.

• Starting in VMware Workstation 6.5, snapshot operations are allowed on virtual machines that are part of a team. Previously, this operation failed with error code VIX_PROPERTY_VM_IN_VMTEAM. Team members snapshot independently so they can have different and inconsistent snapshot states.

• This function is not supported when using the VMWARE_PLAYER provider.

• If the virtual machine is open and powered off in the UI, this function now closes the virtual machine in the UI before creating the snapshot.

Since VMware Workstation 6.0

func (*VM) CurrentSnapshot ¶

func (v *VM) CurrentSnapshot() (*Snapshot, error)

CurrentSnapshot returns the handle of the current active snapshot belonging to the virtual machine.

Remarks:

• This function returns the handle of the current active snapshot belonging to the virtual machine.

• This function is not supported when using the VMWARE_PLAYER provider

Since VMware Workstation 6.0

func (*VM) Delete ¶

func (v *VM) Delete(options VmDeleteOption) error

Delete permanently deletes a virtual machine from your host system.

Parameters:

options: For VMware Server 2.0 and ESX, this value must be VMDELETE_DISK_FILES.
For all other versions it can be either VMDELETE_KEEP_FILES or VMDELETE_DISK_FILES.
When option is VMDELETE_DISK_FILES, it deletes all associated files.
When option is VMDELETE_KEEP_FILES, does not delete *.vmdk virtual disk file(s).

Remarks:

• This function permanently deletes a virtual machine from your host system. You can accomplish the same effect by deleting all virtual machine files using the host file system. This function simplifies the task by deleting all VMware files in a single function call. If a deleteOptions value of VMDELETE_KEEP_FILES is specified, the virtual disk (vmdk) files will not be deleted. This function does not delete other user files in the virtual machine folder.

• This function is successful only if the virtual machine is powered off or suspended.

• Deleting a virtual machine that is the parent of a linked clone renders the linked clone useless.

• If the machine was powered on with GUI enabled, this function is going to return error VIX_E_FILE_ALREADY_LOCKED if the VM tab is open. If you want to force the removal despite this, pass the option VMDELETE_FORCE.

since VMware Server 1.0

func (*VM) DetachCDDVD ¶

func (v *VM) DetachCDDVD(drive *CDDVDDrive) error

DetachCDDVD detaches a CD/DVD device from the virtual machine.

func (*VM) DisplayName ¶

func (v *VM) DisplayName() (string, error)

DisplayName gets virtual machine name.

func (*VM) EnableSharedFolders ¶

func (v *VM) EnableSharedFolders(enabled bool) error

EnableSharedFolders enables or disables all shared folders as a feature for a virtual machine.

Remarks:

• This function enables/disables all shared folders as a feature on a virtual machine. In order to access shared folders on a guest, the feature has to be enabled, and in addition, the individual shared folder has to be enabled.

• It is not necessary to call VM.LoginInGuest() before calling this function.

• In this release, this function requires the virtual machine to be powered on with VMware Tools installed.

• Shared folders are not supported for the following guest operating systems: Windows ME, Windows 98, Windows 95, Windows 3.x, and DOS.

• On Linux virtual machines, calling this function will automatically mount shared folder(s) in the guest.

Since VMware Workstation 6.0, not available on Server 2.0. Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*VM) GuestOS ¶

func (v *VM) GuestOS() (string, error)

GuestOS returns the guest os.

func (*VM) IPAddress ¶

func (v *VM) IPAddress() (string, error)

IPAddress returns the VM IP Address as reported by VMWare Tools.

func (*VM) InVMTeam ¶

func (v *VM) InVMTeam() (bool, error)

InVMTeam returns whether the virtual machine is a member of a team.

func (*VM) InstallTools ¶

func (v *VM) InstallTools(options InstallToolsOption) error

InstallTools prepares to install VMware Tools on the guest operating system.

Parameters:

options: May be either INSTALLTOOLS_MOUNT_TOOLS_INSTALLER or
INSTALLTOOLS_AUTO_UPGRADE. Either flag can be combined with the
INSTALLTOOLS_RETURN_IMMEDIATELY flag using the bitwise inclusive
OR operator (|). See remarks for more information.

Remarks:

• If the option INSTALLTOOLS_MOUNT_TOOLS_INSTALLER is provided, the function prepares an ISO image to install VMware Tools on the guest operating system. If autorun is enabled, as it often is on Windows, installation begins, otherwise you must initiate installation. If VMware Tools is already installed, this function prepares to upgrade it to the version matching the product.

• If the option VIX_INSTALLTOOLS_AUTO_UPGRADE is provided, the function attempts to automatically upgrade VMware Tools without any user interaction required, and then reboots the virtual machine. This option requires that a version of VMware Tools already be installed. If VMware Tools is not already installed, the function will fail.

• When the option INSTALLTOOLS_AUTO_UPGRADE is used on virtual machine with a Windows guest operating system, the upgrade process may cause the Windows guest to perform a controlled reset in order to load new device drivers. If you intend to perform additional guest operations after upgrading the VMware Tools, it is recommanded that after this task completes, that the guest be reset using VM.Reset() with the VMPOWEROP_FROM_GUEST flag, followed by calling VM.WaitForToolsInGuest() to ensure that the guest has reached a stable state.

• If the option INSTALLTOOLS_AUTO_UPGRADE is provided and the newest version of tools is already installed, the function will return successfully. Some older versions of Vix may return VIX_E_TOOLS_INSTALL_ALREADY_UP_TO_DATE.

• If the INSTALLTOOLS_RETURN_IMMEDIATELY flag is set, this function will return immediately after mounting the VMware Tools ISO image.

• If the INSTALLTOOLS_RETURN_IMMEDIATELY flag is not set for a WS host, this function will return only after the installation successfully completes or is cancelled.

• The virtual machine must be powered on to do this operation.

• If the Workstation installer calls for an ISO file that is not downloaded, this function returns an error, rather than attempting to download the ISO file.

Since VMware Server 1.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*VM) IsRunning ¶

func (v *VM) IsRunning() (bool, error)

IsRunning returns whether the virtual machine is running.

func (*VM) LoginInGuest ¶

func (v *VM) LoginInGuest(username, password string, options GuestLoginOption) (*Guest, error)

LoginInGuest establishes a guest operating system authentication context returning an instance of the Guest object.

Parameters:

username: The name of a user account on the guest operating system.

password: The password of the account identified by username

options: Must be LOGIN_IN_GUEST_NONE or
LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT - directs guest
commands invoked after the call to VM.LoginInGuest() to be run from within
the session of the user who is interactively logged into the guest operating
system.

See the remarks below for more information about LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT.

Remarks:

• This function validates the account name and password in the guest OS.

• You must call this function before calling functions that perform operations on the guest OS, such as those below. Otherwise you do not need to call this function.

• Logins are supported on Linux and Windows. To log in as a Windows Domain user, specify the 'username' parameter in the form "domain\username".

• This function does not respect access permissions on Windows 95, Windows 98, and Windows ME, due to limitations of the permissions model in those systems.

• Other guest operating systems are not supported for login, including Solaris, FreeBSD, and Netware.

• The option LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT should be used to ensure that the functions Guest.CaptureScreenImage(), and Guest.RunProgramInGuest() work correctly.

• All guest operations for a particular VM are done using the identity you provide to VM.LoginInGuest(). As a result, guest operations are restricted by file system privileges in the guest OS that apply to the user specified in VM.LoginInGuest(). For example, Guest.RmDir() might fail if the user named in VM.LoginInGuest() does not have access permissions to the directory in the guest OS.

• VM.LoginInGuest() changes the behavior of Vix functions to use a user account. It does not log a user into a console session on the guest OS. As a result, you might not see the user logged in from within the guest OS. Moreover, operations such as rebooting the guest do not clear the guest credentials.

• The virtual machine must be powered on before calling this function.

• VMware Tools must be installed and running on the guest OS before calling this function.

• You can call VM.WaitForToolsInGuest() to wait for the tools to run.

• Once VM.LoginInGuest() has succeeded, the user session remains valid until Guest.Logout() is called successfully, VM.LoginInGuest() is called successfully with different user credentials, the virtual machine handle's reference count reaches 0, or the client applications exits.

• The special login type VIX_CONSOLE_USER_NAME is no longer supported.

• Calling VM.LoginInGuest() with LOGIN_IN_GUEST_NONE as 'options' can be done at any time when the VMware Tools are running in the guest.

• Calling VM.LoginInGuest() with the LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT flag can only be done when there is an interactive user logged into the guest OS. Specifically, the "interactive user" refers to the user who has logged into the guest OS through the console (for instance, the user who logged into the Windows log-in screen).

• The VIX user is the user whose credentials are being provided in the call to VM.LoginInGuest().

• With LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT, there must be an interactive user logged into the guest when the call to VM.LoginInGuest() is made, and the VIX user must match the interactive user (they must have same account in the guest OS).

• Using LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT will ensure that the environment in which guest commands are executed is as close as possible to the normal environment in which a user interacts with the guest OS. Without LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT, commands may be run in a more limited environment; however, omitting LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT will ensure that commands can be run regardless of whether an interactive user is present in the guest.

• On Linux guest operating systems, the LOGIN_IN_GUEST_REQUIRE_INTERACTIVE_ENVIRONMENT flag requires that X11 be installed and running.

Since VMware Server 1.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*VM) MemorySize ¶

func (v *VM) MemorySize() (uint, error)

MemorySize returns memory size of the virtual machine.

func (*VM) NetworkAdapters ¶

func (v *VM) NetworkAdapters() ([]*NetworkAdapter, error)

NetworkAdapters lists current network adapters attached to the virtual machine.

func (*VM) Pause ¶

func (v *VM) Pause() error

Pause pauses a virtual machine. See Remarks section for pause behavior when used with different operations.

Remarks:

• This stops execution of the virtual machine.

• Functions that invoke guest operations should not be called when the virtual machine is paused.

• Call VM.Resume() to continue execution of the virtual machine.

• Calling VM.Reset(), VM.PowerOff(), and VM.Suspend() will successfully work when paused. The pause state is not preserved in a suspended virtual machine; a subsequent VM.PowerOn() will not remember the previous pause state.

• This function is not supported when using the VMWARE_PLAYER provider

Since VMware Workstation 6.5.

func (*VM) PowerOff ¶

func (v *VM) PowerOff(options VMPowerOption) error

PowerOff powers off a virtual machine.

Parameters:

options: Set of VMPowerOption flags to consider when powering off the
virtual machine.

Remarks:

• If you call this function while the virtual machine is suspended or powered off, the operation returns a VIX_E_VM_NOT_RUNNING error. If suspended, the virtual machine remains suspended and is not powered off. If powered off, you can safely ignore the error.

• If you pass VMPOWEROP_NORMAL as an option, the virtual machine is powered off at the hardware level. Any state of the guest that was not committed to disk will be lost.

• If you pass VMPOWEROP_FROM_GUEST as an option, the function tries to power off the guest OS, ensuring a clean shutdown of the guest. This option requires that VMware Tools be installed and running in the guest.

• After VMware Tools begin running in the guest, and VM.WaitForToolsInGuest() returns, there is a short delay before VMPOWEROP_FROM_GUEST becomes available. During this time a job may return error 3009, VIX_E_POWEROP_SCRIPTS_NOT_AVAILABLE. As a workaround, add a short sleep after the WaitForTools call.

• On a Solaris guest with UFS file system on the root partition, the VMPOWEROP_NORMAL parameter causes an error screen at next power on, which requires user intervention to update the Solaris boot archive by logging into the failsafe boot session from the GRUB menu. Hence, although UFS file systems are supported, VMware recommends using the ZFS file system for Solaris guests.

Since VMware Server 1.0

func (*VM) PowerOn ¶

func (v *VM) PowerOn(options VMPowerOption) error

PowerOn powers on a virtual machine.

Parameters:

options: VMPOWEROP_NORMAL or VMPOWEROP_LAUNCH_GUI.

Remarks:

• This operation completes when the virtual machine has started to boot. If the VMware Tools have been installed on this guest operating system, you can call VM.WaitForToolsInGuest() to determine when the guest has finished booting.

• After powering on, you must call VM.WaitForToolsInGuest() before executing guest operations or querying guest properties.

• In Server 1.0, when you power on a virtual machine, the virtual machine is powered on independent of a console window. If a console window is open, it remains open. Otherwise, the virtual machine is powered on without a console window.

• To display a virtual machine with a Workstation user interface, the options parameter must have the VMPOWEROP_LAUNCH_GUI flag, and you must be connected to the host with the VMWARE_WORKSTATION provider flag. If there is an existing instance of the Workstation user interface, the virtual machine will power on in a new tab within that instance. Otherwise, a new instance of Workstation will open, and the virtual machine will power on there.

• To display a virtual machine with a Player user interface, the options parameter must have the VMPOWEROP_LAUNCH_GUI flag, and you must be connected to the host with the VMWARE_PLAYER flag. A new instance of Player will always open, and the virtual machine will power on there.

• This function can also be used to resume execution of a suspended virtual machine.

• The VMPOWEROP_LAUNCH_GUI option is not supported for encrypted virtual machines; attempting to power on with this option results in VIX_E_NOT_SUPPORTED.

Since VMware Server 1.0

func (*VM) PowerState ¶

func (v *VM) PowerState() (VMPowerState, error)

PowerState returns power state of the virtual machine.

func (*VM) ReadOnly ¶

func (v *VM) ReadOnly() (bool, error)

ReadOnly tells whether or not the VM is read-only.

func (*VM) ReadVariable ¶

func (v *VM) ReadVariable(varType GuestVarType, name string) (string, error)

ReadVariable reads variables from the virtual machine state. This includes the virtual machine configuration, environment variables in the guest, and VMware "Guest Variables"

Parameters:

varType: The type of variable to read. The currently supported values are:
  * VM_GUEST_VARIABLE: A "Guest Variable". This is a runtime-only
    value; it is never stored persistently. This is the same guest
    variable that is exposed through the VMControl APIs, and is a simple
    way to pass runtime values in and out of the guest.

  * VM_CONFIG_RUNTIME_ONLY: The configuration state of the virtual machine.
    This is the .vmx file that is stored on the host. You can read this and
    it will return the persistent data. If you write to this, it will only
    be a runtime change, so changes will be lost when the VM powers off.

  * GUEST_ENVIRONMENT_VARIABLE: An environment variable in the guest of
    the VM. On a Windows NT series guest, writing these values is saved
    persistently so they are immediately visible to every process.
    On a Linux or Windows 9X guest, writing these values is not persistent
    so they are only visible to the VMware tools process.

name: The name of the variable.

Remarks:

• You must call VM.LoginInGuest() before calling this function to read a GUEST_ENVIRONMENT_VARIABLE value.

• You do not have to call VM.LoginInGuest() to use this function to read a VM_GUEST_VARIABLE or a VVM_CONFIG_RUNTIME_ONLY value.

Since Workstation 6.0

func (*VM) RemoveAllCDDVDDrives ¶

func (v *VM) RemoveAllCDDVDDrives() error

RemoveAllCDDVDDrives deletes all the CD/DVD drives from the VM's VMX file.

func (*VM) RemoveAllNetworkAdapters ¶

func (v *VM) RemoveAllNetworkAdapters() error

RemoveAllNetworkAdapters deletes all network adapters from a VM.

func (*VM) RemoveNetworkAdapter ¶

func (v *VM) RemoveNetworkAdapter(adapter *NetworkAdapter) error

RemoveNetworkAdapter deletes network adapter from VMX file that matches the ID in "adapter.Id".

func (*VM) RemoveSharedFolder ¶

func (v *VM) RemoveSharedFolder(guestpath string) error

RemoveSharedFolder removes a shared folder in the virtual machine.

Parameters:

guestpath: Specifies the guest pathname of the shared folder to delete.

Remarks:

• This function removes a shared folder in the virtual machine referenced by the VM object

• It is not necessary to call VM.LoginInGuest() before calling this function.

• Shared folders are not supported for the following guest operating systems: Windows ME, Windows 98, Windows 95, Windows 3.x, and DOS.

• In this release, this function requires the virtual machine to be powered on with VMware Tools installed.

• Depending on the behavior of the guest operating system, when removing shared folders, there might be a delay before the shared folder is no longer visible to programs running within the guest operating system and to functions such as Guest.IsFile()

Since VMware Workstation 6.0

func (*VM) RemoveSnapshot ¶

func (v *VM) RemoveSnapshot(snapshot *Snapshot, options RemoveSnapshotOption) error

RemoveSnapshot deletes all saved states for the snapshot.

Parameters:

snapshot: A Snapshot instance. Call VM.RootSnapshot() to get a snapshot instance.

Remarks:

• This function deletes all saved states for the specified snapshot. If the snapshot was based on another snapshot, the base snapshot becomes the new root snapshot.

• The VMware Server release of the VIX API can manage only a single snapshot for each virtual machine. A virtual machine imported from another VMware product can have more than one snapshot at the time it is imported. In that case, you can delete only a snapshot subsequently added using the VIX API.

• Starting in VMware Workstation 6.5, snapshot operations are allowed on virtual machines that are part of a team. Previously, this operation failed with error code VIX_PROPERTY_VM_IN_VMTEAM. Team members snapshot independently so they can have different and inconsistent snapshot states.

• This function is not supported when using the VMWARE_PLAYER provider

• If the virtual machine is open and powered off in the UI, this function may close the virtual machine in the UI before deleting the snapshot.

Since VMware Server 1.0

func (*VM) Reset ¶

func (v *VM) Reset(options VMPowerOption) error

Reset resets a virtual machine.

Parameters:

options: Must be VMPOWEROP_NORMAL or VMPOWEROP_FROM_GUEST.

Remarks:

• If the virtual machine is not powered on when you call this function, it returns an error.

• If you pass VMPOWEROP_NORMAL as an option, this function is the equivalent of pressing the reset button on a physical machine.

• If you pass VMPOWEROP_FROM_GUEST as an option, this function tries to reset the guest OS, ensuring a clean shutdown of the guest. This option requires that the VMware Tools be installed and running in the guest.

• After VMware Tools begin running in the guest, and VM.WaitForToolsInGuest() returns, there is a short delay before VMPOWEROP_FROM_GUEST becomes available. During this time the function may return error 3009, VIX_E_POWEROP_SCRIPTS_NOT_AVAILABLE. As a workaround, add a short sleep after the WaitForTools call.

• After reset, you must call VM.WaitForToolsInGuest() before executing guest operations or querying guest properties.

• On a Solaris guest with UFS file system on the root partition, the VMPOWEROP_NORMAL parameter causes an error screen at next power on, which requires user intervention to update the Solaris boot archive by logging into the failsafe boot session from the GRUB menu. Hence, although UFS file systems are supported, VMware recommends using the ZFS file system for Solaris guests.

Since VMware Server 1.0

func (*VM) Resume ¶

func (v *VM) Resume() error

Resume continues execution of a paused virtual machine.

Remarks:

• This operation continues execution of a virtual machine that was stopped using VM.Pause().

• Refer to VM.Pause() for pause/unpause behavior with different operations.

• This function is not supported when using the VMWARE_PLAYER provider

Since VMware Workstation 6.5

func (*VM) RevertToSnapshot ¶

func (v *VM) RevertToSnapshot(snapshot *Snapshot, options VMPowerOption) error

RevertToSnapshot restores the virtual machine to the state when the specified snapshot was created.

Parameters:

snapshot: A Snapshot instance. Call VVM.GetRootSnapshot() to get a snapshot
instance.

options: Any applicable VMPowerOption. If the virtual machine was powered on
when the snapshot was created, then this will determine how the
virtual machine is powered back on. To prevent the virtual machine
from being powered on regardless of the power state when the
flag. VMPOWEROP_SUPPRESS_SNAPSHOT_POWERON is mutually exclusive
to all other VMPowerOpOptions.

Remarks:

• Restores the virtual machine to the state when the specified snapshot was created. This function can power on, power off, or suspend a virtual machine. The resulting power state reflects the power state when the snapshot was created.

• When you revert a powered on virtual machine and want it to display in the Workstation user interface, options must have the VMPOWEROP_LAUNCH_GUI flag, unless the VMPOWEROP_SUPPRESS_SNAPSHOT_POWERON is used.

• The ToolsState property of the virtual machine is undefined after the snapshot is reverted.

• Starting in VMware Workstation 6.5, snapshot operations are allowed on virtual machines that are part of a team. Previously, this operation failed with error code PROPERTY_VM_IN_VMTEAM. Team members snapshot independently so they can have different and inconsistent snapshot states.

• This function is not supported when using the VMWARE_PLAYER provider

• If the virtual machine is open and powered off in the UI, this function now closes the virtual machine in the UI before reverting to the snapshot. To refresh this property, you must wait for tools in the guest.

• After reverting to a snapshot, you must call VM.WaitForToolsInGuest() before executing guest operations or querying guest properties.

Since VMware Server 1.0

func (*VM) RootSnapshot ¶

func (v *VM) RootSnapshot(index int) (*Snapshot, error)

RootSnapshot returns a root Snapshot instance belonging to the current virtual machine.

Parameters:

index: Identifies a root snapshot. See below for range of values.

Remarks:

• Snapshots are indexed from 0 to n-1, where n is the number of root snapshots. Use the function VM.TotalRootSnapshots to get the value of n.

• VMware Server can manage only a single snapshot for each virtual machine. The value of index can only be 0.

• This function is not supported when using the VMWARE_PLAYER provider

Since VMware Server 1.0

func (*VM) Screenshot ¶

func (v *VM) Screenshot() ([]byte, error)

Screenshot captures the screen of the guest operating system.

Remarks:

• This function captures the current screen image and returns it as a []byte result.

• For security reasons, this function requires a successful call to VM.LoginInGuest() must be made.

Since VMware Workstation 6.5 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*VM) SetAnnotation ¶

func (v *VM) SetAnnotation(text string) error

SetAnnotation sets annotations for the virtual machine.

func (*VM) SetDisplayName ¶

func (v *VM) SetDisplayName(name string) error

SetDisplayName sets virtual machine name.

func (*VM) SetMemorySize ¶

func (v *VM) SetMemorySize(size uint) error

SetMemorySize sets memory size in megabytes. VM has to be powered off in order to change this parameter.

func (*VM) SetNumberVcpus ¶

func (v *VM) SetNumberVcpus(vcpus uint) error

SetNumberVcpus sets number of virtual cpus assigned to this machine. VM has to be powered off in order to change this parameter.

func (*VM) SetSharedFolderState ¶

func (v *VM) SetSharedFolderState(name, hostpath string, options SharedFolderOption) error

SetSharedFolderState modifies the state of a shared folder mounted in the virtual machine.

Parameters:

name: Specifies the name of the shared folder.
hostpath: Specifies the host path of the shared folder.
options: The new flag settings.

Remarks:

• This function modifies the state flags of an existing shared folder.

• If the shared folder does not exist before calling this function, the function will return a not found error.

• Shared folders are not supported for the following guest operating systems: Windows ME, Windows 98, Windows 95, Windows 3.x, and DOS.

• In this release, this function requires the virtual machine to be powered on with VMware Tools installed.

Since VMware Workstation 6.0

func (*VM) SetVirtualHwVersion ¶

func (v *VM) SetVirtualHwVersion(version string) error

SetVirtualHwVersion sets a virtual hardware version in the VMX file of the VM.

func (*VM) SharedFolderState ¶

func (v *VM) SharedFolderState(index int) (string, string, int, error)

SharedFolderState returns the state of a shared folder mounted in the virtual machine.

Parameters:

index: Identifies the shared folder

Remarks:

• Shared folders are indexed from 0 to n-1, where n is the number of shared folders. Use the function VM.NumSharedFolders() to get the value of n.

• Shared folders are not supported for the following guest operating systems: Windows ME, Windows 98, Windows 95, Windows 3.x, and DOS.

• In this release, this function requires the virtual machine to be powered on with VMware Tools installed.

Since VMware Workstation 6.0

func (*VM) SnapshotByName ¶

func (v *VM) SnapshotByName(name string) (*Snapshot, error)

SnapshotByName returns a Snapshot object matching the given name.

Parameters:

name: Identifies a snapshot name.

Remarks:

• When the snapshot name is a duplicate, it returns error 13017 VIX_E_SNAPSHOT_NONUNIQUE_NAME.

• When there are multiple snapshots with the same name, or the same path to that name, you cannot specify a unique name, but you can to use the UI to rename duplicates.

• You can specify the snapshot name as a path using '/' or '\\' as path separators, including snapshots in the tree above the named snapshot, for example 'a/b/c' or 'x/x'. Do not mix '/' and '\\' in the same path expression.

• This function is not supported when using the VMWARE_PLAYER provider.

Since VMware Workstation 6.0

func (*VM) Suspend ¶

func (v *VM) Suspend() error

Suspend suspends a virtual machine.

Remarks:

• If the virtual machine is not powered on when you call this function, the function returns the error VIX_E_VM_NOT_RUNNING.

• Call VM.PowerOn() to resume running a suspended virtual machine.

Since VMware Server 1.0

func (*VM) ToolsState ¶

func (v *VM) ToolsState() (GuestToolsState, error)

ToolsState returns state of the VMware Tools suite in the guest.

func (*VM) TotalRootSnapshots ¶

func (v *VM) TotalRootSnapshots() (int, error)

TotalRootSnapshots returns the number of top-level (root) snapshots belonging to a virtual machine.

Remarks:

• This function returns the number of top-level (root) snapshots belonging to a virtual machine. A top-level snapshot is one that is not based on any previous snapshot. If the virtual machine has more than one snapshot, the snapshots can be a sequence in which each snapshot is based on the previous one, leaving only a single top-level snapshot. However, if applications create branched trees of snapshots, a single virtual machine can have several top-level snapshots.

• VMware Server can manage only a single snapshot for each virtual machine. All other snapshots in a sequence are ignored. The return value is always 0 or 1.

• This function is not supported when using the VMWARE_PLAYER provider

Since VMware Workstation 6.0

func (*VM) TotalSharedFolders ¶

func (v *VM) TotalSharedFolders() (int, error)

TotalSharedFolders returns the number of shared folders mounted in the virtual machine.

Remarks:

• This function returns the number of shared folders mounted in the virtual machine.

• It is not necessary to call VM.LoginInGuest() before calling this function.

• Shared folders are not supported for the following guest operating systems: Windows ME, Windows 98, Windows 95, Windows 3.x, and DOS.

• In this release, this function requires the virtual machine to be powered on with VMware Tools installed.

Since VMware Workstation 6.0

func (*VM) UpgradeVHardware ¶

func (v *VM) UpgradeVHardware() error

UpgradeVHardware upgrades the virtual hardware version of the virtual machine to match the version of the VIX library. This has no effect if the virtual machine is already at the same version or at a newer version than the VIX library.

Remarks:

• The virtual machine must be powered off to do this operation.
• When the VM is already up-to-date, the function returns without errors.
• This function is not supported when using the VMWARE_PLAYER provider.

Since VMware Server 1.0

func (*VM) VMTeamPath ¶

func (v *VM) VMTeamPath() (string, error)

VMTeamPath returns path to the virtual machine team.

func (*VM) Vcpus ¶

func (v *VM) Vcpus() (uint8, error)

Vcpus returns number of virtual CPUs configured for the virtual machine.

func (*VM) VmxPath ¶

func (v *VM) VmxPath() (string, error)

VmxPath returns path to the virtual machine configuration file.

func (*VM) WaitForToolsInGuest ¶

func (v *VM) WaitForToolsInGuest(timeout time.Duration) error

WaitForToolsInGuest signals the job handle when VMware Tools has successfully started in the guest operating system. VMware Tools is a collection of services that run in the guest.

Parameters:

timeout: The timeout in seconds. If VMware Tools has not started by
this time, the operation completes with an error.
If the value of this argument is zero or negative, then this
operation will wait indefinitely until the VMware Tools start
running in the guest operating system.

Remarks:

• This function signals the job when VMware Tools has successfully started in the guest operating system. VMware Tools is a collection of services that run in the guest.

• VMware Tools must be installed and running for some Vix functions to operate correctly. If VMware Tools is not installed in the guest operating system, or if the virtual machine is not powered on, this function reports an error.

• The ToolsState property of the virtual machine object is undefined until VM.WaitForToolsInGuest() reports that VMware Tools is running.

• This function should be called after calling any function that resets or reboots the state of the guest operating system, but before calling any functions that require VMware Tools to be running. Doing so assures that VMware Tools are once again up and running. Functions that reset the guest operating system in this way include:

• VM.PowerOn()

• VM.Reset()

• VM.RevertToSnapshot()

Since VMware Server 1.0 Minimum Supported Guest OS: Microsoft Windows NT Series, Linux

func (*VM) WriteVariable ¶

func (v *VM) WriteVariable(varType GuestVarType, name, value string) error

WriteVariable writes variables to the virtual machine state. This includes the virtual machine configuration, environment variables in the guest, and VMware "Guest Variables".

Parameters:

varType: The type of variable to write. The currently supported values are:
  * VM_GUEST_VARIABLE: A "Guest Variable". This is a runtime-only value;
    it is never stored persistently. This is the same guest variable that
    is exposed through the VMControl APIs, and is a simple way to
    pass runtime values in and out of the guest.

  * VM_CONFIG_RUNTIME_ONLY: The configuration state of the virtual
    machine. This is the .vmx file that is stored on the host.
    You can read this and it will return the persistent data. If you write
    to this, it will only be a runtime change, so changes will be lost
    when the VM powers off. Not supported on ESX hosts.

  * GUEST_ENVIRONMENT_VARIABLE: An environment variable in the guest of
    the VM. On a Windows NT series guest, writing these values is saved
    persistently so they are immediately visible to every process.
    On a Linux or Windows 9X guest, writing these values is not persistent
    so they are only visible to the VMware tools process. Requires root
    or Administrator privilege.

name: The name of the variable.
value: The value to be written.

Remarks:

• The VM_CONFIG_RUNTIME_ONLY variable type is not supported on ESX hosts.

• You must call VM.LoginInGuest() before calling this function to write a GUEST_ENVIRONMENT_VARIABLE value. You do not have to call VM.LoginInGuest() to use this function to write a VM_GUEST_VARIABLE or a VM_CONFIG_RUNTIME_ONLY value.

• Do not use the slash '/' character in a VM_GUEST_VARIABLE variable name; doing so produces a VIX_E_INVALID_ARG error.

• Do not use the equal '=' character in the value parameter; doing so produces a VIX_E_INVALID_ARG error.

• On Linux guests, you must login as root to change environment variables (when variable type is GUEST_ENVIRONMENT_VARIABLE) otherwise it produces a VIX_E_GUEST_USER_PERMISSIONS error.

• On Windows Vista guests, when variable type is GUEST_ENVIRONMENT_VARIABLE, you must turn off User Account Control (UAC) in Control Panel > User Accounts > User Accounts > Turn User Account on or off, in order for this function to work.

Since VMware Workstation 6.0

func (*VMXFile) Read ¶

func (vmxfile *VMXFile) Read() error

Read reads VMX file from disk and unmarshals it

func (*VMXFile) Write ¶

func (vmxfile *VMXFile) Write() error

Write marshals and writes VMX file to disk