Page 1 of 1
[REOPENED] Docs for GuestControl Execute outdated
Posted: 1. Jul 2011, 16:48
by Technologov
Host: Win7 x64 + 4.1.0_BETA1
Guest: RHEL 5 / 32 + GA 4.1.0_BETA1
Docs 8.29. VBoxManage guestcontrol gives example:
VBoxManage --nologo guestcontrol execute "My VM" "/bin/ls" --arguments "-l /usr"
--username foo --password bar --wait-for stdout
It fails.
1. execute must be after VM name
2. --arguments parameter no longer exists
3. --wait-for parameter no longer exists
Any ideas ?
Re: GuestControl Execute fails
Posted: 4. Jul 2011, 14:26
by pentagonik
The documentation was not updated accordingly. Please refer to the built-in VBoxManage command line help for now. This will be fixed in the next upcoming beta. Thanks for noticing!
Re: GuestControl Execute fails
Posted: 9. Jul 2011, 18:58
by Technologov
Examples are still bad with BETA2.
Reopened.
Plz provide me with examples here, so I can test GuestAdditions.
Re: [REOPENED] GuestControl Execute fails
Posted: 11. Jul 2011, 09:45
by pentagonik
What exactly you didn't understand wrt guest execution? The VBoxManage reference now should contain everything you need to start/handle a guest process.
Re: [REOPENED] GuestControl Execute fails
Posted: 11. Jul 2011, 13:25
by Technologov
Docs are still outdated, and examples wrong.
Renamed bug accordingly.
Re: [REOPENED] Docs for GuestControl Execute outdated
Posted: 11. Jul 2011, 19:45
by Sasquatch
You ask for examples, but you don't give them either. Give some, get some.
Re: [REOPENED] Docs for GuestControl Execute outdated
Posted: 11. Jul 2011, 20:04
by Technologov
8.29. VBoxManage guestcontrol
1. General syntax is incorrect:
Code: Select all
VBoxManage guestcontrol exec[ute] <vmname>|<uuid>
--image <path to program>
--username <name> --password <password>
[--environment "<NAME>=<VALUE> [<NAME>=<VALUE>]"]
[--flags <flags>] [--timeout <msec>]
[--verbose] [--wait-exit] [--wait-stdout] [--wait-stderr]
-- [[<argument1>] ... [<argumentN>]]
Must be:
Code: Select all
VBoxManage guestcontrol <vmname>|<uuid> exec[ute]
--image <path to program>
--username <name> --password <password>
[--environment "<NAME>=<VALUE> [<NAME>=<VALUE>]"]
[--flags <flags>] [--timeout <msec>]
[--verbose] [--wait-exit] [--wait-stdout] [--wait-stderr]
-- [[<argument1>] ... [<argumentN>]]
(execute after VM name)
2. arguments parameter syntax:
Code: Select all
--arguments "<arguments>"
One or more arguments to pass to the process being executed.
Arguments containing spaces must be enclosed in quotation marks. More than one --arguments at a time can be specified to keep the command line tidy.
Now became:
3. examples are incorrect:
Code: Select all
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
Should be:
Code: Select all
Examples:
VBoxManage --nologo guestcontrol "My VM" execute "/bin/ls"
--username foo --password bar --wait-stdout -- "-l /usr"
VBoxManage --nologo guestcontrol "My VM" execute "ping.exe"
--username foo --password bar --wait-stdout -- 127.0.0.1
Hmm.. I thought it is obvious, as I detected it after few seconds when looking at section "8.29".
-Technologov
Re: [REOPENED] Docs for GuestControl Execute outdated
Posted: 14. Jul 2011, 15:12
by Technologov
Please consider fixing this before BETA3.