[REOPENED] Docs for GuestControl Execute outdated

Postings relating to old VirtualBox pre-releases
Post Reply
Technologov
Volunteer
Posts: 3342
Joined: 10. May 2007, 16:59
Location: Israel

[REOPENED] Docs for GuestControl Execute outdated

Post 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 ?
pentagonik
Oracle Corporation
Posts: 283
Joined: 19. May 2008, 16:09
Primary OS: Ubuntu other
VBox Version: PUEL
Guest OSses: Too many to specify!
Contact:

Re: GuestControl Execute fails

Post 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!
Technologov
Volunteer
Posts: 3342
Joined: 10. May 2007, 16:59
Location: Israel

Re: GuestControl Execute fails

Post by Technologov »

Examples are still bad with BETA2.

Reopened.

Plz provide me with examples here, so I can test GuestAdditions.
pentagonik
Oracle Corporation
Posts: 283
Joined: 19. May 2008, 16:09
Primary OS: Ubuntu other
VBox Version: PUEL
Guest OSses: Too many to specify!
Contact:

Re: [REOPENED] GuestControl Execute fails

Post 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.
Technologov
Volunteer
Posts: 3342
Joined: 10. May 2007, 16:59
Location: Israel

Re: [REOPENED] GuestControl Execute fails

Post by Technologov »

Docs are still outdated, and examples wrong.

Renamed bug accordingly.
Sasquatch
Volunteer
Posts: 17798
Joined: 17. Mar 2008, 13:41
Primary OS: Debian other
VBox Version: PUEL
Guest OSses: Windows XP, Windows 7, Linux
Location: /dev/random

Re: [REOPENED] Docs for GuestControl Execute outdated

Post by Sasquatch »

You ask for examples, but you don't give them either. Give some, get some.
Read the Forum Posting Guide before opening a topic.
VirtualBox FAQ: Check this before asking questions.
Online User Manual: A must read if you want to know what we're talking about.
Howto: Install Linux Guest Additions
Howto: Use Shared Folders on Linux Guest
See the Tutorials and FAQ section at the top of the Forum for more guides.
Try searching the forums first with Google and add the site filter for this forum.
E.g. install guest additions site:forums.virtualbox.org

Retired from this Forum since OSSO introduction.
Technologov
Volunteer
Posts: 3342
Joined: 10. May 2007, 16:59
Location: Israel

Re: [REOPENED] Docs for GuestControl Execute outdated

Post 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:

Code: Select all

-- "<arguments>"
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
Technologov
Volunteer
Posts: 3342
Joined: 10. May 2007, 16:59
Location: Israel

Re: [REOPENED] Docs for GuestControl Execute outdated

Post by Technologov »

Please consider fixing this before BETA3.
Post Reply