/* $Id: VirtualBoxImpl.cpp 86069 2020-09-09 03:03:23Z vboxsync $ */ /** @file * Implementation of IVirtualBox in VBoxSVC. */ /* * Copyright (C) 2006-2020 Oracle Corporation * * This file is part of VirtualBox Open Source Edition (OSE), as * available from http://www.virtualbox.org. This file is free software; * you can redistribute it and/or modify it under the terms of the GNU * General Public License (GPL) as published by the Free Software * Foundation, in version 2 as it comes in the "COPYING" file of the * VirtualBox OSE distribution. VirtualBox OSE is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. */ #define LOG_GROUP LOG_GROUP_MAIN_VIRTUALBOX #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "VBox/com/EventQueue.h" #include "VBox/com/MultiResult.h" #include #include #include #include #ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS # include #endif #include #include #include #include #include // for auto_ptr #include "VirtualBoxImpl.h" #include "Global.h" #include "MachineImpl.h" #include "MediumImpl.h" #include "SharedFolderImpl.h" #include "ProgressImpl.h" #include "HostImpl.h" #include "USBControllerImpl.h" #include "SystemPropertiesImpl.h" #include "GuestOSTypeImpl.h" #include "NetworkServiceRunner.h" #include "DHCPServerImpl.h" #include "NATNetworkImpl.h" #ifdef VBOX_WITH_CLOUD_NET #include "CloudNetworkImpl.h" #endif /* VBOX_WITH_CLOUD_NET */ #ifdef VBOX_WITH_RESOURCE_USAGE_API # include "PerformanceImpl.h" #endif /* VBOX_WITH_RESOURCE_USAGE_API */ #include "EventImpl.h" #ifdef VBOX_WITH_EXTPACK # include "ExtPackManagerImpl.h" #endif #ifdef VBOX_WITH_UNATTENDED # include "UnattendedImpl.h" #endif #include "AutostartDb.h" #include "ClientWatcher.h" #include "AutoCaller.h" #include "LoggingNew.h" #include "CloudProviderManagerImpl.h" #include "ThreadTask.h" #include "VBoxEvents.h" #include #ifdef RT_OS_WINDOWS # include "win/svchlp.h" # include "tchar.h" #endif //////////////////////////////////////////////////////////////////////////////// // // Definitions // //////////////////////////////////////////////////////////////////////////////// #define VBOX_GLOBAL_SETTINGS_FILE "VirtualBox.xml" //////////////////////////////////////////////////////////////////////////////// // // Global variables // //////////////////////////////////////////////////////////////////////////////// // static com::Utf8Str VirtualBox::sVersion; // static com::Utf8Str VirtualBox::sVersionNormalized; // static ULONG VirtualBox::sRevision; // static com::Utf8Str VirtualBox::sPackageType; // static com::Utf8Str VirtualBox::sAPIVersion; // static std::map VirtualBox::sNatNetworkNameToRefCount; // static leaked (todo: find better place to free it.) RWLockHandle *VirtualBox::spMtxNatNetworkNameToRefCountLock; #if 0 /* obsoleted by AsyncEvent */ //////////////////////////////////////////////////////////////////////////////// // // CallbackEvent class // //////////////////////////////////////////////////////////////////////////////// /** * Abstract callback event class to asynchronously call VirtualBox callbacks * on a dedicated event thread. Subclasses reimplement #prepareEventDesc() * to initialize the event depending on the event to be dispatched. * * @note The VirtualBox instance passed to the constructor is strongly * referenced, so that the VirtualBox singleton won't be released until the * event gets handled by the event thread. */ class VirtualBox::CallbackEvent : public Event { public: CallbackEvent(VirtualBox *aVirtualBox, VBoxEventType_T aWhat) : mVirtualBox(aVirtualBox), mWhat(aWhat) { Assert(aVirtualBox); } void *handler(); virtual HRESULT prepareEventDesc(IEventSource* aSource, VBoxEventDesc& aEvDesc) = 0; private: /** * Note that this is a weak ref -- the CallbackEvent handler thread * is bound to the lifetime of the VirtualBox instance, so it's safe. */ VirtualBox *mVirtualBox; protected: VBoxEventType_T mWhat; }; #endif //////////////////////////////////////////////////////////////////////////////// // // AsyncEvent class // //////////////////////////////////////////////////////////////////////////////// /** * For firing off an event on asynchronously on an event thread. */ class VirtualBox::AsyncEvent : public Event { public: AsyncEvent(VirtualBox *a_pVirtualBox, ComPtr const &a_rEvent) : mVirtualBox(a_pVirtualBox), mEvent(a_rEvent) { Assert(a_pVirtualBox); } void *handler() RT_OVERRIDE; private: /** * @note This is a weak ref -- the CallbackEvent handler thread is bound to the * lifetime of the VirtualBox instance, so it's safe. */ VirtualBox *mVirtualBox; /** The event. */ ComPtr mEvent; }; //////////////////////////////////////////////////////////////////////////////// // // VirtualBox private member data definition // //////////////////////////////////////////////////////////////////////////////// #if defined(RT_OS_WINDOWS) && defined(VBOXSVC_WITH_CLIENT_WATCHER) /** * Client process watcher data. */ class WatchedClientProcess { public: WatchedClientProcess(RTPROCESS a_pid, HANDLE a_hProcess) RT_NOEXCEPT : m_pid(a_pid) , m_cRefs(1) , m_hProcess(a_hProcess) { } ~WatchedClientProcess() { if (m_hProcess != NULL) { ::CloseHandle(m_hProcess); m_hProcess = NULL; } m_pid = NIL_RTPROCESS; } /** The client PID. */ RTPROCESS m_pid; /** Number of references to this structure. */ uint32_t volatile m_cRefs; /** Handle of the client process. * Ideally, we've got full query privileges, but we'll settle for waiting. */ HANDLE m_hProcess; }; typedef std::map WatchedClientProcessMap; #endif typedef ObjectsList MediaOList; typedef ObjectsList GuestOSTypesOList; typedef ObjectsList SharedFoldersOList; typedef ObjectsList DHCPServersOList; typedef ObjectsList NATNetworksOList; #ifdef VBOX_WITH_CLOUD_NET typedef ObjectsList CloudNetworksOList; #endif /* VBOX_WITH_CLOUD_NET */ typedef std::map > ProgressMap; typedef std::map > HardDiskMap; #ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS /** * Structure for keeping Shared Clipboard area data within the VirtualBox object. */ struct SharedClipboardAreaData { SharedClipboardAreaData() : uID(NIL_SHCLAREAID) { } /** The area's (unique) ID. * Set to NIL_SHCLAREAID if not initialized yet. */ ULONG uID; /** The actual Shared Clipboard area assigned to this ID. */ SharedClipboardArea Area; }; /** Map of Shared Clipboard areas. The key defines the area ID. */ typedef std::map SharedClipboardAreaMap; /** * Structure for keeping global Shared Clipboard data within the VirtualBox object. */ struct SharedClipboardData { SharedClipboardData() : uMostRecentClipboardAreaID(NIL_SHCLAREAID) , uMaxClipboardAreas(32) /** @todo Make this configurable. */ { #ifdef DEBUG_andy uMaxClipboardAreas = 9999; #endif int rc2 = RTCritSectInit(&CritSect); AssertRC(rc2); } virtual ~SharedClipboardData() { RTCritSectDelete(&CritSect); } /** * Generates a new clipboard area ID. * Currently does *not* check for collisions and stuff. * * @returns New clipboard area ID. */ ULONG GenerateAreaID(void) { ULONG uID = NIL_SHCLAREAID; int rc = RTCritSectEnter(&CritSect); if (RT_SUCCESS(rc)) { uID = RTRandU32Ex(1, UINT32_MAX - 1); /** @todo Make this a bit more sophisticated. Later. */ int rc2 = RTCritSectLeave(&CritSect); AssertRC(rc2); } LogFlowFunc(("uID=%RU32\n", uID)); return uID; } /** Critical section to serialize access. */ RTCRITSECT CritSect; /** The most recent (last created) clipboard area ID. * NIL_SHCLAREAID if not initialized yet. */ ULONG uMostRecentClipboardAreaID; /** Maximum of concurrent clipboard areas. * @todo Make this configurable. */ ULONG uMaxClipboardAreas; /** Map of clipboard areas. The key is the area ID. */ SharedClipboardAreaMap mapClipboardAreas; }; #endif /* VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS */ /** * Main VirtualBox data structure. * @note |const| members are persistent during lifetime so can be accessed * without locking. */ struct VirtualBox::Data { Data() : pMainConfigFile(NULL) , uuidMediaRegistry("48024e5c-fdd9-470f-93af-ec29f7ea518c") , uRegistryNeedsSaving(0) , lockMachines(LOCKCLASS_LISTOFMACHINES) , allMachines(lockMachines) , lockGuestOSTypes(LOCKCLASS_LISTOFOTHEROBJECTS) , allGuestOSTypes(lockGuestOSTypes) , lockMedia(LOCKCLASS_LISTOFMEDIA) , allHardDisks(lockMedia) , allDVDImages(lockMedia) , allFloppyImages(lockMedia) , lockSharedFolders(LOCKCLASS_LISTOFOTHEROBJECTS) , allSharedFolders(lockSharedFolders) , lockDHCPServers(LOCKCLASS_LISTOFOTHEROBJECTS) , allDHCPServers(lockDHCPServers) , lockNATNetworks(LOCKCLASS_LISTOFOTHEROBJECTS) , allNATNetworks(lockNATNetworks) #ifdef VBOX_WITH_CLOUD_NET , lockCloudNetworks(LOCKCLASS_LISTOFOTHEROBJECTS) , allCloudNetworks(lockCloudNetworks) #endif /* VBOX_WITH_CLOUD_NET */ , mtxProgressOperations(LOCKCLASS_PROGRESSLIST) , pClientWatcher(NULL) , threadAsyncEvent(NIL_RTTHREAD) , pAsyncEventQ(NULL) , pAutostartDb(NULL) , fSettingsCipherKeySet(false) #if defined(RT_OS_WINDOWS) && defined(VBOXSVC_WITH_CLIENT_WATCHER) , fWatcherIsReliable(RTSystemGetNtVersion() >= RTSYSTEM_MAKE_NT_VERSION(6, 0, 0)) #endif { #if defined(RT_OS_WINDOWS) && defined(VBOXSVC_WITH_CLIENT_WATCHER) RTCritSectRwInit(&WatcherCritSect); #endif } ~Data() { if (pMainConfigFile) { delete pMainConfigFile; pMainConfigFile = NULL; } }; // const data members not requiring locking const Utf8Str strHomeDir; // VirtualBox main settings file const Utf8Str strSettingsFilePath; settings::MainConfigFile *pMainConfigFile; // constant pseudo-machine ID for global media registry const Guid uuidMediaRegistry; // counter if global media registry needs saving, updated using atomic // operations, without requiring any locks uint64_t uRegistryNeedsSaving; // const objects not requiring locking const ComObjPtr pHost; const ComObjPtr pSystemProperties; #ifdef VBOX_WITH_RESOURCE_USAGE_API const ComObjPtr pPerformanceCollector; #endif /* VBOX_WITH_RESOURCE_USAGE_API */ // Each of the following lists use a particular lock handle that protects the // list as a whole. As opposed to version 3.1 and earlier, these lists no // longer need the main VirtualBox object lock, but only the respective list // lock. In each case, the locking order is defined that the list must be // requested before object locks of members of the lists (see the order definitions // in AutoLock.h; e.g. LOCKCLASS_LISTOFMACHINES before LOCKCLASS_MACHINEOBJECT). RWLockHandle lockMachines; MachinesOList allMachines; RWLockHandle lockGuestOSTypes; GuestOSTypesOList allGuestOSTypes; // All the media lists are protected by the following locking handle: RWLockHandle lockMedia; MediaOList allHardDisks, // base images only! allDVDImages, allFloppyImages; // the hard disks map is an additional map sorted by UUID for quick lookup // and contains ALL hard disks (base and differencing); it is protected by // the same lock as the other media lists above HardDiskMap mapHardDisks; // list of pending machine renames (also protected by media tree lock; // see VirtualBox::rememberMachineNameChangeForMedia()) struct PendingMachineRename { Utf8Str strConfigDirOld; Utf8Str strConfigDirNew; }; typedef std::list PendingMachineRenamesList; PendingMachineRenamesList llPendingMachineRenames; RWLockHandle lockSharedFolders; SharedFoldersOList allSharedFolders; RWLockHandle lockDHCPServers; DHCPServersOList allDHCPServers; RWLockHandle lockNATNetworks; NATNetworksOList allNATNetworks; #ifdef VBOX_WITH_CLOUD_NET RWLockHandle lockCloudNetworks; CloudNetworksOList allCloudNetworks; #endif /* VBOX_WITH_CLOUD_NET */ RWLockHandle mtxProgressOperations; ProgressMap mapProgressOperations; ClientWatcher * const pClientWatcher; // the following are data for the async event thread const RTTHREAD threadAsyncEvent; EventQueue * const pAsyncEventQ; const ComObjPtr pEventSource; #ifdef VBOX_WITH_EXTPACK /** The extension pack manager object lives here. */ const ComObjPtr ptrExtPackManager; #endif /** The reference to the cloud provider manager singleton. */ const ComObjPtr pCloudProviderManager; /** The global autostart database for the user. */ AutostartDb * const pAutostartDb; /** Settings secret */ bool fSettingsCipherKeySet; uint8_t SettingsCipherKey[RTSHA512_HASH_SIZE]; #if defined(RT_OS_WINDOWS) && defined(VBOXSVC_WITH_CLIENT_WATCHER) /** Critical section protecting WatchedProcesses. */ RTCRITSECTRW WatcherCritSect; /** Map of processes being watched, key is the PID. */ WatchedClientProcessMap WatchedProcesses; /** Set if the watcher is reliable, otherwise cleared. * The watcher goes unreliable when we run out of memory, fail open a client * process, or if the watcher thread gets messed up. */ bool fWatcherIsReliable; #endif #ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS /** Data related to Shared Clipboard handling. */ SharedClipboardData SharedClipboard; #endif }; // constructor / destructor ///////////////////////////////////////////////////////////////////////////// DEFINE_EMPTY_CTOR_DTOR(VirtualBox) HRESULT VirtualBox::FinalConstruct() { LogRelFlowThisFuncEnter(); LogRel(("VirtualBox: object creation starts\n")); BaseFinalConstruct(); HRESULT rc = init(); LogRelFlowThisFuncLeave(); LogRel(("VirtualBox: object created\n")); return rc; } void VirtualBox::FinalRelease() { LogRelFlowThisFuncEnter(); LogRel(("VirtualBox: object deletion starts\n")); uninit(); BaseFinalRelease(); LogRel(("VirtualBox: object deleted\n")); LogRelFlowThisFuncLeave(); } // public initializer/uninitializer for internal purposes only ///////////////////////////////////////////////////////////////////////////// /** * Initializes the VirtualBox object. * * @return COM result code */ HRESULT VirtualBox::init() { LogRelFlowThisFuncEnter(); /* Enclose the state transition NotReady->InInit->Ready */ AutoInitSpan autoInitSpan(this); AssertReturn(autoInitSpan.isOk(), E_FAIL); /* Locking this object for writing during init sounds a bit paradoxical, * but in the current locking mess this avoids that some code gets a * read lock and later calls code which wants the same write lock. */ AutoWriteLock lock(this COMMA_LOCKVAL_SRC_POS); // allocate our instance data m = new Data; LogFlow(("===========================================================\n")); LogFlowThisFuncEnter(); if (sVersion.isEmpty()) sVersion = RTBldCfgVersion(); if (sVersionNormalized.isEmpty()) { Utf8Str tmp(RTBldCfgVersion()); if (tmp.endsWith(VBOX_BUILD_PUBLISHER)) tmp = tmp.substr(0, tmp.length() - strlen(VBOX_BUILD_PUBLISHER)); sVersionNormalized = tmp; } sRevision = RTBldCfgRevision(); if (sPackageType.isEmpty()) sPackageType = VBOX_PACKAGE_STRING; if (sAPIVersion.isEmpty()) sAPIVersion = VBOX_API_VERSION_STRING; if (!spMtxNatNetworkNameToRefCountLock) spMtxNatNetworkNameToRefCountLock = new RWLockHandle(LOCKCLASS_VIRTUALBOXOBJECT); LogFlowThisFunc(("Version: %s, Package: %s, API Version: %s\n", sVersion.c_str(), sPackageType.c_str(), sAPIVersion.c_str())); /* Important: DO NOT USE any kind of "early return" (except the single * one above, checking the init span success) in this method. It is vital * for correct error handling that it has only one point of return, which * does all the magic on COM to signal object creation success and * reporting the error later for every API method. COM translates any * unsuccessful object creation to REGDB_E_CLASSNOTREG errors or similar * unhelpful ones which cause us a lot of grief with troubleshooting. */ HRESULT rc = S_OK; bool fCreate = false; try { /* Create the event source early as we may fire async event during settings loading (media). */ rc = unconst(m->pEventSource).createObject(); if (FAILED(rc)) throw rc; rc = m->pEventSource->init(); if (FAILED(rc)) throw rc; /* Get the VirtualBox home directory. */ { char szHomeDir[RTPATH_MAX]; int vrc = com::GetVBoxUserHomeDirectory(szHomeDir, sizeof(szHomeDir)); if (RT_FAILURE(vrc)) throw setErrorBoth(E_FAIL, vrc, tr("Could not create the VirtualBox home directory '%s' (%Rrc)"), szHomeDir, vrc); unconst(m->strHomeDir) = szHomeDir; } LogRel(("Home directory: '%s'\n", m->strHomeDir.c_str())); i_reportDriverVersions(); /* compose the VirtualBox.xml file name */ unconst(m->strSettingsFilePath) = Utf8StrFmt("%s%c%s", m->strHomeDir.c_str(), RTPATH_DELIMITER, VBOX_GLOBAL_SETTINGS_FILE); // load and parse VirtualBox.xml; this will throw on XML or logic errors try { m->pMainConfigFile = new settings::MainConfigFile(&m->strSettingsFilePath); } catch (xml::EIPRTFailure &e) { // this is thrown by the XML backend if the RTOpen() call fails; // only if the main settings file does not exist, create it, // if there's something more serious, then do fail! if (e.rc() == VERR_FILE_NOT_FOUND) fCreate = true; else throw; } if (fCreate) m->pMainConfigFile = new settings::MainConfigFile(NULL); #ifdef VBOX_WITH_RESOURCE_USAGE_API /* create the performance collector object BEFORE host */ unconst(m->pPerformanceCollector).createObject(); rc = m->pPerformanceCollector->init(); ComAssertComRCThrowRC(rc); #endif /* VBOX_WITH_RESOURCE_USAGE_API */ /* create the host object early, machines will need it */ unconst(m->pHost).createObject(); rc = m->pHost->init(this); ComAssertComRCThrowRC(rc); rc = m->pHost->i_loadSettings(m->pMainConfigFile->host); if (FAILED(rc)) throw rc; /* * Create autostart database object early, because the system properties * might need it. */ unconst(m->pAutostartDb) = new AutostartDb; #ifdef VBOX_WITH_EXTPACK /* * Initialize extension pack manager before system properties because * it is required for the VD plugins. */ rc = unconst(m->ptrExtPackManager).createObject(); if (SUCCEEDED(rc)) rc = m->ptrExtPackManager->initExtPackManager(this, VBOXEXTPACKCTX_PER_USER_DAEMON); if (FAILED(rc)) throw rc; #endif /* create the system properties object, someone may need it too */ rc = unconst(m->pSystemProperties).createObject(); if (SUCCEEDED(rc)) rc = m->pSystemProperties->init(this); ComAssertComRCThrowRC(rc); rc = m->pSystemProperties->i_loadSettings(m->pMainConfigFile->systemProperties); if (FAILED(rc)) throw rc; /* guest OS type objects, needed by machines */ for (size_t i = 0; i < Global::cOSTypes; ++i) { ComObjPtr guestOSTypeObj; rc = guestOSTypeObj.createObject(); if (SUCCEEDED(rc)) { rc = guestOSTypeObj->init(Global::sOSTypes[i]); if (SUCCEEDED(rc)) m->allGuestOSTypes.addChild(guestOSTypeObj); } ComAssertComRCThrowRC(rc); } /* all registered media, needed by machines */ if (FAILED(rc = initMedia(m->uuidMediaRegistry, m->pMainConfigFile->mediaRegistry, Utf8Str::Empty))) // const Utf8Str &machineFolder throw rc; /* machines */ if (FAILED(rc = initMachines())) throw rc; #ifdef DEBUG LogFlowThisFunc(("Dumping media backreferences\n")); i_dumpAllBackRefs(); #endif /* net services - dhcp services */ for (settings::DHCPServersList::const_iterator it = m->pMainConfigFile->llDhcpServers.begin(); it != m->pMainConfigFile->llDhcpServers.end(); ++it) { const settings::DHCPServer &data = *it; ComObjPtr pDhcpServer; if (SUCCEEDED(rc = pDhcpServer.createObject())) rc = pDhcpServer->init(this, data); if (FAILED(rc)) throw rc; rc = i_registerDHCPServer(pDhcpServer, false /* aSaveRegistry */); if (FAILED(rc)) throw rc; } /* net services - nat networks */ for (settings::NATNetworksList::const_iterator it = m->pMainConfigFile->llNATNetworks.begin(); it != m->pMainConfigFile->llNATNetworks.end(); ++it) { const settings::NATNetwork &net = *it; ComObjPtr pNATNetwork; rc = pNATNetwork.createObject(); AssertComRCThrowRC(rc); rc = pNATNetwork->init(this, ""); AssertComRCThrowRC(rc); rc = pNATNetwork->i_loadSettings(net); AssertComRCThrowRC(rc); rc = i_registerNATNetwork(pNATNetwork, false /* aSaveRegistry */); AssertComRCThrowRC(rc); } #ifdef VBOX_WITH_CLOUD_NET /* net services - cloud networks */ for (settings::CloudNetworksList::const_iterator it = m->pMainConfigFile->llCloudNetworks.begin(); it != m->pMainConfigFile->llCloudNetworks.end(); ++it) { ComObjPtr pCloudNetwork; rc = pCloudNetwork.createObject(); AssertComRCThrowRC(rc); rc = pCloudNetwork->init(this, ""); AssertComRCThrowRC(rc); rc = pCloudNetwork->i_loadSettings(*it); AssertComRCThrowRC(rc); m->allCloudNetworks.addChild(pCloudNetwork); AssertComRCThrowRC(rc); } #endif /* VBOX_WITH_CLOUD_NET */ /* cloud provider manager */ rc = unconst(m->pCloudProviderManager).createObject(); if (SUCCEEDED(rc)) rc = m->pCloudProviderManager->init(this); ComAssertComRCThrowRC(rc); if (FAILED(rc)) throw rc; } catch (HRESULT err) { /* we assume that error info is set by the thrower */ rc = err; } catch (...) { rc = VirtualBoxBase::handleUnexpectedExceptions(this, RT_SRC_POS); } if (SUCCEEDED(rc)) { /* set up client monitoring */ try { unconst(m->pClientWatcher) = new ClientWatcher(this); if (!m->pClientWatcher->isReady()) { delete m->pClientWatcher; unconst(m->pClientWatcher) = NULL; rc = E_FAIL; } } catch (std::bad_alloc &) { rc = E_OUTOFMEMORY; } } if (SUCCEEDED(rc)) { try { /* start the async event handler thread */ int vrc = RTThreadCreate(&unconst(m->threadAsyncEvent), AsyncEventHandler, &unconst(m->pAsyncEventQ), 0, RTTHREADTYPE_MAIN_WORKER, RTTHREADFLAGS_WAITABLE, "EventHandler"); ComAssertRCThrow(vrc, E_FAIL); /* wait until the thread sets m->pAsyncEventQ */ RTThreadUserWait(m->threadAsyncEvent, RT_INDEFINITE_WAIT); ComAssertThrow(m->pAsyncEventQ, E_FAIL); } catch (HRESULT aRC) { rc = aRC; } } #ifdef VBOX_WITH_EXTPACK /* Let the extension packs have a go at things. */ if (SUCCEEDED(rc)) { lock.release(); m->ptrExtPackManager->i_callAllVirtualBoxReadyHooks(); } #endif /* Confirm a successful initialization when it's the case. Must be last, * as on failure it will uninitialize the object. */ if (SUCCEEDED(rc)) autoInitSpan.setSucceeded(); else autoInitSpan.setFailed(rc); LogFlowThisFunc(("rc=%Rhrc\n", rc)); LogFlowThisFuncLeave(); LogFlow(("===========================================================\n")); /* Unconditionally return success, because the error return is delayed to * the attribute/method calls through the InitFailed object state. */ return S_OK; } HRESULT VirtualBox::initMachines() { for (settings::MachinesRegistry::const_iterator it = m->pMainConfigFile->llMachines.begin(); it != m->pMainConfigFile->llMachines.end(); ++it) { HRESULT rc = S_OK; const settings::MachineRegistryEntry &xmlMachine = *it; Guid uuid = xmlMachine.uuid; /* Check if machine record has valid parameters. */ if (xmlMachine.strSettingsFile.isEmpty() || uuid.isZero()) { LogRel(("Skipped invalid machine record.\n")); continue; } ComObjPtr pMachine; if (SUCCEEDED(rc = pMachine.createObject())) { rc = pMachine->initFromSettings(this, xmlMachine.strSettingsFile, &uuid); if (SUCCEEDED(rc)) rc = i_registerMachine(pMachine); if (FAILED(rc)) return rc; } } return S_OK; } /** * Loads a media registry from XML and adds the media contained therein to * the global lists of known media. * * This now (4.0) gets called from two locations: * * -- VirtualBox::init(), to load the global media registry from VirtualBox.xml; * * -- Machine::loadMachineDataFromSettings(), to load the per-machine registry * from machine XML, for machines created with VirtualBox 4.0 or later. * * In both cases, the media found are added to the global lists so the * global arrays of media (including the GUI's virtual media manager) * continue to work as before. * * @param uuidRegistry The UUID of the media registry. This is either the * transient UUID created at VirtualBox startup for the global registry or * a machine ID. * @param mediaRegistry The XML settings structure to load, either from VirtualBox.xml * or a machine XML. * @param strMachineFolder The folder of the machine. * @return */ HRESULT VirtualBox::initMedia(const Guid &uuidRegistry, const settings::MediaRegistry &mediaRegistry, const Utf8Str &strMachineFolder) { LogFlow(("VirtualBox::initMedia ENTERING, uuidRegistry=%s, strMachineFolder=%s\n", uuidRegistry.toString().c_str(), strMachineFolder.c_str())); AutoWriteLock treeLock(i_getMediaTreeLockHandle() COMMA_LOCKVAL_SRC_POS); // the order of notification is critical for GUI, so use std::list instead of map std::list > uIdsForNotify; HRESULT rc = S_OK; settings::MediaList::const_iterator it; for (it = mediaRegistry.llHardDisks.begin(); it != mediaRegistry.llHardDisks.end(); ++it) { const settings::Medium &xmlHD = *it; ComObjPtr pHardDisk; if (SUCCEEDED(rc = pHardDisk.createObject())) rc = pHardDisk->init(this, NULL, // parent DeviceType_HardDisk, uuidRegistry, xmlHD, // XML data; this recurses to processes the children strMachineFolder, treeLock); if (FAILED(rc)) return rc; rc = i_registerMedium(pHardDisk, &pHardDisk, treeLock); if (SUCCEEDED(rc)) { uIdsForNotify.push_back(std::pair(pHardDisk->i_getId(), DeviceType_HardDisk)); // Add children IDs to notification using non-recursive children enumeration. std::vector > > llEnumStack; const MediaList& mediaList = pHardDisk->i_getChildren(); llEnumStack.push_back(std::pair >(mediaList.begin(), pHardDisk)); while (!llEnumStack.empty()) { if (llEnumStack.back().first == llEnumStack.back().second->i_getChildren().end()) { llEnumStack.pop_back(); if (!llEnumStack.empty()) ++llEnumStack.back().first; continue; } uIdsForNotify.push_back(std::pair((*llEnumStack.back().first)->i_getId(), DeviceType_HardDisk)); const MediaList& childMediaList = (*llEnumStack.back().first)->i_getChildren(); if (!childMediaList.empty()) { llEnumStack.push_back(std::pair >(childMediaList.begin(), *llEnumStack.back().first)); continue; } ++llEnumStack.back().first; } } // Avoid trouble with lock/refcount, before returning or not. treeLock.release(); pHardDisk.setNull(); treeLock.acquire(); if (FAILED(rc)) return rc; } for (it = mediaRegistry.llDvdImages.begin(); it != mediaRegistry.llDvdImages.end(); ++it) { const settings::Medium &xmlDvd = *it; ComObjPtr pImage; if (SUCCEEDED(pImage.createObject())) rc = pImage->init(this, NULL, DeviceType_DVD, uuidRegistry, xmlDvd, strMachineFolder, treeLock); if (FAILED(rc)) return rc; rc = i_registerMedium(pImage, &pImage, treeLock); if (SUCCEEDED(rc)) uIdsForNotify.push_back(std::pair(pImage->i_getId(), DeviceType_DVD)); // Avoid trouble with lock/refcount, before returning or not. treeLock.release(); pImage.setNull(); treeLock.acquire(); if (FAILED(rc)) return rc; } for (it = mediaRegistry.llFloppyImages.begin(); it != mediaRegistry.llFloppyImages.end(); ++it) { const settings::Medium &xmlFloppy = *it; ComObjPtr pImage; if (SUCCEEDED(pImage.createObject())) rc = pImage->init(this, NULL, DeviceType_Floppy, uuidRegistry, xmlFloppy, strMachineFolder, treeLock); if (FAILED(rc)) return rc; rc = i_registerMedium(pImage, &pImage, treeLock); if (SUCCEEDED(rc)) uIdsForNotify.push_back(std::pair(pImage->i_getId(), DeviceType_Floppy)); // Avoid trouble with lock/refcount, before returning or not. treeLock.release(); pImage.setNull(); treeLock.acquire(); if (FAILED(rc)) return rc; } if (SUCCEEDED(rc)) { for (std::list >::const_iterator itItem = uIdsForNotify.begin(); itItem != uIdsForNotify.end(); ++itItem) { i_onMediumRegistered(itItem->first, itItem->second, TRUE); } } LogFlow(("VirtualBox::initMedia LEAVING\n")); return S_OK; } void VirtualBox::uninit() { /* Must be done outside the AutoUninitSpan, as it expects AutoCaller to * be successful. This needs additional checks to protect against double * uninit, as then the pointer is NULL. */ if (RT_VALID_PTR(m)) { Assert(!m->uRegistryNeedsSaving); if (m->uRegistryNeedsSaving) i_saveSettings(); } /* Enclose the state transition Ready->InUninit->NotReady */ AutoUninitSpan autoUninitSpan(this); if (autoUninitSpan.uninitDone()) return; LogFlow(("===========================================================\n")); LogFlowThisFuncEnter(); LogFlowThisFunc(("initFailed()=%d\n", autoUninitSpan.initFailed())); /* tell all our child objects we've been uninitialized */ LogFlowThisFunc(("Uninitializing machines (%d)...\n", m->allMachines.size())); if (m->pHost) { /* It is necessary to hold the VirtualBox and Host locks here because we may have to uninitialize SessionMachines. */ AutoMultiWriteLock2 multilock(this, m->pHost COMMA_LOCKVAL_SRC_POS); m->allMachines.uninitAll(); } else m->allMachines.uninitAll(); m->allFloppyImages.uninitAll(); m->allDVDImages.uninitAll(); m->allHardDisks.uninitAll(); m->allDHCPServers.uninitAll(); m->mapProgressOperations.clear(); m->allGuestOSTypes.uninitAll(); /* Note that we release singleton children after we've all other children. * In some cases this is important because these other children may use * some resources of the singletons which would prevent them from * uninitializing (as for example, mSystemProperties which owns * MediumFormat objects which Medium objects refer to) */ if (m->pCloudProviderManager) { m->pCloudProviderManager->uninit(); unconst(m->pCloudProviderManager).setNull(); } if (m->pSystemProperties) { m->pSystemProperties->uninit(); unconst(m->pSystemProperties).setNull(); } if (m->pHost) { m->pHost->uninit(); unconst(m->pHost).setNull(); } #ifdef VBOX_WITH_RESOURCE_USAGE_API if (m->pPerformanceCollector) { m->pPerformanceCollector->uninit(); unconst(m->pPerformanceCollector).setNull(); } #endif /* VBOX_WITH_RESOURCE_USAGE_API */ #ifdef VBOX_WITH_EXTPACK if (m->ptrExtPackManager) { m->ptrExtPackManager->uninit(); unconst(m->ptrExtPackManager).setNull(); } #endif #ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS LogFlowThisFunc(("Destroying Shared Clipboard areas...\n")); SharedClipboardAreaMap::iterator itArea = m->SharedClipboard.mapClipboardAreas.begin(); while (itArea != m->SharedClipboard.mapClipboardAreas.end()) { i_clipboardAreaDestroy(itArea->second); ++itArea; } m->SharedClipboard.mapClipboardAreas.clear(); #endif LogFlowThisFunc(("Terminating the async event handler...\n")); if (m->threadAsyncEvent != NIL_RTTHREAD) { /* signal to exit the event loop */ if (RT_SUCCESS(m->pAsyncEventQ->interruptEventQueueProcessing())) { /* * Wait for thread termination (only after we've successfully * interrupted the event queue processing!) */ int vrc = RTThreadWait(m->threadAsyncEvent, 60000, NULL); if (RT_FAILURE(vrc)) Log1WarningFunc(("RTThreadWait(%RTthrd) -> %Rrc\n", m->threadAsyncEvent, vrc)); } else { AssertMsgFailed(("interruptEventQueueProcessing() failed\n")); RTThreadWait(m->threadAsyncEvent, 0, NULL); } unconst(m->threadAsyncEvent) = NIL_RTTHREAD; unconst(m->pAsyncEventQ) = NULL; } LogFlowThisFunc(("Releasing event source...\n")); if (m->pEventSource) { // Must uninit the event source here, because it makes no sense that // it survives longer than the base object. If someone gets an event // with such an event source then that's life and it has to be dealt // with appropriately on the API client side. m->pEventSource->uninit(); unconst(m->pEventSource).setNull(); } LogFlowThisFunc(("Terminating the client watcher...\n")); if (m->pClientWatcher) { delete m->pClientWatcher; unconst(m->pClientWatcher) = NULL; } delete m->pAutostartDb; // clean up our instance data delete m; m = NULL; /* Unload hard disk plugin backends. */ VDShutdown(); LogFlowThisFuncLeave(); LogFlow(("===========================================================\n")); } // Wrapped IVirtualBox properties ///////////////////////////////////////////////////////////////////////////// HRESULT VirtualBox::getVersion(com::Utf8Str &aVersion) { aVersion = sVersion; return S_OK; } HRESULT VirtualBox::getVersionNormalized(com::Utf8Str &aVersionNormalized) { aVersionNormalized = sVersionNormalized; return S_OK; } HRESULT VirtualBox::getRevision(ULONG *aRevision) { *aRevision = sRevision; return S_OK; } HRESULT VirtualBox::getPackageType(com::Utf8Str &aPackageType) { aPackageType = sPackageType; return S_OK; } HRESULT VirtualBox::getAPIVersion(com::Utf8Str &aAPIVersion) { aAPIVersion = sAPIVersion; return S_OK; } HRESULT VirtualBox::getAPIRevision(LONG64 *aAPIRevision) { AssertCompile(VBOX_VERSION_MAJOR < 128 && VBOX_VERSION_MAJOR > 0); AssertCompile((uint64_t)VBOX_VERSION_MINOR < 256); uint64_t uRevision = ((uint64_t)VBOX_VERSION_MAJOR << 56) | ((uint64_t)VBOX_VERSION_MINOR << 48) | ((uint64_t)VBOX_VERSION_BUILD << 40); /** @todo This needs to be the same in OSE and non-OSE, preferrably * only changing when actual API changes happens. */ uRevision |= 1; *aAPIRevision = (LONG64)uRevision; return S_OK; } HRESULT VirtualBox::getHomeFolder(com::Utf8Str &aHomeFolder) { /* mHomeDir is const and doesn't need a lock */ aHomeFolder = m->strHomeDir; return S_OK; } HRESULT VirtualBox::getSettingsFilePath(com::Utf8Str &aSettingsFilePath) { /* mCfgFile.mName is const and doesn't need a lock */ aSettingsFilePath = m->strSettingsFilePath; return S_OK; } HRESULT VirtualBox::getHost(ComPtr &aHost) { /* mHost is const, no need to lock */ m->pHost.queryInterfaceTo(aHost.asOutParam()); return S_OK; } HRESULT VirtualBox::getSystemProperties(ComPtr &aSystemProperties) { /* mSystemProperties is const, no need to lock */ m->pSystemProperties.queryInterfaceTo(aSystemProperties.asOutParam()); return S_OK; } HRESULT VirtualBox::getMachines(std::vector > &aMachines) { AutoReadLock al(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); aMachines.resize(m->allMachines.size()); size_t i = 0; for (MachinesOList::const_iterator it= m->allMachines.begin(); it!= m->allMachines.end(); ++it, ++i) (*it).queryInterfaceTo(aMachines[i].asOutParam()); return S_OK; } HRESULT VirtualBox::getMachineGroups(std::vector &aMachineGroups) { std::list allGroups; /* get copy of all machine references, to avoid holding the list lock */ MachinesOList::MyList allMachines; { AutoReadLock al(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); allMachines = m->allMachines.getList(); } for (MachinesOList::MyList::const_iterator it = allMachines.begin(); it != allMachines.end(); ++it) { const ComObjPtr &pMachine = *it; AutoCaller autoMachineCaller(pMachine); if (FAILED(autoMachineCaller.rc())) continue; AutoReadLock mlock(pMachine COMMA_LOCKVAL_SRC_POS); if (pMachine->i_isAccessible()) { const StringsList &thisGroups = pMachine->i_getGroups(); for (StringsList::const_iterator it2 = thisGroups.begin(); it2 != thisGroups.end(); ++it2) allGroups.push_back(*it2); } } /* throw out any duplicates */ allGroups.sort(); allGroups.unique(); aMachineGroups.resize(allGroups.size()); size_t i = 0; for (std::list::const_iterator it = allGroups.begin(); it != allGroups.end(); ++it, ++i) aMachineGroups[i] = (*it); return S_OK; } HRESULT VirtualBox::getHardDisks(std::vector > &aHardDisks) { AutoReadLock al(m->allHardDisks.getLockHandle() COMMA_LOCKVAL_SRC_POS); aHardDisks.resize(m->allHardDisks.size()); size_t i = 0; for (MediaOList::const_iterator it = m->allHardDisks.begin(); it != m->allHardDisks.end(); ++it, ++i) (*it).queryInterfaceTo(aHardDisks[i].asOutParam()); return S_OK; } HRESULT VirtualBox::getDVDImages(std::vector > &aDVDImages) { AutoReadLock al(m->allDVDImages.getLockHandle() COMMA_LOCKVAL_SRC_POS); aDVDImages.resize(m->allDVDImages.size()); size_t i = 0; for (MediaOList::const_iterator it = m->allDVDImages.begin(); it!= m->allDVDImages.end(); ++it, ++i) (*it).queryInterfaceTo(aDVDImages[i].asOutParam()); return S_OK; } HRESULT VirtualBox::getFloppyImages(std::vector > &aFloppyImages) { AutoReadLock al(m->allFloppyImages.getLockHandle() COMMA_LOCKVAL_SRC_POS); aFloppyImages.resize(m->allFloppyImages.size()); size_t i = 0; for (MediaOList::const_iterator it = m->allFloppyImages.begin(); it != m->allFloppyImages.end(); ++it, ++i) (*it).queryInterfaceTo(aFloppyImages[i].asOutParam()); return S_OK; } HRESULT VirtualBox::getProgressOperations(std::vector > &aProgressOperations) { /* protect mProgressOperations */ AutoReadLock safeLock(m->mtxProgressOperations COMMA_LOCKVAL_SRC_POS); ProgressMap pmap(m->mapProgressOperations); aProgressOperations.resize(pmap.size()); size_t i = 0; for (ProgressMap::iterator it = pmap.begin(); it != pmap.end(); ++it, ++i) it->second.queryInterfaceTo(aProgressOperations[i].asOutParam()); return S_OK; } HRESULT VirtualBox::getGuestOSTypes(std::vector > &aGuestOSTypes) { AutoReadLock al(m->allGuestOSTypes.getLockHandle() COMMA_LOCKVAL_SRC_POS); aGuestOSTypes.resize(m->allGuestOSTypes.size()); size_t i = 0; for (GuestOSTypesOList::const_iterator it = m->allGuestOSTypes.begin(); it != m->allGuestOSTypes.end(); ++it, ++i) (*it).queryInterfaceTo(aGuestOSTypes[i].asOutParam()); return S_OK; } HRESULT VirtualBox::getSharedFolders(std::vector > &aSharedFolders) { NOREF(aSharedFolders); return setError(E_NOTIMPL, "Not yet implemented"); } HRESULT VirtualBox::getPerformanceCollector(ComPtr &aPerformanceCollector) { #ifdef VBOX_WITH_RESOURCE_USAGE_API /* mPerformanceCollector is const, no need to lock */ m->pPerformanceCollector.queryInterfaceTo(aPerformanceCollector.asOutParam()); return S_OK; #else /* !VBOX_WITH_RESOURCE_USAGE_API */ NOREF(aPerformanceCollector); ReturnComNotImplemented(); #endif /* !VBOX_WITH_RESOURCE_USAGE_API */ } HRESULT VirtualBox::getDHCPServers(std::vector > &aDHCPServers) { AutoReadLock al(m->allDHCPServers.getLockHandle() COMMA_LOCKVAL_SRC_POS); aDHCPServers.resize(m->allDHCPServers.size()); size_t i = 0; for (DHCPServersOList::const_iterator it= m->allDHCPServers.begin(); it!= m->allDHCPServers.end(); ++it, ++i) (*it).queryInterfaceTo(aDHCPServers[i].asOutParam()); return S_OK; } HRESULT VirtualBox::getNATNetworks(std::vector > &aNATNetworks) { #ifdef VBOX_WITH_NAT_SERVICE AutoReadLock al(m->allNATNetworks.getLockHandle() COMMA_LOCKVAL_SRC_POS); aNATNetworks.resize(m->allNATNetworks.size()); size_t i = 0; for (NATNetworksOList::const_iterator it= m->allNATNetworks.begin(); it!= m->allNATNetworks.end(); ++it, ++i) (*it).queryInterfaceTo(aNATNetworks[i].asOutParam()); return S_OK; #else NOREF(aNATNetworks); return E_NOTIMPL; #endif } HRESULT VirtualBox::getEventSource(ComPtr &aEventSource) { /* event source is const, no need to lock */ m->pEventSource.queryInterfaceTo(aEventSource.asOutParam()); return S_OK; } HRESULT VirtualBox::getExtensionPackManager(ComPtr &aExtensionPackManager) { HRESULT hrc = S_OK; #ifdef VBOX_WITH_EXTPACK /* The extension pack manager is const, no need to lock. */ hrc = m->ptrExtPackManager.queryInterfaceTo(aExtensionPackManager.asOutParam()); #else hrc = E_NOTIMPL; NOREF(aExtensionPackManager); #endif return hrc; } HRESULT VirtualBox::getInternalNetworks(std::vector &aInternalNetworks) { std::list allInternalNetworks; /* get copy of all machine references, to avoid holding the list lock */ MachinesOList::MyList allMachines; { AutoReadLock al(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); allMachines = m->allMachines.getList(); } for (MachinesOList::MyList::const_iterator it = allMachines.begin(); it != allMachines.end(); ++it) { const ComObjPtr &pMachine = *it; AutoCaller autoMachineCaller(pMachine); if (FAILED(autoMachineCaller.rc())) continue; AutoReadLock mlock(pMachine COMMA_LOCKVAL_SRC_POS); if (pMachine->i_isAccessible()) { uint32_t cNetworkAdapters = Global::getMaxNetworkAdapters(pMachine->i_getChipsetType()); for (ULONG i = 0; i < cNetworkAdapters; i++) { ComPtr pNet; HRESULT rc = pMachine->GetNetworkAdapter(i, pNet.asOutParam()); if (FAILED(rc) || pNet.isNull()) continue; Bstr strInternalNetwork; rc = pNet->COMGETTER(InternalNetwork)(strInternalNetwork.asOutParam()); if (FAILED(rc) || strInternalNetwork.isEmpty()) continue; allInternalNetworks.push_back(Utf8Str(strInternalNetwork)); } } } /* throw out any duplicates */ allInternalNetworks.sort(); allInternalNetworks.unique(); size_t i = 0; aInternalNetworks.resize(allInternalNetworks.size()); for (std::list::const_iterator it = allInternalNetworks.begin(); it != allInternalNetworks.end(); ++it, ++i) aInternalNetworks[i] = *it; return S_OK; } HRESULT VirtualBox::getGenericNetworkDrivers(std::vector &aGenericNetworkDrivers) { std::list allGenericNetworkDrivers; /* get copy of all machine references, to avoid holding the list lock */ MachinesOList::MyList allMachines; { AutoReadLock al(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); allMachines = m->allMachines.getList(); } for (MachinesOList::MyList::const_iterator it = allMachines.begin(); it != allMachines.end(); ++it) { const ComObjPtr &pMachine = *it; AutoCaller autoMachineCaller(pMachine); if (FAILED(autoMachineCaller.rc())) continue; AutoReadLock mlock(pMachine COMMA_LOCKVAL_SRC_POS); if (pMachine->i_isAccessible()) { uint32_t cNetworkAdapters = Global::getMaxNetworkAdapters(pMachine->i_getChipsetType()); for (ULONG i = 0; i < cNetworkAdapters; i++) { ComPtr pNet; HRESULT rc = pMachine->GetNetworkAdapter(i, pNet.asOutParam()); if (FAILED(rc) || pNet.isNull()) continue; Bstr strGenericNetworkDriver; rc = pNet->COMGETTER(GenericDriver)(strGenericNetworkDriver.asOutParam()); if (FAILED(rc) || strGenericNetworkDriver.isEmpty()) continue; allGenericNetworkDrivers.push_back(Utf8Str(strGenericNetworkDriver).c_str()); } } } /* throw out any duplicates */ allGenericNetworkDrivers.sort(); allGenericNetworkDrivers.unique(); aGenericNetworkDrivers.resize(allGenericNetworkDrivers.size()); size_t i = 0; for (std::list::const_iterator it = allGenericNetworkDrivers.begin(); it != allGenericNetworkDrivers.end(); ++it, ++i) aGenericNetworkDrivers[i] = *it; return S_OK; } /** * Cloud Network */ #ifdef VBOX_WITH_CLOUD_NET HRESULT VirtualBox::i_findCloudNetworkByName(const com::Utf8Str &aNetworkName, ComObjPtr *aNetwork) { HRESULT rc = VBOX_E_OBJECT_NOT_FOUND; ComPtr found; Bstr bstrNameToFind(aNetworkName); AutoReadLock alock(m->allCloudNetworks.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (CloudNetworksOList::const_iterator it = m->allCloudNetworks.begin(); it != m->allCloudNetworks.end(); ++it) { Bstr bstrCloudNetworkName; HRESULT hrc = (*it)->COMGETTER(NetworkName)(bstrCloudNetworkName.asOutParam()); if (FAILED(hrc)) return hrc; if (bstrCloudNetworkName == bstrNameToFind) { *aNetwork = *it; rc = S_OK; break; } } return rc; } #endif /* VBOX_WITH_CLOUD_NET */ HRESULT VirtualBox::createCloudNetwork(const com::Utf8Str &aNetworkName, ComPtr &aNetwork) { #ifdef VBOX_WITH_CLOUD_NET ComObjPtr cloudNetwork; cloudNetwork.createObject(); HRESULT rc = cloudNetwork->init(this, aNetworkName); if (FAILED(rc)) return rc; m->allCloudNetworks.addChild(cloudNetwork); cloudNetwork.queryInterfaceTo(aNetwork.asOutParam()); return rc; #else /* !VBOX_WITH_CLOUD_NET */ NOREF(aNetworkName); NOREF(aNetwork); return E_NOTIMPL; #endif /* !VBOX_WITH_CLOUD_NET */ } HRESULT VirtualBox::findCloudNetworkByName(const com::Utf8Str &aNetworkName, ComPtr &aNetwork) { #ifdef VBOX_WITH_CLOUD_NET ComObjPtr network; HRESULT hrc = i_findCloudNetworkByName(aNetworkName, &network); if (SUCCEEDED(hrc)) network.queryInterfaceTo(aNetwork.asOutParam()); return hrc; #else /* !VBOX_WITH_CLOUD_NET */ NOREF(aNetworkName); NOREF(aNetwork); return E_NOTIMPL; #endif /* !VBOX_WITH_CLOUD_NET */ } HRESULT VirtualBox::removeCloudNetwork(const ComPtr &aNetwork) { #ifdef VBOX_WITH_CLOUD_NET Bstr name; HRESULT rc = aNetwork->COMGETTER(NetworkName)(name.asOutParam()); if (FAILED(rc)) return rc; ICloudNetwork *p = aNetwork; CloudNetwork *network = static_cast(p); AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); AutoCaller cloudNetworkCaller(network); AssertComRCReturnRC(cloudNetworkCaller.rc()); m->allCloudNetworks.removeChild(network); { AutoWriteLock vboxLock(this COMMA_LOCKVAL_SRC_POS); rc = i_saveSettings(); vboxLock.release(); if (FAILED(rc)) m->allCloudNetworks.addChild(network); } return rc; #else /* !VBOX_WITH_CLOUD_NET */ NOREF(aNetwork); return E_NOTIMPL; #endif /* !VBOX_WITH_CLOUD_NET */ } HRESULT VirtualBox::getCloudNetworks(std::vector > &aCloudNetworks) { #ifdef VBOX_WITH_CLOUD_NET AutoReadLock al(m->allCloudNetworks.getLockHandle() COMMA_LOCKVAL_SRC_POS); aCloudNetworks.resize(m->allCloudNetworks.size()); size_t i = 0; for (CloudNetworksOList::const_iterator it = m->allCloudNetworks.begin(); it != m->allCloudNetworks.end(); ++it) (*it).queryInterfaceTo(aCloudNetworks[i++].asOutParam()); return S_OK; #else /* !VBOX_WITH_CLOUD_NET */ NOREF(aCloudNetworks); return E_NOTIMPL; #endif /* !VBOX_WITH_CLOUD_NET */ } #ifdef VBOX_WITH_CLOUD_NET HRESULT VirtualBox::i_getEventSource(ComPtr& aSource) { m->pEventSource.queryInterfaceTo(aSource.asOutParam()); return S_OK; } #endif /* VBOX_WITH_CLOUD_NET */ HRESULT VirtualBox::getCloudProviderManager(ComPtr &aCloudProviderManager) { HRESULT hrc = m->pCloudProviderManager.queryInterfaceTo(aCloudProviderManager.asOutParam()); return hrc; } HRESULT VirtualBox::checkFirmwarePresent(FirmwareType_T aFirmwareType, const com::Utf8Str &aVersion, com::Utf8Str &aUrl, com::Utf8Str &aFile, BOOL *aResult) { NOREF(aVersion); static const struct { FirmwareType_T enmType; bool fBuiltIn; const char *pszFileName; const char *pszUrl; } firmwareDesc[] = { { FirmwareType_BIOS, true, NULL, NULL }, #ifdef VBOX_WITH_EFI_IN_DD2 { FirmwareType_EFI32, true, "VBoxEFI32.fd", NULL }, { FirmwareType_EFI64, true, "VBoxEFI64.fd", NULL }, { FirmwareType_EFIDUAL, true, "VBoxEFIDual.fd", NULL }, #else { FirmwareType_EFI32, false, "VBoxEFI32.fd", "http://virtualbox.org/firmware/VBoxEFI32.fd" }, { FirmwareType_EFI64, false, "VBoxEFI64.fd", "http://virtualbox.org/firmware/VBoxEFI64.fd" }, { FirmwareType_EFIDUAL, false, "VBoxEFIDual.fd", "http://virtualbox.org/firmware/VBoxEFIDual.fd" }, #endif }; for (size_t i = 0; i < sizeof(firmwareDesc) / sizeof(firmwareDesc[0]); i++) { if (aFirmwareType != firmwareDesc[i].enmType) continue; /* compiled-in firmware */ if (firmwareDesc[i].fBuiltIn) { aFile = firmwareDesc[i].pszFileName; *aResult = TRUE; break; } Utf8Str fullName; Utf8StrFmt shortName("Firmware%c%s", RTPATH_DELIMITER, firmwareDesc[i].pszFileName); int rc = i_calculateFullPath(shortName, fullName); AssertRCReturn(rc, VBOX_E_IPRT_ERROR); if (RTFileExists(fullName.c_str())) { *aResult = TRUE; aFile = fullName; break; } char szVBoxPath[RTPATH_MAX]; rc = RTPathExecDir(szVBoxPath, RTPATH_MAX); AssertRCReturn(rc, VBOX_E_IPRT_ERROR); rc = RTPathAppend(szVBoxPath, sizeof(szVBoxPath), firmwareDesc[i].pszFileName); if (RTFileExists(szVBoxPath)) { *aResult = TRUE; aFile = szVBoxPath; break; } /** @todo account for version in the URL */ aUrl = firmwareDesc[i].pszUrl; *aResult = FALSE; /* Assume single record per firmware type */ break; } return S_OK; } // Wrapped IVirtualBox methods ///////////////////////////////////////////////////////////////////////////// /* Helper for VirtualBox::ComposeMachineFilename */ static void sanitiseMachineFilename(Utf8Str &aName); HRESULT VirtualBox::composeMachineFilename(const com::Utf8Str &aName, const com::Utf8Str &aGroup, const com::Utf8Str &aCreateFlags, const com::Utf8Str &aBaseFolder, com::Utf8Str &aFile) { if (RT_UNLIKELY(aName.isEmpty())) return setError(E_INVALIDARG, tr("Machine name is invalid, must not be empty")); Utf8Str strBase = aBaseFolder; Utf8Str strName = aName; LogFlowThisFunc(("aName=\"%s\",aBaseFolder=\"%s\"\n", strName.c_str(), strBase.c_str())); com::Guid id; bool fDirectoryIncludesUUID = false; if (!aCreateFlags.isEmpty()) { size_t uPos = 0; com::Utf8Str strKey; com::Utf8Str strValue; while ((uPos = aCreateFlags.parseKeyValue(strKey, strValue, uPos)) != com::Utf8Str::npos) { if (strKey == "UUID") id = strValue.c_str(); else if (strKey == "directoryIncludesUUID") fDirectoryIncludesUUID = (strValue == "1"); } } if (id.isZero()) fDirectoryIncludesUUID = false; else if (!id.isValid()) { /* do something else */ return setError(E_INVALIDARG, tr("'%s' is not a valid Guid"), id.toStringCurly().c_str()); } Utf8Str strGroup(aGroup); if (strGroup.isEmpty()) strGroup = "/"; HRESULT rc = i_validateMachineGroup(strGroup, true); if (FAILED(rc)) return rc; /* Compose the settings file name using the following scheme: * * //.xml * * If a non-null and non-empty base folder is specified, the default * machine folder will be used as a base folder. * We sanitise the machine name to a safe white list of characters before * using it. */ Utf8Str strDirName(strName); if (fDirectoryIncludesUUID) strDirName += Utf8StrFmt(" (%RTuuid)", id.raw()); sanitiseMachineFilename(strName); sanitiseMachineFilename(strDirName); if (strBase.isEmpty()) /* we use the non-full folder value below to keep the path relative */ i_getDefaultMachineFolder(strBase); i_calculateFullPath(strBase, strBase); /* eliminate toplevel group to avoid // in the result */ if (strGroup == "/") strGroup.setNull(); aFile = com::Utf8StrFmt("%s%s%c%s%c%s.vbox", strBase.c_str(), strGroup.c_str(), RTPATH_DELIMITER, strDirName.c_str(), RTPATH_DELIMITER, strName.c_str()); return S_OK; } /** * Remove characters from a machine file name which can be problematic on * particular systems. * @param strName The file name to sanitise. */ void sanitiseMachineFilename(Utf8Str &strName) { if (strName.isEmpty()) return; /* Set of characters which should be safe for use in filenames: some basic * ASCII, Unicode from Latin-1 alphabetic to the end of Hangul. We try to * skip anything that could count as a control character in Windows or * *nix, or be otherwise difficult for shells to handle (I would have * preferred to remove the space and brackets too). We also remove all * characters which need UTF-16 surrogate pairs for Windows's benefit. */ static RTUNICP const s_uszValidRangePairs[] = { ' ', ' ', '(', ')', '-', '.', '0', '9', 'A', 'Z', 'a', 'z', '_', '_', 0xa0, 0xd7af, '\0' }; char *pszName = strName.mutableRaw(); ssize_t cReplacements = RTStrPurgeComplementSet(pszName, s_uszValidRangePairs, '_'); Assert(cReplacements >= 0); NOREF(cReplacements); /* No leading dot or dash. */ if (pszName[0] == '.' || pszName[0] == '-') pszName[0] = '_'; /* No trailing dot. */ if (pszName[strName.length() - 1] == '.') pszName[strName.length() - 1] = '_'; /* Mangle leading and trailing spaces. */ for (size_t i = 0; pszName[i] == ' '; ++i) pszName[i] = '_'; for (size_t i = strName.length() - 1; i && pszName[i] == ' '; --i) pszName[i] = '_'; } #ifdef DEBUG typedef DECLCALLBACKTYPE(void, FNTESTPRINTF,(const char *, ...)); /** Simple unit test/operation examples for sanitiseMachineFilename(). */ static unsigned testSanitiseMachineFilename(FNTESTPRINTF *pfnPrintf) { unsigned cErrors = 0; /** Expected results of sanitising given file names. */ static struct { /** The test file name to be sanitised (Utf-8). */ const char *pcszIn; /** The expected sanitised output (Utf-8). */ const char *pcszOutExpected; } aTest[] = { { "OS/2 2.1", "OS_2 2.1" }, { "-!My VM!-", "__My VM_-" }, { "\xF0\x90\x8C\xB0", "____" }, { " My VM ", "__My VM__" }, { ".My VM.", "_My VM_" }, { "My VM", "My VM" } }; for (unsigned i = 0; i < RT_ELEMENTS(aTest); ++i) { Utf8Str str(aTest[i].pcszIn); sanitiseMachineFilename(str); if (str.compare(aTest[i].pcszOutExpected)) { ++cErrors; pfnPrintf("%s: line %d, expected %s, actual %s\n", __PRETTY_FUNCTION__, i, aTest[i].pcszOutExpected, str.c_str()); } } return cErrors; } /** @todo Proper testcase. */ /** @todo Do we have a better method of doing init functions? */ namespace { class TestSanitiseMachineFilename { public: TestSanitiseMachineFilename(void) { Assert(!testSanitiseMachineFilename(RTAssertMsg2)); } }; TestSanitiseMachineFilename s_TestSanitiseMachineFilename; } #endif /** @note Locks mSystemProperties object for reading. */ HRESULT VirtualBox::createMachine(const com::Utf8Str &aSettingsFile, const com::Utf8Str &aName, const std::vector &aGroups, const com::Utf8Str &aOsTypeId, const com::Utf8Str &aFlags, ComPtr &aMachine) { LogFlowThisFuncEnter(); LogFlowThisFunc(("aSettingsFile=\"%s\", aName=\"%s\", aOsTypeId =\"%s\", aCreateFlags=\"%s\"\n", aSettingsFile.c_str(), aName.c_str(), aOsTypeId.c_str(), aFlags.c_str())); StringsList llGroups; HRESULT rc = i_convertMachineGroups(aGroups, &llGroups); if (FAILED(rc)) return rc; /** @todo r=bird: Would be goot to rewrite this parsing using offset into * aFlags and drop all the C pointers, strchr, misguided RTStrStr and * tedious copying of substrings. */ Utf8Str strCreateFlags(aFlags); /** @todo r=bird: WTF is the point of this copy? */ Guid id; bool fForceOverwrite = false; bool fDirectoryIncludesUUID = false; if (!strCreateFlags.isEmpty()) { const char *pcszNext = strCreateFlags.c_str(); while (*pcszNext != '\0') { Utf8Str strFlag; const char *pcszComma = strchr(pcszNext, ','); /*clueless version: RTStrStr(pcszNext, ","); */ if (!pcszComma) strFlag = pcszNext; else strFlag.assign(pcszNext, (size_t)(pcszComma - pcszNext)); const char *pcszEqual = strchr(strFlag.c_str(), '='); /* more cluelessness: RTStrStr(strFlag.c_str(), "="); */ /* skip over everything which doesn't contain '=' */ if (pcszEqual && pcszEqual != strFlag.c_str()) { Utf8Str strKey(strFlag.c_str(), (size_t)(pcszEqual - strFlag.c_str())); Utf8Str strValue(strFlag.c_str() + (pcszEqual - strFlag.c_str() + 1)); if (strKey == "UUID") id = strValue.c_str(); else if (strKey == "forceOverwrite") fForceOverwrite = (strValue == "1"); else if (strKey == "directoryIncludesUUID") fDirectoryIncludesUUID = (strValue == "1"); } if (!pcszComma) pcszNext += strFlag.length(); /* you can just 'break' out here... */ else pcszNext += strFlag.length() + 1; } } /* Create UUID if none was specified. */ if (id.isZero()) id.create(); else if (!id.isValid()) { /* do something else */ return setError(E_INVALIDARG, tr("'%s' is not a valid Guid"), id.toStringCurly().c_str()); } /* NULL settings file means compose automatically */ Utf8Str strSettingsFile(aSettingsFile); if (strSettingsFile.isEmpty()) { Utf8Str strNewCreateFlags(Utf8StrFmt("UUID=%RTuuid", id.raw())); if (fDirectoryIncludesUUID) strNewCreateFlags += ",directoryIncludesUUID=1"; com::Utf8Str blstr; rc = composeMachineFilename(aName, llGroups.front(), strNewCreateFlags, blstr /* aBaseFolder */, strSettingsFile); if (FAILED(rc)) return rc; } /* create a new object */ ComObjPtr machine; rc = machine.createObject(); if (FAILED(rc)) return rc; ComObjPtr osType; if (!aOsTypeId.isEmpty()) i_findGuestOSType(aOsTypeId, osType); /* initialize the machine object */ rc = machine->init(this, strSettingsFile, aName, llGroups, aOsTypeId, osType, id, fForceOverwrite, fDirectoryIncludesUUID); if (SUCCEEDED(rc)) { /* set the return value */ machine.queryInterfaceTo(aMachine.asOutParam()); AssertComRC(rc); #ifdef VBOX_WITH_EXTPACK /* call the extension pack hooks */ m->ptrExtPackManager->i_callAllVmCreatedHooks(machine); #endif } LogFlowThisFuncLeave(); return rc; } HRESULT VirtualBox::openMachine(const com::Utf8Str &aSettingsFile, ComPtr &aMachine) { HRESULT rc = E_FAIL; /* create a new object */ ComObjPtr machine; rc = machine.createObject(); if (SUCCEEDED(rc)) { /* initialize the machine object */ rc = machine->initFromSettings(this, aSettingsFile, NULL); /* const Guid *aId */ if (SUCCEEDED(rc)) { /* set the return value */ machine.queryInterfaceTo(aMachine.asOutParam()); ComAssertComRC(rc); } } return rc; } /** @note Locks objects! */ HRESULT VirtualBox::registerMachine(const ComPtr &aMachine) { HRESULT rc; Bstr name; rc = aMachine->COMGETTER(Name)(name.asOutParam()); if (FAILED(rc)) return rc; /* We can safely cast child to Machine * here because only Machine * implementations of IMachine can be among our children. */ IMachine *aM = aMachine; Machine *pMachine = static_cast(aM); AutoCaller machCaller(pMachine); ComAssertComRCRetRC(machCaller.rc()); rc = i_registerMachine(pMachine); /* fire an event */ if (SUCCEEDED(rc)) i_onMachineRegistered(pMachine->i_getId(), TRUE); return rc; } /** @note Locks this object for reading, then some machine objects for reading. */ HRESULT VirtualBox::findMachine(const com::Utf8Str &aSettingsFile, ComPtr &aMachine) { LogFlowThisFuncEnter(); LogFlowThisFunc(("aSettingsFile=\"%s\", aMachine={%p}\n", aSettingsFile.c_str(), &aMachine)); /* start with not found */ HRESULT rc = S_OK; ComObjPtr pMachineFound; Guid id(aSettingsFile); Utf8Str strFile(aSettingsFile); if (id.isValid() && !id.isZero()) rc = i_findMachine(id, true /* fPermitInaccessible */, true /* setError */, &pMachineFound); // returns VBOX_E_OBJECT_NOT_FOUND if not found and sets error else { rc = i_findMachineByName(strFile, true /* setError */, &pMachineFound); // returns VBOX_E_OBJECT_NOT_FOUND if not found and sets error } /* this will set (*machine) to NULL if machineObj is null */ pMachineFound.queryInterfaceTo(aMachine.asOutParam()); LogFlowThisFunc(("aName=\"%s\", aMachine=%p, rc=%08X\n", aSettingsFile.c_str(), &aMachine, rc)); LogFlowThisFuncLeave(); return rc; } HRESULT VirtualBox::getMachinesByGroups(const std::vector &aGroups, std::vector > &aMachines) { StringsList llGroups; HRESULT rc = i_convertMachineGroups(aGroups, &llGroups); if (FAILED(rc)) return rc; /* we want to rely on sorted groups during compare, to save time */ llGroups.sort(); /* get copy of all machine references, to avoid holding the list lock */ MachinesOList::MyList allMachines; AutoReadLock al(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); allMachines = m->allMachines.getList(); std::vector > saMachines; saMachines.resize(0); for (MachinesOList::MyList::const_iterator it = allMachines.begin(); it != allMachines.end(); ++it) { const ComObjPtr &pMachine = *it; AutoCaller autoMachineCaller(pMachine); if (FAILED(autoMachineCaller.rc())) continue; AutoReadLock mlock(pMachine COMMA_LOCKVAL_SRC_POS); if (pMachine->i_isAccessible()) { const StringsList &thisGroups = pMachine->i_getGroups(); for (StringsList::const_iterator it2 = thisGroups.begin(); it2 != thisGroups.end(); ++it2) { const Utf8Str &group = *it2; bool fAppended = false; for (StringsList::const_iterator it3 = llGroups.begin(); it3 != llGroups.end(); ++it3) { int order = it3->compare(group); if (order == 0) { saMachines.push_back(static_cast(pMachine)); fAppended = true; break; } else if (order > 0) break; else continue; } /* avoid duplicates and save time */ if (fAppended) break; } } } aMachines.resize(saMachines.size()); size_t i = 0; for(i = 0; i < saMachines.size(); ++i) saMachines[i].queryInterfaceTo(aMachines[i].asOutParam()); return S_OK; } HRESULT VirtualBox::getMachineStates(const std::vector > &aMachines, std::vector &aStates) { com::SafeIfaceArray saMachines(aMachines); aStates.resize(aMachines.size()); for (size_t i = 0; i < saMachines.size(); i++) { ComPtr pMachine = saMachines[i]; MachineState_T state = MachineState_Null; if (!pMachine.isNull()) { HRESULT rc = pMachine->COMGETTER(State)(&state); if (rc == E_ACCESSDENIED) rc = S_OK; AssertComRC(rc); } aStates[i] = state; } return S_OK; } HRESULT VirtualBox::createUnattendedInstaller(ComPtr &aUnattended) { #ifdef VBOX_WITH_UNATTENDED ComObjPtr ptrUnattended; HRESULT hrc = ptrUnattended.createObject(); if (SUCCEEDED(hrc)) { AutoReadLock wlock(this COMMA_LOCKVAL_SRC_POS); hrc = ptrUnattended->initUnattended(this); if (SUCCEEDED(hrc)) hrc = ptrUnattended.queryInterfaceTo(aUnattended.asOutParam()); } return hrc; #else NOREF(aUnattended); return E_NOTIMPL; #endif } HRESULT VirtualBox::createMedium(const com::Utf8Str &aFormat, const com::Utf8Str &aLocation, AccessMode_T aAccessMode, DeviceType_T aDeviceType, ComPtr &aMedium) { NOREF(aAccessMode); /**< @todo r=klaus make use of access mode */ HRESULT rc = S_OK; ComObjPtr medium; medium.createObject(); com::Utf8Str format = aFormat; switch (aDeviceType) { case DeviceType_HardDisk: { /* we don't access non-const data members so no need to lock */ if (format.isEmpty()) i_getDefaultHardDiskFormat(format); rc = medium->init(this, format, aLocation, Guid::Empty /* media registry: none yet */, aDeviceType); } break; case DeviceType_DVD: case DeviceType_Floppy: { if (format.isEmpty()) return setError(E_INVALIDARG, "Format must be Valid Type%s", format.c_str()); // enforce read-only for DVDs even if caller specified ReadWrite if (aDeviceType == DeviceType_DVD) aAccessMode = AccessMode_ReadOnly; rc = medium->init(this, format, aLocation, Guid::Empty /* media registry: none yet */, aDeviceType); } break; default: return setError(E_INVALIDARG, "Device type must be HardDisk, DVD or Floppy %d", aDeviceType); } if (SUCCEEDED(rc)) { medium.queryInterfaceTo(aMedium.asOutParam()); com::Guid uMediumId = medium->i_getId(); if (uMediumId.isValid() && !uMediumId.isZero()) i_onMediumRegistered(uMediumId, medium->i_getDeviceType(), TRUE); } return rc; } HRESULT VirtualBox::openMedium(const com::Utf8Str &aLocation, DeviceType_T aDeviceType, AccessMode_T aAccessMode, BOOL aForceNewUuid, ComPtr &aMedium) { HRESULT rc = S_OK; Guid id(aLocation); ComObjPtr pMedium; // have to get write lock as the whole find/update sequence must be done // in one critical section, otherwise there are races which can lead to // multiple Medium objects with the same content AutoWriteLock treeLock(i_getMediaTreeLockHandle() COMMA_LOCKVAL_SRC_POS); // check if the device type is correct, and see if a medium for the // given path has already initialized; if so, return that switch (aDeviceType) { case DeviceType_HardDisk: if (id.isValid() && !id.isZero()) rc = i_findHardDiskById(id, false /* setError */, &pMedium); else rc = i_findHardDiskByLocation(aLocation, false, /* aSetError */ &pMedium); break; case DeviceType_Floppy: case DeviceType_DVD: if (id.isValid() && !id.isZero()) rc = i_findDVDOrFloppyImage(aDeviceType, &id, Utf8Str::Empty, false /* setError */, &pMedium); else rc = i_findDVDOrFloppyImage(aDeviceType, NULL, aLocation, false /* setError */, &pMedium); // enforce read-only for DVDs even if caller specified ReadWrite if (aDeviceType == DeviceType_DVD) aAccessMode = AccessMode_ReadOnly; break; default: return setError(E_INVALIDARG, "Device type must be HardDisk, DVD or Floppy %d", aDeviceType); } bool fMediumRegistered = false; if (pMedium.isNull()) { pMedium.createObject(); treeLock.release(); rc = pMedium->init(this, aLocation, (aAccessMode == AccessMode_ReadWrite) ? Medium::OpenReadWrite : Medium::OpenReadOnly, !!aForceNewUuid, aDeviceType); treeLock.acquire(); if (SUCCEEDED(rc)) { rc = i_registerMedium(pMedium, &pMedium, treeLock); treeLock.release(); /* Note that it's important to call uninit() on failure to register * because the differencing hard disk would have been already associated * with the parent and this association needs to be broken. */ if (FAILED(rc)) { pMedium->uninit(); rc = VBOX_E_OBJECT_NOT_FOUND; } else { fMediumRegistered = true; } } else { if (rc != VBOX_E_INVALID_OBJECT_STATE) rc = VBOX_E_OBJECT_NOT_FOUND; } } if (SUCCEEDED(rc)) { pMedium.queryInterfaceTo(aMedium.asOutParam()); if (fMediumRegistered) i_onMediumRegistered(pMedium->i_getId(), pMedium->i_getDeviceType() ,TRUE); } return rc; } /** @note Locks this object for reading. */ HRESULT VirtualBox::getGuestOSType(const com::Utf8Str &aId, ComPtr &aType) { ComObjPtr pType; HRESULT rc = i_findGuestOSType(aId, pType); pType.queryInterfaceTo(aType.asOutParam()); return rc; } HRESULT VirtualBox::createSharedFolder(const com::Utf8Str &aName, const com::Utf8Str &aHostPath, BOOL aWritable, BOOL aAutomount, const com::Utf8Str &aAutoMountPoint) { NOREF(aName); NOREF(aHostPath); NOREF(aWritable); NOREF(aAutomount); NOREF(aAutoMountPoint); return setError(E_NOTIMPL, "Not yet implemented"); } HRESULT VirtualBox::removeSharedFolder(const com::Utf8Str &aName) { NOREF(aName); return setError(E_NOTIMPL, "Not yet implemented"); } /** * @note Locks this object for reading. */ HRESULT VirtualBox::getExtraDataKeys(std::vector &aKeys) { using namespace settings; AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS); aKeys.resize(m->pMainConfigFile->mapExtraDataItems.size()); size_t i = 0; for (StringsMap::const_iterator it = m->pMainConfigFile->mapExtraDataItems.begin(); it != m->pMainConfigFile->mapExtraDataItems.end(); ++it, ++i) aKeys[i] = it->first; return S_OK; } /** * @note Locks this object for reading. */ HRESULT VirtualBox::getExtraData(const com::Utf8Str &aKey, com::Utf8Str &aValue) { settings::StringsMap::const_iterator it = m->pMainConfigFile->mapExtraDataItems.find(aKey); if (it != m->pMainConfigFile->mapExtraDataItems.end()) // found: aValue = it->second; // source is a Utf8Str /* return the result to caller (may be empty) */ return S_OK; } /** * @note Locks this object for writing. */ HRESULT VirtualBox::setExtraData(const com::Utf8Str &aKey, const com::Utf8Str &aValue) { Utf8Str strKey(aKey); Utf8Str strValue(aValue); Utf8Str strOldValue; // empty HRESULT rc = S_OK; /* Because control characters in aKey have caused problems in the settings * they are rejected unless the key should be deleted. */ if (!strValue.isEmpty()) { for (size_t i = 0; i < strKey.length(); ++i) { char ch = strKey[i]; if (RTLocCIsCntrl(ch)) return E_INVALIDARG; } } // locking note: we only hold the read lock briefly to look up the old value, // then release it and call the onExtraCanChange callbacks. There is a small // chance of a race insofar as the callback might be called twice if two callers // change the same key at the same time, but that's a much better solution // than the deadlock we had here before. The actual changing of the extradata // is then performed under the write lock and race-free. // look up the old value first; if nothing has changed then we need not do anything { AutoReadLock alock(this COMMA_LOCKVAL_SRC_POS); // hold read lock only while looking up settings::StringsMap::const_iterator it = m->pMainConfigFile->mapExtraDataItems.find(strKey); if (it != m->pMainConfigFile->mapExtraDataItems.end()) strOldValue = it->second; } bool fChanged; if ((fChanged = (strOldValue != strValue))) { // ask for permission from all listeners outside the locks; // onExtraDataCanChange() only briefly requests the VirtualBox // lock to copy the list of callbacks to invoke Bstr error; if (!i_onExtraDataCanChange(Guid::Empty, Bstr(aKey).raw(), Bstr(aValue).raw(), error)) { const char *sep = error.isEmpty() ? "" : ": "; Log1WarningFunc(("Someone vetoed! Change refused%s%ls\n", sep, error.raw())); return setError(E_ACCESSDENIED, tr("Could not set extra data because someone refused the requested change of '%s' to '%s'%s%ls"), strKey.c_str(), strValue.c_str(), sep, error.raw()); } // data is changing and change not vetoed: then write it out under the lock AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS); if (strValue.isEmpty()) m->pMainConfigFile->mapExtraDataItems.erase(strKey); else m->pMainConfigFile->mapExtraDataItems[strKey] = strValue; // creates a new key if needed /* save settings on success */ rc = i_saveSettings(); if (FAILED(rc)) return rc; } // fire notification outside the lock if (fChanged) i_onExtraDataChanged(Guid::Empty, Bstr(aKey).raw(), Bstr(aValue).raw()); return rc; } /** * */ HRESULT VirtualBox::setSettingsSecret(const com::Utf8Str &aPassword) { i_storeSettingsKey(aPassword); i_decryptSettings(); return S_OK; } int VirtualBox::i_decryptMediumSettings(Medium *pMedium) { Bstr bstrCipher; HRESULT hrc = pMedium->GetProperty(Bstr("InitiatorSecretEncrypted").raw(), bstrCipher.asOutParam()); if (SUCCEEDED(hrc)) { Utf8Str strPlaintext; int rc = i_decryptSetting(&strPlaintext, bstrCipher); if (RT_SUCCESS(rc)) pMedium->i_setPropertyDirect("InitiatorSecret", strPlaintext); else return rc; } return VINF_SUCCESS; } /** * Decrypt all encrypted settings. * * So far we only have encrypted iSCSI initiator secrets so we just go through * all hard disk mediums and determine the plain 'InitiatorSecret' from * 'InitiatorSecretEncrypted. The latter is stored as Base64 because medium * properties need to be null-terminated strings. */ int VirtualBox::i_decryptSettings() { bool fFailure = false; AutoReadLock al(m->allHardDisks.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (MediaList::const_iterator mt = m->allHardDisks.begin(); mt != m->allHardDisks.end(); ++mt) { ComObjPtr pMedium = *mt; AutoCaller medCaller(pMedium); if (FAILED(medCaller.rc())) continue; AutoWriteLock mlock(pMedium COMMA_LOCKVAL_SRC_POS); int vrc = i_decryptMediumSettings(pMedium); if (RT_FAILURE(vrc)) fFailure = true; } if (!fFailure) { for (MediaList::const_iterator mt = m->allHardDisks.begin(); mt != m->allHardDisks.end(); ++mt) { i_onMediumConfigChanged(*mt); } } return fFailure ? VERR_INVALID_PARAMETER : VINF_SUCCESS; } /** * Encode. * * @param aPlaintext plaintext to be encrypted * @param aCiphertext resulting ciphertext (base64-encoded) */ int VirtualBox::i_encryptSetting(const Utf8Str &aPlaintext, Utf8Str *aCiphertext) { uint8_t abCiphertext[32]; char szCipherBase64[128]; size_t cchCipherBase64; int rc = i_encryptSettingBytes((uint8_t*)aPlaintext.c_str(), abCiphertext, aPlaintext.length()+1, sizeof(abCiphertext)); if (RT_SUCCESS(rc)) { rc = RTBase64Encode(abCiphertext, sizeof(abCiphertext), szCipherBase64, sizeof(szCipherBase64), &cchCipherBase64); if (RT_SUCCESS(rc)) *aCiphertext = szCipherBase64; } return rc; } /** * Decode. * * @param aPlaintext resulting plaintext * @param aCiphertext ciphertext (base64-encoded) to decrypt */ int VirtualBox::i_decryptSetting(Utf8Str *aPlaintext, const Utf8Str &aCiphertext) { uint8_t abPlaintext[64]; uint8_t abCiphertext[64]; size_t cbCiphertext; int rc = RTBase64Decode(aCiphertext.c_str(), abCiphertext, sizeof(abCiphertext), &cbCiphertext, NULL); if (RT_SUCCESS(rc)) { rc = i_decryptSettingBytes(abPlaintext, abCiphertext, cbCiphertext); if (RT_SUCCESS(rc)) { for (unsigned i = 0; i < cbCiphertext; i++) { /* sanity check: null-terminated string? */ if (abPlaintext[i] == '\0') { /* sanity check: valid UTF8 string? */ if (RTStrIsValidEncoding((const char*)abPlaintext)) { *aPlaintext = Utf8Str((const char*)abPlaintext); return VINF_SUCCESS; } } } rc = VERR_INVALID_MAGIC; } } return rc; } /** * Encrypt secret bytes. Use the m->SettingsCipherKey as key. * * @param aPlaintext clear text to be encrypted * @param aCiphertext resulting encrypted text * @param aPlaintextSize size of the plaintext * @param aCiphertextSize size of the ciphertext */ int VirtualBox::i_encryptSettingBytes(const uint8_t *aPlaintext, uint8_t *aCiphertext, size_t aPlaintextSize, size_t aCiphertextSize) const { unsigned i, j; uint8_t aBytes[64]; if (!m->fSettingsCipherKeySet) return VERR_INVALID_STATE; if (aCiphertextSize > sizeof(aBytes)) return VERR_BUFFER_OVERFLOW; if (aCiphertextSize < 32) return VERR_INVALID_PARAMETER; AssertCompile(sizeof(m->SettingsCipherKey) >= 32); /* store the first 8 bytes of the cipherkey for verification */ for (i = 0, j = 0; i < 8; i++, j++) aCiphertext[i] = m->SettingsCipherKey[j]; for (unsigned k = 0; k < aPlaintextSize && i < aCiphertextSize; i++, k++) { aCiphertext[i] = (aPlaintext[k] ^ m->SettingsCipherKey[j]); if (++j >= sizeof(m->SettingsCipherKey)) j = 0; } /* fill with random data to have a minimal length (salt) */ if (i < aCiphertextSize) { RTRandBytes(aBytes, aCiphertextSize - i); for (int k = 0; i < aCiphertextSize; i++, k++) { aCiphertext[i] = aBytes[k] ^ m->SettingsCipherKey[j]; if (++j >= sizeof(m->SettingsCipherKey)) j = 0; } } return VINF_SUCCESS; } /** * Decrypt secret bytes. Use the m->SettingsCipherKey as key. * * @param aPlaintext resulting plaintext * @param aCiphertext ciphertext to be decrypted * @param aCiphertextSize size of the ciphertext == size of the plaintext */ int VirtualBox::i_decryptSettingBytes(uint8_t *aPlaintext, const uint8_t *aCiphertext, size_t aCiphertextSize) const { unsigned i, j; if (!m->fSettingsCipherKeySet) return VERR_INVALID_STATE; if (aCiphertextSize < 32) return VERR_INVALID_PARAMETER; /* key verification */ for (i = 0, j = 0; i < 8; i++, j++) if (aCiphertext[i] != m->SettingsCipherKey[j]) return VERR_INVALID_MAGIC; /* poison */ memset(aPlaintext, 0xff, aCiphertextSize); for (int k = 0; i < aCiphertextSize; i++, k++) { aPlaintext[k] = aCiphertext[i] ^ m->SettingsCipherKey[j]; if (++j >= sizeof(m->SettingsCipherKey)) j = 0; } return VINF_SUCCESS; } /** * Store a settings key. * * @param aKey the key to store */ void VirtualBox::i_storeSettingsKey(const Utf8Str &aKey) { RTSha512(aKey.c_str(), aKey.length(), m->SettingsCipherKey); m->fSettingsCipherKeySet = true; } // public methods only for internal purposes ///////////////////////////////////////////////////////////////////////////// #ifdef DEBUG void VirtualBox::i_dumpAllBackRefs() { { AutoReadLock al(m->allHardDisks.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (MediaList::const_iterator mt = m->allHardDisks.begin(); mt != m->allHardDisks.end(); ++mt) { ComObjPtr pMedium = *mt; pMedium->i_dumpBackRefs(); } } { AutoReadLock al(m->allDVDImages.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (MediaList::const_iterator mt = m->allDVDImages.begin(); mt != m->allDVDImages.end(); ++mt) { ComObjPtr pMedium = *mt; pMedium->i_dumpBackRefs(); } } } #endif /** * Posts an event to the event queue that is processed asynchronously * on a dedicated thread. * * Posting events to the dedicated event queue is useful to perform secondary * actions outside any object locks -- for example, to iterate over a list * of callbacks and inform them about some change caused by some object's * method call. * * @param event event to post; must have been allocated using |new|, will * be deleted automatically by the event thread after processing * * @note Doesn't lock any object. */ HRESULT VirtualBox::i_postEvent(Event *event) { AssertReturn(event, E_FAIL); HRESULT rc; AutoCaller autoCaller(this); if (SUCCEEDED((rc = autoCaller.rc()))) { if (getObjectState().getState() != ObjectState::Ready) Log1WarningFunc(("VirtualBox has been uninitialized (state=%d), the event is discarded!\n", getObjectState().getState())); // return S_OK else if ( (m->pAsyncEventQ) && (m->pAsyncEventQ->postEvent(event)) ) return S_OK; else rc = E_FAIL; } // in any event of failure, we must clean up here, or we'll leak; // the caller has allocated the object using new() delete event; return rc; } /** * Adds a progress to the global collection of pending operations. * Usually gets called upon progress object initialization. * * @param aProgress Operation to add to the collection. * * @note Doesn't lock objects. */ HRESULT VirtualBox::i_addProgress(IProgress *aProgress) { CheckComArgNotNull(aProgress); AutoCaller autoCaller(this); if (FAILED(autoCaller.rc())) return autoCaller.rc(); Bstr id; HRESULT rc = aProgress->COMGETTER(Id)(id.asOutParam()); AssertComRCReturnRC(rc); /* protect mProgressOperations */ AutoWriteLock safeLock(m->mtxProgressOperations COMMA_LOCKVAL_SRC_POS); m->mapProgressOperations.insert(ProgressMap::value_type(Guid(id), aProgress)); return S_OK; } /** * Removes the progress from the global collection of pending operations. * Usually gets called upon progress completion. * * @param aId UUID of the progress operation to remove * * @note Doesn't lock objects. */ HRESULT VirtualBox::i_removeProgress(IN_GUID aId) { AutoCaller autoCaller(this); if (FAILED(autoCaller.rc())) return autoCaller.rc(); ComPtr progress; /* protect mProgressOperations */ AutoWriteLock safeLock(m->mtxProgressOperations COMMA_LOCKVAL_SRC_POS); size_t cnt = m->mapProgressOperations.erase(aId); Assert(cnt == 1); NOREF(cnt); return S_OK; } #ifdef RT_OS_WINDOWS class StartSVCHelperClientData : public ThreadTask { public: StartSVCHelperClientData() { LogFlowFuncEnter(); m_strTaskName = "SVCHelper"; threadVoidData = NULL; initialized = false; } virtual ~StartSVCHelperClientData() { LogFlowFuncEnter(); if (threadVoidData!=NULL) { delete threadVoidData; threadVoidData=NULL; } }; void handler() { VirtualBox::i_SVCHelperClientThreadTask(this); } const ComPtr& GetProgressObject() const {return progress;} bool init(VirtualBox* aVbox, Progress* aProgress, bool aPrivileged, VirtualBox::SVCHelperClientFunc aFunc, void *aUser) { LogFlowFuncEnter(); that = aVbox; progress = aProgress; privileged = aPrivileged; func = aFunc; user = aUser; initThreadVoidData(); initialized = true; return initialized; } bool isOk() const{ return initialized;} bool initialized; ComObjPtr that; ComObjPtr progress; bool privileged; VirtualBox::SVCHelperClientFunc func; void *user; ThreadVoidData *threadVoidData; private: bool initThreadVoidData() { LogFlowFuncEnter(); threadVoidData = static_cast(user); return true; } }; /** * Helper method that starts a worker thread that: * - creates a pipe communication channel using SVCHlpClient; * - starts an SVC Helper process that will inherit this channel; * - executes the supplied function by passing it the created SVCHlpClient * and opened instance to communicate to the Helper process and the given * Progress object. * * The user function is supposed to communicate to the helper process * using the \a aClient argument to do the requested job and optionally expose * the progress through the \a aProgress object. The user function should never * call notifyComplete() on it: this will be done automatically using the * result code returned by the function. * * Before the user function is started, the communication channel passed to * the \a aClient argument is fully set up, the function should start using * its write() and read() methods directly. * * The \a aVrc parameter of the user function may be used to return an error * code if it is related to communication errors (for example, returned by * the SVCHlpClient members when they fail). In this case, the correct error * message using this value will be reported to the caller. Note that the * value of \a aVrc is inspected only if the user function itself returns * success. * * If a failure happens anywhere before the user function would be normally * called, it will be called anyway in special "cleanup only" mode indicated * by \a aClient, \a aProgress and \a aVrc arguments set to NULL. In this mode, * all the function is supposed to do is to cleanup its aUser argument if * necessary (it's assumed that the ownership of this argument is passed to * the user function once #startSVCHelperClient() returns a success, thus * making it responsible for the cleanup). * * After the user function returns, the thread will send the SVCHlpMsg::Null * message to indicate a process termination. * * @param aPrivileged |true| to start the SVC Helper process as a privileged * user that can perform administrative tasks * @param aFunc user function to run * @param aUser argument to the user function * @param aProgress progress object that will track operation completion * * @note aPrivileged is currently ignored (due to some unsolved problems in * Vista) and the process will be started as a normal (unprivileged) * process. * * @note Doesn't lock anything. */ HRESULT VirtualBox::i_startSVCHelperClient(bool aPrivileged, SVCHelperClientFunc aFunc, void *aUser, Progress *aProgress) { LogFlowFuncEnter(); AssertReturn(aFunc, E_POINTER); AssertReturn(aProgress, E_POINTER); AutoCaller autoCaller(this); if (FAILED(autoCaller.rc())) return autoCaller.rc(); /* create the i_SVCHelperClientThreadTask() argument */ HRESULT hr = S_OK; StartSVCHelperClientData *pTask = NULL; try { pTask = new StartSVCHelperClientData(); pTask->init(this, aProgress, aPrivileged, aFunc, aUser); if (!pTask->isOk()) { delete pTask; LogRel(("Could not init StartSVCHelperClientData object \n")); throw E_FAIL; } //this function delete pTask in case of exceptions, so there is no need in the call of delete operator hr = pTask->createThreadWithType(RTTHREADTYPE_MAIN_WORKER); } catch(std::bad_alloc &) { hr = setError(E_OUTOFMEMORY); } catch(...) { LogRel(("Could not create thread for StartSVCHelperClientData \n")); hr = E_FAIL; } return hr; } /** * Worker thread for startSVCHelperClient(). */ /* static */ void VirtualBox::i_SVCHelperClientThreadTask(StartSVCHelperClientData *pTask) { LogFlowFuncEnter(); HRESULT rc = S_OK; bool userFuncCalled = false; do { AssertBreakStmt(pTask, rc = E_POINTER); AssertReturnVoid(!pTask->progress.isNull()); /* protect VirtualBox from uninitialization */ AutoCaller autoCaller(pTask->that); if (!autoCaller.isOk()) { /* it's too late */ rc = autoCaller.rc(); break; } int vrc = VINF_SUCCESS; Guid id; id.create(); SVCHlpClient client; vrc = client.create(Utf8StrFmt("VirtualBox\\SVCHelper\\{%RTuuid}", id.raw()).c_str()); if (RT_FAILURE(vrc)) { rc = pTask->that->setErrorBoth(E_FAIL, vrc, tr("Could not create the communication channel (%Rrc)"), vrc); break; } /* get the path to the executable */ char exePathBuf[RTPATH_MAX]; char *exePath = RTProcGetExecutablePath(exePathBuf, RTPATH_MAX); if (!exePath) { rc = pTask->that->setError(E_FAIL, tr("Cannot get executable name")); break; } Utf8Str argsStr = Utf8StrFmt("/Helper %s", client.name().c_str()); LogFlowFunc(("Starting '\"%s\" %s'...\n", exePath, argsStr.c_str())); RTPROCESS pid = NIL_RTPROCESS; if (pTask->privileged) { /* Attempt to start a privileged process using the Run As dialog */ Bstr file = exePath; Bstr parameters = argsStr; SHELLEXECUTEINFO shExecInfo; shExecInfo.cbSize = sizeof(SHELLEXECUTEINFO); shExecInfo.fMask = NULL; shExecInfo.hwnd = NULL; shExecInfo.lpVerb = L"runas"; shExecInfo.lpFile = file.raw(); shExecInfo.lpParameters = parameters.raw(); shExecInfo.lpDirectory = NULL; shExecInfo.nShow = SW_NORMAL; shExecInfo.hInstApp = NULL; if (!ShellExecuteEx(&shExecInfo)) { int vrc2 = RTErrConvertFromWin32(GetLastError()); /* hide excessive details in case of a frequent error * (pressing the Cancel button to close the Run As dialog) */ if (vrc2 == VERR_CANCELLED) rc = pTask->that->setErrorBoth(E_FAIL, vrc, tr("Operation canceled by the user")); else rc = pTask->that->setErrorBoth(E_FAIL, vrc, tr("Could not launch a privileged process '%s' (%Rrc)"), exePath, vrc2); break; } } else { const char *args[] = { exePath, "/Helper", client.name().c_str(), 0 }; vrc = RTProcCreate(exePath, args, RTENV_DEFAULT, 0, &pid); if (RT_FAILURE(vrc)) { rc = pTask->that->setErrorBoth(E_FAIL, vrc, tr("Could not launch a process '%s' (%Rrc)"), exePath, vrc); break; } } /* wait for the client to connect */ vrc = client.connect(); if (RT_SUCCESS(vrc)) { /* start the user supplied function */ rc = pTask->func(&client, pTask->progress, pTask->user, &vrc); userFuncCalled = true; } /* send the termination signal to the process anyway */ { int vrc2 = client.write(SVCHlpMsg::Null); if (RT_SUCCESS(vrc)) vrc = vrc2; } if (SUCCEEDED(rc) && RT_FAILURE(vrc)) { rc = pTask->that->setErrorBoth(E_FAIL, vrc, tr("Could not operate the communication channel (%Rrc)"), vrc); break; } } while (0); if (FAILED(rc) && !userFuncCalled) { /* call the user function in the "cleanup only" mode * to let it free resources passed to in aUser */ pTask->func(NULL, NULL, pTask->user, NULL); } pTask->progress->i_notifyComplete(rc); LogFlowFuncLeave(); } #endif /* RT_OS_WINDOWS */ /** * Sends a signal to the client watcher to rescan the set of machines * that have open sessions. * * @note Doesn't lock anything. */ void VirtualBox::i_updateClientWatcher() { AutoCaller autoCaller(this); AssertComRCReturnVoid(autoCaller.rc()); AssertPtrReturnVoid(m->pClientWatcher); m->pClientWatcher->update(); } /** * Adds the given child process ID to the list of processes to be reaped. * This call should be followed by #i_updateClientWatcher() to take the effect. * * @note Doesn't lock anything. */ void VirtualBox::i_addProcessToReap(RTPROCESS pid) { AutoCaller autoCaller(this); AssertComRCReturnVoid(autoCaller.rc()); AssertPtrReturnVoid(m->pClientWatcher); m->pClientWatcher->addProcess(pid); } /** * VD plugin load */ int VirtualBox::i_loadVDPlugin(const char *pszPluginLibrary) { return m->pSystemProperties->i_loadVDPlugin(pszPluginLibrary); } /** * VD plugin unload */ int VirtualBox::i_unloadVDPlugin(const char *pszPluginLibrary) { return m->pSystemProperties->i_unloadVDPlugin(pszPluginLibrary); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onMediumRegistered(const Guid &aMediumId, const DeviceType_T aDevType, const BOOL aRegistered) { ComPtr ptrEvent; HRESULT hrc = ::CreateMediumRegisteredEvent(ptrEvent.asOutParam(), m->pEventSource, aMediumId.toString(), aDevType, aRegistered); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } void VirtualBox::i_onMediumConfigChanged(IMedium *aMedium) { ComPtr ptrEvent; HRESULT hrc = ::CreateMediumConfigChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aMedium); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } void VirtualBox::i_onMediumChanged(IMediumAttachment *aMediumAttachment) { ComPtr ptrEvent; HRESULT hrc = ::CreateMediumChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aMediumAttachment); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onStorageControllerChanged(const Guid &aMachineId, const com::Utf8Str &aControllerName) { ComPtr ptrEvent; HRESULT hrc = ::CreateStorageControllerChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aMachineId.toString(), aControllerName); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } void VirtualBox::i_onStorageDeviceChanged(IMediumAttachment *aStorageDevice, const BOOL fRemoved, const BOOL fSilent) { ComPtr ptrEvent; HRESULT hrc = ::CreateStorageDeviceChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aStorageDevice, fRemoved, fSilent); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onMachineStateChanged(const Guid &aId, MachineState_T aState) { ComPtr ptrEvent; HRESULT hrc = ::CreateMachineStateChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aId.toString(), aState); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onMachineDataChanged(const Guid &aId, BOOL aTemporary) { ComPtr ptrEvent; HRESULT hrc = ::CreateMachineDataChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aId.toString(), aTemporary); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Locks this object for reading. */ BOOL VirtualBox::i_onExtraDataCanChange(const Guid &aId, const Utf8Str &aKey, const Utf8Str &aValue, Bstr &aError) { LogFlowThisFunc(("machine={%RTuuid} aKey={%s} aValue={%s}\n", aId.raw(), aKey.c_str(), aValue.c_str())); AutoCaller autoCaller(this); AssertComRCReturn(autoCaller.rc(), FALSE); ComPtr ptrEvent; HRESULT hrc = ::CreateExtraDataCanChangeEvent(ptrEvent.asOutParam(), m->pEventSource, aId.toString(), aKey, aValue); AssertComRCReturn(hrc, TRUE); VBoxEventDesc EvtDesc(ptrEvent, m->pEventSource); BOOL fDelivered = EvtDesc.fire(3000); /* Wait up to 3 secs for delivery */ //Assert(fDelivered); BOOL fAllowChange = TRUE; if (fDelivered) { ComPtr ptrCanChangeEvent = ptrEvent; Assert(ptrCanChangeEvent); BOOL fVetoed = FALSE; ptrCanChangeEvent->IsVetoed(&fVetoed); fAllowChange = !fVetoed; if (!fAllowChange) { SafeArray aVetos; ptrCanChangeEvent->GetVetos(ComSafeArrayAsOutParam(aVetos)); if (aVetos.size() > 0) aError = aVetos[0]; } } LogFlowThisFunc(("fAllowChange=%RTbool\n", fAllowChange)); return fAllowChange; } /** * @note Doesn't lock any object. */ void VirtualBox::i_onExtraDataChanged(const Guid &aId, const Utf8Str &aKey, const Utf8Str &aValue) { ComPtr ptrEvent; HRESULT hrc = ::CreateExtraDataChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aId.toString(), aKey, aValue); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onMachineRegistered(const Guid &aId, BOOL aRegistered) { ComPtr ptrEvent; HRESULT hrc = ::CreateMachineRegisteredEvent(ptrEvent.asOutParam(), m->pEventSource, aId.toString(), aRegistered); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onSessionStateChanged(const Guid &aId, SessionState_T aState) { ComPtr ptrEvent; HRESULT hrc = ::CreateSessionStateChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aId.toString(), aState); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onSnapshotTaken(const Guid &aMachineId, const Guid &aSnapshotId) { ComPtr ptrEvent; HRESULT hrc = ::CreateSnapshotTakenEvent(ptrEvent.asOutParam(), m->pEventSource, aMachineId.toString(), aSnapshotId.toString()); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onSnapshotDeleted(const Guid &aMachineId, const Guid &aSnapshotId) { ComPtr ptrEvent; HRESULT hrc = ::CreateSnapshotDeletedEvent(ptrEvent.asOutParam(), m->pEventSource, aMachineId.toString(), aSnapshotId.toString()); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onSnapshotRestored(const Guid &aMachineId, const Guid &aSnapshotId) { ComPtr ptrEvent; HRESULT hrc = ::CreateSnapshotRestoredEvent(ptrEvent.asOutParam(), m->pEventSource, aMachineId.toString(), aSnapshotId.toString()); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onSnapshotChanged(const Guid &aMachineId, const Guid &aSnapshotId) { ComPtr ptrEvent; HRESULT hrc = ::CreateSnapshotChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aMachineId.toString(), aSnapshotId.toString()); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } #ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS /** @todo r=bird: Why is this still here? */ /** * Generates a new clipboard area on the host by opening (and locking) a new, temporary directory. * * @returns VBox status code. * @param uAreaID Clipboard area ID to use for creation. * @param fFlags Additional creation flags; currently unused and ignored. * @param ppAreaData Where to return the created clipboard area on success. */ int VirtualBox::i_clipboardAreaCreate(ULONG uAreaID, uint32_t fFlags, SharedClipboardAreaData **ppAreaData) { RT_NOREF(fFlags); int vrc; SharedClipboardAreaData *pAreaData = new SharedClipboardAreaData(); if (pAreaData) { vrc = pAreaData->Area.OpenTemp(uAreaID, SHCLAREA_OPEN_FLAGS_MUST_NOT_EXIST); if (RT_SUCCESS(vrc)) { pAreaData->uID = uAreaID; *ppAreaData = pAreaData; } } else vrc = VERR_NO_MEMORY; LogFlowFunc(("uID=%RU32, rc=%Rrc\n", uAreaID, vrc)); return vrc; } /** * Destroys a formerly created clipboard area. * * @returns VBox status code. * @param pAreaData Area data to destroy. The pointer will be invalid on successful return. */ int VirtualBox::i_clipboardAreaDestroy(SharedClipboardAreaData *pAreaData) { if (!pAreaData) return VINF_SUCCESS; /** @todo Do we need a worker for this to not block here for too long? * This could take a while to clean up huge areas ... */ int vrc = pAreaData->Area.Close(); if (RT_SUCCESS(vrc)) { delete pAreaData; pAreaData = NULL; } LogFlowFunc(("uID=%RU32, rc=%Rrc\n", pAreaData->uID, vrc)); return vrc; } /** * Registers and creates a new clipboard area on the host (for all VMs), returned the clipboard area ID for it. * * @returns HRESULT * @param aParms Creation parameters. Currently unused. * @param aID Where to return the clipboard area ID on success. */ HRESULT VirtualBox::i_onClipboardAreaRegister(const std::vector &aParms, ULONG *aID) { RT_NOREF(aParms); HRESULT rc = S_OK; int vrc = RTCritSectEnter(&m->SharedClipboard.CritSect); if (RT_SUCCESS(vrc)) { try { if (m->SharedClipboard.mapClipboardAreas.size() < m->SharedClipboard.uMaxClipboardAreas) { for (unsigned uTries = 0; uTries < 32; uTries++) /* Don't try too hard. */ { const ULONG uAreaID = m->SharedClipboard.GenerateAreaID(); /* Area ID already taken? */ if (m->SharedClipboard.mapClipboardAreas.find(uAreaID) != m->SharedClipboard.mapClipboardAreas.end()) continue; SharedClipboardAreaData *pAreaData; vrc = i_clipboardAreaCreate(uAreaID, 0 /* fFlags */, &pAreaData); if (RT_SUCCESS(vrc)) { m->SharedClipboard.mapClipboardAreas[uAreaID] = pAreaData; m->SharedClipboard.uMostRecentClipboardAreaID = uAreaID; /** @todo Implement collision detection / wrap-around. */ if (aID) *aID = uAreaID; LogThisFunc(("Registered new clipboard area %RU32: '%s'\n", uAreaID, pAreaData->Area.GetDirAbs())); break; } } if (RT_FAILURE(vrc)) rc = setError(E_FAIL, /** @todo Find a better rc. */ tr("Failed to create new clipboard area (%Rrc)"), vrc); } else { rc = setError(E_FAIL, /** @todo Find a better rc. */ tr("Maximum number of concurrent clipboard areas reached (%RU32)"), m->SharedClipboard.uMaxClipboardAreas); } } catch (std::bad_alloc &ba) { vrc = VERR_NO_MEMORY; RT_NOREF(ba); } RTCritSectLeave(&m->SharedClipboard.CritSect); } LogFlowThisFunc(("rc=%Rhrc\n", rc)); return rc; } /** * Unregisters (destroys) a formerly created clipboard area. * * @returns HRESULT * @param aID ID of clipboard area to destroy. */ HRESULT VirtualBox::i_onClipboardAreaUnregister(ULONG aID) { HRESULT rc = S_OK; int vrc = RTCritSectEnter(&m->SharedClipboard.CritSect); if (RT_SUCCESS(vrc)) { SharedClipboardAreaMap::iterator itArea = m->SharedClipboard.mapClipboardAreas.find(aID); if (itArea != m->SharedClipboard.mapClipboardAreas.end()) { if (itArea->second->Area.GetRefCount() == 0) { vrc = i_clipboardAreaDestroy(itArea->second); if (RT_SUCCESS(vrc)) { m->SharedClipboard.mapClipboardAreas.erase(itArea); } } else rc = setError(E_ACCESSDENIED, /** @todo Find a better rc. */ tr("Area with ID %RU32 still in used, cannot unregister"), aID); } else rc = setError(VBOX_E_OBJECT_NOT_FOUND, /** @todo Find a better rc. */ tr("Could not find a registered clipboard area with ID %RU32"), aID); int vrc2 = RTCritSectLeave(&m->SharedClipboard.CritSect); AssertRC(vrc2); } LogFlowThisFunc(("aID=%RU32, rc=%Rhrc\n", aID, rc)); return rc; } /** * Attaches to an existing clipboard area. * * @returns HRESULT * @param aID ID of clipboard area to attach. */ HRESULT VirtualBox::i_onClipboardAreaAttach(ULONG aID) { HRESULT rc = S_OK; int vrc = RTCritSectEnter(&m->SharedClipboard.CritSect); if (RT_SUCCESS(vrc)) { SharedClipboardAreaMap::iterator itArea = m->SharedClipboard.mapClipboardAreas.find(aID); if (itArea != m->SharedClipboard.mapClipboardAreas.end()) { const uint32_t cRefs = itArea->second->Area.AddRef(); RT_NOREF(cRefs); LogFlowThisFunc(("aID=%RU32 -> cRefs=%RU32\n", aID, cRefs)); vrc = VINF_SUCCESS; } else rc = setError(VBOX_E_OBJECT_NOT_FOUND, /** @todo Find a better rc. */ tr("Could not find a registered clipboard area with ID %RU32"), aID); int vrc2 = RTCritSectLeave(&m->SharedClipboard.CritSect); AssertRC(vrc2); } LogFlowThisFunc(("aID=%RU32, rc=%Rhrc\n", aID, rc)); return rc; } /** * Detaches from an existing clipboard area. * * @returns HRESULT * @param aID ID of clipboard area to detach from. */ HRESULT VirtualBox::i_onClipboardAreaDetach(ULONG aID) { HRESULT rc = S_OK; int vrc = RTCritSectEnter(&m->SharedClipboard.CritSect); if (RT_SUCCESS(vrc)) { SharedClipboardAreaMap::iterator itArea = m->SharedClipboard.mapClipboardAreas.find(aID); if (itArea != m->SharedClipboard.mapClipboardAreas.end()) { const uint32_t cRefs = itArea->second->Area.Release(); RT_NOREF(cRefs); LogFlowThisFunc(("aID=%RU32 -> cRefs=%RU32\n", aID, cRefs)); vrc = VINF_SUCCESS; } else rc = setError(VBOX_E_OBJECT_NOT_FOUND, /** @todo Find a better rc. */ tr("Could not find a registered clipboard area with ID %RU32"), aID); int rc2 = RTCritSectLeave(&m->SharedClipboard.CritSect); AssertRC(rc2); } LogFlowThisFunc(("aID=%RU32, rc=%Rhrc\n", aID, rc)); return rc; } /** * Returns the ID of the most recent (last created) clipboard area, * or NIL_SHCLAREAID if no clipboard area has been created yet. * * @returns Most recent clipboard area ID. */ ULONG VirtualBox::i_onClipboardAreaGetMostRecent(void) { ULONG aID = 0; int vrc2 = RTCritSectEnter(&m->SharedClipboard.CritSect); if (RT_SUCCESS(vrc2)) { aID = m->SharedClipboard.uMostRecentClipboardAreaID; vrc2 = RTCritSectLeave(&m->SharedClipboard.CritSect); AssertRC(vrc2); } LogFlowThisFunc(("aID=%RU32\n", aID)); return aID; } /** * Returns the current reference count of a clipboard area. * * @returns Reference count of given clipboard area ID. */ ULONG VirtualBox::i_onClipboardAreaGetRefCount(ULONG aID) { ULONG cRefCount = 0; int rc2 = RTCritSectEnter(&m->SharedClipboard.CritSect); if (RT_SUCCESS(rc2)) { SharedClipboardAreaMap::iterator itArea = m->SharedClipboard.mapClipboardAreas.find(aID); if (itArea != m->SharedClipboard.mapClipboardAreas.end()) { cRefCount = itArea->second->Area.GetRefCount(); } rc2 = RTCritSectLeave(&m->SharedClipboard.CritSect); AssertRC(rc2); } LogFlowThisFunc(("aID=%RU32, cRefCount=%RU32\n", aID, cRefCount)); return cRefCount; } #endif /* VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS */ /** * @note Doesn't lock any object. */ void VirtualBox::i_onGuestPropertyChanged(const Guid &aMachineId, const Utf8Str &aName, const Utf8Str &aValue, const Utf8Str &aFlags) { ComPtr ptrEvent; HRESULT hrc = ::CreateGuestPropertyChangedEvent(ptrEvent.asOutParam(), m->pEventSource, aMachineId.toString(), aName, aValue, aFlags); AssertComRCReturnVoid(hrc); i_postEvent(new AsyncEvent(this, ptrEvent)); } /** * @note Doesn't lock any object. */ void VirtualBox::i_onNatRedirectChanged(const Guid &aMachineId, ULONG ulSlot, bool fRemove, const Utf8Str &aName, NATProtocol_T aProto, const Utf8Str &aHostIp, uint16_t aHostPort, const Utf8Str &aGuestIp, uint16_t aGuestPort) { ::FireNATRedirectEvent(m->pEventSource, aMachineId.toString(), ulSlot, fRemove, aName, aProto, aHostIp, aHostPort, aGuestIp, aGuestPort); } /** @todo Unused!! */ void VirtualBox::i_onNATNetworkChanged(const Utf8Str &aName) { ::FireNATNetworkChangedEvent(m->pEventSource, aName); } void VirtualBox::i_onNATNetworkStartStop(const Utf8Str &aName, BOOL fStart) { ::FireNATNetworkStartStopEvent(m->pEventSource, aName, fStart); } void VirtualBox::i_onNATNetworkSetting(const Utf8Str &aNetworkName, BOOL aEnabled, const Utf8Str &aNetwork, const Utf8Str &aGateway, BOOL aAdvertiseDefaultIpv6RouteEnabled, BOOL fNeedDhcpServer) { ::FireNATNetworkSettingEvent(m->pEventSource, aNetworkName, aEnabled, aNetwork, aGateway, aAdvertiseDefaultIpv6RouteEnabled, fNeedDhcpServer); } void VirtualBox::i_onNATNetworkPortForward(const Utf8Str &aNetworkName, BOOL create, BOOL fIpv6, const Utf8Str &aRuleName, NATProtocol_T proto, const Utf8Str &aHostIp, LONG aHostPort, const Utf8Str &aGuestIp, LONG aGuestPort) { ::FireNATNetworkPortForwardEvent(m->pEventSource, aNetworkName, create, fIpv6, aRuleName, proto, aHostIp, aHostPort, aGuestIp, aGuestPort); } void VirtualBox::i_onHostNameResolutionConfigurationChange() { if (m->pEventSource) ::FireHostNameResolutionConfigurationChangeEvent(m->pEventSource); } int VirtualBox::i_natNetworkRefInc(const Utf8Str &aNetworkName) { AutoWriteLock safeLock(*spMtxNatNetworkNameToRefCountLock COMMA_LOCKVAL_SRC_POS); if (!sNatNetworkNameToRefCount[aNetworkName]) { ComPtr nat; HRESULT rc = findNATNetworkByName(aNetworkName, nat); if (FAILED(rc)) return -1; rc = nat->Start(); if (SUCCEEDED(rc)) LogRel(("Started NAT network '%s'\n", aNetworkName.c_str())); else LogRel(("Error %Rhrc starting NAT network '%s'\n", rc, aNetworkName.c_str())); AssertComRCReturn(rc, -1); } sNatNetworkNameToRefCount[aNetworkName]++; return sNatNetworkNameToRefCount[aNetworkName]; } int VirtualBox::i_natNetworkRefDec(const Utf8Str &aNetworkName) { AutoWriteLock safeLock(*spMtxNatNetworkNameToRefCountLock COMMA_LOCKVAL_SRC_POS); if (!sNatNetworkNameToRefCount[aNetworkName]) return 0; sNatNetworkNameToRefCount[aNetworkName]--; if (!sNatNetworkNameToRefCount[aNetworkName]) { ComPtr nat; HRESULT rc = findNATNetworkByName(aNetworkName, nat); if (FAILED(rc)) return -1; rc = nat->Stop(); if (SUCCEEDED(rc)) LogRel(("Stopped NAT network '%s'\n", aNetworkName.c_str())); else LogRel(("Error %Rhrc stopping NAT network '%s'\n", rc, aNetworkName.c_str())); AssertComRCReturn(rc, -1); } return sNatNetworkNameToRefCount[aNetworkName]; } void VirtualBox::i_onCloudProviderListChanged(BOOL aRegistered) { ::FireCloudProviderListChangedEvent(m->pEventSource, aRegistered); } void VirtualBox::i_onCloudProviderRegistered(const Utf8Str &aProviderId, BOOL aRegistered) { ::FireCloudProviderRegisteredEvent(m->pEventSource, aProviderId, aRegistered); } void VirtualBox::i_onCloudProviderUninstall(const Utf8Str &aProviderId) { HRESULT hrc; ComPtr pEvent; hrc = CreateCloudProviderUninstallEvent(pEvent.asOutParam(), m->pEventSource, aProviderId); if (FAILED(hrc)) return; BOOL fDelivered = FALSE; hrc = m->pEventSource->FireEvent(pEvent, /* :timeout */ 10000, &fDelivered); if (FAILED(hrc)) return; } /** * @note Locks the list of other objects for reading. */ ComObjPtr VirtualBox::i_getUnknownOSType() { ComObjPtr type; /* unknown type must always be the first */ ComAssertRet(m->allGuestOSTypes.size() > 0, type); return m->allGuestOSTypes.front(); } /** * Returns the list of opened machines (machines having VM sessions opened, * ignoring other sessions) and optionally the list of direct session controls. * * @param aMachines Where to put opened machines (will be empty if none). * @param aControls Where to put direct session controls (optional). * * @note The returned lists contain smart pointers. So, clear it as soon as * it becomes no more necessary to release instances. * * @note It can be possible that a session machine from the list has been * already uninitialized, so do a usual AutoCaller/AutoReadLock sequence * when accessing unprotected data directly. * * @note Locks objects for reading. */ void VirtualBox::i_getOpenedMachines(SessionMachinesList &aMachines, InternalControlList *aControls /*= NULL*/) { AutoCaller autoCaller(this); AssertComRCReturnVoid(autoCaller.rc()); aMachines.clear(); if (aControls) aControls->clear(); AutoReadLock alock(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (MachinesOList::iterator it = m->allMachines.begin(); it != m->allMachines.end(); ++it) { ComObjPtr sm; ComPtr ctl; if ((*it)->i_isSessionOpenVM(sm, &ctl)) { aMachines.push_back(sm); if (aControls) aControls->push_back(ctl); } } } /** * Gets a reference to the machine list. This is the real thing, not a copy, * so bad things will happen if the caller doesn't hold the necessary lock. * * @returns reference to machine list * * @note Caller must hold the VirtualBox object lock at least for reading. */ VirtualBox::MachinesOList &VirtualBox::i_getMachinesList(void) { return m->allMachines; } /** * Searches for a machine object with the given ID in the collection * of registered machines. * * @param aId Machine UUID to look for. * @param fPermitInaccessible If true, inaccessible machines will be found; * if false, this will fail if the given machine is inaccessible. * @param aSetError If true, set errorinfo if the machine is not found. * @param aMachine Returned machine, if found. * @return */ HRESULT VirtualBox::i_findMachine(const Guid &aId, bool fPermitInaccessible, bool aSetError, ComObjPtr *aMachine /* = NULL */) { HRESULT rc = VBOX_E_OBJECT_NOT_FOUND; AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); { AutoReadLock al(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (MachinesOList::iterator it = m->allMachines.begin(); it != m->allMachines.end(); ++it) { ComObjPtr pMachine = *it; if (!fPermitInaccessible) { // skip inaccessible machines AutoCaller machCaller(pMachine); if (FAILED(machCaller.rc())) continue; } if (pMachine->i_getId() == aId) { rc = S_OK; if (aMachine) *aMachine = pMachine; break; } } } if (aSetError && FAILED(rc)) rc = setError(rc, tr("Could not find a registered machine with UUID {%RTuuid}"), aId.raw()); return rc; } /** * Searches for a machine object with the given name or location in the * collection of registered machines. * * @param aName Machine name or location to look for. * @param aSetError If true, set errorinfo if the machine is not found. * @param aMachine Returned machine, if found. * @return */ HRESULT VirtualBox::i_findMachineByName(const Utf8Str &aName, bool aSetError, ComObjPtr *aMachine /* = NULL */) { HRESULT rc = VBOX_E_OBJECT_NOT_FOUND; AutoReadLock al(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (MachinesOList::iterator it = m->allMachines.begin(); it != m->allMachines.end(); ++it) { ComObjPtr &pMachine = *it; AutoCaller machCaller(pMachine); if (!machCaller.isOk()) continue; // we can't ask inaccessible machines for their names AutoReadLock machLock(pMachine COMMA_LOCKVAL_SRC_POS); if (pMachine->i_getName() == aName) { rc = S_OK; if (aMachine) *aMachine = pMachine; break; } if (!RTPathCompare(pMachine->i_getSettingsFileFull().c_str(), aName.c_str())) { rc = S_OK; if (aMachine) *aMachine = pMachine; break; } } if (aSetError && FAILED(rc)) rc = setError(rc, tr("Could not find a registered machine named '%s'"), aName.c_str()); return rc; } static HRESULT i_validateMachineGroupHelper(const Utf8Str &aGroup, bool fPrimary, VirtualBox *pVirtualBox) { /* empty strings are invalid */ if (aGroup.isEmpty()) return E_INVALIDARG; /* the toplevel group is valid */ if (aGroup == "/") return S_OK; /* any other strings of length 1 are invalid */ if (aGroup.length() == 1) return E_INVALIDARG; /* must start with a slash */ if (aGroup.c_str()[0] != '/') return E_INVALIDARG; /* must not end with a slash */ if (aGroup.c_str()[aGroup.length() - 1] == '/') return E_INVALIDARG; /* check the group components */ const char *pStr = aGroup.c_str() + 1; /* first char is /, skip it */ while (pStr) { char *pSlash = RTStrStr(pStr, "/"); if (pSlash) { /* no empty components (or // sequences in other words) */ if (pSlash == pStr) return E_INVALIDARG; /* check if the machine name rules are violated, because that means * the group components are too close to the limits. */ Utf8Str tmp((const char *)pStr, (size_t)(pSlash - pStr)); Utf8Str tmp2(tmp); sanitiseMachineFilename(tmp); if (tmp != tmp2) return E_INVALIDARG; if (fPrimary) { HRESULT rc = pVirtualBox->i_findMachineByName(tmp, false /* aSetError */); if (SUCCEEDED(rc)) return VBOX_E_VM_ERROR; } pStr = pSlash + 1; } else { /* check if the machine name rules are violated, because that means * the group components is too close to the limits. */ Utf8Str tmp(pStr); Utf8Str tmp2(tmp); sanitiseMachineFilename(tmp); if (tmp != tmp2) return E_INVALIDARG; pStr = NULL; } } return S_OK; } /** * Validates a machine group. * * @param aGroup Machine group. * @param fPrimary Set if this is the primary group. * * @return S_OK or E_INVALIDARG */ HRESULT VirtualBox::i_validateMachineGroup(const Utf8Str &aGroup, bool fPrimary) { HRESULT rc = i_validateMachineGroupHelper(aGroup, fPrimary, this); if (FAILED(rc)) { if (rc == VBOX_E_VM_ERROR) rc = setError(E_INVALIDARG, tr("Machine group '%s' conflicts with a virtual machine name"), aGroup.c_str()); else rc = setError(rc, tr("Invalid machine group '%s'"), aGroup.c_str()); } return rc; } /** * Takes a list of machine groups, and sanitizes/validates it. * * @param aMachineGroups Array with the machine groups. * @param pllMachineGroups Pointer to list of strings for the result. * * @return S_OK or E_INVALIDARG */ HRESULT VirtualBox::i_convertMachineGroups(const std::vector aMachineGroups, StringsList *pllMachineGroups) { pllMachineGroups->clear(); if (aMachineGroups.size()) { for (size_t i = 0; i < aMachineGroups.size(); i++) { Utf8Str group(aMachineGroups[i]); if (group.length() == 0) group = "/"; HRESULT rc = i_validateMachineGroup(group, i == 0); if (FAILED(rc)) return rc; /* no duplicates please */ if ( find(pllMachineGroups->begin(), pllMachineGroups->end(), group) == pllMachineGroups->end()) pllMachineGroups->push_back(group); } if (pllMachineGroups->size() == 0) pllMachineGroups->push_back("/"); } else pllMachineGroups->push_back("/"); return S_OK; } /** * Searches for a Medium object with the given ID in the list of registered * hard disks. * * @param aId ID of the hard disk. Must not be empty. * @param aSetError If @c true , the appropriate error info is set in case * when the hard disk is not found. * @param aHardDisk Where to store the found hard disk object (can be NULL). * * @return S_OK, E_INVALIDARG or VBOX_E_OBJECT_NOT_FOUND when not found. * * @note Locks the media tree for reading. */ HRESULT VirtualBox::i_findHardDiskById(const Guid &aId, bool aSetError, ComObjPtr *aHardDisk /*= NULL*/) { AssertReturn(!aId.isZero(), E_INVALIDARG); // we use the hard disks map, but it is protected by the // hard disk _list_ lock handle AutoReadLock alock(m->allHardDisks.getLockHandle() COMMA_LOCKVAL_SRC_POS); HardDiskMap::const_iterator it = m->mapHardDisks.find(aId); if (it != m->mapHardDisks.end()) { if (aHardDisk) *aHardDisk = (*it).second; return S_OK; } if (aSetError) return setError(VBOX_E_OBJECT_NOT_FOUND, tr("Could not find an open hard disk with UUID {%RTuuid}"), aId.raw()); return VBOX_E_OBJECT_NOT_FOUND; } /** * Searches for a Medium object with the given ID or location in the list of * registered hard disks. If both ID and location are specified, the first * object that matches either of them (not necessarily both) is returned. * * @param strLocation Full location specification. Must not be empty. * @param aSetError If @c true , the appropriate error info is set in case * when the hard disk is not found. * @param aHardDisk Where to store the found hard disk object (can be NULL). * * @return S_OK, E_INVALIDARG or VBOX_E_OBJECT_NOT_FOUND when not found. * * @note Locks the media tree for reading. */ HRESULT VirtualBox::i_findHardDiskByLocation(const Utf8Str &strLocation, bool aSetError, ComObjPtr *aHardDisk /*= NULL*/) { AssertReturn(!strLocation.isEmpty(), E_INVALIDARG); // we use the hard disks map, but it is protected by the // hard disk _list_ lock handle AutoReadLock alock(m->allHardDisks.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (HardDiskMap::const_iterator it = m->mapHardDisks.begin(); it != m->mapHardDisks.end(); ++it) { const ComObjPtr &pHD = (*it).second; AutoCaller autoCaller(pHD); if (FAILED(autoCaller.rc())) return autoCaller.rc(); AutoWriteLock mlock(pHD COMMA_LOCKVAL_SRC_POS); Utf8Str strLocationFull = pHD->i_getLocationFull(); if (0 == RTPathCompare(strLocationFull.c_str(), strLocation.c_str())) { if (aHardDisk) *aHardDisk = pHD; return S_OK; } } if (aSetError) return setError(VBOX_E_OBJECT_NOT_FOUND, tr("Could not find an open hard disk with location '%s'"), strLocation.c_str()); return VBOX_E_OBJECT_NOT_FOUND; } /** * Searches for a Medium object with the given ID or location in the list of * registered DVD or floppy images, depending on the @a mediumType argument. * If both ID and file path are specified, the first object that matches either * of them (not necessarily both) is returned. * * @param mediumType Must be either DeviceType_DVD or DeviceType_Floppy. * @param aId ID of the image file (unused when NULL). * @param aLocation Full path to the image file (unused when NULL). * @param aSetError If @c true, the appropriate error info is set in case when * the image is not found. * @param aImage Where to store the found image object (can be NULL). * * @return S_OK when found or E_INVALIDARG or VBOX_E_OBJECT_NOT_FOUND when not found. * * @note Locks the media tree for reading. */ HRESULT VirtualBox::i_findDVDOrFloppyImage(DeviceType_T mediumType, const Guid *aId, const Utf8Str &aLocation, bool aSetError, ComObjPtr *aImage /* = NULL */) { AssertReturn(aId || !aLocation.isEmpty(), E_INVALIDARG); Utf8Str location; if (!aLocation.isEmpty()) { int vrc = i_calculateFullPath(aLocation, location); if (RT_FAILURE(vrc)) return setError(VBOX_E_FILE_ERROR, tr("Invalid image file location '%s' (%Rrc)"), aLocation.c_str(), vrc); } MediaOList *pMediaList; switch (mediumType) { case DeviceType_DVD: pMediaList = &m->allDVDImages; break; case DeviceType_Floppy: pMediaList = &m->allFloppyImages; break; default: return E_INVALIDARG; } AutoReadLock alock(pMediaList->getLockHandle() COMMA_LOCKVAL_SRC_POS); bool found = false; for (MediaList::const_iterator it = pMediaList->begin(); it != pMediaList->end(); ++it) { // no AutoCaller, registered image life time is bound to this Medium *pMedium = *it; AutoReadLock imageLock(pMedium COMMA_LOCKVAL_SRC_POS); const Utf8Str &strLocationFull = pMedium->i_getLocationFull(); found = ( aId && pMedium->i_getId() == *aId) || ( !aLocation.isEmpty() && RTPathCompare(location.c_str(), strLocationFull.c_str()) == 0); if (found) { if (pMedium->i_getDeviceType() != mediumType) { if (mediumType == DeviceType_DVD) return setError(E_INVALIDARG, "Cannot mount DVD medium '%s' as floppy", strLocationFull.c_str()); else return setError(E_INVALIDARG, "Cannot mount floppy medium '%s' as DVD", strLocationFull.c_str()); } if (aImage) *aImage = pMedium; break; } } HRESULT rc = found ? S_OK : VBOX_E_OBJECT_NOT_FOUND; if (aSetError && !found) { if (aId) setError(rc, tr("Could not find an image file with UUID {%RTuuid} in the media registry ('%s')"), aId->raw(), m->strSettingsFilePath.c_str()); else setError(rc, tr("Could not find an image file with location '%s' in the media registry ('%s')"), aLocation.c_str(), m->strSettingsFilePath.c_str()); } return rc; } /** * Searches for an IMedium object that represents the given UUID. * * If the UUID is empty (indicating an empty drive), this sets pMedium * to NULL and returns S_OK. * * If the UUID refers to a host drive of the given device type, this * sets pMedium to the object from the list in IHost and returns S_OK. * * If the UUID is an image file, this sets pMedium to the object that * findDVDOrFloppyImage() returned. * * If none of the above apply, this returns VBOX_E_OBJECT_NOT_FOUND. * * @param mediumType Must be DeviceType_DVD or DeviceType_Floppy. * @param uuid UUID to search for; must refer to a host drive or an image file or be null. * @param fRefresh Whether to refresh the list of host drives in IHost (see Host::getDrives()) * @param aSetError * @param pMedium out: IMedium object found. * @return */ HRESULT VirtualBox::i_findRemoveableMedium(DeviceType_T mediumType, const Guid &uuid, bool fRefresh, bool aSetError, ComObjPtr &pMedium) { if (uuid.isZero()) { // that's easy pMedium.setNull(); return S_OK; } else if (!uuid.isValid()) { /* handling of case invalid GUID */ return setError(VBOX_E_OBJECT_NOT_FOUND, tr("Guid '%s' is invalid"), uuid.toString().c_str()); } // first search for host drive with that UUID HRESULT rc = m->pHost->i_findHostDriveById(mediumType, uuid, fRefresh, pMedium); if (rc == VBOX_E_OBJECT_NOT_FOUND) // then search for an image with that UUID rc = i_findDVDOrFloppyImage(mediumType, &uuid, Utf8Str::Empty, aSetError, &pMedium); return rc; } /* Look for a GuestOSType object */ HRESULT VirtualBox::i_findGuestOSType(const Utf8Str &strOSType, ComObjPtr &guestOSType) { guestOSType.setNull(); AssertMsg(m->allGuestOSTypes.size() != 0, ("Guest OS types array must be filled")); AutoReadLock alock(m->allGuestOSTypes.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (GuestOSTypesOList::const_iterator it = m->allGuestOSTypes.begin(); it != m->allGuestOSTypes.end(); ++it) { const Utf8Str &typeId = (*it)->i_id(); AssertMsg(!typeId.isEmpty(), ("ID must not be NULL")); if (strOSType.compare(typeId, Utf8Str::CaseInsensitive) == 0) { guestOSType = *it; return S_OK; } } return setError(VBOX_E_OBJECT_NOT_FOUND, tr("'%s' is not a valid Guest OS type"), strOSType.c_str()); } /** * Returns the constant pseudo-machine UUID that is used to identify the * global media registry. * * Starting with VirtualBox 4.0 each medium remembers in its instance data * in which media registry it is saved (if any): this can either be a machine * UUID, if it's in a per-machine media registry, or this global ID. * * This UUID is only used to identify the VirtualBox object while VirtualBox * is running. It is a compile-time constant and not saved anywhere. * * @return */ const Guid& VirtualBox::i_getGlobalRegistryId() const { return m->uuidMediaRegistry; } const ComObjPtr& VirtualBox::i_host() const { return m->pHost; } SystemProperties* VirtualBox::i_getSystemProperties() const { return m->pSystemProperties; } CloudProviderManager *VirtualBox::i_getCloudProviderManager() const { return m->pCloudProviderManager; } #ifdef VBOX_WITH_EXTPACK /** * Getter that SystemProperties and others can use to talk to the extension * pack manager. */ ExtPackManager* VirtualBox::i_getExtPackManager() const { return m->ptrExtPackManager; } #endif /** * Getter that machines can talk to the autostart database. */ AutostartDb* VirtualBox::i_getAutostartDb() const { return m->pAutostartDb; } #ifdef VBOX_WITH_RESOURCE_USAGE_API const ComObjPtr& VirtualBox::i_performanceCollector() const { return m->pPerformanceCollector; } #endif /* VBOX_WITH_RESOURCE_USAGE_API */ /** * Returns the default machine folder from the system properties * with proper locking. * @return */ void VirtualBox::i_getDefaultMachineFolder(Utf8Str &str) const { AutoReadLock propsLock(m->pSystemProperties COMMA_LOCKVAL_SRC_POS); str = m->pSystemProperties->m->strDefaultMachineFolder; } /** * Returns the default hard disk format from the system properties * with proper locking. * @return */ void VirtualBox::i_getDefaultHardDiskFormat(Utf8Str &str) const { AutoReadLock propsLock(m->pSystemProperties COMMA_LOCKVAL_SRC_POS); str = m->pSystemProperties->m->strDefaultHardDiskFormat; } const Utf8Str& VirtualBox::i_homeDir() const { return m->strHomeDir; } /** * Calculates the absolute path of the given path taking the VirtualBox home * directory as the current directory. * * @param strPath Path to calculate the absolute path for. * @param aResult Where to put the result (used only on success, can be the * same Utf8Str instance as passed in @a aPath). * @return IPRT result. * * @note Doesn't lock any object. */ int VirtualBox::i_calculateFullPath(const Utf8Str &strPath, Utf8Str &aResult) { AutoCaller autoCaller(this); AssertComRCReturn(autoCaller.rc(), VERR_GENERAL_FAILURE); /* no need to lock since strHomeDir is const */ char szFolder[RTPATH_MAX]; size_t cbFolder = sizeof(szFolder); int vrc = RTPathAbsEx(m->strHomeDir.c_str(), strPath.c_str(), RTPATH_STR_F_STYLE_HOST, szFolder, &cbFolder); if (RT_SUCCESS(vrc)) aResult = szFolder; return vrc; } /** * Copies strSource to strTarget, making it relative to the VirtualBox config folder * if it is a subdirectory thereof, or simply copying it otherwise. * * @param strSource Path to evalue and copy. * @param strTarget Buffer to receive target path. */ void VirtualBox::i_copyPathRelativeToConfig(const Utf8Str &strSource, Utf8Str &strTarget) { AutoCaller autoCaller(this); AssertComRCReturnVoid(autoCaller.rc()); // no need to lock since mHomeDir is const // use strTarget as a temporary buffer to hold the machine settings dir strTarget = m->strHomeDir; if (RTPathStartsWith(strSource.c_str(), strTarget.c_str())) // is relative: then append what's left strTarget.append(strSource.c_str() + strTarget.length()); // include '/' else // is not relative: then overwrite strTarget = strSource; } // private methods ///////////////////////////////////////////////////////////////////////////// /** * Checks if there is a hard disk, DVD or floppy image with the given ID or * location already registered. * * On return, sets @a aConflict to the string describing the conflicting medium, * or sets it to @c Null if no conflicting media is found. Returns S_OK in * either case. A failure is unexpected. * * @param aId UUID to check. * @param aLocation Location to check. * @param aConflict Where to return parameters of the conflicting medium. * @param ppMedium Medium reference in case this is simply a duplicate. * * @note Locks the media tree and media objects for reading. */ HRESULT VirtualBox::i_checkMediaForConflicts(const Guid &aId, const Utf8Str &aLocation, Utf8Str &aConflict, ComObjPtr *ppMedium) { AssertReturn(!aId.isZero() && !aLocation.isEmpty(), E_FAIL); AssertReturn(ppMedium, E_INVALIDARG); aConflict.setNull(); ppMedium->setNull(); AutoReadLock alock(i_getMediaTreeLockHandle() COMMA_LOCKVAL_SRC_POS); HRESULT rc = S_OK; ComObjPtr pMediumFound; const char *pcszType = NULL; if (aId.isValid() && !aId.isZero()) rc = i_findHardDiskById(aId, false /* aSetError */, &pMediumFound); if (FAILED(rc) && !aLocation.isEmpty()) rc = i_findHardDiskByLocation(aLocation, false /* aSetError */, &pMediumFound); if (SUCCEEDED(rc)) pcszType = tr("hard disk"); if (!pcszType) { rc = i_findDVDOrFloppyImage(DeviceType_DVD, &aId, aLocation, false /* aSetError */, &pMediumFound); if (SUCCEEDED(rc)) pcszType = tr("CD/DVD image"); } if (!pcszType) { rc = i_findDVDOrFloppyImage(DeviceType_Floppy, &aId, aLocation, false /* aSetError */, &pMediumFound); if (SUCCEEDED(rc)) pcszType = tr("floppy image"); } if (pcszType && pMediumFound) { /* Note: no AutoCaller since bound to this */ AutoReadLock mlock(pMediumFound COMMA_LOCKVAL_SRC_POS); Utf8Str strLocFound = pMediumFound->i_getLocationFull(); Guid idFound = pMediumFound->i_getId(); if ( (RTPathCompare(strLocFound.c_str(), aLocation.c_str()) == 0) && (idFound == aId) ) *ppMedium = pMediumFound; aConflict = Utf8StrFmt(tr("%s '%s' with UUID {%RTuuid}"), pcszType, strLocFound.c_str(), idFound.raw()); } return S_OK; } /** * Checks whether the given UUID is already in use by one medium for the * given device type. * * @returns true if the UUID is already in use * fale otherwise * @param aId The UUID to check. * @param deviceType The device type the UUID is going to be checked for * conflicts. */ bool VirtualBox::i_isMediaUuidInUse(const Guid &aId, DeviceType_T deviceType) { /* A zero UUID is invalid here, always claim that it is already used. */ AssertReturn(!aId.isZero(), true); AutoReadLock alock(i_getMediaTreeLockHandle() COMMA_LOCKVAL_SRC_POS); HRESULT rc = S_OK; bool fInUse = false; ComObjPtr pMediumFound; switch (deviceType) { case DeviceType_HardDisk: rc = i_findHardDiskById(aId, false /* aSetError */, &pMediumFound); break; case DeviceType_DVD: rc = i_findDVDOrFloppyImage(DeviceType_DVD, &aId, Utf8Str::Empty, false /* aSetError */, &pMediumFound); break; case DeviceType_Floppy: rc = i_findDVDOrFloppyImage(DeviceType_Floppy, &aId, Utf8Str::Empty, false /* aSetError */, &pMediumFound); break; default: AssertMsgFailed(("Invalid device type %d\n", deviceType)); } if (SUCCEEDED(rc) && pMediumFound) fInUse = true; return fInUse; } /** * Called from Machine::prepareSaveSettings() when it has detected * that a machine has been renamed. Such renames will require * updating the global media registry during the * VirtualBox::saveSettings() that follows later. * * When a machine is renamed, there may well be media (in particular, * diff images for snapshots) in the global registry that will need * to have their paths updated. Before 3.2, Machine::saveSettings * used to call VirtualBox::saveSettings implicitly, which was both * unintuitive and caused locking order problems. Now, we remember * such pending name changes with this method so that * VirtualBox::saveSettings() can process them properly. */ void VirtualBox::i_rememberMachineNameChangeForMedia(const Utf8Str &strOldConfigDir, const Utf8Str &strNewConfigDir) { AutoWriteLock mediaLock(i_getMediaTreeLockHandle() COMMA_LOCKVAL_SRC_POS); Data::PendingMachineRename pmr; pmr.strConfigDirOld = strOldConfigDir; pmr.strConfigDirNew = strNewConfigDir; m->llPendingMachineRenames.push_back(pmr); } static DECLCALLBACK(int) fntSaveMediaRegistries(void *pvUser); class SaveMediaRegistriesDesc : public ThreadTask { public: SaveMediaRegistriesDesc() { m_strTaskName = "SaveMediaReg"; } virtual ~SaveMediaRegistriesDesc(void) { } private: void handler() { try { fntSaveMediaRegistries(this); } catch(...) { LogRel(("Exception in the function fntSaveMediaRegistries()\n")); } } MediaList llMedia; ComObjPtr pVirtualBox; friend DECLCALLBACK(int) fntSaveMediaRegistries(void *pvUser); friend void VirtualBox::i_saveMediaRegistry(settings::MediaRegistry &mediaRegistry, const Guid &uuidRegistry, const Utf8Str &strMachineFolder); }; DECLCALLBACK(int) fntSaveMediaRegistries(void *pvUser) { SaveMediaRegistriesDesc *pDesc = (SaveMediaRegistriesDesc *)pvUser; if (!pDesc) { LogRelFunc(("Thread for saving media registries lacks parameters\n")); return VERR_INVALID_PARAMETER; } for (MediaList::const_iterator it = pDesc->llMedia.begin(); it != pDesc->llMedia.end(); ++it) { Medium *pMedium = *it; pMedium->i_markRegistriesModified(); } pDesc->pVirtualBox->i_saveModifiedRegistries(); pDesc->llMedia.clear(); pDesc->pVirtualBox.setNull(); return VINF_SUCCESS; } /** * Goes through all known media (hard disks, floppies and DVDs) and saves * those into the given settings::MediaRegistry structures whose registry * ID match the given UUID. * * Before actually writing to the structures, all media paths (not just the * ones for the given registry) are updated if machines have been renamed * since the last call. * * This gets called from two contexts: * * -- VirtualBox::saveSettings() with the UUID of the global registry * (VirtualBox::Data.uuidRegistry); this will save those media * which had been loaded from the global registry or have been * attached to a "legacy" machine which can't save its own registry; * * -- Machine::saveSettings() with the UUID of a machine, if a medium * has been attached to a machine created with VirtualBox 4.0 or later. * * Media which have only been temporarily opened without having been * attached to a machine have a NULL registry UUID and therefore don't * get saved. * * This locks the media tree. Throws HRESULT on errors! * * @param mediaRegistry Settings structure to fill. * @param uuidRegistry The UUID of the media registry; either a machine UUID * (if machine registry) or the UUID of the global registry. * @param strMachineFolder The machine folder for relative paths, if machine registry, or an empty string otherwise. */ void VirtualBox::i_saveMediaRegistry(settings::MediaRegistry &mediaRegistry, const Guid &uuidRegistry, const Utf8Str &strMachineFolder) { // lock all media for the following; use a write lock because we're // modifying the PendingMachineRenamesList, which is protected by this AutoWriteLock mediaLock(i_getMediaTreeLockHandle() COMMA_LOCKVAL_SRC_POS); // if a machine was renamed, then we'll need to refresh media paths if (m->llPendingMachineRenames.size()) { // make a single list from the three media lists so we don't need three loops MediaList llAllMedia; // with hard disks, we must use the map, not the list, because the list only has base images for (HardDiskMap::iterator it = m->mapHardDisks.begin(); it != m->mapHardDisks.end(); ++it) llAllMedia.push_back(it->second); for (MediaList::iterator it = m->allDVDImages.begin(); it != m->allDVDImages.end(); ++it) llAllMedia.push_back(*it); for (MediaList::iterator it = m->allFloppyImages.begin(); it != m->allFloppyImages.end(); ++it) llAllMedia.push_back(*it); SaveMediaRegistriesDesc *pDesc = new SaveMediaRegistriesDesc(); for (MediaList::iterator it = llAllMedia.begin(); it != llAllMedia.end(); ++it) { Medium *pMedium = *it; for (Data::PendingMachineRenamesList::iterator it2 = m->llPendingMachineRenames.begin(); it2 != m->llPendingMachineRenames.end(); ++it2) { const Data::PendingMachineRename &pmr = *it2; HRESULT rc = pMedium->i_updatePath(pmr.strConfigDirOld, pmr.strConfigDirNew); if (SUCCEEDED(rc)) { // Remember which medium objects has been changed, // to trigger saving their registries later. pDesc->llMedia.push_back(pMedium); } else if (rc == VBOX_E_FILE_ERROR) /* nothing */; else AssertComRC(rc); } } // done, don't do it again until we have more machine renames m->llPendingMachineRenames.clear(); if (pDesc->llMedia.size()) { // Handle the media registry saving in a separate thread, to // avoid giant locking problems and passing up the list many // levels up to whoever triggered saveSettings, as there are // lots of places which would need to handle saving more settings. pDesc->pVirtualBox = this; //the function createThread() takes ownership of pDesc //so there is no need to use delete operator for pDesc //after calling this function HRESULT hr = pDesc->createThread(); pDesc = NULL; if (FAILED(hr)) { // failure means that settings aren't saved, but there isn't // much we can do besides avoiding memory leaks LogRelFunc(("Failed to create thread for saving media registries (%Rhr)\n", hr)); } } else delete pDesc; } struct { MediaOList &llSource; settings::MediaList &llTarget; } s[] = { // hard disks { m->allHardDisks, mediaRegistry.llHardDisks }, // CD/DVD images { m->allDVDImages, mediaRegistry.llDvdImages }, // floppy images { m->allFloppyImages, mediaRegistry.llFloppyImages } }; HRESULT rc; for (size_t i = 0; i < RT_ELEMENTS(s); ++i) { MediaOList &llSource = s[i].llSource; settings::MediaList &llTarget = s[i].llTarget; llTarget.clear(); for (MediaList::const_iterator it = llSource.begin(); it != llSource.end(); ++it) { Medium *pMedium = *it; AutoCaller autoCaller(pMedium); if (FAILED(autoCaller.rc())) throw autoCaller.rc(); AutoReadLock mlock(pMedium COMMA_LOCKVAL_SRC_POS); if (pMedium->i_isInRegistry(uuidRegistry)) { llTarget.push_back(settings::Medium::Empty); rc = pMedium->i_saveSettings(llTarget.back(), strMachineFolder); // this recurses into child hard disks if (FAILED(rc)) { llTarget.pop_back(); throw rc; } } } } } /** * Helper function which actually writes out VirtualBox.xml, the main configuration file. * Gets called from the public VirtualBox::SaveSettings() as well as from various other * places internally when settings need saving. * * @note Caller must have locked the VirtualBox object for writing and must not hold any * other locks since this locks all kinds of member objects and trees temporarily, * which could cause conflicts. */ HRESULT VirtualBox::i_saveSettings() { AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); AssertReturn(isWriteLockOnCurrentThread(), E_FAIL); AssertReturn(!m->strSettingsFilePath.isEmpty(), E_FAIL); i_unmarkRegistryModified(i_getGlobalRegistryId()); HRESULT rc = S_OK; try { // machines m->pMainConfigFile->llMachines.clear(); { AutoReadLock machinesLock(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (MachinesOList::iterator it = m->allMachines.begin(); it != m->allMachines.end(); ++it) { Machine *pMachine = *it; // save actual machine registry entry settings::MachineRegistryEntry mre; rc = pMachine->i_saveRegistryEntry(mre); m->pMainConfigFile->llMachines.push_back(mre); } } i_saveMediaRegistry(m->pMainConfigFile->mediaRegistry, m->uuidMediaRegistry, // global media registry ID Utf8Str::Empty); // strMachineFolder m->pMainConfigFile->llDhcpServers.clear(); { AutoReadLock dhcpLock(m->allDHCPServers.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (DHCPServersOList::const_iterator it = m->allDHCPServers.begin(); it != m->allDHCPServers.end(); ++it) { settings::DHCPServer d; rc = (*it)->i_saveSettings(d); if (FAILED(rc)) throw rc; m->pMainConfigFile->llDhcpServers.push_back(d); } } #ifdef VBOX_WITH_NAT_SERVICE /* Saving NAT Network configuration */ m->pMainConfigFile->llNATNetworks.clear(); { AutoReadLock natNetworkLock(m->allNATNetworks.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (NATNetworksOList::const_iterator it = m->allNATNetworks.begin(); it != m->allNATNetworks.end(); ++it) { settings::NATNetwork n; rc = (*it)->i_saveSettings(n); if (FAILED(rc)) throw rc; m->pMainConfigFile->llNATNetworks.push_back(n); } } #endif #ifdef VBOX_WITH_CLOUD_NET m->pMainConfigFile->llCloudNetworks.clear(); { AutoReadLock cloudNetworkLock(m->allCloudNetworks.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (CloudNetworksOList::const_iterator it = m->allCloudNetworks.begin(); it != m->allCloudNetworks.end(); ++it) { settings::CloudNetwork n; rc = (*it)->i_saveSettings(n); if (FAILED(rc)) throw rc; m->pMainConfigFile->llCloudNetworks.push_back(n); } } #endif /* VBOX_WITH_CLOUD_NET */ // leave extra data alone, it's still in the config file // host data (USB filters) rc = m->pHost->i_saveSettings(m->pMainConfigFile->host); if (FAILED(rc)) throw rc; rc = m->pSystemProperties->i_saveSettings(m->pMainConfigFile->systemProperties); if (FAILED(rc)) throw rc; // and write out the XML, still under the lock m->pMainConfigFile->write(m->strSettingsFilePath); } catch (HRESULT err) { /* we assume that error info is set by the thrower */ rc = err; } catch (...) { rc = VirtualBoxBase::handleUnexpectedExceptions(this, RT_SRC_POS); } return rc; } /** * Helper to register the machine. * * When called during VirtualBox startup, adds the given machine to the * collection of registered machines. Otherwise tries to mark the machine * as registered, and, if succeeded, adds it to the collection and * saves global settings. * * @note The caller must have added itself as a caller of the @a aMachine * object if calls this method not on VirtualBox startup. * * @param aMachine machine to register * * @note Locks objects! */ HRESULT VirtualBox::i_registerMachine(Machine *aMachine) { ComAssertRet(aMachine, E_INVALIDARG); AutoCaller autoCaller(this); if (FAILED(autoCaller.rc())) return autoCaller.rc(); HRESULT rc = S_OK; AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS); { ComObjPtr pMachine; rc = i_findMachine(aMachine->i_getId(), true /* fPermitInaccessible */, false /* aDoSetError */, &pMachine); if (SUCCEEDED(rc)) { /* sanity */ AutoLimitedCaller machCaller(pMachine); AssertComRC(machCaller.rc()); return setError(E_INVALIDARG, tr("Registered machine with UUID {%RTuuid} ('%s') already exists"), aMachine->i_getId().raw(), pMachine->i_getSettingsFileFull().c_str()); } ComAssertRet(rc == VBOX_E_OBJECT_NOT_FOUND, rc); rc = S_OK; } if (getObjectState().getState() != ObjectState::InInit) { rc = aMachine->i_prepareRegister(); if (FAILED(rc)) return rc; } /* add to the collection of registered machines */ m->allMachines.addChild(aMachine); if (getObjectState().getState() != ObjectState::InInit) rc = i_saveSettings(); return rc; } /** * Remembers the given medium object by storing it in either the global * medium registry or a machine one. * * @note Caller must hold the media tree lock for writing; in addition, this * locks @a pMedium for reading * * @param pMedium Medium object to remember. * @param ppMedium Actually stored medium object. Can be different if due * to an unavoidable race there was a duplicate Medium object * created. * @param mediaTreeLock Reference to the AutoWriteLock holding the media tree * lock, necessary to release it in the right spot. * @return */ HRESULT VirtualBox::i_registerMedium(const ComObjPtr &pMedium, ComObjPtr *ppMedium, AutoWriteLock &mediaTreeLock) { AssertReturn(pMedium != NULL, E_INVALIDARG); AssertReturn(ppMedium != NULL, E_INVALIDARG); // caller must hold the media tree write lock Assert(i_getMediaTreeLockHandle().isWriteLockOnCurrentThread()); AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); AutoCaller mediumCaller(pMedium); AssertComRCReturnRC(mediumCaller.rc()); bool fAddToGlobalRegistry = false; const char *pszDevType = NULL; Guid regId; ObjectsList *pall = NULL; DeviceType_T devType; { AutoReadLock mediumLock(pMedium COMMA_LOCKVAL_SRC_POS); devType = pMedium->i_getDeviceType(); if (!pMedium->i_getFirstRegistryMachineId(regId)) fAddToGlobalRegistry = true; } switch (devType) { case DeviceType_HardDisk: pall = &m->allHardDisks; pszDevType = tr("hard disk"); break; case DeviceType_DVD: pszDevType = tr("DVD image"); pall = &m->allDVDImages; break; case DeviceType_Floppy: pszDevType = tr("floppy image"); pall = &m->allFloppyImages; break; default: AssertMsgFailedReturn(("invalid device type %d", devType), E_INVALIDARG); } Guid id; Utf8Str strLocationFull; ComObjPtr pParent; { AutoReadLock mediumLock(pMedium COMMA_LOCKVAL_SRC_POS); id = pMedium->i_getId(); strLocationFull = pMedium->i_getLocationFull(); pParent = pMedium->i_getParent(); } HRESULT rc; Utf8Str strConflict; ComObjPtr pDupMedium; rc = i_checkMediaForConflicts(id, strLocationFull, strConflict, &pDupMedium); if (FAILED(rc)) return rc; if (pDupMedium.isNull()) { if (strConflict.length()) return setError(E_INVALIDARG, tr("Cannot register the %s '%s' {%RTuuid} because a %s already exists"), pszDevType, strLocationFull.c_str(), id.raw(), strConflict.c_str(), m->strSettingsFilePath.c_str()); // add to the collection if it is a base medium if (pParent.isNull()) pall->getList().push_back(pMedium); // store all hard disks (even differencing images) in the map if (devType == DeviceType_HardDisk) m->mapHardDisks[id] = pMedium; mediumCaller.release(); mediaTreeLock.release(); *ppMedium = pMedium; } else { // pMedium may be the last reference to the Medium object, and the // caller may have specified the same ComObjPtr as the output parameter. // In this case the assignment will uninit the object, and we must not // have a caller pending. mediumCaller.release(); // release media tree lock, must not be held at uninit time. mediaTreeLock.release(); // must not hold the media tree write lock any more Assert(!i_getMediaTreeLockHandle().isWriteLockOnCurrentThread()); *ppMedium = pDupMedium; } if (fAddToGlobalRegistry) { AutoWriteLock mediumLock(pMedium COMMA_LOCKVAL_SRC_POS); if (pMedium->i_addRegistry(m->uuidMediaRegistry)) i_markRegistryModified(m->uuidMediaRegistry); } // Restore the initial lock state, so that no unexpected lock changes are // done by this method, which would need adjustments everywhere. mediaTreeLock.acquire(); return rc; } /** * Removes the given medium from the respective registry. * * @param pMedium Hard disk object to remove. * * @note Caller must hold the media tree lock for writing; in addition, this locks @a pMedium for reading */ HRESULT VirtualBox::i_unregisterMedium(Medium *pMedium) { AssertReturn(pMedium != NULL, E_INVALIDARG); AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); AutoCaller mediumCaller(pMedium); AssertComRCReturnRC(mediumCaller.rc()); // caller must hold the media tree write lock Assert(i_getMediaTreeLockHandle().isWriteLockOnCurrentThread()); Guid id; ComObjPtr pParent; DeviceType_T devType; { AutoReadLock mediumLock(pMedium COMMA_LOCKVAL_SRC_POS); id = pMedium->i_getId(); pParent = pMedium->i_getParent(); devType = pMedium->i_getDeviceType(); } ObjectsList *pall = NULL; switch (devType) { case DeviceType_HardDisk: pall = &m->allHardDisks; break; case DeviceType_DVD: pall = &m->allDVDImages; break; case DeviceType_Floppy: pall = &m->allFloppyImages; break; default: AssertMsgFailedReturn(("invalid device type %d", devType), E_INVALIDARG); } // remove from the collection if it is a base medium if (pParent.isNull()) pall->getList().remove(pMedium); // remove all hard disks (even differencing images) from map if (devType == DeviceType_HardDisk) { size_t cnt = m->mapHardDisks.erase(id); Assert(cnt == 1); NOREF(cnt); } return S_OK; } /** * Little helper called from unregisterMachineMedia() to recursively add media to the given list, * with children appearing before their parents. * @param llMedia * @param pMedium */ void VirtualBox::i_pushMediumToListWithChildren(MediaList &llMedia, Medium *pMedium) { // recurse first, then add ourselves; this way children end up on the // list before their parents const MediaList &llChildren = pMedium->i_getChildren(); for (MediaList::const_iterator it = llChildren.begin(); it != llChildren.end(); ++it) { Medium *pChild = *it; i_pushMediumToListWithChildren(llMedia, pChild); } Log(("Pushing medium %RTuuid\n", pMedium->i_getId().raw())); llMedia.push_back(pMedium); } /** * Unregisters all Medium objects which belong to the given machine registry. * Gets called from Machine::uninit() just before the machine object dies * and must only be called with a machine UUID as the registry ID. * * Locks the media tree. * * @param uuidMachine Medium registry ID (always a machine UUID) * @return */ HRESULT VirtualBox::i_unregisterMachineMedia(const Guid &uuidMachine) { Assert(!uuidMachine.isZero() && uuidMachine.isValid()); LogFlowFuncEnter(); AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); MediaList llMedia2Close; { AutoWriteLock tlock(i_getMediaTreeLockHandle() COMMA_LOCKVAL_SRC_POS); for (MediaOList::iterator it = m->allHardDisks.getList().begin(); it != m->allHardDisks.getList().end(); ++it) { ComObjPtr pMedium = *it; AutoCaller medCaller(pMedium); if (FAILED(medCaller.rc())) return medCaller.rc(); AutoReadLock medlock(pMedium COMMA_LOCKVAL_SRC_POS); if (pMedium->i_isInRegistry(uuidMachine)) // recursively with children first i_pushMediumToListWithChildren(llMedia2Close, pMedium); } } for (MediaList::iterator it = llMedia2Close.begin(); it != llMedia2Close.end(); ++it) { ComObjPtr pMedium = *it; Log(("Closing medium %RTuuid\n", pMedium->i_getId().raw())); AutoCaller mac(pMedium); pMedium->i_close(mac); } LogFlowFuncLeave(); return S_OK; } /** * Removes the given machine object from the internal list of registered machines. * Called from Machine::Unregister(). * @param pMachine * @param id UUID of the machine. Must be passed by caller because machine may be dead by this time. * @return */ HRESULT VirtualBox::i_unregisterMachine(Machine *pMachine, const Guid &id) { // remove from the collection of registered machines AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS); m->allMachines.removeChild(pMachine); // save the global registry HRESULT rc = i_saveSettings(); alock.release(); /* * Now go over all known media and checks if they were registered in the * media registry of the given machine. Each such medium is then moved to * a different media registry to make sure it doesn't get lost since its * media registry is about to go away. * * This fixes the following use case: Image A.vdi of machine A is also used * by machine B, but registered in the media registry of machine A. If machine * A is deleted, A.vdi must be moved to the registry of B, or else B will * become inaccessible. */ { AutoReadLock tlock(i_getMediaTreeLockHandle() COMMA_LOCKVAL_SRC_POS); // iterate over the list of *base* images for (MediaOList::iterator it = m->allHardDisks.getList().begin(); it != m->allHardDisks.getList().end(); ++it) { ComObjPtr &pMedium = *it; AutoCaller medCaller(pMedium); if (FAILED(medCaller.rc())) return medCaller.rc(); AutoWriteLock mlock(pMedium COMMA_LOCKVAL_SRC_POS); if (pMedium->i_removeRegistryRecursive(id)) { // machine ID was found in base medium's registry list: // move this base image and all its children to another registry then // 1) first, find a better registry to add things to const Guid *puuidBetter = pMedium->i_getAnyMachineBackref(); if (puuidBetter) { // 2) better registry found: then use that pMedium->i_addRegistryRecursive(*puuidBetter); // 3) and make sure the registry is saved below mlock.release(); tlock.release(); i_markRegistryModified(*puuidBetter); tlock.acquire(); mlock.acquire(); } } } } i_saveModifiedRegistries(); /* fire an event */ i_onMachineRegistered(id, FALSE); return rc; } /** * Marks the registry for @a uuid as modified, so that it's saved in a later * call to saveModifiedRegistries(). * * @param uuid */ void VirtualBox::i_markRegistryModified(const Guid &uuid) { if (uuid == i_getGlobalRegistryId()) ASMAtomicIncU64(&m->uRegistryNeedsSaving); else { ComObjPtr pMachine; HRESULT rc = i_findMachine(uuid, false /* fPermitInaccessible */, false /* aSetError */, &pMachine); if (SUCCEEDED(rc)) { AutoCaller machineCaller(pMachine); if (SUCCEEDED(machineCaller.rc()) && pMachine->i_isAccessible()) ASMAtomicIncU64(&pMachine->uRegistryNeedsSaving); } } } /** * Marks the registry for @a uuid as unmodified, so that it's not saved in * a later call to saveModifiedRegistries(). * * @param uuid */ void VirtualBox::i_unmarkRegistryModified(const Guid &uuid) { uint64_t uOld; if (uuid == i_getGlobalRegistryId()) { for (;;) { uOld = ASMAtomicReadU64(&m->uRegistryNeedsSaving); if (!uOld) break; if (ASMAtomicCmpXchgU64(&m->uRegistryNeedsSaving, 0, uOld)) break; ASMNopPause(); } } else { ComObjPtr pMachine; HRESULT rc = i_findMachine(uuid, false /* fPermitInaccessible */, false /* aSetError */, &pMachine); if (SUCCEEDED(rc)) { AutoCaller machineCaller(pMachine); if (SUCCEEDED(machineCaller.rc())) { for (;;) { uOld = ASMAtomicReadU64(&pMachine->uRegistryNeedsSaving); if (!uOld) break; if (ASMAtomicCmpXchgU64(&pMachine->uRegistryNeedsSaving, 0, uOld)) break; ASMNopPause(); } } } } } /** * Saves all settings files according to the modified flags in the Machine * objects and in the VirtualBox object. * * This locks machines and the VirtualBox object as necessary, so better not * hold any locks before calling this. * * @return */ void VirtualBox::i_saveModifiedRegistries() { HRESULT rc = S_OK; bool fNeedsGlobalSettings = false; uint64_t uOld; { AutoReadLock alock(m->allMachines.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (MachinesOList::iterator it = m->allMachines.begin(); it != m->allMachines.end(); ++it) { const ComObjPtr &pMachine = *it; for (;;) { uOld = ASMAtomicReadU64(&pMachine->uRegistryNeedsSaving); if (!uOld) break; if (ASMAtomicCmpXchgU64(&pMachine->uRegistryNeedsSaving, 0, uOld)) break; ASMNopPause(); } if (uOld) { AutoCaller autoCaller(pMachine); if (FAILED(autoCaller.rc())) continue; /* object is already dead, no point in saving settings */ if (getObjectState().getState() != ObjectState::Ready) continue; AutoWriteLock mlock(pMachine COMMA_LOCKVAL_SRC_POS); rc = pMachine->i_saveSettings(&fNeedsGlobalSettings, Machine::SaveS_Force); // caller said save, so stop arguing } } } for (;;) { uOld = ASMAtomicReadU64(&m->uRegistryNeedsSaving); if (!uOld) break; if (ASMAtomicCmpXchgU64(&m->uRegistryNeedsSaving, 0, uOld)) break; ASMNopPause(); } if (uOld || fNeedsGlobalSettings) { AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS); rc = i_saveSettings(); } NOREF(rc); /* XXX */ } /* static */ const com::Utf8Str &VirtualBox::i_getVersionNormalized() { return sVersionNormalized; } /** * Checks if the path to the specified file exists, according to the path * information present in the file name. Optionally the path is created. * * Note that the given file name must contain the full path otherwise the * extracted relative path will be created based on the current working * directory which is normally unknown. * * @param strFileName Full file name which path is checked/created. * @param fCreate Flag if the path should be created if it doesn't exist. * * @return Extended error information on failure to check/create the path. */ /* static */ HRESULT VirtualBox::i_ensureFilePathExists(const Utf8Str &strFileName, bool fCreate) { Utf8Str strDir(strFileName); strDir.stripFilename(); if (!RTDirExists(strDir.c_str())) { if (fCreate) { int vrc = RTDirCreateFullPath(strDir.c_str(), 0700); if (RT_FAILURE(vrc)) return i_setErrorStaticBoth(VBOX_E_IPRT_ERROR, vrc, Utf8StrFmt(tr("Could not create the directory '%s' (%Rrc)"), strDir.c_str(), vrc)); } else return i_setErrorStaticBoth(VBOX_E_IPRT_ERROR, VERR_FILE_NOT_FOUND, Utf8StrFmt(tr("Directory '%s' does not exist"), strDir.c_str())); } return S_OK; } const Utf8Str& VirtualBox::i_settingsFilePath() { return m->strSettingsFilePath; } /** * Returns the lock handle which protects the machines list. As opposed * to version 3.1 and earlier, these lists are no longer protected by the * VirtualBox lock, but by this more specialized lock. Mind the locking * order: always request this lock after the VirtualBox object lock but * before the locks of any machine object. See AutoLock.h. */ RWLockHandle& VirtualBox::i_getMachinesListLockHandle() { return m->lockMachines; } /** * Returns the lock handle which protects the media trees (hard disks, * DVDs, floppies). As opposed to version 3.1 and earlier, these lists * are no longer protected by the VirtualBox lock, but by this more * specialized lock. Mind the locking order: always request this lock * after the VirtualBox object lock but before the locks of the media * objects contained in these lists. See AutoLock.h. */ RWLockHandle& VirtualBox::i_getMediaTreeLockHandle() { return m->lockMedia; } /** * Thread function that handles custom events posted using #i_postEvent(). */ // static DECLCALLBACK(int) VirtualBox::AsyncEventHandler(RTTHREAD thread, void *pvUser) { LogFlowFuncEnter(); AssertReturn(pvUser, VERR_INVALID_POINTER); HRESULT hr = com::Initialize(); if (FAILED(hr)) return VERR_COM_UNEXPECTED; int rc = VINF_SUCCESS; try { /* Create an event queue for the current thread. */ EventQueue *pEventQueue = new EventQueue(); AssertPtr(pEventQueue); /* Return the queue to the one who created this thread. */ *(static_cast (pvUser)) = pEventQueue; /* signal that we're ready. */ RTThreadUserSignal(thread); /* * In case of spurious wakeups causing VERR_TIMEOUTs and/or other return codes * we must not stop processing events and delete the pEventQueue object. This must * be done ONLY when we stop this loop via interruptEventQueueProcessing(). * See @bugref{5724}. */ for (;;) { rc = pEventQueue->processEventQueue(RT_INDEFINITE_WAIT); if (rc == VERR_INTERRUPTED) { LogFlow(("Event queue processing ended with rc=%Rrc\n", rc)); rc = VINF_SUCCESS; /* Set success when exiting. */ break; } } delete pEventQueue; } catch (std::bad_alloc &ba) { rc = VERR_NO_MEMORY; NOREF(ba); } com::Shutdown(); LogFlowFuncLeaveRC(rc); return rc; } //////////////////////////////////////////////////////////////////////////////// #if 0 /* obsoleted by AsyncEvent */ /** * Prepare the event using the overwritten #prepareEventDesc method and fire. * * @note Locks the managed VirtualBox object for reading but leaves the lock * before iterating over callbacks and calling their methods. */ void *VirtualBox::CallbackEvent::handler() { if (!mVirtualBox) return NULL; AutoCaller autoCaller(mVirtualBox); if (!autoCaller.isOk()) { Log1WarningFunc(("VirtualBox has been uninitialized (state=%d), the callback event is discarded!\n", mVirtualBox->getObjectState().getState())); /* We don't need mVirtualBox any more, so release it */ mVirtualBox = NULL; return NULL; } { VBoxEventDesc evDesc; prepareEventDesc(mVirtualBox->m->pEventSource, evDesc); evDesc.fire(/* don't wait for delivery */0); } mVirtualBox = NULL; /* Not needed any longer. Still make sense to do this? */ return NULL; } #endif /** * Called on the event handler thread. * * @note Locks the managed VirtualBox object for reading but leaves the lock * before iterating over callbacks and calling their methods. */ void *VirtualBox::AsyncEvent::handler() { if (mVirtualBox) { AutoCaller autoCaller(mVirtualBox); if (autoCaller.isOk()) { VBoxEventDesc EvtDesc(mEvent, mVirtualBox->m->pEventSource); EvtDesc.fire(/* don't wait for delivery */0); } else Log1WarningFunc(("VirtualBox has been uninitialized (state=%d), the callback event is discarded!\n", mVirtualBox->getObjectState().getState())); mVirtualBox = NULL; /* Old code did this, not really necessary, but whatever. */ } mEvent.setNull(); return NULL; } //STDMETHODIMP VirtualBox::CreateDHCPServerForInterface(/*IHostNetworkInterface * aIinterface,*/ IDHCPServer ** aServer) //{ // return E_NOTIMPL; //} HRESULT VirtualBox::createDHCPServer(const com::Utf8Str &aName, ComPtr &aServer) { ComObjPtr dhcpServer; dhcpServer.createObject(); HRESULT rc = dhcpServer->init(this, aName); if (FAILED(rc)) return rc; rc = i_registerDHCPServer(dhcpServer, true); if (FAILED(rc)) return rc; dhcpServer.queryInterfaceTo(aServer.asOutParam()); return rc; } HRESULT VirtualBox::findDHCPServerByNetworkName(const com::Utf8Str &aName, ComPtr &aServer) { HRESULT rc = S_OK; ComPtr found; AutoReadLock alock(m->allDHCPServers.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (DHCPServersOList::const_iterator it = m->allDHCPServers.begin(); it != m->allDHCPServers.end(); ++it) { Bstr bstrNetworkName; rc = (*it)->COMGETTER(NetworkName)(bstrNetworkName.asOutParam()); if (FAILED(rc)) return rc; if (Utf8Str(bstrNetworkName) == aName) { found = *it; break; } } if (!found) return E_INVALIDARG; rc = found.queryInterfaceTo(aServer.asOutParam()); return rc; } HRESULT VirtualBox::removeDHCPServer(const ComPtr &aServer) { IDHCPServer *aP = aServer; HRESULT rc = i_unregisterDHCPServer(static_cast(aP)); return rc; } /** * Remembers the given DHCP server in the settings. * * @param aDHCPServer DHCP server object to remember. * @param aSaveSettings @c true to save settings to disk (default). * * When @a aSaveSettings is @c true, this operation may fail because of the * failed #i_saveSettings() method it calls. In this case, the dhcp server object * will not be remembered. It is therefore the responsibility of the caller to * call this method as the last step of some action that requires registration * in order to make sure that only fully functional dhcp server objects get * registered. * * @note Locks this object for writing and @a aDHCPServer for reading. */ HRESULT VirtualBox::i_registerDHCPServer(DHCPServer *aDHCPServer, bool aSaveSettings /*= true*/) { AssertReturn(aDHCPServer != NULL, E_INVALIDARG); AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); // Acquire a lock on the VirtualBox object early to avoid lock order issues // when we call i_saveSettings() later on. AutoWriteLock vboxLock(this COMMA_LOCKVAL_SRC_POS); // need it below, in findDHCPServerByNetworkName (reading) and in // m->allDHCPServers.addChild, so need to get it here to avoid lock // order trouble with dhcpServerCaller AutoWriteLock alock(m->allDHCPServers.getLockHandle() COMMA_LOCKVAL_SRC_POS); AutoCaller dhcpServerCaller(aDHCPServer); AssertComRCReturnRC(dhcpServerCaller.rc()); Bstr bstrNetworkName; HRESULT rc = S_OK; rc = aDHCPServer->COMGETTER(NetworkName)(bstrNetworkName.asOutParam()); if (FAILED(rc)) return rc; ComPtr existing; rc = findDHCPServerByNetworkName(Utf8Str(bstrNetworkName), existing); if (SUCCEEDED(rc)) return E_INVALIDARG; rc = S_OK; m->allDHCPServers.addChild(aDHCPServer); // we need to release the list lock before we attempt to acquire locks // on other objects in i_saveSettings (see @bugref{7500}) alock.release(); if (aSaveSettings) { // we acquired the lock on 'this' earlier to avoid lock order issues rc = i_saveSettings(); if (FAILED(rc)) { alock.acquire(); m->allDHCPServers.removeChild(aDHCPServer); } } return rc; } /** * Removes the given DHCP server from the settings. * * @param aDHCPServer DHCP server object to remove. * * This operation may fail because of the failed #i_saveSettings() method it * calls. In this case, the DHCP server will NOT be removed from the settings * when this method returns. * * @note Locks this object for writing. */ HRESULT VirtualBox::i_unregisterDHCPServer(DHCPServer *aDHCPServer) { AssertReturn(aDHCPServer != NULL, E_INVALIDARG); AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); AutoCaller dhcpServerCaller(aDHCPServer); AssertComRCReturnRC(dhcpServerCaller.rc()); AutoWriteLock vboxLock(this COMMA_LOCKVAL_SRC_POS); AutoWriteLock alock(m->allDHCPServers.getLockHandle() COMMA_LOCKVAL_SRC_POS); m->allDHCPServers.removeChild(aDHCPServer); // we need to release the list lock before we attempt to acquire locks // on other objects in i_saveSettings (see @bugref{7500}) alock.release(); HRESULT rc = i_saveSettings(); // undo the changes if we failed to save them if (FAILED(rc)) { alock.acquire(); m->allDHCPServers.addChild(aDHCPServer); } return rc; } /** * NAT Network */ HRESULT VirtualBox::createNATNetwork(const com::Utf8Str &aNetworkName, ComPtr &aNetwork) { #ifdef VBOX_WITH_NAT_SERVICE ComObjPtr natNetwork; natNetwork.createObject(); HRESULT rc = natNetwork->init(this, aNetworkName); if (FAILED(rc)) return rc; rc = i_registerNATNetwork(natNetwork, true); if (FAILED(rc)) return rc; natNetwork.queryInterfaceTo(aNetwork.asOutParam()); ::FireNATNetworkCreationDeletionEvent(m->pEventSource, aNetworkName, TRUE); return rc; #else NOREF(aNetworkName); NOREF(aNetwork); return E_NOTIMPL; #endif } HRESULT VirtualBox::findNATNetworkByName(const com::Utf8Str &aNetworkName, ComPtr &aNetwork) { #ifdef VBOX_WITH_NAT_SERVICE HRESULT rc = S_OK; ComPtr found; AutoReadLock alock(m->allNATNetworks.getLockHandle() COMMA_LOCKVAL_SRC_POS); for (NATNetworksOList::const_iterator it = m->allNATNetworks.begin(); it != m->allNATNetworks.end(); ++it) { Bstr bstrNATNetworkName; rc = (*it)->COMGETTER(NetworkName)(bstrNATNetworkName.asOutParam()); if (FAILED(rc)) return rc; if (Utf8Str(bstrNATNetworkName) == aNetworkName) { found = *it; break; } } if (!found) return E_INVALIDARG; found.queryInterfaceTo(aNetwork.asOutParam()); return rc; #else NOREF(aNetworkName); NOREF(aNetwork); return E_NOTIMPL; #endif } HRESULT VirtualBox::removeNATNetwork(const ComPtr &aNetwork) { #ifdef VBOX_WITH_NAT_SERVICE Bstr name; HRESULT rc = aNetwork->COMGETTER(NetworkName)(name.asOutParam()); if (FAILED(rc)) return rc; INATNetwork *p = aNetwork; NATNetwork *network = static_cast(p); rc = i_unregisterNATNetwork(network, true); ::FireNATNetworkCreationDeletionEvent(m->pEventSource, name.raw(), FALSE); return rc; #else NOREF(aNetwork); return E_NOTIMPL; #endif } /** * Remembers the given NAT network in the settings. * * @param aNATNetwork NAT Network object to remember. * @param aSaveSettings @c true to save settings to disk (default). * * * @note Locks this object for writing and @a aNATNetwork for reading. */ HRESULT VirtualBox::i_registerNATNetwork(NATNetwork *aNATNetwork, bool aSaveSettings /*= true*/) { #ifdef VBOX_WITH_NAT_SERVICE AssertReturn(aNATNetwork != NULL, E_INVALIDARG); AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); AutoCaller natNetworkCaller(aNATNetwork); AssertComRCReturnRC(natNetworkCaller.rc()); Bstr name; HRESULT rc; rc = aNATNetwork->COMGETTER(NetworkName)(name.asOutParam()); AssertComRCReturnRC(rc); /* returned value isn't 0 and aSaveSettings is true * means that we create duplicate, otherwise we just load settings. */ if ( sNatNetworkNameToRefCount[name] && aSaveSettings) AssertComRCReturnRC(E_INVALIDARG); rc = S_OK; sNatNetworkNameToRefCount[name] = 0; m->allNATNetworks.addChild(aNATNetwork); if (aSaveSettings) { AutoWriteLock vboxLock(this COMMA_LOCKVAL_SRC_POS); rc = i_saveSettings(); vboxLock.release(); if (FAILED(rc)) i_unregisterNATNetwork(aNATNetwork, false /* aSaveSettings */); } return rc; #else NOREF(aNATNetwork); NOREF(aSaveSettings); /* No panic please (silently ignore) */ return S_OK; #endif } /** * Removes the given NAT network from the settings. * * @param aNATNetwork NAT network object to remove. * @param aSaveSettings @c true to save settings to disk (default). * * When @a aSaveSettings is @c true, this operation may fail because of the * failed #i_saveSettings() method it calls. In this case, the DHCP server * will NOT be removed from the settingsi when this method returns. * * @note Locks this object for writing. */ HRESULT VirtualBox::i_unregisterNATNetwork(NATNetwork *aNATNetwork, bool aSaveSettings /*= true*/) { #ifdef VBOX_WITH_NAT_SERVICE AssertReturn(aNATNetwork != NULL, E_INVALIDARG); AutoCaller autoCaller(this); AssertComRCReturnRC(autoCaller.rc()); AutoCaller natNetworkCaller(aNATNetwork); AssertComRCReturnRC(natNetworkCaller.rc()); Bstr name; HRESULT rc = aNATNetwork->COMGETTER(NetworkName)(name.asOutParam()); /* Hm, there're still running clients. */ if (FAILED(rc) || sNatNetworkNameToRefCount[name]) AssertComRCReturnRC(E_INVALIDARG); m->allNATNetworks.removeChild(aNATNetwork); if (aSaveSettings) { AutoWriteLock vboxLock(this COMMA_LOCKVAL_SRC_POS); rc = i_saveSettings(); vboxLock.release(); if (FAILED(rc)) i_registerNATNetwork(aNATNetwork, false /* aSaveSettings */); } return rc; #else NOREF(aNATNetwork); NOREF(aSaveSettings); return E_NOTIMPL; #endif } #ifdef RT_OS_WINDOWS #include /** * Report versions of installed drivers to release log. */ void VirtualBox::i_reportDriverVersions() { /** @todo r=klaus this code is very confusing, as it uses TCHAR (and * randomly also _TCHAR, which sounds to me like asking for trouble), * the "sz" variable prefix but "%ls" for the format string - so the whole * thing is better compiled with UNICODE and _UNICODE defined. Would be * far easier to read if it would be coded explicitly for the unicode * case, as it won't work otherwise. */ DWORD err; HRESULT hrc; LPVOID aDrivers[1024]; LPVOID *pDrivers = aDrivers; UINT cNeeded = 0; TCHAR szSystemRoot[MAX_PATH]; TCHAR *pszSystemRoot = szSystemRoot; LPVOID pVerInfo = NULL; DWORD cbVerInfo = 0; do { cNeeded = GetWindowsDirectory(szSystemRoot, RT_ELEMENTS(szSystemRoot)); if (cNeeded == 0) { err = GetLastError(); hrc = HRESULT_FROM_WIN32(err); AssertLogRelMsgFailed(("GetWindowsDirectory failed, hr=%Rhrc (0x%x) err=%u\n", hrc, hrc, err)); break; } else if (cNeeded > RT_ELEMENTS(szSystemRoot)) { /* The buffer is too small, allocate big one. */ pszSystemRoot = (TCHAR *)RTMemTmpAlloc(cNeeded * sizeof(_TCHAR)); if (!pszSystemRoot) { AssertLogRelMsgFailed(("RTMemTmpAlloc failed to allocate %d bytes\n", cNeeded)); break; } if (GetWindowsDirectory(pszSystemRoot, cNeeded) == 0) { err = GetLastError(); hrc = HRESULT_FROM_WIN32(err); AssertLogRelMsgFailed(("GetWindowsDirectory failed, hr=%Rhrc (0x%x) err=%u\n", hrc, hrc, err)); break; } } DWORD cbNeeded = 0; if (!EnumDeviceDrivers(aDrivers, sizeof(aDrivers), &cbNeeded) || cbNeeded > sizeof(aDrivers)) { pDrivers = (LPVOID *)RTMemTmpAlloc(cbNeeded); if (!EnumDeviceDrivers(pDrivers, cbNeeded, &cbNeeded)) { err = GetLastError(); hrc = HRESULT_FROM_WIN32(err); AssertLogRelMsgFailed(("EnumDeviceDrivers failed, hr=%Rhrc (0x%x) err=%u\n", hrc, hrc, err)); break; } } LogRel(("Installed Drivers:\n")); TCHAR szDriver[1024]; int cDrivers = cbNeeded / sizeof(pDrivers[0]); for (int i = 0; i < cDrivers; i++) { if (GetDeviceDriverBaseName(pDrivers[i], szDriver, sizeof(szDriver) / sizeof(szDriver[0]))) { if (_tcsnicmp(TEXT("vbox"), szDriver, 4)) continue; } else continue; if (GetDeviceDriverFileName(pDrivers[i], szDriver, sizeof(szDriver) / sizeof(szDriver[0]))) { _TCHAR szTmpDrv[1024]; _TCHAR *pszDrv = szDriver; if (!_tcsncmp(TEXT("\\SystemRoot"), szDriver, 11)) { _tcscpy_s(szTmpDrv, pszSystemRoot); _tcsncat_s(szTmpDrv, szDriver + 11, sizeof(szTmpDrv) / sizeof(szTmpDrv[0]) - _tclen(pszSystemRoot)); pszDrv = szTmpDrv; } else if (!_tcsncmp(TEXT("\\??\\"), szDriver, 4)) pszDrv = szDriver + 4; /* Allocate a buffer for version info. Reuse if large enough. */ DWORD cbNewVerInfo = GetFileVersionInfoSize(pszDrv, NULL); if (cbNewVerInfo > cbVerInfo) { if (pVerInfo) RTMemTmpFree(pVerInfo); cbVerInfo = cbNewVerInfo; pVerInfo = RTMemTmpAlloc(cbVerInfo); if (!pVerInfo) { AssertLogRelMsgFailed(("RTMemTmpAlloc failed to allocate %d bytes\n", cbVerInfo)); break; } } if (GetFileVersionInfo(pszDrv, NULL, cbVerInfo, pVerInfo)) { UINT cbSize = 0; LPBYTE lpBuffer = NULL; if (VerQueryValue(pVerInfo, TEXT("\\"), (VOID FAR* FAR*)&lpBuffer, &cbSize)) { if (cbSize) { VS_FIXEDFILEINFO *pFileInfo = (VS_FIXEDFILEINFO *)lpBuffer; if (pFileInfo->dwSignature == 0xfeef04bd) { LogRel((" %ls (Version: %d.%d.%d.%d)\n", pszDrv, (pFileInfo->dwFileVersionMS >> 16) & 0xffff, (pFileInfo->dwFileVersionMS >> 0) & 0xffff, (pFileInfo->dwFileVersionLS >> 16) & 0xffff, (pFileInfo->dwFileVersionLS >> 0) & 0xffff)); } } } } } } } while (0); if (pVerInfo) RTMemTmpFree(pVerInfo); if (pDrivers != aDrivers) RTMemTmpFree(pDrivers); if (pszSystemRoot != szSystemRoot) RTMemTmpFree(pszSystemRoot); } #else /* !RT_OS_WINDOWS */ void VirtualBox::i_reportDriverVersions(void) { } #endif /* !RT_OS_WINDOWS */ #if defined(RT_OS_WINDOWS) && defined(VBOXSVC_WITH_CLIENT_WATCHER) # include /* for GetProcessImageFileNameW */ /** * Callout from the wrapper. */ void VirtualBox::i_callHook(const char *a_pszFunction) { RT_NOREF(a_pszFunction); /* * Let'see figure out who is calling. * Note! Requires Vista+, so skip this entirely on older systems. */ if (RTSystemGetNtVersion() >= RTSYSTEM_MAKE_NT_VERSION(6, 0, 0)) { RPC_CALL_ATTRIBUTES_V2_W CallAttribs = { RPC_CALL_ATTRIBUTES_VERSION, RPC_QUERY_CLIENT_PID | RPC_QUERY_IS_CLIENT_LOCAL }; RPC_STATUS rcRpc = RpcServerInqCallAttributesW(NULL, &CallAttribs); if ( rcRpc == RPC_S_OK && CallAttribs.ClientPID != 0) { RTPROCESS const pidClient = (RTPROCESS)(uintptr_t)CallAttribs.ClientPID; if (pidClient != RTProcSelf()) { /** @todo LogRel2 later: */ LogRel(("i_callHook: %Rfn [ClientPID=%#zx/%zu IsClientLocal=%d ProtocolSequence=%#x CallStatus=%#x CallType=%#x OpNum=%#x InterfaceUuid=%RTuuid]\n", a_pszFunction, CallAttribs.ClientPID, CallAttribs.ClientPID, CallAttribs.IsClientLocal, CallAttribs.ProtocolSequence, CallAttribs.CallStatus, CallAttribs.CallType, CallAttribs.OpNum, &CallAttribs.InterfaceUuid)); /* * Do we know this client PID already? */ RTCritSectRwEnterShared(&m->WatcherCritSect); WatchedClientProcessMap::iterator It = m->WatchedProcesses.find(pidClient); if (It != m->WatchedProcesses.end()) RTCritSectRwLeaveShared(&m->WatcherCritSect); /* Known process, nothing to do. */ else { /* This is a new client process, start watching it. */ RTCritSectRwLeaveShared(&m->WatcherCritSect); i_watchClientProcess(pidClient, a_pszFunction); } } } else LogRel(("i_callHook: %Rfn - rcRpc=%#x ClientPID=%#zx/%zu !! [IsClientLocal=%d ProtocolSequence=%#x CallStatus=%#x CallType=%#x OpNum=%#x InterfaceUuid=%RTuuid]\n", a_pszFunction, rcRpc, CallAttribs.ClientPID, CallAttribs.ClientPID, CallAttribs.IsClientLocal, CallAttribs.ProtocolSequence, CallAttribs.CallStatus, CallAttribs.CallType, CallAttribs.OpNum, &CallAttribs.InterfaceUuid)); } } /** * Wathces @a a_pidClient for termination. * * @returns true if successfully enabled watching of it, false if not. * @param a_pidClient The PID to watch. * @param a_pszFunction The function we which we detected the client in. */ bool VirtualBox::i_watchClientProcess(RTPROCESS a_pidClient, const char *a_pszFunction) { RT_NOREF_PV(a_pszFunction); /* * Open the client process. */ HANDLE hClient = OpenProcess(SYNCHRONIZE | PROCESS_QUERY_INFORMATION, FALSE /*fInherit*/, a_pidClient); if (hClient == NULL) hClient = OpenProcess(SYNCHRONIZE | PROCESS_QUERY_LIMITED_INFORMATION, FALSE , a_pidClient); if (hClient == NULL) hClient = OpenProcess(SYNCHRONIZE, FALSE , a_pidClient); AssertLogRelMsgReturn(hClient != NULL, ("pidClient=%d (%#x) err=%d\n", a_pidClient, a_pidClient, GetLastError()), m->fWatcherIsReliable = false); /* * Create a new watcher structure and try add it to the map. */ bool fRet = true; WatchedClientProcess *pWatched = new (std::nothrow) WatchedClientProcess(a_pidClient, hClient); if (pWatched) { RTCritSectRwEnterExcl(&m->WatcherCritSect); WatchedClientProcessMap::iterator It = m->WatchedProcesses.find(a_pidClient); if (It == m->WatchedProcesses.end()) { try { m->WatchedProcesses.insert(WatchedClientProcessMap::value_type(a_pidClient, pWatched)); } catch (std::bad_alloc &) { fRet = false; } if (fRet) { /* * Schedule it on a watcher thread. */ /** @todo later. */ RTCritSectRwLeaveExcl(&m->WatcherCritSect); } else { RTCritSectRwLeaveExcl(&m->WatcherCritSect); delete pWatched; LogRel(("VirtualBox::i_watchClientProcess: out of memory inserting into client map!\n")); } } else { /* * Someone raced us here, we lost. */ RTCritSectRwLeaveExcl(&m->WatcherCritSect); delete pWatched; } } else { LogRel(("VirtualBox::i_watchClientProcess: out of memory!\n")); CloseHandle(hClient); m->fWatcherIsReliable = fRet = false; } return fRet; } /** Logs the RPC caller info to the release log. */ /*static*/ void VirtualBox::i_logCaller(const char *a_pszFormat, ...) { if (RTSystemGetNtVersion() >= RTSYSTEM_MAKE_NT_VERSION(6, 0, 0)) { char szTmp[80]; va_list va; va_start(va, a_pszFormat); RTStrPrintfV(szTmp, sizeof(szTmp), a_pszFormat, va); va_end(va); RPC_CALL_ATTRIBUTES_V2_W CallAttribs = { RPC_CALL_ATTRIBUTES_VERSION, RPC_QUERY_CLIENT_PID | RPC_QUERY_IS_CLIENT_LOCAL }; RPC_STATUS rcRpc = RpcServerInqCallAttributesW(NULL, &CallAttribs); RTUTF16 wszProcName[256]; wszProcName[0] = '\0'; if (rcRpc == 0 && CallAttribs.ClientPID != 0) { HANDLE hProcess = OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION, FALSE, (DWORD)(uintptr_t)CallAttribs.ClientPID); if (hProcess) { RT_ZERO(wszProcName); GetProcessImageFileNameW(hProcess, wszProcName, RT_ELEMENTS(wszProcName) - 1); CloseHandle(hProcess); } } LogRel(("%s [rcRpc=%#x ClientPID=%#zx/%zu (%ls) IsClientLocal=%d ProtocolSequence=%#x CallStatus=%#x CallType=%#x OpNum=%#x InterfaceUuid=%RTuuid]\n", szTmp, rcRpc, CallAttribs.ClientPID, CallAttribs.ClientPID, wszProcName, CallAttribs.IsClientLocal, CallAttribs.ProtocolSequence, CallAttribs.CallStatus, CallAttribs.CallType, CallAttribs.OpNum, &CallAttribs.InterfaceUuid)); } } #endif /* RT_OS_WINDOWS && VBOXSVC_WITH_CLIENT_WATCHER */ /* vi: set tabstop=4 shiftwidth=4 expandtab: */