VBoxManageControlVM.cpp revision d01bb88591e2ae070aa233b99c81e58598d557e1
1ce069685b24d243eb0464f46d4c56b250c64445vboxsync * VBoxManage - Implementation of the controlvm command.
069b9101fbd3b049610c5511b1cc9534d01ea472vboxsync * Copyright (C) 2006-2014 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.
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * @returns Valid number on success.
ad27e1d5e48ca41245120c331cc88b50464813cevboxsync * @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);
376b92d26cc4fad78e813cf33afcc0784adc9b19vboxsyncunsigned int getMaxNics(IVirtualBox* vbox, IMachine* mach)
89aedeb1d8af54aba6ae46dbbd256281315c1be6vboxsync CHECK_ERROR_BREAK(vbox, COMGETTER(SystemProperties)(info.asOutParam()));
89aedeb1d8af54aba6ae46dbbd256281315c1be6vboxsync CHECK_ERROR_BREAK(mach, COMGETTER(ChipsetType)(&aChipset));
89aedeb1d8af54aba6ae46dbbd256281315c1be6vboxsync CHECK_ERROR_BREAK(info, GetMaxNetworkAdapters(aChipset, &NetworkAdapterCount));
376b92d26cc4fad78e813cf33afcc0784adc9b19vboxsync return (unsigned int)NetworkAdapterCount;
89aedeb1d8af54aba6ae46dbbd256281315c1be6vboxsync } while (0);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync using namespace com;
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync return errorSyntax(USAGE_CONTROLVM, "Not enough parameters");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* try to find the given machine */
508452243fd3328f7b9e0405d39fb9dc004e31b8vboxsync CHECK_ERROR(a->virtualBox, FindMachine(Bstr(a->argv[0]).raw(),
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* open a session for the VM */
f409459bdd4c15cdb8d7fb6c6d54338cce9ac814vboxsync CHECK_ERROR_RET(machine, LockMachine(a->session, LockType_Shared), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* get the associated console */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(a->session, COMGETTER(Console)(console.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* ... and session machine */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(a->session, COMGETTER(Machine)(sessionMachine.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* which command? */
6e12ccc60ac657fb87e27b7a2b26e0a63bebe024vboxsync errorArgument("Missing argument to '%s'. Expected CPU number.", a->argv[1]);
6e12ccc60ac657fb87e27b7a2b26e0a63bebe024vboxsync CHECK_ERROR_BREAK(sessionMachine, HotUnplugCPU(n));
6e12ccc60ac657fb87e27b7a2b26e0a63bebe024vboxsync errorArgument("Missing argument to '%s'. Expected CPU number.", a->argv[1]);
657b2c9f6d33f08001e5fa6f6e0572dcf0391013vboxsync errorArgument("Missing argument to '%s'. Expected execution cap number.", a->argv[1]);
657b2c9f6d33f08001e5fa6f6e0572dcf0391013vboxsync unsigned n = parseNum(a->argv[2], 100, "ExecutionCap");
9cb702c3a5fd2287c57c7c1e98a61ba9e357b4devboxsync CHECK_ERROR_BREAK(sessionMachine, COMSETTER(CPUExecutionCap)(n));
6fe1329154975472e055284198df7fa8e64dee3avboxsync errorArgument("Missing argument to '%s'. Expected clipboard mode.", a->argv[1]);
6fe1329154975472e055284198df7fa8e64dee3avboxsync errorArgument("Invalid '%s' argument '%s'.", a->argv[1], a->argv[2]);
6fe1329154975472e055284198df7fa8e64dee3avboxsync CHECK_ERROR_BREAK(sessionMachine, COMSETTER(ClipboardMode)(mode));
2a171646d32f8a15e9820d6fb3bf3f9b9990ca3fvboxsync errorArgument("Missing argument to '%s'. Expected drag'n'drop mode.", a->argv[1]);
2a171646d32f8a15e9820d6fb3bf3f9b9990ca3fvboxsync errorArgument("Invalid '%s' argument '%s'.", a->argv[1], a->argv[2]);
069b9101fbd3b049610c5511b1cc9534d01ea472vboxsync CHECK_ERROR_BREAK(sessionMachine, COMSETTER(DnDMode)(mode));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(console, PowerDown(progress.asOutParam()));
ae16af2d7d3c99d359094a7f19f5937efc2e66bdvboxsync CHECK_PROGRESS_ERROR(progress, ("Failed to power off machine"));
ae017640afff8b6cc50453182a4edf2eb0903a12vboxsync /* first pause so we don't trigger a live save which needs more time/resources */
cdf129515a2b03bc9d122091ce7656d6e6934cc7vboxsync bool fPaused = false;
cdf129515a2b03bc9d122091ce7656d6e6934cc7vboxsync bool fError = true;
7e837ad8d6aeb3f86520ea7adb61e4eb15f2087evboxsync /* check if we are already paused */
7e837ad8d6aeb3f86520ea7adb61e4eb15f2087evboxsync CHECK_ERROR_BREAK(console, COMGETTER(State)(&machineState));
8b7ee9f7ebabcdbf40fececa0d6321d97d5143d8vboxsync /* the error code was lost by the previous instruction */
31a693ce9a8a9ebbecdcea9f24ce7f912aef4cd1vboxsync machineState, machineStateToName(machineState, false));
b986941f0aa5155c7fd37da0aa5876675a7680e4vboxsync CHECK_ERROR(console, SaveState(progress.asOutParam()));
ae16af2d7d3c99d359094a7f19f5937efc2e66bdvboxsync CHECK_PROGRESS_ERROR(progress, ("Failed to save machine state"));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync else if (!strcmp(a->argv[1], "keyboardputscancode"))
29d55b79593710186ceda5a557fdab1727972175vboxsync CHECK_ERROR_BREAK(console, COMGETTER(Keyboard)(pKeyboard.asOutParam()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync 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. */
42aef05f4b27fb393967e581be04be455064c80avboxsync int irc = RTStrToUInt8Ex(a->argv[i], NULL, 16, &u8Scancode);
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync RTMsgError("Converting '%s' returned %Rrc!", a->argv[i], rc);
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync RTMsgError("Error: '%s' is not a hex byte!", a->argv[i]);
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync /* Send scancodes to the VM. */
29d55b79593710186ceda5a557fdab1727972175vboxsync CHECK_ERROR_BREAK(pKeyboard, PutScancodes(ComSafeArrayAsInParam(saScancodes),
3a8aa22ef125135ef67bfc396771bcee15ef02dfvboxsync RTMsgError("Only %d scancodes were stored", codesStored);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Get the number of network adapters */
89aedeb1d8af54aba6ae46dbbd256281315c1be6vboxsync 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 */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync 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));
e48239695d41f806ff02d8a60b97dc20d4822d7avboxsync 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 */
89aedeb1d8af54aba6ae46dbbd256281315c1be6vboxsync 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 */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync CHECK_ERROR_RET(adapter, COMSETTER(TraceFile)(Bstr(a->argv[2]).raw()), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid filename or filename not specified for NIC %lu", n);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync RTMsgError("The NIC %d is currently disabled and thus its tracefile can't be changed", n);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Get the number of network adapters */
89aedeb1d8af54aba6ae46dbbd256281315c1be6vboxsync 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);
e48239695d41f806ff02d8a60b97dc20d4822d7avboxsync errorArgument("Invalid nictrace%lu argument '%s'", n, Utf8Str(a->argv[2]).c_str());
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync RTMsgError("The NIC %d is currently disabled and thus its trace flag can't be changed", n);
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync /* Get the number of network adapters */
89aedeb1d8af54aba6ae46dbbd256281315c1be6vboxsync 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()));
1cd59fdf671ca60c64d77e3f7046aaecf7003824vboxsync CHECK_ERROR(adapter, COMGETTER(NATEngine)(engine.asOutParam()));
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync CHECK_ERROR(engine, RemoveRedirect(Bstr(a->argv[3]).raw()));
b4bcdbd7ac35c938e6f71a6403fe9f3ebf106a07vboxsync if (*ch == 0) \
8ccde4f32d77b1ad3f02111f28a48ee85abf6779vboxsync "Missing or invalid argument to '%s'", \
8ccde4f32d77b1ad3f02111f28a48ee85abf6779vboxsync "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 */
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync /* Get the number of network adapters */
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync ULONG NetworkAdapterCount = getMaxNics(a->virtualBox,sessionMachine) ;
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync unsigned n = parseNum(&a->argv[1][11], NetworkAdapterCount, "NIC");
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync /* get the corresponding network adapter */
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync /* Parse 'name=value' */
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR(adapter, SetProperty(bstrName.raw(), bstrValue.raw()));
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync errorArgument("Invalid nicproperty%d argument '%s'", n, a->argv[2]);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync RTStrmPrintf(g_pStdErr, "Error: Failed to allocate memory for nicproperty%d '%s'\n", n, a->argv[2]);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync RTMsgError("The NIC %d is currently disabled and thus its properties can't be changed", n);
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync /* Get the number of network adapters */
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync ULONG NetworkAdapterCount = getMaxNics(a->virtualBox,sessionMachine) ;
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync unsigned n = parseNum(&a->argv[1][10], NetworkAdapterCount, "NIC");
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync /* get the corresponding network adapter */
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync CHECK_ERROR_BREAK(sessionMachine, GetNetworkAdapter(n - 1, adapter.asOutParam()));
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync NetworkAdapterPromiscModePolicy_T enmPromiscModePolicy;
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync enmPromiscModePolicy = NetworkAdapterPromiscModePolicy_Deny;
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync enmPromiscModePolicy = NetworkAdapterPromiscModePolicy_AllowNetwork;
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync enmPromiscModePolicy = NetworkAdapterPromiscModePolicy_AllowAll;
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync errorArgument("Unknown promiscuous mode policy '%s'", a->argv[2]);
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync CHECK_ERROR(adapter, COMSETTER(PromiscModePolicy)(enmPromiscModePolicy));
a38afdea3cc827dc5964b4ba39a5cae6dbae23bdvboxsync RTMsgError("The NIC %d is currently disabled and thus its promiscuous mode can't be changed", n);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* Get the number of network adapters */
89aedeb1d8af54aba6ae46dbbd256281315c1be6vboxsync 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()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Null), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync CHECK_ERROR_RET(adapter, COMSETTER(NATNetwork)(Bstr(a->argv[3]).raw()), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_NAT), 1);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync || !strcmp(a->argv[2], "hostif")) /* backward compatibility */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[2]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(BridgedInterface)(Bstr(a->argv[3]).raw()), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync 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);
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync CHECK_ERROR_RET(adapter, COMSETTER(InternalNetwork)(Bstr(a->argv[3]).raw()), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync 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);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(HostOnlyInterface)(Bstr(a->argv[3]).raw()), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_HostOnly), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync errorArgument("Missing argument to '%s'", a->argv[2]);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(GenericDriver)(Bstr(a->argv[3]).raw()), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Generic), 1);
4b9a9888c020ed3508c8ac3a5b47842d6aa3f8d2vboxsync errorArgument("Missing argument to '%s'", a->argv[2]);
4b9a9888c020ed3508c8ac3a5b47842d6aa3f8d2vboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
4b9a9888c020ed3508c8ac3a5b47842d6aa3f8d2vboxsync CHECK_ERROR_RET(adapter, COMSETTER(NATNetwork)(Bstr(a->argv[3]).raw()), 1);
4b9a9888c020ed3508c8ac3a5b47842d6aa3f8d2vboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_NATNetwork), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync /** @todo obsolete, remove eventually */
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync errorArgument("Missing argument to '%s'", a->argv[2]);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(Enabled)(TRUE), 1);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync CHECK_ERROR_RET(adapter, COMSETTER(AttachmentType)(NetworkAttachmentType_Generic), 1);
56349fc0a23f96f82208016f8f59f8377bb284b1vboxsync CHECK_ERROR_RET(adapter, SetProperty(Bstr("name").raw(), Bstr(a->argv[3]).raw()), 1);
e48239695d41f806ff02d8a60b97dc20d4822d7avboxsync errorArgument("Invalid type '%s' specfied for NIC %lu", Utf8Str(a->argv[2]).c_str(), n);
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync RTMsgError("The NIC %d is currently disabled and thus its attachment type can't be changed", n);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync RTStrmPrintf(g_pStdErr, "Warning: 'vrdp' is deprecated. Use 'vrde'.\n");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
3933885bc0c2c93436d858a14564c6179ec72872vboxsync 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());
36a04912b64bea8318327fe0723535f1b3f041b0vboxsync RTStrmPrintf(g_pStdErr, "Warning: 'vrdpport' is deprecated. Use 'vrdeport'.\n");
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR_BREAK(vrdeServer, SetVRDEProperty(Bstr("TCP/Ports").raw(), ports.raw()));
3933885bc0c2c93436d858a14564c6179ec72872vboxsync else if ( !strcmp(a->argv[1], "vrdevideochannelquality")
3933885bc0c2c93436d858a14564c6179ec72872vboxsync if (!strcmp(a->argv[1], "vrdpvideochannelquality"))
3933885bc0c2c93436d858a14564c6179ec72872vboxsync RTStrmPrintf(g_pStdErr, "Warning: 'vrdpvideochannelquality' is deprecated. Use 'vrdevideochannelquality'.\n");
3933885bc0c2c93436d858a14564c6179ec72872vboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
060f7ec6ae5c99df18341ef2e1f3e91f4b0c89f1vboxsync CHECK_ERROR(vrdeServer, SetVRDEProperty(Bstr("VideoChannel/Quality").raw(), value.raw()));
70ca8d009d026a301bf7fa08cd18c6494c45fdeevboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync sessionMachine->COMGETTER(VRDEServer)(vrdeServer.asOutParam());
3933885bc0c2c93436d858a14564c6179ec72872vboxsync /* Parse 'name=value' */
3933885bc0c2c93436d858a14564c6179ec72872vboxsync CHECK_ERROR(vrdeServer, SetVRDEProperty(bstrName.raw(), bstrValue.raw()));
aa0553becec2abc2e781f839ba1d399c31c2c07fvboxsync errorArgument("Invalid vrdeproperty argument '%s'", a->argv[2]);
3933885bc0c2c93436d858a14564c6179ec72872vboxsync 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)));
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync 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)));
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync CHECK_ERROR_BREAK(console, FindUSBDeviceByAddress(Bstr(a->argv[2]).raw(),
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR_BREAK(dev, COMGETTER(Id)(usbId.asOutParam()));
501181107e73684ab109521ba371063734cd1d76vboxsync errorArgument("Zero UUID argument '%s'", a->argv[2]);
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync CHECK_ERROR_BREAK(console, AttachUSBDevice(usbId.raw()));
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync CHECK_ERROR_BREAK(console, DetachUSBDevice(usbId.raw(),
28ae9ced88db55943497a8bb98682bc2be513476vboxsync if (a->argc != 5 && a->argc != 6 && a->argc != 7 && a->argc != 9)
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
28ae9ced88db55943497a8bb98682bc2be513476vboxsync bool fEnabled = true;
28ae9ced88db55943497a8bb98682bc2be513476vboxsync errorSyntax(USAGE_CONTROLVM, "Either \"yes\" or \"no\" is expected");
03a954338932c2b34361f1d27ae2029828db0958vboxsync CHECK_ERROR_BREAK(console, COMGETTER(Display)(pDisplay.asOutParam()));
03a954338932c2b34361f1d27ae2029828db0958vboxsync CHECK_ERROR_BREAK(pDisplay, SetVideoModeHint(uDisplayIdx, fEnabled,
5af5f66dd66e8ed177bcb8b429a1c2f3093ab406vboxsync if ( strcmp(a->argv[5 + (a->argc - 7)], "--allowlocallogon")
5af5f66dd66e8ed177bcb8b429a1c2f3093ab406vboxsync && strcmp(a->argv[5 + (a->argc - 7)], "-allowlocallogon"))
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorArgument("Invalid parameter '%s'", a->argv[5]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
5af5f66dd66e8ed177bcb8b429a1c2f3093ab406vboxsync RTEXITCODE rcExit = readPasswordFile(a->argv[4], &passwd);
e4cab07522ccc54b3232ed0f7b6c11ddc3a99572vboxsync CHECK_ERROR_BREAK(console, COMGETTER(Guest)(pGuest.asOutParam()));
e4cab07522ccc54b3232ed0f7b6c11ddc3a99572vboxsync CHECK_ERROR_BREAK(pGuest, SetCredentials(Bstr(a->argv[2]).raw(),
c9e3f6ad81ea9a279ffb537720699e552882c40avboxsync#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 */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync 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()));
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /** @todo generalize this, allow arbitrary number of DVD drives
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * and as a consequence multiple attachments and different
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync * storage controllers. */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync CHECK_ERROR(machine, MountMedium(Bstr("IDE Controller"), 1, 0, uuid, FALSE /* aForce */));
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 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());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* must be a filename, check if it's in the collection */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync rc = a->virtualBox->FindFloppyImage(Bstr(a->argv[2]), floppyMedium.asOutParam());
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync /* not registered, do that on the fly */
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync 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 */));
c9e3f6ad81ea9a279ffb537720699e552882c40avboxsync#endif /* obsolete dvdattach/floppyattach */
21ed14a0d745501ffc9a68be81c0abadc777b628vboxsync 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]);
629169500a4e1696f37dd3118a791d68278f71davboxsync /* guest is running; update IGuest */
58ff90b6beb1ca44c2c8c03a190082a455ee55ebvboxsync rc = console->COMGETTER(Guest)(pGuest.asOutParam());
58ff90b6beb1ca44c2c8c03a190082a455ee55ebvboxsync CHECK_ERROR(pGuest, COMSETTER(MemoryBalloonSize)(uVal));
4c13f0d619c9707412b40eae8e3beafae5cf1858vboxsync { "--host", 'h', RTGETOPT_REQ_STRING }, /** @todo RTGETOPT_FLAG_MANDATORY */
4c13f0d619c9707412b40eae8e3beafae5cf1858vboxsync { "--hostname", 'h', RTGETOPT_REQ_STRING }, /** @todo remove this */
94c4b844625733fedcd2b473c207981b31316bd9vboxsync { "--port", 'P', RTGETOPT_REQ_UINT32 }, /** @todo RTGETOPT_FLAG_MANDATORY */
4c13f0d619c9707412b40eae8e3beafae5cf1858vboxsync { "--detailed-progress", 'D', RTGETOPT_REQ_NOTHING }
fb1975a6972d89de9e515bed0248db93f04ec9d8vboxsync RTGetOptInit(&GetOptState, a->argc, a->argv, s_aTeleportOptions, RT_ELEMENTS(s_aTeleportOptions), 2, RTGETOPTINIT_FLAGS_NO_STD_OPTS);
94c4b844625733fedcd2b473c207981b31316bd9vboxsync RTEXITCODE rcExit = readPasswordFile(Value.psz, &strPassword);
1207f59aa62006952dbb0bf7700decf34d8caeb2vboxsync CHECK_ERROR_BREAK(console, Teleport(bstrHostname.raw(), uPort,
b2c92fb03e119c7de54f86a32fae9c1d59bc479evboxsync if (FAILED(rc) && rc != VBOX_E_INVALID_OBJECT_STATE)
b2c92fb03e119c7de54f86a32fae9c1d59bc479evboxsync CHECK_ERROR_BREAK(progress, COMSETTER(Timeout)(cMsTimeout)); /* lazyness */
ae16af2d7d3c99d359094a7f19f5937efc2e66bdvboxsync CHECK_PROGRESS_ERROR(progress, ("Teleportation failed"));
9ce5d949e4f1572d445a5c0aecabe9de8b672c99vboxsync errorSyntax(USAGE_CONTROLVM, "Incorrect number of parameters");
48890ac9b4b339e0341e826b5c26ce6408729987vboxsync vrc = RTStrToUInt32Ex(a->argv[3], NULL, 0, &iScreen);
9ce5d949e4f1572d445a5c0aecabe9de8b672c99vboxsync errorArgument("Error parsing display number '%s'", a->argv[3]);
9ce5d949e4f1572d445a5c0aecabe9de8b672c99vboxsync CHECK_ERROR_BREAK(console, COMGETTER(Display)(pDisplay.asOutParam()));
77b95150000f2ef9778e43783401ed80eaed6949vboxsync CHECK_ERROR_BREAK(pDisplay, GetScreenResolution(iScreen, &width, &height, &bpp, &xOrigin, &yOrigin));
d01bb88591e2ae070aa233b99c81e58598d557e1vboxsync CHECK_ERROR_BREAK(pDisplay, TakeScreenShotToArray(iScreen, width, height, BitmapFormat_PNG, ComSafeArrayAsOutParam(saScreenshot)));
844af57b369279e0d79e59b433ab16aa83b47df2vboxsync vrc = RTFileOpen(&pngFile, a->argv[2], RTFILE_O_OPEN_CREATE | RTFILE_O_WRITE | RTFILE_O_TRUNCATE | RTFILE_O_DENY_ALL);
9ce5d949e4f1572d445a5c0aecabe9de8b672c99vboxsync RTMsgError("Failed to create file '%s'. rc=%Rrc", a->argv[2], vrc);
9ce5d949e4f1572d445a5c0aecabe9de8b672c99vboxsync vrc = RTFileWrite(pngFile, saScreenshot.raw(), saScreenshot.size(), NULL);
9ce5d949e4f1572d445a5c0aecabe9de8b672c99vboxsync RTMsgError("Failed to write screenshot to file '%s'. rc=%Rrc", a->argv[2], vrc);
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync CHECK_ERROR_RET(sessionMachine, COMSETTER(VideoCaptureEnabled)(TRUE), 1);
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync CHECK_ERROR_RET(sessionMachine, COMSETTER(VideoCaptureEnabled)(FALSE), 1);
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync errorArgument("Invalid state '%s'", Utf8Str(a->argv[2]).c_str());
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync else if ( !strcmp(a->argv[1], "videocapturescreens"))
48890ac9b4b339e0341e826b5c26ce6408729987vboxsync CHECK_ERROR_BREAK(machine, COMGETTER(MonitorCount)(&cMonitors));
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync /* enable all screens */
48890ac9b4b339e0341e826b5c26ce6408729987vboxsync for (unsigned i = 0; i < cMonitors; i++)
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync /* disable all screens */
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync for (unsigned i = 0; i < cMonitors; i++)
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync /* enable selected screens */
ab9d561bc33f1705a10c5e4bffed9c9e660dc32fvboxsync for (unsigned i = 0; i < cMonitors; i++)
48890ac9b4b339e0341e826b5c26ce6408729987vboxsync int vrc = RTStrToUInt32Ex(a->argv[i], NULL, 0, &iScreen);
48890ac9b4b339e0341e826b5c26ce6408729987vboxsync errorArgument("Error parsing display number '%s'", a->argv[i]);
48890ac9b4b339e0341e826b5c26ce6408729987vboxsync errorArgument("Invalid screen ID specified '%u'", iScreen);
1a3fdaf7f4fdfc0680a7091ba9c1e7309098ff2bvboxsync CHECK_ERROR_BREAK(sessionMachine, COMSETTER(VideoCaptureScreens)(ComSafeArrayAsInParam(saScreens)));
101e307bb33304d9dda53a7652510880e8228b13vboxsync errorArgument("Missing argument to '%s'", a->argv[1]);
101e307bb33304d9dda53a7652510880e8228b13vboxsync CHECK_ERROR_BREAK(console, COMGETTER(EmulatedUSB)(pEmulatedUSB.asOutParam()));
101e307bb33304d9dda53a7652510880e8228b13vboxsync CHECK_ERROR_BREAK(pEmulatedUSB, WebcamAttach(path.raw(), settings.raw()));
101e307bb33304d9dda53a7652510880e8228b13vboxsync CHECK_ERROR_BREAK(pEmulatedUSB, WebcamDetach(path.raw()));
101e307bb33304d9dda53a7652510880e8228b13vboxsync CHECK_ERROR_BREAK(pEmulatedUSB, COMGETTER(Webcams)(ComSafeArrayAsOutParam(webcams)));
101e307bb33304d9dda53a7652510880e8228b13vboxsync RTPrintf("%ls\n", webcams[i][0]? webcams[i]: Bstr("default").raw());
101e307bb33304d9dda53a7652510880e8228b13vboxsync errorArgument("Invalid argument to '%s'", a->argv[1]);
1ce069685b24d243eb0464f46d4c56b250c64445vboxsync errorSyntax(USAGE_CONTROLVM, "Invalid parameter '%s'", a->argv[1]);
4328e87247f4a96449677e199c7e99ef516fc1cevboxsync } while (0);