/** @file * * VirtualBox COM class implementation */ /* * Copyright (C) 2006 InnoTek Systemberatung GmbH * * 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 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. * * If you received this file as part of a commercial VirtualBox * distribution, then only the terms of your commercial VirtualBox * license agreement apply instead of the previous paragraph. */ #if defined(__WIN__) #elif defined(__LINUX__) #endif #ifdef VBOX_WITH_SYS_V_IPC_SESSION_WATCHER # include # include # include # include # include #endif #include "VirtualBoxImpl.h" #include "MachineImpl.h" #include "HardDiskImpl.h" #include "HostDVDDriveImpl.h" #include "HostFloppyDriveImpl.h" #include "ProgressImpl.h" #include "HardDiskAttachmentImpl.h" #include "USBControllerImpl.h" #include "HostImpl.h" #include "SystemPropertiesImpl.h" #include "SharedFolderImpl.h" #include "GuestOSTypeImpl.h" #include "VirtualBoxErrorInfoImpl.h" #include "USBProxyService.h" #include "Logging.h" #include #include #include #include #include #include #include #include #include #include #if defined(__WIN__) || defined(__OS2__) #define HOSTSUFF_EXE ".exe" #else /* !__WIN__ */ #define HOSTSUFF_EXE "" #endif /* !__WIN__ */ // defines / prototypes ///////////////////////////////////////////////////////////////////////////// /** * Local mutability check macro for Machine implementation only. */ #define CHECK_SETTER() \ if (!isMutable()) \ return setError (E_ACCESSDENIED, tr ("The machine is not mutable")); // globals ///////////////////////////////////////////////////////////////////////////// /** * @note The template is NOT completely valid according to VBOX_XML_SCHEMA * (when loading a newly created settings file, validation will be turned off) */ static const char DefaultMachineConfig[] = { "" RTFILE_LINEFEED "" RTFILE_LINEFEED "" RTFILE_LINEFEED "" RTFILE_LINEFEED }; /** * Progress callback handler for lengthy operations * (corresponds to the FNRTPROGRESS typedef). * * @param uPercentage Completetion precentage (0-100). * @param pvUser Pointer to the Progress instance. */ static DECLCALLBACK(int) progressCallback (unsigned uPercentage, void *pvUser) { Progress *progress = static_cast (pvUser); /* update the progress object */ if (progress) progress->notifyProgress (uPercentage); return VINF_SUCCESS; } ///////////////////////////////////////////////////////////////////////////// // Machine::Data structure ///////////////////////////////////////////////////////////////////////////// Machine::Data::Data() { mRegistered = FALSE; /* mUuid is initialized in Machine::init() */ mMachineState = MachineState_PoweredOff; RTTIMESPEC time; mLastStateChange = RTTimeSpecGetMilli (RTTimeNow (&time)); mCurrentStateModified = TRUE; mHandleCfgFile = NIL_RTFILE; mSession.mPid = NIL_RTPROCESS; mSession.mState = SessionState_SessionClosed; } Machine::Data::~Data() { } ///////////////////////////////////////////////////////////////////////////// // Machine::UserData structure ///////////////////////////////////////////////////////////////////////////// Machine::UserData::UserData() { /* default values for a newly created machine */ mNameSync = TRUE; /* mName, mOSType, mSnapshotFolder, mSnapshotFolderFull are initialized in * Machine::init() */ } Machine::UserData::~UserData() { } ///////////////////////////////////////////////////////////////////////////// // Machine::HWData structure ///////////////////////////////////////////////////////////////////////////// Machine::HWData::HWData() { /* default values for a newly created machine */ mMemorySize = 128; mVRAMSize = 8; mHWVirtExEnabled = TriStateBool_False; /* default boot order: floppy - DVD - HDD */ mBootOrder [0] = DeviceType_FloppyDevice; mBootOrder [1] = DeviceType_DVDDevice; mBootOrder [2] = DeviceType_HardDiskDevice; for (size_t i = 3; i < ELEMENTS (mBootOrder); i++) mBootOrder [i] = DeviceType_NoDevice; mClipboardMode = ClipboardMode_ClipDisabled; } Machine::HWData::~HWData() { } bool Machine::HWData::operator== (const HWData &that) const { if (this == &that) return true; if (mMemorySize != that.mMemorySize || mVRAMSize != that.mVRAMSize || mHWVirtExEnabled != that.mHWVirtExEnabled || mClipboardMode != that.mClipboardMode) return false; for (size_t i = 0; i < ELEMENTS (mBootOrder); ++ i) if (mBootOrder [i] != that.mBootOrder [i]) return false; if (mSharedFolders.size() != that.mSharedFolders.size()) return false; if (mSharedFolders.size() == 0) return true; /* Make copies to speed up comparison */ SharedFolderList folders = mSharedFolders; SharedFolderList thatFolders = that.mSharedFolders; SharedFolderList::iterator it = folders.begin(); while (it != folders.end()) { bool found = false; SharedFolderList::iterator thatIt = thatFolders.begin(); while (thatIt != thatFolders.end()) { if ((*it)->name() == (*thatIt)->name() && RTPathCompare (Utf8Str ((*it)->hostPath()), Utf8Str ((*thatIt)->hostPath())) == 0) { thatFolders.erase (thatIt); found = true; break; } else ++ thatIt; } if (found) it = folders.erase (it); else return false; } Assert (folders.size() == 0 && thatFolders.size() == 0); return true; } ///////////////////////////////////////////////////////////////////////////// // Machine::HDData structure ///////////////////////////////////////////////////////////////////////////// Machine::HDData::HDData() { /* default values for a newly created machine */ mHDAttachmentsChanged = false; } Machine::HDData::~HDData() { } bool Machine::HDData::operator== (const HDData &that) const { if (this == &that) return true; if (mHDAttachments.size() != that.mHDAttachments.size()) return false; if (mHDAttachments.size() == 0) return true; /* Make copies to speed up comparison */ HDAttachmentList atts = mHDAttachments; HDAttachmentList thatAtts = that.mHDAttachments; HDAttachmentList::iterator it = atts.begin(); while (it != atts.end()) { bool found = false; HDAttachmentList::iterator thatIt = thatAtts.begin(); while (thatIt != thatAtts.end()) { if ((*it)->deviceNumber() == (*thatIt)->deviceNumber() && (*it)->controller() == (*thatIt)->controller() && (*it)->hardDisk().equalsTo ((*thatIt)->hardDisk())) { thatAtts.erase (thatIt); found = true; break; } else ++ thatIt; } if (found) it = atts.erase (it); else return false; } Assert (atts.size() == 0 && thatAtts.size() == 0); return true; } ///////////////////////////////////////////////////////////////////////////// // Machine class ///////////////////////////////////////////////////////////////////////////// // constructor / destructor ///////////////////////////////////////////////////////////////////////////// Machine::Machine() : mType (IsMachine) {} Machine::~Machine() {} HRESULT Machine::FinalConstruct() { LogFlowThisFunc (("\n")); return S_OK; } void Machine::FinalRelease() { LogFlowThisFunc (("\n")); uninit(); } /** * Initializes the instance. * * @param aParent Associated parent object * @param aConfigFile Local file system path to the VM settings file (can * be relative to the VirtualBox config directory). * @param aMode Init_New, Init_Existing or Init_Registered * @param aName name for the machine when aMode is Init_New * (ignored otherwise) * @param aNameSync |TRUE| to authomatically sync settings dir and file * name with the machine name. |FALSE| is used for legacy * machines where the file name is specified by the * user and should never change. Used only in Init_New * mode (ignored otherwise). * @param aId UUID of the machine (used only for consistency * check when aMode is Init_Registered; must match UUID * stored in the settings file). * * @return Success indicator. if not S_OK, the machine object is invalid */ HRESULT Machine::init (VirtualBox *aParent, const BSTR aConfigFile, InitMode aMode, const BSTR aName /* = NULL */, BOOL aNameSync /* = TRUE */, const Guid *aId /* = NULL */) { LogFlowThisFuncEnter(); LogFlowThisFunc (("aConfigFile='%ls', aMode=%d\n", aConfigFile, aMode)); AssertReturn (aParent, E_INVALIDARG); AssertReturn (aConfigFile, E_INVALIDARG); AssertReturn (aMode != Init_New || (aName != NULL && *aName != '\0'), E_INVALIDARG); AssertReturn (aMode != Init_Registered || aId != NULL, E_FAIL); /* Enclose the state transition NotReady->InInit->Ready */ AutoInitSpan autoInitSpan (this); AssertReturn (autoInitSpan.isOk(), E_UNEXPECTED); HRESULT rc = S_OK; /* share the parent weakly */ unconst (mParent) = aParent; /* register with parent early, since uninit() will unconditionally * unregister on failure */ mParent->addDependentChild (this); /* create machine data structures */ mData.allocate(); mSSData.allocate(); mUserData.allocate(); mHWData.allocate(); mHDData.allocate(); char configFileFull [RTPATH_MAX] = {0}; /* memorize the config file name (as provided) */ mData->mConfigFile = aConfigFile; /* get the full file name */ int vrc = RTPathAbsEx (mParent->homeDir(), Utf8Str (aConfigFile), configFileFull, sizeof (configFileFull)); if (VBOX_FAILURE (vrc)) return setError (E_FAIL, tr ("Invalid settings file name: '%ls' (%Vrc)"), aConfigFile, vrc); mData->mConfigFileFull = configFileFull; mData->mAccessible = TRUE; if (aMode != Init_New) { /* lock the settings file */ rc = lockConfig(); if (aMode == Init_Registered && FAILED (rc)) { /* If the machine is registered, then, instead of returning a * failure, we mark it as inaccessible and set the result to * success to give it a try later */ mData->mAccessible = FALSE; /* fetch the current error info */ mData->mAccessError = com::ErrorInfo(); LogWarning (("Machine {%Vuuid} is inaccessible! [%ls]\n", mData->mUuid.raw(), mData->mAccessError.getText().raw())); rc = S_OK; } } else { /* check for the file existence */ RTFILE f = NIL_RTFILE; int vrc = RTFileOpen (&f, configFileFull, RTFILE_O_READ); if (VBOX_SUCCESS (vrc) || vrc == VERR_SHARING_VIOLATION) { rc = setError (E_FAIL, tr ("Settings file '%s' already exists"), configFileFull); if (VBOX_SUCCESS (vrc)) RTFileClose (f); } else { if (vrc != VERR_FILE_NOT_FOUND && vrc != VERR_PATH_NOT_FOUND) rc = setError (E_FAIL, tr ("Invalid settings file name: '%ls' (%Vrc)"), mData->mConfigFileFull.raw(), vrc); } } CheckComRCReturnRC (rc); /* initialize mOSType */ mUserData->mOSType = mParent->getUnknownOSType(); /* create associated BIOS settings object */ unconst (mBIOSSettings).createObject(); mBIOSSettings->init(this); #ifdef VBOX_VRDP /* create an associated VRDPServer object (default is disabled) */ unconst (mVRDPServer).createObject(); mVRDPServer->init(this); #endif /* create an associated DVD drive object */ unconst (mDVDDrive).createObject(); mDVDDrive->init (this); /* create an associated floppy drive object */ unconst (mFloppyDrive).createObject(); mFloppyDrive->init (this); /* create the audio adapter object (always present, default is disabled) */ unconst (mAudioAdapter).createObject(); mAudioAdapter->init(this); /* create the USB controller object (always present, default is disabled) */ unconst (mUSBController).createObject(); mUSBController->init(this); /* create associated network adapter objects */ for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) { unconst (mNetworkAdapters [slot]).createObject(); mNetworkAdapters [slot]->init (this, slot); } if (aMode == Init_Registered) { /* store the supplied UUID (will be used to check for UUID consistency * in loadSettings() */ unconst (mData->mUuid) = *aId; /* try to load settings only if the settings file is accessible */ if (mData->mAccessible) rc = registeredInit(); } else { if (aMode != Init_New) { rc = loadSettings (false /* aRegistered */); } else { /* create the machine UUID */ unconst (mData->mUuid).create(); /* initialize the default snapshots folder */ rc = COMSETTER(SnapshotFolder) (NULL); AssertComRC (rc); /* memorize the provided new machine's name */ mUserData->mName = aName; mUserData->mNameSync = aNameSync; } /* commit all changes made during the initialization */ if (SUCCEEDED (rc)) commit(); } /* Confirm a successful initialization when it's the case */ if (SUCCEEDED (rc)) { if (mData->mAccessible) autoInitSpan.setSucceeded(); else autoInitSpan.setLimited(); } LogFlowThisFunc (("mName='%ls', mRegistered=%RTbool, mAccessible=%RTbool " "rc=%08X\n", mUserData->mName.raw(), mData->mRegistered, mData->mAccessible, rc)); LogFlowThisFuncLeave(); return rc; } /** * Initializes the registered machine by loading the settings file. * This method is separated from #init() in order to make it possible to * retry the operation after VirtualBox startup instead of refusing to * startup the whole VirtualBox server in case if the settings file of some * registered VM is invalid or inaccessible. * * @note Must be always called from this object's write lock * (unless called from #init() that doesn't need any locking). * @note Locks the mUSBController method for writing. * @note Subclasses must not call this method. */ HRESULT Machine::registeredInit() { AssertReturn (mType == IsMachine, E_FAIL); AssertReturn (!mData->mUuid.isEmpty(), E_FAIL); HRESULT rc = S_OK; if (!mData->mAccessible) rc = lockConfig(); /* Temporarily reset the registered flag in order to let setters potentially * called from loadSettings() succeed (isMutable() used in all setters * will return FALSE for a Machine instance if mRegistered is TRUE). */ mData->mRegistered = FALSE; if (SUCCEEDED (rc)) { rc = loadSettings (true /* aRegistered */); if (FAILED (rc)) unlockConfig(); } if (SUCCEEDED (rc)) { mData->mAccessible = TRUE; /* commit all changes made during loading the settings file */ commit(); /* VirtualBox will not call trySetRegistered(), so * inform the USB proxy about all attached USB filters */ mUSBController->onMachineRegistered (TRUE); } else { /* If the machine is registered, then, instead of returning a * failure, we mark it as inaccessible and set the result to * success to give it a try later */ mData->mAccessible = FALSE; /* fetch the current error info */ mData->mAccessError = com::ErrorInfo(); LogWarning (("Machine {%Vuuid} is inaccessible! [%ls]\n", mData->mUuid.raw(), mData->mAccessError.getText().raw())); /* rollback all changes */ rollback (false /* aNotify */); rc = S_OK; } /* Restore the registered flag (even on failure) */ mData->mRegistered = TRUE; return rc; } /** * Uninitializes the instance. * Called either from FinalRelease() or by the parent when it gets destroyed. * * @note The caller of this method must make sure that this object * a) doesn't have active callers on the current thread and b) is not locked * by the current thread; otherwise uninit() will hang either a) due to * AutoUninitSpan waiting for a number of calls to drop to zero or b) due to * a dead-lock caused by this thread waiting for all callers on the other * threads are are done but preventing them from doing so by holding a lock. */ void Machine::uninit() { LogFlowThisFuncEnter(); Assert (!isLockedOnCurrentThread()); /* Enclose the state transition Ready->InUninit->NotReady */ AutoUninitSpan autoUninitSpan (this); if (autoUninitSpan.uninitDone()) return; Assert (mType == IsMachine); Assert (!!mData && !!mUserData && !!mHWData && !!mHDData && !!mSSData); LogFlowThisFunc (("initFailed()=%d\n", autoUninitSpan.initFailed())); LogFlowThisFunc (("mRegistered=%d\n", mData->mRegistered)); /* * Enter this object's lock because there may be a SessionMachine instance * somewhere around, that shares our data and lock but doesn't use our * addCaller()/removeCaller(), and it may be also accessing the same * data members. mParent lock is necessary as well because of * SessionMachine::uninit(), etc. */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); if (!mData->mSession.mMachine.isNull()) { /* * Theoretically, this can only happen if the VirtualBox server has * been terminated while there were clients running that owned open * direct sessions. Since in this case we are definitely called by * VirtualBox::uninit(), we may be sure that SessionMachine::uninit() * won't happen on the client watcher thread (because it does * VirtualBox::addCaller() for the duration of the * SessionMachine::checkForDeath() call, so that VirtualBox::uninit() * cannot happen until the VirtualBox caller is released). This is * important, because SessionMachine::uninit() cannot correctly operate * after we return from this method (it expects the Machine instance * is still valid). We'll call it ourselves below. */ LogWarningThisFunc (("Session machine is not NULL (%p), " "the direct session is still open!\n", (SessionMachine *) mData->mSession.mMachine)); if (mData->mMachineState >= MachineState_Running) { LogWarningThisFunc (("Setting state to Aborted!\n")); /* set machine state using SessionMachine reimplementation */ static_cast (mData->mSession.mMachine) ->setMachineState (MachineState_Aborted); } /* * Uninitialize SessionMachine using public uninit() to indicate * an unexpected uninitialization. */ mData->mSession.mMachine->uninit(); /* SessionMachine::uninit() must set mSession.mMachine to null */ Assert (mData->mSession.mMachine.isNull()); } /* the lock is no more necessary (SessionMachine is uninitialized) */ alock.leave(); /* make sure the configuration is unlocked */ unlockConfig(); if (isModified()) { LogWarningThisFunc (("Discarding unsaved settings changes!\n")); rollback (false /* aNotify */); } uninitDataAndChildObjects(); mParent->removeDependentChild (this); LogFlowThisFuncLeave(); } // IMachine properties ///////////////////////////////////////////////////////////////////////////// STDMETHODIMP Machine::COMGETTER(Parent) (IVirtualBox **aParent) { if (!aParent) return E_POINTER; AutoLimitedCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); /* mParent is constant during life time, no need to lock */ mParent.queryInterfaceTo (aParent); return S_OK; } STDMETHODIMP Machine::COMGETTER(Accessible) (BOOL *aAccessible) { if (!aAccessible) return E_POINTER; AutoLimitedCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); HRESULT rc = S_OK; if (!mData->mAccessible) { /* try to initialize the VM once more if not accessible */ AutoReadySpan autoReadySpan (this); AssertReturn (autoReadySpan.isOk(), E_FAIL); rc = registeredInit(); if (mData->mAccessible) autoReadySpan.setSucceeded(); } if (SUCCEEDED (rc)) *aAccessible = mData->mAccessible; return rc; } STDMETHODIMP Machine::COMGETTER(AccessError) (IVirtualBoxErrorInfo **aAccessError) { if (!aAccessError) return E_POINTER; AutoLimitedCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); if (mData->mAccessible || !mData->mAccessError.isBasicAvailable()) { /* return shortly */ aAccessError = NULL; return S_OK; } HRESULT rc = S_OK; ComObjPtr errorInfo; rc = errorInfo.createObject(); if (SUCCEEDED (rc)) { errorInfo->init (mData->mAccessError.getResultCode(), mData->mAccessError.getInterfaceID(), mData->mAccessError.getComponent(), mData->mAccessError.getText()); rc = errorInfo.queryInterfaceTo (aAccessError); } return rc; } STDMETHODIMP Machine::COMGETTER(Name) (BSTR *aName) { if (!aName) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); mUserData->mName.cloneTo (aName); return S_OK; } STDMETHODIMP Machine::COMSETTER(Name) (INPTR BSTR aName) { if (!aName) return E_INVALIDARG; if (!*aName) return setError (E_INVALIDARG, tr ("Machine name cannot be empty")); AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); mUserData.backup(); mUserData->mName = aName; return S_OK; } STDMETHODIMP Machine::COMGETTER(Id) (GUIDPARAMOUT aId) { if (!aId) return E_POINTER; AutoLimitedCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); mData->mUuid.cloneTo (aId); return S_OK; } STDMETHODIMP Machine::COMGETTER(OSType) (IGuestOSType **aOSType) { if (!aOSType) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); mUserData->mOSType.queryInterfaceTo (aOSType); return S_OK; } STDMETHODIMP Machine::COMSETTER(OSType) (IGuestOSType *aOSType) { if (!aOSType) return E_INVALIDARG; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); mUserData.backup(); mUserData->mOSType = aOSType; return S_OK; } STDMETHODIMP Machine::COMGETTER(MemorySize) (ULONG *memorySize) { if (!memorySize) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *memorySize = mHWData->mMemorySize; return S_OK; } STDMETHODIMP Machine::COMSETTER(MemorySize) (ULONG memorySize) { /* check RAM limits */ if (memorySize < SchemaDefs::MinGuestRAM || memorySize > SchemaDefs::MaxGuestRAM) return setError (E_INVALIDARG, tr ("Invalid RAM size: %lu MB (must be in range [%lu, %lu] MB)"), memorySize, SchemaDefs::MinGuestRAM, SchemaDefs::MaxGuestRAM); AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); mHWData.backup(); mHWData->mMemorySize = memorySize; return S_OK; } STDMETHODIMP Machine::COMGETTER(VRAMSize) (ULONG *memorySize) { if (!memorySize) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *memorySize = mHWData->mVRAMSize; return S_OK; } STDMETHODIMP Machine::COMSETTER(VRAMSize) (ULONG memorySize) { /* check VRAM limits */ if (memorySize < SchemaDefs::MinGuestVRAM || memorySize > SchemaDefs::MaxGuestVRAM) return setError (E_INVALIDARG, tr ("Invalid VRAM size: %lu MB (must be in range [%lu, %lu] MB)"), memorySize, SchemaDefs::MinGuestVRAM, SchemaDefs::MaxGuestVRAM); AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); mHWData.backup(); mHWData->mVRAMSize = memorySize; return S_OK; } STDMETHODIMP Machine::COMGETTER(BIOSSettings)(IBIOSSettings **biosSettings) { if (!biosSettings) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); /* mBIOSSettings is constant during life time, no need to lock */ mBIOSSettings.queryInterfaceTo (biosSettings); return S_OK; } STDMETHODIMP Machine::COMGETTER(HWVirtExEnabled)(TriStateBool_T *enabled) { if (!enabled) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *enabled = mHWData->mHWVirtExEnabled; return S_OK; } STDMETHODIMP Machine::COMSETTER(HWVirtExEnabled)(TriStateBool_T enable) { AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); /** @todo check validity! */ mHWData.backup(); mHWData->mHWVirtExEnabled = enable; return S_OK; } STDMETHODIMP Machine::COMGETTER(SnapshotFolder) (BSTR *aSnapshotFolder) { if (!aSnapshotFolder) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); mUserData->mSnapshotFolderFull.cloneTo (aSnapshotFolder); return S_OK; } STDMETHODIMP Machine::COMSETTER(SnapshotFolder) (INPTR BSTR aSnapshotFolder) { /// @todo (r=dmik): // 1. Allow to change the name of the snapshot folder containing snapshots // 2. Rename the folder on disk instead of just changing the property // value (to be smart and not to leave garbage). Note that it cannot be // done here because the change may be rolled back. Thus, the right // place is #saveSettings(). AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); if (!mData->mCurrentSnapshot.isNull()) return setError (E_FAIL, tr ("The snapshot folder of a machine with snapshots cannot " "be changed (please discard all snapshots first)")); Utf8Str snapshotFolder = aSnapshotFolder; if (snapshotFolder.isEmpty()) { if (isInOwnDir()) { /* the default snapshots folder is 'Snapshots' in the machine dir */ snapshotFolder = Utf8Str ("Snapshots"); } else { /* the default snapshots folder is {UUID}, for backwards * compatibility and to resolve conflicts */ snapshotFolder = Utf8StrFmt ("{%Vuuid}", mData->mUuid.raw()); } } int vrc = calculateFullPath (snapshotFolder, snapshotFolder); if (VBOX_FAILURE (vrc)) return setError (E_FAIL, tr ("Invalid snapshot folder: '%ls' (%Vrc)"), aSnapshotFolder, vrc); mUserData.backup(); mUserData->mSnapshotFolder = aSnapshotFolder; mUserData->mSnapshotFolderFull = snapshotFolder; return S_OK; } STDMETHODIMP Machine::COMGETTER(HardDiskAttachments) (IHardDiskAttachmentCollection **attachments) { if (!attachments) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); ComObjPtr collection; collection.createObject(); collection->init (mHDData->mHDAttachments); collection.queryInterfaceTo (attachments); return S_OK; } STDMETHODIMP Machine::COMGETTER(VRDPServer)(IVRDPServer **vrdpServer) { #ifdef VBOX_VRDP if (!vrdpServer) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); Assert (!!mVRDPServer); mVRDPServer.queryInterfaceTo (vrdpServer); return S_OK; #else return E_NOTIMPL; #endif } STDMETHODIMP Machine::COMGETTER(DVDDrive) (IDVDDrive **dvdDrive) { if (!dvdDrive) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); Assert (!!mDVDDrive); mDVDDrive.queryInterfaceTo (dvdDrive); return S_OK; } STDMETHODIMP Machine::COMGETTER(FloppyDrive) (IFloppyDrive **floppyDrive) { if (!floppyDrive) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); Assert (!!mFloppyDrive); mFloppyDrive.queryInterfaceTo (floppyDrive); return S_OK; } STDMETHODIMP Machine::COMGETTER(AudioAdapter)(IAudioAdapter **audioAdapter) { if (!audioAdapter) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); mAudioAdapter.queryInterfaceTo (audioAdapter); return S_OK; } STDMETHODIMP Machine::COMGETTER(USBController)(IUSBController * *a_ppUSBController) { #ifdef VBOX_WITH_USB if (!a_ppUSBController) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); USBProxyService *usbProxyService = mParent->host()->usbProxyService(); AssertReturn (usbProxyService, E_FAIL); if (!usbProxyService->isActive()) { /* disable the USB controller completely to avoid assertions if the * USB proxy service could not start. */ Assert (VBOX_FAILURE (usbProxyService->getLastError())); if (usbProxyService->getLastError() == VERR_FILE_NOT_FOUND) return setError (E_FAIL, tr ("Could not load the USB proxy service (%Vrc), " "the virtual USB Controller is not available." "The service may not be installed on the host computer."), usbProxyService->getLastError()); else return setError (E_FAIL, tr ("Could not load the USB proxy service (%Vrc), " "the virtual USB Controller is not available."), usbProxyService->getLastError()); } mUSBController.queryInterfaceTo (a_ppUSBController); return S_OK; #else return E_NOTIMPL; #endif } STDMETHODIMP Machine::COMGETTER(SettingsFilePath) (BSTR *filePath) { if (!filePath) return E_POINTER; AutoLimitedCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); mData->mConfigFileFull.cloneTo (filePath); return S_OK; } STDMETHODIMP Machine::COMGETTER(SettingsModified) (BOOL *modified) { if (!modified) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); if (!isConfigLocked()) { /* * if we're ready and isConfigLocked() is FALSE then it means * that no config file exists yet, so always return TRUE */ *modified = TRUE; } else { *modified = isModified(); } return S_OK; } STDMETHODIMP Machine::COMGETTER(SessionState) (SessionState_T *sessionState) { if (!sessionState) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *sessionState = mData->mSession.mState; return S_OK; } STDMETHODIMP Machine::COMGETTER(State) (MachineState_T *machineState) { if (!machineState) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *machineState = mData->mMachineState; return S_OK; } STDMETHODIMP Machine::COMGETTER(LastStateChange) (LONG64 *aLastStateChange) { if (!aLastStateChange) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *aLastStateChange = mData->mLastStateChange; return S_OK; } STDMETHODIMP Machine::COMGETTER(StateFilePath) (BSTR *aStateFilePath) { if (!aStateFilePath) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); mSSData->mStateFilePath.cloneTo (aStateFilePath); return S_OK; } STDMETHODIMP Machine::COMGETTER(CurrentSnapshot) (ISnapshot **aCurrentSnapshot) { if (!aCurrentSnapshot) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); mData->mCurrentSnapshot.queryInterfaceTo (aCurrentSnapshot); return S_OK; } STDMETHODIMP Machine::COMGETTER(SnapshotCount) (ULONG *aSnapshotCount) { if (!aSnapshotCount) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *aSnapshotCount = !mData->mFirstSnapshot ? 0 : mData->mFirstSnapshot->descendantCount() + 1 /* self */; return S_OK; } STDMETHODIMP Machine::COMGETTER(CurrentStateModified) (BOOL *aCurrentStateModified) { if (!aCurrentStateModified) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); /* * Note: for machines with no snapshots, we always return FALSE * (mData->mCurrentStateModified will be TRUE in this case, for historical * reasons :) */ *aCurrentStateModified = !mData->mFirstSnapshot ? FALSE : mData->mCurrentStateModified; return S_OK; } STDMETHODIMP Machine::COMGETTER(SharedFolders) (ISharedFolderCollection **aSharedFolders) { if (!aSharedFolders) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); ComObjPtr coll; coll.createObject(); coll->init (mHWData->mSharedFolders); coll.queryInterfaceTo (aSharedFolders); return S_OK; } STDMETHODIMP Machine::COMGETTER(ClipboardMode) (ClipboardMode_T *aClipboardMode) { if (!aClipboardMode) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *aClipboardMode = mHWData->mClipboardMode; return S_OK; } STDMETHODIMP Machine::COMSETTER(ClipboardMode) (ClipboardMode_T aClipboardMode) { AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); mHWData.backup(); mHWData->mClipboardMode = aClipboardMode; return S_OK; } // IMachine methods ///////////////////////////////////////////////////////////////////////////// STDMETHODIMP Machine::SetBootOrder (ULONG aPosition, DeviceType_T aDevice) { if (aPosition < 1 || aPosition > SchemaDefs::MaxBootPosition) return setError (E_INVALIDARG, tr ("Invalid boot position: %lu (must be in range [1, %lu])"), aPosition, SchemaDefs::MaxBootPosition); if (aDevice == DeviceType_USBDevice) return setError (E_FAIL, tr ("Booting from USB devices is not currently supported")); AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); mHWData.backup(); mHWData->mBootOrder [aPosition - 1] = aDevice; return S_OK; } STDMETHODIMP Machine::GetBootOrder (ULONG aPosition, DeviceType_T *aDevice) { if (aPosition < 1 || aPosition > SchemaDefs::MaxBootPosition) return setError (E_INVALIDARG, tr ("Invalid boot position: %lu (must be in range [1, %lu])"), aPosition, SchemaDefs::MaxBootPosition); AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *aDevice = mHWData->mBootOrder [aPosition - 1]; return S_OK; } STDMETHODIMP Machine::AttachHardDisk (INPTR GUIDPARAM aId, DiskControllerType_T aCtl, LONG aDev) { Guid id = aId; if (id.isEmpty() || aCtl == DiskControllerType_InvalidController || aDev < 0 || aDev > 1) return E_INVALIDARG; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); if (!mData->mRegistered) return setError (E_FAIL, tr ("Cannot attach hard disks to an unregistered machine")); AssertReturn (mData->mMachineState != MachineState_Saved, E_FAIL); if (mData->mMachineState >= MachineState_Running) return setError (E_FAIL, tr ("Invalid machine state: %d"), mData->mMachineState); /* see if the device on the controller is already busy */ for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; if (hda->controller() == aCtl && hda->deviceNumber() == aDev) { ComObjPtr hd = hda->hardDisk(); AutoLock hdLock (hd); return setError (E_FAIL, tr ("Hard disk '%ls' is already attached to device slot %d " "on controller %d"), hd->toString().raw(), aDev, aCtl); } } /* find a hard disk by UUID */ ComObjPtr hd; HRESULT rc = mParent->getHardDisk (id, hd); if (FAILED (rc)) return rc; AutoLock hdLock (hd); if (hd->isDifferencing()) return setError (E_FAIL, tr ("Cannot attach the differencing hard disk '%ls'"), hd->toString().raw()); bool dirty = false; switch (hd->type()) { case HardDiskType_ImmutableHardDisk: { Assert (hd->machineId().isEmpty()); /* * increase readers to protect from unregistration * until rollback()/commit() is done */ hd->addReader(); // LogTraceMsg (("A: %ls proteced\n", hd->toString().raw())); dirty = true; break; } case HardDiskType_WritethroughHardDisk: { Assert (hd->children().size() == 0); Assert (hd->snapshotId().isEmpty()); /* fall through */ } case HardDiskType_NormalHardDisk: { if (hd->machineId().isEmpty()) { /* attach directly */ hd->setMachineId (mData->mUuid); // LogTraceMsg (("A: %ls associated with %Vuuid\n", // hd->toString().raw(), mData->mUuid.raw())); dirty = true; } else { /* determine what the hard disk is already attached to */ if (hd->snapshotId().isEmpty()) { /* attached to some VM in its current state */ if (hd->machineId() == mData->mUuid) { /* * attached to us, either in the backed up list of the * attachments or in the current one; the former is ok * (reattachment takes place within the same * "transaction") the latter is an error so check for it */ for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { if ((*it)->hardDisk().equalsTo (hd)) { return setError (E_FAIL, tr ("Normal/Writethrough hard disk '%ls' is " "currently attached to device slot %d " "on controller %d of this machine"), hd->toString().raw(), (*it)->deviceNumber(), (*it)->controller()); } } /* * dirty = false to indicate we didn't set machineId * and prevent it from being reset in DetachHardDisk() */ // LogTraceMsg (("A: %ls found in old\n", hd->toString().raw())); } else { /* attached to other VM */ return setError (E_FAIL, tr ("Normal/Writethrough hard disk '%ls' is " "currently attached to a machine with " "UUID {%Vuuid}"), hd->toString().raw(), hd->machineId().raw()); } } else { /* * here we go when the HardDiskType_NormalHardDisk * is attached to some VM (probably to this one, too) * at some particular snapshot, so we can create a diff * based on it */ Assert (!hd->machineId().isEmpty()); /* * increase readers to protect from unregistration * until rollback()/commit() is done */ hd->addReader(); // LogTraceMsg (("A: %ls proteced\n", hd->toString().raw())); dirty = true; } } break; } } ComObjPtr attachment; attachment.createObject(); attachment->init (hd, aCtl, aDev, dirty); mHDData.backup(); mHDData->mHDAttachments.push_back (attachment); // LogTraceMsg (("A: %ls attached\n", hd->toString().raw())); /* note: diff images are actually created only in commit() */ return S_OK; } STDMETHODIMP Machine::GetHardDisk (DiskControllerType_T aCtl, LONG aDev, IHardDisk **aHardDisk) { if (aCtl == DiskControllerType_InvalidController || aDev < 0 || aDev > 1) return E_INVALIDARG; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); *aHardDisk = NULL; for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; if (hda->controller() == aCtl && hda->deviceNumber() == aDev) { hda->hardDisk().queryInterfaceTo (aHardDisk); return S_OK; } } return setError (E_INVALIDARG, tr ("No hard disk attached to device slot %d on controller %d"), aDev, aCtl); } STDMETHODIMP Machine::DetachHardDisk (DiskControllerType_T aCtl, LONG aDev) { if (aCtl == DiskControllerType_InvalidController || aDev < 0 || aDev > 1) return E_INVALIDARG; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); AssertReturn (mData->mMachineState != MachineState_Saved, E_FAIL); if (mData->mMachineState >= MachineState_Running) return setError (E_FAIL, tr ("Invalid machine state: %d"), mData->mMachineState); for (HDData::HDAttachmentList::iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; if (hda->controller() == aCtl && hda->deviceNumber() == aDev) { ComObjPtr hd = hda->hardDisk(); AutoLock hdLock (hd); ComAssertRet (hd->children().size() == 0 && hd->machineId() == mData->mUuid, E_FAIL); if (hda->isDirty()) { switch (hd->type()) { case HardDiskType_ImmutableHardDisk: { /* decrease readers increased in AttachHardDisk() */ hd->releaseReader(); // LogTraceMsg (("D: %ls released\n", hd->toString().raw())); break; } case HardDiskType_WritethroughHardDisk: { /* deassociate from this machine */ hd->setMachineId (Guid()); // LogTraceMsg (("D: %ls deassociated\n", hd->toString().raw())); break; } case HardDiskType_NormalHardDisk: { if (hd->snapshotId().isEmpty()) { /* deassociate from this machine */ hd->setMachineId (Guid()); // LogTraceMsg (("D: %ls deassociated\n", hd->toString().raw())); } else { /* decrease readers increased in AttachHardDisk() */ hd->releaseReader(); // LogTraceMsg (("%ls released\n", hd->toString().raw())); } break; } } } mHDData.backup(); /* * we cannot use erase (it) below because backup() above will create * a copy of the list and make this copy active, but the iterator * still refers to the original and is not valid for a copy */ mHDData->mHDAttachments.remove (hda); // LogTraceMsg (("D: %ls detached\n", hd->toString().raw())); /* * note: Non-dirty hard disks are actually deassociated * and diff images are deleted only in commit() */ return S_OK; } } return setError (E_INVALIDARG, tr ("No hard disk attached to device slot %d on controller %d"), aDev, aCtl); } STDMETHODIMP Machine::GetNetworkAdapter (ULONG slot, INetworkAdapter **adapter) { if (!adapter) return E_POINTER; if (slot >= ELEMENTS (mNetworkAdapters)) return setError (E_INVALIDARG, tr ("Invalid slot number: %d"), slot); AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); mNetworkAdapters [slot].queryInterfaceTo (adapter); return S_OK; } /** * Returns the extra data key name following the given key. If the key * is not found, an error is returned. If NULL is supplied, the first * key will be returned. If key is the last item, NULL will be returned. * * @returns COM status code * @param key extra data key name * @param nextKey name of the key following "key". NULL if "key" is the last. * @param nextValue value of the key following "key". Optional parameter. */ STDMETHODIMP Machine::GetNextExtraDataKey(INPTR BSTR key, BSTR *nextKey, BSTR *nextValue) { if (!nextKey) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); /* start with nothing found */ *nextKey = NULL; /* * if we're ready and isConfigLocked() is FALSE then it means * that no config file exists yet, so return shortly */ if (!isConfigLocked()) return S_OK; HRESULT rc = S_OK; /* load the config file */ CFGHANDLE configLoader = 0; rc = openConfigLoader (&configLoader); if (FAILED (rc)) return E_FAIL; CFGNODE machineNode; CFGNODE extraDataNode; /* navigate to the right position */ if (VBOX_SUCCESS(CFGLDRGetNode(configLoader, "VirtualBox/Machine", 0, &machineNode)) && VBOX_SUCCESS(CFGLDRGetChildNode(machineNode, "ExtraData", 0, &extraDataNode))) { /* check if it exists */ bool found = false; unsigned count; CFGNODE extraDataItemNode; CFGLDRCountChildren(extraDataNode, "ExtraDataItem", &count); for (unsigned i = 0; (i < count) && (found == false); i++) { Bstr name; CFGLDRGetChildNode(extraDataNode, "ExtraDataItem", i, &extraDataItemNode); CFGLDRQueryBSTR(extraDataItemNode, "name", name.asOutParam()); /* if we're supposed to return the first one */ if (key == NULL) { name.cloneTo(nextKey); if (nextValue) CFGLDRQueryBSTR(extraDataItemNode, "value", nextValue); found = true; } /* did we find the key we're looking for? */ else if (name == key) { found = true; /* is there another item? */ if (i + 1 < count) { CFGLDRGetChildNode(extraDataNode, "ExtraDataItem", i + 1, &extraDataItemNode); CFGLDRQueryBSTR(extraDataItemNode, "name", name.asOutParam()); name.cloneTo(nextKey); if (nextValue) CFGLDRQueryBSTR(extraDataItemNode, "value", nextValue); found = true; } else { /* it's the last one */ *nextKey = NULL; } } CFGLDRReleaseNode(extraDataItemNode); } /* if we haven't found the key, it's an error */ if (!found) rc = setError(E_FAIL, tr("Could not find extra data key")); CFGLDRReleaseNode(extraDataNode); CFGLDRReleaseNode(machineNode); } closeConfigLoader (configLoader, false /* aSaveBeforeClose */); return rc; } /** * Returns associated extra data from the configuration. If the key does * not exist, NULL will be stored in the output pointer. * * @returns COM status code * @param key extra data key * @param value address of result pointer */ STDMETHODIMP Machine::GetExtraData(INPTR BSTR key, BSTR *value) { if (!key) return E_INVALIDARG; if (!value) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); /* start with nothing found */ *value = NULL; /* * if we're ready and isConfigLocked() is FALSE then it means * that no config file exists yet, so return shortly */ if (!isConfigLocked()) return S_OK; HRESULT rc = S_OK; /* load the config file */ CFGHANDLE configLoader = 0; rc = openConfigLoader (&configLoader); if (FAILED (rc)) return E_FAIL; CFGNODE machineNode; CFGNODE extraDataNode; /* navigate to the right position */ if (VBOX_SUCCESS(CFGLDRGetNode(configLoader, "VirtualBox/Machine", 0, &machineNode)) && VBOX_SUCCESS(CFGLDRGetChildNode(machineNode, "ExtraData", 0, &extraDataNode))) { /* check if it exists */ bool found = false; unsigned count; CFGNODE extraDataItemNode; CFGLDRCountChildren(extraDataNode, "ExtraDataItem", &count); for (unsigned i = 0; (i < count) && (found == false); i++) { Bstr name; CFGLDRGetChildNode(extraDataNode, "ExtraDataItem", i, &extraDataItemNode); CFGLDRQueryBSTR(extraDataItemNode, "name", name.asOutParam()); if (name == key) { found = true; CFGLDRQueryBSTR(extraDataItemNode, "value", value); } CFGLDRReleaseNode(extraDataItemNode); } CFGLDRReleaseNode(extraDataNode); CFGLDRReleaseNode(machineNode); } rc = closeConfigLoader (configLoader, false /* aSaveBeforeClose */); return rc; } /** * Stores associated extra data in the configuration. If the data value is NULL * then the corresponding extra data item is deleted. This method can be called * outside a session and therefore belongs to the non protected machine data. * * @param key extra data key * @param value extra data value * * @note Locks mParent for reading + this object for writing. */ STDMETHODIMP Machine::SetExtraData (INPTR BSTR key, INPTR BSTR value) { if (!key) return E_INVALIDARG; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); /* VirtualBox::onExtraDataCanChange() needs mParent lock */ AutoMultiLock <2> alock (mParent->rlock(), this->wlock()); if (mType == IsSnapshotMachine) CHECK_SETTER(); bool changed = false; HRESULT rc = S_OK; /* * if we're ready and isConfigLocked() is FALSE then it means * that no config file exists yet, so call saveSettings() to create one */ if (!isConfigLocked()) { rc = saveSettings (false /* aMarkCurStateAsModified */); if (FAILED (rc)) return rc; } /* load the config file */ CFGHANDLE configLoader = 0; rc = openConfigLoader (&configLoader); if (FAILED (rc)) return rc; CFGNODE machineNode = 0; CFGNODE extraDataNode = 0; int vrc = CFGLDRGetNode (configLoader, "VirtualBox/Machine", 0, &machineNode); if (VBOX_FAILURE (vrc)) vrc = CFGLDRCreateNode (configLoader, "VirtualBox/Machine", &machineNode); vrc = CFGLDRGetChildNode (machineNode, "ExtraData", 0, &extraDataNode); if (VBOX_FAILURE (vrc) && value) vrc = CFGLDRCreateChildNode (machineNode, "ExtraData", &extraDataNode); if (extraDataNode) { CFGNODE extraDataItemNode = 0; Bstr oldVal; unsigned count; CFGLDRCountChildren (extraDataNode, "ExtraDataItem", &count); for (unsigned i = 0; i < count; i++) { CFGLDRGetChildNode (extraDataNode, "ExtraDataItem", i, &extraDataItemNode); Bstr name; CFGLDRQueryBSTR (extraDataItemNode, "name", name.asOutParam()); if (name == key) { CFGLDRQueryBSTR (extraDataItemNode, "value", oldVal.asOutParam()); break; } CFGLDRReleaseNode (extraDataItemNode); extraDataItemNode = 0; } /* * When no key is found, oldVal is null * Note: * 1. when oldVal is null, |oldVal == (BSTR) NULL| is true * 2. we cannot do |oldVal != value| because it will compare * BSTR pointers instead of strings (due to type conversion ops) */ changed = !(oldVal == value); if (changed) { /* ask for permission from all listeners */ if (!mParent->onExtraDataCanChange (mData->mUuid, key, value)) { LogWarningFunc (("Someone vetoed! Change refused!\n")); rc = setError (E_ACCESSDENIED, tr ("Could not set extra data because someone refused " "the requested change of '%ls' to '%ls'"), key, value); } else { if (value) { if (!extraDataItemNode) { /* create a new item */ CFGLDRAppendChildNode (extraDataNode, "ExtraDataItem", &extraDataItemNode); CFGLDRSetBSTR (extraDataItemNode, "name", key); } CFGLDRSetBSTR (extraDataItemNode, "value", value); } else { /* an old value does for sure exist here */ CFGLDRDeleteNode (extraDataItemNode); extraDataItemNode = 0; } } } if (extraDataItemNode) CFGLDRReleaseNode (extraDataItemNode); CFGLDRReleaseNode (extraDataNode); } CFGLDRReleaseNode (machineNode); if (SUCCEEDED (rc) && changed) rc = closeConfigLoader (configLoader, true /* aSaveBeforeClose */); else closeConfigLoader (configLoader, false /* aSaveBeforeClose */); /* fire an event */ if (SUCCEEDED (rc) && changed) { mParent->onExtraDataChange (mData->mUuid, key, value); } return rc; } STDMETHODIMP Machine::SaveSettings() { AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); /* Under some circumstancies, saveSettings() needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); CHECK_SETTER(); /* the settings file path may never be null */ ComAssertRet (mData->mConfigFileFull, E_FAIL); /* save all VM data excluding snapshots */ return saveSettings(); } STDMETHODIMP Machine::DiscardSettings() { AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); /* * during this rollback, the session will be notified if data has * been actually changed */ rollback (true /* aNotify */); return S_OK; } STDMETHODIMP Machine::DeleteSettings() { AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); if (mData->mRegistered) return setError (E_FAIL, tr ("Cannot delete settings of a registered machine")); /* delete the settings only when the file actually exists */ if (isConfigLocked()) { unlockConfig(); int vrc = RTFileDelete (Utf8Str (mData->mConfigFileFull)); if (VBOX_FAILURE (vrc)) return setError (E_FAIL, tr ("Could not delete the settings file '%ls' (%Vrc)"), mData->mConfigFileFull.raw(), vrc); /* delete the Logs folder, nothing important should be left * there (we don't check for errors because the user might have * some private files there that we don't want to delete) */ Utf8Str logFolder; getLogFolder (logFolder); Assert (!logFolder.isEmpty()); if (RTDirExists (logFolder)) { /* delete all VBox.log[.N] files from the Logs folder * (this must be in sync with the rotation logic in * Console::powerUpThread()) */ Utf8Str log = Utf8StrFmt ("%s/VBox.log", logFolder.raw()); RTFileDelete (log); for (int i = 3; i >= 0; i--) { log = Utf8StrFmt ("%s/VBox.log.%d", logFolder.raw(), i); RTFileDelete (log); } RTDirRemove (logFolder); } /* delete the Snapshots folder, nothing important should be left * there (we don't check for errors because the user might have * some private files there that we don't want to delete) */ Utf8Str snapshotFolder = mUserData->mSnapshotFolderFull; Assert (!snapshotFolder.isEmpty()); if (RTDirExists (snapshotFolder)) RTDirRemove (snapshotFolder); /* delete the directory that contains the settings file, but only * if it matches the VM name (i.e. a structure created by default in * openConfigLoader()) */ { Utf8Str settingsDir; if (isInOwnDir (&settingsDir)) RTDirRemove (settingsDir); } } return S_OK; } STDMETHODIMP Machine::GetSnapshot (INPTR GUIDPARAM aId, ISnapshot **aSnapshot) { if (!aSnapshot) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); Guid id = aId; ComObjPtr snapshot; HRESULT rc = findSnapshot (id, snapshot, true /* aSetError */); snapshot.queryInterfaceTo (aSnapshot); return rc; } STDMETHODIMP Machine::FindSnapshot (INPTR BSTR aName, ISnapshot **aSnapshot) { if (!aName) return E_INVALIDARG; if (!aSnapshot) return E_POINTER; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); ComObjPtr snapshot; HRESULT rc = findSnapshot (aName, snapshot, true /* aSetError */); snapshot.queryInterfaceTo (aSnapshot); return rc; } STDMETHODIMP Machine::SetCurrentSnapshot (INPTR GUIDPARAM aId) { /// @todo (dmik) don't forget to set // mData->mCurrentStateModified to FALSE return setError (E_NOTIMPL, "Not implemented"); } STDMETHODIMP Machine::CreateSharedFolder (INPTR BSTR aName, INPTR BSTR aHostPath) { if (!aName || !aHostPath) return E_INVALIDARG; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); CHECK_SETTER(); /// @todo (dmik) check global shared folders when they are done ComObjPtr sharedFolder; HRESULT rc = findSharedFolder (aName, sharedFolder, false /* aSetError */); if (SUCCEEDED (rc)) return setError (E_FAIL, tr ("Shared folder named '%ls' already exists"), aName); sharedFolder.createObject(); rc = sharedFolder->init (machine(), aName, aHostPath); if (FAILED (rc)) return rc; BOOL accessible = FALSE; rc = sharedFolder->COMGETTER(Accessible) (&accessible); if (FAILED (rc)) return rc; if (!accessible) return setError (E_FAIL, tr ("Shared folder path '%ls' is not accessible"), aHostPath); mHWData.backup(); mHWData->mSharedFolders.push_back (sharedFolder); return S_OK; } STDMETHODIMP Machine::RemoveSharedFolder (INPTR BSTR aName) { if (!aName) return E_INVALIDARG; AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoReaderLock alock (this); CHECK_SETTER(); ComObjPtr sharedFolder; HRESULT rc = findSharedFolder (aName, sharedFolder, true /* aSetError */); if (FAILED (rc)) return rc; mHWData.backup(); mHWData->mSharedFolders.remove (sharedFolder); return S_OK; } // public methods for internal purposes ///////////////////////////////////////////////////////////////////////////// /** * Returns the session machine object associated with the this machine. * The returned session machine is null if no direct session is currently open. * * @Note locks this object for reading. */ ComObjPtr Machine::sessionMachine() { ComObjPtr sm; AutoCaller autoCaller (this); /* the machine may be inaccessible, so don't assert below */ if (FAILED (autoCaller.rc())) return sm; AutoReaderLock alock (this); sm = mData->mSession.mMachine; Assert (!sm.isNull() || mData->mSession.mState != SessionState_SessionOpen); return sm; } /** * Calculates the absolute path of the given path taking the directory of * the machine settings file as the current directory. * * @param aPath path to calculate the absolute path for * @param aResult where to put the result (used only on success, * so can be the same Utf8Str instance as passed as \a aPath) * @return VirtualBox result * * @note Locks this object for reading. */ int Machine::calculateFullPath (const char *aPath, Utf8Str &aResult) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AutoReaderLock alock (this); AssertReturn (!mData->mConfigFileFull.isNull(), VERR_GENERAL_FAILURE); Utf8Str settingsDir = mData->mConfigFileFull; RTPathStripFilename (settingsDir.mutableRaw()); char folder [RTPATH_MAX]; int vrc = RTPathAbsEx (settingsDir, aPath, folder, sizeof (folder)); if (VBOX_SUCCESS (vrc)) aResult = folder; return vrc; } /** * Tries to calculate the relative path of the given absolute path using the * directory of the machine settings file as the base directory. * * @param aPath absolute path to calculate the relative path for * @param aResult where to put the result (used only when it's possible to * make a relative path from the given absolute path; * otherwise left untouched) * * @note Locks this object for reading. */ void Machine::calculateRelativePath (const char *aPath, Utf8Str &aResult) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), (void) 0); AutoReaderLock alock (this); AssertReturnVoid (!mData->mConfigFileFull.isNull()); Utf8Str settingsDir = mData->mConfigFileFull; RTPathStripFilename (settingsDir.mutableRaw()); if (RTPathStartsWith (aPath, settingsDir)) { /* when assigning, we create a separate Utf8Str instance because both * aPath and aResult can point to the same memory location when this * func is called (if we just do aResult = aPath, aResult will be freed * first, and since its the same as aPath, an attempt to copy garbage * will be made. */ aResult = Utf8Str (aPath + settingsDir.length() + 1); } } /** * Returns the full path to the machine's log folder in the * \a aLogFolder argument. */ void Machine::getLogFolder (Utf8Str &aLogFolder) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), (void) 0); AutoReaderLock alock (this); Utf8Str settingsDir; if (isInOwnDir (&settingsDir)) { /* Log folder is //Logs */ aLogFolder = Utf8StrFmt ("%s%cLogs", settingsDir.raw(), RTPATH_DELIMITER); } else { /* Log folder is //Logs */ Assert (!mUserData->mSnapshotFolderFull.isEmpty()); aLogFolder = Utf8StrFmt ("%ls%cLogs", mUserData->mSnapshotFolderFull.raw(), RTPATH_DELIMITER); } } /** * @note Locks mParent and this object for writing, * calls the client process (outside the lock). */ HRESULT Machine::openSession (IInternalSessionControl *aControl) { LogFlowThisFuncEnter(); AssertReturn (aControl, E_FAIL); AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); /* We need VirtualBox lock because of Progress::notifyComplete() */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); if (!mData->mRegistered) return setError (E_UNEXPECTED, tr ("The machine '%ls' is not registered"), mUserData->mName.raw()); LogFlowThisFunc (("mSession.mState=%d\n", mData->mSession.mState)); if (mData->mSession.mState == SessionState_SessionOpen || mData->mSession.mState == SessionState_SessionClosing) return setError (E_ACCESSDENIED, tr ("A session for the machine '%ls' is currently open " "(or being closed)"), mUserData->mName.raw()); /* may not be Running */ AssertReturn (mData->mMachineState < MachineState_Running, E_FAIL); if (mData->mSession.mState == SessionState_SessionSpawning) { /* * this machine awaits for a spawning session to be opened, * so reject any other open attempts from processes other than * one started by #openRemoteSession(). */ RTPROCESS pid = NIL_RTPROCESS; AssertCompile (sizeof (ULONG) == sizeof (RTPROCESS)); aControl->GetPID (&pid); LogFlowThisFunc (("mSession.mPid=%d(0x%x)\n", mData->mSession.mPid, mData->mSession.mPid)); LogFlowThisFunc (("session.pid=%d(0x%x)\n", pid, pid)); if (mData->mSession.mPid != pid) return setError (E_ACCESSDENIED, tr ("An unexpected process (PID=0x%08X) has tried to open a direct " "session with the machine named '%ls', while only a process " "started by OpenRemoteSession (PID=0x%08X) is allowed"), pid, mUserData->mName.raw(), mData->mSession.mPid); } /* create a SessionMachine object */ ComObjPtr sessionMachine; sessionMachine.createObject(); HRESULT rc = sessionMachine->init (this); AssertComRC (rc); if (SUCCEEDED (rc)) { /* * Set the session state to Spawning to protect against subsequent * attempts to open a session and to unregister the machine after * we leave the lock. */ SessionState_T origState = mData->mSession.mState; mData->mSession.mState = SessionState_SessionSpawning; /* * Leave the lock before calling the client process -- it will call * Machine/SessionMachine methods. Leaving the lock here is quite safe * because the state is Spawning, so that openRemotesession() and * openExistingSession() calls will fail. This method, called before we * enter the lock again, will fail because of the wrong PID. * * Note that mData->mSession.mRemoteControls accessed outside * the lock may not be modified when state is Spawning, so it's safe. */ alock.leave(); LogFlowThisFunc (("Calling AssignMachine()...\n")); rc = aControl->AssignMachine (sessionMachine); LogFlowThisFunc (("AssignMachine() returned %08X\n", rc)); /* The failure may w/o any error info (from RPC), so provide one */ if (FAILED (rc)) setError (rc, tr ("Failed to assign the machine to the session")); if (SUCCEEDED (rc) && origState == SessionState_SessionSpawning) { /* complete the remote session initialization */ /* get the console from the direct session */ ComPtr console; rc = aControl->GetRemoteConsole (console.asOutParam()); ComAssertComRC (rc); if (SUCCEEDED (rc) && !console) { ComAssert (!!console); rc = E_FAIL; } /* assign machine & console to the remote sesion */ if (SUCCEEDED (rc)) { /* * after openRemoteSession(), the first and the only * entry in remoteControls is that remote session */ LogFlowThisFunc (("Calling AssignRemoteMachine()...\n")); rc = mData->mSession.mRemoteControls.front()-> AssignRemoteMachine (sessionMachine, console); LogFlowThisFunc (("AssignRemoteMachine() returned %08X\n", rc)); /* The failure may w/o any error info (from RPC), so provide one */ if (FAILED (rc)) setError (rc, tr ("Failed to assign the machine to the remote session")); } if (FAILED (rc)) aControl->Uninitialize(); } /* enter the lock again */ alock.enter(); /* Restore the session state */ mData->mSession.mState = origState; } /* finalize spawning amyway (this is why we don't return on errors above) */ if (mData->mSession.mState == SessionState_SessionSpawning) { /* Note that the progress object is finalized later */ /* We don't reset mSession.mPid here because it is necessary for * SessionMachine::uninit() to reap the child process later. */ if (FAILED (rc)) { /* Remove the remote control from the list on failure * and reset session state to Closed. */ mData->mSession.mRemoteControls.clear(); mData->mSession.mState = SessionState_SessionClosed; } } if (SUCCEEDED (rc)) { /* memorize the direct session control */ mData->mSession.mDirectControl = aControl; mData->mSession.mState = SessionState_SessionOpen; /* associate the SessionMachine with this Machine */ mData->mSession.mMachine = sessionMachine; } if (mData->mSession.mProgress) { /* finalize the progress after setting the state, for consistency */ mData->mSession.mProgress->notifyComplete (rc); mData->mSession.mProgress.setNull(); } /* uninitialize the created session machine on failure */ if (FAILED (rc)) sessionMachine->uninit(); LogFlowThisFunc (("rc=%08X\n", rc)); LogFlowThisFuncLeave(); return rc; } /** * @note Locks this object for writing, calls the client process * (inside the lock). */ HRESULT Machine::openRemoteSession (IInternalSessionControl *aControl, INPTR BSTR aType, Progress *aProgress) { LogFlowThisFuncEnter(); AssertReturn (aControl, E_FAIL); AssertReturn (aProgress, E_FAIL); AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); if (!mData->mRegistered) return setError (E_UNEXPECTED, tr ("The machine '%ls' is not registered"), mUserData->mName.raw()); LogFlowThisFunc (("mSession.mState=%d\n", mData->mSession.mState)); if (mData->mSession.mState == SessionState_SessionOpen || mData->mSession.mState == SessionState_SessionSpawning || mData->mSession.mState == SessionState_SessionClosing) return setError (E_ACCESSDENIED, tr ("A session for the machine '%ls' is currently open " "(or being opened or closed)"), mUserData->mName.raw()); /* may not be Running */ AssertReturn (mData->mMachineState < MachineState_Running, E_FAIL); /* get the path to the executable */ char path [RTPATH_MAX]; RTPathProgram (path, RTPATH_MAX); size_t sz = strlen (path); path [sz++] = RTPATH_DELIMITER; path [sz] = 0; char *cmd = path + sz; sz = RTPATH_MAX - sz; int vrc = VINF_SUCCESS; RTPROCESS pid = NIL_RTPROCESS; Bstr type (aType); if (type == "gui") { const char VirtualBox_exe[] = "VirtualBox" HOSTSUFF_EXE; Assert (sz >= sizeof (VirtualBox_exe)); strcpy (cmd, VirtualBox_exe); Utf8Str idStr = mData->mUuid.toString(); const char * args[] = {path, "-startvm", idStr, 0 }; vrc = RTProcCreate (path, args, NULL, 0, &pid); } else #ifdef VBOX_VRDP if (type == "vrdp") { const char VBoxVRDP_exe[] = "VBoxVRDP" HOSTSUFF_EXE; Assert (sz >= sizeof (VBoxVRDP_exe)); strcpy (cmd, VBoxVRDP_exe); Utf8Str idStr = mData->mUuid.toString(); const char * args[] = {path, "-startvm", idStr, 0 }; vrc = RTProcCreate (path, args, NULL, 0, &pid); } else #endif /* VBOX_VRDP */ if (type == "capture") { const char VBoxVRDP_exe[] = "VBoxVRDP" HOSTSUFF_EXE; Assert (sz >= sizeof (VBoxVRDP_exe)); strcpy (cmd, VBoxVRDP_exe); Utf8Str idStr = mData->mUuid.toString(); const char * args[] = {path, "-startvm", idStr, "-capture", 0 }; vrc = RTProcCreate (path, args, NULL, 0, &pid); } else { return setError (E_INVALIDARG, tr ("Invalid session type: '%ls'"), aType); } if (VBOX_FAILURE (vrc)) return setError (E_FAIL, tr ("Could not launch a process for the machine '%ls' (%Vrc)"), mUserData->mName.raw(), vrc); LogFlowThisFunc (("launched.pid=%d(0x%x)\n", pid, pid)); /* * Note that we don't leave the lock here before calling the client, * because it doesn't need to call us back if called with a NULL argument. * Leaving the lock herer is dangerous because we didn't prepare the * launch data yet, but the client we've just started may happen to be * too fast and call openSession() that will fail (because of PID, etc.), * so that the Machine will never get out of the Spawning session state. */ /* inform the session that it will be a remote one */ LogFlowThisFunc (("Calling AssignMachine (NULL)...\n")); HRESULT rc = aControl->AssignMachine (NULL); LogFlowThisFunc (("AssignMachine (NULL) returned %08X\n", rc)); if (FAILED (rc)) { /* restore the session state */ mData->mSession.mState = SessionState_SessionClosed; /* The failure may w/o any error info (from RPC), so provide one */ return setError (rc, tr ("Failed to assign the machine to the session")); } /* attach launch data to the machine */ Assert (mData->mSession.mPid == NIL_RTPROCESS); mData->mSession.mRemoteControls.push_back (aControl); mData->mSession.mProgress = aProgress; mData->mSession.mPid = pid; mData->mSession.mState = SessionState_SessionSpawning; LogFlowThisFuncLeave(); return S_OK; } /** * @note Locks this object for writing, calls the client process * (outside the lock). */ HRESULT Machine::openExistingSession (IInternalSessionControl *aControl) { LogFlowThisFuncEnter(); AssertReturn (aControl, E_FAIL); AutoCaller autoCaller (this); CheckComRCReturnRC (autoCaller.rc()); AutoLock alock (this); if (!mData->mRegistered) return setError (E_UNEXPECTED, tr ("The machine '%ls' is not registered"), mUserData->mName.raw()); LogFlowThisFunc (("mSession.state=%d\n", mData->mSession.mState)); if (mData->mSession.mState != SessionState_SessionOpen) return setError (E_ACCESSDENIED, tr ("The machine '%ls' does not have an open session"), mUserData->mName.raw()); ComAssertRet (!mData->mSession.mDirectControl.isNull(), E_FAIL); /* * Get the console from the direct session (note that we don't leave the * lock here because GetRemoteConsole must not call us back). */ ComPtr console; HRESULT rc = mData->mSession.mDirectControl-> GetRemoteConsole (console.asOutParam()); if (FAILED (rc)) { /* The failure may w/o any error info (from RPC), so provide one */ return setError (rc, tr ("Failed to get a console object from the direct session")); } ComAssertRet (!console.isNull(), E_FAIL); ComObjPtr sessionMachine = mData->mSession.mMachine; AssertReturn (!sessionMachine.isNull(), E_FAIL); /* * Leave the lock before calling the client process. It's safe here * since the only thing to do after we get the lock again is to add * the remote control to the list (which doesn't directly influence * anything). */ alock.leave(); /* attach the remote session to the machine */ LogFlowThisFunc (("Calling AssignRemoteMachine()...\n")); rc = aControl->AssignRemoteMachine (sessionMachine, console); LogFlowThisFunc (("AssignRemoteMachine() returned %08X\n", rc)); /* The failure may w/o any error info (from RPC), so provide one */ if (FAILED (rc)) return setError (rc, tr ("Failed to assign the machine to the session")); alock.enter(); /* need to revalidate the state after entering the lock again */ if (mData->mSession.mState != SessionState_SessionOpen) { aControl->Uninitialize(); return setError (E_ACCESSDENIED, tr ("The machine '%ls' does not have an open session"), mUserData->mName.raw()); } /* store the control in the list */ mData->mSession.mRemoteControls.push_back (aControl); LogFlowThisFuncLeave(); return S_OK; } /** * Checks that the registered flag of the machine can be set according to * the argument and sets it. On success, commits and saves all settings. * * @note When this machine is inaccessible, the only valid value for \a * aRegistered is FALSE (i.e. unregister the machine) because unregistered * inaccessible machines are not currently supported. Note that unregistering * an inaccessible machine will \b uninitialize this machine object. Therefore, * the caller must make sure there are no active Machine::addCaller() calls * on the current thread because this will block Machine::uninit(). * * @note Locks this object and children for writing! */ HRESULT Machine::trySetRegistered (BOOL aRegistered) { AutoLimitedCaller autoCaller (this); AssertComRCReturnRC (autoCaller.rc()); AutoLock alock (this); ComAssertRet (mData->mRegistered != aRegistered, E_FAIL); if (!mData->mAccessible) { /* A special case: the machine is not accessible. */ /* inaccessible machines can only be unregistered */ AssertReturn (!aRegistered, E_FAIL); /* Uninitialize ourselves here because currently there may be no * unregistered that are inaccessible (this state combination is not * supported). Note releasing the caller and leaving the lock before * calling uninit() */ alock.leave(); autoCaller.release(); uninit(); return S_OK; } AssertReturn (autoCaller.state() == Ready, E_FAIL); if (aRegistered) { if (mData->mRegistered) return setError (E_FAIL, tr ("The machine '%ls' with UUID {%s} is already registered"), mUserData->mName.raw(), mData->mUuid.toString().raw()); } else { if (mData->mMachineState == MachineState_Saved) return setError (E_FAIL, tr ("Cannot unregister the machine '%ls' because it " "is in the Saved state"), mUserData->mName.raw()); size_t snapshotCount = 0; if (mData->mFirstSnapshot) snapshotCount = mData->mFirstSnapshot->descendantCount() + 1; if (snapshotCount) return setError (E_FAIL, tr ("Cannot unregister the machine '%ls' because it " "has %d snapshots"), mUserData->mName.raw(), snapshotCount); if (mData->mSession.mState != SessionState_SessionClosed) return setError (E_FAIL, tr ("Cannot unregister the machine '%ls' because it has an " "open session"), mUserData->mName.raw()); if (mHDData->mHDAttachments.size() != 0) return setError (E_FAIL, tr ("Cannot unregister the machine '%ls' because it " "has %d hard disks attached"), mUserData->mName.raw(), mHDData->mHDAttachments.size()); } /* Ensure the settings are saved. If we are going to be registered and * isConfigLocked() is FALSE then it means that no config file exists yet, * so create it. */ if (isModified() || (aRegistered && !isConfigLocked())) { HRESULT rc = saveSettings(); CheckComRCReturnRC (rc); } mData->mRegistered = aRegistered; /* inform the USB proxy about all attached/detached USB filters */ mUSBController->onMachineRegistered (aRegistered); return S_OK; } // protected methods ///////////////////////////////////////////////////////////////////////////// /** * Helper to uninitialize all associated child objects * and to free all data structures. * * This method must be called as a part of the object's uninitialization * procedure (usually done in the uninit() method). * * @note Must be called only from uninit(). */ void Machine::uninitDataAndChildObjects() { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), (void) 0); AssertComRCReturn (autoCaller.state( ) == InUninit, (void) 0); /* tell all our child objects we've been uninitialized */ /* * uninit all children using addDependentChild()/removeDependentChild() * in their init()/uninit() methods */ uninitDependentChildren(); for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) { if (mNetworkAdapters [slot]) { mNetworkAdapters [slot]->uninit(); unconst (mNetworkAdapters [slot]).setNull(); } } if (mUSBController) { mUSBController->uninit(); unconst (mUSBController).setNull(); } if (mAudioAdapter) { mAudioAdapter->uninit(); unconst (mAudioAdapter).setNull(); } if (mFloppyDrive) { mFloppyDrive->uninit(); unconst (mFloppyDrive).setNull(); } if (mDVDDrive) { mDVDDrive->uninit(); unconst (mDVDDrive).setNull(); } #ifdef VBOX_VRDP if (mVRDPServer) { mVRDPServer->uninit(); unconst (mVRDPServer).setNull(); } #endif if (mBIOSSettings) { mBIOSSettings->uninit(); unconst (mBIOSSettings).setNull(); } /* free data structures */ mSSData.free(); mHDData.free(); mHWData.free(); mUserData.free(); mData.free(); } /** * Helper to change the machine state. * * @note Locks this object for writing. */ HRESULT Machine::setMachineState (MachineState_T aMachineState) { LogFlowThisFuncEnter(); LogFlowThisFunc (("aMachineState=%d\n", aMachineState)); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AutoLock alock (this); if (mData->mMachineState != aMachineState) { mData->mMachineState = aMachineState; RTTIMESPEC time; mData->mLastStateChange = RTTimeSpecGetMilli(RTTimeNow(&time)); mParent->onMachineStateChange (mData->mUuid, aMachineState); } LogFlowThisFuncLeave(); return S_OK; } /** * Searches for a shared folder with the given logical name * in the collection of shared folders. * * @param aName logical name of the shared folder * @param aSharedFolder where to return the found object * @param aSetError whether to set the error info if the folder is * not found * @return * S_OK when found or E_INVALIDARG when not found * * @note * must be called from under the object's lock! */ HRESULT Machine::findSharedFolder (const BSTR aName, ComObjPtr &aSharedFolder, bool aSetError /* = false */) { bool found = false; for (HWData::SharedFolderList::const_iterator it = mHWData->mSharedFolders.begin(); !found && it != mHWData->mSharedFolders.end(); ++ it) { AutoLock alock (*it); found = (*it)->name() == aName; if (found) aSharedFolder = *it; } HRESULT rc = found ? S_OK : E_INVALIDARG; if (aSetError && !found) setError (rc, tr ("Could not find a shared folder named '%ls'"), aName); return rc; } /** * Loads all the VM settings by walking down the node. * * @param aRegistered true when the machine is being loaded on VirtualBox * startup * * @note This method is intended to be called only from init(), so it assumes * all machine data fields have appropriate default values when it is called. * * @note Doesn't lock any objects. */ HRESULT Machine::loadSettings (bool aRegistered) { LogFlowThisFuncEnter(); AssertReturn (mType == IsMachine, E_FAIL); AutoCaller autoCaller (this); AssertReturn (autoCaller.state() == InInit, E_FAIL); HRESULT rc = S_OK; CFGHANDLE configLoader = NULL; char *loaderError = NULL; int vrc = CFGLDRLoad (&configLoader, Utf8Str (mData->mConfigFileFull), mData->mHandleCfgFile, XmlSchemaNS, true, cfgLdrEntityResolver, &loaderError); if (VBOX_FAILURE (vrc)) { rc = setError (E_FAIL, tr ("Could not load the settings file '%ls' (%Vrc)%s%s"), mData->mConfigFileFull.raw(), vrc, loaderError ? ".\n" : "", loaderError ? loaderError : ""); if (loaderError) RTMemTmpFree (loaderError); LogFlowThisFuncLeave(); return rc; } /* * When reading the XML, we assume it has been validated, so we don't * do any structural checks here, Just Assert() some things. */ CFGNODE machineNode = 0; CFGLDRGetNode (configLoader, "VirtualBox/Machine", 0, &machineNode); do { ComAssertBreak (machineNode, rc = E_FAIL); /* uuid (required) */ Guid id; CFGLDRQueryUUID (machineNode, "uuid", id.ptr()); /* If the stored UUID is not empty, it means the registered machine * is being loaded. Compare the loaded UUID with the stored one taken * from the global registry. */ if (!mData->mUuid.isEmpty()) { if (mData->mUuid != id) { rc = setError (E_FAIL, tr ("Machine UUID {%Vuuid} in '%ls' doesn't match its " "UUID {%s} in the registry file '%ls'"), id.raw(), mData->mConfigFileFull.raw(), mData->mUuid.toString().raw(), mParent->settingsFileName().raw()); break; } } else unconst (mData->mUuid) = id; /* name (required) */ CFGLDRQueryBSTR (machineNode, "name", mUserData->mName.asOutParam()); /* nameSync (optional, default is true) */ { bool nameSync = true; CFGLDRQueryBool (machineNode, "nameSync", &nameSync); mUserData->mNameSync = nameSync; } /* OSType (required) */ { Bstr osTypeId; CFGLDRQueryBSTR (machineNode, "OSType", osTypeId.asOutParam()); /* look up the object in our list */ ComPtr guestOSType; rc = mParent->FindGuestOSType (osTypeId, guestOSType.asOutParam()); if (FAILED (rc)) break; mUserData->mOSType = guestOSType; } /* stateFile (optional) */ { Bstr stateFilePath; CFGLDRQueryBSTR (machineNode, "stateFile", stateFilePath.asOutParam()); if (stateFilePath) { Utf8Str stateFilePathFull = stateFilePath; int vrc = calculateFullPath (stateFilePathFull, stateFilePathFull); if (VBOX_FAILURE (vrc)) { rc = setError (E_FAIL, tr ("Invalid saved state file path: '%ls' (%Vrc)"), stateFilePath.raw(), vrc); break; } mSSData->mStateFilePath = stateFilePathFull; } else mSSData->mStateFilePath.setNull(); } /* * currentSnapshot ID (optional) * Note that due to XML Schema constaraints this attribute, when present, * will guaranteedly refer to an existing snapshot definition in XML */ Guid currentSnapshotId; CFGLDRQueryUUID (machineNode, "currentSnapshot", currentSnapshotId.ptr()); /* snapshotFolder (optional) */ { Bstr folder; CFGLDRQueryBSTR (machineNode, "snapshotFolder", folder.asOutParam()); rc = COMSETTER(SnapshotFolder) (folder); if (FAILED (rc)) break; } /* lastStateChange (optional, for compatiblity) */ { int64_t lastStateChange = 0; CFGLDRQueryDateTime (machineNode, "lastStateChange", &lastStateChange); if (lastStateChange == 0) { /// @todo (dmik) until lastStateChange is the required attribute, // we simply set it to the current time if missing in the config RTTIMESPEC time; lastStateChange = RTTimeSpecGetMilli (RTTimeNow (&time)); } mData->mLastStateChange = lastStateChange; } /* aborted (optional) */ bool aborted = false; CFGLDRQueryBool (machineNode, "aborted", &aborted); /* currentStateModified (optional, default is true) */ mData->mCurrentStateModified = TRUE; { bool val = true; CFGLDRQueryBool (machineNode, "currentStateModified", &val); mData->mCurrentStateModified = val; } /* * note: all mUserData members must be assigned prior this point because * we need to commit changes in order to let mUserData be shared by all * snapshot machine instances. */ mUserData.commitCopy(); /* Snapshot node (optional) */ { CFGNODE snapshotNode = 0; CFGLDRGetChildNode (machineNode, "Snapshot", 0, &snapshotNode); if (snapshotNode) { /* read all snapshots recursively */ rc = loadSnapshot (snapshotNode, currentSnapshotId, NULL); CFGLDRReleaseNode (snapshotNode); if (FAILED (rc)) break; } } /* Hardware node (required) */ { CFGNODE hardwareNode = 0; CFGLDRGetChildNode (machineNode, "Hardware", 0, &hardwareNode); ComAssertBreak (hardwareNode, rc = E_FAIL); rc = loadHardware (hardwareNode); CFGLDRReleaseNode (hardwareNode); if (FAILED (rc)) break; } /* HardDiskAttachments node (required) */ { CFGNODE hdasNode = 0; CFGLDRGetChildNode (machineNode, "HardDiskAttachments", 0, &hdasNode); ComAssertBreak (hdasNode, rc = E_FAIL); rc = loadHardDisks (hdasNode, aRegistered); CFGLDRReleaseNode (hdasNode); if (FAILED (rc)) break; } /* * NOTE: the assignment below must be the last thing to do, * otherwise it will be not possible to change the settings * somewehere in the code above because all setters will be * blocked by CHECK_SETTER() */ /* set the machine state to Aborted or Saved when appropriate */ if (aborted) { Assert (!mSSData->mStateFilePath); mSSData->mStateFilePath.setNull(); mData->mMachineState = MachineState_Aborted; } else if (mSSData->mStateFilePath) { mData->mMachineState = MachineState_Saved; } } while (0); if (machineNode) CFGLDRReleaseNode (machineNode); CFGLDRFree (configLoader); LogFlowThisFuncLeave(); return rc; } /** * Recursively loads all snapshots starting from the given. * * @param aNode node * @param aCurSnapshotId current snapshot ID from the settings file * @param aParentSnapshot parent snapshot */ HRESULT Machine::loadSnapshot (CFGNODE aNode, const Guid &aCurSnapshotId, Snapshot *aParentSnapshot) { AssertReturn (aNode, E_INVALIDARG); AssertReturn (mType == IsMachine, E_FAIL); // create a snapshot machine object ComObjPtr snapshotMachine; snapshotMachine.createObject(); HRESULT rc = S_OK; Guid uuid; // required CFGLDRQueryUUID (aNode, "uuid", uuid.ptr()); Bstr stateFilePath; // optional CFGLDRQueryBSTR (aNode, "stateFile", stateFilePath.asOutParam()); if (stateFilePath) { Utf8Str stateFilePathFull = stateFilePath; int vrc = calculateFullPath (stateFilePathFull, stateFilePathFull); if (VBOX_FAILURE (vrc)) return setError (E_FAIL, tr ("Invalid saved state file path: '%ls' (%Vrc)"), stateFilePath.raw(), vrc); stateFilePath = stateFilePathFull; } do { // Hardware node (required) CFGNODE hardwareNode = 0; CFGLDRGetChildNode (aNode, "Hardware", 0, &hardwareNode); ComAssertBreak (hardwareNode, rc = E_FAIL); do { // HardDiskAttachments node (required) CFGNODE hdasNode = 0; CFGLDRGetChildNode (aNode, "HardDiskAttachments", 0, &hdasNode); ComAssertBreak (hdasNode, rc = E_FAIL); // initialize the snapshot machine rc = snapshotMachine->init (this, hardwareNode, hdasNode, uuid, stateFilePath); CFGLDRReleaseNode (hdasNode); } while (0); CFGLDRReleaseNode (hardwareNode); } while (0); if (FAILED (rc)) return rc; // create a snapshot object ComObjPtr snapshot; snapshot.createObject(); { Bstr name; // required CFGLDRQueryBSTR (aNode, "name", name.asOutParam()); LONG64 timeStamp = 0; // required CFGLDRQueryDateTime (aNode, "timeStamp", &timeStamp); Bstr description; // optional { CFGNODE descNode = 0; CFGLDRGetChildNode (aNode, "Description", 0, &descNode); CFGLDRQueryBSTR (descNode, NULL, description.asOutParam()); CFGLDRReleaseNode (descNode); } // initialize the snapshot rc = snapshot->init (uuid, name, description, timeStamp, snapshotMachine, aParentSnapshot); if (FAILED (rc)) return rc; } // memorize the first snapshot if necessary if (!mData->mFirstSnapshot) mData->mFirstSnapshot = snapshot; // memorize the current snapshot when appropriate if (!mData->mCurrentSnapshot && snapshot->data().mId == aCurSnapshotId) mData->mCurrentSnapshot = snapshot; // Snapshots node (optional) { CFGNODE snapshotsNode = 0; CFGLDRGetChildNode (aNode, "Snapshots", 0, &snapshotsNode); if (snapshotsNode) { unsigned cbDisks = 0; CFGLDRCountChildren (snapshotsNode, "Snapshot", &cbDisks); for (unsigned i = 0; i < cbDisks && SUCCEEDED (rc); i++) { CFGNODE snapshotNode; CFGLDRGetChildNode (snapshotsNode, "Snapshot", i, &snapshotNode); ComAssertBreak (snapshotNode, rc = E_FAIL); rc = loadSnapshot (snapshotNode, aCurSnapshotId, snapshot); CFGLDRReleaseNode (snapshotNode); } CFGLDRReleaseNode (snapshotsNode); } } return rc; } /** * @param aNode node */ HRESULT Machine::loadHardware (CFGNODE aNode) { AssertReturn (aNode, E_INVALIDARG); AssertReturn (mType == IsMachine || mType == IsSnapshotMachine, E_FAIL); /* CPU node (currently not required) */ { /* default value in case the node is not there */ mHWData->mHWVirtExEnabled = TriStateBool_Default; CFGNODE cpuNode = 0; CFGLDRGetChildNode (aNode, "CPU", 0, &cpuNode); if (cpuNode) { CFGNODE hwVirtExNode = 0; CFGLDRGetChildNode (cpuNode, "HardwareVirtEx", 0, &hwVirtExNode); if (hwVirtExNode) { Bstr hwVirtExEnabled; CFGLDRQueryBSTR (hwVirtExNode, "enabled", hwVirtExEnabled.asOutParam()); if (hwVirtExEnabled == L"false") mHWData->mHWVirtExEnabled = TriStateBool_False; else if (hwVirtExEnabled == L"true") mHWData->mHWVirtExEnabled = TriStateBool_True; else mHWData->mHWVirtExEnabled = TriStateBool_Default; CFGLDRReleaseNode (hwVirtExNode); } CFGLDRReleaseNode (cpuNode); } } /* Memory node (required) */ { CFGNODE memoryNode = 0; CFGLDRGetChildNode (aNode, "Memory", 0, &memoryNode); ComAssertRet (memoryNode, E_FAIL); uint32_t RAMSize; CFGLDRQueryUInt32 (memoryNode, "RAMSize", &RAMSize); mHWData->mMemorySize = RAMSize; CFGLDRReleaseNode (memoryNode); } /* Boot node (required) */ { /* reset all boot order positions to NoDevice */ for (size_t i = 0; i < ELEMENTS (mHWData->mBootOrder); i++) mHWData->mBootOrder [i] = DeviceType_NoDevice; CFGNODE bootNode = 0; CFGLDRGetChildNode (aNode, "Boot", 0, &bootNode); ComAssertRet (bootNode, E_FAIL); HRESULT rc = S_OK; unsigned cOrder; CFGLDRCountChildren (bootNode, "Order", &cOrder); for (unsigned i = 0; i < cOrder; i++) { CFGNODE orderNode = 0; CFGLDRGetChildNode (bootNode, "Order", i, &orderNode); ComAssertBreak (orderNode, rc = E_FAIL); /* position (required) */ /* position unicity is guaranteed by XML Schema */ uint32_t position = 0; CFGLDRQueryUInt32 (orderNode, "position", &position); -- position; Assert (position < ELEMENTS (mHWData->mBootOrder)); /* device (required) */ Bstr device; CFGLDRQueryBSTR (orderNode, "device", device.asOutParam()); if (device == L"None") mHWData->mBootOrder [position] = DeviceType_NoDevice; else if (device == L"Floppy") mHWData->mBootOrder [position] = DeviceType_FloppyDevice; else if (device == L"DVD") mHWData->mBootOrder [position] = DeviceType_DVDDevice; else if (device == L"HardDisk") mHWData->mBootOrder [position] = DeviceType_HardDiskDevice; else if (device == L"Network") mHWData->mBootOrder [position] = DeviceType_NetworkDevice; else ComAssertMsgFailed (("Invalid device: %ls\n", device.raw())); CFGLDRReleaseNode (orderNode); } CFGLDRReleaseNode (bootNode); if (FAILED (rc)) return rc; } /* Display node (required) */ { CFGNODE displayNode = 0; CFGLDRGetChildNode (aNode, "Display", 0, &displayNode); ComAssertRet (displayNode, E_FAIL); uint32_t VRAMSize; CFGLDRQueryUInt32 (displayNode, "VRAMSize", &VRAMSize); mHWData->mVRAMSize = VRAMSize; CFGLDRReleaseNode (displayNode); } #ifdef VBOX_VRDP /* RemoteDisplay node (optional) */ /// @todo (dmik) move the code to VRDPServer /// @todo r=sunlover: moved. dmik, please review. { CFGNODE remoteDisplayNode = 0; CFGLDRGetChildNode (aNode, "RemoteDisplay", 0, &remoteDisplayNode); if (remoteDisplayNode) { mVRDPServer->loadConfig (remoteDisplayNode); CFGLDRReleaseNode (remoteDisplayNode); } } #endif /* BIOS node (required) */ { CFGNODE biosNode = 0; CFGLDRGetChildNode (aNode, "BIOS", 0, &biosNode); ComAssertRet (biosNode, E_FAIL); HRESULT rc = S_OK; do { /* ACPI */ { CFGNODE acpiNode = 0; CFGLDRGetChildNode (biosNode, "ACPI", 0, &acpiNode); ComAssertBreak (acpiNode, rc = E_FAIL); bool enabled; CFGLDRQueryBool (acpiNode, "enabled", &enabled); mBIOSSettings->COMSETTER(ACPIEnabled)(enabled); CFGLDRReleaseNode (acpiNode); } /* IOAPIC */ { CFGNODE ioapicNode = 0; CFGLDRGetChildNode (biosNode, "IOAPIC", 0, &ioapicNode); if (ioapicNode) { bool enabled; CFGLDRQueryBool (ioapicNode, "enabled", &enabled); mBIOSSettings->COMSETTER(IOAPICEnabled)(enabled); CFGLDRReleaseNode (ioapicNode); } } /* Logo (optional) */ { CFGNODE logoNode = 0; CFGLDRGetChildNode (biosNode, "Logo", 0, &logoNode); if (logoNode) { bool enabled = false; CFGLDRQueryBool (logoNode, "fadeIn", &enabled); mBIOSSettings->COMSETTER(LogoFadeIn)(enabled); CFGLDRQueryBool (logoNode, "fadeOut", &enabled); mBIOSSettings->COMSETTER(LogoFadeOut)(enabled); uint32_t BIOSLogoDisplayTime; CFGLDRQueryUInt32 (logoNode, "displayTime", &BIOSLogoDisplayTime); mBIOSSettings->COMSETTER(LogoDisplayTime)(BIOSLogoDisplayTime); Bstr logoPath; CFGLDRQueryBSTR (logoNode, "imagePath", logoPath.asOutParam()); mBIOSSettings->COMSETTER(LogoImagePath)(logoPath); CFGLDRReleaseNode (logoNode); } } /* boot menu (optional) */ { CFGNODE bootMenuNode = 0; CFGLDRGetChildNode (biosNode, "BootMenu", 0, &bootMenuNode); if (bootMenuNode) { Bstr modeStr; BIOSBootMenuMode_T mode; CFGLDRQueryBSTR (bootMenuNode, "mode", modeStr.asOutParam()); if (modeStr == L"disabled") mode = BIOSBootMenuMode_Disabled; else if (modeStr == L"menuonly") mode = BIOSBootMenuMode_MenuOnly; else mode = BIOSBootMenuMode_MessageAndMenu; mBIOSSettings->COMSETTER(BootMenuMode)(mode); CFGLDRReleaseNode (bootMenuNode); } } } while (0); CFGLDRReleaseNode (biosNode); if (FAILED (rc)) return rc; } /* DVD drive (contains either Image or HostDrive or nothing) */ /// @todo (dmik) move the code to DVDDrive { HRESULT rc = S_OK; CFGNODE dvdDriveNode = 0; CFGLDRGetChildNode (aNode, "DVDDrive", 0, &dvdDriveNode); ComAssertRet (dvdDriveNode, E_FAIL); bool fPassthrough; CFGLDRQueryBool(dvdDriveNode, "passthrough", &fPassthrough); mDVDDrive->COMSETTER(Passthrough)(fPassthrough); CFGNODE typeNode = 0; do { CFGLDRGetChildNode (dvdDriveNode, "Image", 0, &typeNode); if (typeNode) { Guid uuid; CFGLDRQueryUUID (typeNode, "uuid", uuid.ptr()); rc = mDVDDrive->MountImage (uuid); } else { CFGLDRGetChildNode (dvdDriveNode, "HostDrive", 0, &typeNode); if (typeNode) { Bstr src; CFGLDRQueryBSTR (typeNode, "src", src.asOutParam()); /* find the correspoding object */ ComPtr host; rc = mParent->COMGETTER(Host) (host.asOutParam()); ComAssertComRCBreak (rc, rc = rc); ComPtr coll; rc = host->COMGETTER(DVDDrives) (coll.asOutParam()); ComAssertComRCBreak (rc, rc = rc); ComPtr drive; rc = coll->FindByName (src, drive.asOutParam()); if (SUCCEEDED (rc)) rc = mDVDDrive->CaptureHostDrive (drive); else if (rc == E_INVALIDARG) { /* the host DVD drive is not currently available. we * assume it will be available later and create an * extra object now */ ComObjPtr hostDrive; hostDrive.createObject(); rc = hostDrive->init (src); ComAssertComRCBreak (rc, rc = rc); rc = mDVDDrive->CaptureHostDrive (hostDrive); } else ComAssertComRCBreak (rc, rc = rc); } } } while (0); if (typeNode) CFGLDRReleaseNode (typeNode); CFGLDRReleaseNode (dvdDriveNode); if (FAILED (rc)) return rc; } /* Floppy drive (contains either Image or HostDrive or nothing) */ /// @todo (dmik) move the code to FloppyDrive { HRESULT rc = S_OK; CFGNODE driveNode = 0; CFGLDRGetChildNode (aNode, "FloppyDrive", 0, &driveNode); ComAssertRet (driveNode, E_FAIL); BOOL fFloppyEnabled = TRUE; CFGLDRQueryBool (driveNode, "enabled", (bool*)&fFloppyEnabled); rc = mFloppyDrive->COMSETTER(Enabled)(fFloppyEnabled); CFGNODE typeNode = 0; do { CFGLDRGetChildNode (driveNode, "Image", 0, &typeNode); if (typeNode) { Guid uuid; CFGLDRQueryUUID (typeNode, "uuid", uuid.ptr()); rc = mFloppyDrive->MountImage (uuid); } else { CFGLDRGetChildNode (driveNode, "HostDrive", 0, &typeNode); if (typeNode) { Bstr src; CFGLDRQueryBSTR (typeNode, "src", src.asOutParam()); /* find the correspoding object */ ComPtr host; rc = mParent->COMGETTER(Host) (host.asOutParam()); ComAssertComRCBreak (rc, rc = rc); ComPtr coll; rc = host->COMGETTER(FloppyDrives) (coll.asOutParam()); ComAssertComRCBreak (rc, rc = rc); ComPtr drive; rc = coll->FindByName (src, drive.asOutParam()); if (SUCCEEDED (rc)) rc = mFloppyDrive->CaptureHostDrive (drive); else if (rc == E_INVALIDARG) { /* the host Floppy drive is not currently available. we * assume it will be available later and create an * extra object now */ ComObjPtr hostDrive; hostDrive.createObject(); rc = hostDrive->init (src); ComAssertComRCBreak (rc, rc = rc); rc = mFloppyDrive->CaptureHostDrive (hostDrive); } else ComAssertComRCBreak (rc, rc = rc); } } } while (0); if (typeNode) CFGLDRReleaseNode (typeNode); CFGLDRReleaseNode (driveNode); if (FAILED (rc)) return rc; } /* USB Controller */ { HRESULT rc = mUSBController->loadSettings (aNode); if (FAILED (rc)) return rc; } /* Network node (required) */ /// @todo (dmik) move the code to NetworkAdapter { /* we assume that all network adapters are initially disabled * and detached */ CFGNODE networkNode = 0; CFGLDRGetChildNode (aNode, "Network", 0, &networkNode); ComAssertRet (networkNode, E_FAIL); HRESULT rc = S_OK; unsigned cAdapters = 0; CFGLDRCountChildren (networkNode, "Adapter", &cAdapters); for (unsigned i = 0; i < cAdapters; i++) { CFGNODE adapterNode = 0; CFGLDRGetChildNode (networkNode, "Adapter", i, &adapterNode); ComAssertBreak (adapterNode, rc = E_FAIL); /* slot number (required) */ /* slot unicity is guaranteed by XML Schema */ uint32_t slot = 0; CFGLDRQueryUInt32 (adapterNode, "slot", &slot); Assert (slot < ELEMENTS (mNetworkAdapters)); /* type */ Bstr adapterType; CFGLDRQueryBSTR (adapterNode, "type", adapterType.asOutParam()); ComAssertBreak (adapterType, rc = E_FAIL); /* enabled (required) */ bool enabled = false; CFGLDRQueryBool (adapterNode, "enabled", &enabled); /* MAC address (can be null) */ Bstr macAddr; CFGLDRQueryBSTR (adapterNode, "MACAddress", macAddr.asOutParam()); /* cable (required) */ bool cableConnected; CFGLDRQueryBool (adapterNode, "cable", &cableConnected); /* tracing (defaults to false) */ bool traceEnabled; CFGLDRQueryBool (adapterNode, "trace", &traceEnabled); Bstr traceFile; CFGLDRQueryBSTR (adapterNode, "tracefile", traceFile.asOutParam()); mNetworkAdapters [slot]->COMSETTER(Enabled) (enabled); mNetworkAdapters [slot]->COMSETTER(MACAddress) (macAddr); mNetworkAdapters [slot]->COMSETTER(CableConnected) (cableConnected); mNetworkAdapters [slot]->COMSETTER(TraceEnabled) (traceEnabled); mNetworkAdapters [slot]->COMSETTER(TraceFile) (traceFile); if (adapterType.compare(Bstr("Am79C970A")) == 0) mNetworkAdapters [slot]->COMSETTER(AdapterType)(NetworkAdapterType_NetworkAdapterAm79C970A); else if (adapterType.compare(Bstr("Am79C973")) == 0) mNetworkAdapters [slot]->COMSETTER(AdapterType)(NetworkAdapterType_NetworkAdapterAm79C973); else ComAssertBreak (0, rc = E_FAIL); CFGNODE attachmentNode = 0; if (CFGLDRGetChildNode (adapterNode, "NAT", 0, &attachmentNode), attachmentNode) { mNetworkAdapters [slot]->AttachToNAT(); } else if (CFGLDRGetChildNode (adapterNode, "HostInterface", 0, &attachmentNode), attachmentNode) { /* Host Interface Networking */ Bstr name; CFGLDRQueryBSTR (attachmentNode, "name", name.asOutParam()); #ifdef __WIN__ /* @name can be empty on Win32, but not null */ ComAssertBreak (!name.isNull(), rc = E_FAIL); #endif mNetworkAdapters [slot]->COMSETTER(HostInterface) (name); #ifdef VBOX_WITH_UNIXY_TAP_NETWORKING Bstr tapSetupApp; CFGLDRQueryBSTR (attachmentNode, "TAPSetup", tapSetupApp.asOutParam()); Bstr tapTerminateApp; CFGLDRQueryBSTR (attachmentNode, "TAPTerminate", tapTerminateApp.asOutParam()); mNetworkAdapters [slot]->COMSETTER(TAPSetupApplication) (tapSetupApp); mNetworkAdapters [slot]->COMSETTER(TAPTerminateApplication) (tapTerminateApp); #endif // VBOX_WITH_UNIXY_TAP_NETWORKING mNetworkAdapters [slot]->AttachToHostInterface(); } else if (CFGLDRGetChildNode(adapterNode, "InternalNetwork", 0, &attachmentNode), attachmentNode) { /* Internal Networking */ Bstr name; CFGLDRQueryBSTR (attachmentNode, "name", name.asOutParam()); ComAssertBreak (!name.isNull(), rc = E_FAIL); mNetworkAdapters[slot]->AttachToInternalNetwork(); mNetworkAdapters[slot]->COMSETTER(InternalNetwork) (name); } else { /* Adapter has no children */ mNetworkAdapters [slot]->Detach(); } if (attachmentNode) CFGLDRReleaseNode (attachmentNode); CFGLDRReleaseNode (adapterNode); } CFGLDRReleaseNode (networkNode); if (FAILED (rc)) return rc; } /* AudioAdapter node (required) */ /// @todo (dmik) move the code to AudioAdapter { CFGNODE audioAdapterNode = 0; CFGLDRGetChildNode (aNode, "AudioAdapter", 0, &audioAdapterNode); ComAssertRet (audioAdapterNode, E_FAIL); // is the adapter enabled? bool enabled = false; CFGLDRQueryBool (audioAdapterNode, "enabled", &enabled); mAudioAdapter->COMSETTER(Enabled) (enabled); // now check the audio driver Bstr driver; CFGLDRQueryBSTR (audioAdapterNode, "driver", driver.asOutParam()); AudioDriverType_T audioDriver; audioDriver = AudioDriverType_NullAudioDriver; if (driver == L"null") ; // Null has been set above #ifdef __WIN__ else if (driver == L"winmm") audioDriver = AudioDriverType_WINMMAudioDriver; else if (driver == L"dsound") audioDriver = AudioDriverType_DSOUNDAudioDriver; #endif // __WIN__ #ifdef __LINUX__ else if (driver == L"oss") audioDriver = AudioDriverType_OSSAudioDriver; else if (driver == L"alsa") #ifdef VBOX_WITH_ALSA audioDriver = AudioDriverType_ALSAAudioDriver; #else // fall back to OSS audioDriver = AudioDriverType_OSSAudioDriver; #endif #endif // __LINUX__ else AssertMsgFailed (("Invalid driver: %ls\n", driver.raw())); mAudioAdapter->COMSETTER(AudioDriver) (audioDriver); CFGLDRReleaseNode (audioAdapterNode); } /* Shared folders (optional) */ /// @todo (dmik) make required on next format change! do { CFGNODE sharedFoldersNode = 0; CFGLDRGetChildNode (aNode, "SharedFolders", 0, &sharedFoldersNode); if (!sharedFoldersNode) break; HRESULT rc = S_OK; unsigned cFolders = 0; CFGLDRCountChildren (sharedFoldersNode, "SharedFolder", &cFolders); for (unsigned i = 0; i < cFolders; i++) { CFGNODE folderNode = 0; CFGLDRGetChildNode (sharedFoldersNode, "SharedFolder", i, &folderNode); ComAssertBreak (folderNode, rc = E_FAIL); // folder logical name (required) Bstr name; CFGLDRQueryBSTR (folderNode, "name", name.asOutParam()); // folder host path (required) Bstr hostPath; CFGLDRQueryBSTR (folderNode, "hostPath", hostPath.asOutParam()); rc = CreateSharedFolder (name, hostPath); if (FAILED (rc)) break; CFGLDRReleaseNode (folderNode); } CFGLDRReleaseNode (sharedFoldersNode); if (FAILED (rc)) return rc; } while (0); /* Clipboard node (currently not required) */ /// @todo (dmik) make required on next format change! { /* default value in case the node is not there */ mHWData->mClipboardMode = ClipboardMode_ClipDisabled; CFGNODE clipNode = 0; CFGLDRGetChildNode (aNode, "Clipboard", 0, &clipNode); if (clipNode) { Bstr mode; CFGLDRQueryBSTR (clipNode, "mode", mode.asOutParam()); if (mode == L"Disabled") mHWData->mClipboardMode = ClipboardMode_ClipDisabled; else if (mode == L"HostToGuest") mHWData->mClipboardMode = ClipboardMode_ClipHostToGuest; else if (mode == L"GuestToHost") mHWData->mClipboardMode = ClipboardMode_ClipGuestToHost; else if (mode == L"Bidirectional") mHWData->mClipboardMode = ClipboardMode_ClipBidirectional; else AssertMsgFailed (("%ls clipboard mode is invalid\n", mode.raw())); CFGLDRReleaseNode (clipNode); } } return S_OK; } /** * @param aNode node * @param aRegistered true when the machine is being loaded on VirtualBox * startup, or when a snapshot is being loaded (wchich * currently can happen on startup only) * @param aSnapshotId pointer to the snapshot ID if this is a snapshot machine */ HRESULT Machine::loadHardDisks (CFGNODE aNode, bool aRegistered, const Guid *aSnapshotId /* = NULL */) { AssertReturn (aNode, E_INVALIDARG); AssertReturn ((mType == IsMachine && aSnapshotId == NULL) || (mType == IsSnapshotMachine && aSnapshotId != NULL), E_FAIL); HRESULT rc = S_OK; unsigned cbDisks = 0; CFGLDRCountChildren (aNode, "HardDiskAttachment", &cbDisks); if (!aRegistered && cbDisks > 0) { /* when the machine is being loaded (opened) from a file, it cannot * have hard disks attached (this should not happen normally, * because we don't allow to attach hard disks to an unregistered * VM at all */ return setError (E_FAIL, tr ("Unregistered machine '%ls' cannot have hard disks attached " "(found %d hard disk attachments)"), mUserData->mName.raw(), cbDisks); } for (unsigned i = 0; i < cbDisks && SUCCEEDED (rc); ++ i) { CFGNODE hdNode; CFGLDRGetChildNode (aNode, "HardDiskAttachment", i, &hdNode); ComAssertRet (hdNode, E_FAIL); do { /* hardDisk uuid (required) */ Guid uuid; CFGLDRQueryUUID (hdNode, "hardDisk", uuid.ptr()); /* bus (controller) type (required) */ Bstr bus; CFGLDRQueryBSTR (hdNode, "bus", bus.asOutParam()); /* device (required) */ Bstr device; CFGLDRQueryBSTR (hdNode, "device", device.asOutParam()); /* find a hard disk by UUID */ ComObjPtr hd; rc = mParent->getHardDisk (uuid, hd); if (FAILED (rc)) break; AutoLock hdLock (hd); if (!hd->machineId().isEmpty()) { rc = setError (E_FAIL, tr ("Hard disk '%ls' with UUID {%s} is already " "attached to a machine with UUID {%s} (see '%ls')"), hd->toString().raw(), uuid.toString().raw(), hd->machineId().toString().raw(), mData->mConfigFileFull.raw()); break; } if (hd->type() == HardDiskType_ImmutableHardDisk) { rc = setError (E_FAIL, tr ("Immutable hard disk '%ls' with UUID {%s} cannot be " "directly attached to a machine (see '%ls')"), hd->toString().raw(), uuid.toString().raw(), mData->mConfigFileFull.raw()); break; } /* attach the device */ DiskControllerType_T ctl = DiskControllerType_InvalidController; LONG dev = -1; if (bus == L"ide0") { ctl = DiskControllerType_IDE0Controller; if (device == L"master") dev = 0; else if (device == L"slave") dev = 1; else ComAssertMsgFailedBreak (("Invalid device: %ls\n", device.raw()), rc = E_FAIL); } else if (bus == L"ide1") { ctl = DiskControllerType_IDE1Controller; if (device == L"master") rc = setError (E_FAIL, tr("Could not attach a disk as a master " "device on the secondary controller")); else if (device == L"slave") dev = 1; else ComAssertMsgFailedBreak (("Invalid device: %ls\n", device.raw()), rc = E_FAIL); } else ComAssertMsgFailedBreak (("Invalid bus: %ls\n", bus.raw()), rc = E_FAIL); ComObjPtr attachment; attachment.createObject(); rc = attachment->init (hd, ctl, dev, false /* aDirty */); if (FAILED (rc)) break; /* associate the hard disk with this machine */ hd->setMachineId (mData->mUuid); /* associate the hard disk with the given snapshot ID */ if (mType == IsSnapshotMachine) hd->setSnapshotId (*aSnapshotId); mHDData->mHDAttachments.push_back (attachment); } while (0); CFGLDRReleaseNode (hdNode); } return rc; } /** * Creates a config loader and loads the settings file. * * @param aIsNew |true| if a newly created settings file is to be opened * (must be the case only when called from #saveSettings()) * * @note * XML Schema errors are not detected by this method because * it assumes that it will load settings from an exclusively locked * file (using a file handle) that was previously validated when opened * for the first time. Thus, this method should be used only when * it's necessary to modify (save) the settings file. * * @note The object must be locked at least for reading before calling * this method. */ HRESULT Machine::openConfigLoader (CFGHANDLE *aLoader, bool aIsNew /* = false */) { AssertReturn (aLoader, E_FAIL); /* The settings file must be created and locked at this point */ ComAssertRet (isConfigLocked(), E_FAIL); /* load the config file */ int vrc = CFGLDRLoad (aLoader, Utf8Str (mData->mConfigFileFull), mData->mHandleCfgFile, aIsNew ? NULL : XmlSchemaNS, true, cfgLdrEntityResolver, NULL); ComAssertRCRet (vrc, E_FAIL); return S_OK; } /** * Closes the config loader previously created by #openConfigLoader(). * If \a aSaveBeforeClose is true, then the config is saved to the settings file * before closing. If saving fails, a proper error message is set. * * @param aSaveBeforeClose whether to save the config before closing or not */ HRESULT Machine::closeConfigLoader (CFGHANDLE aLoader, bool aSaveBeforeClose) { HRESULT rc = S_OK; if (aSaveBeforeClose) { char *loaderError = NULL; int vrc = CFGLDRSave (aLoader, &loaderError); if (VBOX_FAILURE (vrc)) { rc = setError (E_FAIL, tr ("Could not save the settings file '%ls' (%Vrc)%s%s"), mData->mConfigFileFull.raw(), vrc, loaderError ? ".\n" : "", loaderError ? loaderError : ""); if (loaderError) RTMemTmpFree (loaderError); } } CFGLDRFree (aLoader); return rc; } /** * Searches for a node for the given snapshot. * If the search is successful, \a aSnapshotNode will contain the found node. * In this case, \a aSnapshotsNode can be NULL meaning the found node is a * direct child of \a aMachineNode. * * If the search fails, a failure is returned and both \a aSnapshotsNode and * \a aSnapshotNode are set to 0. * * @param aSnapshot snapshot to search for * @param aMachineNode node to start from * @param aSnapshotsNode node containing the found node * (may be NULL if the caller is not interested) * @param aSnapshotNode found node */ HRESULT Machine::findSnapshotNode (Snapshot *aSnapshot, CFGNODE aMachineNode, CFGNODE *aSnapshotsNode, CFGNODE *aSnapshotNode) { AssertReturn (aSnapshot && aMachineNode && aSnapshotNode, E_FAIL); if (aSnapshotsNode) *aSnapshotsNode = 0; *aSnapshotNode = 0; // build the full uuid path (from the fist parent to the given snapshot) std::list path; { ComObjPtr parent = aSnapshot; while (parent) { path.push_front (parent->data().mId); parent = parent->parent(); } } CFGNODE snapshotsNode = aMachineNode; CFGNODE snapshotNode = 0; for (std::list ::const_iterator it = path.begin(); it != path.end(); ++ it) { if (snapshotNode) { // proceed to the nested node Assert (snapshotsNode); if (snapshotsNode != aMachineNode) { CFGLDRReleaseNode (snapshotsNode); snapshotsNode = 0; } CFGLDRGetChildNode (snapshotNode, "Snapshots", 0, &snapshotsNode); CFGLDRReleaseNode (snapshotNode); snapshotNode = 0; } AssertReturn (snapshotsNode, E_FAIL); unsigned count = 0, i = 0; CFGLDRCountChildren (snapshotsNode, "Snapshot", &count); for (; i < count; ++ i) { snapshotNode = 0; CFGLDRGetChildNode (snapshotsNode, "Snapshot", i, &snapshotNode); Guid id; CFGLDRQueryUUID (snapshotNode, "uuid", id.ptr()); if (id == (*it)) { // we keep (don't release) snapshotNode and snapshotsNode break; } CFGLDRReleaseNode (snapshotNode); snapshotNode = 0; } if (i == count) { // the next uuid is not found, no need to continue... AssertFailed(); if (snapshotsNode != aMachineNode) { CFGLDRReleaseNode (snapshotsNode); snapshotsNode = 0; } break; } } // we must always succesfully find the node AssertReturn (snapshotNode, E_FAIL); AssertReturn (snapshotsNode, E_FAIL); if (aSnapshotsNode) *aSnapshotsNode = snapshotsNode != aMachineNode ? snapshotsNode : 0; *aSnapshotNode = snapshotNode; return S_OK; } /** * Returns the snapshot with the given UUID or fails of no such snapshot. * * @param aId snapshot UUID to find (empty UUID refers the first snapshot) * @param aSnapshot where to return the found snapshot * @param aSetError true to set extended error info on failure */ HRESULT Machine::findSnapshot (const Guid &aId, ComObjPtr &aSnapshot, bool aSetError /* = false */) { if (!mData->mFirstSnapshot) { if (aSetError) return setError (E_FAIL, tr ("This machine does not have any snapshots")); return E_FAIL; } if (aId.isEmpty()) aSnapshot = mData->mFirstSnapshot; else aSnapshot = mData->mFirstSnapshot->findChildOrSelf (aId); if (!aSnapshot) { if (aSetError) return setError (E_FAIL, tr ("Could not find a snapshot with UUID {%s}"), aId.toString().raw()); return E_FAIL; } return S_OK; } /** * Returns the snapshot with the given name or fails of no such snapshot. * * @param aName snapshot name to find * @param aSnapshot where to return the found snapshot * @param aSetError true to set extended error info on failure */ HRESULT Machine::findSnapshot (const BSTR aName, ComObjPtr &aSnapshot, bool aSetError /* = false */) { AssertReturn (aName, E_INVALIDARG); if (!mData->mFirstSnapshot) { if (aSetError) return setError (E_FAIL, tr ("This machine does not have any snapshots")); return E_FAIL; } aSnapshot = mData->mFirstSnapshot->findChildOrSelf (aName); if (!aSnapshot) { if (aSetError) return setError (E_FAIL, tr ("Could not find a snapshot named '%ls'"), aName); return E_FAIL; } return S_OK; } /** * Searches for an attachment that contains the given hard disk. * The hard disk must be associated with some VM and can be optionally * associated with some snapshot. If the attachment is stored in the snapshot * (i.e. the hard disk is associated with some snapshot), @a aSnapshot * will point to a non-null object on output. * * @param aHd hard disk to search an attachment for * @param aMachine where to store the hard disk's machine (can be NULL) * @param aSnapshot where to store the hard disk's snapshot (can be NULL) * @param aHda where to store the hard disk's attachment (can be NULL) * * * @note * It is assumed that the machine where the attachment is found, * is already placed to the Discarding state, when this method is called. * @note * The object returned in @a aHda is the attachment from the snapshot * machine if the hard disk is associated with the snapshot, not from the * primary machine object returned returned in @a aMachine. */ HRESULT Machine::findHardDiskAttachment (const ComObjPtr &aHd, ComObjPtr *aMachine, ComObjPtr *aSnapshot, ComObjPtr *aHda) { AssertReturn (!aHd.isNull(), E_INVALIDARG); Guid mid = aHd->machineId(); Guid sid = aHd->snapshotId(); AssertReturn (!mid.isEmpty(), E_INVALIDARG); ComObjPtr m; mParent->getMachine (mid, m); ComAssertRet (!m.isNull(), E_FAIL); HDData::HDAttachmentList *attachments = &m->mHDData->mHDAttachments; ComObjPtr s; if (!sid.isEmpty()) { m->findSnapshot (sid, s); ComAssertRet (!s.isNull(), E_FAIL); attachments = &s->data().mMachine->mHDData->mHDAttachments; } AssertReturn (attachments, E_FAIL); for (HDData::HDAttachmentList::const_iterator it = attachments->begin(); it != attachments->end(); ++ it) { if ((*it)->hardDisk() == aHd) { if (aMachine) *aMachine = m; if (aSnapshot) *aSnapshot = s; if (aHda) *aHda = (*it); return S_OK; } } ComAssertFailed(); return E_FAIL; } /** * Helper for #saveSettings. Cares about renaming the settings directory and * file if the machine name was changed and about creating a new settings file * if this is a new machine. * * @note Must be never called directly. * * @param aRenamed receives |true| if the name was changed and the settings * file was renamed as a result, or |false| otherwise. The * value makes sense only on success. * @param aNew receives |true| if a virgin settings file was created. */ HRESULT Machine::prepareSaveSettings (bool &aRenamed, bool &aNew) { HRESULT rc = S_OK; aRenamed = false; /* if we're ready and isConfigLocked() is FALSE then it means * that no config file exists yet (we will create a virgin one) */ aNew = !isConfigLocked(); /* attempt to rename the settings file if machine name is changed */ if (mUserData->mNameSync && mUserData.isBackedUp() && mUserData.backedUpData()->mName != mUserData->mName) { aRenamed = true; if (!aNew) { /* unlock the old config file */ rc = unlockConfig(); CheckComRCReturnRC (rc); } bool dirRenamed = false; bool fileRenamed = false; Utf8Str configFile, newConfigFile; Utf8Str configDir, newConfigDir; do { int vrc = VINF_SUCCESS; Utf8Str name = mUserData.backedUpData()->mName; Utf8Str newName = mUserData->mName; configFile = mData->mConfigFileFull; /* first, rename the directory if it matches the machine name */ configDir = configFile; RTPathStripFilename (configDir.mutableRaw()); newConfigDir = configDir; if (RTPathFilename (configDir) == name) { RTPathStripFilename (newConfigDir.mutableRaw()); newConfigDir = Utf8StrFmt ("%s%c%s", newConfigDir.raw(), RTPATH_DELIMITER, newName.raw()); /* new dir and old dir cannot be equal here because of 'if' * above and because name != newName */ Assert (configDir != newConfigDir); if (!aNew) { /* perform real rename only if the machine is not new */ vrc = RTPathRename (configDir.raw(), newConfigDir.raw(), 0); if (VBOX_FAILURE (vrc)) { rc = setError (E_FAIL, tr ("Could not rename the directory '%s' to '%s' " "to save the settings file (%Vrc)"), configDir.raw(), newConfigDir.raw(), vrc); break; } dirRenamed = true; } } newConfigFile = Utf8StrFmt ("%s%c%s.xml", newConfigDir.raw(), RTPATH_DELIMITER, newName.raw()); /* then try to rename the settings file itself */ if (newConfigFile != configFile) { /* get the path to old settings file in renamed directory */ configFile = Utf8StrFmt ("%s%c%s", newConfigDir.raw(), RTPATH_DELIMITER, RTPathFilename (configFile)); if (!aNew) { /* perform real rename only if the machine is not new */ vrc = RTFileRename (configFile.raw(), newConfigFile.raw(), 0); if (VBOX_FAILURE (vrc)) { rc = setError (E_FAIL, tr ("Could not rename the settings file '%s' to '%s' " "(%Vrc)"), configFile.raw(), newConfigFile.raw(), vrc); break; } fileRenamed = true; } } /* update mConfigFileFull amd mConfigFile */ Bstr oldConfigFileFull = mData->mConfigFileFull; Bstr oldConfigFile = mData->mConfigFile; mData->mConfigFileFull = newConfigFile; /* try to get the relative path for mConfigFile */ Utf8Str path = newConfigFile; mParent->calculateRelativePath (path, path); mData->mConfigFile = path; /* last, try to update the global settings with the new path */ if (mData->mRegistered) { rc = mParent->updateSettings (configDir, newConfigDir); if (FAILED (rc)) { /* revert to old values */ mData->mConfigFileFull = oldConfigFileFull; mData->mConfigFile = oldConfigFile; break; } } /* update the snapshot folder */ path = mUserData->mSnapshotFolderFull; if (RTPathStartsWith (path, configDir)) { path = Utf8StrFmt ("%s%s", newConfigDir.raw(), path.raw() + configDir.length()); mUserData->mSnapshotFolderFull = path; calculateRelativePath (path, path); mUserData->mSnapshotFolder = path; } /* update the saved state file path */ path = mSSData->mStateFilePath; if (RTPathStartsWith (path, configDir)) { path = Utf8StrFmt ("%s%s", newConfigDir.raw(), path.raw() + configDir.length()); mSSData->mStateFilePath = path; } /* Update saved state file paths of all online snapshots. * Note that saveSettings() will recognize name change * and will save all snapshots in this case. */ if (mData->mFirstSnapshot) mData->mFirstSnapshot->updateSavedStatePaths (configDir, newConfigDir); } while (0); if (FAILED (rc)) { /* silently try to rename everything back */ if (fileRenamed) RTFileRename (newConfigFile.raw(), configFile.raw(), 0); if (dirRenamed) RTPathRename (newConfigDir.raw(), configDir.raw(), 0); } if (!aNew) { /* lock the config again */ HRESULT rc2 = lockConfig(); if (SUCCEEDED (rc)) rc = rc2; } CheckComRCReturnRC (rc); } if (aNew) { /* create a virgin config file */ int vrc = VINF_SUCCESS; /* ensure the settings directory exists */ Utf8Str path = mData->mConfigFileFull; RTPathStripFilename (path.mutableRaw()); if (!RTDirExists (path)) { vrc = RTDirCreateFullPath (path, 0777); if (VBOX_FAILURE (vrc)) { return setError (E_FAIL, tr ("Could not create a directory '%s' " "to save the settings file (%Vrc)"), path.raw(), vrc); } } /* Note: open flags must correlated with RTFileOpen() in lockConfig() */ path = Utf8Str (mData->mConfigFileFull); vrc = RTFileOpen (&mData->mHandleCfgFile, path, RTFILE_O_READWRITE | RTFILE_O_CREATE | RTFILE_O_DENY_WRITE); if (VBOX_SUCCESS (vrc)) { vrc = RTFileWrite (mData->mHandleCfgFile, (void *) DefaultMachineConfig, sizeof (DefaultMachineConfig), NULL); } if (VBOX_FAILURE (vrc)) { mData->mHandleCfgFile = NIL_RTFILE; return setError (E_FAIL, tr ("Could not create the settings file '%s' (%Vrc)"), path.raw(), vrc); } /* we do not close the file to simulate lockConfig() */ } return rc; } /** * Saves machine data, user data and hardware data. * * @param aMarkCurStateAsModified * if true (default), mData->mCurrentStateModified will be set to * what #isReallyModified() returns prior to saving settings to a file, * otherwise the current value of mData->mCurrentStateModified will be * saved. * @param aInformCallbacksAnyway * if true, callbacks will be informed even if #isReallyModified() * returns false. This is necessary for cases when we change machine data * diectly, not through the backup()/commit() mechanism. * * @note Locks mParent (only in some cases, and only when #isConfigLocked() is * |TRUE|, see the #prepareSaveSettings() code for details) + * this object + children for writing. */ HRESULT Machine::saveSettings (bool aMarkCurStateAsModified /* = true */, bool aInformCallbacksAnyway /* = false */) { /// @todo (dmik) I guess we should lock all our child objects here // (such as mVRDPServer etc.) to ensure they are not changed // until completely saved to disk and committed /// @todo (dmik) also, we need to delegate saving child objects' settings // to objects themselves to ensure operations 'commit + save changes' // are atomic (amd done from the object's lock so that nobody can change // settings again until completely saved). AssertReturn (mType == IsMachine || mType == IsSessionMachine, E_FAIL); bool wasModified; if (aMarkCurStateAsModified) { /* * We ignore changes to user data when setting mCurrentStateModified * because the current state will not differ from the current snapshot * if only user data has been changed (user data is shared by all * snapshots). */ mData->mCurrentStateModified = isReallyModified (true /* aIgnoreUserData */); wasModified = mUserData.hasActualChanges() || mData->mCurrentStateModified; } else { wasModified = isReallyModified(); } HRESULT rc = S_OK; /* First, prepare to save settings. It will will care about renaming the * settings directory and file if the machine name was changed and about * creating a new settings file if this is a new machine. */ bool isRenamed = false; bool isNew = false; rc = prepareSaveSettings (isRenamed, isNew); CheckComRCReturnRC (rc); /* then, open the settings file */ CFGHANDLE configLoader = 0; rc = openConfigLoader (&configLoader, isNew); CheckComRCReturnRC (rc); /* save all snapshots when the machine name was changed since * it may affect saved state file paths for online snapshots (see * #openConfigLoader() for details) */ bool updateAllSnapshots = isRenamed; /* commit before saving, since it may change settings * (for example, perform fixup of lazy hard disk changes) */ rc = commit(); if (FAILED (rc)) { closeConfigLoader (configLoader, false /* aSaveBeforeClose */); return rc; } /* include hard disk changes to the modified flag */ wasModified |= mHDData->mHDAttachmentsChanged; if (aMarkCurStateAsModified) mData->mCurrentStateModified |= BOOL (mHDData->mHDAttachmentsChanged); CFGNODE machineNode = 0; /* create if not exists */ CFGLDRCreateNode (configLoader, "VirtualBox/Machine", &machineNode); do { ComAssertBreak (machineNode, rc = E_FAIL); /* uuid (required) */ Assert (mData->mUuid); CFGLDRSetUUID (machineNode, "uuid", mData->mUuid.raw()); /* name (required) */ Assert (!mUserData->mName.isEmpty()); CFGLDRSetBSTR (machineNode, "name", mUserData->mName); /* nameSync (optional, default is true) */ if (!mUserData->mNameSync) CFGLDRSetBool (machineNode, "nameSync", false); else CFGLDRDeleteAttribute (machineNode, "nameSync"); /* OSType (required) */ { Bstr osTypeID; rc = mUserData->mOSType->COMGETTER(Id) (osTypeID.asOutParam()); ComAssertComRCBreak (rc, rc = rc); Assert (!osTypeID.isNull()); CFGLDRSetBSTR (machineNode, "OSType", osTypeID); } /* stateFile (optional) */ if (mData->mMachineState == MachineState_Saved) { Assert (!mSSData->mStateFilePath.isEmpty()); /* try to make the file name relative to the settings file dir */ Utf8Str stateFilePath = mSSData->mStateFilePath; calculateRelativePath (stateFilePath, stateFilePath); CFGLDRSetString (machineNode, "stateFile", stateFilePath); } else { Assert (mSSData->mStateFilePath.isNull()); CFGLDRDeleteAttribute (machineNode, "stateFile"); } /* currentSnapshot ID (optional) */ if (!mData->mCurrentSnapshot.isNull()) { Assert (!mData->mFirstSnapshot.isNull()); CFGLDRSetUUID (machineNode, "currentSnapshot", mData->mCurrentSnapshot->data().mId); } else { Assert (mData->mFirstSnapshot.isNull()); CFGLDRDeleteAttribute (machineNode, "currentSnapshot"); } /* snapshotFolder (optional) */ if (mUserData->mSnapshotFolder) CFGLDRSetBSTR (machineNode, "snapshotFolder", mUserData->mSnapshotFolder); else CFGLDRDeleteAttribute (machineNode, "snapshotFolder"); /* currentStateModified (optional, default is yes) */ if (!mData->mCurrentStateModified) CFGLDRSetBool (machineNode, "currentStateModified", false); else CFGLDRDeleteAttribute (machineNode, "currentStateModified"); /* lastStateChange */ CFGLDRSetDateTime (machineNode, "lastStateChange", mData->mLastStateChange); /* Hardware node (required) */ { CFGNODE hwNode = 0; CFGLDRGetChildNode (machineNode, "Hardware", 0, &hwNode); /* first, delete the entire node if exists */ if (hwNode) CFGLDRDeleteNode (hwNode); /* then recreate it */ hwNode = 0; CFGLDRCreateChildNode (machineNode, "Hardware", &hwNode); ComAssertBreak (hwNode, rc = E_FAIL); rc = saveHardware (hwNode); CFGLDRReleaseNode (hwNode); if (FAILED (rc)) break; } /* HardDiskAttachments node (required) */ { CFGNODE hdasNode = 0; CFGLDRGetChildNode (machineNode, "HardDiskAttachments", 0, &hdasNode); /* first, delete the entire node if exists */ if (hdasNode) CFGLDRDeleteNode (hdasNode); /* then recreate it */ hdasNode = 0; CFGLDRCreateChildNode (machineNode, "HardDiskAttachments", &hdasNode); ComAssertBreak (hdasNode, rc = E_FAIL); rc = saveHardDisks (hdasNode); CFGLDRReleaseNode (hdasNode); if (FAILED (rc)) break; } /* update all snapshots if requested */ if (updateAllSnapshots) rc = saveSnapshotSettingsWorker (machineNode, NULL, SaveSS_UpdateAllOp); } while (0); if (machineNode) CFGLDRReleaseNode (machineNode); if (SUCCEEDED (rc)) rc = closeConfigLoader (configLoader, true /* aSaveBeforeClose */); else closeConfigLoader (configLoader, false /* aSaveBeforeClose */); if (FAILED (rc)) { /* * backup arbitrary data item to cause #isModified() to still return * true in case of any error */ mHWData.backup(); } if (wasModified || aInformCallbacksAnyway) { /* * Fire the data change event, even on failure (since we've already * committed all data). This is done only for SessionMachines because * mutable Machine instances are always not registered (i.e. private * to the client process that creates them) and thus don't need to * inform callbacks. */ if (mType == IsSessionMachine) mParent->onMachineDataChange (mData->mUuid); } return rc; } /** * Wrapper for #saveSnapshotSettingsWorker() that opens the settings file * and locates the node in there. See #saveSnapshotSettingsWorker() * for more details. * * @param aSnapshot Snapshot to operate on * @param aOpFlags Operation to perform, one of SaveSS_NoOp, SaveSS_AddOp * or SaveSS_UpdateAttrsOp possibly combined with * SaveSS_UpdateCurrentId. * * @note Locks this object for writing + other child objects. */ HRESULT Machine::saveSnapshotSettings (Snapshot *aSnapshot, int aOpFlags) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AssertReturn (mType == IsMachine || mType == IsSessionMachine, E_FAIL); AutoLock alock (this); AssertReturn (isConfigLocked(), E_FAIL); HRESULT rc = S_OK; /* load the config file */ CFGHANDLE configLoader = 0; rc = openConfigLoader (&configLoader); if (FAILED (rc)) return rc; CFGNODE machineNode = 0; CFGLDRGetNode (configLoader, "VirtualBox/Machine", 0, &machineNode); do { ComAssertBreak (machineNode, rc = E_FAIL); rc = saveSnapshotSettingsWorker (machineNode, aSnapshot, aOpFlags); CFGLDRReleaseNode (machineNode); } while (0); if (SUCCEEDED (rc)) rc = closeConfigLoader (configLoader, true /* aSaveBeforeClose */); else closeConfigLoader (configLoader, false /* aSaveBeforeClose */); return rc; } /** * Performs the specified operation on the given snapshot * in the settings file represented by \a aMachineNode. * * If \a aOpFlags = SaveSS_UpdateAllOp, \a aSnapshot can be NULL to indicate * that the whole tree of the snapshots should be updated in . * One particular case is when the last (and the only) snapshot should be * removed (it is so when both mCurrentSnapshot and mFirstSnapshot are NULL). * * \a aOp may be just SaveSS_UpdateCurrentId if only the currentSnapshot * attribute of needs to be updated. * * @param aMachineNode node in the opened settings file * @param aSnapshot Snapshot to operate on * @param aOpFlags Operation to perform, one of SaveSS_NoOp, SaveSS_AddOp * or SaveSS_UpdateAttrsOp possibly combined with * SaveSS_UpdateCurrentId. * * @note Must be called with this object locked for writing. * Locks child objects. */ HRESULT Machine::saveSnapshotSettingsWorker (CFGNODE aMachineNode, Snapshot *aSnapshot, int aOpFlags) { AssertReturn (aMachineNode, E_FAIL); AssertReturn (isLockedOnCurrentThread(), E_FAIL); int op = aOpFlags & SaveSS_OpMask; AssertReturn ( (aSnapshot && (op == SaveSS_AddOp || op == SaveSS_UpdateAttrsOp || op == SaveSS_UpdateAllOp)) || (!aSnapshot && ((op == SaveSS_NoOp && (aOpFlags & SaveSS_UpdateCurrentId)) || op == SaveSS_UpdateAllOp)), E_FAIL); HRESULT rc = S_OK; bool recreateWholeTree = false; do { if (op == SaveSS_NoOp) break; /* quick path: recreate the whole tree of the snapshots */ if (op == SaveSS_UpdateAllOp && !aSnapshot) { /* first, delete the entire root snapshot node if it exists */ CFGNODE snapshotNode = 0; CFGLDRGetChildNode (aMachineNode, "Snapshot", 0, &snapshotNode); if (snapshotNode) CFGLDRDeleteNode (snapshotNode); /* * second, if we have any snapshots left, substitute aSnapshot with * the first snapshot to recreate the whole tree, otherwise break */ if (mData->mFirstSnapshot) { aSnapshot = mData->mFirstSnapshot; recreateWholeTree = true; } else break; } Assert (!!aSnapshot); ComObjPtr parent = aSnapshot->parent(); if (op == SaveSS_AddOp) { CFGNODE parentNode = 0; if (parent) { rc = findSnapshotNode (parent, aMachineNode, NULL, &parentNode); if (FAILED (rc)) break; ComAssertBreak (parentNode, rc = E_FAIL); } do { CFGNODE snapshotsNode = 0; if (parentNode) { CFGLDRCreateChildNode (parentNode, "Snapshots", &snapshotsNode); ComAssertBreak (snapshotsNode, rc = E_FAIL); } else snapshotsNode = aMachineNode; do { CFGNODE snapshotNode = 0; CFGLDRAppendChildNode (snapshotsNode, "Snapshot", &snapshotNode); ComAssertBreak (snapshotNode, rc = E_FAIL); rc = saveSnapshot (snapshotNode, aSnapshot, false /* aAttrsOnly */); CFGLDRReleaseNode (snapshotNode); if (FAILED (rc)) break; /* * when a new snapshot is added, this means diffs were created * for every normal/immutable hard disk of the VM, so we need to * save the current hard disk attachments */ CFGNODE hdasNode = 0; CFGLDRGetChildNode (aMachineNode, "HardDiskAttachments", 0, &hdasNode); if (hdasNode) CFGLDRDeleteNode (hdasNode); CFGLDRCreateChildNode (aMachineNode, "HardDiskAttachments", &hdasNode); ComAssertBreak (hdasNode, rc = E_FAIL); rc = saveHardDisks (hdasNode); if (mHDData->mHDAttachments.size() != 0) { /* * If we have one or more attachments then we definitely * created diffs for them and associated new diffs with * current settngs. So, since we don't use saveSettings(), * we need to inform callbacks manually. */ if (mType == IsSessionMachine) mParent->onMachineDataChange (mData->mUuid); } CFGLDRReleaseNode (hdasNode); } while (0); if (snapshotsNode != aMachineNode) CFGLDRReleaseNode (snapshotsNode); } while (0); if (parentNode) CFGLDRReleaseNode (parentNode); break; } Assert (op == SaveSS_UpdateAttrsOp && !recreateWholeTree || op == SaveSS_UpdateAllOp); CFGNODE snapshotsNode = 0; CFGNODE snapshotNode = 0; if (!recreateWholeTree) { rc = findSnapshotNode (aSnapshot, aMachineNode, &snapshotsNode, &snapshotNode); if (FAILED (rc)) break; ComAssertBreak (snapshotNode, rc = E_FAIL); } if (!snapshotsNode) snapshotsNode = aMachineNode; if (op == SaveSS_UpdateAttrsOp) rc = saveSnapshot (snapshotNode, aSnapshot, true /* aAttrsOnly */); else do { if (snapshotNode) { CFGLDRDeleteNode (snapshotNode); snapshotNode = 0; } CFGLDRAppendChildNode (snapshotsNode, "Snapshot", &snapshotNode); ComAssertBreak (snapshotNode, rc = E_FAIL); rc = saveSnapshot (snapshotNode, aSnapshot, false /* aAttrsOnly */); } while (0); CFGLDRReleaseNode (snapshotNode); if (snapshotsNode != aMachineNode) CFGLDRReleaseNode (snapshotsNode); } while (0); if (SUCCEEDED (rc)) { /* update currentSnapshot when appropriate */ if (aOpFlags & SaveSS_UpdateCurrentId) { if (!mData->mCurrentSnapshot.isNull()) CFGLDRSetUUID (aMachineNode, "currentSnapshot", mData->mCurrentSnapshot->data().mId); else CFGLDRDeleteAttribute (aMachineNode, "currentSnapshot"); } if (aOpFlags & SaveSS_UpdateCurStateModified) { if (!mData->mCurrentStateModified) CFGLDRSetBool (aMachineNode, "currentStateModified", false); else CFGLDRDeleteAttribute (aMachineNode, "currentStateModified"); } } return rc; } /** * Saves the given snapshot and all its children (unless \a aAttrsOnly is true). * It is assumed that the given node is empty (unless \a aAttrsOnly is true). * * @param aNode node to save the snapshot to * @param aSnapshot snapshot to save * @param aAttrsOnly if true, only updatge user-changeable attrs */ HRESULT Machine::saveSnapshot (CFGNODE aNode, Snapshot *aSnapshot, bool aAttrsOnly) { AssertReturn (aNode && aSnapshot, E_INVALIDARG); AssertReturn (mType == IsMachine || mType == IsSessionMachine, E_FAIL); /* uuid (required) */ if (!aAttrsOnly) CFGLDRSetUUID (aNode, "uuid", aSnapshot->data().mId); /* name (required) */ CFGLDRSetBSTR (aNode, "name", aSnapshot->data().mName); /* timeStamp (required) */ CFGLDRSetDateTime (aNode, "timeStamp", aSnapshot->data().mTimeStamp); /* Description node (optional) */ { CFGNODE descNode = 0; CFGLDRCreateChildNode (aNode, "Description", &descNode); CFGLDRSetBSTR (descNode, NULL, aSnapshot->data().mDescription); CFGLDRReleaseNode (descNode); } if (aAttrsOnly) return S_OK; /* stateFile (optional) */ if (aSnapshot->stateFilePath()) { /* try to make the file name relative to the settings file dir */ Utf8Str stateFilePath = aSnapshot->stateFilePath(); calculateRelativePath (stateFilePath, stateFilePath); CFGLDRSetString (aNode, "stateFile", stateFilePath); } { ComObjPtr snapshotMachine = aSnapshot->data().mMachine; ComAssertRet (!snapshotMachine.isNull(), E_FAIL); /* save hardware */ { CFGNODE hwNode = 0; CFGLDRCreateChildNode (aNode, "Hardware", &hwNode); HRESULT rc = snapshotMachine->saveHardware (hwNode); CFGLDRReleaseNode (hwNode); if (FAILED (rc)) return rc; } /* save hard disks */ { CFGNODE hdasNode = 0; CFGLDRCreateChildNode (aNode, "HardDiskAttachments", &hdasNode); HRESULT rc = snapshotMachine->saveHardDisks (hdasNode); CFGLDRReleaseNode (hdasNode); if (FAILED (rc)) return rc; } } /* save children */ { AutoLock listLock (aSnapshot->childrenLock()); if (aSnapshot->children().size()) { CFGNODE snapshotsNode = 0; CFGLDRCreateChildNode (aNode, "Snapshots", &snapshotsNode); HRESULT rc = S_OK; for (Snapshot::SnapshotList::const_iterator it = aSnapshot->children().begin(); it != aSnapshot->children().end() && SUCCEEDED (rc); ++ it) { CFGNODE snapshotNode = 0; CFGLDRCreateChildNode (snapshotsNode, "Snapshot", &snapshotNode); rc = saveSnapshot (snapshotNode, (*it), aAttrsOnly); CFGLDRReleaseNode (snapshotNode); } CFGLDRReleaseNode (snapshotsNode); if (FAILED (rc)) return rc; } } return S_OK; } /** * Creates Saves the VM hardware configuration. * It is assumed that the given node is empty. * * @param aNode node to save the VM hardware confguration to */ HRESULT Machine::saveHardware (CFGNODE aNode) { AssertReturn (aNode, E_INVALIDARG); HRESULT rc = S_OK; /* CPU */ { CFGNODE cpuNode = 0; CFGLDRCreateChildNode (aNode, "CPU", &cpuNode); CFGNODE hwVirtExNode = 0; CFGLDRCreateChildNode (cpuNode, "HardwareVirtEx", &hwVirtExNode); char *value = NULL; switch (mHWData->mHWVirtExEnabled) { case TriStateBool_False: value = "false"; break; case TriStateBool_True: value = "true"; break; default: value = "default"; } CFGLDRSetString (hwVirtExNode, "enabled", value); CFGLDRReleaseNode (hwVirtExNode); CFGLDRReleaseNode (cpuNode); } /* memory (required) */ { CFGNODE memoryNode = 0; CFGLDRCreateChildNode (aNode, "Memory", &memoryNode); CFGLDRSetUInt32 (memoryNode, "RAMSize", mHWData->mMemorySize); CFGLDRReleaseNode (memoryNode); } /* boot (required) */ do { CFGNODE bootNode = 0; CFGLDRCreateChildNode (aNode, "Boot", &bootNode); for (ULONG pos = 0; pos < ELEMENTS (mHWData->mBootOrder); pos ++) { const char *device = NULL; switch (mHWData->mBootOrder [pos]) { case DeviceType_NoDevice: /* skip, this is allowed for nodes * when loading, the default value NoDevice will remain */ continue; case DeviceType_FloppyDevice: device = "Floppy"; break; case DeviceType_DVDDevice: device = "DVD"; break; case DeviceType_HardDiskDevice: device = "HardDisk"; break; case DeviceType_NetworkDevice: device = "Network"; break; default: ComAssertMsgFailedBreak (("Invalid boot device: %d\n", mHWData->mBootOrder [pos]), rc = E_FAIL); } if (FAILED (rc)) break; CFGNODE orderNode = 0; CFGLDRAppendChildNode (bootNode, "Order", &orderNode); CFGLDRSetUInt32 (orderNode, "position", pos + 1); CFGLDRSetString (orderNode, "device", device); CFGLDRReleaseNode (orderNode); } CFGLDRReleaseNode (bootNode); } while (0); if (FAILED (rc)) return rc; /* display (required) */ { CFGNODE displayNode = 0; CFGLDRCreateChildNode (aNode, "Display", &displayNode); CFGLDRSetUInt32 (displayNode, "VRAMSize", mHWData->mVRAMSize); CFGLDRReleaseNode (displayNode); } #ifdef VBOX_VRDP /* VRDP settings (optional) */ /// @todo (dmik) move the code to VRDPServer /// @todo r=sunlover: moved. dmik, please review. { CFGNODE remoteDisplayNode = 0; CFGLDRCreateChildNode (aNode, "RemoteDisplay", &remoteDisplayNode); if (remoteDisplayNode) { mVRDPServer->saveConfig (remoteDisplayNode); CFGLDRReleaseNode (remoteDisplayNode); } } #endif /* BIOS (required) */ { CFGNODE biosNode = 0; CFGLDRCreateChildNode (aNode, "BIOS", &biosNode); { BOOL fSet; /* ACPI */ CFGNODE acpiNode = 0; CFGLDRCreateChildNode (biosNode, "ACPI", &acpiNode); mBIOSSettings->COMGETTER(ACPIEnabled)(&fSet); CFGLDRSetBool (acpiNode, "enabled", !!fSet); CFGLDRReleaseNode (acpiNode); /* IOAPIC */ CFGNODE ioapicNode = 0; CFGLDRCreateChildNode (biosNode, "IOAPIC", &ioapicNode); mBIOSSettings->COMGETTER(IOAPICEnabled)(&fSet); CFGLDRSetBool (ioapicNode, "enabled", !!fSet); CFGLDRReleaseNode (ioapicNode); /* BIOS logo (optional) **/ CFGNODE logoNode = 0; CFGLDRCreateChildNode (biosNode, "Logo", &logoNode); mBIOSSettings->COMGETTER(LogoFadeIn)(&fSet); CFGLDRSetBool (logoNode, "fadeIn", !!fSet); mBIOSSettings->COMGETTER(LogoFadeOut)(&fSet); CFGLDRSetBool (logoNode, "fadeOut", !!fSet); ULONG ulDisplayTime; mBIOSSettings->COMGETTER(LogoDisplayTime)(&ulDisplayTime); CFGLDRSetUInt32 (logoNode, "displayTime", ulDisplayTime); Bstr logoPath; mBIOSSettings->COMGETTER(LogoImagePath)(logoPath.asOutParam()); if (logoPath) CFGLDRSetBSTR (logoNode, "imagePath", logoPath); else CFGLDRDeleteAttribute (logoNode, "imagePath"); CFGLDRReleaseNode (logoNode); /* boot menu (optional) */ CFGNODE bootMenuNode = 0; CFGLDRCreateChildNode (biosNode, "BootMenu", &bootMenuNode); BIOSBootMenuMode_T bootMenuMode; Bstr bootMenuModeStr; mBIOSSettings->COMGETTER(BootMenuMode)(&bootMenuMode); switch (bootMenuMode) { case BIOSBootMenuMode_Disabled: bootMenuModeStr = "disabled"; break; case BIOSBootMenuMode_MenuOnly: bootMenuModeStr = "menuonly"; break; default: bootMenuModeStr = "messageandmenu"; } CFGLDRSetBSTR (bootMenuNode, "mode", bootMenuModeStr); CFGLDRReleaseNode (bootMenuNode); } CFGLDRReleaseNode(biosNode); } /* DVD drive (required) */ /// @todo (dmik) move the code to DVDDrive do { CFGNODE dvdNode = 0; CFGLDRCreateChildNode (aNode, "DVDDrive", &dvdNode); BOOL fPassthrough; mDVDDrive->COMGETTER(Passthrough)(&fPassthrough); CFGLDRSetBool(dvdNode, "passthrough", !!fPassthrough); switch (mDVDDrive->data()->mDriveState) { case DriveState_ImageMounted: { Assert (!mDVDDrive->data()->mDVDImage.isNull()); Guid id; rc = mDVDDrive->data()->mDVDImage->COMGETTER(Id) (id.asOutParam()); Assert (!id.isEmpty()); CFGNODE imageNode = 0; CFGLDRCreateChildNode (dvdNode, "Image", &imageNode); CFGLDRSetUUID (imageNode, "uuid", id.ptr()); CFGLDRReleaseNode (imageNode); break; } case DriveState_HostDriveCaptured: { Assert (!mDVDDrive->data()->mHostDrive.isNull()); Bstr name; rc = mDVDDrive->data()->mHostDrive->COMGETTER(Name) (name.asOutParam()); Assert (!name.isEmpty()); CFGNODE hostDriveNode = 0; CFGLDRCreateChildNode (dvdNode, "HostDrive", &hostDriveNode); CFGLDRSetBSTR (hostDriveNode, "src", name); CFGLDRReleaseNode (hostDriveNode); break; } case DriveState_NotMounted: /* do nothing, i.e.leave the DVD drive node empty */ break; default: ComAssertMsgFailedBreak (("Invalid DVD drive state: %d\n", mDVDDrive->data()->mDriveState), rc = E_FAIL); } CFGLDRReleaseNode (dvdNode); } while (0); if (FAILED (rc)) return rc; /* Flooppy drive (required) */ /// @todo (dmik) move the code to DVDDrive do { CFGNODE floppyNode = 0; CFGLDRCreateChildNode (aNode, "FloppyDrive", &floppyNode); BOOL fFloppyEnabled; rc = mFloppyDrive->COMGETTER(Enabled)(&fFloppyEnabled); CFGLDRSetBool (floppyNode, "enabled", !!fFloppyEnabled); switch (mFloppyDrive->data()->mDriveState) { case DriveState_ImageMounted: { Assert (!mFloppyDrive->data()->mFloppyImage.isNull()); Guid id; rc = mFloppyDrive->data()->mFloppyImage->COMGETTER(Id) (id.asOutParam()); Assert (!id.isEmpty()); CFGNODE imageNode = 0; CFGLDRCreateChildNode (floppyNode, "Image", &imageNode); CFGLDRSetUUID (imageNode, "uuid", id.ptr()); CFGLDRReleaseNode (imageNode); break; } case DriveState_HostDriveCaptured: { Assert (!mFloppyDrive->data()->mHostDrive.isNull()); Bstr name; rc = mFloppyDrive->data()->mHostDrive->COMGETTER(Name) (name.asOutParam()); Assert (!name.isEmpty()); CFGNODE hostDriveNode = 0; CFGLDRCreateChildNode (floppyNode, "HostDrive", &hostDriveNode); CFGLDRSetBSTR (hostDriveNode, "src", name); CFGLDRReleaseNode (hostDriveNode); break; } case DriveState_NotMounted: /* do nothing, i.e.leave the Floppy drive node empty */ break; default: ComAssertMsgFailedBreak (("Invalid Floppy drive state: %d\n", mFloppyDrive->data()->mDriveState), rc = E_FAIL); } CFGLDRReleaseNode (floppyNode); } while (0); if (FAILED (rc)) return rc; /* USB Controller (required) */ rc = mUSBController->saveSettings (aNode); if (FAILED (rc)) return rc; /* Network adapters (required) */ do { CFGNODE nwNode = 0; CFGLDRCreateChildNode (aNode, "Network", &nwNode); for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) { CFGNODE networkAdapterNode = 0; CFGLDRAppendChildNode (nwNode, "Adapter", &networkAdapterNode); CFGLDRSetUInt32 (networkAdapterNode, "slot", slot); CFGLDRSetBool (networkAdapterNode, "enabled", !!mNetworkAdapters [slot]->data()->mEnabled); CFGLDRSetBSTR (networkAdapterNode, "MACAddress", mNetworkAdapters [slot]->data()->mMACAddress); CFGLDRSetBool (networkAdapterNode, "cable", !!mNetworkAdapters [slot]->data()->mCableConnected); if (mNetworkAdapters [slot]->data()->mTraceEnabled) CFGLDRSetBool (networkAdapterNode, "trace", true); CFGLDRSetBSTR (networkAdapterNode, "tracefile", mNetworkAdapters [slot]->data()->mTraceFile); switch (mNetworkAdapters [slot]->data()->mAdapterType) { case NetworkAdapterType_NetworkAdapterAm79C970A: CFGLDRSetString (networkAdapterNode, "type", "Am79C970A"); break; case NetworkAdapterType_NetworkAdapterAm79C973: CFGLDRSetString (networkAdapterNode, "type", "Am79C973"); break; default: ComAssertMsgFailedBreak (("Invalid network adapter type: %d\n", mNetworkAdapters [slot]->data()->mAdapterType), rc = E_FAIL); } CFGNODE attachmentNode = 0; switch (mNetworkAdapters [slot]->data()->mAttachmentType) { case NetworkAttachmentType_NoNetworkAttachment: { /* do nothing -- empty content */ break; } case NetworkAttachmentType_NATNetworkAttachment: { CFGLDRAppendChildNode (networkAdapterNode, "NAT", &attachmentNode); break; } case NetworkAttachmentType_HostInterfaceNetworkAttachment: { CFGLDRAppendChildNode (networkAdapterNode, "HostInterface", &attachmentNode); const Bstr &name = mNetworkAdapters [slot]->data()->mHostInterface; #ifdef __WIN__ Assert (!name.isNull()); #endif #ifdef VBOX_WITH_UNIXY_TAP_NETWORKING if (!name.isEmpty()) #endif CFGLDRSetBSTR (attachmentNode, "name", name); #ifdef VBOX_WITH_UNIXY_TAP_NETWORKING const Bstr &tapSetupApp = mNetworkAdapters [slot]->data()->mTAPSetupApplication; if (!tapSetupApp.isEmpty()) CFGLDRSetBSTR (attachmentNode, "TAPSetup", tapSetupApp); const Bstr &tapTerminateApp = mNetworkAdapters [slot]->data()->mTAPTerminateApplication; if (!tapTerminateApp.isEmpty()) CFGLDRSetBSTR (attachmentNode, "TAPTerminate", tapTerminateApp); #endif /* VBOX_WITH_UNIXY_TAP_NETWORKING */ break; } case NetworkAttachmentType_InternalNetworkAttachment: { CFGLDRAppendChildNode (networkAdapterNode, "InternalNetwork", &attachmentNode); const Bstr &name = mNetworkAdapters[slot]->data()->mInternalNetwork; Assert(!name.isNull()); CFGLDRSetBSTR (attachmentNode, "name", name); break; } default: { ComAssertFailedBreak (rc = E_FAIL); break; } } if (attachmentNode) CFGLDRReleaseNode (attachmentNode); CFGLDRReleaseNode (networkAdapterNode); } CFGLDRReleaseNode (nwNode); } while (0); if (FAILED (rc)) return rc; /* Audio adapter */ do { CFGNODE adapterNode = 0; CFGLDRCreateChildNode (aNode, "AudioAdapter", &adapterNode); switch (mAudioAdapter->data()->mAudioDriver) { case AudioDriverType_NullAudioDriver: { CFGLDRSetString (adapterNode, "driver", "null"); break; } #ifdef __WIN__ case AudioDriverType_WINMMAudioDriver: { CFGLDRSetString (adapterNode, "driver", "winmm"); break; } case AudioDriverType_DSOUNDAudioDriver: { CFGLDRSetString (adapterNode, "driver", "dsound"); break; } #endif /* __WIN__ */ #ifdef VBOX_WITH_ALSA case AudioDriverType_ALSAAudioDriver: { CFGLDRSetString (adapterNode, "driver", "alsa"); break; } #else /* fall back to OSS */ case AudioDriverType_ALSAAudioDriver: #endif #ifdef __LINUX__ case AudioDriverType_OSSAudioDriver: { CFGLDRSetString (adapterNode, "driver", "oss"); break; } #endif /* __LINUX__ */ default: ComAssertMsgFailedBreak (("Wrong audio driver type! driver = %d\n", mAudioAdapter->data()->mAudioDriver), rc = E_FAIL); } CFGLDRSetBool (adapterNode, "enabled", !!mAudioAdapter->data()->mEnabled); CFGLDRReleaseNode (adapterNode); } while (0); if (FAILED (rc)) return rc; /* Shared folders */ do { CFGNODE sharedFoldersNode = 0; CFGLDRCreateChildNode (aNode, "SharedFolders", &sharedFoldersNode); for (HWData::SharedFolderList::const_iterator it = mHWData->mSharedFolders.begin(); it != mHWData->mSharedFolders.end(); ++ it) { ComObjPtr folder = *it; CFGNODE folderNode = 0; CFGLDRAppendChildNode (sharedFoldersNode, "SharedFolder", &folderNode); /* all are mandatory */ CFGLDRSetBSTR (folderNode, "name", folder->name()); CFGLDRSetBSTR (folderNode, "hostPath", folder->hostPath()); CFGLDRReleaseNode (folderNode); } CFGLDRReleaseNode (sharedFoldersNode); } while (0); /* Clipboard */ { CFGNODE clipNode = 0; CFGLDRCreateChildNode (aNode, "Clipboard", &clipNode); char *mode = "Disabled"; switch (mHWData->mClipboardMode) { case ClipboardMode_ClipDisabled: /* already assigned */ break; case ClipboardMode_ClipHostToGuest: mode = "HostToGuest"; break; case ClipboardMode_ClipGuestToHost: mode = "GuestToHost"; break; case ClipboardMode_ClipBidirectional: mode = "Bidirectional"; break; default: AssertMsgFailed (("Clipboard mode %d is invalid", mHWData->mClipboardMode)); break; } CFGLDRSetString (clipNode, "mode", mode); CFGLDRReleaseNode (clipNode); } return rc; } /** * Saves the hard disk confguration. * It is assumed that the given node is empty. * * @param aNode node to save the hard disk confguration to */ HRESULT Machine::saveHardDisks (CFGNODE aNode) { AssertReturn (aNode, E_INVALIDARG); HRESULT rc = S_OK; for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end() && SUCCEEDED (rc); ++ it) { ComObjPtr att = *it; CFGNODE hdNode = 0; CFGLDRAppendChildNode (aNode, "HardDiskAttachment", &hdNode); do { const char *bus = NULL; switch (att->controller()) { case DiskControllerType_IDE0Controller: bus = "ide0"; break; case DiskControllerType_IDE1Controller: bus = "ide1"; break; default: ComAssertFailedBreak (rc = E_FAIL); } if (FAILED (rc)) break; const char *dev = NULL; switch (att->deviceNumber()) { case 0: dev = "master"; break; case 1: dev = "slave"; break; default: ComAssertFailedBreak (rc = E_FAIL); } if (FAILED (rc)) break; CFGLDRSetUUID (hdNode, "hardDisk", att->hardDisk()->id()); CFGLDRSetString (hdNode, "bus", bus); CFGLDRSetString (hdNode, "device", dev); } while (0); CFGLDRReleaseNode (hdNode); } return rc; } /** * Saves machine state settings as defined by aFlags * (SaveSTS_* values). * * @param aFlags a combination of SaveSTS_* flags * * @note Locks objects! */ HRESULT Machine::saveStateSettings (int aFlags) { if (aFlags == 0) return S_OK; AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AutoLock alock (this); /* load the config file */ CFGHANDLE configLoader = 0; HRESULT rc = openConfigLoader (&configLoader); if (FAILED (rc)) return rc; CFGNODE machineNode = 0; CFGLDRGetNode (configLoader, "VirtualBox/Machine", 0, &machineNode); do { ComAssertBreak (machineNode, rc = E_FAIL); if (aFlags & SaveSTS_CurStateModified) { if (!mData->mCurrentStateModified) CFGLDRSetBool (machineNode, "currentStateModified", false); else CFGLDRDeleteAttribute (machineNode, "currentStateModified"); } if (aFlags & SaveSTS_StateFilePath) { if (mSSData->mStateFilePath) CFGLDRSetBSTR (machineNode, "stateFile", mSSData->mStateFilePath); else CFGLDRDeleteAttribute (machineNode, "stateFile"); } if (aFlags & SaveSTS_StateTimeStamp) { Assert (mData->mMachineState != MachineState_Aborted || mSSData->mStateFilePath.isNull()); CFGLDRSetDateTime (machineNode, "lastStateChange", mData->mLastStateChange); // set the aborted attribute when appropriate if (mData->mMachineState == MachineState_Aborted) CFGLDRSetBool (machineNode, "aborted", true); else CFGLDRDeleteAttribute (machineNode, "aborted"); } } while (0); if (machineNode) CFGLDRReleaseNode (machineNode); if (SUCCEEDED (rc)) rc = closeConfigLoader (configLoader, true /* aSaveBeforeClose */); else closeConfigLoader (configLoader, false /* aSaveBeforeClose */); return rc; } /** * Cleans up all differencing hard disks based on immutable hard disks. * * @note Locks objects! */ HRESULT Machine::wipeOutImmutableDiffs() { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AutoReaderLock alock (this); AssertReturn (mData->mMachineState == MachineState_PoweredOff || mData->mMachineState == MachineState_Aborted, E_FAIL); for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hd = (*it)->hardDisk(); AutoLock hdLock (hd); if(hd->isParentImmutable()) { /// @todo (dmik) no error handling for now // (need async error reporting for this) hd->asVDI()->wipeOutImage(); } } return S_OK; } /** * Fixes up lazy hard disk attachments by creating or deleting differencing * hard disks when machine settings are being committed. * Must be called only from #commit(). * * @note Locks objects! */ HRESULT Machine::fixupHardDisks (bool aCommit) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AutoLock alock (this); /* no attac/detach operations -- nothing to do */ if (!mHDData.isBackedUp()) { mHDData->mHDAttachmentsChanged = false; return S_OK; } AssertReturn (mData->mRegistered, E_FAIL); if (aCommit) { /* * changes are being committed, * perform actual diff image creation, deletion etc. */ /* take a copy of backed up attachments (will modify it) */ HDData::HDAttachmentList backedUp = mHDData.backedUpData()->mHDAttachments; /* list of new diffs created */ std::list > newDiffs; HRESULT rc = S_OK; /* go through current attachments */ for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; ComObjPtr hd = hda->hardDisk(); AutoLock hdLock (hd); if (!hda->isDirty()) { /* * not dirty, therefore was either attached before backing up * or doesn't need any fixup (already fixed up); try to locate * this hard disk among backed up attachments and remove from * there to prevent it from being deassociated/deleted */ HDData::HDAttachmentList::iterator oldIt; for (oldIt = backedUp.begin(); oldIt != backedUp.end(); ++ oldIt) if ((*oldIt)->hardDisk().equalsTo (hd)) break; if (oldIt != backedUp.end()) { /* remove from there */ backedUp.erase (oldIt); // LogTraceMsg (("FC: %ls found in old\n", hd->toString().raw())); } } else { /* dirty, determine what to do */ bool needDiff = false; bool searchAmongSnapshots = false; switch (hd->type()) { case HardDiskType_ImmutableHardDisk: { /* decrease readers increased in AttachHardDisk() */ hd->releaseReader(); // LogTraceMsg (("FC: %ls released\n", hd->toString().raw())); /* indicate we need a diff (indirect attachment) */ needDiff = true; break; } case HardDiskType_WritethroughHardDisk: { /* reset the dirty flag */ hda->updateHardDisk (hd, false /* aDirty */); // LogTraceMsg (("FC: %ls updated\n", hd->toString().raw())); break; } case HardDiskType_NormalHardDisk: { if (hd->snapshotId().isEmpty()) { /* reset the dirty flag */ hda->updateHardDisk (hd, false /* aDirty */); // LogTraceMsg (("FC: %ls updated\n", hd->toString().raw())); } else { /* decrease readers increased in AttachHardDisk() */ hd->releaseReader(); // LogTraceMsg (("FC: %ls released\n", hd->toString().raw())); /* indicate we need a diff (indirect attachment) */ needDiff = true; /* search for the most recent base among snapshots */ searchAmongSnapshots = true; } break; } } if (!needDiff) continue; bool createDiff = false; /* * see whether any previously attached hard disk has the * the currently attached one (Normal or Independent) as * the root */ HDData::HDAttachmentList::iterator foundIt = backedUp.end(); for (HDData::HDAttachmentList::iterator it = backedUp.begin(); it != backedUp.end(); ++ it) { if ((*it)->hardDisk()->root().equalsTo (hd)) { /* * matched dev and ctl (i.e. attached to the same place) * will win and immediately stop the search; otherwise * the first attachment that matched the hd only will * be used */ if ((*it)->deviceNumber() == hda->deviceNumber() && (*it)->controller() == hda->controller()) { foundIt = it; break; } else if (foundIt == backedUp.end()) { /* * not an exact match; ensure there is no exact match * among other current attachments referring the same * root (to prevent this attachmend from reusing the * hard disk of the other attachment that will later * give the exact match or already gave it before) */ bool canReuse = true; for (HDData::HDAttachmentList::const_iterator it2 = mHDData->mHDAttachments.begin(); it2 != mHDData->mHDAttachments.end(); ++ it2) { if ((*it2)->deviceNumber() == (*it)->deviceNumber() && (*it2)->controller() == (*it)->controller() && (*it2)->hardDisk()->root().equalsTo (hd)) { /* * the exact match, either non-dirty or dirty * one refers the same root: in both cases * we cannot reuse the hard disk, so break */ canReuse = false; break; } } if (canReuse) foundIt = it; } } } if (foundIt != backedUp.end()) { /* found either one or another, reuse the diff */ hda->updateHardDisk ((*foundIt)->hardDisk(), false /* aDirty */); // LogTraceMsg (("FC: %ls reused as %ls\n", hd->toString().raw(), // (*foundIt)->hardDisk()->toString().raw())); /* remove from there */ backedUp.erase (foundIt); } else { /* was not attached, need a diff */ createDiff = true; } if (!createDiff) continue; ComObjPtr baseHd = hd; if (searchAmongSnapshots) { /* * find the most recent diff based on the currently * attached root (Normal hard disk) among snapshots */ ComObjPtr snap = mData->mCurrentSnapshot; while (snap) { AutoLock snapLock (snap); const HDData::HDAttachmentList &snapAtts = snap->data().mMachine->hdData()->mHDAttachments; HDData::HDAttachmentList::const_iterator foundIt = snapAtts.end(); for (HDData::HDAttachmentList::const_iterator it = snapAtts.begin(); it != snapAtts.end(); ++ it) { if ((*it)->hardDisk()->root().equalsTo (hd)) { /* * matched dev and ctl (i.e. attached to the same place) * will win and immediately stop the search; otherwise * the first attachment that matched the hd only will * be used */ if ((*it)->deviceNumber() == hda->deviceNumber() && (*it)->controller() == hda->controller()) { foundIt = it; break; } else if (foundIt == snapAtts.end()) foundIt = it; } } if (foundIt != snapAtts.end()) { /* the most recent diff has been found, use as a base */ baseHd = (*foundIt)->hardDisk(); // LogTraceMsg (("FC: %ls: recent found %ls\n", // hd->toString().raw(), baseHd->toString().raw())); break; } snap = snap->parent(); } } /* create a new diff for the hard disk being indirectly attached */ AutoLock baseHdLock (baseHd); baseHd->addReader(); ComObjPtr vdi; rc = baseHd->createDiffHardDisk (mUserData->mSnapshotFolderFull, mData->mUuid, vdi, NULL); baseHd->releaseReader(); CheckComRCBreakRC (rc); newDiffs.push_back (ComObjPtr (vdi)); /* update the attachment and reset the dirty flag */ hda->updateHardDisk (ComObjPtr (vdi), false /* aDirty */); // LogTraceMsg (("FC: %ls: diff created %ls\n", // baseHd->toString().raw(), vdi->toString().raw())); } } if (FAILED (rc)) { /* delete diffs we created */ for (std::list >::const_iterator it = newDiffs.begin(); it != newDiffs.end(); ++ it) { /* * unregisterDiffHardDisk() is supposed to delete and uninit * the differencing hard disk */ mParent->unregisterDiffHardDisk (*it); /* too bad if we fail here, but nothing to do, just continue */ } /* the best is to rollback the changes... */ mHDData.rollback(); mHDData->mHDAttachmentsChanged = false; // LogTraceMsg (("FC: ROLLED BACK\n")); return rc; } /* * go through the rest of old attachments and delete diffs * or deassociate hard disks from machines (they will become detached) */ for (HDData::HDAttachmentList::iterator it = backedUp.begin(); it != backedUp.end(); ++ it) { ComObjPtr hda = *it; ComObjPtr hd = hda->hardDisk(); AutoLock hdLock (hd); if (hd->isDifferencing()) { /* * unregisterDiffHardDisk() is supposed to delete and uninit * the differencing hard disk */ // LogTraceMsg (("FC: %ls diff deleted\n", hd->toString().raw())); rc = mParent->unregisterDiffHardDisk (hd); /* * too bad if we fail here, but nothing to do, just continue * (the last rc will be returned to the caller though) */ } else { /* deassociate from this machine */ // LogTraceMsg (("FC: %ls deassociated\n", hd->toString().raw())); hd->setMachineId (Guid()); } } /* commit all the changes */ mHDData->mHDAttachmentsChanged = mHDData.hasActualChanges(); mHDData.commit(); // LogTraceMsg (("FC: COMMITTED\n")); return rc; } /* * changes are being rolled back, * go trhough all current attachments and fix up dirty ones * the way it is done in DetachHardDisk() */ for (HDData::HDAttachmentList::iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; ComObjPtr hd = hda->hardDisk(); AutoLock hdLock (hd); if (hda->isDirty()) { switch (hd->type()) { case HardDiskType_ImmutableHardDisk: { /* decrease readers increased in AttachHardDisk() */ hd->releaseReader(); // LogTraceMsg (("FR: %ls released\n", hd->toString().raw())); break; } case HardDiskType_WritethroughHardDisk: { /* deassociate from this machine */ hd->setMachineId (Guid()); // LogTraceMsg (("FR: %ls deassociated\n", hd->toString().raw())); break; } case HardDiskType_NormalHardDisk: { if (hd->snapshotId().isEmpty()) { /* deassociate from this machine */ hd->setMachineId (Guid()); // LogTraceMsg (("FR: %ls deassociated\n", hd->toString().raw())); } else { /* decrease readers increased in AttachHardDisk() */ hd->releaseReader(); // LogTraceMsg (("FR: %ls released\n", hd->toString().raw())); } break; } } } } /* rollback all the changes */ mHDData.rollback(); // LogTraceMsg (("FR: ROLLED BACK\n")); return S_OK; } /** * Creates differencing hard disks for all normal hard disks * and replaces attachments to refer to created disks. * Used when taking a snapshot or when discarding the current state. * * @param aSnapshotId ID of the snapshot being taken * or NULL if the current state is being discarded * @param aFolder folder where to create diff. hard disks * @param aProgress progress object to run (must contain at least as * many operations left as the number of VDIs attached) * @param aOnline whether the machine is online (i.e., when the EMT * thread is paused, OR when current hard disks are * marked as busy for some other reason) * * @note * The progress object is not marked as completed, neither on success * nor on failure. This is a responsibility of the caller. * * @note Locks mParent + this object for writing */ HRESULT Machine::createSnapshotDiffs (const Guid *aSnapshotId, const Bstr &aFolder, const ComObjPtr &aProgress, bool aOnline) { AssertReturn (!aFolder.isEmpty(), E_FAIL); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* accessing mParent methods below needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); HRESULT rc = S_OK; // first pass: check accessibility before performing changes if (!aOnline) { for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; ComObjPtr hd = hda->hardDisk(); AutoLock hdLock (hd); ComAssertMsgBreak (hd->type() == HardDiskType_NormalHardDisk, ("Invalid hard disk type %d\n", hd->type()), rc = E_FAIL); ComAssertMsgBreak (!hd->isParentImmutable() || hd->storageType() == HardDiskStorageType_VirtualDiskImage, ("Invalid hard disk storage type %d\n", hd->storageType()), rc = E_FAIL); Bstr accessError; rc = hd->getAccessible (accessError); CheckComRCBreakRC (rc); if (!accessError.isNull()) { rc = setError (E_FAIL, tr ("Hard disk '%ls' is not accessible (%ls)"), hd->toString().raw(), accessError.raw()); break; } } CheckComRCReturnRC (rc); } HDData::HDAttachmentList attachments; // second pass: perform changes for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; ComObjPtr hd = hda->hardDisk(); AutoLock hdLock (hd); ComObjPtr parent = hd->parent(); AutoLock parentHdLock (parent); ComObjPtr newHd; // clear busy flag if the VM is online if (aOnline) hd->clearBusy(); // increase readers hd->addReader(); if (hd->isParentImmutable()) { aProgress->advanceOperation (Bstr (Utf8StrFmt ( tr ("Preserving immutable hard disk '%ls'"), parent->toString (true /* aShort */).raw()))); parentHdLock.unlock(); alock.leave(); // create a copy of the independent diff ComObjPtr vdi; rc = hd->asVDI()->cloneDiffImage (aFolder, mData->mUuid, vdi, aProgress); newHd = vdi; alock.enter(); parentHdLock.lock(); // decrease readers (hd is no more used for reading in any case) hd->releaseReader(); } else { // checked in the first pass Assert (hd->type() == HardDiskType_NormalHardDisk); aProgress->advanceOperation (Bstr (Utf8StrFmt ( tr ("Creating a differencing hard disk for '%ls'"), hd->root()->toString (true /* aShort */).raw()))); parentHdLock.unlock(); alock.leave(); // create a new diff for the image being attached ComObjPtr vdi; rc = hd->createDiffHardDisk (aFolder, mData->mUuid, vdi, aProgress); newHd = vdi; alock.enter(); parentHdLock.lock(); if (SUCCEEDED (rc)) { // if online, hd must keep a reader referece if (!aOnline) hd->releaseReader(); } else { // decrease readers hd->releaseReader(); } } if (SUCCEEDED (rc)) { ComObjPtr newHda; newHda.createObject(); rc = newHda->init (newHd, hda->controller(), hda->deviceNumber(), false /* aDirty */); if (SUCCEEDED (rc)) { // associate the snapshot id with the old hard disk if (hd->type() != HardDiskType_WritethroughHardDisk && aSnapshotId) hd->setSnapshotId (*aSnapshotId); // add the new attachment attachments.push_back (newHda); // if online, newHd must be marked as busy if (aOnline) newHd->setBusy(); } } if (FAILED (rc)) { // set busy flag back if the VM is online if (aOnline) hd->setBusy(); break; } } if (SUCCEEDED (rc)) { // replace the whole list of attachments with the new one mHDData->mHDAttachments = attachments; } else { // delete those diffs we've just created for (HDData::HDAttachmentList::const_iterator it = attachments.begin(); it != attachments.end(); ++ it) { ComObjPtr hd = (*it)->hardDisk(); AutoLock hdLock (hd); Assert (hd->children().size() == 0); Assert (hd->isDifferencing()); // unregisterDiffHardDisk() is supposed to delete and uninit // the differencing hard disk mParent->unregisterDiffHardDisk (hd); } } return rc; } /** * Deletes differencing hard disks created by createSnapshotDiffs() in case * if snapshot creation was failed. * * @param aSnapshot failed snapshot * * @note Locks mParent + this object for writing. */ HRESULT Machine::deleteSnapshotDiffs (const ComObjPtr &aSnapshot) { AssertReturn (!aSnapshot.isNull(), E_FAIL); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* accessing mParent methods below needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); /* short cut: check whether attachments are all the same */ if (mHDData->mHDAttachments == aSnapshot->data().mMachine->mHDData->mHDAttachments) return S_OK; HRESULT rc = S_OK; for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; ComObjPtr hd = hda->hardDisk(); AutoLock hdLock (hd); ComObjPtr parent = hd->parent(); AutoLock parentHdLock (parent); if (!parent || parent->snapshotId() != aSnapshot->data().mId) continue; /* must not have children */ ComAssertRet (hd->children().size() == 0, E_FAIL); /* deassociate the old hard disk from the given snapshot's ID */ parent->setSnapshotId (Guid()); /* unregisterDiffHardDisk() is supposed to delete and uninit * the differencing hard disk */ rc = mParent->unregisterDiffHardDisk (hd); /* continue on error */ } /* restore the whole list of attachments from the failed snapshot */ mHDData->mHDAttachments = aSnapshot->data().mMachine->mHDData->mHDAttachments; return rc; } /** * Helper to lock the machine configuration for write access. * * @return S_OK or E_FAIL and sets error info on failure * * @note Doesn't lock anything (must be called from this object's lock) */ HRESULT Machine::lockConfig() { HRESULT rc = S_OK; if (!isConfigLocked()) { /* open the associated config file */ int vrc = RTFileOpen (&mData->mHandleCfgFile, Utf8Str (mData->mConfigFileFull), RTFILE_O_READWRITE | RTFILE_O_OPEN | RTFILE_O_DENY_WRITE); if (VBOX_FAILURE (vrc)) mData->mHandleCfgFile = NIL_RTFILE; } LogFlowThisFunc (("mConfigFile={%ls}, mHandleCfgFile=%d, rc=%08X\n", mData->mConfigFileFull.raw(), mData->mHandleCfgFile, rc)); return rc; } /** * Helper to unlock the machine configuration from write access * * @return S_OK * * @note Doesn't lock anything. * @note Not thread safe (must be called from this object's lock). */ HRESULT Machine::unlockConfig() { HRESULT rc = S_OK; if (isConfigLocked()) { RTFileClose(mData->mHandleCfgFile); mData->mHandleCfgFile = NIL_RTFILE; } LogFlowThisFunc (("\n")); return rc; } /** * Returns true if the settings file is located in the directory named exactly * as the machine. This will be true if the machine settings structure was * created by default in #openConfigLoader(). * * @param aSettingsDir if not NULL, the full machine settings file directory * name will be assigned there. * * @note Doesn't lock anything. * @note Not thread safe (must be called from this object's lock). */ bool Machine::isInOwnDir (Utf8Str *aSettingsDir /* = NULL */) { Utf8Str settingsDir = mData->mConfigFileFull; RTPathStripFilename (settingsDir.mutableRaw()); char *dirName = RTPathFilename (settingsDir); AssertReturn (dirName, false); /* if we don't rename anything on name change, return false shorlty */ if (!mUserData->mNameSync) return false; if (aSettingsDir) *aSettingsDir = settingsDir; return Bstr (dirName) == mUserData->mName; } /** * @note Locks objects for reading! */ bool Machine::isModified() { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), false); AutoReaderLock alock (this); for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) if (mNetworkAdapters [slot] && mNetworkAdapters [slot]->isModified()) return true; return mUserData.isBackedUp() || mHWData.isBackedUp() || mHDData.isBackedUp() || #ifdef VBOX_VRDP (mVRDPServer && mVRDPServer->isModified()) || #endif (mDVDDrive && mDVDDrive->isModified()) || (mFloppyDrive && mFloppyDrive->isModified()) || (mAudioAdapter && mAudioAdapter->isModified()) || (mUSBController && mUSBController->isModified()) || (mBIOSSettings && mBIOSSettings->isModified()); } /** * @note This method doesn't check (ignores) actual changes to mHDData. * Use mHDData.mHDAttachmentsChanged right after #commit() instead. * * @param aIgnoreUserData |true| to ignore changes to mUserData * * @note Locks objects for reading! */ bool Machine::isReallyModified (bool aIgnoreUserData /* = false */) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), false); AutoReaderLock alock (this); for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) if (mNetworkAdapters [slot] && mNetworkAdapters [slot]->isReallyModified()) return true; return (!aIgnoreUserData && mUserData.hasActualChanges()) || mHWData.hasActualChanges() || /* ignore mHDData */ //mHDData.hasActualChanges() || #ifdef VBOX_VRDP (mVRDPServer && mVRDPServer->isReallyModified()) || #endif (mDVDDrive && mDVDDrive->isReallyModified()) || (mFloppyDrive && mFloppyDrive->isReallyModified()) || (mAudioAdapter && mAudioAdapter->isReallyModified()) || (mUSBController && mUSBController->isReallyModified()) || (mBIOSSettings && mBIOSSettings->isReallyModified()); } /** * Discards all changes to machine settings. * * @param aNotify whether to notify the direct session about changes or not * * @note Locks objects! */ void Machine::rollback (bool aNotify) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), (void) 0); AutoLock alock (this); mUserData.rollback(); mHWData.rollback(); if (mHDData.isBackedUp()) fixupHardDisks (false /* aCommit */); bool vrdpChanged = false, dvdChanged = false, floppyChanged = false, usbChanged = false; ComPtr networkAdapters [ELEMENTS (mNetworkAdapters)]; if (mBIOSSettings) mBIOSSettings->rollback(); #ifdef VBOX_VRDP if (mVRDPServer) vrdpChanged = mVRDPServer->rollback(); #endif if (mDVDDrive) dvdChanged = mDVDDrive->rollback(); if (mFloppyDrive) floppyChanged = mFloppyDrive->rollback(); if (mAudioAdapter) mAudioAdapter->rollback(); if (mUSBController) usbChanged = mUSBController->rollback(); for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) if (mNetworkAdapters [slot]) if (mNetworkAdapters [slot]->rollback()) networkAdapters [slot] = mNetworkAdapters [slot]; if (aNotify) { // inform the direct session about changes ComObjPtr that = this; alock.leave(); if (vrdpChanged) that->onVRDPServerChange(); if (dvdChanged) that->onDVDDriveChange(); if (floppyChanged) that->onFloppyDriveChange(); if (usbChanged) that->onUSBControllerChange(); for (ULONG slot = 0; slot < ELEMENTS (networkAdapters); slot ++) if (networkAdapters [slot]) that->onNetworkAdapterChange (networkAdapters [slot]); } } /** * Commits all the changes to machine settings. * * Note that when committing fails at some stage, it still continues * until the end. So, all data will either be actually committed or rolled * back (for failed cases) and the returned result code will describe the * first failure encountered. However, #isModified() will still return true * in case of failure, to indicade that settings in memory and on disk are * out of sync. * * @note Locks objects! */ HRESULT Machine::commit() { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AutoLock alock (this); HRESULT rc = S_OK; /* * use safe commit to ensure Snapshot machines (that share mUserData) * will still refer to a valid memory location */ mUserData.commitCopy(); mHWData.commit(); if (mHDData.isBackedUp()) rc = fixupHardDisks (true /* aCommit */); mBIOSSettings->commit(); #ifdef VBOX_VRDP mVRDPServer->commit(); #endif mDVDDrive->commit(); mFloppyDrive->commit(); mAudioAdapter->commit(); mUSBController->commit(); for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) mNetworkAdapters [slot]->commit(); if (mType == IsSessionMachine) { /* attach new data to the primary machine and reshare it */ mPeer->mUserData.attach (mUserData); mPeer->mHWData.attach (mHWData); mPeer->mHDData.attach (mHDData); } if (FAILED (rc)) { /* * backup arbitrary data item to cause #isModified() to still return * true in case of any error */ mHWData.backup(); } return rc; } /** * Copies all the hardware data from the given machine. * * @note * This method must be called from under this object's lock. * @note * This method doesn't call #commit(), so all data remains backed up * and unsaved. */ void Machine::copyFrom (Machine *aThat) { AssertReturn (mType == IsMachine || mType == IsSessionMachine, (void) 0); AssertReturn (aThat->mType == IsSnapshotMachine, (void) 0); mHWData.assignCopy (aThat->mHWData); // create copies of all shared folders (mHWData after attiching a copy // contains just references to original objects) for (HWData::SharedFolderList::iterator it = mHWData->mSharedFolders.begin(); it != mHWData->mSharedFolders.end(); ++ it) { ComObjPtr folder; folder.createObject(); HRESULT rc = folder->initCopy (machine(), *it); AssertComRC (rc); *it = folder; } mBIOSSettings->copyFrom (aThat->mBIOSSettings); #ifdef VBOX_VRDP mVRDPServer->copyFrom (aThat->mVRDPServer); #endif mDVDDrive->copyFrom (aThat->mDVDDrive); mFloppyDrive->copyFrom (aThat->mFloppyDrive); mAudioAdapter->copyFrom (aThat->mAudioAdapter); mUSBController->copyFrom (aThat->mUSBController); for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) mNetworkAdapters [slot]->copyFrom (aThat->mNetworkAdapters [slot]); } ///////////////////////////////////////////////////////////////////////////// // SessionMachine class ///////////////////////////////////////////////////////////////////////////// /** Task structure for asynchronous VM operations */ struct SessionMachine::Task { Task (SessionMachine *m, Progress *p) : machine (m), progress (p) , state (m->data()->mMachineState) // save the current machine state , subTask (false), settingsChanged (false) {} void modifyLastState (MachineState_T s) { *const_cast (&state) = s; } virtual void handler() = 0; const ComObjPtr machine; const ComObjPtr progress; const MachineState_T state; bool subTask : 1; bool settingsChanged : 1; }; /** Take snapshot task */ struct SessionMachine::TakeSnapshotTask : public SessionMachine::Task { TakeSnapshotTask (SessionMachine *m) : Task (m, NULL) {} void handler() { machine->takeSnapshotHandler (*this); } }; /** Discard snapshot task */ struct SessionMachine::DiscardSnapshotTask : public SessionMachine::Task { DiscardSnapshotTask (SessionMachine *m, Progress *p, Snapshot *s) : Task (m, p) , snapshot (s) {} DiscardSnapshotTask (const Task &task, Snapshot *s) : Task (task) , snapshot (s) {} void handler() { machine->discardSnapshotHandler (*this); } const ComObjPtr snapshot; }; /** Discard current state task */ struct SessionMachine::DiscardCurrentStateTask : public SessionMachine::Task { DiscardCurrentStateTask (SessionMachine *m, Progress *p, bool discardCurSnapshot) : Task (m, p), discardCurrentSnapshot (discardCurSnapshot) {} void handler() { machine->discardCurrentStateHandler (*this); } const bool discardCurrentSnapshot; }; //////////////////////////////////////////////////////////////////////////////// DEFINE_EMPTY_CTOR_DTOR (SessionMachine) HRESULT SessionMachine::FinalConstruct() { LogFlowThisFunc (("\n")); /* set the proper type to indicate we're the SessionMachine instance */ unconst (mType) = IsSessionMachine; #if defined(__WIN__) mIPCSem = NULL; #elif defined(VBOX_WITH_SYS_V_IPC_SESSION_WATCHER) mIPCSem = -1; #endif return S_OK; } void SessionMachine::FinalRelease() { LogFlowThisFunc (("\n")); uninit (Uninit::Unexpected); } /** * @note Must be called only by Machine::openSession() from its own write lock. */ HRESULT SessionMachine::init (Machine *aMachine) { LogFlowThisFuncEnter(); LogFlowThisFunc (("mName={%ls}\n", aMachine->mUserData->mName.raw())); AssertReturn (aMachine, E_INVALIDARG); AssertReturn (aMachine->lockHandle()->isLockedOnCurrentThread(), E_FAIL); /* Enclose the state transition NotReady->InInit->Ready */ AutoInitSpan autoInitSpan (this); AssertReturn (autoInitSpan.isOk(), E_UNEXPECTED); /* create the interprocess semaphore */ #if defined(__WIN__) mIPCSemName = aMachine->mData->mConfigFileFull; for (size_t i = 0; i < mIPCSemName.length(); i++) if (mIPCSemName[i] == '\\') mIPCSemName[i] = '/'; mIPCSem = ::CreateMutex (NULL, FALSE, mIPCSemName); ComAssertMsgRet (mIPCSem, ("Cannot create IPC mutex, err=0x%08X", ::GetLastError()), E_FAIL); #elif defined(VBOX_WITH_SYS_V_IPC_SESSION_WATCHER) Utf8Str configFile = aMachine->mData->mConfigFileFull; char *pszConfigFile = NULL; RTStrUtf8ToCurrentCP (&pszConfigFile, configFile); key_t key = ::ftok (pszConfigFile, 0); RTStrFree (pszConfigFile); mIPCSem = ::semget (key, 1, S_IRWXU | S_IRWXG | S_IRWXO | IPC_CREAT); ComAssertMsgRet (mIPCSem >= 0, ("Cannot create IPC semaphore, errno=%d", errno), E_FAIL); /* set the initial value to 1 */ int rv = ::semctl (mIPCSem, 0, SETVAL, 1); ComAssertMsgRet (rv == 0, ("Cannot init IPC semaphore, errno=%d", errno), E_FAIL); #endif /* memorize the peer Machine */ unconst (mPeer) = aMachine; /* share the parent pointer */ unconst (mParent) = aMachine->mParent; /* take the pointers to data to share */ mData.share (aMachine->mData); mSSData.share (aMachine->mSSData); mUserData.share (aMachine->mUserData); mHWData.share (aMachine->mHWData); mHDData.share (aMachine->mHDData); unconst (mBIOSSettings).createObject(); mBIOSSettings->init (this, aMachine->mBIOSSettings); #ifdef VBOX_VRDP /* create another VRDPServer object that will be mutable */ unconst (mVRDPServer).createObject(); mVRDPServer->init (this, aMachine->mVRDPServer); #endif /* create another DVD drive object that will be mutable */ unconst (mDVDDrive).createObject(); mDVDDrive->init (this, aMachine->mDVDDrive); /* create another floppy drive object that will be mutable */ unconst (mFloppyDrive).createObject(); mFloppyDrive->init (this, aMachine->mFloppyDrive); /* create another audio adapter object that will be mutable */ unconst (mAudioAdapter).createObject(); mAudioAdapter->init (this, aMachine->mAudioAdapter); /* create another USB controller object that will be mutable */ unconst (mUSBController).createObject(); mUSBController->init (this, aMachine->mUSBController); /* create a list of network adapters that will be mutable */ for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) { unconst (mNetworkAdapters [slot]).createObject(); mNetworkAdapters [slot]->init (this, aMachine->mNetworkAdapters [slot]); } /* Confirm a successful initialization when it's the case */ autoInitSpan.setSucceeded(); LogFlowThisFuncLeave(); return S_OK; } /** * Uninitializes this session object. If the reason is other than * Uninit::Unexpected, then this method MUST be called from #checkForDeath(). * * @param aReason uninitialization reason * * @note Locks mParent + this object for writing. */ void SessionMachine::uninit (Uninit::Reason aReason) { LogFlowThisFuncEnter(); LogFlowThisFunc (("reason=%d\n", aReason)); /* * Strongly reference ourselves to prevent this object deletion after * mData->mSession.mMachine.setNull() below (which can release the last * reference and call the destructor). Important: this must be done before * accessing any members (and before AutoUninitSpan that does it as well). * This self reference will be released as the very last step on return. */ ComObjPtr selfRef = this; /* Enclose the state transition Ready->InUninit->NotReady */ AutoUninitSpan autoUninitSpan (this); if (autoUninitSpan.uninitDone()) { LogFlowThisFunc (("Already uninitialized\n")); LogFlowThisFuncLeave(); return; } if (autoUninitSpan.initFailed()) { /* * We've been called by init() because it's failed. It's not really * necessary (nor it's safe) to perform the regular uninit sequence * below, the following is enough. */ LogFlowThisFunc (("Initialization failed\n")); #if defined(__WIN__) if (mIPCSem) ::CloseHandle (mIPCSem); mIPCSem = NULL; #elif defined(VBOX_WITH_SYS_V_IPC_SESSION_WATCHER) if (mIPCSem >= 0) ::semctl (mIPCSem, 0, IPC_RMID); mIPCSem = -1; #endif uninitDataAndChildObjects(); unconst (mParent).setNull(); unconst (mPeer).setNull(); LogFlowThisFuncLeave(); return; } /* * We need to lock this object in uninit() because the lock is shared * with mPeer (as well as data we modify below). * mParent->addProcessToReap() and others need mParent lock. */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); if (isModified()) { LogWarningThisFunc (("Discarding unsaved settings changes!\n")); rollback (false /* aNotify */); } Assert (!mSnapshotData.mStateFilePath || !mSnapshotData.mSnapshot); if (mSnapshotData.mStateFilePath) { LogWarningThisFunc (("canceling failed save state request!\n")); endSavingState (FALSE /* aSuccess */); } else if (!!mSnapshotData.mSnapshot) { LogWarningThisFunc (("canceling untaken snapshot!\n")); endTakingSnapshot (FALSE /* aSuccess */); } /* release all captured USB devices */ mParent->host()->releaseAllUSBDevices (this); if (mData->mSession.mPid != NIL_RTPROCESS) { /* * pid is not NIL, meaning this machine's process has been started * using VirtualBox::OpenRemoteSession(), thus it is our child. * we need to queue this pid to be reaped (to avoid zombies on Linux) */ mParent->addProcessToReap (mData->mSession.mPid); mData->mSession.mPid = NIL_RTPROCESS; } if (aReason == Uninit::Unexpected) { /* * uninitialization didn't come from #checkForDeath(), so tell the * client watcher thread to update the set of machines that have * open sessions. */ mParent->updateClientWatcher(); } /* uninitialize all remote controls */ if (mData->mSession.mRemoteControls.size()) { LogFlowThisFunc (("Closing remote sessions (%d):\n", mData->mSession.mRemoteControls.size())); Data::Session::RemoteControlList::iterator it = mData->mSession.mRemoteControls.begin(); while (it != mData->mSession.mRemoteControls.end()) { LogFlowThisFunc ((" Calling remoteControl->Uninitialize()...\n")); HRESULT rc = (*it)->Uninitialize(); LogFlowThisFunc ((" remoteControl->Uninitialize() returned %08X\n", rc)); if (FAILED (rc)) LogWarningThisFunc (("Forgot to close the remote session?\n")); ++ it; } mData->mSession.mRemoteControls.clear(); } /* * An expected uninitialization can come only from #checkForDeath(). * Otherwise it means that something's got really wrong (for examlple, * the Session implementation has released the VirtualBox reference * before it triggered #OnSessionEnd(), or before releasing IPC semaphore, * etc). However, it's also possible, that the client releases the IPC * semaphore correctly (i.e. before it releases the VirtualBox reference), * but but the VirtualBox release event comes first to the server process. * This case is practically possible, so we should not assert on an * unexpected uninit, just log a warning. */ if ((aReason == Uninit::Unexpected)) LogWarningThisFunc (("Unexpected SessionMachine uninitialization!\n")); if (aReason != Uninit::Normal) mData->mSession.mDirectControl.setNull(); else { /* this must be null here (see #OnSessionEnd()) */ Assert (mData->mSession.mDirectControl.isNull()); Assert (mData->mSession.mState == SessionState_SessionClosing); Assert (!mData->mSession.mProgress.isNull()); mData->mSession.mProgress->notifyComplete (S_OK); mData->mSession.mProgress.setNull(); } /* remove the association between the peer machine and this session machine */ Assert (mData->mSession.mMachine == this || aReason == Uninit::Unexpected); /* reset the rest of session data */ mData->mSession.mMachine.setNull(); mData->mSession.mState = SessionState_SessionClosed; /* close the interprocess semaphore before leaving the shared lock */ #if defined(__WIN__) if (mIPCSem) ::CloseHandle (mIPCSem); mIPCSem = NULL; #elif defined(VBOX_WITH_SYS_V_IPC_SESSION_WATCHER) if (mIPCSem >= 0) ::semctl (mIPCSem, 0, IPC_RMID); mIPCSem = -1; #endif /* fire an event */ mParent->onSessionStateChange (mData->mUuid, SessionState_SessionClosed); uninitDataAndChildObjects(); /* leave the shared lock before setting the above two to NULL */ alock.leave(); unconst (mParent).setNull(); unconst (mPeer).setNull(); LogFlowThisFuncLeave(); } // AutoLock::Lockable interface //////////////////////////////////////////////////////////////////////////////// /** * Overrides VirtualBoxBase::lockHandle() in order to share the lock handle * with the primary Machine instance (mPeer). */ AutoLock::Handle *SessionMachine::lockHandle() const { AssertReturn (!mPeer.isNull(), NULL); return mPeer->lockHandle(); } // IInternalMachineControl methods //////////////////////////////////////////////////////////////////////////////// /** * @note Locks the same as #setMachineState() does. */ STDMETHODIMP SessionMachine::UpdateState (MachineState_T machineState) { return setMachineState (machineState); } /** * @note Locks this object for reading. */ STDMETHODIMP SessionMachine::GetIPCId (BSTR *id) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AutoReaderLock alock (this); #if defined(__WIN__) mIPCSemName.cloneTo (id); return S_OK; #elif defined(VBOX_WITH_SYS_V_IPC_SESSION_WATCHER) mData->mConfigFileFull.cloneTo (id); return S_OK; #else return S_FAIL; #endif } /** * @note Locks this object for reading. */ STDMETHODIMP SessionMachine::GetLogFolder (BSTR *aLogFolder) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AutoReaderLock alock (this); Utf8Str logFolder; getLogFolder (logFolder); Bstr (logFolder).cloneTo (aLogFolder); return S_OK; } /** * Goes through the USB filters of the given machine to see if the given * device matches any filter or not. * * @note Locks the same as USBController::hasMatchingFilter() does. */ STDMETHODIMP SessionMachine::RunUSBDeviceFilters (IUSBDevice *aUSBDevice, BOOL *aMatched) { if (!aUSBDevice) return E_INVALIDARG; if (!aMatched) return E_POINTER; AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); *aMatched = mUSBController->hasMatchingFilter (aUSBDevice); return S_OK; } /** * @note Locks the same as Host::captureUSBDevice() does. */ STDMETHODIMP SessionMachine::CaptureUSBDevice (INPTR GUIDPARAM aId, IUSBDevice **aHostDevice) { if (!aHostDevice) return E_POINTER; AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); // if cautureUSBDevice() fails, it must have set extended error info return mParent->host()->captureUSBDevice (this, aId, aHostDevice); } /** * @note Locks the same as Host::releaseUSBDevice() does. */ STDMETHODIMP SessionMachine::ReleaseUSBDevice (INPTR GUIDPARAM aId) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); return mParent->host()->releaseUSBDevice (this, aId); } /** * @note Locks the same as Host::autoCaptureUSBDevices() does. */ STDMETHODIMP SessionMachine::AutoCaptureUSBDevices (IUSBDeviceCollection **aHostDevices) { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); return mParent->host()->autoCaptureUSBDevices (this, aHostDevices); } /** * @note Locks the same as Host::releaseAllUSBDevices() does. */ STDMETHODIMP SessionMachine::ReleaseAllUSBDevices() { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); return mParent->host()->releaseAllUSBDevices (this); } /** * @note Locks mParent + this object for writing. */ STDMETHODIMP SessionMachine::OnSessionEnd (ISession *aSession, IProgress **aProgress) { LogFlowThisFuncEnter(); AssertReturn (aSession, E_INVALIDARG); AssertReturn (aProgress, E_INVALIDARG); AutoCaller autoCaller (this); LogFlowThisFunc (("state=%d\n", autoCaller.state())); /* * We don't assert below because it might happen that a non-direct session * informs us it is closed right after we've been uninitialized -- it's ok. */ CheckComRCReturnRC (autoCaller.rc()); /* get IInternalSessionControl interface */ ComPtr control (aSession); ComAssertRet (!control.isNull(), E_INVALIDARG); /* Progress::init() needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); if (control.equalsTo (mData->mSession.mDirectControl)) { ComAssertRet (aProgress, E_POINTER); /* The direct session is being normally closed by the client process * ----------------------------------------------------------------- */ /* go to the closing state (essential for all open*Session() calls and * for #checkForDeath()) */ Assert (mData->mSession.mState == SessionState_SessionOpen); mData->mSession.mState = SessionState_SessionClosing; /* set direct control to NULL to release the remote instance */ mData->mSession.mDirectControl.setNull(); LogFlowThisFunc (("Direct control is set to NULL\n")); /* * Create the progress object the client will use to wait until * #checkForDeath() is called to uninitialize this session object * after it releases the IPC semaphore. */ ComObjPtr progress; progress.createObject(); progress->init (mParent, (IMachine *) mPeer, Bstr (tr ("Closing session")), FALSE /* aCancelable */); progress.queryInterfaceTo (aProgress); mData->mSession.mProgress = progress; } else { /* the remote session is being normally closed */ Data::Session::RemoteControlList::iterator it = mData->mSession.mRemoteControls.begin(); while (it != mData->mSession.mRemoteControls.end()) { if (control.equalsTo (*it)) break; ++it; } BOOL found = it != mData->mSession.mRemoteControls.end(); ComAssertMsgRet (found, ("The session is not found in the session list!"), E_INVALIDARG); mData->mSession.mRemoteControls.remove (*it); } LogFlowThisFuncLeave(); return S_OK; } /** * @note Locks mParent + this object for writing. */ STDMETHODIMP SessionMachine::BeginSavingState (IProgress *aProgress, BSTR *aStateFilePath) { LogFlowThisFuncEnter(); AssertReturn (aProgress, E_INVALIDARG); AssertReturn (aStateFilePath, E_POINTER); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* mParent->addProgress() needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); AssertReturn (mData->mMachineState == MachineState_Paused && mSnapshotData.mLastState == MachineState_InvalidMachineState && mSnapshotData.mProgressId.isEmpty() && mSnapshotData.mStateFilePath.isNull(), E_FAIL); /* memorize the progress ID and add it to the global collection */ Guid progressId; HRESULT rc = aProgress->COMGETTER(Id) (progressId.asOutParam()); AssertComRCReturn (rc, rc); rc = mParent->addProgress (aProgress); AssertComRCReturn (rc, rc); Bstr stateFilePath; /* stateFilePath is null when the machine is not running */ if (mData->mMachineState == MachineState_Paused) { stateFilePath = Utf8StrFmt ("%ls%c{%Vuuid}.sav", mUserData->mSnapshotFolderFull.raw(), RTPATH_DELIMITER, mData->mUuid.raw()); } /* fill in the snapshot data */ mSnapshotData.mLastState = mData->mMachineState; mSnapshotData.mProgressId = progressId; mSnapshotData.mStateFilePath = stateFilePath; /* set the state to Saving (this is expected by Console::SaveState()) */ setMachineState (MachineState_Saving); stateFilePath.cloneTo (aStateFilePath); return S_OK; } /** * @note Locks mParent + this objects for writing. */ STDMETHODIMP SessionMachine::EndSavingState (BOOL aSuccess) { LogFlowThisFunc (("\n")); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* endSavingState() need mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); AssertReturn (mData->mMachineState == MachineState_Saving && mSnapshotData.mLastState != MachineState_InvalidMachineState && !mSnapshotData.mProgressId.isEmpty() && !mSnapshotData.mStateFilePath.isNull(), E_FAIL); /* * on success, set the state to Saved; * on failure, set the state to the state we had when BeginSavingState() was * called (this is expected by Console::SaveState() and * Console::saveStateThread()) */ if (aSuccess) setMachineState (MachineState_Saved); else setMachineState (mSnapshotData.mLastState); return endSavingState (aSuccess); } /** * @note Locks mParent + this objects for writing. */ STDMETHODIMP SessionMachine::BeginTakingSnapshot ( IConsole *aInitiator, INPTR BSTR aName, INPTR BSTR aDescription, IProgress *aProgress, BSTR *aStateFilePath, IProgress **aServerProgress) { LogFlowThisFuncEnter(); AssertReturn (aInitiator && aName, E_INVALIDARG); AssertReturn (aStateFilePath && aServerProgress, E_POINTER); LogFlowThisFunc (("aName='%ls'\n", aName)); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* Progress::init() needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); AssertReturn ((mData->mMachineState < MachineState_Running || mData->mMachineState == MachineState_Paused) && mSnapshotData.mLastState == MachineState_InvalidMachineState && mSnapshotData.mSnapshot.isNull() && mSnapshotData.mServerProgress.isNull() && mSnapshotData.mCombinedProgress.isNull(), E_FAIL); bool takingSnapshotOnline = mData->mMachineState == MachineState_Paused; if (!takingSnapshotOnline && mData->mMachineState != MachineState_Saved) { /* * save all current settings to ensure current changes are committed * and hard disks are fixed up */ HRESULT rc = saveSettings(); CheckComRCReturnRC (rc); } /* check that there are no Writethrough hard disks attached */ for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hd = (*it)->hardDisk(); AutoLock hdLock (hd); if (hd->type() == HardDiskType_WritethroughHardDisk) return setError (E_FAIL, tr ("Cannot take a snapshot when there is a Writethrough hard " " disk attached ('%ls')"), hd->toString().raw()); } AssertReturn (aProgress || !takingSnapshotOnline, E_FAIL); /* create an ID for the snapshot */ Guid snapshotId; snapshotId.create(); Bstr stateFilePath; /* stateFilePath is null when the machine is not online nor saved */ if (takingSnapshotOnline || mData->mMachineState == MachineState_Saved) stateFilePath = Utf8StrFmt ("%ls%c{%Vuuid}.sav", mUserData->mSnapshotFolderFull.raw(), RTPATH_DELIMITER, snapshotId.ptr()); /* ensure the directory for the saved state file exists */ if (stateFilePath) { Utf8Str dir = stateFilePath; RTPathStripFilename (dir.mutableRaw()); if (!RTDirExists (dir)) { int vrc = RTDirCreateFullPath (dir, 0777); if (VBOX_FAILURE (vrc)) return setError (E_FAIL, tr ("Could not create a directory '%s' to save the " "VM state to (%Vrc)"), dir.raw(), vrc); } } /* create a snapshot machine object */ ComObjPtr snapshotMachine; snapshotMachine.createObject(); HRESULT rc = snapshotMachine->init (this, snapshotId, stateFilePath); AssertComRCReturn (rc, rc); Bstr progressDesc = Bstr (tr ("Taking snapshot of virtual machine")); Bstr firstOpDesc = Bstr (tr ("Preparing to take snapshot")); /* * create a server-side progress object (it will be descriptionless * when we need to combine it with the VM-side progress, i.e. when we're * taking a snapshot online). The number of operations is: * 1 (preparing) + # of VDIs + 1 (if the state is saved so we need to copy it) */ ComObjPtr serverProgress; { ULONG opCount = 1 + mHDData->mHDAttachments.size(); if (mData->mMachineState == MachineState_Saved) opCount ++; serverProgress.createObject(); if (takingSnapshotOnline) rc = serverProgress->init (FALSE, opCount, firstOpDesc); else rc = serverProgress->init (mParent, aInitiator, progressDesc, FALSE, opCount, firstOpDesc); AssertComRCReturn (rc, rc); } /* create a combined server-side progress object when necessary */ ComObjPtr combinedProgress; if (takingSnapshotOnline) { combinedProgress.createObject(); rc = combinedProgress->init (mParent, aInitiator, progressDesc, serverProgress, aProgress); AssertComRCReturn (rc, rc); } /* create a snapshot object */ RTTIMESPEC time; ComObjPtr snapshot; snapshot.createObject(); rc = snapshot->init (snapshotId, aName, aDescription, RTTimeSpecGetMilli (RTTimeNow (&time)), snapshotMachine, mData->mCurrentSnapshot); AssertComRCReturn (rc, rc); /* * create and start the task on a separate thread * (note that it will not start working until we release alock) */ TakeSnapshotTask *task = new TakeSnapshotTask (this); int vrc = RTThreadCreate (NULL, taskHandler, (void *) task, 0, RTTHREADTYPE_MAIN_WORKER, 0, "TakeSnapshot"); if (VBOX_FAILURE (vrc)) { snapshot->uninit(); delete task; ComAssertFailedRet (E_FAIL); } /* fill in the snapshot data */ mSnapshotData.mLastState = mData->mMachineState; mSnapshotData.mSnapshot = snapshot; mSnapshotData.mServerProgress = serverProgress; mSnapshotData.mCombinedProgress = combinedProgress; /* set the state to Saving (this is expected by Console::TakeSnapshot()) */ setMachineState (MachineState_Saving); if (takingSnapshotOnline) stateFilePath.cloneTo (aStateFilePath); else *aStateFilePath = NULL; serverProgress.queryInterfaceTo (aServerProgress); LogFlowThisFuncLeave(); return S_OK; } /** * @note Locks mParent + this objects for writing. */ STDMETHODIMP SessionMachine::EndTakingSnapshot (BOOL aSuccess) { LogFlowThisFunc (("\n")); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* Lock mParent because of endTakingSnapshot() */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); AssertReturn (!aSuccess || (mData->mMachineState == MachineState_Saving && mSnapshotData.mLastState != MachineState_InvalidMachineState && !mSnapshotData.mSnapshot.isNull() && !mSnapshotData.mServerProgress.isNull() && !mSnapshotData.mCombinedProgress.isNull()), E_FAIL); /* * set the state to the state we had when BeginTakingSnapshot() was called * (this is expected by Console::TakeSnapshot() and * Console::saveStateThread()) */ setMachineState (mSnapshotData.mLastState); return endTakingSnapshot (aSuccess); } /** * @note Locks mParent + this + children objects for writing! */ STDMETHODIMP SessionMachine::DiscardSnapshot ( IConsole *aInitiator, INPTR GUIDPARAM aId, MachineState_T *aMachineState, IProgress **aProgress) { LogFlowThisFunc (("\n")); Guid id = aId; AssertReturn (aInitiator && !id.isEmpty(), E_INVALIDARG); AssertReturn (aMachineState && aProgress, E_POINTER); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* Progress::init() needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); ComAssertRet (mData->mMachineState < MachineState_Running, E_FAIL); ComObjPtr snapshot; HRESULT rc = findSnapshot (id, snapshot, true /* aSetError */); CheckComRCReturnRC (rc); AutoLock snapshotLock (snapshot); if (snapshot == mData->mFirstSnapshot) { AutoLock chLock (mData->mFirstSnapshot->childrenLock()); size_t childrenCount = mData->mFirstSnapshot->children().size(); if (childrenCount > 1) return setError (E_FAIL, tr ("Cannot discard the snapshot '%ls' because it is the first " "snapshot of the machine '%ls' and it has more than one " "child snapshot (%d)"), snapshot->data().mName.raw(), mUserData->mName.raw(), childrenCount); } /* * If the snapshot being discarded is the current one, ensure current * settings are committed and saved. */ if (snapshot == mData->mCurrentSnapshot) { if (isModified()) { rc = saveSettings(); CheckComRCReturnRC (rc); } } /* * create a progress object. The number of operations is: * 1 (preparing) + # of VDIs */ ComObjPtr progress; progress.createObject(); rc = progress->init (mParent, aInitiator, Bstr (Utf8StrFmt (tr ("Discarding snapshot '%ls'"), snapshot->data().mName.raw())), FALSE /* aCancelable */, 1 + snapshot->data().mMachine->mHDData->mHDAttachments.size(), Bstr (tr ("Preparing to discard snapshot"))); AssertComRCReturn (rc, rc); /* create and start the task on a separate thread */ DiscardSnapshotTask *task = new DiscardSnapshotTask (this, progress, snapshot); int vrc = RTThreadCreate (NULL, taskHandler, (void *) task, 0, RTTHREADTYPE_MAIN_WORKER, 0, "DiscardSnapshot"); if (VBOX_FAILURE (vrc)) delete task; ComAssertRCRet (vrc, E_FAIL); /* set the proper machine state (note: after creating a Task instance) */ setMachineState (MachineState_Discarding); /* return the progress to the caller */ progress.queryInterfaceTo (aProgress); /* return the new state to the caller */ *aMachineState = mData->mMachineState; return S_OK; } /** * @note Locks mParent + this + children objects for writing! */ STDMETHODIMP SessionMachine::DiscardCurrentState ( IConsole *aInitiator, MachineState_T *aMachineState, IProgress **aProgress) { LogFlowThisFunc (("\n")); AssertReturn (aInitiator, E_INVALIDARG); AssertReturn (aMachineState && aProgress, E_POINTER); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* Progress::init() needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); ComAssertRet (mData->mMachineState < MachineState_Running, E_FAIL); if (mData->mCurrentSnapshot.isNull()) return setError (E_FAIL, tr ("Could not discard the current state of the machine '%ls' " "because it doesn't have any snapshots"), mUserData->mName.raw()); /* * create a progress object. The number of operations is: * 1 (preparing) + # of VDIs + 1 (if we need to copy the saved state file) */ ComObjPtr progress; progress.createObject(); { ULONG opCount = 1 + mData->mCurrentSnapshot->data() .mMachine->mHDData->mHDAttachments.size(); if (mData->mCurrentSnapshot->stateFilePath()) ++ opCount; progress->init (mParent, aInitiator, Bstr (tr ("Discarding current machine state")), FALSE /* aCancelable */, opCount, Bstr (tr ("Preparing to discard current state"))); } /* create and start the task on a separate thread */ DiscardCurrentStateTask *task = new DiscardCurrentStateTask (this, progress, false /* discardCurSnapshot */); int vrc = RTThreadCreate (NULL, taskHandler, (void *) task, 0, RTTHREADTYPE_MAIN_WORKER, 0, "DiscardCurState"); if (VBOX_FAILURE (vrc)) delete task; ComAssertRCRet (vrc, E_FAIL); /* set the proper machine state (note: after creating a Task instance) */ setMachineState (MachineState_Discarding); /* return the progress to the caller */ progress.queryInterfaceTo (aProgress); /* return the new state to the caller */ *aMachineState = mData->mMachineState; return S_OK; } /** * @note Locks mParent + other objects for writing! */ STDMETHODIMP SessionMachine::DiscardCurrentSnapshotAndState ( IConsole *aInitiator, MachineState_T *aMachineState, IProgress **aProgress) { LogFlowThisFunc (("\n")); AssertReturn (aInitiator, E_INVALIDARG); AssertReturn (aMachineState && aProgress, E_POINTER); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* Progress::init() needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); ComAssertRet (mData->mMachineState < MachineState_Running, E_FAIL); if (mData->mCurrentSnapshot.isNull()) return setError (E_FAIL, tr ("Could not discard the current state of the machine '%ls' " "because it doesn't have any snapshots"), mUserData->mName.raw()); /* * create a progress object. The number of operations is: * 1 (preparing) + # of VDIs in the current snapshot + * # of VDIs in the previous snapshot + * 1 (if we need to copy the saved state file of the previous snapshot) * or (if there is no previous snapshot): * 1 (preparing) + # of VDIs in the current snapshot * 2 + * 1 (if we need to copy the saved state file of the current snapshot) */ ComObjPtr progress; progress.createObject(); { ComObjPtr curSnapshot = mData->mCurrentSnapshot; ComObjPtr prevSnapshot = mData->mCurrentSnapshot->parent(); ULONG opCount = 1; if (prevSnapshot) { opCount += curSnapshot->data().mMachine->mHDData->mHDAttachments.size(); opCount += prevSnapshot->data().mMachine->mHDData->mHDAttachments.size(); if (prevSnapshot->stateFilePath()) ++ opCount; } else { opCount += curSnapshot->data().mMachine->mHDData->mHDAttachments.size() * 2; if (curSnapshot->stateFilePath()) ++ opCount; } progress->init (mParent, aInitiator, Bstr (tr ("Discarding current machine snapshot and state")), FALSE /* aCancelable */, opCount, Bstr (tr ("Preparing to discard current snapshot and state"))); } /* create and start the task on a separate thread */ DiscardCurrentStateTask *task = new DiscardCurrentStateTask (this, progress, true /* discardCurSnapshot */); int vrc = RTThreadCreate (NULL, taskHandler, (void *) task, 0, RTTHREADTYPE_MAIN_WORKER, 0, "DiscardCurState"); if (VBOX_FAILURE (vrc)) delete task; ComAssertRCRet (vrc, E_FAIL); /* set the proper machine state (note: after creating a Task instance) */ setMachineState (MachineState_Discarding); /* return the progress to the caller */ progress.queryInterfaceTo (aProgress); /* return the new state to the caller */ *aMachineState = mData->mMachineState; return S_OK; } // public methods only for internal purposes ///////////////////////////////////////////////////////////////////////////// /** * Called from the client watcher thread to check for unexpected client * process death. * * @note On Win32, this method is called only when we've got the semaphore * (i.e. it has been signaled when we were waiting for it). * * On Win32, this method always returns true. * * On Linux, the method returns true if the client process has terminated * abnormally (and/or the session has been uninitialized) and false if it is * still alive. * * @note Locks this object for writing. */ bool SessionMachine::checkForDeath() { Uninit::Reason reason; bool doUninit = false; bool rc = false; /* * Enclose autoCaller with a block because calling uninit() * from under it will deadlock. */ { AutoCaller autoCaller (this); if (!autoCaller.isOk()) { /* * return true if not ready, to cause the client watcher to exclude * the corresponding session from watching */ LogFlowThisFunc (("Already uninitialized!")); return true; } AutoLock alock (this); /* * Determine the reason of death: if the session state is Closing here, * everything is fine. Otherwise it means that the client did not call * OnSessionEnd() before it released the IPC semaphore. * This may happen either because the client process has abnormally * terminated, or because it simply forgot to call ISession::Close() * before exiting. We threat the latter also as an abnormal termination * (see Session::uninit() for details). */ reason = mData->mSession.mState == SessionState_SessionClosing ? Uninit::Normal : Uninit::Abnormal; #if defined(__WIN__) AssertMsg (mIPCSem, ("semaphore must be created")); if (reason == Uninit::Abnormal) { LogWarningThisFunc (("ABNORMAL client termination! (wasRunning=%d)\n", mData->mMachineState >= MachineState_Running)); /* reset the state to Aborted */ if (mData->mMachineState != MachineState_Aborted) setMachineState (MachineState_Aborted); } /* release the IPC mutex */ ::ReleaseMutex (mIPCSem); doUninit = true; rc = true; #elif defined(VBOX_WITH_SYS_V_IPC_SESSION_WATCHER) AssertMsg (mIPCSem >= 0, ("semaphore must be created")); int val = ::semctl (mIPCSem, 0, GETVAL); if (val > 0) { /* the semaphore is signaled, meaning the session is terminated */ if (reason == Uninit::Abnormal) { LogWarningThisFunc (("ABNORMAL client termination! (wasRunning=%d)\n", mData->mMachineState >= MachineState_Running)); /* reset the state to Aborted */ if (mData->mMachineState != MachineState_Aborted) setMachineState (MachineState_Aborted); } doUninit = true; } rc = val > 0; #endif } /* AutoCaller block */ if (doUninit) uninit (reason); return rc; } /** * @note Locks this object for reading. */ HRESULT SessionMachine::onDVDDriveChange() { LogFlowThisFunc (("\n")); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); ComPtr directControl; { AutoReaderLock alock (this); directControl = mData->mSession.mDirectControl; } /* ignore notifications sent after #OnSessionEnd() is called */ if (!directControl) return S_OK; return directControl->OnDVDDriveChange(); } /** * @note Locks this object for reading. */ HRESULT SessionMachine::onFloppyDriveChange() { LogFlowThisFunc (("\n")); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); ComPtr directControl; { AutoReaderLock alock (this); directControl = mData->mSession.mDirectControl; } /* ignore notifications sent after #OnSessionEnd() is called */ if (!directControl) return S_OK; return directControl->OnFloppyDriveChange(); } /** * @note Locks this object for reading. */ HRESULT SessionMachine::onNetworkAdapterChange(INetworkAdapter *networkAdapter) { LogFlowThisFunc (("\n")); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); ComPtr directControl; { AutoReaderLock alock (this); directControl = mData->mSession.mDirectControl; } /* ignore notifications sent after #OnSessionEnd() is called */ if (!directControl) return S_OK; return directControl->OnNetworkAdapterChange(networkAdapter); } /** * @note Locks this object for reading. */ HRESULT SessionMachine::onVRDPServerChange() { LogFlowThisFunc (("\n")); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); ComPtr directControl; { AutoReaderLock alock (this); directControl = mData->mSession.mDirectControl; } /* ignore notifications sent after #OnSessionEnd() is called */ if (!directControl) return S_OK; return directControl->OnVRDPServerChange(); } /** * @note Locks this object for reading. */ HRESULT SessionMachine::onUSBControllerChange() { LogFlowThisFunc (("\n")); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); ComPtr directControl; { AutoReaderLock alock (this); directControl = mData->mSession.mDirectControl; } /* ignore notifications sent after #OnSessionEnd() is called */ if (!directControl) return S_OK; return directControl->OnUSBControllerChange(); } /** * @note Locks this object for reading. */ HRESULT SessionMachine::onUSBDeviceAttach (IUSBDevice *aDevice) { LogFlowThisFunc (("\n")); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); ComPtr directControl; { AutoReaderLock alock (this); directControl = mData->mSession.mDirectControl; } /* ignore notifications sent after #OnSessionEnd() is called */ if (!directControl) return S_OK; return directControl->OnUSBDeviceAttach (aDevice); } /** * @note Locks this object for reading. */ HRESULT SessionMachine::onUSBDeviceDetach (INPTR GUIDPARAM aId) { LogFlowThisFunc (("\n")); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); ComPtr directControl; { AutoReaderLock alock (this); directControl = mData->mSession.mDirectControl; } /* ignore notifications sent after #OnSessionEnd() is called */ if (!directControl) return S_OK; return directControl->OnUSBDeviceDetach (aId); } // protected methods ///////////////////////////////////////////////////////////////////////////// /** * Helper method to finalize saving the state. * * @note Must be called from under this object's lock. * * @param aSuccess TRUE if the snapshot has been taken successfully * * @note Locks mParent + this objects for writing. */ HRESULT SessionMachine::endSavingState (BOOL aSuccess) { LogFlowThisFuncEnter(); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* mParent->removeProgress() needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); HRESULT rc = S_OK; if (aSuccess) { mSSData->mStateFilePath = mSnapshotData.mStateFilePath; /* save all VM settings */ rc = saveSettings(); } else { /* delete the saved state file (it might have been already created) */ RTFileDelete (Utf8Str (mSnapshotData.mStateFilePath)); } /* remove the completed progress object */ mParent->removeProgress (mSnapshotData.mProgressId); /* clear out the temporary saved state data */ mSnapshotData.mLastState = MachineState_InvalidMachineState; mSnapshotData.mProgressId.clear(); mSnapshotData.mStateFilePath.setNull(); LogFlowThisFuncLeave(); return rc; } /** * Helper method to finalize taking a snapshot. * Gets called only from #EndTakingSnapshot() that is expected to * be called by the VM process when it finishes *all* the tasks related to * taking a snapshot, either scucessfully or unsuccessfilly. * * @param aSuccess TRUE if the snapshot has been taken successfully * * @note Locks mParent + this objects for writing. */ HRESULT SessionMachine::endTakingSnapshot (BOOL aSuccess) { LogFlowThisFuncEnter(); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); /* Progress object uninitialization needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); HRESULT rc = S_OK; if (aSuccess) { /* the server progress must be completed on success */ Assert (mSnapshotData.mServerProgress->completed()); mData->mCurrentSnapshot = mSnapshotData.mSnapshot; /* memorize the first snapshot if necessary */ if (!mData->mFirstSnapshot) mData->mFirstSnapshot = mData->mCurrentSnapshot; int opFlags = SaveSS_AddOp | SaveSS_UpdateCurrentId; if (mSnapshotData.mLastState != MachineState_Paused && !isModified()) { /* * the machine was powered off or saved when taking a snapshot, * so reset the mCurrentStateModified flag */ mData->mCurrentStateModified = FALSE; opFlags |= SaveSS_UpdateCurStateModified; } rc = saveSnapshotSettings (mSnapshotData.mSnapshot, opFlags); } if (!aSuccess || FAILED (rc)) { if (mSnapshotData.mSnapshot) { /* wait for the completion of the server progress (diff VDI creation) */ /// @todo (dmik) later, we will definitely want to cancel it instead // (when the cancel function is implemented) mSnapshotData.mServerProgress->WaitForCompletion (-1); /* * delete all differencing VDIs created * (this will attach their parents back) */ rc = deleteSnapshotDiffs (mSnapshotData.mSnapshot); /* continue cleanup on error */ /* delete the saved state file (it might have been already created) */ if (mSnapshotData.mSnapshot->stateFilePath()) RTFileDelete (Utf8Str (mSnapshotData.mSnapshot->stateFilePath())); mSnapshotData.mSnapshot->uninit(); } } /* inform callbacks */ if (aSuccess && SUCCEEDED (rc)) mParent->onSnapshotTaken (mData->mUuid, mSnapshotData.mSnapshot->data().mId); /* clear out the snapshot data */ mSnapshotData.mLastState = MachineState_InvalidMachineState; mSnapshotData.mSnapshot.setNull(); mSnapshotData.mServerProgress.setNull(); /* uninitialize the combined progress (to remove it from the VBox collection) */ if (!mSnapshotData.mCombinedProgress.isNull()) { mSnapshotData.mCombinedProgress->uninit(); mSnapshotData.mCombinedProgress.setNull(); } LogFlowThisFuncLeave(); return rc; } /** * Take snapshot task handler. * Must be called only by TakeSnapshotTask::handler()! * * The sole purpose of this task is to asynchronously create differencing VDIs * and copy the saved state file (when necessary). The VM process will wait * for this task to complete using the mSnapshotData.mServerProgress * returned to it. * * @note Locks mParent + this objects for writing. */ void SessionMachine::takeSnapshotHandler (TakeSnapshotTask &aTask) { LogFlowThisFuncEnter(); AutoCaller autoCaller (this); LogFlowThisFunc (("state=%d\n", autoCaller.state())); if (!autoCaller.isOk()) { /* * we might have been uninitialized because the session was * accidentally closed by the client, so don't assert */ LogFlowThisFuncLeave(); return; } /* endTakingSnapshot() needs mParent lock */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); HRESULT rc = S_OK; LogFlowThisFunc (("Creating differencing VDIs...\n")); /* create new differencing hard disks and attach them to this machine */ rc = createSnapshotDiffs (&mSnapshotData.mSnapshot->data().mId, mUserData->mSnapshotFolderFull, mSnapshotData.mServerProgress, true /* aOnline */); if (SUCCEEDED (rc) && mSnapshotData.mLastState == MachineState_Saved) { Utf8Str stateFrom = mSSData->mStateFilePath; Utf8Str stateTo = mSnapshotData.mSnapshot->stateFilePath(); LogFlowThisFunc (("Copying the execution state from '%s' to '%s'...\n", stateFrom.raw(), stateTo.raw())); mSnapshotData.mServerProgress->advanceOperation ( Bstr (tr ("Copying the execution state"))); /* * We can safely leave the lock here: * mMachineState is MachineState_Saving here */ alock.leave(); /* copy the state file */ int vrc = RTFileCopyEx (stateFrom, stateTo, progressCallback, static_cast (mSnapshotData.mServerProgress)); alock.enter(); if (VBOX_FAILURE (vrc)) rc = setError (E_FAIL, tr ("Could not copy the state file '%ls' to '%ls' (%Vrc)"), stateFrom.raw(), stateTo.raw()); } /* * we have to call endTakingSnapshot() here if the snapshot was taken * offline, because the VM process will not do it in this case */ if (mSnapshotData.mLastState != MachineState_Paused) { LogFlowThisFunc (("Finalizing the taken snapshot (rc=%08X)...\n", rc)); setMachineState (mSnapshotData.mLastState); updateMachineStateOnClient(); /* finalize the progress after setting the state, for consistency */ mSnapshotData.mServerProgress->notifyComplete (rc); endTakingSnapshot (SUCCEEDED (rc)); } else { mSnapshotData.mServerProgress->notifyComplete (rc); } LogFlowThisFuncLeave(); } /** * Discard snapshot task handler. * Must be called only by DiscardSnapshotTask::handler()! * * When aTask.subTask is true, the associated progress object is left * uncompleted on success. On failure, the progress is marked as completed * regardless of this parameter. * * @note Locks mParent + this + child objects for writing! */ void SessionMachine::discardSnapshotHandler (DiscardSnapshotTask &aTask) { LogFlowThisFuncEnter(); AutoCaller autoCaller (this); LogFlowThisFunc (("state=%d\n", autoCaller.state())); if (!autoCaller.isOk()) { /* * we might have been uninitialized because the session was * accidentally closed by the client, so don't assert */ aTask.progress->notifyComplete ( E_FAIL, COM_IIDOF (IMachine), getComponentName(), tr ("The session has been accidentally closed")); LogFlowThisFuncLeave(); return; } ComObjPtr sm = aTask.snapshot->data().mMachine; /* mParent is locked because of Progress::notifyComplete(), etc. */ AutoMultiLock <3> alock (mParent->wlock(), this->wlock(), sm->rlock()); /* Safe locking in the direction parent->child */ AutoLock snapshotLock (aTask.snapshot); AutoLock snapshotChildrenLock (aTask.snapshot->childrenLock()); HRESULT rc = S_OK; /* save the snapshot ID (for callbacks) */ Guid snapshotId = aTask.snapshot->data().mId; do { /* first pass: */ LogFlowThisFunc (("Check hard disk accessibility and affected machines...\n")); HDData::HDAttachmentList::const_iterator it; for (it = sm->mHDData->mHDAttachments.begin(); it != sm->mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; ComObjPtr hd = hda->hardDisk(); ComObjPtr parent = hd->parent(); AutoLock hdLock (hd); if (hd->hasForeignChildren()) { rc = setError (E_FAIL, tr ("One or more hard disks belonging to other machines are " "based on the hard disk '%ls' stored in the snapshot '%ls'"), hd->toString().raw(), aTask.snapshot->data().mName.raw()); break; } if (hd->type() == HardDiskType_NormalHardDisk) { AutoLock hdChildrenLock (hd->childrenLock()); size_t childrenCount = hd->children().size(); if (childrenCount > 1) { rc = setError (E_FAIL, tr ("Normal hard disk '%ls' stored in the snapshot '%ls' " "has more than one child hard disk (%d)"), hd->toString().raw(), aTask.snapshot->data().mName.raw(), childrenCount); break; } } else { ComAssertMsgFailedBreak (("Invalid hard disk type %d\n", hd->type()), rc = E_FAIL); } Bstr accessError; rc = hd->getAccessibleWithChildren (accessError); CheckComRCBreakRC (rc); if (!accessError.isNull()) { rc = setError (E_FAIL, tr ("Hard disk '%ls' stored in the snapshot '%ls' is not " "accessible (%ls)"), hd->toString().raw(), aTask.snapshot->data().mName.raw(), accessError.raw()); break; } rc = hd->setBusyWithChildren(); if (FAILED (rc)) { /* reset the busy flag of all previous hard disks */ while (it != sm->mHDData->mHDAttachments.begin()) (*(-- it))->hardDisk()->clearBusyWithChildren(); break; } } CheckComRCBreakRC (rc); /* second pass: */ LogFlowThisFunc (("Performing actual vdi merging...\n")); for (it = sm->mHDData->mHDAttachments.begin(); it != sm->mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hda = *it; ComObjPtr hd = hda->hardDisk(); ComObjPtr parent = hd->parent(); AutoLock hdLock (hd); Bstr hdRootString = hd->root()->toString (true /* aShort */); if (parent) { if (hd->isParentImmutable()) { aTask.progress->advanceOperation (Bstr (Utf8StrFmt ( tr ("Discarding changes to immutable hard disk '%ls'"), hdRootString.raw()))); /* clear the busy flag before unregistering */ hd->clearBusy(); /* * unregisterDiffHardDisk() is supposed to delete and uninit * the differencing hard disk */ rc = mParent->unregisterDiffHardDisk (hd); CheckComRCBreakRC (rc); continue; } else { /* * differencing VDI: * merge this image to all its children */ aTask.progress->advanceOperation (Bstr (Utf8StrFmt ( tr ("Merging changes to normal hard disk '%ls' to children"), hdRootString.raw()))); snapshotChildrenLock.unlock(); snapshotLock.unlock(); alock.leave(); rc = hd->asVDI()->mergeImageToChildren (aTask.progress); alock.enter(); snapshotLock.lock(); snapshotChildrenLock.lock(); // debug code // if (it != sm->mHDData->mHDAttachments.begin()) // { // rc = setError (E_FAIL, "Simulated failure"); // break; //} if (SUCCEEDED (rc)) rc = mParent->unregisterDiffHardDisk (hd); else hd->clearBusyWithChildren(); CheckComRCBreakRC (rc); } } else if (hd->type() == HardDiskType_NormalHardDisk) { /* * normal vdi has the only child or none * (checked in the first pass) */ ComObjPtr child; { AutoLock hdChildrenLock (hd->childrenLock()); if (hd->children().size()) child = hd->children().front(); } if (child.isNull()) { aTask.progress->advanceOperation (Bstr (Utf8StrFmt ( tr ("Detaching normal hard disk '%ls'"), hdRootString.raw()))); /* just deassociate the normal image from this machine */ hd->setMachineId (Guid()); hd->setSnapshotId (Guid()); /* clear the busy flag */ hd->clearBusy(); } else { AutoLock childLock (child); aTask.progress->advanceOperation (Bstr (Utf8StrFmt ( tr ("Preserving changes to normal hard disk '%ls'"), hdRootString.raw()))); ComObjPtr cm; ComObjPtr cs; ComObjPtr childHda; rc = findHardDiskAttachment (child, &cm, &cs, &childHda); CheckComRCBreakRC (rc); /* must be the same machine (checked in the first pass) */ ComAssertBreak (cm->mData->mUuid == mData->mUuid, rc = E_FAIL); /* merge the child to this basic image */ snapshotChildrenLock.unlock(); snapshotLock.unlock(); alock.leave(); rc = child->asVDI()->mergeImageToParent (aTask.progress); alock.enter(); snapshotLock.lock(); snapshotChildrenLock.lock(); if (SUCCEEDED (rc)) rc = mParent->unregisterDiffHardDisk (child); else hd->clearBusyWithChildren(); CheckComRCBreakRC (rc); /* replace the child image in the appropriate place */ childHda->updateHardDisk (hd, FALSE /* aDirty */); if (!cs) { aTask.settingsChanged = true; } else { rc = cm->saveSnapshotSettings (cs, SaveSS_UpdateAllOp); CheckComRCBreakRC (rc); } } } else { ComAssertMsgFailedBreak (("Invalid hard disk type %d\n", hd->type()), rc = E_FAIL); } } /* fetch the current error info */ ErrorInfo mergeEi; HRESULT mergeRc = rc; if (FAILED (rc)) { /* clear the busy flag on the rest of hard disks */ for (++ it; it != sm->mHDData->mHDAttachments.end(); ++ it) (*it)->hardDisk()->clearBusyWithChildren(); } /* * we have to try to discard the snapshot even if merging failed * because some images might have been already merged (and deleted) */ do { LogFlowThisFunc (("Discarding the snapshot (reparenting children)...\n")); ComObjPtr parentSnapshot = aTask.snapshot->parent(); /// @todo (dmik): // when we introduce clones later, discarding the snapshot // will affect the current and first snapshots of clones, if they are // direct children of this snapshot. So we will need to lock machines // associated with child snapshots as well and update mCurrentSnapshot // and/or mFirstSnapshot fields. if (aTask.snapshot == mData->mCurrentSnapshot) { /* currently, the parent snapshot must refer to the same machine */ ComAssertBreak ( !parentSnapshot || parentSnapshot->data().mMachine->mData->mUuid == mData->mUuid, rc = E_FAIL); mData->mCurrentSnapshot = parentSnapshot; /* mark the current state as modified */ mData->mCurrentStateModified = TRUE; } if (aTask.snapshot == mData->mFirstSnapshot) { /* * the first snapshot must have only one child when discarded, * or no children at all */ ComAssertBreak (aTask.snapshot->children().size() <= 1, rc = E_FAIL); if (aTask.snapshot->children().size() == 1) { ComObjPtr childSnapshot = aTask.snapshot->children().front(); ComAssertBreak ( childSnapshot->data().mMachine->mData->mUuid == mData->mUuid, rc = E_FAIL); mData->mFirstSnapshot = childSnapshot; } else mData->mFirstSnapshot.setNull(); } /// @todo (dmik) // if we implement some warning mechanism later, we'll have // to return a warning if the state file path cannot be deleted Bstr stateFilePath = aTask.snapshot->stateFilePath(); if (stateFilePath) RTFileDelete (Utf8Str (stateFilePath)); aTask.snapshot->discard(); rc = saveSnapshotSettings (parentSnapshot, SaveSS_UpdateAllOp | SaveSS_UpdateCurrentId); } while (0); /* restore the merge error if any */ if (FAILED (mergeRc)) { rc = mergeRc; setError (mergeEi); } } while (0); if (!aTask.subTask || FAILED (rc)) { if (!aTask.subTask) { /* save current error info */ ErrorInfo ei; /* restore the machine state */ setMachineState (aTask.state); updateMachineStateOnClient(); /* * save settings anyway, since we've already changed the current * machine configuration */ if (aTask.settingsChanged) { saveSettings (true /* aMarkCurStateAsModified */, true /* aInformCallbacksAnyway */); } /* restore current error info */ setError (ei); } /* set the result (this will try to fetch current error info on failure) */ aTask.progress->notifyComplete (rc); } if (SUCCEEDED (rc)) mParent->onSnapshotDiscarded (mData->mUuid, snapshotId); LogFlowThisFunc (("Done discarding snapshot (rc=%08X)\n", rc)); LogFlowThisFuncLeave(); } /** * Discard current state task handler. * Must be called only by DiscardCurrentStateTask::handler()! * * @note Locks mParent + this object for writing. */ void SessionMachine::discardCurrentStateHandler (DiscardCurrentStateTask &aTask) { LogFlowThisFuncEnter(); AutoCaller autoCaller (this); LogFlowThisFunc (("state=%d\n", autoCaller.state())); if (!autoCaller.isOk()) { /* * we might have been uninitialized because the session was * accidentally closed by the client, so don't assert */ aTask.progress->notifyComplete ( E_FAIL, COM_IIDOF (IMachine), getComponentName(), tr ("The session has been accidentally closed")); LogFlowThisFuncLeave(); return; } /* mParent is locked because of Progress::notifyComplete(), etc. */ AutoMultiLock <2> alock (mParent->wlock(), this->wlock()); /* * discard all current changes to mUserData (name, OSType etc.) * (note that the machine is powered off, so there is no need * to inform the direct session) */ if (isModified()) rollback (false /* aNotify */); HRESULT rc = S_OK; bool errorInSubtask = false; bool stateRestored = false; const bool isLastSnapshot = mData->mCurrentSnapshot->parent().isNull(); do { /* * discard the saved state file if the machine was Saved prior * to this operation */ if (aTask.state == MachineState_Saved) { Assert (!mSSData->mStateFilePath.isEmpty()); RTFileDelete (Utf8Str (mSSData->mStateFilePath)); mSSData->mStateFilePath.setNull(); aTask.modifyLastState (MachineState_PoweredOff); rc = saveStateSettings (SaveSTS_StateFilePath); CheckComRCBreakRC (rc); } if (aTask.discardCurrentSnapshot && !isLastSnapshot) { /* * the "discard current snapshot and state" task is in action, * the current snapshot is not the last one. * Discard the current snapshot first. */ DiscardSnapshotTask subTask (aTask, mData->mCurrentSnapshot); subTask.subTask = true; discardSnapshotHandler (subTask); aTask.settingsChanged = subTask.settingsChanged; if (aTask.progress->completed()) { /* * the progress can be completed by a subtask only if there was * a failure */ Assert (FAILED (aTask.progress->resultCode())); errorInSubtask = true; rc = aTask.progress->resultCode(); break; } } LONG64 snapshotTimeStamp = 0; { ComObjPtr curSnapshot = mData->mCurrentSnapshot; AutoLock snapshotLock (curSnapshot); /* remember the timestamp of the snapshot we're restoring from */ snapshotTimeStamp = curSnapshot->data().mTimeStamp; /* copy all hardware data from the current snapshot */ copyFrom (curSnapshot->data().mMachine); LogFlowThisFunc (("Restoring VDIs from the snapshot...\n")); /* restore the attachmends from the snapshot */ mHDData.backup(); mHDData->mHDAttachments = curSnapshot->data().mMachine->mHDData->mHDAttachments; snapshotLock.unlock(); alock.leave(); rc = createSnapshotDiffs (NULL, mUserData->mSnapshotFolderFull, aTask.progress, false /* aOnline */); alock.enter(); snapshotLock.lock(); if (FAILED (rc)) { /* here we can still safely rollback, so do it */ ErrorInfo ei; /* undo all changes */ rollback (false /* aNotify */); setError (ei); break; } /* * note: old VDIs will be deassociated/deleted on #commit() called * either from #saveSettings() or directly at the end */ /* should not have a saved state file associated at this point */ Assert (mSSData->mStateFilePath.isNull()); if (curSnapshot->stateFilePath()) { Utf8Str snapStateFilePath = curSnapshot->stateFilePath(); Utf8Str stateFilePath = Utf8StrFmt ("%ls%c{%Vuuid}.sav", mUserData->mSnapshotFolderFull.raw(), RTPATH_DELIMITER, mData->mUuid.raw()); LogFlowThisFunc (("Copying saved state file from '%s' to '%s'...\n", snapStateFilePath.raw(), stateFilePath.raw())); aTask.progress->advanceOperation ( Bstr (tr ("Restoring the execution state"))); /* copy the state file */ snapshotLock.unlock(); alock.leave(); int vrc = RTFileCopyEx (snapStateFilePath, stateFilePath, progressCallback, aTask.progress); alock.enter(); snapshotLock.lock(); if (VBOX_SUCCESS (vrc)) { mSSData->mStateFilePath = stateFilePath; } else { rc = setError (E_FAIL, tr ("Could not copy the state file '%s' to '%s' (%Vrc)"), snapStateFilePath.raw(), stateFilePath.raw(), vrc); break; } } } bool informCallbacks = false; if (aTask.discardCurrentSnapshot && isLastSnapshot) { /* * discard the current snapshot and state task is in action, * the current snapshot is the last one. * Discard the current snapshot after discarding the current state. */ /* commit changes to fixup hard disks before discarding */ rc = commit(); if (SUCCEEDED (rc)) { DiscardSnapshotTask subTask (aTask, mData->mCurrentSnapshot); subTask.subTask = true; discardSnapshotHandler (subTask); aTask.settingsChanged = subTask.settingsChanged; if (aTask.progress->completed()) { /* * the progress can be completed by a subtask only if there * was a failure */ Assert (FAILED (aTask.progress->resultCode())); errorInSubtask = true; rc = aTask.progress->resultCode(); } } /* * we've committed already, so inform callbacks anyway to ensure * they don't miss some change */ informCallbacks = true; } /* * we have already discarded the current state, so set the * execution state accordingly no matter of the discard snapshot result */ if (mSSData->mStateFilePath) setMachineState (MachineState_Saved); else setMachineState (MachineState_PoweredOff); updateMachineStateOnClient(); stateRestored = true; if (errorInSubtask) break; /* assign the timestamp from the snapshot */ Assert (snapshotTimeStamp != 0); mData->mLastStateChange = snapshotTimeStamp; /* mark the current state as not modified */ mData->mCurrentStateModified = FALSE; /* save all settings and commit */ rc = saveSettings (false /* aMarkCurStateAsModified */, informCallbacks); aTask.settingsChanged = false; } while (0); if (FAILED (rc)) { ErrorInfo ei; if (!stateRestored) { /* restore the machine state */ setMachineState (aTask.state); updateMachineStateOnClient(); } /* * save all settings and commit if still modified (there is no way to * rollback properly). Note that isModified() will return true after * copyFrom(). Also save the settings if requested by the subtask. */ if (isModified() || aTask.settingsChanged) { if (aTask.settingsChanged) saveSettings (true /* aMarkCurStateAsModified */, true /* aInformCallbacksAnyway */); else saveSettings(); } setError (ei); } if (!errorInSubtask) { /* set the result (this will try to fetch current error info on failure) */ aTask.progress->notifyComplete (rc); } if (SUCCEEDED (rc)) mParent->onSnapshotDiscarded (mData->mUuid, Guid()); LogFlowThisFunc (("Done discarding current state (rc=%08X)\n", rc)); LogFlowThisFuncLeave(); } /** * Helper to change the machine state (reimplementation). * * @note Locks this object for writing. */ HRESULT SessionMachine::setMachineState (MachineState_T aMachineState) { LogFlowThisFuncEnter(); LogFlowThisFunc (("aMachineState=%d\n", aMachineState)); AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); AutoLock alock (this); MachineState_T oldMachineState = mData->mMachineState; AssertMsgReturn (oldMachineState != aMachineState, ("oldMachineState=%d, aMachineState=%d\n", oldMachineState, aMachineState), E_FAIL); HRESULT rc = S_OK; int stsFlags = 0; bool deleteSavedState = false; /* detect some state transitions */ if (oldMachineState < MachineState_Running && aMachineState >= MachineState_Running && aMachineState != MachineState_Discarding) { /* * the EMT thread is about to start, so mark attached HDDs as busy * and all its ancestors as being in use */ for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hd = (*it)->hardDisk(); AutoLock hdLock (hd); hd->setBusy(); hd->addReaderOnAncestors(); } } else if (oldMachineState >= MachineState_Running && oldMachineState != MachineState_Discarding && aMachineState < MachineState_Running) { /* * the EMT thread stopped, so mark attached HDDs as no more busy * and remove the in-use flag from all its ancestors */ for (HDData::HDAttachmentList::const_iterator it = mHDData->mHDAttachments.begin(); it != mHDData->mHDAttachments.end(); ++ it) { ComObjPtr hd = (*it)->hardDisk(); AutoLock hdLock (hd); hd->releaseReaderOnAncestors(); hd->clearBusy(); } } if (oldMachineState == MachineState_Restoring) { if (aMachineState != MachineState_Saved) { /* * delete the saved state file once the machine has finished * restoring from it (note that Console sets the state from * Restoring to Saved if the VM couldn't restore successfully, * to give the user an ability to fix an error and retry -- * we keep the saved state file in this case) */ deleteSavedState = true; } } else if (oldMachineState == MachineState_Saved && (aMachineState == MachineState_PoweredOff || aMachineState == MachineState_Aborted)) { /* * delete the saved state after Console::DiscardSavedState() is called * or if the VM process (owning a direct VM session) crashed while the * VM was Saved */ /// @todo (dmik) // Not sure that deleting the saved state file just because of the // client death before it attempted to restore the VM is a good // thing. But when it crashes we need to go to the Aborted state // which cannot have the saved state file associated... The only // way to fix this is to make the Aborted condition not a VM state // but a bool flag: i.e., when a crash occurs, set it to true and // change the state to PoweredOff or Saved depending on the // saved state presence. deleteSavedState = true; mData->mCurrentStateModified = TRUE; stsFlags |= SaveSTS_CurStateModified; } if (aMachineState == MachineState_Starting || aMachineState == MachineState_Restoring) { /* * set the current state modified flag to indicate that the * current state is no more identical to the state in the * current snapshot */ if (!mData->mCurrentSnapshot.isNull()) { mData->mCurrentStateModified = TRUE; stsFlags |= SaveSTS_CurStateModified; } } if (deleteSavedState == true) { Assert (!mSSData->mStateFilePath.isEmpty()); RTFileDelete (Utf8Str (mSSData->mStateFilePath)); mSSData->mStateFilePath.setNull(); stsFlags |= SaveSTS_StateFilePath; } /* redirect to the underlying peer machine */ mPeer->setMachineState (aMachineState); if (aMachineState == MachineState_PoweredOff || aMachineState == MachineState_Aborted || aMachineState == MachineState_Saved) { stsFlags |= SaveSTS_StateTimeStamp; } rc = saveStateSettings (stsFlags); if ((oldMachineState != MachineState_PoweredOff && oldMachineState != MachineState_Aborted) && (aMachineState == MachineState_PoweredOff || aMachineState == MachineState_Aborted)) { /* * clear differencing hard disks based on immutable hard disks * once we've been shut down for any reason */ rc = wipeOutImmutableDiffs(); } LogFlowThisFunc (("rc=%08X\n", rc)); LogFlowThisFuncLeave(); return rc; } /** * Sends the current machine state value to the VM process. * * @note Locks this object for reading, then calls a client process. */ HRESULT SessionMachine::updateMachineStateOnClient() { AutoCaller autoCaller (this); AssertComRCReturn (autoCaller.rc(), autoCaller.rc()); ComPtr directControl; { AutoReaderLock alock (this); AssertReturn (!!mData, E_FAIL); directControl = mData->mSession.mDirectControl; /* directControl may be already set to NULL here in #OnSessionEnd() * called too early by the direct session process while there is still * some operation (like discarding the snapshot) in progress. The client * process in this case is waiting inside Session::close() for the * "end session" process object to complete, while #uninit() called by * #checkForDeath() on the Watcher thread is waiting for the pending * operation to complete. For now, we accept this inconsitent behavior * and simply do nothing here. */ if (mData->mSession.mState == SessionState_SessionClosing) return S_OK; AssertReturn (!directControl.isNull(), E_FAIL); } return directControl->UpdateMachineState (mData->mMachineState); } /* static */ DECLCALLBACK(int) SessionMachine::taskHandler (RTTHREAD thread, void *pvUser) { AssertReturn (pvUser, VERR_INVALID_POINTER); Task *task = static_cast (pvUser); task->handler(); // it's our responsibility to delete the task delete task; return 0; } ///////////////////////////////////////////////////////////////////////////// // SnapshotMachine class ///////////////////////////////////////////////////////////////////////////// DEFINE_EMPTY_CTOR_DTOR (SnapshotMachine) HRESULT SnapshotMachine::FinalConstruct() { LogFlowThisFunc (("\n")); /* set the proper type to indicate we're the SnapshotMachine instance */ unconst (mType) = IsSnapshotMachine; return S_OK; } void SnapshotMachine::FinalRelease() { LogFlowThisFunc (("\n")); uninit(); } /** * Initializes the SnapshotMachine object when taking a snapshot. * * @param aSessionMachine machine to take a snapshot from * @param aSnapshotId snapshot ID of this snapshot machine * @param aStateFilePath file where the execution state will be later saved * (or NULL for the offline snapshot) * * @note Locks aSessionMachine object for reading. */ HRESULT SnapshotMachine::init (SessionMachine *aSessionMachine, INPTR GUIDPARAM aSnapshotId, INPTR BSTR aStateFilePath) { LogFlowThisFuncEnter(); LogFlowThisFunc (("mName={%ls}\n", aSessionMachine->mUserData->mName.raw())); AssertReturn (aSessionMachine && !Guid (aSnapshotId).isEmpty(), E_INVALIDARG); /* Enclose the state transition NotReady->InInit->Ready */ AutoInitSpan autoInitSpan (this); AssertReturn (autoInitSpan.isOk(), E_UNEXPECTED); mSnapshotId = aSnapshotId; AutoReaderLock alock (aSessionMachine); /* memorize the primary Machine instance (i.e. not SessionMachine!) */ unconst (mPeer) = aSessionMachine->mPeer; /* share the parent pointer */ unconst (mParent) = mPeer->mParent; /* take the pointer to Data to share */ mData.share (mPeer->mData); /* * take the pointer to UserData to share * (our UserData must always be the same as Machine's data) */ mUserData.share (mPeer->mUserData); /* make a private copy of all other data (recent changes from SessionMachine) */ mHWData.attachCopy (aSessionMachine->mHWData); mHDData.attachCopy (aSessionMachine->mHDData); /* SSData is always unique for SnapshotMachine */ mSSData.allocate(); mSSData->mStateFilePath = aStateFilePath; /* * create copies of all shared folders (mHWData after attiching a copy * contains just references to original objects) */ for (HWData::SharedFolderList::iterator it = mHWData->mSharedFolders.begin(); it != mHWData->mSharedFolders.end(); ++ it) { ComObjPtr folder; folder.createObject(); HRESULT rc = folder->initCopy (this, *it); CheckComRCReturnRC (rc); *it = folder; } /* create all other child objects that will be immutable private copies */ unconst (mBIOSSettings).createObject(); mBIOSSettings->initCopy (this, mPeer->mBIOSSettings); #ifdef VBOX_VRDP unconst (mVRDPServer).createObject(); mVRDPServer->initCopy (this, mPeer->mVRDPServer); #endif unconst (mDVDDrive).createObject(); mDVDDrive->initCopy (this, mPeer->mDVDDrive); unconst (mFloppyDrive).createObject(); mFloppyDrive->initCopy (this, mPeer->mFloppyDrive); unconst (mAudioAdapter).createObject(); mAudioAdapter->initCopy (this, mPeer->mAudioAdapter); unconst (mUSBController).createObject(); mUSBController->initCopy (this, mPeer->mUSBController); for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) { unconst (mNetworkAdapters [slot]).createObject(); mNetworkAdapters [slot]->initCopy (this, mPeer->mNetworkAdapters [slot]); } /* Confirm a successful initialization when it's the case */ autoInitSpan.setSucceeded(); LogFlowThisFuncLeave(); return S_OK; } /** * Initializes the SnapshotMachine object when loading from the settings file. * * @param aMachine machine the snapshot belngs to * @param aHWNode node * @param aHDAsNode node * @param aSnapshotId snapshot ID of this snapshot machine * @param aStateFilePath file where the execution state is saved * (or NULL for the offline snapshot) * * @note Locks aMachine object for reading. */ HRESULT SnapshotMachine::init (Machine *aMachine, CFGNODE aHWNode, CFGNODE aHDAsNode, INPTR GUIDPARAM aSnapshotId, INPTR BSTR aStateFilePath) { LogFlowThisFuncEnter(); LogFlowThisFunc (("mName={%ls}\n", aMachine->mUserData->mName.raw())); AssertReturn (aMachine && aHWNode && aHDAsNode && !Guid (aSnapshotId).isEmpty(), E_INVALIDARG); /* Enclose the state transition NotReady->InInit->Ready */ AutoInitSpan autoInitSpan (this); AssertReturn (autoInitSpan.isOk(), E_UNEXPECTED); mSnapshotId = aSnapshotId; AutoReaderLock alock (aMachine); /* memorize the primary Machine instance */ unconst (mPeer) = aMachine; /* share the parent pointer */ unconst (mParent) = mPeer->mParent; /* take the pointer to Data to share */ mData.share (mPeer->mData); /* * take the pointer to UserData to share * (our UserData must always be the same as Machine's data) */ mUserData.share (mPeer->mUserData); /* allocate private copies of all other data (will be loaded from settings) */ mHWData.allocate(); mHDData.allocate(); /* SSData is always unique for SnapshotMachine */ mSSData.allocate(); mSSData->mStateFilePath = aStateFilePath; /* create all other child objects that will be immutable private copies */ unconst (mBIOSSettings).createObject(); mBIOSSettings->init (this); #ifdef VBOX_VRDP unconst (mVRDPServer).createObject(); mVRDPServer->init (this); #endif unconst (mDVDDrive).createObject(); mDVDDrive->init (this); unconst (mFloppyDrive).createObject(); mFloppyDrive->init (this); unconst (mAudioAdapter).createObject(); mAudioAdapter->init (this); unconst (mUSBController).createObject(); mUSBController->init (this); for (ULONG slot = 0; slot < ELEMENTS (mNetworkAdapters); slot ++) { unconst (mNetworkAdapters [slot]).createObject(); mNetworkAdapters [slot]->init (this, slot); } /* load hardware and harddisk settings */ HRESULT rc = loadHardware (aHWNode); if (SUCCEEDED (rc)) rc = loadHardDisks (aHDAsNode, true /* aRegistered */, &mSnapshotId); if (SUCCEEDED (rc)) { /* commit all changes made during the initialization */ commit(); } /* Confirm a successful initialization when it's the case */ if (SUCCEEDED (rc)) autoInitSpan.setSucceeded(); LogFlowThisFuncLeave(); return rc; } /** * Uninitializes this SnapshotMachine object. */ void SnapshotMachine::uninit() { LogFlowThisFuncEnter(); /* Enclose the state transition Ready->InUninit->NotReady */ AutoUninitSpan autoUninitSpan (this); if (autoUninitSpan.uninitDone()) return; uninitDataAndChildObjects(); unconst (mParent).setNull(); unconst (mPeer).setNull(); LogFlowThisFuncLeave(); } // AutoLock::Lockable interface //////////////////////////////////////////////////////////////////////////////// /** * Overrides VirtualBoxBase::lockHandle() in order to share the lock handle * with the primary Machine instance (mPeer). */ AutoLock::Handle *SnapshotMachine::lockHandle() const { AssertReturn (!mPeer.isNull(), NULL); return mPeer->lockHandle(); } // public methods only for internal purposes //////////////////////////////////////////////////////////////////////////////// /** * Called by the snapshot object associated with this SnapshotMachine when * snapshot data such as name or description is changed. * * @note Locks this object for writing. */ HRESULT SnapshotMachine::onSnapshotChange (Snapshot *aSnapshot) { AutoLock alock (this); mPeer->saveSnapshotSettings (aSnapshot, SaveSS_UpdateAttrsOp); /* inform callbacks */ mParent->onSnapshotChange (mData->mUuid, aSnapshot->data().mId); return S_OK; }