From f215e02bf85f68d3a6106c2a1f4f7f063f819064 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Thu, 11 Apr 2024 10:17:27 +0200 Subject: Adding upstream version 7.0.14-dfsg. Signed-off-by: Daniel Baumann --- src/VBox/Main/include/MachineImpl.h | 1691 +++++++++++++++++++++++++++++++++++ 1 file changed, 1691 insertions(+) create mode 100644 src/VBox/Main/include/MachineImpl.h (limited to 'src/VBox/Main/include/MachineImpl.h') diff --git a/src/VBox/Main/include/MachineImpl.h b/src/VBox/Main/include/MachineImpl.h new file mode 100644 index 00000000..311a80bd --- /dev/null +++ b/src/VBox/Main/include/MachineImpl.h @@ -0,0 +1,1691 @@ +/* $Id: MachineImpl.h $ */ +/** @file + * Implementation of IMachine in VBoxSVC - Header. + */ + +/* + * Copyright (C) 2006-2023 Oracle and/or its affiliates. + * + * This file is part of VirtualBox base platform packages, as + * available from https://www.virtualbox.org. + * + * This program 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 3 of the + * License. + * + * This program is distributed in the hope that it will be useful, but + * WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, see . + * + * SPDX-License-Identifier: GPL-3.0-only + */ + +#ifndef MAIN_INCLUDED_MachineImpl_h +#define MAIN_INCLUDED_MachineImpl_h +#ifndef RT_WITHOUT_PRAGMA_ONCE +# pragma once +#endif + +#include "AuthLibrary.h" +#include "VirtualBoxBase.h" +#include "ProgressImpl.h" +#include "VRDEServerImpl.h" +#include "MediumAttachmentImpl.h" +#include "PCIDeviceAttachmentImpl.h" +#include "MediumLock.h" +#include "NetworkAdapterImpl.h" +#include "AudioSettingsImpl.h" +#include "SerialPortImpl.h" +#include "ParallelPortImpl.h" +#include "BIOSSettingsImpl.h" +#include "RecordingSettingsImpl.h" +#include "GraphicsAdapterImpl.h" +#include "StorageControllerImpl.h" // required for MachineImpl.h to compile on Windows +#include "USBControllerImpl.h" // required for MachineImpl.h to compile on Windows +#include "BandwidthControlImpl.h" +#include "BandwidthGroupImpl.h" +#include "TrustedPlatformModuleImpl.h" +#include "NvramStoreImpl.h" +#include "GuestDebugControlImpl.h" +#ifdef VBOX_WITH_RESOURCE_USAGE_API +# include "Performance.h" +# include "PerformanceImpl.h" +#endif +#include "ThreadTask.h" + +// generated header +#include "SchemaDefs.h" + +#include "VBox/com/ErrorInfo.h" + +#include +#ifdef VBOX_WITH_FULL_VM_ENCRYPTION +# include +# include +#endif + +#include +#include + +#include "MachineWrap.h" + +/** @todo r=klaus after moving the various Machine settings structs to + * MachineImpl.cpp it should be possible to eliminate this include. */ +#include + +// defines +//////////////////////////////////////////////////////////////////////////////// + +// helper declarations +//////////////////////////////////////////////////////////////////////////////// + +class Progress; +class ProgressProxy; +class Keyboard; +class Mouse; +class Display; +class MachineDebugger; +class USBController; +class USBDeviceFilters; +class Snapshot; +class SharedFolder; +class HostUSBDevice; +class StorageController; +class SessionMachine; +#ifdef VBOX_WITH_UNATTENDED +class Unattended; +#endif + +// Machine class +//////////////////////////////////////////////////////////////////////////////// +// +class ATL_NO_VTABLE Machine : + public MachineWrap +{ + +public: + + enum StateDependency + { + AnyStateDep = 0, + MutableStateDep, + MutableOrSavedStateDep, + MutableOrRunningStateDep, + MutableOrSavedOrRunningStateDep, + }; + + /** + * Internal machine data. + * + * Only one instance of this data exists per every machine -- it is shared + * by the Machine, SessionMachine and all SnapshotMachine instances + * associated with the given machine using the util::Shareable template + * through the mData variable. + * + * @note |const| members are persistent during lifetime so can be + * accessed without locking. + * + * @note There is no need to lock anything inside init() or uninit() + * methods, because they are always serialized (see AutoCaller). + */ + struct Data + { + /** + * Data structure to hold information about sessions opened for the + * given machine. + */ + struct Session + { + /** Type of lock which created this session */ + LockType_T mLockType; + + /** Control of the direct session opened by lockMachine() */ + ComPtr mDirectControl; + + typedef std::list > RemoteControlList; + + /** list of controls of all opened remote sessions */ + RemoteControlList mRemoteControls; + + /** launchVMProcess() and OnSessionEnd() progress indicator */ + ComObjPtr mProgress; + + /** + * PID of the session object that must be passed to openSession() + * to finalize the launchVMProcess() request (i.e., PID of the + * process created by launchVMProcess()) + */ + RTPROCESS mPID; + + /** Current session state */ + SessionState_T mState; + + /** Session name string (of the primary session) */ + Utf8Str mName; + + /** Session machine object */ + ComObjPtr mMachine; + + /** Medium object lock collection. */ + MediumLockListMap mLockedMedia; + }; + + Data(); + ~Data(); + + const Guid mUuid; + BOOL mRegistered; + + Utf8Str m_strConfigFile; + Utf8Str m_strConfigFileFull; + + // machine settings XML file + settings::MachineConfigFile *pMachineConfigFile; + uint32_t flModifications; + bool m_fAllowStateModification; + + BOOL mAccessible; + com::ErrorInfo mAccessError; + + MachineState_T mMachineState; + RTTIMESPEC mLastStateChange; + + /* Note: These are guarded by VirtualBoxBase::stateLockHandle() */ + uint32_t mMachineStateDeps; + RTSEMEVENTMULTI mMachineStateDepsSem; + uint32_t mMachineStateChangePending; + + BOOL mCurrentStateModified; + /** Guest properties have been modified and need saving since the + * machine was started, or there are transient properties which need + * deleting and the machine is being shut down. */ + BOOL mGuestPropertiesModified; + + Session mSession; + + ComObjPtr mFirstSnapshot; + ComObjPtr mCurrentSnapshot; + + // list of files to delete in Delete(); this list is filled by Unregister() + std::list llFilesToDelete; + +#ifdef VBOX_WITH_FULL_VM_ENCRYPTION + /* Store for secret keys. */ + SecretKeyStore *mpKeyStore; + BOOL fEncrypted; + /* KeyId of the password encrypting the DEK */ + com::Utf8Str mstrKeyId; + /* Store containing the DEK used for encrypting the VM */ + com::Utf8Str mstrKeyStore; + /* KeyId of the password encrypting the DEK for log files */ + com::Utf8Str mstrLogKeyId; + /* Store containing the DEK used for encrypting the VM's log files */ + com::Utf8Str mstrLogKeyStore; +#endif + }; + + /** + * Saved state data. + * + * It's actually only the state file path string and its encryption + * settings, but it needs to be separate from Data, because Machine + * and SessionMachine instances share it, while SnapshotMachine does + * not. + * + * The data variable is |mSSData|. + */ + struct SSData + { + Utf8Str strStateFilePath; +#ifdef VBOX_WITH_FULL_VM_ENCRYPTION + /* KeyId of the password encrypting the DEK for saved state */ + com::Utf8Str strStateKeyId; + /* Store containing the DEK used for encrypting saved state */ + com::Utf8Str strStateKeyStore; +#endif + }; + + /** + * User changeable machine data. + * + * This data is common for all machine snapshots, i.e. it is shared + * by all SnapshotMachine instances associated with the given machine + * using the util::Backupable template through the |mUserData| variable. + * + * SessionMachine instances can alter this data and discard changes. + * + * @note There is no need to lock anything inside init() or uninit() + * methods, because they are always serialized (see AutoCaller). + */ + struct UserData + { + settings::MachineUserData s; + }; + + /** + * Hardware data. + * + * This data is unique for a machine and for every machine snapshot. + * Stored using the util::Backupable template in the |mHWData| variable. + * + * SessionMachine instances can alter this data and discard changes. + * + * @todo r=klaus move all "pointer" objects out of this struct, as they + * need non-obvious handling when creating a new session or when taking + * a snapshot. Better do this right straight away, not relying on the + * template magic which doesn't work right in this case. + */ + struct HWData + { + /** + * Data structure to hold information about a guest property. + */ + struct GuestProperty { + /** Property value */ + Utf8Str strValue; + /** Property timestamp */ + LONG64 mTimestamp; + /** Property flags */ + ULONG mFlags; + }; + + HWData(); + ~HWData(); + + Bstr mHWVersion; + Guid mHardwareUUID; /**< If Null, use mData.mUuid. */ + ULONG mMemorySize; + ULONG mMemoryBalloonSize; + BOOL mPageFusionEnabled; + settings::RecordingSettings mRecordSettings; + BOOL mHWVirtExEnabled; + BOOL mHWVirtExNestedPagingEnabled; + BOOL mHWVirtExLargePagesEnabled; + BOOL mHWVirtExVPIDEnabled; + BOOL mHWVirtExUXEnabled; + BOOL mHWVirtExForceEnabled; + BOOL mHWVirtExUseNativeApi; + BOOL mHWVirtExVirtVmsaveVmload; + BOOL mPAEEnabled; + settings::Hardware::LongModeType mLongMode; + BOOL mTripleFaultReset; + BOOL mAPIC; + BOOL mX2APIC; + BOOL mIBPBOnVMExit; + BOOL mIBPBOnVMEntry; + BOOL mSpecCtrl; + BOOL mSpecCtrlByHost; + BOOL mL1DFlushOnSched; + BOOL mL1DFlushOnVMEntry; + BOOL mMDSClearOnSched; + BOOL mMDSClearOnVMEntry; + BOOL mNestedHWVirt; + ULONG mCPUCount; + BOOL mCPUHotPlugEnabled; + ULONG mCpuExecutionCap; + uint32_t mCpuIdPortabilityLevel; + Utf8Str mCpuProfile; + BOOL mHPETEnabled; + + BOOL mCPUAttached[SchemaDefs::MaxCPUCount]; + + std::list mCpuIdLeafList; + + DeviceType_T mBootOrder[SchemaDefs::MaxBootPosition]; + + typedef std::list > SharedFolderList; + SharedFolderList mSharedFolders; + + ClipboardMode_T mClipboardMode; + BOOL mClipboardFileTransfersEnabled; + + DnDMode_T mDnDMode; + + typedef std::map GuestPropertyMap; + GuestPropertyMap mGuestProperties; + + FirmwareType_T mFirmwareType; + KeyboardHIDType_T mKeyboardHIDType; + PointingHIDType_T mPointingHIDType; + ChipsetType_T mChipsetType; + IommuType_T mIommuType; + ParavirtProvider_T mParavirtProvider; + Utf8Str mParavirtDebug; + BOOL mEmulatedUSBCardReaderEnabled; + + BOOL mIOCacheEnabled; + ULONG mIOCacheSize; + + typedef std::list > PCIDeviceAssignmentList; + PCIDeviceAssignmentList mPCIDeviceAssignments; + + settings::Debugging mDebugging; + settings::Autostart mAutostart; + + Utf8Str mDefaultFrontend; + }; + + typedef std::list > MediumAttachmentList; + + DECLARE_COMMON_CLASS_METHODS(Machine) + + HRESULT FinalConstruct(); + void FinalRelease(); + + // public initializer/uninitializer for internal purposes only: + + // initializer for creating a new, empty machine + HRESULT init(VirtualBox *aParent, + const Utf8Str &strConfigFile, + const Utf8Str &strName, + const StringsList &llGroups, + const Utf8Str &strOsTypeId, + GuestOSType *aOsType, + const Guid &aId, + bool fForceOverwrite, + bool fDirectoryIncludesUUID, + const com::Utf8Str &aCipher, + const com::Utf8Str &aPasswordId, + const com::Utf8Str &aPassword); + + // initializer for loading existing machine XML (either registered or not) + HRESULT initFromSettings(VirtualBox *aParent, + const Utf8Str &strConfigFile, + const Guid *aId, + const com::Utf8Str &strPassword); + + // initializer for machine config in memory (OVF import) + HRESULT init(VirtualBox *aParent, + const Utf8Str &strName, + const Utf8Str &strSettingsFilename, + const settings::MachineConfigFile &config); + + void uninit(); + +#ifdef VBOX_WITH_RESOURCE_USAGE_API + // Needed from VirtualBox, for the delayed metrics cleanup. + void i_unregisterMetrics(PerformanceCollector *aCollector, Machine *aMachine); +#endif /* VBOX_WITH_RESOURCE_USAGE_API */ + +protected: + HRESULT initImpl(VirtualBox *aParent, + const Utf8Str &strConfigFile); + HRESULT initDataAndChildObjects(); + HRESULT i_registeredInit(); + HRESULT i_tryCreateMachineConfigFile(bool fForceOverwrite); + void uninitDataAndChildObjects(); + +public: + + + // public methods only for internal purposes + + virtual bool i_isSnapshotMachine() const + { + return false; + } + + virtual bool i_isSessionMachine() const + { + return false; + } + + /** + * Override of the default locking class to be used for validating lock + * order with the standard member lock handle. + */ + virtual VBoxLockingClass getLockingClass() const + { + return LOCKCLASS_MACHINEOBJECT; + } + + /// @todo (dmik) add lock and make non-inlined after revising classes + // that use it. Note: they should enter Machine lock to keep the returned + // information valid! + bool i_isRegistered() { return !!mData->mRegistered; } + + // unsafe inline public methods for internal purposes only (ensure there is + // a caller and a read lock before calling them!) + + /** + * Returns the VirtualBox object this machine belongs to. + * + * @note This method doesn't check this object's readiness. Intended to be + * used by ready Machine children (whose readiness is bound to the parent's + * one) or after doing addCaller() manually. + */ + VirtualBox* i_getVirtualBox() const { return mParent; } + + /** + * Checks if this machine is accessible, without attempting to load the + * config file. + * + * @note This method doesn't check this object's readiness. Intended to be + * used by ready Machine children (whose readiness is bound to the parent's + * one) or after doing addCaller() manually. + */ + bool i_isAccessible() const { return !!mData->mAccessible; } + + /** + * Returns this machine ID. + * + * @note This method doesn't check this object's readiness. Intended to be + * used by ready Machine children (whose readiness is bound to the parent's + * one) or after adding a caller manually. + */ + const Guid& i_getId() const { return mData->mUuid; } + + /** + * Returns the snapshot ID this machine represents or an empty UUID if this + * instance is not SnapshotMachine. + * + * @note This method doesn't check this object's readiness. Intended to be + * used by ready Machine children (whose readiness is bound to the parent's + * one) or after adding a caller manually. + */ + inline const Guid& i_getSnapshotId() const; + + /** + * Returns this machine's full settings file path. + * + * @note This method doesn't lock this object or check its readiness. + * Intended to be used only after doing addCaller() manually and locking it + * for reading. + */ + const Utf8Str& i_getSettingsFileFull() const { return mData->m_strConfigFileFull; } + + /** + * Returns this machine name. + * + * @note This method doesn't lock this object or check its readiness. + * Intended to be used only after doing addCaller() manually and locking it + * for reading. + */ + const Utf8Str& i_getName() const { return mUserData->s.strName; } + + enum + { + IsModified_MachineData = 0x000001, + IsModified_Storage = 0x000002, + IsModified_NetworkAdapters = 0x000008, + IsModified_SerialPorts = 0x000010, + IsModified_ParallelPorts = 0x000020, + IsModified_VRDEServer = 0x000040, + IsModified_AudioSettings = 0x000080, + IsModified_USB = 0x000100, + IsModified_BIOS = 0x000200, + IsModified_SharedFolders = 0x000400, + IsModified_Snapshots = 0x000800, + IsModified_BandwidthControl = 0x001000, + IsModified_Recording = 0x002000, + IsModified_GraphicsAdapter = 0x004000, + IsModified_TrustedPlatformModule = 0x008000, + IsModified_NvramStore = 0x010000, + IsModified_GuestDebugControl = 0x020000, + }; + + /** + * Returns various information about this machine. + * + * @note This method doesn't lock this object or check its readiness. + * Intended to be used only after doing addCaller() manually and locking it + * for reading. + */ + Utf8Str i_getOSTypeId() const { return mUserData->s.strOsType; } + ChipsetType_T i_getChipsetType() const { return mHWData->mChipsetType; } + FirmwareType_T i_getFirmwareType() const { return mHWData->mFirmwareType; } + ParavirtProvider_T i_getParavirtProvider() const { return mHWData->mParavirtProvider; } + Utf8Str i_getParavirtDebug() const { return mHWData->mParavirtDebug; } + + void i_setModified(uint32_t fl, bool fAllowStateModification = true); + void i_setModifiedLock(uint32_t fl, bool fAllowStateModification = true); + + MachineState_T i_getMachineState() const { return mData->mMachineState; } + + bool i_isStateModificationAllowed() const { return mData->m_fAllowStateModification; } + void i_allowStateModification() { mData->m_fAllowStateModification = true; } + void i_disallowStateModification() { mData->m_fAllowStateModification = false; } + + const StringsList &i_getGroups() const { return mUserData->s.llGroups; } + + // callback handlers + virtual HRESULT i_onNetworkAdapterChange(INetworkAdapter * /* networkAdapter */, BOOL /* changeAdapter */) { return S_OK; } + virtual HRESULT i_onNATRedirectRuleChanged(ULONG /* slot */, BOOL /* fRemove */ , const Utf8Str & /* name */, + NATProtocol_T /* protocol */, const Utf8Str & /* host ip */, LONG /* host port */, + const Utf8Str & /* guest port */, LONG /* guest port */ ) { return S_OK; } + virtual HRESULT i_onAudioAdapterChange(IAudioAdapter * /* audioAdapter */) { return S_OK; } + virtual HRESULT i_onHostAudioDeviceChange(IHostAudioDevice *, BOOL /* new */, AudioDeviceState_T, IVirtualBoxErrorInfo *) { return S_OK; } + virtual HRESULT i_onSerialPortChange(ISerialPort * /* serialPort */) { return S_OK; } + virtual HRESULT i_onParallelPortChange(IParallelPort * /* parallelPort */) { return S_OK; } + virtual HRESULT i_onVRDEServerChange(BOOL /* aRestart */) { return S_OK; } + virtual HRESULT i_onUSBControllerChange() { return S_OK; } + virtual HRESULT i_onStorageControllerChange(const com::Guid & /* aMachineId */, const com::Utf8Str & /* aControllerName */) { return S_OK; } + virtual HRESULT i_onCPUChange(ULONG /* aCPU */, BOOL /* aRemove */) { return S_OK; } + virtual HRESULT i_onCPUExecutionCapChange(ULONG /* aExecutionCap */) { return S_OK; } + virtual HRESULT i_onMediumChange(IMediumAttachment * /* mediumAttachment */, BOOL /* force */) { return S_OK; } + virtual HRESULT i_onSharedFolderChange() { return S_OK; } + virtual HRESULT i_onVMProcessPriorityChange(VMProcPriority_T /* aPriority */) { return S_OK; } + virtual HRESULT i_onClipboardModeChange(ClipboardMode_T /* aClipboardMode */) { return S_OK; } + virtual HRESULT i_onClipboardFileTransferModeChange(BOOL /* aEnable */) { return S_OK; } + virtual HRESULT i_onDnDModeChange(DnDMode_T /* aDnDMode */) { return S_OK; } + virtual HRESULT i_onBandwidthGroupChange(IBandwidthGroup * /* aBandwidthGroup */) { return S_OK; } + virtual HRESULT i_onStorageDeviceChange(IMediumAttachment * /* mediumAttachment */, BOOL /* remove */, + BOOL /* silent */) { return S_OK; } + virtual HRESULT i_onRecordingChange(BOOL /* aEnable */) { return S_OK; } + virtual HRESULT i_onGuestDebugControlChange(IGuestDebugControl * /* guestDebugControl */) { return S_OK; } + + + HRESULT i_saveRegistryEntry(settings::MachineRegistryEntry &data); + + int i_calculateFullPath(const Utf8Str &strPath, Utf8Str &aResult); + void i_copyPathRelativeToMachine(const Utf8Str &strSource, Utf8Str &strTarget); + + void i_getLogFolder(Utf8Str &aLogFolder); + Utf8Str i_getLogFilename(ULONG idx); + Utf8Str i_getHardeningLogFilename(void); + Utf8Str i_getDefaultNVRAMFilename(); + Utf8Str i_getSnapshotNVRAMFilename(); + SettingsVersion_T i_getSettingsVersion(void); + + void i_composeSavedStateFilename(Utf8Str &strStateFilePath); + + bool i_isUSBControllerPresent(); + + HRESULT i_launchVMProcess(IInternalSessionControl *aControl, + const Utf8Str &strType, + const std::vector &aEnvironmentChanges, + ProgressProxy *aProgress); + + HRESULT i_getDirectControl(ComPtr *directControl) + { + *directControl = mData->mSession.mDirectControl; + + HRESULT hrc; + if (!*directControl) + hrc = E_ACCESSDENIED; + else + hrc = S_OK; + + return hrc; + } + + bool i_isSessionOpen(ComObjPtr &aMachine, + ComPtr *aControl = NULL, + bool aRequireVM = false, + bool aAllowClosing = false); + bool i_isSessionSpawning(); + + bool i_isSessionOpenOrClosing(ComObjPtr &aMachine, + ComPtr *aControl = NULL) + { return i_isSessionOpen(aMachine, aControl, false /* aRequireVM */, true /* aAllowClosing */); } + + bool i_isSessionOpenVM(ComObjPtr &aMachine, + ComPtr *aControl = NULL) + { return i_isSessionOpen(aMachine, aControl, true /* aRequireVM */, false /* aAllowClosing */); } + + bool i_checkForSpawnFailure(); + + HRESULT i_prepareRegister(); + + HRESULT i_getSharedFolder(const Utf8Str &aName, + ComObjPtr &aSharedFolder, + bool aSetError = false) + { + AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS); + return i_findSharedFolder(aName, aSharedFolder, aSetError); + } + + HRESULT i_addStateDependency(StateDependency aDepType = AnyStateDep, + MachineState_T *aState = NULL, + BOOL *aRegistered = NULL); + void i_releaseStateDependency(); + + HRESULT i_getStorageControllerByName(const Utf8Str &aName, + ComObjPtr &aStorageController, + bool aSetError = false); + + HRESULT i_getMediumAttachmentsOfController(const Utf8Str &aName, + MediumAttachmentList &aAttachments); + + HRESULT i_getUSBControllerByName(const Utf8Str &aName, + ComObjPtr &aUSBController, + bool aSetError = false); + + HRESULT i_getBandwidthGroup(const Utf8Str &strBandwidthGroup, + ComObjPtr &pBandwidthGroup, + bool fSetError = false) + { + return mBandwidthControl->i_getBandwidthGroupByName(strBandwidthGroup, + pBandwidthGroup, + fSetError); + } + + static HRESULT i_setErrorStatic(HRESULT aResultCode, const char *pcszMsg, ...); + +protected: + + class ClientToken; + + HRESULT i_checkStateDependency(StateDependency aDepType); + + Machine *i_getMachine(); + + void i_ensureNoStateDependencies(AutoWriteLock &alock); + + virtual HRESULT i_setMachineState(MachineState_T aMachineState); + + HRESULT i_findSharedFolder(const Utf8Str &aName, + ComObjPtr &aSharedFolder, + bool aSetError = false); + + HRESULT i_loadSettings(bool aRegistered); + HRESULT i_loadMachineDataFromSettings(const settings::MachineConfigFile &config, + const Guid *puuidRegistry); + HRESULT i_loadSnapshot(const settings::Snapshot &data, + const Guid &aCurSnapshotId); + HRESULT i_loadHardware(const Guid *puuidRegistry, + const Guid *puuidSnapshot, + const settings::Hardware &data, + const settings::Debugging *pDbg, + const settings::Autostart *pAutostart, + const settings::RecordingSettings &recording); + HRESULT i_loadDebugging(const settings::Debugging *pDbg); + HRESULT i_loadAutostart(const settings::Autostart *pAutostart); + HRESULT i_loadStorageControllers(const settings::Storage &data, + const Guid *puuidRegistry, + const Guid *puuidSnapshot); + HRESULT i_loadStorageDevices(StorageController *aStorageController, + const settings::StorageController &data, + const Guid *puuidRegistry, + const Guid *puuidSnapshot); + + HRESULT i_findSnapshotById(const Guid &aId, + ComObjPtr &aSnapshot, + bool aSetError = false); + HRESULT i_findSnapshotByName(const Utf8Str &strName, + ComObjPtr &aSnapshot, + bool aSetError = false); + + ULONG i_getUSBControllerCountByType(USBControllerType_T enmType); + + enum + { + /* flags for #saveSettings() */ + SaveS_ResetCurStateModified = 0x01, + SaveS_Force = 0x04, + SaveS_RemoveBackup = 0x08, + /* flags for #saveStateSettings() */ + SaveSTS_CurStateModified = 0x20, + SaveSTS_StateFilePath = 0x40, + SaveSTS_StateTimeStamp = 0x80 + }; + + HRESULT i_prepareSaveSettings(bool *pfNeedsGlobalSaveSettings, + bool *pfSettingsFileIsNew); + HRESULT i_saveSettings(bool *pfNeedsGlobalSaveSettings, AutoWriteLock &alock, int aFlags = 0); + + void i_copyMachineDataToSettings(settings::MachineConfigFile &config); + HRESULT i_saveAllSnapshots(settings::MachineConfigFile &config); + HRESULT i_saveHardware(settings::Hardware &data, settings::Debugging *pDbg, + settings::Autostart *pAutostart, settings::RecordingSettings &recording); + HRESULT i_saveStorageControllers(settings::Storage &data); + HRESULT i_saveStorageDevices(ComObjPtr aStorageController, + settings::StorageController &data); + HRESULT i_saveStateSettings(int aFlags); + + void i_addMediumToRegistry(ComObjPtr &pMedium); + + HRESULT i_deleteFile(const Utf8Str &strFile, bool fIgnoreFailures = false, const Utf8Str &strWhat = "", int *prc = NULL); + + HRESULT i_createImplicitDiffs(IProgress *aProgress, + ULONG aWeight, + bool aOnline); + HRESULT i_deleteImplicitDiffs(bool aOnline); + + MediumAttachment* i_findAttachment(const MediumAttachmentList &ll, + const Utf8Str &aControllerName, + LONG aControllerPort, + LONG aDevice); + MediumAttachment* i_findAttachment(const MediumAttachmentList &ll, + ComObjPtr pMedium); + MediumAttachment* i_findAttachment(const MediumAttachmentList &ll, + Guid &id); + + HRESULT i_detachDevice(MediumAttachment *pAttach, + AutoWriteLock &writeLock, + Snapshot *pSnapshot); + + HRESULT i_detachAllMedia(AutoWriteLock &writeLock, + Snapshot *pSnapshot, + CleanupMode_T cleanupMode, + MediaList &llMedia); + + void i_commitMedia(bool aOnline = false); + void i_rollbackMedia(); + + bool i_isInOwnDir(Utf8Str *aSettingsDir = NULL) const; + + void i_rollback(bool aNotify); + void i_commit(); + void i_copyFrom(Machine *aThat); + bool i_isControllerHotplugCapable(StorageControllerType_T enmCtrlType); + + Utf8Str i_getExtraData(const Utf8Str &strKey); + + com::Utf8Str i_controllerNameFromBusType(StorageBus_T aBusType); + +#ifdef VBOX_WITH_GUEST_PROPS + HRESULT i_getGuestPropertyFromService(const com::Utf8Str &aName, com::Utf8Str &aValue, + LONG64 *aTimestamp, com::Utf8Str &aFlags) const; + HRESULT i_setGuestPropertyToService(const com::Utf8Str &aName, const com::Utf8Str &aValue, + const com::Utf8Str &aFlags, bool fDelete); + HRESULT i_getGuestPropertyFromVM(const com::Utf8Str &aName, com::Utf8Str &aValue, + LONG64 *aTimestamp, com::Utf8Str &aFlags) const; + HRESULT i_setGuestPropertyToVM(const com::Utf8Str &aName, const com::Utf8Str &aValue, + const com::Utf8Str &aFlags, bool fDelete); + HRESULT i_enumerateGuestPropertiesInService(const com::Utf8Str &aPatterns, + std::vector &aNames, + std::vector &aValues, + std::vector &aTimestamps, + std::vector &aFlags); + HRESULT i_enumerateGuestPropertiesOnVM(const com::Utf8Str &aPatterns, + std::vector &aNames, + std::vector &aValues, + std::vector &aTimestamps, + std::vector &aFlags); + +#endif /* VBOX_WITH_GUEST_PROPS */ + +#ifdef VBOX_WITH_RESOURCE_USAGE_API + void i_getDiskList(MediaList &list); + void i_registerMetrics(PerformanceCollector *aCollector, Machine *aMachine, RTPROCESS pid); + + pm::CollectorGuest *mCollectorGuest; +#endif /* VBOX_WITH_RESOURCE_USAGE_API */ + + Machine * const mPeer; + + VirtualBox * const mParent; + + Shareable mData; + Shareable mSSData; + + Backupable mUserData; + Backupable mHWData; + + /** + * Hard disk and other media data. + * + * The usage policy is the same as for mHWData, but a separate field + * is necessary because hard disk data requires different procedures when + * taking or deleting snapshots, etc. + * + * @todo r=klaus change this to a regular list and use the normal way to + * handle the settings when creating a session or taking a snapshot. + * Same thing applies to mStorageControllers and mUSBControllers. + */ + Backupable mMediumAttachments; + + // the following fields need special backup/rollback/commit handling, + // so they cannot be a part of HWData + + const ComObjPtr mVRDEServer; + const ComObjPtr mSerialPorts[SchemaDefs::SerialPortCount]; + const ComObjPtr mParallelPorts[SchemaDefs::ParallelPortCount]; + const ComObjPtr mAudioSettings; + const ComObjPtr mUSBDeviceFilters; + const ComObjPtr mBIOSSettings; + const ComObjPtr mRecordingSettings; + const ComObjPtr mGraphicsAdapter; + const ComObjPtr mBandwidthControl; + const ComObjPtr mGuestDebugControl; + + const ComObjPtr mTrustedPlatformModule; + const ComObjPtr mNvramStore; + + typedef std::vector > NetworkAdapterVector; + NetworkAdapterVector mNetworkAdapters; + + typedef std::list > StorageControllerList; + Backupable mStorageControllers; + + typedef std::list > USBControllerList; + Backupable mUSBControllers; + + uint64_t uRegistryNeedsSaving; + + /** + * Abstract base class for all Machine or SessionMachine related + * asynchronous tasks. This is necessary since RTThreadCreate cannot call + * a (non-static) method as its thread function, so instead we have it call + * the static Machine::taskHandler, which then calls the handler() method + * in here (implemented by the subclasses). + */ + class Task : public ThreadTask + { + public: + Task(Machine *m, Progress *p, const Utf8Str &t) + : ThreadTask(t), + m_pMachine(m), + m_machineCaller(m), + m_pProgress(p), + m_machineStateBackup(m->mData->mMachineState) // save the current machine state + {} + virtual ~Task(){} + + void modifyBackedUpState(MachineState_T s) + { + *const_cast(&m_machineStateBackup) = s; + } + + ComObjPtr m_pMachine; + AutoCaller m_machineCaller; + ComObjPtr m_pProgress; + const MachineState_T m_machineStateBackup; + }; + + class DeleteConfigTask; + void i_deleteConfigHandler(DeleteConfigTask &task); + +#ifdef VBOX_WITH_FULL_VM_ENCRYPTION + class ChangeEncryptionTask; + void i_changeEncryptionHandler(ChangeEncryptionTask &task); + HRESULT i_changeEncryptionForComponent(ChangeEncryptionTask &task, const com::Utf8Str strDirectory, + const com::Utf8Str strFilePattern, com::Utf8Str &strKeyStore, + com::Utf8Str &strKeyId, int iCipherMode); + int i_findFiles(std::list &lstFiles, const com::Utf8Str &strDir, + const com::Utf8Str &strPattern); + int i_createIoStreamForFile(const char *pszFilename, PCVBOXCRYPTOIF pCryptoIf, + const char *pszKeyStore, const char *pszPassword, + uint64_t fOpen, PRTVFSIOSTREAM phVfsIos); +#endif + + friend class Appliance; + friend class RecordingSettings; + friend class RecordingScreenSettings; + friend class SessionMachine; + friend class SnapshotMachine; + friend class VirtualBox; + + friend class MachineCloneVM; + friend class MachineMoveVM; +private: + // wrapped IMachine properties + HRESULT getParent(ComPtr &aParent); + HRESULT getIcon(std::vector &aIcon); + HRESULT setIcon(const std::vector &aIcon); + HRESULT getAccessible(BOOL *aAccessible); + HRESULT getAccessError(ComPtr &aAccessError); + HRESULT getName(com::Utf8Str &aName); + HRESULT setName(const com::Utf8Str &aName); + HRESULT getDescription(com::Utf8Str &aDescription); + HRESULT setDescription(const com::Utf8Str &aDescription); + HRESULT getId(com::Guid &aId); + HRESULT getGroups(std::vector &aGroups); + HRESULT setGroups(const std::vector &aGroups); + HRESULT getOSTypeId(com::Utf8Str &aOSTypeId); + HRESULT setOSTypeId(const com::Utf8Str &aOSTypeId); + HRESULT getHardwareVersion(com::Utf8Str &aHardwareVersion); + HRESULT setHardwareVersion(const com::Utf8Str &aHardwareVersion); + HRESULT getHardwareUUID(com::Guid &aHardwareUUID); + HRESULT setHardwareUUID(const com::Guid &aHardwareUUID); + HRESULT getCPUCount(ULONG *aCPUCount); + HRESULT setCPUCount(ULONG aCPUCount); + HRESULT getCPUHotPlugEnabled(BOOL *aCPUHotPlugEnabled); + HRESULT setCPUHotPlugEnabled(BOOL aCPUHotPlugEnabled); + HRESULT getCPUExecutionCap(ULONG *aCPUExecutionCap); + HRESULT setCPUExecutionCap(ULONG aCPUExecutionCap); + HRESULT getCPUIDPortabilityLevel(ULONG *aCPUIDPortabilityLevel); + HRESULT setCPUIDPortabilityLevel(ULONG aCPUIDPortabilityLevel); + HRESULT getCPUProfile(com::Utf8Str &aCPUProfile); + HRESULT setCPUProfile(const com::Utf8Str &aCPUProfile); + HRESULT getMemorySize(ULONG *aMemorySize); + HRESULT setMemorySize(ULONG aMemorySize); + HRESULT getMemoryBalloonSize(ULONG *aMemoryBalloonSize); + HRESULT setMemoryBalloonSize(ULONG aMemoryBalloonSize); + HRESULT getPageFusionEnabled(BOOL *aPageFusionEnabled); + HRESULT setPageFusionEnabled(BOOL aPageFusionEnabled); + HRESULT getGraphicsAdapter(ComPtr &aGraphicsAdapter); + HRESULT getBIOSSettings(ComPtr &aBIOSSettings); + HRESULT getTrustedPlatformModule(ComPtr &aTrustedPlatformModule); + HRESULT getNonVolatileStore(ComPtr &aNvramStore); + HRESULT getRecordingSettings(ComPtr &aRecordingSettings); + HRESULT getFirmwareType(FirmwareType_T *aFirmwareType); + HRESULT setFirmwareType(FirmwareType_T aFirmwareType); + HRESULT getPointingHIDType(PointingHIDType_T *aPointingHIDType); + HRESULT setPointingHIDType(PointingHIDType_T aPointingHIDType); + HRESULT getKeyboardHIDType(KeyboardHIDType_T *aKeyboardHIDType); + HRESULT setKeyboardHIDType(KeyboardHIDType_T aKeyboardHIDType); + HRESULT getHPETEnabled(BOOL *aHPETEnabled); + HRESULT setHPETEnabled(BOOL aHPETEnabled); + HRESULT getChipsetType(ChipsetType_T *aChipsetType); + HRESULT setChipsetType(ChipsetType_T aChipsetType); + HRESULT getIommuType(IommuType_T *aIommuType); + HRESULT setIommuType(IommuType_T aIommuType); + HRESULT getSnapshotFolder(com::Utf8Str &aSnapshotFolder); + HRESULT setSnapshotFolder(const com::Utf8Str &aSnapshotFolder); + HRESULT getVRDEServer(ComPtr &aVRDEServer); + HRESULT getEmulatedUSBCardReaderEnabled(BOOL *aEmulatedUSBCardReaderEnabled); + HRESULT setEmulatedUSBCardReaderEnabled(BOOL aEmulatedUSBCardReaderEnabled); + HRESULT getMediumAttachments(std::vector > &aMediumAttachments); + HRESULT getUSBControllers(std::vector > &aUSBControllers); + HRESULT getUSBDeviceFilters(ComPtr &aUSBDeviceFilters); + HRESULT getAudioSettings(ComPtr &aAudioSettings); + HRESULT getStorageControllers(std::vector > &aStorageControllers); + HRESULT getSettingsFilePath(com::Utf8Str &aSettingsFilePath); + HRESULT getSettingsAuxFilePath(com::Utf8Str &aSettingsAuxFilePath); + HRESULT getSettingsModified(BOOL *aSettingsModified); + HRESULT getSessionState(SessionState_T *aSessionState); + HRESULT getSessionType(SessionType_T *aSessionType); + HRESULT getSessionName(com::Utf8Str &aSessionType); + HRESULT getSessionPID(ULONG *aSessionPID); + HRESULT getState(MachineState_T *aState); + HRESULT getLastStateChange(LONG64 *aLastStateChange); + HRESULT getStateFilePath(com::Utf8Str &aStateFilePath); + HRESULT getLogFolder(com::Utf8Str &aLogFolder); + HRESULT getCurrentSnapshot(ComPtr &aCurrentSnapshot); + HRESULT getSnapshotCount(ULONG *aSnapshotCount); + HRESULT getCurrentStateModified(BOOL *aCurrentStateModified); + HRESULT getSharedFolders(std::vector > &aSharedFolders); + HRESULT getClipboardMode(ClipboardMode_T *aClipboardMode); + HRESULT setClipboardMode(ClipboardMode_T aClipboardMode); + HRESULT getClipboardFileTransfersEnabled(BOOL *aEnabled); + HRESULT setClipboardFileTransfersEnabled(BOOL aEnabled); + HRESULT getDnDMode(DnDMode_T *aDnDMode); + HRESULT setDnDMode(DnDMode_T aDnDMode); + HRESULT getTeleporterEnabled(BOOL *aTeleporterEnabled); + HRESULT setTeleporterEnabled(BOOL aTeleporterEnabled); + HRESULT getTeleporterPort(ULONG *aTeleporterPort); + HRESULT setTeleporterPort(ULONG aTeleporterPort); + HRESULT getTeleporterAddress(com::Utf8Str &aTeleporterAddress); + HRESULT setTeleporterAddress(const com::Utf8Str &aTeleporterAddress); + HRESULT getTeleporterPassword(com::Utf8Str &aTeleporterPassword); + HRESULT setTeleporterPassword(const com::Utf8Str &aTeleporterPassword); + HRESULT getParavirtProvider(ParavirtProvider_T *aParavirtProvider); + HRESULT setParavirtProvider(ParavirtProvider_T aParavirtProvider); + HRESULT getParavirtDebug(com::Utf8Str &aParavirtDebug); + HRESULT setParavirtDebug(const com::Utf8Str &aParavirtDebug); + HRESULT getRTCUseUTC(BOOL *aRTCUseUTC); + HRESULT setRTCUseUTC(BOOL aRTCUseUTC); + HRESULT getIOCacheEnabled(BOOL *aIOCacheEnabled); + HRESULT setIOCacheEnabled(BOOL aIOCacheEnabled); + HRESULT getIOCacheSize(ULONG *aIOCacheSize); + HRESULT setIOCacheSize(ULONG aIOCacheSize); + HRESULT getPCIDeviceAssignments(std::vector > &aPCIDeviceAssignments); + HRESULT getBandwidthControl(ComPtr &aBandwidthControl); + HRESULT getTracingEnabled(BOOL *aTracingEnabled); + HRESULT setTracingEnabled(BOOL aTracingEnabled); + HRESULT getTracingConfig(com::Utf8Str &aTracingConfig); + HRESULT setTracingConfig(const com::Utf8Str &aTracingConfig); + HRESULT getAllowTracingToAccessVM(BOOL *aAllowTracingToAccessVM); + HRESULT setAllowTracingToAccessVM(BOOL aAllowTracingToAccessVM); + HRESULT getAutostartEnabled(BOOL *aAutostartEnabled); + HRESULT setAutostartEnabled(BOOL aAutostartEnabled); + HRESULT getAutostartDelay(ULONG *aAutostartDelay); + HRESULT setAutostartDelay(ULONG aAutostartDelay); + HRESULT getAutostopType(AutostopType_T *aAutostopType); + HRESULT setAutostopType(AutostopType_T aAutostopType); + HRESULT getDefaultFrontend(com::Utf8Str &aDefaultFrontend); + HRESULT setDefaultFrontend(const com::Utf8Str &aDefaultFrontend); + HRESULT getUSBProxyAvailable(BOOL *aUSBProxyAvailable); + HRESULT getVMProcessPriority(VMProcPriority_T *aVMProcessPriority); + HRESULT setVMProcessPriority(VMProcPriority_T aVMProcessPriority); + HRESULT getStateKeyId(com::Utf8Str &aKeyId); + HRESULT getStateKeyStore(com::Utf8Str &aKeyStore); + HRESULT getLogKeyId(com::Utf8Str &aKeyId); + HRESULT getLogKeyStore(com::Utf8Str &aKeyStore); + HRESULT getGuestDebugControl(ComPtr &aGuestDebugControl); + + // wrapped IMachine methods + HRESULT lockMachine(const ComPtr &aSession, + LockType_T aLockType); + HRESULT launchVMProcess(const ComPtr &aSession, + const com::Utf8Str &aType, + const std::vector &aEnvironmentChanges, + ComPtr &aProgress); + HRESULT setBootOrder(ULONG aPosition, + DeviceType_T aDevice); + HRESULT getBootOrder(ULONG aPosition, + DeviceType_T *aDevice); + HRESULT attachDevice(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + DeviceType_T aType, + const ComPtr &aMedium); + HRESULT attachDeviceWithoutMedium(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + DeviceType_T aType); + HRESULT detachDevice(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice); + HRESULT passthroughDevice(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + BOOL aPassthrough); + HRESULT temporaryEjectDevice(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + BOOL aTemporaryEject); + HRESULT nonRotationalDevice(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + BOOL aNonRotational); + HRESULT setAutoDiscardForDevice(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + BOOL aDiscard); + HRESULT setHotPluggableForDevice(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + BOOL aHotPluggable); + HRESULT setBandwidthGroupForDevice(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + const ComPtr &aBandwidthGroup); + HRESULT setNoBandwidthGroupForDevice(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice); + HRESULT unmountMedium(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + BOOL aForce); + HRESULT mountMedium(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + const ComPtr &aMedium, + BOOL aForce); + HRESULT getMedium(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + ComPtr &aMedium); + HRESULT getMediumAttachmentsOfController(const com::Utf8Str &aName, + std::vector > &aMediumAttachments); + HRESULT getMediumAttachment(const com::Utf8Str &aName, + LONG aControllerPort, + LONG aDevice, + ComPtr &aAttachment); + HRESULT attachHostPCIDevice(LONG aHostAddress, + LONG aDesiredGuestAddress, + BOOL aTryToUnbind); + HRESULT detachHostPCIDevice(LONG aHostAddress); + HRESULT getNetworkAdapter(ULONG aSlot, + ComPtr &aAdapter); + HRESULT addStorageController(const com::Utf8Str &aName, + StorageBus_T aConnectionType, + ComPtr &aController); + HRESULT getStorageControllerByName(const com::Utf8Str &aName, + ComPtr &aStorageController); + HRESULT getStorageControllerByInstance(StorageBus_T aConnectionType, + ULONG aInstance, + ComPtr &aStorageController); + HRESULT removeStorageController(const com::Utf8Str &aName); + HRESULT setStorageControllerBootable(const com::Utf8Str &aName, + BOOL aBootable); + HRESULT addUSBController(const com::Utf8Str &aName, + USBControllerType_T aType, + ComPtr &aController); + HRESULT removeUSBController(const com::Utf8Str &aName); + HRESULT getUSBControllerByName(const com::Utf8Str &aName, + ComPtr &aController); + HRESULT getUSBControllerCountByType(USBControllerType_T aType, + ULONG *aControllers); + HRESULT getSerialPort(ULONG aSlot, + ComPtr &aPort); + HRESULT getParallelPort(ULONG aSlot, + ComPtr &aPort); + HRESULT getExtraDataKeys(std::vector &aKeys); + HRESULT getExtraData(const com::Utf8Str &aKey, + com::Utf8Str &aValue); + HRESULT setExtraData(const com::Utf8Str &aKey, + const com::Utf8Str &aValue); + HRESULT getCPUProperty(CPUPropertyType_T aProperty, + BOOL *aValue); + HRESULT setCPUProperty(CPUPropertyType_T aProperty, + BOOL aValue); + HRESULT getCPUIDLeafByOrdinal(ULONG aOrdinal, + ULONG *aIdx, + ULONG *aSubIdx, + ULONG *aValEax, + ULONG *aValEbx, + ULONG *aValEcx, + ULONG *aValEdx); + HRESULT getCPUIDLeaf(ULONG aIdx, ULONG aSubIdx, + ULONG *aValEax, + ULONG *aValEbx, + ULONG *aValEcx, + ULONG *aValEdx); + HRESULT setCPUIDLeaf(ULONG aIdx, ULONG aSubIdx, + ULONG aValEax, + ULONG aValEbx, + ULONG aValEcx, + ULONG aValEdx); + HRESULT removeCPUIDLeaf(ULONG aIdx, ULONG aSubIdx); + HRESULT removeAllCPUIDLeaves(); + HRESULT getHWVirtExProperty(HWVirtExPropertyType_T aProperty, + BOOL *aValue); + HRESULT setHWVirtExProperty(HWVirtExPropertyType_T aProperty, + BOOL aValue); + HRESULT setSettingsFilePath(const com::Utf8Str &aSettingsFilePath, + ComPtr &aProgress); + HRESULT saveSettings(); + HRESULT discardSettings(); + HRESULT unregister(AutoCaller &aAutoCaller, + CleanupMode_T aCleanupMode, + std::vector > &aMedia); + HRESULT deleteConfig(const std::vector > &aMedia, + ComPtr &aProgress); + HRESULT exportTo(const ComPtr &aAppliance, + const com::Utf8Str &aLocation, + ComPtr &aDescription); + HRESULT findSnapshot(const com::Utf8Str &aNameOrId, + ComPtr &aSnapshot); + HRESULT createSharedFolder(const com::Utf8Str &aName, + const com::Utf8Str &aHostPath, + BOOL aWritable, + BOOL aAutomount, + const com::Utf8Str &aAutoMountPoint); + HRESULT removeSharedFolder(const com::Utf8Str &aName); + HRESULT canShowConsoleWindow(BOOL *aCanShow); + HRESULT showConsoleWindow(LONG64 *aWinId); + HRESULT getGuestProperty(const com::Utf8Str &aName, + com::Utf8Str &aValue, + LONG64 *aTimestamp, + com::Utf8Str &aFlags); + HRESULT getGuestPropertyValue(const com::Utf8Str &aProperty, + com::Utf8Str &aValue); + HRESULT getGuestPropertyTimestamp(const com::Utf8Str &aProperty, + LONG64 *aValue); + HRESULT setGuestProperty(const com::Utf8Str &aProperty, + const com::Utf8Str &aValue, + const com::Utf8Str &aFlags); + HRESULT setGuestPropertyValue(const com::Utf8Str &aProperty, + const com::Utf8Str &aValue); + HRESULT deleteGuestProperty(const com::Utf8Str &aName); + HRESULT enumerateGuestProperties(const com::Utf8Str &aPatterns, + std::vector &aNames, + std::vector &aValues, + std::vector &aTimestamps, + std::vector &aFlags); + HRESULT querySavedGuestScreenInfo(ULONG aScreenId, + ULONG *aOriginX, + ULONG *aOriginY, + ULONG *aWidth, + ULONG *aHeight, + BOOL *aEnabled); + HRESULT readSavedThumbnailToArray(ULONG aScreenId, + BitmapFormat_T aBitmapFormat, + ULONG *aWidth, + ULONG *aHeight, + std::vector &aData); + HRESULT querySavedScreenshotInfo(ULONG aScreenId, + ULONG *aWidth, + ULONG *aHeight, + std::vector &aBitmapFormats); + HRESULT readSavedScreenshotToArray(ULONG aScreenId, + BitmapFormat_T aBitmapFormat, + ULONG *aWidth, + ULONG *aHeight, + std::vector &aData); + + HRESULT hotPlugCPU(ULONG aCpu); + HRESULT hotUnplugCPU(ULONG aCpu); + HRESULT getCPUStatus(ULONG aCpu, + BOOL *aAttached); + HRESULT getEffectiveParavirtProvider(ParavirtProvider_T *aParavirtProvider); + HRESULT queryLogFilename(ULONG aIdx, + com::Utf8Str &aFilename); + HRESULT readLog(ULONG aIdx, + LONG64 aOffset, + LONG64 aSize, + std::vector &aData); + HRESULT cloneTo(const ComPtr &aTarget, + CloneMode_T aMode, + const std::vector &aOptions, + ComPtr &aProgress); + HRESULT moveTo(const com::Utf8Str &aTargetPath, + const com::Utf8Str &aType, + ComPtr &aProgress); + HRESULT saveState(ComPtr &aProgress); + HRESULT adoptSavedState(const com::Utf8Str &aSavedStateFile); + HRESULT discardSavedState(BOOL aFRemoveFile); + HRESULT takeSnapshot(const com::Utf8Str &aName, + const com::Utf8Str &aDescription, + BOOL aPause, + com::Guid &aId, + ComPtr &aProgress); + HRESULT deleteSnapshot(const com::Guid &aId, + ComPtr &aProgress); + HRESULT deleteSnapshotAndAllChildren(const com::Guid &aId, + ComPtr &aProgress); + HRESULT deleteSnapshotRange(const com::Guid &aStartId, + const com::Guid &aEndId, + ComPtr &aProgress); + HRESULT restoreSnapshot(const ComPtr &aSnapshot, + ComPtr &aProgress); + HRESULT applyDefaults(const com::Utf8Str &aFlags); + HRESULT changeEncryption(const com::Utf8Str &aCurrentPassword, + const com::Utf8Str &aCipher, + const com::Utf8Str &aNewPassword, + const com::Utf8Str &aNewPasswordId, + BOOL aForce, + ComPtr &aProgress); + HRESULT getEncryptionSettings(com::Utf8Str &aCipher, + com::Utf8Str &aPasswordId); + HRESULT checkEncryptionPassword(const com::Utf8Str &aPassword); + HRESULT addEncryptionPassword(const com::Utf8Str &aId, + const com::Utf8Str &aPassword); + HRESULT addEncryptionPasswords(const std::vector &aIds, + const std::vector &aPasswords); + HRESULT removeEncryptionPassword(AutoCaller &autoCaller, + const com::Utf8Str &aId); + HRESULT clearAllEncryptionPasswords(AutoCaller &autoCaller); + + // wrapped IInternalMachineControl properties + + // wrapped IInternalMachineControl methods + HRESULT updateState(MachineState_T aState); + HRESULT beginPowerUp(const ComPtr &aProgress); + HRESULT endPowerUp(LONG aResult); + HRESULT beginPoweringDown(ComPtr &aProgress); + HRESULT endPoweringDown(LONG aResult, + const com::Utf8Str &aErrMsg); + HRESULT runUSBDeviceFilters(const ComPtr &aDevice, + BOOL *aMatched, + ULONG *aMaskedInterfaces); + HRESULT captureUSBDevice(const com::Guid &aId, + const com::Utf8Str &aCaptureFilename); + HRESULT detachUSBDevice(const com::Guid &aId, + BOOL aDone); + HRESULT autoCaptureUSBDevices(); + HRESULT detachAllUSBDevices(BOOL aDone); + HRESULT onSessionEnd(const ComPtr &aSession, + ComPtr &aProgress); + HRESULT finishOnlineMergeMedium(); + HRESULT pullGuestProperties(std::vector &aNames, + std::vector &aValues, + std::vector &aTimestamps, + std::vector &aFlags); + HRESULT pushGuestProperty(const com::Utf8Str &aName, + const com::Utf8Str &aValue, + LONG64 aTimestamp, + const com::Utf8Str &aFlags, + BOOL fWasDeleted); + HRESULT lockMedia(); + HRESULT unlockMedia(); + HRESULT ejectMedium(const ComPtr &aAttachment, + ComPtr &aNewAttachment); + HRESULT reportVmStatistics(ULONG aValidStats, + ULONG aCpuUser, + ULONG aCpuKernel, + ULONG aCpuIdle, + ULONG aMemTotal, + ULONG aMemFree, + ULONG aMemBalloon, + ULONG aMemShared, + ULONG aMemCache, + ULONG aPagedTotal, + ULONG aMemAllocTotal, + ULONG aMemFreeTotal, + ULONG aMemBalloonTotal, + ULONG aMemSharedTotal, + ULONG aVmNetRx, + ULONG aVmNetTx); + HRESULT authenticateExternal(const std::vector &aAuthParams, + com::Utf8Str &aResult); + +#ifdef VBOX_WITH_FULL_VM_ENCRYPTION + HRESULT i_setInaccessible(void); +#endif +}; + +// SessionMachine class +//////////////////////////////////////////////////////////////////////////////// + +/** + * @note Notes on locking objects of this class: + * SessionMachine shares some data with the primary Machine instance (pointed + * to by the |mPeer| member). In order to provide data consistency it also + * shares its lock handle. This means that whenever you lock a SessionMachine + * instance using Auto[Reader]Lock or AutoMultiLock, the corresponding Machine + * instance is also locked in the same lock mode. Keep it in mind. + */ +class ATL_NO_VTABLE SessionMachine : + public Machine +{ +public: + VIRTUALBOXBASE_ADD_ERRORINFO_SUPPORT(SessionMachine, IMachine) + + DECLARE_NOT_AGGREGATABLE(SessionMachine) + + DECLARE_PROTECT_FINAL_CONSTRUCT() + + BEGIN_COM_MAP(SessionMachine) + COM_INTERFACE_ENTRY(ISupportErrorInfo) + COM_INTERFACE_ENTRY(IMachine) + COM_INTERFACE_ENTRY2(IDispatch, IMachine) + COM_INTERFACE_ENTRY(IInternalMachineControl) + VBOX_TWEAK_INTERFACE_ENTRY(IMachine) + END_COM_MAP() + + DECLARE_COMMON_CLASS_METHODS(SessionMachine) + + HRESULT FinalConstruct(); + void FinalRelease(); + + struct Uninit + { + enum Reason { Unexpected, Abnormal, Normal }; + }; + + // public initializer/uninitializer for internal purposes only + HRESULT init(Machine *aMachine); + void uninit() { uninit(Uninit::Unexpected); } + void uninit(Uninit::Reason aReason); + + + // util::Lockable interface + RWLockHandle *lockHandle() const; + + // public methods only for internal purposes + + virtual bool i_isSessionMachine() const + { + return true; + } + +#ifndef VBOX_WITH_GENERIC_SESSION_WATCHER + bool i_checkForDeath(); + + void i_getTokenId(Utf8Str &strTokenId); +#else /* VBOX_WITH_GENERIC_SESSION_WATCHER */ + IToken *i_getToken(); +#endif /* VBOX_WITH_GENERIC_SESSION_WATCHER */ + // getClientToken must be only used by callers who can guarantee that + // the object cannot be deleted in the mean time, i.e. have a caller/lock. + ClientToken *i_getClientToken(); + + HRESULT i_onNetworkAdapterChange(INetworkAdapter *networkAdapter, BOOL changeAdapter); + HRESULT i_onNATRedirectRuleChanged(ULONG ulSlot, BOOL aNatRuleRemove, const Utf8Str &aRuleName, + NATProtocol_T aProto, const Utf8Str &aHostIp, LONG aHostPort, + const Utf8Str &aGuestIp, LONG aGuestPort) RT_OVERRIDE; + HRESULT i_onStorageControllerChange(const com::Guid &aMachineId, const com::Utf8Str &aControllerName); + HRESULT i_onMediumChange(IMediumAttachment *aMediumAttachment, BOOL aForce); + HRESULT i_onVMProcessPriorityChange(VMProcPriority_T aPriority); + HRESULT i_onAudioAdapterChange(IAudioAdapter *audioAdapter); + HRESULT i_onHostAudioDeviceChange(IHostAudioDevice *aDevice, BOOL aNew, AudioDeviceState_T aState, IVirtualBoxErrorInfo *aErrInfo); + HRESULT i_onSerialPortChange(ISerialPort *serialPort); + HRESULT i_onParallelPortChange(IParallelPort *parallelPort); + HRESULT i_onCPUChange(ULONG aCPU, BOOL aRemove); + HRESULT i_onVRDEServerChange(BOOL aRestart); + HRESULT i_onRecordingChange(BOOL aEnable); + HRESULT i_onUSBControllerChange(); + HRESULT i_onUSBDeviceAttach(IUSBDevice *aDevice, + IVirtualBoxErrorInfo *aError, + ULONG aMaskedIfs, + const com::Utf8Str &aCaptureFilename); + HRESULT i_onUSBDeviceDetach(IN_BSTR aId, + IVirtualBoxErrorInfo *aError); + HRESULT i_onSharedFolderChange(); + HRESULT i_onClipboardModeChange(ClipboardMode_T aClipboardMode); + HRESULT i_onClipboardFileTransferModeChange(BOOL aEnable); + HRESULT i_onDnDModeChange(DnDMode_T aDnDMode); + HRESULT i_onBandwidthGroupChange(IBandwidthGroup *aBandwidthGroup); + HRESULT i_onStorageDeviceChange(IMediumAttachment *aMediumAttachment, BOOL aRemove, BOOL aSilent); + HRESULT i_onCPUExecutionCapChange(ULONG aCpuExecutionCap); + HRESULT i_onGuestDebugControlChange(IGuestDebugControl *guestDebugControl); + + bool i_hasMatchingUSBFilter(const ComObjPtr &aDevice, ULONG *aMaskedIfs); + + HRESULT i_lockMedia(); + HRESULT i_unlockMedia(); + + HRESULT i_saveStateWithReason(Reason_T aReason, ComPtr &aProgress); + +private: + + // wrapped IInternalMachineControl properties + + // wrapped IInternalMachineControl methods + HRESULT setRemoveSavedStateFile(BOOL aRemove); + HRESULT updateState(MachineState_T aState); + HRESULT beginPowerUp(const ComPtr &aProgress); + HRESULT endPowerUp(LONG aResult); + HRESULT beginPoweringDown(ComPtr &aProgress); + HRESULT endPoweringDown(LONG aResult, + const com::Utf8Str &aErrMsg); + HRESULT runUSBDeviceFilters(const ComPtr &aDevice, + BOOL *aMatched, + ULONG *aMaskedInterfaces); + HRESULT captureUSBDevice(const com::Guid &aId, const com::Utf8Str &aCaptureFilename); + HRESULT detachUSBDevice(const com::Guid &aId, + BOOL aDone); + HRESULT autoCaptureUSBDevices(); + HRESULT detachAllUSBDevices(BOOL aDone); + HRESULT onSessionEnd(const ComPtr &aSession, + ComPtr &aProgress); + HRESULT finishOnlineMergeMedium(); + HRESULT pullGuestProperties(std::vector &aNames, + std::vector &aValues, + std::vector &aTimestamps, + std::vector &aFlags); + HRESULT pushGuestProperty(const com::Utf8Str &aName, + const com::Utf8Str &aValue, + LONG64 aTimestamp, + const com::Utf8Str &aFlags, + BOOL fWasDeleted); + HRESULT lockMedia(); + HRESULT unlockMedia(); + HRESULT ejectMedium(const ComPtr &aAttachment, + ComPtr &aNewAttachment); + HRESULT reportVmStatistics(ULONG aValidStats, + ULONG aCpuUser, + ULONG aCpuKernel, + ULONG aCpuIdle, + ULONG aMemTotal, + ULONG aMemFree, + ULONG aMemBalloon, + ULONG aMemShared, + ULONG aMemCache, + ULONG aPagedTotal, + ULONG aMemAllocTotal, + ULONG aMemFreeTotal, + ULONG aMemBalloonTotal, + ULONG aMemSharedTotal, + ULONG aVmNetRx, + ULONG aVmNetTx); + HRESULT authenticateExternal(const std::vector &aAuthParams, + com::Utf8Str &aResult); + + + struct ConsoleTaskData + { + ConsoleTaskData() + : mLastState(MachineState_Null), + mDeleteSnapshotInfo(NULL) + { } + + MachineState_T mLastState; + ComObjPtr mProgress; + + // used when deleting online snaphshot + void *mDeleteSnapshotInfo; + }; + + class SaveStateTask; + class SnapshotTask; + class TakeSnapshotTask; + class DeleteSnapshotTask; + class RestoreSnapshotTask; + + void i_saveStateHandler(SaveStateTask &aTask); + + // Override some functionality for SessionMachine, this is where the + // real action happens (the Machine methods are just dummies). + HRESULT saveState(ComPtr &aProgress); + HRESULT adoptSavedState(const com::Utf8Str &aSavedStateFile); + HRESULT discardSavedState(BOOL aFRemoveFile); + HRESULT takeSnapshot(const com::Utf8Str &aName, + const com::Utf8Str &aDescription, + BOOL aPause, + com::Guid &aId, + ComPtr &aProgress); + HRESULT deleteSnapshot(const com::Guid &aId, + ComPtr &aProgress); + HRESULT deleteSnapshotAndAllChildren(const com::Guid &aId, + ComPtr &aProgress); + HRESULT deleteSnapshotRange(const com::Guid &aStartId, + const com::Guid &aEndId, + ComPtr &aProgress); + HRESULT restoreSnapshot(const ComPtr &aSnapshot, + ComPtr &aProgress); + + void i_releaseSavedStateFile(const Utf8Str &strSavedStateFile, Snapshot *pSnapshotToIgnore); + + void i_takeSnapshotHandler(TakeSnapshotTask &aTask); + static void i_takeSnapshotProgressCancelCallback(void *pvUser); + HRESULT i_finishTakingSnapshot(TakeSnapshotTask &aTask, AutoWriteLock &alock, bool aSuccess); + HRESULT i_deleteSnapshot(const com::Guid &aStartId, + const com::Guid &aEndId, + BOOL aDeleteAllChildren, + ComPtr &aProgress); + void i_deleteSnapshotHandler(DeleteSnapshotTask &aTask); + void i_restoreSnapshotHandler(RestoreSnapshotTask &aTask); + + HRESULT i_prepareDeleteSnapshotMedium(const ComObjPtr &aHD, + const Guid &machineId, + const Guid &snapshotId, + bool fOnlineMergePossible, + MediumLockList *aVMMALockList, + ComObjPtr &aSource, + ComObjPtr &aTarget, + bool &fMergeForward, + ComObjPtr &pParentForTarget, + MediumLockList * &aChildrenToReparent, + bool &fNeedOnlineMerge, + MediumLockList * &aMediumLockList, + ComPtr &aHDLockToken); + void i_cancelDeleteSnapshotMedium(const ComObjPtr &aHD, + const ComObjPtr &aSource, + MediumLockList *aChildrenToReparent, + bool fNeedsOnlineMerge, + MediumLockList *aMediumLockList, + const ComPtr &aHDLockToken, + const Guid &aMediumId, + const Guid &aSnapshotId); + HRESULT i_onlineMergeMedium(const ComObjPtr &aMediumAttachment, + const ComObjPtr &aSource, + const ComObjPtr &aTarget, + bool fMergeForward, + const ComObjPtr &pParentForTarget, + MediumLockList *aChildrenToReparent, + MediumLockList *aMediumLockList, + ComObjPtr &aProgress, + bool *pfNeedsMachineSaveSettings); + + HRESULT i_setMachineState(MachineState_T aMachineState); + HRESULT i_updateMachineStateOnClient(); + + bool mRemoveSavedState; + + ConsoleTaskData mConsoleTaskData; + + /** client token for this machine */ + ClientToken *mClientToken; + + int miNATNetworksStarted; + + AUTHLIBRARYCONTEXT mAuthLibCtx; +}; + +// SnapshotMachine class +//////////////////////////////////////////////////////////////////////////////// + +/** + * @note Notes on locking objects of this class: + * SnapshotMachine shares some data with the primary Machine instance (pointed + * to by the |mPeer| member). In order to provide data consistency it also + * shares its lock handle. This means that whenever you lock a SessionMachine + * instance using Auto[Reader]Lock or AutoMultiLock, the corresponding Machine + * instance is also locked in the same lock mode. Keep it in mind. + */ +class ATL_NO_VTABLE SnapshotMachine : + public Machine +{ +public: + VIRTUALBOXBASE_ADD_ERRORINFO_SUPPORT(SnapshotMachine, IMachine) + + DECLARE_NOT_AGGREGATABLE(SnapshotMachine) + + DECLARE_PROTECT_FINAL_CONSTRUCT() + + BEGIN_COM_MAP(SnapshotMachine) + COM_INTERFACE_ENTRY(ISupportErrorInfo) + COM_INTERFACE_ENTRY(IMachine) + COM_INTERFACE_ENTRY2(IDispatch, IMachine) + VBOX_TWEAK_INTERFACE_ENTRY(IMachine) + END_COM_MAP() + + DECLARE_COMMON_CLASS_METHODS(SnapshotMachine) + + HRESULT FinalConstruct(); + void FinalRelease(); + + // public initializer/uninitializer for internal purposes only + HRESULT init(SessionMachine *aSessionMachine, + IN_GUID aSnapshotId, + const Utf8Str &aStateFilePath); + HRESULT initFromSettings(Machine *aMachine, + const settings::Hardware &hardware, + const settings::Debugging *pDbg, + const settings::Autostart *pAutostart, + const settings::RecordingSettings &recording, + IN_GUID aSnapshotId, + const Utf8Str &aStateFilePath); + void uninit(); + + // util::Lockable interface + RWLockHandle *lockHandle() const; + + // public methods only for internal purposes + + virtual bool i_isSnapshotMachine() const + { + return true; + } + + HRESULT i_onSnapshotChange(Snapshot *aSnapshot); + + // unsafe inline public methods for internal purposes only (ensure there is + // a caller and a read lock before calling them!) + + const Guid& i_getSnapshotId() const { return mSnapshotId; } + +private: + + Guid mSnapshotId; + /** This field replaces mPeer for SessionMachine instances, as having + * a peer reference is plain meaningless and causes many subtle problems + * with saving settings and the like. */ + Machine * const mMachine; + + friend class Snapshot; +}; + +// third party methods that depend on SnapshotMachine definition + +inline const Guid &Machine::i_getSnapshotId() const +{ + return (i_isSnapshotMachine()) + ? static_cast(this)->i_getSnapshotId() + : Guid::Empty; +} + + +#endif /* !MAIN_INCLUDED_MachineImpl_h */ +/* vi: set tabstop=4 shiftwidth=4 expandtab: */ -- cgit v1.2.3