VBoxManageControlVM.cpp@ 84575

Last change on this file since 84575 was 84575, checked in by vboxsync, 5 years ago
Guest Control/VBoxManage: Added "controlvm [...] reboot\|shutdown" commands to reboot or shut down the guest OS. bugref:9320
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 89.1 KB

Line
1	/* $Id: VBoxManageControlVM.cpp 84575 2020-05-27 17:14:25Z vboxsync $ */
2	/** @file
3	* VBoxManage - Implementation of the controlvm command.
4	*/
5
6	/*
7	* Copyright (C) 2006-2020 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/VirtualBox.h>
29
30	#include <iprt/ctype.h>
31	#include <iprt/getopt.h>
32	#include <iprt/stream.h>
33	#include <iprt/string.h>
34	#include <iprt/thread.h>
35	#include <iprt/uuid.h>
36	#include <iprt/file.h>
37	#include <VBox/log.h>
38
39	#include "VBoxManage.h"
40
41	#include <list>
42
43	VMProcPriority_T nameToVMProcPriority(const char *pszName);
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	*/
52	static 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	unsigned int getMaxNics(IVirtualBox* vbox, IMachine* mach)
67	{
68	ComPtr<ISystemProperties> info;
69	ChipsetType_T aChipset;
70	ULONG NetworkAdapterCount = 0;
71	HRESULT rc;
72
73	do {
74	CHECK_ERROR_BREAK(vbox, COMGETTER(SystemProperties)(info.asOutParam()));
75	CHECK_ERROR_BREAK(mach, COMGETTER(ChipsetType)(&aChipset));
76	CHECK_ERROR_BREAK(info, GetMaxNetworkAdapters(aChipset, &NetworkAdapterCount));
77
78	return (unsigned int)NetworkAdapterCount;
79	} while (0);
80
81	return 0;
82	}
83
84	#define KBDCHARDEF_MOD_NONE 0x00
85	#define KBDCHARDEF_MOD_SHIFT 0x01
86
87	typedef struct KBDCHARDEF
88	{
89	uint8_t u8Scancode;
90	uint8_t u8Modifiers;
91	} KBDCHARDEF;
92
93	static const KBDCHARDEF g_aASCIIChars[0x80] =
94	{
95	/* 0x00 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
96	/* 0x01 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
97	/* 0x02 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
98	/* 0x03 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
99	/* 0x04 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
100	/* 0x05 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
101	/* 0x06 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
102	/* 0x07 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
103	/* 0x08 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
104	/* 0x09 ' ' */ {0x0f, KBDCHARDEF_MOD_NONE},
105	/* 0x0A ' ' */ {0x1c, KBDCHARDEF_MOD_NONE},
106	/* 0x0B ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
107	/* 0x0C ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
108	/* 0x0D ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
109	/* 0x0E ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
110	/* 0x0F ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
111	/* 0x10 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
112	/* 0x11 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
113	/* 0x12 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
114	/* 0x13 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
115	/* 0x14 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
116	/* 0x15 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
117	/* 0x16 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
118	/* 0x17 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
119	/* 0x18 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
120	/* 0x19 ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
121	/* 0x1A ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
122	/* 0x1B ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
123	/* 0x1C ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
124	/* 0x1D ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
125	/* 0x1E ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
126	/* 0x1F ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
127	/* 0x20 ' ' */ {0x39, KBDCHARDEF_MOD_NONE},
128	/* 0x21 '!' */ {0x02, KBDCHARDEF_MOD_SHIFT},
129	/* 0x22 '"' */ {0x28, KBDCHARDEF_MOD_SHIFT},
130	/* 0x23 '#' */ {0x04, KBDCHARDEF_MOD_SHIFT},
131	/* 0x24 '$' */ {0x05, KBDCHARDEF_MOD_SHIFT},
132	/* 0x25 '%' */ {0x06, KBDCHARDEF_MOD_SHIFT},
133	/* 0x26 '&' */ {0x08, KBDCHARDEF_MOD_SHIFT},
134	/* 0x27 ''' */ {0x28, KBDCHARDEF_MOD_NONE},
135	/* 0x28 '(' */ {0x0a, KBDCHARDEF_MOD_SHIFT},
136	/* 0x29 ')' */ {0x0b, KBDCHARDEF_MOD_SHIFT},
137	/* 0x2A '' / {0x09, KBDCHARDEF_MOD_SHIFT},
138	/* 0x2B '+' */ {0x0d, KBDCHARDEF_MOD_SHIFT},
139	/* 0x2C ',' */ {0x33, KBDCHARDEF_MOD_NONE},
140	/* 0x2D '-' */ {0x0c, KBDCHARDEF_MOD_NONE},
141	/* 0x2E '.' */ {0x34, KBDCHARDEF_MOD_NONE},
142	/* 0x2F '/' */ {0x35, KBDCHARDEF_MOD_NONE},
143	/* 0x30 '0' */ {0x0b, KBDCHARDEF_MOD_NONE},
144	/* 0x31 '1' */ {0x02, KBDCHARDEF_MOD_NONE},
145	/* 0x32 '2' */ {0x03, KBDCHARDEF_MOD_NONE},
146	/* 0x33 '3' */ {0x04, KBDCHARDEF_MOD_NONE},
147	/* 0x34 '4' */ {0x05, KBDCHARDEF_MOD_NONE},
148	/* 0x35 '5' */ {0x06, KBDCHARDEF_MOD_NONE},
149	/* 0x36 '6' */ {0x07, KBDCHARDEF_MOD_NONE},
150	/* 0x37 '7' */ {0x08, KBDCHARDEF_MOD_NONE},
151	/* 0x38 '8' */ {0x09, KBDCHARDEF_MOD_NONE},
152	/* 0x39 '9' */ {0x0a, KBDCHARDEF_MOD_NONE},
153	/* 0x3A ':' */ {0x27, KBDCHARDEF_MOD_SHIFT},
154	/* 0x3B ';' */ {0x27, KBDCHARDEF_MOD_NONE},
155	/* 0x3C '<' */ {0x33, KBDCHARDEF_MOD_SHIFT},
156	/* 0x3D '=' */ {0x0d, KBDCHARDEF_MOD_NONE},
157	/* 0x3E '>' */ {0x34, KBDCHARDEF_MOD_SHIFT},
158	/* 0x3F '?' */ {0x35, KBDCHARDEF_MOD_SHIFT},
159	/* 0x40 '@' */ {0x03, KBDCHARDEF_MOD_SHIFT},
160	/* 0x41 'A' */ {0x1e, KBDCHARDEF_MOD_SHIFT},
161	/* 0x42 'B' */ {0x30, KBDCHARDEF_MOD_SHIFT},
162	/* 0x43 'C' */ {0x2e, KBDCHARDEF_MOD_SHIFT},
163	/* 0x44 'D' */ {0x20, KBDCHARDEF_MOD_SHIFT},
164	/* 0x45 'E' */ {0x12, KBDCHARDEF_MOD_SHIFT},
165	/* 0x46 'F' */ {0x21, KBDCHARDEF_MOD_SHIFT},
166	/* 0x47 'G' */ {0x22, KBDCHARDEF_MOD_SHIFT},
167	/* 0x48 'H' */ {0x23, KBDCHARDEF_MOD_SHIFT},
168	/* 0x49 'I' */ {0x17, KBDCHARDEF_MOD_SHIFT},
169	/* 0x4A 'J' */ {0x24, KBDCHARDEF_MOD_SHIFT},
170	/* 0x4B 'K' */ {0x25, KBDCHARDEF_MOD_SHIFT},
171	/* 0x4C 'L' */ {0x26, KBDCHARDEF_MOD_SHIFT},
172	/* 0x4D 'M' */ {0x32, KBDCHARDEF_MOD_SHIFT},
173	/* 0x4E 'N' */ {0x31, KBDCHARDEF_MOD_SHIFT},
174	/* 0x4F 'O' */ {0x18, KBDCHARDEF_MOD_SHIFT},
175	/* 0x50 'P' */ {0x19, KBDCHARDEF_MOD_SHIFT},
176	/* 0x51 'Q' */ {0x10, KBDCHARDEF_MOD_SHIFT},
177	/* 0x52 'R' */ {0x13, KBDCHARDEF_MOD_SHIFT},
178	/* 0x53 'S' */ {0x1f, KBDCHARDEF_MOD_SHIFT},
179	/* 0x54 'T' */ {0x14, KBDCHARDEF_MOD_SHIFT},
180	/* 0x55 'U' */ {0x16, KBDCHARDEF_MOD_SHIFT},
181	/* 0x56 'V' */ {0x2f, KBDCHARDEF_MOD_SHIFT},
182	/* 0x57 'W' */ {0x11, KBDCHARDEF_MOD_SHIFT},
183	/* 0x58 'X' */ {0x2d, KBDCHARDEF_MOD_SHIFT},
184	/* 0x59 'Y' */ {0x15, KBDCHARDEF_MOD_SHIFT},
185	/* 0x5A 'Z' */ {0x2c, KBDCHARDEF_MOD_SHIFT},
186	/* 0x5B '[' */ {0x1a, KBDCHARDEF_MOD_NONE},
187	/* 0x5C '\' */ {0x2b, KBDCHARDEF_MOD_NONE},
188	/* 0x5D ']' */ {0x1b, KBDCHARDEF_MOD_NONE},
189	/* 0x5E '^' */ {0x07, KBDCHARDEF_MOD_SHIFT},
190	/* 0x5F '_' */ {0x0c, KBDCHARDEF_MOD_SHIFT},
191	/* 0x60 '`' */ {0x28, KBDCHARDEF_MOD_NONE},
192	/* 0x61 'a' */ {0x1e, KBDCHARDEF_MOD_NONE},
193	/* 0x62 'b' */ {0x30, KBDCHARDEF_MOD_NONE},
194	/* 0x63 'c' */ {0x2e, KBDCHARDEF_MOD_NONE},
195	/* 0x64 'd' */ {0x20, KBDCHARDEF_MOD_NONE},
196	/* 0x65 'e' */ {0x12, KBDCHARDEF_MOD_NONE},
197	/* 0x66 'f' */ {0x21, KBDCHARDEF_MOD_NONE},
198	/* 0x67 'g' */ {0x22, KBDCHARDEF_MOD_NONE},
199	/* 0x68 'h' */ {0x23, KBDCHARDEF_MOD_NONE},
200	/* 0x69 'i' */ {0x17, KBDCHARDEF_MOD_NONE},
201	/* 0x6A 'j' */ {0x24, KBDCHARDEF_MOD_NONE},
202	/* 0x6B 'k' */ {0x25, KBDCHARDEF_MOD_NONE},
203	/* 0x6C 'l' */ {0x26, KBDCHARDEF_MOD_NONE},
204	/* 0x6D 'm' */ {0x32, KBDCHARDEF_MOD_NONE},
205	/* 0x6E 'n' */ {0x31, KBDCHARDEF_MOD_NONE},
206	/* 0x6F 'o' */ {0x18, KBDCHARDEF_MOD_NONE},
207	/* 0x70 'p' */ {0x19, KBDCHARDEF_MOD_NONE},
208	/* 0x71 'q' */ {0x10, KBDCHARDEF_MOD_NONE},
209	/* 0x72 'r' */ {0x13, KBDCHARDEF_MOD_NONE},
210	/* 0x73 's' */ {0x1f, KBDCHARDEF_MOD_NONE},
211	/* 0x74 't' */ {0x14, KBDCHARDEF_MOD_NONE},
212	/* 0x75 'u' */ {0x16, KBDCHARDEF_MOD_NONE},
213	/* 0x76 'v' */ {0x2f, KBDCHARDEF_MOD_NONE},
214	/* 0x77 'w' */ {0x11, KBDCHARDEF_MOD_NONE},
215	/* 0x78 'x' */ {0x2d, KBDCHARDEF_MOD_NONE},
216	/* 0x79 'y' */ {0x15, KBDCHARDEF_MOD_NONE},
217	/* 0x7A 'z' */ {0x2c, KBDCHARDEF_MOD_NONE},
218	/* 0x7B '{' */ {0x1a, KBDCHARDEF_MOD_SHIFT},
219	/* 0x7C '\|' */ {0x2b, KBDCHARDEF_MOD_SHIFT},
220	/* 0x7D '}' */ {0x1b, KBDCHARDEF_MOD_SHIFT},
221	/* 0x7E '~' */ {0x29, KBDCHARDEF_MOD_SHIFT},
222	/* 0x7F ' ' */ {0x00, KBDCHARDEF_MOD_NONE},
223	};
224
225	static HRESULT keyboardPutScancodes(IKeyboard *pKeyboard, const std::list<LONG> &llScancodes)
226	{
227	/* Send scancodes to the VM. */
228	com::SafeArray<LONG> saScancodes(llScancodes);
229
230	#if 1
231	HRESULT rc = S_OK;
232	size_t i;
233	for (i = 0; i < saScancodes.size(); ++i)
234	{
235	rc = pKeyboard->PutScancode(saScancodes[i]);
236	if (FAILED(rc))
237	{
238	RTMsgError("Failed to send a scancode");
239	break;
240	}
241
242	RTThreadSleep(10); /* "Typing" too fast causes lost characters. */
243	}
244	#else
245	/** @todo PutScancodes does not deliver more than 20 scancodes. */
246	ULONG codesStored = 0;
247	HRESULT rc = pKeyboard->PutScancodes(ComSafeArrayAsInParam(saScancodes),
248	&codesStored);
249	if (SUCCEEDED(rc) && codesStored < saScancodes.size())
250	{
251	RTMsgError("Only %d scancodes were stored", codesStored);
252	rc = E_FAIL;
253	}
254	#endif
255
256	return rc;
257	}
258
259	static void keyboardCharsToScancodes(const char pch, size_t cchMax, std::list<LONG> &llScancodes, bool pfShift)
260	{
261	size_t cchProcessed = 0;
262	const char *p = pch;
263	while (cchProcessed < cchMax)
264	{
265	++cchProcessed;
266	const uint8_t c = (uint8_t)*p++;
267	if (c < RT_ELEMENTS(g_aASCIIChars))
268	{
269	const KBDCHARDEF *d = &g_aASCIIChars[c];
270	if (d->u8Scancode)
271	{
272	const bool fNeedShift = RT_BOOL(d->u8Modifiers & KBDCHARDEF_MOD_SHIFT);
273	if (*pfShift != fNeedShift)
274	{
275	*pfShift = fNeedShift;
276	/* Press or release the SHIFT key. */
277	llScancodes.push_back(0x2a \| (fNeedShift? 0x00: 0x80));
278	}
279
280	llScancodes.push_back(d->u8Scancode);
281	llScancodes.push_back(d->u8Scancode \| 0x80);
282	}
283	}
284	}
285	}
286
287	static HRESULT keyboardPutString(IKeyboard pKeyboard, int argc, char *argv)
288	{
289	std::list<LONG> llScancodes;
290	bool fShift = false;
291
292	/* Convert command line string(s) to the en-us keyboard scancodes. */
293	int i;
294	for (i = 1 + 1; i < argc; ++i)
295	{
296	if (!llScancodes.empty())
297	{
298	/* Insert a SPACE before the next string. */
299	llScancodes.push_back(0x39);
300	llScancodes.push_back(0x39 \| 0x80);
301	}
302
303	keyboardCharsToScancodes(argv[i], strlen(argv[i]), llScancodes, &fShift);
304	}
305
306	/* Release SHIFT if pressed. */
307	if (fShift)
308	llScancodes.push_back(0x2a \| 0x80);
309
310	return keyboardPutScancodes(pKeyboard, llScancodes);
311	}
312
313	static HRESULT keyboardPutFile(IKeyboard pKeyboard, const char pszFilename)
314	{
315	std::list<LONG> llScancodes;
316	bool fShift = false;
317
318	RTFILE File = NIL_RTFILE;
319	int vrc = RTFileOpen(&File, pszFilename, RTFILE_O_READ \| RTFILE_O_OPEN \| RTFILE_O_DENY_WRITE);
320	if (RT_SUCCESS(vrc))
321	{
322	uint64_t cbFile = 0;
323	vrc = RTFileQuerySize(File, &cbFile);
324	if (RT_SUCCESS(vrc))
325	{
326	const uint64_t cbFileMax = _64K;
327	if (cbFile <= cbFileMax)
328	{
329	const size_t cbBuffer = _4K;
330	char pchBuf = (char )RTMemAlloc(cbBuffer);
331	if (pchBuf)
332	{
333	size_t cbRemaining = (size_t)cbFile;
334	while (cbRemaining > 0)
335	{
336	const size_t cbToRead = cbRemaining > cbBuffer ? cbBuffer : cbRemaining;
337
338	size_t cbRead = 0;
339	vrc = RTFileRead(File, pchBuf, cbToRead, &cbRead);
340	if (RT_FAILURE(vrc) \|\| cbRead == 0)
341	break;
342
343	keyboardCharsToScancodes(pchBuf, cbRead, llScancodes, &fShift);
344	cbRemaining -= cbRead;
345	}
346
347	RTMemFree(pchBuf);
348	}
349	else
350	RTMsgError("Out of memory allocating %d bytes", cbBuffer);
351	}
352	else
353	RTMsgError("File size %RI64 is greater than %RI64: '%s'", cbFile, cbFileMax, pszFilename);
354	}
355	else
356	RTMsgError("Cannot get size of file '%s': %Rrc", pszFilename, vrc);
357
358	RTFileClose(File);
359	}
360	else
361	RTMsgError("Cannot open file '%s': %Rrc", pszFilename, vrc);
362
363	/* Release SHIFT if pressed. */
364	if (fShift)
365	llScancodes.push_back(0x2a \| 0x80);
366
367	return keyboardPutScancodes(pKeyboard, llScancodes);
368	}
369
370
371	RTEXITCODE handleControlVM(HandlerArg *a)
372	{
373	using namespace com;
374	bool fNeedsSaving = false;
375	HRESULT rc;
376
377	if (a->argc < 2)
378	return errorSyntax(USAGE_CONTROLVM, "Not enough parameters");
379
380	/* try to find the given machine */
381	ComPtr<IMachine> machine;
382	CHECK_ERROR(a->virtualBox, FindMachine(Bstr(a->argv[0]).raw(),
383	machine.asOutParam()));
384	if (FAILED(rc))
385	return RTEXITCODE_FAILURE;
386
387	/* open a session for the VM */
388	CHECK_ERROR_RET(machine, LockMachine(a->session, LockType_Shared), RTEXITCODE_FAILURE);
389
390	ComPtr<IConsole> console;
391	ComPtr<IMachine> sessionMachine;
392
393	do
394	{
395	/* get the associated console */
396	CHECK_ERROR_BREAK(a->session, COMGETTER(Console)(console.asOutParam()));
397	if (!console)
398	return RTMsgErrorExit(RTEXITCODE_FAILURE, "Machine '%s' is not currently running", a->argv[0]);
399
400	/* ... and session machine */
401	CHECK_ERROR_BREAK(a->session, COMGETTER(Machine)(sessionMachine.asOutParam()));
402
403	/* which command? */
404	if (!strcmp(a->argv[1], "pause"))
405	{
406	CHECK_ERROR_BREAK(console, Pause());
407	}
408	else if (!strcmp(a->argv[1], "resume"))
409	{
410	CHECK_ERROR_BREAK(console, Resume());
411	}
412	else if (!strcmp(a->argv[1], "reset"))
413	{
414	CHECK_ERROR_BREAK(console, Reset());
415	}
416	else if (!strcmp(a->argv[1], "unplugcpu"))
417	{
418	if (a->argc <= 1 + 1)
419	{
420	errorArgument("Missing argument to '%s'. Expected CPU number.", a->argv[1]);
421	rc = E_FAIL;
422	break;
423	}
424
425	unsigned n = parseNum(a->argv[2], 32, "CPU");
426
427	CHECK_ERROR_BREAK(sessionMachine, HotUnplugCPU(n));
428	}
429	else if (!strcmp(a->argv[1], "plugcpu"))
430	{
431	if (a->argc <= 1 + 1)
432	{
433	errorArgument("Missing argument to '%s'. Expected CPU number.", a->argv[1]);
434	rc = E_FAIL;
435	break;
436	}
437
438	unsigned n = parseNum(a->argv[2], 32, "CPU");
439
440	CHECK_ERROR_BREAK(sessionMachine, HotPlugCPU(n));
441	}
442	else if (!strcmp(a->argv[1], "cpuexecutioncap"))
443	{
444	if (a->argc <= 1 + 1)
445	{
446	errorArgument("Missing argument to '%s'. Expected execution cap number.", a->argv[1]);
447	rc = E_FAIL;
448	break;
449	}
450
451	unsigned n = parseNum(a->argv[2], 100, "ExecutionCap");
452
453	CHECK_ERROR_BREAK(sessionMachine, COMSETTER(CPUExecutionCap)(n));
454	}
455	else if (!strcmp(a->argv[1], "audioin"))
456	{
457	ComPtr<IAudioAdapter> adapter;
458	CHECK_ERROR_BREAK(sessionMachine, COMGETTER(AudioAdapter)(adapter.asOutParam()));
459	if (adapter)
460	{
461	if (!strcmp(a->argv[2], "on"))
462	{
463	CHECK_ERROR_RET(adapter, COMSETTER(EnabledIn)(TRUE), RTEXITCODE_FAILURE);
464	}
465	else if (!strcmp(a->argv[2], "off"))
466	{
467	CHECK_ERROR_RET(adapter, COMSETTER(EnabledIn)(FALSE), RTEXITCODE_FAILURE);
468	}
469	else
470	{
471	errorArgument("Invalid value '%s'", Utf8Str(a->argv[2]).c_str());
472	rc = E_FAIL;
473	break;
474	}
475	if (SUCCEEDED(rc))
476	fNeedsSaving = true;
477	}
478	else
479	{
480	errorArgument("audio adapter not enabled in VM configuration");
481	rc = E_FAIL;
482	break;
483	}
484	}
485	else if (!strcmp(a->argv[1], "audioout"))
486	{
487	ComPtr<IAudioAdapter> adapter;
488	CHECK_ERROR_BREAK(sessionMachine, COMGETTER(AudioAdapter)(adapter.asOutParam()));
489	if (adapter)
490	{
491	if (!strcmp(a->argv[2], "on"))
492	{
493	CHECK_ERROR_RET(adapter, COMSETTER(EnabledOut)(TRUE), RTEXITCODE_FAILURE);
494	}
495	else if (!strcmp(a->argv[2], "off"))
496	{
497	CHECK_ERROR_RET(adapter, COMSETTER(EnabledOut)(FALSE), RTEXITCODE_FAILURE);
498	}
499	else
500	{
501	errorArgument("Invalid value '%s'", Utf8Str(a->argv[2]).c_str());
502	rc = E_FAIL;
503	break;
504	}
505	if (SUCCEEDED(rc))
506	fNeedsSaving = true;
507	}
508	else
509	{
510	errorArgument("audio adapter not enabled in VM configuration");
511	rc = E_FAIL;
512	break;
513	}
514	}
515	#ifdef VBOX_WITH_SHARED_CLIPBOARD
516	else if (!strcmp(a->argv[1], "clipboard"))
517	{
518	if (a->argc <= 1 + 1)
519	{
520	errorArgument("Missing argument to '%s'.", a->argv[1]);
521	rc = E_FAIL;
522	break;
523	}
524
525	ClipboardMode_T mode = ClipboardMode_Disabled; /* Shut up MSC */
526	if (!strcmp(a->argv[2], "mode"))
527	{
528	if (!strcmp(a->argv[3], "disabled"))
529	mode = ClipboardMode_Disabled;
530	else if (!strcmp(a->argv[3], "hosttoguest"))
531	mode = ClipboardMode_HostToGuest;
532	else if (!strcmp(a->argv[3], "guesttohost"))
533	mode = ClipboardMode_GuestToHost;
534	else if (!strcmp(a->argv[3], "bidirectional"))
535	mode = ClipboardMode_Bidirectional;
536	else
537	{
538	errorArgument("Invalid '%s' argument '%s'.", a->argv[2], a->argv[3]);
539	rc = E_FAIL;
540	break;
541	}
542
543	CHECK_ERROR_BREAK(sessionMachine, COMSETTER(ClipboardMode)(mode));
544	if (SUCCEEDED(rc))
545	fNeedsSaving = true;
546	}
547	# ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS
548	else if (!strcmp(a->argv[2], "filetransfers"))
549	{
550	if (a->argc <= 1 + 2)
551	{
552	errorArgument("Missing argument to '%s'. Expected enabled / disabled.", a->argv[2]);
553	rc = E_FAIL;
554	break;
555	}
556
557	BOOL fEnabled;
558	if (!strcmp(a->argv[3], "enabled"))
559	{
560	fEnabled = TRUE;
561	}
562	else if (!strcmp(a->argv[3], "disabled"))
563	{
564	fEnabled = FALSE;
565	}
566	else
567	{
568	errorArgument("Invalid '%s' argument '%s'.", a->argv[2], a->argv[3]);
569	rc = E_FAIL;
570	break;
571	}
572
573	CHECK_ERROR_BREAK(sessionMachine, COMSETTER(ClipboardFileTransfersEnabled)(fEnabled));
574	if (SUCCEEDED(rc))
575	fNeedsSaving = true;
576	}
577	# endif /* VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS */
578	else
579	{
580	errorArgument("Invalid '%s' argument '%s'.", a->argv[1], a->argv[2]);
581	rc = E_FAIL;
582	break;
583	}
584	}
585	#endif /* VBOX_WITH_SHARED_CLIPBOARD */
586	else if (!strcmp(a->argv[1], "draganddrop"))
587	{
588	if (a->argc <= 1 + 1)
589	{
590	errorArgument("Missing argument to '%s'. Expected drag and drop mode.", a->argv[1]);
591	rc = E_FAIL;
592	break;
593	}
594
595	DnDMode_T mode = DnDMode_Disabled; /* Shup up MSC. */
596	if (!strcmp(a->argv[2], "disabled"))
597	mode = DnDMode_Disabled;
598	else if (!strcmp(a->argv[2], "hosttoguest"))
599	mode = DnDMode_HostToGuest;
600	else if (!strcmp(a->argv[2], "guesttohost"))
601	mode = DnDMode_GuestToHost;
602	else if (!strcmp(a->argv[2], "bidirectional"))
603	mode = DnDMode_Bidirectional;
604	else
605	{
606	errorArgument("Invalid '%s' argument '%s'.", a->argv[1], a->argv[2]);
607	rc = E_FAIL;
608	}
609	if (SUCCEEDED(rc))
610	{
611	CHECK_ERROR_BREAK(sessionMachine, COMSETTER(DnDMode)(mode));
612	if (SUCCEEDED(rc))
613	fNeedsSaving = true;
614	}
615	}
616	else if (!strcmp(a->argv[1], "poweroff"))
617	{
618	ComPtr<IProgress> progress;
619	CHECK_ERROR_BREAK(console, PowerDown(progress.asOutParam()));
620
621	rc = showProgress(progress);
622	CHECK_PROGRESS_ERROR(progress, ("Failed to power off machine"));
623	}
624	else if (!strcmp(a->argv[1], "savestate"))
625	{
626	/* first pause so we don't trigger a live save which needs more time/resources */
627	bool fPaused = false;
628	rc = console->Pause();
629	if (FAILED(rc))
630	{
631	bool fError = true;
632	if (rc == VBOX_E_INVALID_VM_STATE)
633	{
634	/* check if we are already paused */
635	MachineState_T machineState;
636	CHECK_ERROR_BREAK(console, COMGETTER(State)(&machineState));
637	/* the error code was lost by the previous instruction */
638	rc = VBOX_E_INVALID_VM_STATE;
639	if (machineState != MachineState_Paused)
640	{
641	RTMsgError("Machine in invalid state %d -- %s\n",
642	machineState, machineStateToName(machineState, false));
643	}
644	else
645	{
646	fError = false;
647	fPaused = true;
648	}
649	}
650	if (fError)
651	break;
652	}
653
654	ComPtr<IProgress> progress;
655	CHECK_ERROR(sessionMachine, SaveState(progress.asOutParam()));
656	if (FAILED(rc))
657	{
658	if (!fPaused)
659	console->Resume();
660	break;
661	}
662
663	rc = showProgress(progress);
664	CHECK_PROGRESS_ERROR(progress, ("Failed to save machine state"));
665	if (FAILED(rc))
666	{
667	if (!fPaused)
668	console->Resume();
669	}
670	}
671	else if (!strcmp(a->argv[1], "acpipowerbutton"))
672	{
673	CHECK_ERROR_BREAK(console, PowerButton());
674	}
675	else if (!strcmp(a->argv[1], "acpisleepbutton"))
676	{
677	CHECK_ERROR_BREAK(console, SleepButton());
678	}
679	else if ( !strcmp(a->argv[1], "reboot")
680	\|\| !strcmp(a->argv[1], "shutdown")) /* With shutdown we mean gracefully powering off the VM by letting the guest OS do its thing. */
681	{
682	ComPtr<IGuest> guest;
683	CHECK_ERROR_BREAK(console, COMGETTER(Guest)(guest.asOutParam()));
684
685	const bool fReboot = !strcmp(a->argv[1], "reboot");
686
687	com::SafeArray<GuestShutdownFlag_T> aShutdownFlags;
688	if (fReboot)
689	aShutdownFlags.push_back(GuestShutdownFlag_Reboot);
690	else
691	aShutdownFlags.push_back(GuestShutdownFlag_PowerOff);
692	CHECK_ERROR(guest, Shutdown(ComSafeArrayAsInParam(aShutdownFlags)));
693	if (FAILED(rc))
694	{
695	if (rc == VBOX_E_NOT_SUPPORTED)
696	RTPrintf("Current installed Guest Additions don't support %s the guest.",
697	fReboot ? "rebooting" : "shutting down");
698	}
699	}
700	else if (!strcmp(a->argv[1], "keyboardputscancode"))
701	{
702	ComPtr<IKeyboard> pKeyboard;
703	CHECK_ERROR_BREAK(console, COMGETTER(Keyboard)(pKeyboard.asOutParam()));
704	if (!pKeyboard)
705	{
706	RTMsgError("Guest not running");
707	rc = E_FAIL;
708	break;
709	}
710
711	if (a->argc <= 1 + 1)
712	{
713	errorArgument("Missing argument to '%s'. Expected IBM PC AT set 2 keyboard scancode(s) as hex byte(s).", a->argv[1]);
714	rc = E_FAIL;
715	break;
716	}
717
718	std::list<LONG> llScancodes;
719
720	/* Process the command line. */
721	int i;
722	for (i = 1 + 1; i < a->argc; i++)
723	{
724	if ( RT_C_IS_XDIGIT (a->argv[i][0])
725	&& RT_C_IS_XDIGIT (a->argv[i][1])
726	&& a->argv[i][2] == 0)
727	{
728	uint8_t u8Scancode;
729	int irc = RTStrToUInt8Ex(a->argv[i], NULL, 16, &u8Scancode);
730	if (RT_FAILURE (irc))
731	{
732	RTMsgError("Converting '%s' returned %Rrc!", a->argv[i], rc);
733	rc = E_FAIL;
734	break;
735	}
736
737	llScancodes.push_back(u8Scancode);
738	}
739	else
740	{
741	RTMsgError("Error: '%s' is not a hex byte!", a->argv[i]);
742	rc = E_FAIL;
743	break;
744	}
745	}
746
747	if (FAILED(rc))
748	break;
749
750	rc = keyboardPutScancodes(pKeyboard, llScancodes);
751	}
752	else if (!strcmp(a->argv[1], "keyboardputstring"))
753	{
754	ComPtr<IKeyboard> pKeyboard;
755	CHECK_ERROR_BREAK(console, COMGETTER(Keyboard)(pKeyboard.asOutParam()));
756	if (!pKeyboard)
757	{
758	RTMsgError("Guest not running");
759	rc = E_FAIL;
760	break;
761	}
762
763	if (a->argc <= 1 + 1)
764	{
765	errorArgument("Missing argument to '%s'. Expected ASCII string(s).", a->argv[1]);
766	rc = E_FAIL;
767	break;
768	}
769
770	rc = keyboardPutString(pKeyboard, a->argc, a->argv);
771	}
772	else if (!strcmp(a->argv[1], "keyboardputfile"))
773	{
774	ComPtr<IKeyboard> pKeyboard;
775	CHECK_ERROR_BREAK(console, COMGETTER(Keyboard)(pKeyboard.asOutParam()));
776	if (!pKeyboard)
777	{
778	RTMsgError("Guest not running");
779	rc = E_FAIL;
780	break;
781	}
782
783	if (a->argc <= 1 + 1)
784	{
785	errorArgument("Missing argument to '%s'. Expected file name.", a->argv[1]);
786	rc = E_FAIL;
787	break;
788	}
789
790	rc = keyboardPutFile(pKeyboard, a->argv[2]);
791	}
792	else if (!strncmp(a->argv[1], "setlinkstate", 12))
793	{
794	/* Get the number of network adapters */
795	ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
796	unsigned n = parseNum(&a->argv[1][12], NetworkAdapterCount, "NIC");
797	if (!n)
798	{
799	rc = E_FAIL;
800	break;
801	}
802	if (a->argc <= 1 + 1)
803	{
804	errorArgument("Missing argument to '%s'", a->argv[1]);
805	rc = E_FAIL;
806	break;
807	}
808	/* get the corresponding network adapter */
809	ComPtr<INetworkAdapter> adapter;
810	CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
811	if (adapter)
812	{
813	if (!strcmp(a->argv[2], "on"))
814	{
815	CHECK_ERROR_BREAK(adapter, COMSETTER(CableConnected)(TRUE));
816	}
817	else if (!strcmp(a->argv[2], "off"))
818	{
819	CHECK_ERROR_BREAK(adapter, COMSETTER(CableConnected)(FALSE));
820	}
821	else
822	{
823	errorArgument("Invalid link state '%s'", Utf8Str(a->argv[2]).c_str());
824	rc = E_FAIL;
825	break;
826	}
827	if (SUCCEEDED(rc))
828	fNeedsSaving = true;
829	}
830	}
831	/* here the order in which strncmp is called is important
832	* cause nictracefile can be very well compared with
833	* nictrace and nic and thus everything will always fail
834	* if the order is changed
835	*/
836	else if (!strncmp(a->argv[1], "nictracefile", 12))
837	{
838	/* Get the number of network adapters */
839	ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
840	unsigned n = parseNum(&a->argv[1][12], NetworkAdapterCount, "NIC");
841	if (!n)
842	{
843	rc = E_FAIL;
844	break;
845	}
846	if (a->argc <= 2)
847	{
848	errorArgument("Missing argument to '%s'", a->argv[1]);
849	rc = E_FAIL;
850	break;
851	}
852
853	/* get the corresponding network adapter */
854	ComPtr<INetworkAdapter> adapter;
855	CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
856	if (adapter)
857	{
858	BOOL fEnabled;
859	adapter->COMGETTER(Enabled)(&fEnabled);
860	if (fEnabled)
861	{
862	if (a->argv[2])
863	{
864	CHECK_ERROR_RET(adapter, COMSETTER(TraceFile)(Bstr(a->argv[2]).raw()), RTEXITCODE_FAILURE);
865	}
866	else
867	{
868	errorArgument("Invalid filename or filename not specified for NIC %lu", n);
869	rc = E_FAIL;
870	break;
871	}
872	if (SUCCEEDED(rc))
873	fNeedsSaving = true;
874	}
875	else
876	RTMsgError("The NIC %d is currently disabled and thus its tracefile can't be changed", n);
877	}
878	}
879	else if (!strncmp(a->argv[1], "nictrace", 8))
880	{
881	/* Get the number of network adapters */
882	ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
883	unsigned n = parseNum(&a->argv[1][8], NetworkAdapterCount, "NIC");
884	if (!n)
885	{
886	rc = E_FAIL;
887	break;
888	}
889	if (a->argc <= 2)
890	{
891	errorArgument("Missing argument to '%s'", a->argv[1]);
892	rc = E_FAIL;
893	break;
894	}
895
896	/* get the corresponding network adapter */
897	ComPtr<INetworkAdapter> adapter;
898	CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
899	if (adapter)
900	{
901	BOOL fEnabled;
902	adapter->COMGETTER(Enabled)(&fEnabled);
903	if (fEnabled)
904	{
905	if (!strcmp(a->argv[2], "on"))
906	{
907	CHECK_ERROR_RET(adapter, COMSETTER(TraceEnabled)(TRUE), RTEXITCODE_FAILURE);
908	}
909	else if (!strcmp(a->argv[2], "off"))
910	{
911	CHECK_ERROR_RET(adapter, COMSETTER(TraceEnabled)(FALSE), RTEXITCODE_FAILURE);
912	}
913	else
914	{
915	errorArgument("Invalid nictrace%lu argument '%s'", n, Utf8Str(a->argv[2]).c_str());
916	rc = E_FAIL;
917	break;
918	}
919	if (SUCCEEDED(rc))
920	fNeedsSaving = true;
921	}
922	else
923	RTMsgError("The NIC %d is currently disabled and thus its trace flag can't be changed", n);
924	}
925	}
926	else if( a->argc > 2
927	&& !strncmp(a->argv[1], "natpf", 5))
928	{
929	/* Get the number of network adapters */
930	ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
931	unsigned n = parseNum(&a->argv[1][5], NetworkAdapterCount, "NIC");
932	if (!n)
933	{
934	rc = E_FAIL;
935	break;
936	}
937	if (a->argc <= 2)
938	{
939	errorArgument("Missing argument to '%s'", a->argv[1]);
940	rc = E_FAIL;
941	break;
942	}
943
944	/* get the corresponding network adapter */
945	ComPtr<INetworkAdapter> adapter;
946	CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
947	if (!adapter)
948	{
949	rc = E_FAIL;
950	break;
951	}
952	ComPtr<INATEngine> engine;
953	CHECK_ERROR(adapter, COMGETTER(NATEngine)(engine.asOutParam()));
954	if (!engine)
955	{
956	rc = E_FAIL;
957	break;
958	}
959
960	if (!strcmp(a->argv[2], "delete"))
961	{
962	if (a->argc >= 3)
963	CHECK_ERROR(engine, RemoveRedirect(Bstr(a->argv[3]).raw()));
964	}
965	else
966	{
967	#define ITERATE_TO_NEXT_TERM(ch) \
968	do { \
969	while (*ch != ',') \
970	{ \
971	if (*ch == 0) \
972	{ \
973	return errorSyntax(USAGE_CONTROLVM, \
974	"Missing or invalid argument to '%s'", \
975	a->argv[1]); \
976	} \
977	ch++; \
978	} \
979	*ch = '\0'; \
980	ch++; \
981	} while(0)
982
983	char *strName;
984	char *strProto;
985	char *strHostIp;
986	char *strHostPort;
987	char *strGuestIp;
988	char *strGuestPort;
989	char *strRaw = RTStrDup(a->argv[2]);
990	char *ch = strRaw;
991	strName = RTStrStrip(ch);
992	ITERATE_TO_NEXT_TERM(ch);
993	strProto = RTStrStrip(ch);
994	ITERATE_TO_NEXT_TERM(ch);
995	strHostIp = RTStrStrip(ch);
996	ITERATE_TO_NEXT_TERM(ch);
997	strHostPort = RTStrStrip(ch);
998	ITERATE_TO_NEXT_TERM(ch);
999	strGuestIp = RTStrStrip(ch);
1000	ITERATE_TO_NEXT_TERM(ch);
1001	strGuestPort = RTStrStrip(ch);
1002	NATProtocol_T proto;
1003	if (RTStrICmp(strProto, "udp") == 0)
1004	proto = NATProtocol_UDP;
1005	else if (RTStrICmp(strProto, "tcp") == 0)
1006	proto = NATProtocol_TCP;
1007	else
1008	{
1009	return errorSyntax(USAGE_CONTROLVM,
1010	"Wrong rule proto '%s' specified -- only 'udp' and 'tcp' are allowed.",
1011	strProto);
1012	}
1013	CHECK_ERROR(engine, AddRedirect(Bstr(strName).raw(), proto, Bstr(strHostIp).raw(),
1014	RTStrToUInt16(strHostPort), Bstr(strGuestIp).raw(), RTStrToUInt16(strGuestPort)));
1015	#undef ITERATE_TO_NEXT_TERM
1016	}
1017	if (SUCCEEDED(rc))
1018	fNeedsSaving = true;
1019	}
1020	else if (!strncmp(a->argv[1], "nicproperty", 11))
1021	{
1022	/* Get the number of network adapters */
1023	ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
1024	unsigned n = parseNum(&a->argv[1][11], NetworkAdapterCount, "NIC");
1025	if (!n)
1026	{
1027	rc = E_FAIL;
1028	break;
1029	}
1030	if (a->argc <= 2)
1031	{
1032	errorArgument("Missing argument to '%s'", a->argv[1]);
1033	rc = E_FAIL;
1034	break;
1035	}
1036
1037	/* get the corresponding network adapter */
1038	ComPtr<INetworkAdapter> adapter;
1039	CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
1040	if (adapter)
1041	{
1042	BOOL fEnabled;
1043	adapter->COMGETTER(Enabled)(&fEnabled);
1044	if (fEnabled)
1045	{
1046	/* Parse 'name=value' */
1047	char *pszProperty = RTStrDup(a->argv[2]);
1048	if (pszProperty)
1049	{
1050	char *pDelimiter = strchr(pszProperty, '=');
1051	if (pDelimiter)
1052	{
1053	*pDelimiter = '\0';
1054
1055	Bstr bstrName = pszProperty;
1056	Bstr bstrValue = &pDelimiter[1];
1057	CHECK_ERROR(adapter, SetProperty(bstrName.raw(), bstrValue.raw()));
1058	if (SUCCEEDED(rc))
1059	fNeedsSaving = true;
1060	}
1061	else
1062	{
1063	errorArgument("Invalid nicproperty%d argument '%s'", n, a->argv[2]);
1064	rc = E_FAIL;
1065	}
1066	RTStrFree(pszProperty);
1067	}
1068	else
1069	{
1070	RTStrmPrintf(g_pStdErr, "Error: Failed to allocate memory for nicproperty%d '%s'\n", n, a->argv[2]);
1071	rc = E_FAIL;
1072	}
1073	if (FAILED(rc))
1074	break;
1075	}
1076	else
1077	RTMsgError("The NIC %d is currently disabled and thus its properties can't be changed", n);
1078	}
1079	}
1080	else if (!strncmp(a->argv[1], "nicpromisc", 10))
1081	{
1082	/* Get the number of network adapters */
1083	ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
1084	unsigned n = parseNum(&a->argv[1][10], NetworkAdapterCount, "NIC");
1085	if (!n)
1086	{
1087	rc = E_FAIL;
1088	break;
1089	}
1090	if (a->argc <= 2)
1091	{
1092	errorArgument("Missing argument to '%s'", a->argv[1]);
1093	rc = E_FAIL;
1094	break;
1095	}
1096
1097	/* get the corresponding network adapter */
1098	ComPtr<INetworkAdapter> adapter;
1099	CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
1100	if (adapter)
1101	{
1102	BOOL fEnabled;
1103	adapter->COMGETTER(Enabled)(&fEnabled);
1104	if (fEnabled)
1105	{
1106	NetworkAdapterPromiscModePolicy_T enmPromiscModePolicy;
1107	if (!strcmp(a->argv[2], "deny"))
1108	enmPromiscModePolicy = NetworkAdapterPromiscModePolicy_Deny;
1109	else if ( !strcmp(a->argv[2], "allow-vms")
1110	\|\| !strcmp(a->argv[2], "allow-network"))
1111	enmPromiscModePolicy = NetworkAdapterPromiscModePolicy_AllowNetwork;
1112	else if (!strcmp(a->argv[2], "allow-all"))
1113	enmPromiscModePolicy = NetworkAdapterPromiscModePolicy_AllowAll;
1114	else
1115	{
1116	errorArgument("Unknown promiscuous mode policy '%s'", a->argv[2]);
1117	rc = E_INVALIDARG;
1118	break;
1119	}
1120
1121	CHECK_ERROR(adapter, COMSETTER(PromiscModePolicy)(enmPromiscModePolicy));
1122	if (SUCCEEDED(rc))
1123	fNeedsSaving = true;
1124	}
1125	else
1126	RTMsgError("The NIC %d is currently disabled and thus its promiscuous mode can't be changed", n);
1127	}
1128	}
1129	else if (!strncmp(a->argv[1], "nic", 3))
1130	{
1131	/* Get the number of network adapters */
1132	ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
1133	unsigned n = parseNum(&a->argv[1][3], NetworkAdapterCount, "NIC");
1134	if (!n)
1135	{
1136	rc = E_FAIL;
1137	break;
1138	}
1139	if (a->argc <= 2)
1140	{
1141	errorArgument("Missing argument to '%s'", a->argv[1]);
1142	rc = E_FAIL;
1143	break;
1144	}
1145
1146	/* get the corresponding network adapter */
1147	ComPtr<INetworkAdapter> adapter;
1148	CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
1149	if (adapter)
1150	{
1151	BOOL fEnabled;
1152	adapter->COMGETTER(Enabled)(&fEnabled);
1153	if (fEnabled)
1154	{
1155	if (!strcmp(a->argv[2], "null"))
1156	{
1157	CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Null), RTEXITCODE_FAILURE);
1158	}
1159	else if (!strcmp(a->argv[2], "nat"))
1160	{
1161	if (a->argc == 4)
1162	CHECK_ERROR_RET(adapter, COMSETTER(NATNetwork)(Bstr(a->argv[3]).raw()), RTEXITCODE_FAILURE);
1163	CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_NAT), RTEXITCODE_FAILURE);
1164	}
1165	else if ( !strcmp(a->argv[2], "bridged")
1166	\|\| !strcmp(a->argv[2], "hostif")) /* backward compatibility */
1167	{
1168	if (a->argc <= 3)
1169	{
1170	errorArgument("Missing argument to '%s'", a->argv[2]);
1171	rc = E_FAIL;
1172	break;
1173	}
1174	CHECK_ERROR_RET(adapter, COMSETTER(BridgedInterface)(Bstr(a->argv[3]).raw()), RTEXITCODE_FAILURE);
1175	CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Bridged), RTEXITCODE_FAILURE);
1176	}
1177	else if (!strcmp(a->argv[2], "intnet"))
1178	{
1179	if (a->argc <= 3)
1180	{
1181	errorArgument("Missing argument to '%s'", a->argv[2]);
1182	rc = E_FAIL;
1183	break;
1184	}
1185	CHECK_ERROR_RET(adapter, COMSETTER(InternalNetwork)(Bstr(a->argv[3]).raw()), RTEXITCODE_FAILURE);
1186	CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Internal), RTEXITCODE_FAILURE);
1187	}
1188	#if defined(VBOX_WITH_NETFLT)
1189	else if (!strcmp(a->argv[2], "hostonly"))
1190	{
1191	if (a->argc <= 3)
1192	{
1193	errorArgument("Missing argument to '%s'", a->argv[2]);
1194	rc = E_FAIL;
1195	break;
1196	}
1197	CHECK_ERROR_RET(adapter, COMSETTER(HostOnlyInterface)(Bstr(a->argv[3]).raw()), RTEXITCODE_FAILURE);
1198	CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_HostOnly), RTEXITCODE_FAILURE);
1199	}
1200	#endif
1201	else if (!strcmp(a->argv[2], "generic"))
1202	{
1203	if (a->argc <= 3)
1204	{
1205	errorArgument("Missing argument to '%s'", a->argv[2]);
1206	rc = E_FAIL;
1207	break;
1208	}
1209	CHECK_ERROR_RET(adapter, COMSETTER(GenericDriver)(Bstr(a->argv[3]).raw()), RTEXITCODE_FAILURE);
1210	CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Generic), RTEXITCODE_FAILURE);
1211	}
1212	else if (!strcmp(a->argv[2], "natnetwork"))
1213	{
1214	if (a->argc <= 3)
1215	{
1216	errorArgument("Missing argument to '%s'", a->argv[2]);
1217	rc = E_FAIL;
1218	break;
1219	}
1220	CHECK_ERROR_RET(adapter, COMSETTER(NATNetwork)(Bstr(a->argv[3]).raw()), RTEXITCODE_FAILURE);
1221	CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_NATNetwork), RTEXITCODE_FAILURE);
1222	}
1223	/** @todo obsolete, remove eventually */
1224	else if (!strcmp(a->argv[2], "vde"))
1225	{
1226	if (a->argc <= 3)
1227	{
1228	errorArgument("Missing argument to '%s'", a->argv[2]);
1229	rc = E_FAIL;
1230	break;
1231	}
1232	CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Generic), RTEXITCODE_FAILURE);
1233	CHECK_ERROR_RET(adapter, SetProperty(Bstr("name").raw(), Bstr(a->argv[3]).raw()), RTEXITCODE_FAILURE);
1234	}
1235	else
1236	{
1237	errorArgument("Invalid type '%s' specfied for NIC %lu", Utf8Str(a->argv[2]).c_str(), n);
1238	rc = E_FAIL;
1239	break;
1240	}
1241	if (SUCCEEDED(rc))
1242	fNeedsSaving = true;
1243	}
1244	else
1245	RTMsgError("The NIC %d is currently disabled and thus its attachment type can't be changed", n);
1246	}
1247	}
1248	else if ( !strcmp(a->argv[1], "vrde")
1249	\|\| !strcmp(a->argv[1], "vrdp"))
1250	{
1251	if (!strcmp(a->argv[1], "vrdp"))
1252	RTStrmPrintf(g_pStdErr, "Warning: 'vrdp' is deprecated. Use 'vrde'.\n");
1253
1254	if (a->argc <= 1 + 1)
1255	{
1256	errorArgument("Missing argument to '%s'", a->argv[1]);
1257	rc = E_FAIL;
1258	break;
1259	}
1260	ComPtr<IVRDEServer> vrdeServer;
1261	sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
1262	ASSERT(vrdeServer);
1263	if (vrdeServer)
1264	{
1265	if (!strcmp(a->argv[2], "on"))
1266	{
1267	CHECK_ERROR_BREAK(vrdeServer, COMSETTER(Enabled)(TRUE));
1268	}
1269	else if (!strcmp(a->argv[2], "off"))
1270	{
1271	CHECK_ERROR_BREAK(vrdeServer, COMSETTER(Enabled)(FALSE));
1272	}
1273	else
1274	{
1275	errorArgument("Invalid remote desktop server state '%s'", Utf8Str(a->argv[2]).c_str());
1276	rc = E_FAIL;
1277	break;
1278	}
1279	if (SUCCEEDED(rc))
1280	fNeedsSaving = true;
1281	}
1282	}
1283	else if ( !strcmp(a->argv[1], "vrdeport")
1284	\|\| !strcmp(a->argv[1], "vrdpport"))
1285	{
1286	if (!strcmp(a->argv[1], "vrdpport"))
1287	RTStrmPrintf(g_pStdErr, "Warning: 'vrdpport' is deprecated. Use 'vrdeport'.\n");
1288
1289	if (a->argc <= 1 + 1)
1290	{
1291	errorArgument("Missing argument to '%s'", a->argv[1]);
1292	rc = E_FAIL;
1293	break;
1294	}
1295
1296	ComPtr<IVRDEServer> vrdeServer;
1297	sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
1298	ASSERT(vrdeServer);
1299	if (vrdeServer)
1300	{
1301	Bstr ports;
1302
1303	if (!strcmp(a->argv[2], "default"))
1304	ports = "0";
1305	else
1306	ports = a->argv[2];
1307
1308	CHECK_ERROR_BREAK(vrdeServer, SetVRDEProperty(Bstr("TCP/Ports").raw(), ports.raw()));
1309	if (SUCCEEDED(rc))
1310	fNeedsSaving = true;
1311	}
1312	}
1313	else if ( !strcmp(a->argv[1], "vrdevideochannelquality")
1314	\|\| !strcmp(a->argv[1], "vrdpvideochannelquality"))
1315	{
1316	if (!strcmp(a->argv[1], "vrdpvideochannelquality"))
1317	RTStrmPrintf(g_pStdErr, "Warning: 'vrdpvideochannelquality' is deprecated. Use 'vrdevideochannelquality'.\n");
1318
1319	if (a->argc <= 1 + 1)
1320	{
1321	errorArgument("Missing argument to '%s'", a->argv[1]);
1322	rc = E_FAIL;
1323	break;
1324	}
1325	ComPtr<IVRDEServer> vrdeServer;
1326	sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
1327	ASSERT(vrdeServer);
1328	if (vrdeServer)
1329	{
1330	Bstr value = a->argv[2];
1331
1332	CHECK_ERROR(vrdeServer, SetVRDEProperty(Bstr("VideoChannel/Quality").raw(), value.raw()));
1333	if (SUCCEEDED(rc))
1334	fNeedsSaving = true;
1335	}
1336	}
1337	else if (!strcmp(a->argv[1], "vrdeproperty"))
1338	{
1339	if (a->argc <= 1 + 1)
1340	{
1341	errorArgument("Missing argument to '%s'", a->argv[1]);
1342	rc = E_FAIL;
1343	break;
1344	}
1345	ComPtr<IVRDEServer> vrdeServer;
1346	sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
1347	ASSERT(vrdeServer);
1348	if (vrdeServer)
1349	{
1350	/* Parse 'name=value' */
1351	char *pszProperty = RTStrDup(a->argv[2]);
1352	if (pszProperty)
1353	{
1354	char *pDelimiter = strchr(pszProperty, '=');
1355	if (pDelimiter)
1356	{
1357	*pDelimiter = '\0';
1358
1359	Bstr bstrName = pszProperty;
1360	Bstr bstrValue = &pDelimiter[1];
1361	CHECK_ERROR(vrdeServer, SetVRDEProperty(bstrName.raw(), bstrValue.raw()));
1362	if (SUCCEEDED(rc))
1363	fNeedsSaving = true;
1364	}
1365	else
1366	{
1367	errorArgument("Invalid vrdeproperty argument '%s'", a->argv[2]);
1368	rc = E_FAIL;
1369	}
1370	RTStrFree(pszProperty);
1371	}
1372	else
1373	{
1374	RTStrmPrintf(g_pStdErr, "Error: Failed to allocate memory for VRDE property '%s'\n", a->argv[2]);
1375	rc = E_FAIL;
1376	}
1377	}
1378	if (FAILED(rc))
1379	{
1380	break;
1381	}
1382	}
1383	else if ( !strcmp(a->argv[1], "usbattach")
1384	\|\| !strcmp(a->argv[1], "usbdetach"))
1385	{
1386	if (a->argc < 3)
1387	{
1388	errorSyntax(USAGE_CONTROLVM, "Not enough parameters");
1389	rc = E_FAIL;
1390	break;
1391	}
1392	else if (a->argc == 4 \|\| a->argc > 5)
1393	{
1394	errorSyntax(USAGE_CONTROLVM, "Wrong number of arguments");
1395	rc = E_FAIL;
1396	break;
1397	}
1398
1399	bool attach = !strcmp(a->argv[1], "usbattach");
1400
1401	Bstr usbId = a->argv[2];
1402	Bstr captureFilename;
1403
1404	if (a->argc == 5)
1405	{
1406	if (!strcmp(a->argv[3], "--capturefile"))
1407	captureFilename = a->argv[4];
1408	else
1409	{
1410	errorArgument("Invalid parameter '%s'", a->argv[3]);
1411	rc = E_FAIL;
1412	break;
1413	}
1414	}
1415
1416	Guid guid(usbId);
1417	if (!guid.isValid())
1418	{
1419	// assume address
1420	if (attach)
1421	{
1422	ComPtr<IHost> host;
1423	CHECK_ERROR_BREAK(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
1424	SafeIfaceArray <IHostUSBDevice> coll;
1425	CHECK_ERROR_BREAK(host, COMGETTER(USBDevices)(ComSafeArrayAsOutParam(coll)));
1426	ComPtr<IHostUSBDevice> dev;
1427	CHECK_ERROR_BREAK(host, FindUSBDeviceByAddress(Bstr(a->argv[2]).raw(),
1428	dev.asOutParam()));
1429	CHECK_ERROR_BREAK(dev, COMGETTER(Id)(usbId.asOutParam()));
1430	}
1431	else
1432	{
1433	SafeIfaceArray <IUSBDevice> coll;
1434	CHECK_ERROR_BREAK(console, COMGETTER(USBDevices)(ComSafeArrayAsOutParam(coll)));
1435	ComPtr<IUSBDevice> dev;
1436	CHECK_ERROR_BREAK(console, FindUSBDeviceByAddress(Bstr(a->argv[2]).raw(),
1437	dev.asOutParam()));
1438	CHECK_ERROR_BREAK(dev, COMGETTER(Id)(usbId.asOutParam()));
1439	}
1440	}
1441	else if (guid.isZero())
1442	{
1443	errorArgument("Zero UUID argument '%s'", a->argv[2]);
1444	rc = E_FAIL;
1445	break;
1446	}
1447
1448	if (attach)
1449	CHECK_ERROR_BREAK(console, AttachUSBDevice(usbId.raw(), captureFilename.raw()));
1450	else
1451	{
1452	ComPtr<IUSBDevice> dev;
1453	CHECK_ERROR_BREAK(console, DetachUSBDevice(usbId.raw(),
1454	dev.asOutParam()));
1455	}
1456	}
1457	else if (!strcmp(a->argv[1], "setvideomodehint"))
1458	{
1459	if (a->argc != 5 && a->argc != 6 && a->argc != 7 && a->argc != 9)
1460	{
1461	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
1462	rc = E_FAIL;
1463	break;
1464	}
1465	bool fEnabled = true;
1466	uint32_t uXRes = RTStrToUInt32(a->argv[2]);
1467	uint32_t uYRes = RTStrToUInt32(a->argv[3]);
1468	uint32_t uBpp = RTStrToUInt32(a->argv[4]);
1469	uint32_t uDisplayIdx = 0;
1470	bool fChangeOrigin = false;
1471	int32_t iOriginX = 0;
1472	int32_t iOriginY = 0;
1473	if (a->argc >= 6)
1474	uDisplayIdx = RTStrToUInt32(a->argv[5]);
1475	if (a->argc >= 7)
1476	{
1477	int vrc = parseBool(a->argv[6], &fEnabled);
1478	if (RT_FAILURE(vrc))
1479	{
1480	errorSyntax(USAGE_CONTROLVM, "Either \"yes\" or \"no\" is expected");
1481	rc = E_FAIL;
1482	break;
1483	}
1484	fEnabled = !RTStrICmp(a->argv[6], "yes");
1485	}
1486	if (a->argc == 9)
1487	{
1488	iOriginX = RTStrToInt32(a->argv[7]);
1489	iOriginY = RTStrToInt32(a->argv[8]);
1490	fChangeOrigin = true;
1491	}
1492
1493	ComPtr<IDisplay> pDisplay;
1494	CHECK_ERROR_BREAK(console, COMGETTER(Display)(pDisplay.asOutParam()));
1495	if (!pDisplay)
1496	{
1497	RTMsgError("Guest not running");
1498	rc = E_FAIL;
1499	break;
1500	}
1501	CHECK_ERROR_BREAK(pDisplay, SetVideoModeHint(uDisplayIdx, fEnabled,
1502	fChangeOrigin, iOriginX, iOriginY,
1503	uXRes, uYRes, uBpp, true));
1504	}
1505	else if (!strcmp(a->argv[1], "setscreenlayout"))
1506	{
1507	if (a->argc < 4)
1508	{
1509	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
1510	rc = E_FAIL;
1511	break;
1512	}
1513
1514	ComPtr<IDisplay> pDisplay;
1515	CHECK_ERROR_BREAK(console, COMGETTER(Display)(pDisplay.asOutParam()));
1516	if (!pDisplay)
1517	{
1518	RTMsgError("Guest not running");
1519	rc = E_FAIL;
1520	break;
1521	}
1522
1523	com::SafeIfaceArray<IGuestScreenInfo> aGuestScreenInfos;
1524
1525	/* Parse "<display> on\|primary <xorigin> <yorigin> <xres> <yres> <bpp> \| off" sequences. */
1526	int argc = a->argc - 2;
1527	char **argv = &a->argv[2];
1528	while (argc >= 2)
1529	{
1530	ULONG aDisplay = RTStrToUInt32(argv[0]);
1531	BOOL aPrimary = FALSE;
1532
1533	GuestMonitorStatus_T aStatus;
1534	if (RTStrICmp(argv[1], "primary") == 0)
1535	{
1536	aStatus = GuestMonitorStatus_Enabled;
1537	aPrimary = TRUE;
1538	}
1539	else if (RTStrICmp(argv[1], "on") == 0)
1540	aStatus = GuestMonitorStatus_Enabled;
1541	else if (RTStrICmp(argv[1], "off") == 0)
1542	aStatus = GuestMonitorStatus_Disabled;
1543	else
1544	{
1545	errorSyntax(USAGE_CONTROLVM, "Display status must be <on> or <off>");
1546	rc = E_FAIL;
1547	break;
1548	}
1549
1550	BOOL aChangeOrigin = FALSE;
1551	LONG aOriginX = 0;
1552	LONG aOriginY = 0;
1553	ULONG aWidth = 0;
1554	ULONG aHeight = 0;
1555	ULONG aBitsPerPixel = 0;
1556	if (aStatus == GuestMonitorStatus_Enabled)
1557	{
1558	if (argc < 7)
1559	{
1560	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
1561	rc = E_FAIL;
1562	break;
1563	}
1564
1565	aChangeOrigin = TRUE;
1566	aOriginX = RTStrToUInt32(argv[2]);
1567	aOriginY = RTStrToUInt32(argv[3]);
1568	aWidth = RTStrToUInt32(argv[4]);
1569	aHeight = RTStrToUInt32(argv[5]);
1570	aBitsPerPixel = RTStrToUInt32(argv[6]);
1571
1572	argc -= 7;
1573	argv += 7;
1574	}
1575	else
1576	{
1577	argc -= 2;
1578	argv += 2;
1579	}
1580
1581	ComPtr<IGuestScreenInfo> pInfo;
1582	CHECK_ERROR_BREAK(pDisplay, CreateGuestScreenInfo(aDisplay, aStatus, aPrimary, aChangeOrigin,
1583	aOriginX, aOriginY, aWidth, aHeight, aBitsPerPixel,
1584	pInfo.asOutParam()));
1585	aGuestScreenInfos.push_back(pInfo);
1586	}
1587
1588	if (FAILED(rc))
1589	break;
1590
1591	CHECK_ERROR_BREAK(pDisplay, SetScreenLayout(ScreenLayoutMode_Apply, ComSafeArrayAsInParam(aGuestScreenInfos)));
1592	}
1593	else if (!strcmp(a->argv[1], "setcredentials"))
1594	{
1595	bool fAllowLocalLogon = true;
1596	if ( a->argc == 7
1597	\|\| ( a->argc == 8
1598	&& ( !strcmp(a->argv[3], "-p")
1599	\|\| !strcmp(a->argv[3], "--passwordfile"))))
1600	{
1601	if ( strcmp(a->argv[5 + (a->argc - 7)], "--allowlocallogon")
1602	&& strcmp(a->argv[5 + (a->argc - 7)], "-allowlocallogon"))
1603	{
1604	errorArgument("Invalid parameter '%s'", a->argv[5]);
1605	rc = E_FAIL;
1606	break;
1607	}
1608	if (!strcmp(a->argv[6 + (a->argc - 7)], "no"))
1609	fAllowLocalLogon = false;
1610	}
1611	else if ( a->argc != 5
1612	&& ( a->argc != 6
1613	\|\| ( strcmp(a->argv[3], "-p")
1614	&& strcmp(a->argv[3], "--passwordfile"))))
1615	{
1616	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
1617	rc = E_FAIL;
1618	break;
1619	}
1620	Utf8Str passwd, domain;
1621	if (a->argc == 5 \|\| a->argc == 7)
1622	{
1623	passwd = a->argv[3];
1624	domain = a->argv[4];
1625	}
1626	else
1627	{
1628	RTEXITCODE rcExit = readPasswordFile(a->argv[4], &passwd);
1629	if (rcExit != RTEXITCODE_SUCCESS)
1630	{
1631	rc = E_FAIL;
1632	break;
1633	}
1634	domain = a->argv[5];
1635	}
1636
1637	ComPtr<IGuest> pGuest;
1638	CHECK_ERROR_BREAK(console, COMGETTER(Guest)(pGuest.asOutParam()));
1639	if (!pGuest)
1640	{
1641	RTMsgError("Guest not running");
1642	rc = E_FAIL;
1643	break;
1644	}
1645	CHECK_ERROR_BREAK(pGuest, SetCredentials(Bstr(a->argv[2]).raw(),
1646	Bstr(passwd).raw(),
1647	Bstr(domain).raw(),
1648	fAllowLocalLogon));
1649	}
1650	#if 0 /** @todo review & remove */
1651	else if (!strcmp(a->argv[1], "dvdattach"))
1652	{
1653	Bstr uuid;
1654	if (a->argc != 3)
1655	{
1656	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
1657	rc = E_FAIL;
1658	break;
1659	}
1660
1661	ComPtr<IMedium> dvdMedium;
1662
1663	/* unmount? */
1664	if (!strcmp(a->argv[2], "none"))
1665	{
1666	/* nothing to do, NULL object will cause unmount */
1667	}
1668	/* host drive? */
1669	else if (!strncmp(a->argv[2], "host:", 5))
1670	{
1671	ComPtr<IHost> host;
1672	CHECK_ERROR(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
1673
1674	rc = host->FindHostDVDDrive(Bstr(a->argv[2] + 5), dvdMedium.asOutParam());
1675	if (!dvdMedium)
1676	{
1677	errorArgument("Invalid host DVD drive name \"%s\"",
1678	a->argv[2] + 5);
1679	rc = E_FAIL;
1680	break;
1681	}
1682	}
1683	else
1684	{
1685	/* first assume it's a UUID */
1686	uuid = a->argv[2];
1687	rc = a->virtualBox->GetDVDImage(uuid, dvdMedium.asOutParam());
1688	if (FAILED(rc) \|\| !dvdMedium)
1689	{
1690	/* must be a filename, check if it's in the collection */
1691	rc = a->virtualBox->FindDVDImage(Bstr(a->argv[2]), dvdMedium.asOutParam());
1692	/* not registered, do that on the fly */
1693	if (!dvdMedium)
1694	{
1695	Bstr emptyUUID;
1696	CHECK_ERROR(a->virtualBox, OpenDVDImage(Bstr(a->argv[2]), emptyUUID, dvdMedium.asOutParam()));
1697	}
1698	}
1699	if (!dvdMedium)
1700	{
1701	rc = E_FAIL;
1702	break;
1703	}
1704	}
1705
1706	/** @todo generalize this, allow arbitrary number of DVD drives
1707	* and as a consequence multiple attachments and different
1708	* storage controllers. */
1709	if (dvdMedium)
1710	dvdMedium->COMGETTER(Id)(uuid.asOutParam());
1711	else
1712	uuid = Guid().toString();
1713	CHECK_ERROR(sessionMachine, MountMedium(Bstr("IDE Controller"), 1, 0, uuid, FALSE /* aForce */));
1714	}
1715	else if (!strcmp(a->argv[1], "floppyattach"))
1716	{
1717	Bstr uuid;
1718	if (a->argc != 3)
1719	{
1720	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
1721	rc = E_FAIL;
1722	break;
1723	}
1724
1725	ComPtr<IMedium> floppyMedium;
1726
1727	/* unmount? */
1728	if (!strcmp(a->argv[2], "none"))
1729	{
1730	/* nothing to do, NULL object will cause unmount */
1731	}
1732	/* host drive? */
1733	else if (!strncmp(a->argv[2], "host:", 5))
1734	{
1735	ComPtr<IHost> host;
1736	CHECK_ERROR(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
1737	host->FindHostFloppyDrive(Bstr(a->argv[2] + 5), floppyMedium.asOutParam());
1738	if (!floppyMedium)
1739	{
1740	errorArgument("Invalid host floppy drive name \"%s\"",
1741	a->argv[2] + 5);
1742	rc = E_FAIL;
1743	break;
1744	}
1745	}
1746	else
1747	{
1748	/* first assume it's a UUID */
1749	uuid = a->argv[2];
1750	rc = a->virtualBox->GetFloppyImage(uuid, floppyMedium.asOutParam());
1751	if (FAILED(rc) \|\| !floppyMedium)
1752	{
1753	/* must be a filename, check if it's in the collection */
1754	rc = a->virtualBox->FindFloppyImage(Bstr(a->argv[2]), floppyMedium.asOutParam());
1755	/* not registered, do that on the fly */
1756	if (!floppyMedium)
1757	{
1758	Bstr emptyUUID;
1759	CHECK_ERROR(a->virtualBox, OpenFloppyImage(Bstr(a->argv[2]), emptyUUID, floppyMedium.asOutParam()));
1760	}
1761	}
1762	if (!floppyMedium)
1763	{
1764	rc = E_FAIL;
1765	break;
1766	}
1767	}
1768	floppyMedium->COMGETTER(Id)(uuid.asOutParam());
1769	CHECK_ERROR(sessionMachine, MountMedium(Bstr("Floppy Controller"), 0, 0, uuid, FALSE /* aForce */));
1770	}
1771	#endif /* obsolete dvdattach/floppyattach */
1772	else if (!strcmp(a->argv[1], "guestmemoryballoon"))
1773	{
1774	if (a->argc != 3)
1775	{
1776	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
1777	rc = E_FAIL;
1778	break;
1779	}
1780	uint32_t uVal;
1781	int vrc;
1782	vrc = RTStrToUInt32Ex(a->argv[2], NULL, 0, &uVal);
1783	if (vrc != VINF_SUCCESS)
1784	{
1785	errorArgument("Error parsing guest memory balloon size '%s'", a->argv[2]);
1786	rc = E_FAIL;
1787	break;
1788	}
1789	/* guest is running; update IGuest */
1790	ComPtr<IGuest> pGuest;
1791	rc = console->COMGETTER(Guest)(pGuest.asOutParam());
1792	if (SUCCEEDED(rc))
1793	{
1794	if (!pGuest)
1795	{
1796	RTMsgError("Guest not running");
1797	rc = E_FAIL;
1798	break;
1799	}
1800	CHECK_ERROR(pGuest, COMSETTER(MemoryBalloonSize)(uVal));
1801	}
1802	}
1803	else if (!strcmp(a->argv[1], "teleport"))
1804	{
1805	Bstr bstrHostname;
1806	uint32_t uMaxDowntime = 250 /ms/;
1807	uint32_t uPort = UINT32_MAX;
1808	uint32_t cMsTimeout = 0;
1809	Utf8Str strPassword;
1810	static const RTGETOPTDEF s_aTeleportOptions[] =
1811	{
1812	{ "--host", 'h', RTGETOPT_REQ_STRING }, /** @todo RTGETOPT_FLAG_MANDATORY */
1813	{ "--hostname", 'h', RTGETOPT_REQ_STRING }, /** @todo remove this */
1814	{ "--maxdowntime", 'd', RTGETOPT_REQ_UINT32 },
1815	{ "--port", 'P', RTGETOPT_REQ_UINT32 }, /** @todo RTGETOPT_FLAG_MANDATORY */
1816	{ "--passwordfile", 'p', RTGETOPT_REQ_STRING },
1817	{ "--password", 'W', RTGETOPT_REQ_STRING },
1818	{ "--timeout", 't', RTGETOPT_REQ_UINT32 },
1819	{ "--detailed-progress", 'D', RTGETOPT_REQ_NOTHING }
1820	};
1821	RTGETOPTSTATE GetOptState;
1822	RTGetOptInit(&GetOptState, a->argc, a->argv, s_aTeleportOptions, RT_ELEMENTS(s_aTeleportOptions), 2, RTGETOPTINIT_FLAGS_NO_STD_OPTS);
1823	int ch;
1824	RTGETOPTUNION Value;
1825	while ( SUCCEEDED(rc)
1826	&& (ch = RTGetOpt(&GetOptState, &Value)))
1827	{
1828	switch (ch)
1829	{
1830	case 'h': bstrHostname = Value.psz; break;
1831	case 'd': uMaxDowntime = Value.u32; break;
1832	case 'D': g_fDetailedProgress = true; break;
1833	case 'P': uPort = Value.u32; break;
1834	case 'p':
1835	{
1836	RTEXITCODE rcExit = readPasswordFile(Value.psz, &strPassword);
1837	if (rcExit != RTEXITCODE_SUCCESS)
1838	rc = E_FAIL;
1839	break;
1840	}
1841	case 'W': strPassword = Value.psz; break;
1842	case 't': cMsTimeout = Value.u32; break;
1843	default:
1844	errorGetOpt(USAGE_CONTROLVM, ch, &Value);
1845	rc = E_FAIL;
1846	break;
1847	}
1848	}
1849	if (FAILED(rc))
1850	break;
1851
1852	ComPtr<IProgress> progress;
1853	CHECK_ERROR_BREAK(console, Teleport(bstrHostname.raw(), uPort,
1854	Bstr(strPassword).raw(),
1855	uMaxDowntime,
1856	progress.asOutParam()));
1857
1858	if (cMsTimeout)
1859	{
1860	rc = progress->COMSETTER(Timeout)(cMsTimeout);
1861	if (FAILED(rc) && rc != VBOX_E_INVALID_OBJECT_STATE)
1862	CHECK_ERROR_BREAK(progress, COMSETTER(Timeout)(cMsTimeout)); /* lazyness */
1863	}
1864
1865	rc = showProgress(progress);
1866	CHECK_PROGRESS_ERROR(progress, ("Teleportation failed"));
1867	}
1868	else if (!strcmp(a->argv[1], "screenshotpng"))
1869	{
1870	if (a->argc <= 2 \|\| a->argc > 4)
1871	{
1872	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
1873	rc = E_FAIL;
1874	break;
1875	}
1876	int vrc;
1877	uint32_t iScreen = 0;
1878	if (a->argc == 4)
1879	{
1880	vrc = RTStrToUInt32Ex(a->argv[3], NULL, 0, &iScreen);
1881	if (vrc != VINF_SUCCESS)
1882	{
1883	errorArgument("Error parsing display number '%s'", a->argv[3]);
1884	rc = E_FAIL;
1885	break;
1886	}
1887	}
1888	ComPtr<IDisplay> pDisplay;
1889	CHECK_ERROR_BREAK(console, COMGETTER(Display)(pDisplay.asOutParam()));
1890	if (!pDisplay)
1891	{
1892	RTMsgError("Guest not running");
1893	rc = E_FAIL;
1894	break;
1895	}
1896	ULONG width, height, bpp;
1897	LONG xOrigin, yOrigin;
1898	GuestMonitorStatus_T monitorStatus;
1899	CHECK_ERROR_BREAK(pDisplay, GetScreenResolution(iScreen, &width, &height, &bpp, &xOrigin, &yOrigin, &monitorStatus));
1900	com::SafeArray<BYTE> saScreenshot;
1901	CHECK_ERROR_BREAK(pDisplay, TakeScreenShotToArray(iScreen, width, height, BitmapFormat_PNG, ComSafeArrayAsOutParam(saScreenshot)));
1902	RTFILE pngFile = NIL_RTFILE;
1903	vrc = RTFileOpen(&pngFile, a->argv[2], RTFILE_O_OPEN_CREATE \| RTFILE_O_WRITE \| RTFILE_O_TRUNCATE \| RTFILE_O_DENY_ALL);
1904	if (RT_FAILURE(vrc))
1905	{
1906	RTMsgError("Failed to create file '%s' (%Rrc)", a->argv[2], vrc);
1907	rc = E_FAIL;
1908	break;
1909	}
1910	vrc = RTFileWrite(pngFile, saScreenshot.raw(), saScreenshot.size(), NULL);
1911	if (RT_FAILURE(vrc))
1912	{
1913	RTMsgError("Failed to write screenshot to file '%s' (%Rrc)", a->argv[2], vrc);
1914	rc = E_FAIL;
1915	}
1916	RTFileClose(pngFile);
1917	}
1918	#ifdef VBOX_WITH_RECORDING
1919	else if ( !strcmp(a->argv[1], "recording")
1920	\|\| !strcmp(a->argv[1], "videocap") /* legacy command */)
1921	{
1922	if (a->argc < 3)
1923	{
1924	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
1925	rc = E_FAIL;
1926	break;
1927	}
1928
1929	ComPtr<IRecordingSettings> recordingSettings;
1930	CHECK_ERROR_BREAK(sessionMachine, COMGETTER(RecordingSettings)(recordingSettings.asOutParam()));
1931
1932	SafeIfaceArray <IRecordingScreenSettings> saRecordingScreenScreens;
1933	CHECK_ERROR_BREAK(recordingSettings, COMGETTER(Screens)(ComSafeArrayAsOutParam(saRecordingScreenScreens)));
1934
1935	ComPtr<IGraphicsAdapter> pGraphicsAdapter;
1936	CHECK_ERROR_BREAK(sessionMachine, COMGETTER(GraphicsAdapter)(pGraphicsAdapter.asOutParam()));
1937
1938	/* Note: For now all screens have the same configuration. */
1939
1940	/*
1941	* Note: Commands starting with "vcp" are the deprecated versions and are
1942	* kept to ensure backwards compatibility.
1943	*/
1944	if (!strcmp(a->argv[2], "on"))
1945	{
1946	CHECK_ERROR_RET(recordingSettings, COMSETTER(Enabled)(TRUE), RTEXITCODE_FAILURE);
1947	}
1948	else if (!strcmp(a->argv[2], "off"))
1949	{
1950	CHECK_ERROR_RET(recordingSettings, COMSETTER(Enabled)(FALSE), RTEXITCODE_FAILURE);
1951	}
1952	else if (!strcmp(a->argv[2], "screens"))
1953	{
1954	ULONG cMonitors = 64;
1955	CHECK_ERROR_BREAK(pGraphicsAdapter, COMGETTER(MonitorCount)(&cMonitors));
1956	com::SafeArray<BOOL> saScreens(cMonitors);
1957	if ( a->argc == 4
1958	&& !strcmp(a->argv[3], "all"))
1959	{
1960	/* enable all screens */
1961	for (unsigned i = 0; i < cMonitors; i++)
1962	saScreens[i] = true;
1963	}
1964	else if ( a->argc == 4
1965	&& !strcmp(a->argv[3], "none"))
1966	{
1967	/* disable all screens */
1968	for (unsigned i = 0; i < cMonitors; i++)
1969	saScreens[i] = false;
1970
1971	/** @todo r=andy What if this is specified? */
1972	}
1973	else
1974	{
1975	/* enable selected screens */
1976	for (unsigned i = 0; i < cMonitors; i++)
1977	saScreens[i] = false;
1978	for (int i = 3; SUCCEEDED(rc) && i < a->argc; i++)
1979	{
1980	uint32_t iScreen;
1981	int vrc = RTStrToUInt32Ex(a->argv[i], NULL, 0, &iScreen);
1982	if (vrc != VINF_SUCCESS)
1983	{
1984	errorArgument("Error parsing display number '%s'", a->argv[i]);
1985	rc = E_FAIL;
1986	break;
1987	}
1988	if (iScreen >= cMonitors)
1989	{
1990	errorArgument("Invalid screen ID specified '%u'", iScreen);
1991	rc = E_FAIL;
1992	break;
1993	}
1994	saScreens[iScreen] = true;
1995	}
1996	}
1997
1998	for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
1999	CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(Enabled)(saScreens[i]));
2000	}
2001	else if (!strcmp(a->argv[2], "filename"))
2002	{
2003	if (a->argc != 4)
2004	{
2005	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
2006	rc = E_FAIL;
2007	break;
2008	}
2009
2010	for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
2011	CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(Filename)(Bstr(a->argv[3]).raw()));
2012	}
2013	else if ( !strcmp(a->argv[2], "videores")
2014	\|\| !strcmp(a->argv[2], "videoresolution"))
2015	{
2016	if (a->argc != 5)
2017	{
2018	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
2019	rc = E_FAIL;
2020	break;
2021	}
2022
2023	uint32_t uWidth;
2024	int vrc = RTStrToUInt32Ex(a->argv[3], NULL, 0, &uWidth);
2025	if (RT_FAILURE(vrc))
2026	{
2027	errorArgument("Error parsing video width '%s'", a->argv[3]);
2028	rc = E_FAIL;
2029	break;
2030	}
2031
2032	uint32_t uHeight;
2033	vrc = RTStrToUInt32Ex(a->argv[4], NULL, 0, &uHeight);
2034	if (RT_FAILURE(vrc))
2035	{
2036	errorArgument("Error parsing video height '%s'", a->argv[4]);
2037	rc = E_FAIL;
2038	break;
2039	}
2040
2041	for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
2042	{
2043	CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(VideoWidth)(uWidth));
2044	CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(VideoHeight)(uHeight));
2045	}
2046	}
2047	else if (!strcmp(a->argv[2], "videorate"))
2048	{
2049	if (a->argc != 4)
2050	{
2051	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
2052	rc = E_FAIL;
2053	break;
2054	}
2055
2056	uint32_t uRate;
2057	int vrc = RTStrToUInt32Ex(a->argv[3], NULL, 0, &uRate);
2058	if (RT_FAILURE(vrc))
2059	{
2060	errorArgument("Error parsing video rate '%s'", a->argv[3]);
2061	rc = E_FAIL;
2062	break;
2063	}
2064
2065	for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
2066	CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(VideoRate)(uRate));
2067	}
2068	else if (!strcmp(a->argv[2], "videofps"))
2069	{
2070	if (a->argc != 4)
2071	{
2072	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
2073	rc = E_FAIL;
2074	break;
2075	}
2076
2077	uint32_t uFPS;
2078	int vrc = RTStrToUInt32Ex(a->argv[3], NULL, 0, &uFPS);
2079	if (RT_FAILURE(vrc))
2080	{
2081	errorArgument("Error parsing video FPS '%s'", a->argv[3]);
2082	rc = E_FAIL;
2083	break;
2084	}
2085
2086	for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
2087	CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(VideoFPS)(uFPS));
2088	}
2089	else if (!strcmp(a->argv[2], "maxtime"))
2090	{
2091	if (a->argc != 4)
2092	{
2093	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
2094	rc = E_FAIL;
2095	break;
2096	}
2097
2098	uint32_t uMaxTime;
2099	int vrc = RTStrToUInt32Ex(a->argv[3], NULL, 0, &uMaxTime);
2100	if (RT_FAILURE(vrc))
2101	{
2102	errorArgument("Error parsing maximum time '%s'", a->argv[3]);
2103	rc = E_FAIL;
2104	break;
2105	}
2106
2107	for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
2108	CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(MaxTime)(uMaxTime));
2109	}
2110	else if (!strcmp(a->argv[2], "maxfilesize"))
2111	{
2112	if (a->argc != 4)
2113	{
2114	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
2115	rc = E_FAIL;
2116	break;
2117	}
2118
2119	uint32_t uMaxFileSize;
2120	int vrc = RTStrToUInt32Ex(a->argv[3], NULL, 0, &uMaxFileSize);
2121	if (RT_FAILURE(vrc))
2122	{
2123	errorArgument("Error parsing maximum file size '%s'", a->argv[3]);
2124	rc = E_FAIL;
2125	break;
2126	}
2127
2128	for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
2129	CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(MaxFileSize)(uMaxFileSize));
2130	}
2131	else if (!strcmp(a->argv[2], "opts"))
2132	{
2133	if (a->argc != 4)
2134	{
2135	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
2136	rc = E_FAIL;
2137	break;
2138	}
2139
2140	for (size_t i = 0; i < saRecordingScreenScreens.size(); ++i)
2141	CHECK_ERROR_BREAK(saRecordingScreenScreens[i], COMSETTER(Options)(Bstr(a->argv[3]).raw()));
2142	}
2143	}
2144	#endif /* VBOX_WITH_RECORDING */
2145	else if (!strcmp(a->argv[1], "webcam"))
2146	{
2147	if (a->argc < 3)
2148	{
2149	errorArgument("Missing argument to '%s'", a->argv[1]);
2150	rc = E_FAIL;
2151	break;
2152	}
2153
2154	ComPtr<IEmulatedUSB> pEmulatedUSB;
2155	CHECK_ERROR_BREAK(console, COMGETTER(EmulatedUSB)(pEmulatedUSB.asOutParam()));
2156	if (!pEmulatedUSB)
2157	{
2158	RTMsgError("Guest not running");
2159	rc = E_FAIL;
2160	break;
2161	}
2162
2163	if (!strcmp(a->argv[2], "attach"))
2164	{
2165	Bstr path("");
2166	if (a->argc >= 4)
2167	path = a->argv[3];
2168	Bstr settings("");
2169	if (a->argc >= 5)
2170	settings = a->argv[4];
2171	CHECK_ERROR_BREAK(pEmulatedUSB, WebcamAttach(path.raw(), settings.raw()));
2172	}
2173	else if (!strcmp(a->argv[2], "detach"))
2174	{
2175	Bstr path("");
2176	if (a->argc >= 4)
2177	path = a->argv[3];
2178	CHECK_ERROR_BREAK(pEmulatedUSB, WebcamDetach(path.raw()));
2179	}
2180	else if (!strcmp(a->argv[2], "list"))
2181	{
2182	com::SafeArray <BSTR> webcams;
2183	CHECK_ERROR_BREAK(pEmulatedUSB, COMGETTER(Webcams)(ComSafeArrayAsOutParam(webcams)));
2184	for (size_t i = 0; i < webcams.size(); ++i)
2185	{
2186	RTPrintf("%ls\n", webcams[i][0]? webcams[i]: Bstr("default").raw());
2187	}
2188	}
2189	else
2190	{
2191	errorArgument("Invalid argument to '%s'", a->argv[1]);
2192	rc = E_FAIL;
2193	break;
2194	}
2195	}
2196	else if (!strcmp(a->argv[1], "addencpassword"))
2197	{
2198	if ( a->argc != 4
2199	&& a->argc != 6)
2200	{
2201	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
2202	break;
2203	}
2204
2205	BOOL fRemoveOnSuspend = FALSE;
2206	if (a->argc == 6)
2207	{
2208	if ( strcmp(a->argv[4], "--removeonsuspend")
2209	\|\| ( strcmp(a->argv[5], "yes")
2210	&& strcmp(a->argv[5], "no")))
2211	{
2212	errorSyntax(USAGE_CONTROLVM, "Invalid parameters");
2213	break;
2214	}
2215	if (!strcmp(a->argv[5], "yes"))
2216	fRemoveOnSuspend = TRUE;
2217	}
2218
2219	Bstr bstrPwId(a->argv[2]);
2220	Utf8Str strPassword;
2221
2222	if (!RTStrCmp(a->argv[3], "-"))
2223	{
2224	/* Get password from console. */
2225	RTEXITCODE rcExit = readPasswordFromConsole(&strPassword, "Enter password:");
2226	if (rcExit == RTEXITCODE_FAILURE)
2227	break;
2228	}
2229	else
2230	{
2231	RTEXITCODE rcExit = readPasswordFile(a->argv[3], &strPassword);
2232	if (rcExit == RTEXITCODE_FAILURE)
2233	{
2234	RTMsgError("Failed to read new password from file");
2235	break;
2236	}
2237	}
2238
2239	CHECK_ERROR_BREAK(console, AddDiskEncryptionPassword(bstrPwId.raw(), Bstr(strPassword).raw(), fRemoveOnSuspend));
2240	}
2241	else if (!strcmp(a->argv[1], "removeencpassword"))
2242	{
2243	if (a->argc != 3)
2244	{
2245	errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
2246	break;
2247	}
2248	Bstr bstrPwId(a->argv[2]);
2249	CHECK_ERROR_BREAK(console, RemoveDiskEncryptionPassword(bstrPwId.raw()));
2250	}
2251	else if (!strcmp(a->argv[1], "removeallencpasswords"))
2252	{
2253	CHECK_ERROR_BREAK(console, ClearAllDiskEncryptionPasswords());
2254	}
2255	else if (!strncmp(a->argv[1], "changeuartmode", 14))
2256	{
2257	unsigned n = parseNum(&a->argv[1][14], 4, "UART");
2258	if (!n)
2259	{
2260	rc = E_FAIL;
2261	break;
2262	}
2263	if (a->argc < 3)
2264	{
2265	errorArgument("Missing argument to '%s'", a->argv[1]);
2266	rc = E_FAIL;
2267	break;
2268	}
2269
2270	ComPtr<ISerialPort> uart;
2271
2272	CHECK_ERROR_BREAK(sessionMachine, GetSerialPort(n - 1, uart.asOutParam()));
2273	ASSERT(uart);
2274
2275	if (!RTStrICmp(a->argv[2], "disconnected"))
2276	{
2277	if (a->argc != 3)
2278	{
2279	errorArgument("Incorrect arguments to '%s'", a->argv[1]);
2280	rc = E_FAIL;
2281	break;
2282	}
2283	CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_Disconnected));
2284	}
2285	else if ( !RTStrICmp(a->argv[2], "server")
2286	\|\| !RTStrICmp(a->argv[2], "client")
2287	\|\| !RTStrICmp(a->argv[2], "tcpserver")
2288	\|\| !RTStrICmp(a->argv[2], "tcpclient")
2289	\|\| !RTStrICmp(a->argv[2], "file"))
2290	{
2291	const char *pszMode = a->argv[2];
2292	if (a->argc != 4)
2293	{
2294	errorArgument("Incorrect arguments to '%s'", a->argv[1]);
2295	rc = E_FAIL;
2296	break;
2297	}
2298
2299	CHECK_ERROR(uart, COMSETTER(Path)(Bstr(a->argv[3]).raw()));
2300
2301	/*
2302	* Change to disconnected first to get changes in just a parameter causing
2303	* the correct changes later on.
2304	*/
2305	CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_Disconnected));
2306	if (!RTStrICmp(pszMode, "server"))
2307	{
2308	CHECK_ERROR(uart, COMSETTER(Server)(TRUE));
2309	CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_HostPipe));
2310	}
2311	else if (!RTStrICmp(pszMode, "client"))
2312	{
2313	CHECK_ERROR(uart, COMSETTER(Server)(FALSE));
2314	CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_HostPipe));
2315	}
2316	else if (!RTStrICmp(pszMode, "tcpserver"))
2317	{
2318	CHECK_ERROR(uart, COMSETTER(Server)(TRUE));
2319	CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_TCP));
2320	}
2321	else if (!RTStrICmp(pszMode, "tcpclient"))
2322	{
2323	CHECK_ERROR(uart, COMSETTER(Server)(FALSE));
2324	CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_TCP));
2325	}
2326	else if (!RTStrICmp(pszMode, "file"))
2327	{
2328	CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_RawFile));
2329	}
2330	}
2331	else
2332	{
2333	if (a->argc != 3)
2334	{
2335	errorArgument("Incorrect arguments to '%s'", a->argv[1]);
2336	rc = E_FAIL;
2337	break;
2338	}
2339	CHECK_ERROR(uart, COMSETTER(Path)(Bstr(a->argv[2]).raw()));
2340	CHECK_ERROR(uart, COMSETTER(HostMode)(PortMode_HostDevice));
2341	}
2342	}
2343	else if (!strncmp(a->argv[1], "vm-process-priority", 14))
2344	{
2345	if (a->argc != 3)
2346	{
2347	errorArgument("Incorrect arguments to '%s'", a->argv[1]);
2348	rc = E_FAIL;
2349	break;
2350	}
2351	VMProcPriority_T enmPriority = nameToVMProcPriority(a->argv[2]);
2352	if (enmPriority == VMProcPriority_Invalid)
2353	{
2354	errorArgument("Invalid vm-process-priority '%s'", a->argv[2]);
2355	rc = E_FAIL;
2356	}
2357	else
2358	{
2359	CHECK_ERROR(sessionMachine, COMSETTER(VMProcessPriority)(enmPriority));
2360	}
2361	break;
2362	}
2363	else
2364	{
2365	errorSyntax(USAGE_CONTROLVM, "Invalid parameter '%s'", a->argv[1]);
2366	rc = E_FAIL;
2367	}
2368	} while (0);
2369
2370	/* The client has to trigger saving the state explicitely. */
2371	if (fNeedsSaving)
2372	CHECK_ERROR(sessionMachine, SaveSettings());
2373
2374	a->session->UnlockMachine();
2375
2376	return SUCCEEDED(rc) ? RTEXITCODE_SUCCESS : RTEXITCODE_FAILURE;
2377	}

Note: See TracBrowser for help on using the repository browser.

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

Download in other formats: