[REOPENED] Docs for GuestControl Execute outdated

Temporary forum to discuss issues and problems during a VirtualBox Beta or Release Candidate phase.

[REOPENED] Docs for GuestControl Execute outdated

Postby Technologov » 1. Jul 2011, 16:48

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 ?
Technologov
Site Moderator
 
Posts: 2754
Joined: 10. May 2007, 16:59
Location: Israel

Re: GuestControl Execute fails

Postby pentagonik » 4. Jul 2011, 14:26

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!
pentagonik
Oracle Corporation
 
Posts: 92
Joined: 19. May 2008, 16:09
Primary OS: MS Windows 7
VBox Version: OSE self-compiled
Guest OSses: Too many to specify!

Re: GuestControl Execute fails

Postby Technologov » 9. Jul 2011, 18:58

Examples are still bad with BETA2.

Reopened.

Plz provide me with examples here, so I can test GuestAdditions.
Technologov
Site Moderator
 
Posts: 2754
Joined: 10. May 2007, 16:59
Location: Israel

Re: [REOPENED] GuestControl Execute fails

Postby pentagonik » 11. Jul 2011, 09:45

What exactly you didn't understand wrt guest execution? The VBoxManage reference now should contain everything you need to start/handle a guest process.
pentagonik
Oracle Corporation
 
Posts: 92
Joined: 19. May 2008, 16:09
Primary OS: MS Windows 7
VBox Version: OSE self-compiled
Guest OSses: Too many to specify!

Re: [REOPENED] GuestControl Execute fails

Postby Technologov » 11. Jul 2011, 13:25

Docs are still outdated, and examples wrong.

Renamed bug accordingly.
Technologov
Site Moderator
 
Posts: 2754
Joined: 10. May 2007, 16:59
Location: Israel

Re: [REOPENED] Docs for GuestControl Execute outdated

Postby Sasquatch » 11. Jul 2011, 19:45

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.
Sasquatch
Volunteer
 
Posts: 17800
Joined: 17. Mar 2008, 13:41
Location: /dev/random
Primary OS: Debian other
VBox Version: PUEL
Guest OSses: Windows XP, Windows 7, Linux

Re: [REOPENED] Docs for GuestControl Execute outdated

Postby Technologov » 11. Jul 2011, 20:04

8.29. VBoxManage guestcontrol

1. General syntax is incorrect:
Code: Select all   Expand viewCollapse view
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   Expand viewCollapse view
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   Expand viewCollapse view
--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   Expand viewCollapse view
-- "<arguments>"


3. examples are incorrect:

Code: Select all   Expand viewCollapse view
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   Expand viewCollapse view
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
Site Moderator
 
Posts: 2754
Joined: 10. May 2007, 16:59
Location: Israel

Re: [REOPENED] Docs for GuestControl Execute outdated

Postby Technologov » 14. Jul 2011, 15:12

Please consider fixing this before BETA3.
Technologov
Site Moderator
 
Posts: 2754
Joined: 10. May 2007, 16:59
Location: Israel


Return to VirtualBox Beta/Release Candidate Feedback

Who is online

Users browsing this forum: No registered users and 1 guest