Changeset 51618 in vbox for trunk/src/VBox/Frontends/VBoxHeadless

Timestamp:

Jun 13, 2014 2:47:45 PM (10 years ago)

Author:

vboxsync

Message:

VBoxHeadless: Allow VMs to start paused. (And reformatted usage help to fit typical terminal.)

File:

• trunk/src/VBox/Frontends/VBoxHeadless/VBoxHeadless.cpp (modified) (6 diffs)

trunk/src/VBox/Frontends/VBoxHeadless/VBoxHeadless.cpp

@@ -493 +493 @@
              "   -s, -startvm, --startvm <name|uuid>   Start given VM (required argument)\n"
              "   -v, -vrde, --vrde on|off|config       Enable (default) or disable the VRDE\n"
-             "                                         server or don't change the setting\n"
+             "                                           server or don't change the setting\n"
              "   -e, -vrdeproperty, --vrdeproperty <name=[value]> Set a VRDE property:\n"
-             "                                         \"TCP/Ports\" - comma-separated list of ports\n"
-             "                                         the VRDE server can bind to. Use a dash between\n"
-             "                                         two port numbers to specify a range\n"
-             "                                         \"TCP/Address\" - interface IP the VRDE server\n"
-             "                                         will bind to\n"
-             "   --settingspw <pw>                     Specify the settings password\n"
-             "   --settingspwfile <file>               Specify a file containing the settings password\n"
+             "                                     \"TCP/Ports\" - comma-separated list of\n"
+             "                                       ports the VRDE server can bind to; dash\n"
+             "                                       between two port numbers specifies range\n"
+             "                                     \"TCP/Address\" - interface IP the VRDE\n"
+             "                                       server will bind to\n"
+             "   --settingspw <pw>                 Specify the settings password\n"
+             "   --settingspwfile <file>           Specify a file containing the\n"
+             "                                       settings password\n"
+             "   -start-paused, --start-paused     Start the VM in paused state\n"
 #ifdef VBOX_WITH_VPX
-             "   -c, -capture, --capture               Record the VM screen output to a file\n"
-             "   -w, --width                           Frame width when recording\n"
-             "   -h, --height                          Frame height when recording\n"
-             "   -r, --bitrate                         Recording bit rate when recording\n"
-             "   -f, --filename                        File name when recording. The codec used\n"
-             "                                         will be chosen based on the file extension\n"
+             "   -c, -capture, --capture           Record the VM screen output to a file\n"
+             "   -w, --width                       Frame width when recording\n"
+             "   -h, --height                      Frame height when recording\n"
+             "   -r, --bitrate                     Recording bit rate when recording\n"
+             "   -f, --filename                    File name when recording. The codec used\n"
+             "                                       will be chosen based on file extension\n"
 #endif
              "\n");
@@ -646 +648 @@
     unsigned fPATM  = ~0U;
     unsigned fCSAM  = ~0U;
+    unsigned fPaused = 0;
 #ifdef VBOX_WITH_VPX
     bool fVideoRec = 0;
@@ -677 +680 @@
         OPT_SETTINGSPW,
         OPT_SETTINGSPW_FILE,
-        OPT_COMMENT
+        OPT_COMMENT,
+        OPT_PAUSED
     };
 
@@ -721 +725 @@
 #endif /* VBOX_WITH_VPX defined */
         { "-comment", OPT_COMMENT, RTGETOPT_REQ_STRING },
-        { "--comment", OPT_COMMENT, RTGETOPT_REQ_STRING }
+        { "--comment", OPT_COMMENT, RTGETOPT_REQ_STRING },
+        { "-start-paused", OPT_PAUSED, 0 },
+        { "--start-paused", OPT_PAUSED, 0 }
     };
 
@@ -786 +792 @@
             case OPT_SETTINGSPW_FILE:
                 pcszSettingsPwFile = ValueUnion.psz;
+                break;
+            case OPT_PAUSED:
+                fPaused = true;
                 break;
 #ifdef VBOX_WITH_VPX
@@ -1150 +1159 @@
 
         ComPtr <IProgress> progress;
-        CHECK_ERROR_BREAK(console, PowerUp(progress.asOutParam()));
+        if (!fPaused)
+            CHECK_ERROR_BREAK(console, PowerUp(progress.asOutParam()));
+        else
+            CHECK_ERROR_BREAK(console, PowerUpPaused(progress.asOutParam()));
 
         /*