8 VBoxManage –timeout msec Value (in milliseconds) that specifies the time how long the started process is allowed to run and how long VBoxManage waits for getting output from that process. If no timeout is specified, VBoxManage will wait forever until the started process ends or an error occured. –username name Name of the user the process should run under. This user must exist on the guest OS. –password password Password of the user account specified with --username. If not given, an empty password is assumed. –verbose Tells VBoxManage to be more verbose. –wait-for action Tells VBoxManage to wait for a certain action to happen and react to it. The following actions are available: exit Waits until the process ends and outputs its exit code along with the exit rea- son/flags. stdout or stderr Waits until the process ends and outputs its exit code along with the exit reason/flags. After that VBoxManage retrieves the output collected from the guest process’s stdout and stderr. Note: On Windows there are certain limitations for graphical applications please see chapter 14, Known limitations, page 181 for more information. Examples: VBoxManage --nologo guestcontrol execute "My VM" "/bin/ls" --arguments "-l /usr" --username foo --password bar --wait-for stdout VBoxManage --nologo guestcontrol execute "My VM" "c:\\windows\\system32\\ipconfig.exe" --username foo --password bar --wait-for stdout Note that the double backslashes in the second example are only required on Unix hosts. • copyto, which allows copying files from the host to the guest (only with installed Guest Additions 4.0 and later). VBoxManage copyto|cp vmname|uuid source on host destination on guest --username name --password password [--dryrun] [--follow] [--recursive] [--verbose] where the parameters mean: uuid|vmname The VM UUID or VM name. Mandatory. source on host Absolute path of source file(s) on host to copy over to the guest, e.g. C:\Windows\System32\calc.exe. This also can be a wildcard expression, e.g. C:\Windows\System32\*.dll destination on guest Absolute destination path on the guest, e.g. C:\Temp –username name Name of the user the copy process should run under. This user must exist on the guest OS. –password password Password of the user account specified with --username. If not given, an empty password is assumed. –dryrun Tells VBoxManage to only perform a dry run instead of really copying files to the guest. –follow Enables following symlinks on the host’s source. –recursive Recursively copies files/directories of the specified source. –verbose Tells VBoxManage to be more verbose. –flags flags Additional flags to set. This is not used at the moment. 128