VirtualBox

source: vbox/trunk/src/VBox/Frontends/VBoxManage/VBoxManageControlVM.cpp@ 33595

Last change on this file since 33595 was 33590, checked in by vboxsync, 14 years ago

VRDE: removed VBOX_WITH_VRDP from source code, also some obsolete code removed.
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 34.4 KB
Line 
1/* $Id: VBoxManageControlVM.cpp 33590 2010-10-29 08:55:09Z vboxsync $ */
2/** @file
3 * VBoxManage - Implementation of controlvm command.
4 */
5
6/*
7 * Copyright (C) 2006-2010 Oracle Corporation
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.virtualbox.org. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 */
17
18
19/*******************************************************************************
20* Header Files *
21*******************************************************************************/
22#include <VBox/com/com.h>
23#include <VBox/com/string.h>
24#include <VBox/com/Guid.h>
25#include <VBox/com/array.h>
26#include <VBox/com/ErrorInfo.h>
27#include <VBox/com/errorprint.h>
28#include <VBox/com/EventQueue.h>
29
30#include <VBox/com/VirtualBox.h>
31
32#include <iprt/ctype.h>
33#include <VBox/err.h>
34#include <iprt/getopt.h>
35#include <iprt/stream.h>
36#include <iprt/string.h>
37#include <iprt/uuid.h>
38#include <VBox/log.h>
39
40#include "VBoxManage.h"
41
42#include <list>
43
44
45/**
46 * Parses a number.
47 *
48 * @returns Valid number on success.
49 * @returns 0 if invalid number. All necessary bitching has been done.
50 * @param psz Pointer to the nic number.
51 */
52static unsigned parseNum(const char *psz, unsigned cMaxNum, const char *name)
53{
54 uint32_t u32;
55 char *pszNext;
56 int rc = RTStrToUInt32Ex(psz, &pszNext, 10, &u32);
57 if ( RT_SUCCESS(rc)
58 && *pszNext == '\0'
59 && u32 >= 1
60 && u32 <= cMaxNum)
61 return (unsigned)u32;
62 errorArgument("Invalid %s number '%s'", name, psz);
63 return 0;
64}
65
66
67int handleControlVM(HandlerArg *a)
68{
69 using namespace com;
70 HRESULT rc;
71
72 if (a->argc < 2)
73 return errorSyntax(USAGE_CONTROLVM, "Not enough parameters");
74
75 /* try to find the given machine */
76 ComPtr <IMachine> machine;
77 CHECK_ERROR(a->virtualBox, FindMachine(Bstr(a->argv[0]).raw(),
78 machine.asOutParam()));
79 if (FAILED(rc))
80 return 1;
81
82 /* open a session for the VM */
83 CHECK_ERROR_RET(machine, LockMachine(a->session, LockType_Shared), 1);
84
85 do
86 {
87 /* get the associated console */
88 ComPtr<IConsole> console;
89 CHECK_ERROR_BREAK(a->session, COMGETTER(Console)(console.asOutParam()));
90 /* ... and session machine */
91 ComPtr<IMachine> sessionMachine;
92 CHECK_ERROR_BREAK(a->session, COMGETTER(Machine)(sessionMachine.asOutParam()));
93
94 /* which command? */
95 if (!strcmp(a->argv[1], "pause"))
96 {
97 CHECK_ERROR_BREAK(console, Pause());
98 }
99 else if (!strcmp(a->argv[1], "resume"))
100 {
101 CHECK_ERROR_BREAK(console, Resume());
102 }
103 else if (!strcmp(a->argv[1], "reset"))
104 {
105 CHECK_ERROR_BREAK(console, Reset());
106 }
107 else if (!strcmp(a->argv[1], "unplugcpu"))
108 {
109 if (a->argc <= 1 + 1)
110 {
111 errorArgument("Missing argument to '%s'. Expected CPU number.", a->argv[1]);
112 rc = E_FAIL;
113 break;
114 }
115
116 unsigned n = parseNum(a->argv[2], 32, "CPU");
117
118 CHECK_ERROR_BREAK(sessionMachine, HotUnplugCPU(n));
119 }
120 else if (!strcmp(a->argv[1], "plugcpu"))
121 {
122 if (a->argc <= 1 + 1)
123 {
124 errorArgument("Missing argument to '%s'. Expected CPU number.", a->argv[1]);
125 rc = E_FAIL;
126 break;
127 }
128
129 unsigned n = parseNum(a->argv[2], 32, "CPU");
130
131 CHECK_ERROR_BREAK(sessionMachine, HotPlugCPU(n));
132 }
133 else if (!strcmp(a->argv[1], "cpuexecutioncap"))
134 {
135 if (a->argc <= 1 + 1)
136 {
137 errorArgument("Missing argument to '%s'. Expected execution cap number.", a->argv[1]);
138 rc = E_FAIL;
139 break;
140 }
141
142 unsigned n = parseNum(a->argv[2], 100, "ExecutionCap");
143
144 CHECK_ERROR_BREAK(machine, COMSETTER(CPUExecutionCap)(n));
145 }
146 else if (!strcmp(a->argv[1], "poweroff"))
147 {
148 ComPtr<IProgress> progress;
149 CHECK_ERROR_BREAK(console, PowerDown(progress.asOutParam()));
150
151 rc = showProgress(progress);
152 if (FAILED(rc))
153 {
154 com::ProgressErrorInfo info(progress);
155 if (info.isBasicAvailable())
156 RTMsgError("Failed to power off machine. Error message: %lS", info.getText().raw());
157 else
158 RTMsgError("Failed to power off machine. No error message available!");
159 }
160 }
161 else if (!strcmp(a->argv[1], "savestate"))
162 {
163 /* first pause so we don't trigger a live save which needs more time/resources */
164 CHECK_ERROR_BREAK(console, Pause());
165
166 ComPtr<IProgress> progress;
167 CHECK_ERROR(console, SaveState(progress.asOutParam()));
168 if (FAILED(rc))
169 {
170 console->Resume();
171 break;
172 }
173
174 rc = showProgress(progress);
175 if (FAILED(rc))
176 {
177 com::ProgressErrorInfo info(progress);
178 if (info.isBasicAvailable())
179 RTMsgError("Failed to save machine state. Error message: %lS", info.getText().raw());
180 else
181 RTMsgError("Failed to save machine state. No error message available!");
182 console->Resume();
183 }
184 }
185 else if (!strcmp(a->argv[1], "acpipowerbutton"))
186 {
187 CHECK_ERROR_BREAK(console, PowerButton());
188 }
189 else if (!strcmp(a->argv[1], "acpisleepbutton"))
190 {
191 CHECK_ERROR_BREAK(console, SleepButton());
192 }
193 else if (!strcmp(a->argv[1], "injectnmi"))
194 {
195 /* get the machine debugger. */
196 ComPtr <IMachineDebugger> debugger;
197 CHECK_ERROR_BREAK(console, COMGETTER(Debugger)(debugger.asOutParam()));
198 CHECK_ERROR_BREAK(debugger, InjectNMI());
199 }
200 else if (!strcmp(a->argv[1], "keyboardputscancode"))
201 {
202 ComPtr<IKeyboard> keyboard;
203 CHECK_ERROR_BREAK(console, COMGETTER(Keyboard)(keyboard.asOutParam()));
204
205 if (a->argc <= 1 + 1)
206 {
207 errorArgument("Missing argument to '%s'. Expected IBM PC AT set 2 keyboard scancode(s) as hex byte(s).", a->argv[1]);
208 rc = E_FAIL;
209 break;
210 }
211
212 std::list<LONG> llScancodes;
213
214 /* Process the command line. */
215 int i;
216 for (i = 1 + 1; i < a->argc; i++)
217 {
218 if ( RT_C_IS_XDIGIT (a->argv[i][0])
219 && RT_C_IS_XDIGIT (a->argv[i][1])
220 && a->argv[i][2] == 0)
221 {
222 uint8_t u8Scancode;
223 int irc = RTStrToUInt8Ex(a->argv[i], NULL, 16, &u8Scancode);
224 if (RT_FAILURE (irc))
225 {
226 RTMsgError("Converting '%s' returned %Rrc!", a->argv[i], rc);
227 rc = E_FAIL;
228 break;
229 }
230
231 llScancodes.push_back(u8Scancode);
232 }
233 else
234 {
235 RTMsgError("Error: '%s' is not a hex byte!", a->argv[i]);
236 rc = E_FAIL;
237 break;
238 }
239 }
240
241 if (FAILED(rc))
242 break;
243
244 /* Send scancodes to the VM. */
245 com::SafeArray<LONG> saScancodes(llScancodes);
246 ULONG codesStored = 0;
247 CHECK_ERROR_BREAK(keyboard, PutScancodes(ComSafeArrayAsInParam(saScancodes),
248 &codesStored));
249 if (codesStored < saScancodes.size())
250 {
251 RTMsgError("Only %d scancodes were stored", codesStored);
252 rc = E_FAIL;
253 break;
254 }
255 }
256 else if (!strncmp(a->argv[1], "setlinkstate", 12))
257 {
258 /* Get the number of network adapters */
259 ULONG NetworkAdapterCount = 0;
260 ComPtr <ISystemProperties> info;
261 CHECK_ERROR_BREAK(a->virtualBox, COMGETTER(SystemProperties)(info.asOutParam()));
262 CHECK_ERROR_BREAK(info, COMGETTER(NetworkAdapterCount)(&NetworkAdapterCount));
263
264 unsigned n = parseNum(&a->argv[1][12], NetworkAdapterCount, "NIC");
265 if (!n)
266 {
267 rc = E_FAIL;
268 break;
269 }
270 if (a->argc <= 1 + 1)
271 {
272 errorArgument("Missing argument to '%s'", a->argv[1]);
273 rc = E_FAIL;
274 break;
275 }
276 /* get the corresponding network adapter */
277 ComPtr<INetworkAdapter> adapter;
278 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
279 if (adapter)
280 {
281 if (!strcmp(a->argv[2], "on"))
282 {
283 CHECK_ERROR_BREAK(adapter, COMSETTER(CableConnected)(TRUE));
284 }
285 else if (!strcmp(a->argv[2], "off"))
286 {
287 CHECK_ERROR_BREAK(adapter, COMSETTER(CableConnected)(FALSE));
288 }
289 else
290 {
291 errorArgument("Invalid link state '%s'", Utf8Str(a->argv[2]).c_str());
292 rc = E_FAIL;
293 break;
294 }
295 }
296 }
297 /* here the order in which strncmp is called is important
298 * cause nictracefile can be very well compared with
299 * nictrace and nic and thus everything will always fail
300 * if the order is changed
301 */
302 else if (!strncmp(a->argv[1], "nictracefile", 12))
303 {
304 /* Get the number of network adapters */
305 ULONG NetworkAdapterCount = 0;
306 ComPtr <ISystemProperties> info;
307 CHECK_ERROR_BREAK(a->virtualBox, COMGETTER(SystemProperties)(info.asOutParam()));
308 CHECK_ERROR_BREAK(info, COMGETTER(NetworkAdapterCount)(&NetworkAdapterCount));
309
310 unsigned n = parseNum(&a->argv[1][12], NetworkAdapterCount, "NIC");
311 if (!n)
312 {
313 rc = E_FAIL;
314 break;
315 }
316 if (a->argc <= 2)
317 {
318 errorArgument("Missing argument to '%s'", a->argv[1]);
319 rc = E_FAIL;
320 break;
321 }
322
323 /* get the corresponding network adapter */
324 ComPtr<INetworkAdapter> adapter;
325 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
326 if (adapter)
327 {
328 BOOL fEnabled;
329 adapter->COMGETTER(Enabled)(&fEnabled);
330 if (fEnabled)
331 {
332 if (a->argv[2])
333 {
334 CHECK_ERROR_RET(adapter, COMSETTER(TraceFile)(Bstr(a->argv[2]).raw()), 1);
335 }
336 else
337 {
338 errorArgument("Invalid filename or filename not specified for NIC %lu", n);
339 rc = E_FAIL;
340 break;
341 }
342 }
343 else
344 RTMsgError("The NIC %d is currently disabled and thus can't change its tracefile", n);
345 }
346 }
347 else if (!strncmp(a->argv[1], "nictrace", 8))
348 {
349 /* Get the number of network adapters */
350 ULONG NetworkAdapterCount = 0;
351 ComPtr <ISystemProperties> info;
352 CHECK_ERROR_BREAK(a->virtualBox, COMGETTER(SystemProperties)(info.asOutParam()));
353 CHECK_ERROR_BREAK(info, COMGETTER(NetworkAdapterCount)(&NetworkAdapterCount));
354
355 unsigned n = parseNum(&a->argv[1][8], NetworkAdapterCount, "NIC");
356 if (!n)
357 {
358 rc = E_FAIL;
359 break;
360 }
361 if (a->argc <= 2)
362 {
363 errorArgument("Missing argument to '%s'", a->argv[1]);
364 rc = E_FAIL;
365 break;
366 }
367
368 /* get the corresponding network adapter */
369 ComPtr<INetworkAdapter> adapter;
370 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
371 if (adapter)
372 {
373 BOOL fEnabled;
374 adapter->COMGETTER(Enabled)(&fEnabled);
375 if (fEnabled)
376 {
377 if (!strcmp(a->argv[2], "on"))
378 {
379 CHECK_ERROR_RET(adapter, COMSETTER(TraceEnabled)(TRUE), 1);
380 }
381 else if (!strcmp(a->argv[2], "off"))
382 {
383 CHECK_ERROR_RET(adapter, COMSETTER(TraceEnabled)(FALSE), 1);
384 }
385 else
386 {
387 errorArgument("Invalid nictrace%lu argument '%s'", n, Utf8Str(a->argv[2]).c_str());
388 rc = E_FAIL;
389 break;
390 }
391 }
392 else
393 RTMsgError("The NIC %d is currently disabled and thus can't change its trace flag", n);
394 }
395 }
396 else if (!strncmp(a->argv[1], "nic", 3))
397 {
398 /* Get the number of network adapters */
399 ULONG NetworkAdapterCount = 0;
400 ComPtr <ISystemProperties> info;
401 CHECK_ERROR_BREAK(a->virtualBox, COMGETTER(SystemProperties)(info.asOutParam()));
402 CHECK_ERROR_BREAK(info, COMGETTER(NetworkAdapterCount)(&NetworkAdapterCount));
403
404 unsigned n = parseNum(&a->argv[1][3], NetworkAdapterCount, "NIC");
405 if (!n)
406 {
407 rc = E_FAIL;
408 break;
409 }
410 if (a->argc <= 2)
411 {
412 errorArgument("Missing argument to '%s'", a->argv[1]);
413 rc = E_FAIL;
414 break;
415 }
416
417 /* get the corresponding network adapter */
418 ComPtr<INetworkAdapter> adapter;
419 CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
420 if (adapter)
421 {
422 BOOL fEnabled;
423 adapter->COMGETTER(Enabled)(&fEnabled);
424 if (fEnabled)
425 {
426 if (!strcmp(a->argv[2], "null"))
427 {
428 CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
429 CHECK_ERROR_RET(adapter, Detach(), 1);
430 }
431 else if (!strcmp(a->argv[2], "nat"))
432 {
433 CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
434 if (a->argc == 4)
435 CHECK_ERROR_RET(adapter, COMSETTER(NATNetwork)(Bstr(a->argv[3]).raw()), 1);
436 CHECK_ERROR_RET(adapter, AttachToNAT(), 1);
437 }
438 else if ( !strcmp(a->argv[2], "bridged")
439 || !strcmp(a->argv[2], "hostif")) /* backward compatibility */
440 {
441 if (a->argc <= 3)
442 {
443 errorArgument("Missing argument to '%s'", a->argv[2]);
444 rc = E_FAIL;
445 break;
446 }
447 CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
448 CHECK_ERROR_RET(adapter, COMSETTER(HostInterface)(Bstr(a->argv[3]).raw()), 1);
449 CHECK_ERROR_RET(adapter, AttachToBridgedInterface(), 1);
450 }
451 else if (!strcmp(a->argv[2], "intnet"))
452 {
453 if (a->argc <= 3)
454 {
455 errorArgument("Missing argument to '%s'", a->argv[2]);
456 rc = E_FAIL;
457 break;
458 }
459 CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
460 CHECK_ERROR_RET(adapter, COMSETTER(InternalNetwork)(Bstr(a->argv[3]).raw()), 1);
461 CHECK_ERROR_RET(adapter, AttachToInternalNetwork(), 1);
462 }
463#if defined(VBOX_WITH_NETFLT)
464 else if (!strcmp(a->argv[2], "hostonly"))
465 {
466 if (a->argc <= 3)
467 {
468 errorArgument("Missing argument to '%s'", a->argv[2]);
469 rc = E_FAIL;
470 break;
471 }
472 CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
473 CHECK_ERROR_RET(adapter, COMSETTER(HostInterface)(Bstr(a->argv[3]).raw()), 1);
474 CHECK_ERROR_RET(adapter, AttachToHostOnlyInterface(), 1);
475 }
476#endif
477 else
478 {
479 errorArgument("Invalid type '%s' specfied for NIC %lu", Utf8Str(a->argv[2]).c_str(), n);
480 rc = E_FAIL;
481 break;
482 }
483 }
484 else
485 RTMsgError("The NIC %d is currently disabled and thus can't change its attachment type", n);
486 }
487 }
488 else if ( !strcmp(a->argv[1], "vrde")
489 || !strcmp(a->argv[1], "vrdp"))
490 {
491 if (!strcmp(a->argv[1], "vrdp"))
492 RTStrmPrintf(g_pStdErr, "Warning: 'vrdp' is deprecated. Use 'vrde'.\n");
493
494 if (a->argc <= 1 + 1)
495 {
496 errorArgument("Missing argument to '%s'", a->argv[1]);
497 rc = E_FAIL;
498 break;
499 }
500 ComPtr<IVRDEServer> vrdeServer;
501 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
502 ASSERT(vrdeServer);
503 if (vrdeServer)
504 {
505 if (!strcmp(a->argv[2], "on"))
506 {
507 CHECK_ERROR_BREAK(vrdeServer, COMSETTER(Enabled)(TRUE));
508 }
509 else if (!strcmp(a->argv[2], "off"))
510 {
511 CHECK_ERROR_BREAK(vrdeServer, COMSETTER(Enabled)(FALSE));
512 }
513 else
514 {
515 errorArgument("Invalid remote desktop server state '%s'", Utf8Str(a->argv[2]).c_str());
516 rc = E_FAIL;
517 break;
518 }
519 }
520 }
521 else if (!strcmp(a->argv[1], "vrdpport"))
522 {
523 RTStrmPrintf(g_pStdErr, "Warning: 'vrdpport' is deprecated. Use 'setvrdeproperty'.\n");
524
525 if (a->argc <= 1 + 1)
526 {
527 errorArgument("Missing argument to '%s'", a->argv[1]);
528 rc = E_FAIL;
529 break;
530 }
531 ComPtr<IVRDEServer> vrdeServer;
532 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
533 ASSERT(vrdeServer);
534 if (vrdeServer)
535 {
536 Bstr ports;
537
538 if (!strcmp(a->argv[2], "default"))
539 ports = "0";
540 else
541 ports = a->argv[2];
542
543 CHECK_ERROR_BREAK(vrdeServer, SetVRDEProperty(Bstr("TCP/Ports").raw(), ports.raw()));
544 }
545 }
546 else if ( !strcmp(a->argv[1], "vrdevideochannelquality")
547 || !strcmp(a->argv[1], "vrdpvideochannelquality"))
548 {
549 if (!strcmp(a->argv[1], "vrdpvideochannelquality"))
550 RTStrmPrintf(g_pStdErr, "Warning: 'vrdpvideochannelquality' is deprecated. Use 'vrdevideochannelquality'.\n");
551
552 if (a->argc <= 1 + 1)
553 {
554 errorArgument("Missing argument to '%s'", a->argv[1]);
555 rc = E_FAIL;
556 break;
557 }
558 ComPtr<IVRDEServer> vrdeServer;
559 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
560 ASSERT(vrdeServer);
561 if (vrdeServer)
562 {
563 unsigned n = parseNum(a->argv[2], 100, "VRDE video redirection quality in percent");
564
565 CHECK_ERROR(vrdeServer, COMSETTER(VideoChannelQuality)(n));
566 }
567 }
568 else if (!strcmp(a->argv[1], "vrdeproperty"))
569 {
570 if (a->argc <= 1 + 1)
571 {
572 errorArgument("Missing argument to '%s'", a->argv[1]);
573 rc = E_FAIL;
574 break;
575 }
576 ComPtr<IVRDEServer> vrdeServer;
577 sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
578 ASSERT(vrdeServer);
579 if (vrdeServer)
580 {
581 /* Parse 'name=value' */
582 char *pszProperty = RTStrDup(a->argv[2]);
583 if (pszProperty)
584 {
585 char *pDelimiter = strchr(pszProperty, '=');
586 if (pDelimiter)
587 {
588 *pDelimiter = '\0';
589
590 Bstr bstrName = pszProperty;
591 Bstr bstrValue = &pDelimiter[1];
592 CHECK_ERROR(vrdeServer, SetVRDEProperty(bstrName.raw(), bstrValue.raw()));
593 }
594 else
595 {
596 errorArgument("Invalid --vrdeproperty argument '%s'", a->argv[2]);
597 rc = E_FAIL;
598 break;
599 }
600 RTStrFree(pszProperty);
601 }
602 else
603 {
604 RTStrmPrintf(g_pStdErr, "Error: Failed to allocate memory for VRDE property '%s'\n", a->argv[2]);
605 rc = E_FAIL;
606 }
607 }
608 if (FAILED(rc))
609 {
610 break;
611 }
612 }
613 else if ( !strcmp(a->argv[1], "usbattach")
614 || !strcmp(a->argv[1], "usbdetach"))
615 {
616 if (a->argc < 3)
617 {
618 errorSyntax(USAGE_CONTROLVM, "Not enough parameters");
619 rc = E_FAIL;
620 break;
621 }
622
623 bool attach = !strcmp(a->argv[1], "usbattach");
624
625 Bstr usbId = a->argv[2];
626 if (Guid(usbId).isEmpty())
627 {
628 // assume address
629 if (attach)
630 {
631 ComPtr <IHost> host;
632 CHECK_ERROR_BREAK(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
633 SafeIfaceArray <IHostUSBDevice> coll;
634 CHECK_ERROR_BREAK(host, COMGETTER(USBDevices)(ComSafeArrayAsOutParam(coll)));
635 ComPtr <IHostUSBDevice> dev;
636 CHECK_ERROR_BREAK(host, FindUSBDeviceByAddress(Bstr(a->argv[2]).raw(),
637 dev.asOutParam()));
638 CHECK_ERROR_BREAK(dev, COMGETTER(Id)(usbId.asOutParam()));
639 }
640 else
641 {
642 SafeIfaceArray <IUSBDevice> coll;
643 CHECK_ERROR_BREAK(console, COMGETTER(USBDevices)(ComSafeArrayAsOutParam(coll)));
644 ComPtr <IUSBDevice> dev;
645 CHECK_ERROR_BREAK(console, FindUSBDeviceByAddress(Bstr(a->argv[2]).raw(),
646 dev.asOutParam()));
647 CHECK_ERROR_BREAK(dev, COMGETTER(Id)(usbId.asOutParam()));
648 }
649 }
650
651 if (attach)
652 CHECK_ERROR_BREAK(console, AttachUSBDevice(usbId.raw()));
653 else
654 {
655 ComPtr <IUSBDevice> dev;
656 CHECK_ERROR_BREAK(console, DetachUSBDevice(usbId.raw(),
657 dev.asOutParam()));
658 }
659 }
660 else if (!strcmp(a->argv[1], "setvideomodehint"))
661 {
662 if (a->argc != 5 && a->argc != 6)
663 {
664 errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
665 rc = E_FAIL;
666 break;
667 }
668 uint32_t xres = RTStrToUInt32(a->argv[2]);
669 uint32_t yres = RTStrToUInt32(a->argv[3]);
670 uint32_t bpp = RTStrToUInt32(a->argv[4]);
671 uint32_t displayIdx = 0;
672 if (a->argc == 6)
673 displayIdx = RTStrToUInt32(a->argv[5]);
674
675 ComPtr<IDisplay> display;
676 CHECK_ERROR_BREAK(console, COMGETTER(Display)(display.asOutParam()));
677 CHECK_ERROR_BREAK(display, SetVideoModeHint(xres, yres, bpp, displayIdx));
678 }
679 else if (!strcmp(a->argv[1], "setcredentials"))
680 {
681 bool fAllowLocalLogon = true;
682 if (a->argc == 7)
683 {
684 if ( strcmp(a->argv[5], "--allowlocallogon")
685 && strcmp(a->argv[5], "-allowlocallogon"))
686 {
687 errorArgument("Invalid parameter '%s'", a->argv[5]);
688 rc = E_FAIL;
689 break;
690 }
691 if (!strcmp(a->argv[6], "no"))
692 fAllowLocalLogon = false;
693 }
694 else if (a->argc != 5)
695 {
696 errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
697 rc = E_FAIL;
698 break;
699 }
700
701 ComPtr<IGuest> guest;
702 CHECK_ERROR_BREAK(console, COMGETTER(Guest)(guest.asOutParam()));
703 CHECK_ERROR_BREAK(guest, SetCredentials(Bstr(a->argv[2]).raw(),
704 Bstr(a->argv[3]).raw(),
705 Bstr(a->argv[4]).raw(),
706 fAllowLocalLogon));
707 }
708#if 0 /* TODO: review & remove */
709 else if (!strcmp(a->argv[1], "dvdattach"))
710 {
711 Bstr uuid;
712 if (a->argc != 3)
713 {
714 errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
715 rc = E_FAIL;
716 break;
717 }
718
719 ComPtr<IMedium> dvdMedium;
720
721 /* unmount? */
722 if (!strcmp(a->argv[2], "none"))
723 {
724 /* nothing to do, NULL object will cause unmount */
725 }
726 /* host drive? */
727 else if (!strncmp(a->argv[2], "host:", 5))
728 {
729 ComPtr<IHost> host;
730 CHECK_ERROR(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
731
732 rc = host->FindHostDVDDrive(Bstr(a->argv[2] + 5), dvdMedium.asOutParam());
733 if (!dvdMedium)
734 {
735 errorArgument("Invalid host DVD drive name \"%s\"",
736 a->argv[2] + 5);
737 rc = E_FAIL;
738 break;
739 }
740 }
741 else
742 {
743 /* first assume it's a UUID */
744 uuid = a->argv[2];
745 rc = a->virtualBox->GetDVDImage(uuid, dvdMedium.asOutParam());
746 if (FAILED(rc) || !dvdMedium)
747 {
748 /* must be a filename, check if it's in the collection */
749 rc = a->virtualBox->FindDVDImage(Bstr(a->argv[2]), dvdMedium.asOutParam());
750 /* not registered, do that on the fly */
751 if (!dvdMedium)
752 {
753 Bstr emptyUUID;
754 CHECK_ERROR(a->virtualBox, OpenDVDImage(Bstr(a->argv[2]), emptyUUID, dvdMedium.asOutParam()));
755 }
756 }
757 if (!dvdMedium)
758 {
759 rc = E_FAIL;
760 break;
761 }
762 }
763
764 /** @todo generalize this, allow arbitrary number of DVD drives
765 * and as a consequence multiple attachments and different
766 * storage controllers. */
767 if (dvdMedium)
768 dvdMedium->COMGETTER(Id)(uuid.asOutParam());
769 else
770 uuid = Guid().toString();
771 CHECK_ERROR(machine, MountMedium(Bstr("IDE Controller"), 1, 0, uuid, FALSE /* aForce */));
772 }
773 else if (!strcmp(a->argv[1], "floppyattach"))
774 {
775 Bstr uuid;
776 if (a->argc != 3)
777 {
778 errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
779 rc = E_FAIL;
780 break;
781 }
782
783 ComPtr<IMedium> floppyMedium;
784
785 /* unmount? */
786 if (!strcmp(a->argv[2], "none"))
787 {
788 /* nothing to do, NULL object will cause unmount */
789 }
790 /* host drive? */
791 else if (!strncmp(a->argv[2], "host:", 5))
792 {
793 ComPtr<IHost> host;
794 CHECK_ERROR(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
795 host->FindHostFloppyDrive(Bstr(a->argv[2] + 5), floppyMedium.asOutParam());
796 if (!floppyMedium)
797 {
798 errorArgument("Invalid host floppy drive name \"%s\"",
799 a->argv[2] + 5);
800 rc = E_FAIL;
801 break;
802 }
803 }
804 else
805 {
806 /* first assume it's a UUID */
807 uuid = a->argv[2];
808 rc = a->virtualBox->GetFloppyImage(uuid, floppyMedium.asOutParam());
809 if (FAILED(rc) || !floppyMedium)
810 {
811 /* must be a filename, check if it's in the collection */
812 rc = a->virtualBox->FindFloppyImage(Bstr(a->argv[2]), floppyMedium.asOutParam());
813 /* not registered, do that on the fly */
814 if (!floppyMedium)
815 {
816 Bstr emptyUUID;
817 CHECK_ERROR(a->virtualBox, OpenFloppyImage(Bstr(a->argv[2]), emptyUUID, floppyMedium.asOutParam()));
818 }
819 }
820 if (!floppyMedium)
821 {
822 rc = E_FAIL;
823 break;
824 }
825 }
826 floppyMedium->COMGETTER(Id)(uuid.asOutParam());
827 CHECK_ERROR(machine, MountMedium(Bstr("Floppy Controller"), 0, 0, uuid, FALSE /* aForce */));
828 }
829#endif /* obsolete dvdattach/floppyattach */
830 else if (!strcmp(a->argv[1], "guestmemoryballoon"))
831 {
832 if (a->argc != 3)
833 {
834 errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
835 rc = E_FAIL;
836 break;
837 }
838 uint32_t uVal;
839 int vrc;
840 vrc = RTStrToUInt32Ex(a->argv[2], NULL, 0, &uVal);
841 if (vrc != VINF_SUCCESS)
842 {
843 errorArgument("Error parsing guest memory balloon size '%s'", a->argv[2]);
844 rc = E_FAIL;
845 break;
846 }
847 /* guest is running; update IGuest */
848 ComPtr <IGuest> guest;
849 rc = console->COMGETTER(Guest)(guest.asOutParam());
850 if (SUCCEEDED(rc))
851 CHECK_ERROR(guest, COMSETTER(MemoryBalloonSize)(uVal));
852 }
853 else if (!strcmp(a->argv[1], "teleport"))
854 {
855 Bstr bstrHostname;
856 uint32_t uMaxDowntime = 250 /*ms*/;
857 uint32_t uPort = UINT32_MAX;
858 uint32_t cMsTimeout = 0;
859 Bstr bstrPassword("");
860 static const RTGETOPTDEF s_aTeleportOptions[] =
861 {
862 { "--host", 'h', RTGETOPT_REQ_STRING }, /** @todo RTGETOPT_FLAG_MANDATORY */
863 { "--hostname", 'h', RTGETOPT_REQ_STRING }, /** @todo remove this */
864 { "--maxdowntime", 'd', RTGETOPT_REQ_UINT32 },
865 { "--port", 'p', RTGETOPT_REQ_UINT32 }, /** @todo RTGETOPT_FLAG_MANDATORY */
866 { "--password", 'P', RTGETOPT_REQ_STRING },
867 { "--timeout", 't', RTGETOPT_REQ_UINT32 },
868 { "--detailed-progress", 'D', RTGETOPT_REQ_NOTHING }
869 };
870 RTGETOPTSTATE GetOptState;
871 RTGetOptInit(&GetOptState, a->argc, a->argv, s_aTeleportOptions, RT_ELEMENTS(s_aTeleportOptions), 2, RTGETOPTINIT_FLAGS_NO_STD_OPTS);
872 int ch;
873 RTGETOPTUNION Value;
874 while ( SUCCEEDED(rc)
875 && (ch = RTGetOpt(&GetOptState, &Value)))
876 {
877 switch (ch)
878 {
879 case 'h': bstrHostname = Value.psz; break;
880 case 'd': uMaxDowntime = Value.u32; break;
881 case 'D': g_fDetailedProgress = true; break;
882 case 'p': uPort = Value.u32; break;
883 case 'P': bstrPassword = Value.psz; break;
884 case 't': cMsTimeout = Value.u32; break;
885 default:
886 errorGetOpt(USAGE_CONTROLVM, ch, &Value);
887 rc = E_FAIL;
888 break;
889 }
890 }
891 if (FAILED(rc))
892 break;
893
894 ComPtr<IProgress> progress;
895 CHECK_ERROR_BREAK(console, Teleport(bstrHostname.raw(), uPort,
896 bstrPassword.raw(),
897 uMaxDowntime,
898 progress.asOutParam()));
899
900 if (cMsTimeout)
901 {
902 rc = progress->COMSETTER(Timeout)(cMsTimeout);
903 if (FAILED(rc) && rc != VBOX_E_INVALID_OBJECT_STATE)
904 CHECK_ERROR_BREAK(progress, COMSETTER(Timeout)(cMsTimeout)); /* lazyness */
905 }
906
907 rc = showProgress(progress);
908 if (FAILED(rc))
909 {
910 com::ProgressErrorInfo info(progress);
911 if (info.isBasicAvailable())
912 RTMsgError("Teleportation failed. Error message: %lS", info.getText().raw());
913 else
914 RTMsgError("Teleportation failed. No error message available!");
915 }
916 }
917 else
918 {
919 errorSyntax(USAGE_CONTROLVM, "Invalid parameter '%s'", Utf8Str(a->argv[1]).c_str());
920 rc = E_FAIL;
921 }
922 } while (0);
923
924 a->session->UnlockMachine();
925
926 return SUCCEEDED(rc) ? 0 : 1;
927}
928
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette