VBoxManageControlVM.cpp revision 8b7ee9f7ebabcdbf40fececa0d6321d97d5143d8
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync * VBoxManage - Implementation of the controlvm command.
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync * Copyright (C) 2006-2011 Oracle Corporation
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * available from http://www.virtualbox.org. This file is free software;
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * you can redistribute it and/or modify it under the terms of the GNU
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * General Public License (GPL) as published by the Free Software
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync/*******************************************************************************
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync* Header Files *
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync*******************************************************************************/
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * Parses a number.
ad27e1d5e48ca41245120c331cc88b50464813cevboxsync * @returns Valid number on success.
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * @returns 0 if invalid number. All necessary bitching has been done.
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * @param psz Pointer to the nic number.
4328e87247f4a96449677e199c7e99ef516fc1cevboxsyncstatic unsigned parseNum(const char *psz, unsigned cMaxNum, const char *name)
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync return (unsigned)u32;
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid %s number '%s'", name, psz);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsyncunsigned int getMaxNics(IVirtualBox* vbox, IMachine* mach)
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(vbox, COMGETTER(SystemProperties)(info.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(mach, COMGETTER(ChipsetType)(&aChipset));
508452243fd3328f7b9e0405d39fb9dc004e31b8vboxsync CHECK_ERROR_BREAK(info, GetMaxNetworkAdapters(aChipset, &NetworkAdapterCount));
508452243fd3328f7b9e0405d39fb9dc004e31b8vboxsync return (unsigned int)NetworkAdapterCount;
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync } while (0);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync using namespace com;
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync return errorSyntax(USAGE_CONTROLVM, "Not enough parameters");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* try to find the given machine */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(a->virtualBox, FindMachine(Bstr(a->argv[0]).raw(),
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* open a session for the VM */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(machine, LockMachine(a->session, LockType_Shared), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* get the associated console */
6e12ccc60ac657fb87e27b7a2b26e0a63bebe024vboxsync CHECK_ERROR_BREAK(a->session, COMGETTER(Console)(console.asOutParam()));
6e12ccc60ac657fb87e27b7a2b26e0a63bebe024vboxsync /* ... and session machine */
6e12ccc60ac657fb87e27b7a2b26e0a63bebe024vboxsync CHECK_ERROR_BREAK(a->session, COMGETTER(Machine)(sessionMachine.asOutParam()));
6e12ccc60ac657fb87e27b7a2b26e0a63bebe024vboxsync /* which command? */
6e12ccc60ac657fb87e27b7a2b26e0a63bebe024vboxsync errorArgument("Missing argument to '%s'. Expected CPU number.", a->argv[1]);
657b2c9f6d33f08001e5fa6f6e0572dcf0391013vboxsync CHECK_ERROR_BREAK(sessionMachine, HotUnplugCPU(n));
657b2c9f6d33f08001e5fa6f6e0572dcf0391013vboxsync errorArgument("Missing argument to '%s'. Expected CPU number.", a->argv[1]);
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync errorArgument("Missing argument to '%s'. Expected execution cap number.", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync unsigned n = parseNum(a->argv[2], 100, "ExecutionCap");
ae017640afff8b6cc50453182a4edf2eb0903a12vboxsync CHECK_ERROR_BREAK(sessionMachine, COMSETTER(CPUExecutionCap)(n));
b986941f0aa5155c7fd37da0aa5876675a7680e4vboxsync CHECK_ERROR_BREAK(console, PowerDown(progress.asOutParam()));
b986941f0aa5155c7fd37da0aa5876675a7680e4vboxsync CHECK_PROGRESS_ERROR(progress, ("Failed to power off machine"));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* first pause so we don't trigger a live save which needs more time/resources */
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync /* check if we are already paused */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(console, COMGETTER(State)(&machineState));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* the error code was lost by the previous instruction */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync machineState, machineStateToName(machineState, false));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(console, SaveState(progress.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_PROGRESS_ERROR(progress, ("Failed to save machine state"));
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync else if (!strcmp(a->argv[1], "keyboardputscancode"))
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(console, COMGETTER(Keyboard)(keyboard.asOutParam()));
42aef05f4b27fb393967e581be04be455064c80avboxsync errorArgument("Missing argument to '%s'. Expected IBM PC AT set 2 keyboard scancode(s) as hex byte(s).", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Process the command line. */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync int irc = RTStrToUInt8Ex(a->argv[i], NULL, 16, &u8Scancode);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync RTMsgError("Converting '%s' returned %Rrc!", a->argv[i], rc);
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync RTMsgError("Error: '%s' is not a hex byte!", a->argv[i]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Send scancodes to the VM. */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(keyboard, PutScancodes(ComSafeArrayAsInParam(saScancodes),
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync RTMsgError("Only %d scancodes were stored", codesStored);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Get the number of network adapters */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync unsigned n = parseNum(&a->argv[1][12], NetworkAdapterCount, "NIC");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* get the corresponding network adapter */
e48239695d41f806ff02d8a60b97dc20d4822d7avboxsync CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(adapter, COMSETTER(CableConnected)(TRUE));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(adapter, COMSETTER(CableConnected)(FALSE));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid link state '%s'", Utf8Str(a->argv[2]).c_str());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* here the order in which strncmp is called is important
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * cause nictracefile can be very well compared with
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * nictrace and nic and thus everything will always fail
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * if the order is changed
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Get the number of network adapters */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync unsigned n = parseNum(&a->argv[1][12], NetworkAdapterCount, "NIC");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* get the corresponding network adapter */
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(TraceFile)(Bstr(a->argv[2]).raw()), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid filename or filename not specified for NIC %lu", n);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync RTMsgError("The NIC %d is currently disabled and thus its tracefile can't be changed", n);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Get the number of network adapters */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync unsigned n = parseNum(&a->argv[1][8], NetworkAdapterCount, "NIC");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* get the corresponding network adapter */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(TraceEnabled)(TRUE), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(TraceEnabled)(FALSE), 1);
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync errorArgument("Invalid nictrace%lu argument '%s'", n, Utf8Str(a->argv[2]).c_str());
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync RTMsgError("The NIC %d is currently disabled and thus its trace flag can't be changed", n);
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync /* Get the number of network adapters */
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync ULONG NetworkAdapterCount = getMaxNics(a->virtualBox, sessionMachine);
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync unsigned n = parseNum(&a->argv[1][5], NetworkAdapterCount, "NIC");
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync /* get the corresponding network adapter */
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync CHECK_ERROR(adapter, COMGETTER(NatDriver)(engine.asOutParam()));
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync CHECK_ERROR(engine, RemoveRedirect(Bstr(a->argv[3]).raw()));
8ccde4f32d77b1ad3f02111f28a48ee85abf6779vboxsync if (*ch == 0) \
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync "Missing or invalid argument to '%s'", \
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync "Wrong rule proto '%s' specified -- only 'udp' and 'tcp' are allowed.",
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync CHECK_ERROR(engine, AddRedirect(Bstr(strName).raw(), proto, Bstr(strHostIp).raw(),
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync RTStrToUInt16(strHostPort), Bstr(strGuestIp).raw(), RTStrToUInt16(strGuestPort)));
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync /* commit changes */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Get the number of network adapters */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync ULONG NetworkAdapterCount = getMaxNics(a->virtualBox,sessionMachine) ;
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync unsigned n = parseNum(&a->argv[1][11], NetworkAdapterCount, "NIC");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* get the corresponding network adapter */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Parse 'name=value' */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(adapter, SetProperty(bstrName.raw(), bstrValue.raw()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid nicproperty%d argument '%s'", n, a->argv[2]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync RTStrmPrintf(g_pStdErr, "Error: Failed to allocate memory for nicproperty%d '%s'\n", n, a->argv[2]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync RTMsgError("The NIC %d is currently disabled and thus its properties can't be changed", n);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Get the number of network adapters */
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync ULONG NetworkAdapterCount = getMaxNics(a->virtualBox,sessionMachine) ;
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync unsigned n = parseNum(&a->argv[1][3], NetworkAdapterCount, "NIC");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* get the corresponding network adapter */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Null), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_RET(adapter, COMSETTER(NATNetwork)(Bstr(a->argv[3]).raw()), 1);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_NAT), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync || !strcmp(a->argv[2], "hostif")) /* backward compatibility */
3933885bc0c2c93436d858a14564c6179ec72872vboxsync errorArgument("Missing argument to '%s'", a->argv[2]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(BridgedInterface)(Bstr(a->argv[3]).raw()), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Bridged), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[2]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(InternalNetwork)(Bstr(a->argv[3]).raw()), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Internal), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[2]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(HostOnlyInterface)(Bstr(a->argv[3]).raw()), 1);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_HostOnly), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[2]);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_RET(adapter, COMSETTER(GenericDriver)(Bstr(a->argv[3]).raw()), 1);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Generic), 1);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync /** @todo obsolete, remove eventually */
3933885bc0c2c93436d858a14564c6179ec72872vboxsync errorArgument("Missing argument to '%s'", a->argv[2]);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Generic), 1);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_RET(adapter, SetProperty(Bstr("name").raw(), Bstr(a->argv[3]).raw()), 1);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync errorArgument("Invalid type '%s' specfied for NIC %lu", Utf8Str(a->argv[2]).c_str(), n);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync RTMsgError("The NIC %d is currently disabled and thus its attachment type can't be changed", n);
70ca8d009d026a301bf7fa08cd18c6494c45fdeevboxsync RTStrmPrintf(g_pStdErr, "Warning: 'vrdp' is deprecated. Use 'vrde'.\n");
3933885bc0c2c93436d858a14564c6179ec72872vboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
70ca8d009d026a301bf7fa08cd18c6494c45fdeevboxsync CHECK_ERROR_BREAK(vrdeServer, COMSETTER(Enabled)(TRUE));
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_BREAK(vrdeServer, COMSETTER(Enabled)(FALSE));
3933885bc0c2c93436d858a14564c6179ec72872vboxsync errorArgument("Invalid remote desktop server state '%s'", Utf8Str(a->argv[2]).c_str());
3933885bc0c2c93436d858a14564c6179ec72872vboxsync RTStrmPrintf(g_pStdErr, "Warning: 'vrdpport' is deprecated. Use 'vrdeport'.\n");
70ca8d009d026a301bf7fa08cd18c6494c45fdeevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(vrdeServer, SetVRDEProperty(Bstr("TCP/Ports").raw(), ports.raw()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync else if ( !strcmp(a->argv[1], "vrdevideochannelquality")
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync if (!strcmp(a->argv[1], "vrdpvideochannelquality"))
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync RTStrmPrintf(g_pStdErr, "Warning: 'vrdpvideochannelquality' is deprecated. Use 'vrdevideochannelquality'.\n");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(vrdeServer, SetVRDEProperty(Bstr("VideoChannel/Quality").raw(), value.raw()));
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Parse 'name=value' */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(vrdeServer, SetVRDEProperty(bstrName.raw(), bstrValue.raw()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid vrdeproperty argument '%s'", a->argv[2]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync RTStrmPrintf(g_pStdErr, "Error: Failed to allocate memory for VRDE property '%s'\n", a->argv[2]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorSyntax(USAGE_CONTROLVM, "Not enough parameters");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync // assume address
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(host, COMGETTER(USBDevices)(ComSafeArrayAsOutParam(coll)));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(host, FindUSBDeviceByAddress(Bstr(a->argv[2]).raw(),
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(dev, COMGETTER(Id)(usbId.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(console, COMGETTER(USBDevices)(ComSafeArrayAsOutParam(coll)));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(console, FindUSBDeviceByAddress(Bstr(a->argv[2]).raw(),
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(dev, COMGETTER(Id)(usbId.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(console, AttachUSBDevice(usbId.raw()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(console, DetachUSBDevice(usbId.raw(),
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(console, COMGETTER(Display)(display.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(display, SetVideoModeHint(xres, yres, bpp, displayIdx));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid parameter '%s'", a->argv[5]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(console, COMGETTER(Guest)(guest.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(guest, SetCredentials(Bstr(a->argv[2]).raw(),
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync#if 0 /* TODO: review & remove */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* unmount? */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* nothing to do, NULL object will cause unmount */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* host drive? */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync rc = host->FindHostDVDDrive(Bstr(a->argv[2] + 5), dvdMedium.asOutParam());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid host DVD drive name \"%s\"",
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* first assume it's a UUID */
c9e3f6ad81ea9a279ffb537720699e552882c40avboxsync rc = a->virtualBox->GetDVDImage(uuid, dvdMedium.asOutParam());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* must be a filename, check if it's in the collection */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync rc = a->virtualBox->FindDVDImage(Bstr(a->argv[2]), dvdMedium.asOutParam());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* not registered, do that on the fly */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(a->virtualBox, OpenDVDImage(Bstr(a->argv[2]), emptyUUID, dvdMedium.asOutParam()));
629169500a4e1696f37dd3118a791d68278f71davboxsync /** @todo generalize this, allow arbitrary number of DVD drives
629169500a4e1696f37dd3118a791d68278f71davboxsync * and as a consequence multiple attachments and different
629169500a4e1696f37dd3118a791d68278f71davboxsync * storage controllers. */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(machine, MountMedium(Bstr("IDE Controller"), 1, 0, uuid, FALSE /* aForce */));
4c13f0d619c9707412b40eae8e3beafae5cf1858vboxsync errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* unmount? */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* nothing to do, NULL object will cause unmount */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* host drive? */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(a->virtualBox, COMGETTER(Host)(host.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync host->FindHostFloppyDrive(Bstr(a->argv[2] + 5), floppyMedium.asOutParam());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid host floppy drive name \"%s\"",
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* first assume it's a UUID */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync rc = a->virtualBox->GetFloppyImage(uuid, floppyMedium.asOutParam());
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync /* must be a filename, check if it's in the collection */
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync rc = a->virtualBox->FindFloppyImage(Bstr(a->argv[2]), floppyMedium.asOutParam());
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync /* not registered, do that on the fly */
b2c92fb03e119c7de54f86a32fae9c1d59bc479evboxsync CHECK_ERROR(a->virtualBox, OpenFloppyImage(Bstr(a->argv[2]), emptyUUID, floppyMedium.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(machine, MountMedium(Bstr("Floppy Controller"), 0, 0, uuid, FALSE /* aForce */));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync#endif /* obsolete dvdattach/floppyattach */
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync else if (!strcmp(a->argv[1], "guestmemoryballoon"))
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Error parsing guest memory balloon size '%s'", a->argv[2]);
RTGetOptInit(&GetOptState, a->argc, a->argv, s_aTeleportOptions, RT_ELEMENTS(s_aTeleportOptions), 2, RTGETOPTINIT_FLAGS_NO_STD_OPTS);
int ch;
switch (ch)
if (cMsTimeout)
int vrc;