/* $Id: MachineImpl.h 13356 2008-10-16 18:44:34Z vboxsync $ */ /** @file * * VirtualBox COM class declaration */ /* * Copyright (C) 2006-2007 Sun Microsystems, Inc. * * This file is part of VirtualBox Open Source Edition (OSE), as * available from http://www.virtualbox.org. This file is free software; * you can redistribute it and/or modify it under the terms of the GNU * General Public License (GPL) as published by the Free Software * Foundation, in version 2 as it comes in the "COPYING" file of the * VirtualBox OSE distribution. VirtualBox OSE is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind. * * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa * Clara, CA 95054 USA or visit http://www.sun.com if you need * additional information or have any questions. */ #ifndef ____H_MACHINEIMPL #define ____H_MACHINEIMPL #include "VirtualBoxBase.h" #include "ProgressImpl.h" #include "SnapshotImpl.h" #include "VRDPServerImpl.h" #include "DVDDriveImpl.h" #include "FloppyDriveImpl.h" #include "HardDiskAttachmentImpl.h" #include "Collection.h" #include "NetworkAdapterImpl.h" #include "AudioAdapterImpl.h" #include "SerialPortImpl.h" #include "ParallelPortImpl.h" #include "BIOSSettingsImpl.h" #include "SATAControllerImpl.h" #ifdef VBOX_WITH_RESOURCE_USAGE_API #include "PerformanceImpl.h" #endif /* VBOX_WITH_RESOURCE_USAGE_API */ // generated header #include "SchemaDefs.h" #include #include #include #include #include // defines //////////////////////////////////////////////////////////////////////////////// // helper declarations //////////////////////////////////////////////////////////////////////////////// class VirtualBox; class Progress; class CombinedProgress; class Keyboard; class Mouse; class Display; class MachineDebugger; class USBController; class Snapshot; class SharedFolder; class HostUSBDevice; class SessionMachine; // Machine class //////////////////////////////////////////////////////////////////////////////// class ATL_NO_VTABLE Machine : public VirtualBoxBaseWithChildrenNEXT, public VirtualBoxSupportErrorInfoImpl , public VirtualBoxSupportTranslation , public IMachine { Q_OBJECT public: /** * 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 { /** Control of the direct session opened by openSession() */ ComPtr mDirectControl; typedef std::list > RemoteControlList; /** list of controls of all opened remote sessions */ RemoteControlList mRemoteControls; /** openRemoteSession() and OnSessionEnd() progress indicator */ ComObjPtr mProgress; /** * PID of the session object that must be passed to openSession() * to finalize the openRemoteSession() request * (i.e., PID of the process created by openRemoteSession()) */ RTPROCESS mPid; /** Current session state */ SessionState_T mState; /** Session type string (for indirect sessions) */ Bstr mType; /** Sesison machine object */ ComObjPtr mMachine; }; Data(); ~Data(); const Guid mUuid; BOOL mRegistered; Bstr mConfigFile; Bstr mConfigFileFull; Utf8Str mSettingsFileVersion; 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; RTFILE mHandleCfgFile; Session mSession; ComObjPtr mFirstSnapshot; ComObjPtr mCurrentSnapshot; }; /** * Saved state data. * * It's actually only the state file path string, 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 { Bstr mStateFilePath; }; /** * 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 { UserData(); ~UserData(); bool operator== (const UserData &that) const { return this == &that || (mName == that.mName && mNameSync == that.mNameSync && mDescription == that.mDescription && mOSTypeId == that.mOSTypeId && mSnapshotFolderFull == that.mSnapshotFolderFull); } Bstr mName; BOOL mNameSync; Bstr mDescription; Bstr mOSTypeId; Bstr mSnapshotFolder; Bstr mSnapshotFolderFull; }; /** * 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. */ struct HWData { /** * Data structure to hold information about a guest property. */ struct GuestProperty { /** Property name */ Bstr mName; /** Property value */ Bstr mValue; /** Property timestamp */ ULONG64 mTimestamp; /** Property flags */ ULONG mFlags; }; HWData(); ~HWData(); bool operator== (const HWData &that) const; ULONG mMemorySize; ULONG mMemoryBalloonSize; ULONG mStatisticsUpdateInterval; ULONG mVRAMSize; ULONG mMonitorCount; TSBool_T mHWVirtExEnabled; BOOL mHWVirtExNestedPagingEnabled; BOOL mHWVirtExVPIDEnabled; BOOL mPAEEnabled; DeviceType_T mBootOrder [SchemaDefs::MaxBootPosition]; typedef std::list > SharedFolderList; SharedFolderList mSharedFolders; ClipboardMode_T mClipboardMode; typedef std::list GuestPropertyList; GuestPropertyList mGuestProperties; BOOL mPropertyServiceActive; }; /** * Hard disk data. * * The usage policy is the same as for HWData, but a separate structure * is necessarym because hard disk data requires different procedures when * taking or discarding snapshots, etc. * * The data variable is |mHWData|. */ struct HDData { HDData(); ~HDData(); bool operator== (const HDData &that) const; typedef std::list > HDAttachmentList; HDAttachmentList mHDAttachments; /** * Right after Machine::fixupHardDisks(true): |true| if hard disks * were actually changed, |false| otherwise */ bool mHDAttachmentsChanged; }; enum StateDependency { AnyStateDep = 0, MutableStateDep, MutableOrSavedStateDep }; /** * Helper class that safely manages the machine state dependency by * calling Machine::addStateDependency() on construction and * Machine::releaseStateDependency() on destruction. Intended for Machine * children. The usage pattern is: * * @code * AutoCaller autoCaller (this); * CheckComRCReturnRC (autoCaller.rc()); * * Machine::AutoStateDependency adep (mParent); * CheckComRCReturnRC (stateDep.rc()); * ... * // code that depends on the particular machine state * ... * @endcode * * Note that it is more convenient to use the following individual * shortcut classes instead of using this template directly: * AutoAnyStateDependency, AutoMutableStateDependency and * AutoMutableOrSavedStateDependency. The usage pattern is exactly the * same as above except that there is no need to specify the template * argument because it is already done by the shortcut class. * * @param taDepType Dependecy type to manage. */ template class AutoStateDependency { public: AutoStateDependency (Machine *aThat) : mThat (aThat), mRC (S_OK) , mMachineState (MachineState_Null) , mRegistered (FALSE) { Assert (aThat); mRC = aThat->addStateDependency (taDepType, &mMachineState, &mRegistered); } ~AutoStateDependency() { if (SUCCEEDED (mRC)) mThat->releaseStateDependency(); } /** Decreases the number of dependencies before the instance is * destroyed. Note that will reset #rc() to E_FAIL. */ void release() { AssertReturnVoid (SUCCEEDED (mRC)); mThat->releaseStateDependency(); mRC = E_FAIL; } /** Restores the number of callers after by #release(). #rc() will be * reset to the result of calling addStateDependency() and must be * rechecked to ensure the operation succeeded. */ void add() { AssertReturnVoid (!SUCCEEDED (mRC)); mRC = mThat->addStateDependency (taDepType, &mMachineState, &mRegistered); } /** Returns the result of Machine::addStateDependency(). */ HRESULT rc() const { return mRC; } /** Shortcut to SUCCEEDED (rc()). */ bool isOk() const { return SUCCEEDED (mRC); } /** Returns the machine state value as returned by * Machine::addStateDependency(). */ MachineState_T machineState() const { return mMachineState; } /** Returns the machine state value as returned by * Machine::addStateDependency(). */ BOOL machineRegistered() const { return mRegistered; } protected: Machine *mThat; HRESULT mRC; MachineState_T mMachineState; BOOL mRegistered; private: DECLARE_CLS_COPY_CTOR_ASSIGN_NOOP (AutoStateDependency) DECLARE_CLS_NEW_DELETE_NOOP (AutoStateDependency) }; /** * Shortcut to AutoStateDependency . * See AutoStateDependency to get the usage pattern. * * Accepts any machine state and guarantees the state won't change before * this object is destroyed. If the machine state cannot be protected (as * a result of the state change currently in progress), this instance's * #rc() method will indicate a failure, and the caller is not allowed to * rely on any particular machine state and should return the failed * result code to the upper level. */ typedef AutoStateDependency AutoAnyStateDependency; /** * Shortcut to AutoStateDependency . * See AutoStateDependency to get the usage pattern. * * Succeeds only if the machine state is in one of the mutable states, and * guarantees the given mutable state won't change before this object is * destroyed. If the machine is not mutable, this instance's #rc() method * will indicate a failure, and the caller is not allowed to rely on any * particular machine state and should return the failed result code to * the upper level. * * Intended to be used within all setter methods of IMachine * children objects (DVDDrive, NetworkAdapter, AudioAdapter, etc.) to * provide data protection and consistency. */ typedef AutoStateDependency AutoMutableStateDependency; /** * Shortcut to AutoStateDependency . * See AutoStateDependency to get the usage pattern. * * Succeeds only if the machine state is in one of the mutable states, or * if the machine is in the Saved state, and guarantees the given mutable * state won't change before this object is destroyed. If the machine is * not mutable, this instance's #rc() method will indicate a failure, and * the caller is not allowed to rely on any particular machine state and * should return the failed result code to the upper level. * * Intended to be used within setter methods of IMachine * children objects that may also operate on Saved machines. */ typedef AutoStateDependency AutoMutableOrSavedStateDependency; VIRTUALBOXBASE_ADD_ERRORINFO_SUPPORT (Machine) DECLARE_NOT_AGGREGATABLE(Machine) DECLARE_PROTECT_FINAL_CONSTRUCT() BEGIN_COM_MAP(Machine) COM_INTERFACE_ENTRY(ISupportErrorInfo) COM_INTERFACE_ENTRY(IMachine) END_COM_MAP() NS_DECL_ISUPPORTS DECLARE_EMPTY_CTOR_DTOR (Machine) HRESULT FinalConstruct(); void FinalRelease(); enum InitMode { Init_New, Init_Existing, Init_Registered }; // public initializer/uninitializer for internal purposes only HRESULT init (VirtualBox *aParent, const BSTR aConfigFile, InitMode aMode, const BSTR aName = NULL, BOOL aNameSync = TRUE, const Guid *aId = NULL); void uninit(); // IMachine properties STDMETHOD(COMGETTER(Parent))(IVirtualBox **aParent); STDMETHOD(COMGETTER(Accessible)) (BOOL *aAccessible); STDMETHOD(COMGETTER(AccessError)) (IVirtualBoxErrorInfo **aAccessError); STDMETHOD(COMGETTER(Name))(BSTR *aName); STDMETHOD(COMSETTER(Name))(INPTR BSTR aName); STDMETHOD(COMGETTER(Description))(BSTR *aDescription); STDMETHOD(COMSETTER(Description))(INPTR BSTR aDescription); STDMETHOD(COMGETTER(Id))(GUIDPARAMOUT aId); STDMETHOD(COMGETTER(OSTypeId)) (BSTR *aOSTypeId); STDMETHOD(COMSETTER(OSTypeId)) (INPTR BSTR aOSTypeId); STDMETHOD(COMGETTER(MemorySize))(ULONG *memorySize); STDMETHOD(COMSETTER(MemorySize))(ULONG memorySize); STDMETHOD(COMGETTER(MemoryBalloonSize))(ULONG *memoryBalloonSize); STDMETHOD(COMSETTER(MemoryBalloonSize))(ULONG memoryBalloonSize); STDMETHOD(COMGETTER(StatisticsUpdateInterval))(ULONG *statisticsUpdateInterval); STDMETHOD(COMSETTER(StatisticsUpdateInterval))(ULONG statisticsUpdateInterval); STDMETHOD(COMGETTER(VRAMSize))(ULONG *memorySize); STDMETHOD(COMSETTER(VRAMSize))(ULONG memorySize); STDMETHOD(COMGETTER(MonitorCount))(ULONG *monitorCount); STDMETHOD(COMSETTER(MonitorCount))(ULONG monitorCount); STDMETHOD(COMGETTER(BIOSSettings))(IBIOSSettings **biosSettings); STDMETHOD(COMGETTER(HWVirtExEnabled))(TSBool_T *enabled); STDMETHOD(COMSETTER(HWVirtExEnabled))(TSBool_T enabled); STDMETHOD(COMGETTER(HWVirtExNestedPagingEnabled))(BOOL *enabled); STDMETHOD(COMSETTER(HWVirtExNestedPagingEnabled))(BOOL enabled); STDMETHOD(COMGETTER(HWVirtExVPIDEnabled))(BOOL *enabled); STDMETHOD(COMSETTER(HWVirtExVPIDEnabled))(BOOL enabled); STDMETHOD(COMGETTER(PAEEnabled))(BOOL *enabled); STDMETHOD(COMSETTER(PAEEnabled))(BOOL enabled); STDMETHOD(COMGETTER(SnapshotFolder))(BSTR *aSavedStateFolder); STDMETHOD(COMSETTER(SnapshotFolder))(INPTR BSTR aSavedStateFolder); STDMETHOD(COMGETTER(HardDiskAttachments))(IHardDiskAttachmentCollection **attachments); STDMETHOD(COMGETTER(VRDPServer))(IVRDPServer **vrdpServer); STDMETHOD(COMGETTER(DVDDrive))(IDVDDrive **dvdDrive); STDMETHOD(COMGETTER(FloppyDrive))(IFloppyDrive **floppyDrive); STDMETHOD(COMGETTER(AudioAdapter))(IAudioAdapter **audioAdapter); STDMETHOD(COMGETTER(USBController)) (IUSBController * *aUSBController); STDMETHOD(COMGETTER(SATAController)) (ISATAController **aSATAController); STDMETHOD(COMGETTER(SettingsFilePath)) (BSTR *aFilePath); STDMETHOD(COMGETTER(SettingsFileVersion)) (BSTR *aSettingsFileVersion); STDMETHOD(COMGETTER(SettingsModified)) (BOOL *aModified); STDMETHOD(COMGETTER(SessionState)) (SessionState_T *aSessionState); STDMETHOD(COMGETTER(SessionType)) (BSTR *aSessionType); STDMETHOD(COMGETTER(SessionPid)) (ULONG *aSessionPid); STDMETHOD(COMGETTER(State)) (MachineState_T *machineState); STDMETHOD(COMGETTER(LastStateChange)) (LONG64 *aLastStateChange); STDMETHOD(COMGETTER(StateFilePath)) (BSTR *aStateFilePath); STDMETHOD(COMGETTER(LogFolder)) (BSTR *aLogFolder); STDMETHOD(COMGETTER(CurrentSnapshot)) (ISnapshot **aCurrentSnapshot); STDMETHOD(COMGETTER(SnapshotCount)) (ULONG *aSnapshotCount); STDMETHOD(COMGETTER(CurrentStateModified))(BOOL *aCurrentStateModified); STDMETHOD(COMGETTER(SharedFolders)) (ISharedFolderCollection **aSharedFolders); STDMETHOD(COMGETTER(ClipboardMode)) (ClipboardMode_T *aClipboardMode); STDMETHOD(COMSETTER(ClipboardMode)) (ClipboardMode_T aClipboardMode); // IMachine methods STDMETHOD(SetBootOrder)(ULONG aPosition, DeviceType_T aDevice); STDMETHOD(GetBootOrder)(ULONG aPosition, DeviceType_T *aDevice); STDMETHOD(AttachHardDisk)(INPTR GUIDPARAM aId, StorageBus_T aBus, LONG aChannel, LONG aDevice); STDMETHOD(GetHardDisk)(StorageBus_T aBus, LONG aChannel, LONG aDevice, IHardDisk **aHardDisk); STDMETHOD(DetachHardDisk) (StorageBus_T aBus, LONG aChannel, LONG aDevice); STDMETHOD(GetSerialPort) (ULONG slot, ISerialPort **port); STDMETHOD(GetParallelPort) (ULONG slot, IParallelPort **port); STDMETHOD(GetNetworkAdapter) (ULONG slot, INetworkAdapter **adapter); STDMETHOD(GetNextExtraDataKey)(INPTR BSTR aKey, BSTR *aNextKey, BSTR *aNextValue); STDMETHOD(GetExtraData)(INPTR BSTR aKey, BSTR *aValue); STDMETHOD(SetExtraData)(INPTR BSTR aKey, INPTR BSTR aValue); STDMETHOD(SaveSettings)(); STDMETHOD(SaveSettingsWithBackup) (BSTR *aBakFileName); STDMETHOD(DiscardSettings)(); STDMETHOD(DeleteSettings)(); STDMETHOD(GetSnapshot) (INPTR GUIDPARAM aId, ISnapshot **aSnapshot); STDMETHOD(FindSnapshot) (INPTR BSTR aName, ISnapshot **aSnapshot); STDMETHOD(SetCurrentSnapshot) (INPTR GUIDPARAM aId); STDMETHOD(CreateSharedFolder) (INPTR BSTR aName, INPTR BSTR aHostPath, BOOL aWritable); STDMETHOD(RemoveSharedFolder) (INPTR BSTR aName); STDMETHOD(CanShowConsoleWindow) (BOOL *aCanShow); STDMETHOD(ShowConsoleWindow) (ULONG64 *aWinId); STDMETHOD(GetGuestProperty) (INPTR BSTR aName, BSTR *aValue, ULONG64 *aTimestamp, BSTR *aFlags); STDMETHOD(GetGuestPropertyValue) (INPTR BSTR aName, BSTR *aValue); STDMETHOD(GetGuestPropertyTimestamp) (INPTR BSTR aName, ULONG64 *aTimestamp); STDMETHOD(SetGuestProperty) (INPTR BSTR aName, INPTR BSTR aValue, INPTR BSTR aFlags); STDMETHOD(SetGuestPropertyValue) (INPTR BSTR aName, INPTR BSTR aValue); STDMETHOD(EnumerateGuestProperties) (INPTR BSTR aPattern, ComSafeArrayOut(BSTR, aNames), ComSafeArrayOut(BSTR, aValues), ComSafeArrayOut(ULONG64, aTimestamps), ComSafeArrayOut(BSTR, aFlags)); // public methods only for internal purposes /// @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 isRegistered() { return !!mData->mRegistered; } ComObjPtr sessionMachine(); /** * Returns the VirtualBox object this machine belongs to. * * @note This method doesn't check this object's readiness as it is * intended to be used only by Machine children where it is guaranteed * that this object still exists in memory. */ const ComObjPtr &virtualBox() const { return mParent; } /** * Returns this machine's name. * * @note This method doesn't check this object's readiness as it is * intended to be used only after adding a caller to this object (that * guarantees that the object is ready or at least limited). */ const Guid &uuid() const { return mData->mUuid; } /** * Returns this machine's full settings file path. * * @note This method doesn't lock this object or check its readiness as * it is intended to be used only after adding a caller to this object * (that guarantees that the object is ready) and locking it for reading. */ const Bstr &settingsFileFull() const { return mData->mConfigFileFull; } /** * Returns this machine's name. * * @note This method doesn't lock this object or check its readiness as * it is intended to be used only after adding a caller to this object * (that guarantees that the object is ready) and locking it for reading. */ const Bstr &name() const { return mUserData->mName; } // callback handlers virtual HRESULT onDVDDriveChange() { return S_OK; } virtual HRESULT onFloppyDriveChange() { return S_OK; } virtual HRESULT onNetworkAdapterChange(INetworkAdapter *networkAdapter) { return S_OK; } virtual HRESULT onSerialPortChange(ISerialPort *serialPort) { return S_OK; } virtual HRESULT onParallelPortChange(IParallelPort *ParallelPort) { return S_OK; } virtual HRESULT onVRDPServerChange() { return S_OK; } virtual HRESULT onUSBControllerChange() { return S_OK; } virtual HRESULT onSATAControllerChange() { return S_OK; } virtual HRESULT onSharedFolderChange() { return S_OK; } HRESULT saveRegistryEntry (settings::Key &aEntryNode); int calculateFullPath (const char *aPath, Utf8Str &aResult); void calculateRelativePath (const char *aPath, Utf8Str &aResult); void getLogFolder (Utf8Str &aLogFolder); bool isDVDImageUsed (const Guid &aId, ResourceUsage_T aUsage); bool isFloppyImageUsed (const Guid &aId, ResourceUsage_T aUsage); HRESULT openSession (IInternalSessionControl *aControl); HRESULT openRemoteSession (IInternalSessionControl *aControl, INPTR BSTR aType, INPTR BSTR aEnvironment, Progress *aProgress); HRESULT openExistingSession (IInternalSessionControl *aControl); HRESULT trySetRegistered (BOOL aRegistered); HRESULT getSharedFolder (const BSTR aName, ComObjPtr &aSharedFolder, bool aSetError = false) { AutoWriteLock alock (this); return findSharedFolder (aName, aSharedFolder, aSetError); } HRESULT addStateDependency (StateDependency aDepType = AnyStateDep, MachineState_T *aState = NULL, BOOL *aRegistered = NULL); void releaseStateDependency(); // for VirtualBoxSupportErrorInfoImpl static const wchar_t *getComponentName() { return L"Machine"; } protected: enum InstanceType { IsMachine, IsSessionMachine, IsSnapshotMachine }; HRESULT registeredInit(); HRESULT checkStateDependency (StateDependency aDepType); inline Machine *machine(); HRESULT initDataAndChildObjects(); void uninitDataAndChildObjects(); void ensureNoStateDependencies (AutoWriteLock &aLock); virtual HRESULT setMachineState (MachineState_T aMachineState); HRESULT findSharedFolder (const BSTR aName, ComObjPtr &aSharedFolder, bool aSetError = false); HRESULT loadSettings (bool aRegistered); HRESULT loadSnapshot (const settings::Key &aNode, const Guid &aCurSnapshotId, Snapshot *aParentSnapshot); HRESULT loadHardware (const settings::Key &aNode); HRESULT loadHardDisks (const settings::Key &aNode, bool aRegistered, const Guid *aSnapshotId = NULL); HRESULT findSnapshotNode (Snapshot *aSnapshot, settings::Key &aMachineNode, settings::Key *aSnapshotsNode, settings::Key *aSnapshotNode); HRESULT findSnapshot (const Guid &aId, ComObjPtr &aSnapshot, bool aSetError = false); HRESULT findSnapshot (const BSTR aName, ComObjPtr &aSnapshot, bool aSetError = false); HRESULT findHardDiskAttachment (const ComObjPtr &aHd, ComObjPtr *aMachine, ComObjPtr *aSnapshot, ComObjPtr *aHda); HRESULT prepareSaveSettings (bool &aRenamed, bool &aNew); HRESULT saveSettings (bool aMarkCurStateAsModified = true, bool aInformCallbacksAnyway = false); enum { // ops for #saveSnapshotSettings() SaveSS_NoOp = 0x00, SaveSS_AddOp = 0x01, SaveSS_UpdateAttrsOp = 0x02, SaveSS_UpdateAllOp = 0x03, SaveSS_OpMask = 0xF, // flags for #saveSnapshotSettings() SaveSS_UpdateCurStateModified = 0x40, SaveSS_UpdateCurrentId = 0x80, // flags for #saveStateSettings() SaveSTS_CurStateModified = 0x20, SaveSTS_StateFilePath = 0x40, SaveSTS_StateTimeStamp = 0x80, }; HRESULT saveSnapshotSettings (Snapshot *aSnapshot, int aOpFlags); HRESULT saveSnapshotSettingsWorker (settings::Key &aMachineNode, Snapshot *aSnapshot, int aOpFlags); HRESULT saveSnapshot (settings::Key &aNode, Snapshot *aSnapshot, bool aAttrsOnly); HRESULT saveHardware (settings::Key &aNode); HRESULT saveHardDisks (settings::Key &aNode); HRESULT saveStateSettings (int aFlags); HRESULT wipeOutImmutableDiffs(); HRESULT fixupHardDisks (bool aCommit); HRESULT createSnapshotDiffs (const Guid *aSnapshotId, const Bstr &aFolder, const ComObjPtr &aProgress, bool aOnline); HRESULT deleteSnapshotDiffs (const ComObjPtr &aSnapshot); HRESULT lockConfig(); HRESULT unlockConfig(); /** @note This method is not thread safe */ BOOL isConfigLocked() { return !!mData && mData->mHandleCfgFile != NIL_RTFILE; } bool isInOwnDir (Utf8Str *aSettingsDir = NULL); bool isModified(); bool isReallyModified (bool aIgnoreUserData = false); void rollback (bool aNotify); HRESULT commit(); void copyFrom (Machine *aThat); #ifdef VBOX_WITH_RESOURCE_USAGE_API void registerMetrics (PerformanceCollector *aCollector, Machine *aMachine, RTPROCESS pid); void unregisterMetrics (PerformanceCollector *aCollector, Machine *aMachine); #endif /* VBOX_WITH_RESOURCE_USAGE_API */ const InstanceType mType; const ComObjPtr mPeer; const ComObjPtr mParent; Shareable mData; Shareable mSSData; Backupable mUserData; Backupable mHWData; Backupable mHDData; // the following fields need special backup/rollback/commit handling, // so they cannot be a part of HWData const ComObjPtr mVRDPServer; const ComObjPtr mDVDDrive; const ComObjPtr mFloppyDrive; const ComObjPtr mSerialPorts [SchemaDefs::SerialPortCount]; const ComObjPtr mParallelPorts [SchemaDefs::ParallelPortCount]; const ComObjPtr mAudioAdapter; const ComObjPtr mUSBController; const ComObjPtr mSATAController; const ComObjPtr mBIOSSettings; const ComObjPtr mNetworkAdapters [SchemaDefs::NetworkAdapterCount]; friend class SessionMachine; friend class SnapshotMachine; }; // 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 VirtualBoxSupportTranslation , public Machine, public IInternalMachineControl { public: VIRTUALBOXSUPPORTTRANSLATION_OVERRIDE(SessionMachine) DECLARE_NOT_AGGREGATABLE(SessionMachine) DECLARE_PROTECT_FINAL_CONSTRUCT() BEGIN_COM_MAP(SessionMachine) COM_INTERFACE_ENTRY(ISupportErrorInfo) COM_INTERFACE_ENTRY(IMachine) COM_INTERFACE_ENTRY(IInternalMachineControl) END_COM_MAP() NS_DECL_ISUPPORTS DECLARE_EMPTY_CTOR_DTOR (SessionMachine) HRESULT FinalConstruct(); void FinalRelease(); // public initializer/uninitializer for internal purposes only HRESULT init (Machine *aMachine); void uninit() { uninit (Uninit::Unexpected); } // util::Lockable interface RWLockHandle *lockHandle() const; // IInternalMachineControl methods STDMETHOD(UpdateState)(MachineState_T machineState); STDMETHOD(GetIPCId)(BSTR *id); STDMETHOD(RunUSBDeviceFilters) (IUSBDevice *aUSBDevice, BOOL *aMatched, ULONG *aMaskedIfs); STDMETHOD(CaptureUSBDevice) (INPTR GUIDPARAM aId); STDMETHOD(DetachUSBDevice) (INPTR GUIDPARAM aId, BOOL aDone); STDMETHOD(AutoCaptureUSBDevices)(); STDMETHOD(DetachAllUSBDevices)(BOOL aDone); STDMETHOD(OnSessionEnd)(ISession *aSession, IProgress **aProgress); STDMETHOD(BeginSavingState) (IProgress *aProgress, BSTR *aStateFilePath); STDMETHOD(EndSavingState) (BOOL aSuccess); STDMETHOD(AdoptSavedState) (INPTR BSTR aSavedStateFile); STDMETHOD(BeginTakingSnapshot) (IConsole *aInitiator, INPTR BSTR aName, INPTR BSTR aDescription, IProgress *aProgress, BSTR *aStateFilePath, IProgress **aServerProgress); STDMETHOD(EndTakingSnapshot) (BOOL aSuccess); STDMETHOD(DiscardSnapshot) (IConsole *aInitiator, INPTR GUIDPARAM aId, MachineState_T *aMachineState, IProgress **aProgress); STDMETHOD(DiscardCurrentState) ( IConsole *aInitiator, MachineState_T *aMachineState, IProgress **aProgress); STDMETHOD(DiscardCurrentSnapshotAndState) ( IConsole *aInitiator, MachineState_T *aMachineState, IProgress **aProgress); STDMETHOD(PullGuestProperties) (ComSafeArrayOut(BSTR, aNames), ComSafeArrayOut(BSTR, aValues), ComSafeArrayOut(ULONG64, aTimestamps), ComSafeArrayOut(BSTR, aFlags)); STDMETHOD(PushGuestProperties) (ComSafeArrayIn(INPTR BSTR, aNames), ComSafeArrayIn(INPTR BSTR, aValues), ComSafeArrayIn(ULONG64, aTimestamps), ComSafeArrayIn(INPTR BSTR, aFlags)); STDMETHOD(PushGuestProperty) (INPTR BSTR aName, INPTR BSTR aValue, ULONG64 aTimestamp, INPTR BSTR aFlags); // public methods only for internal purposes bool checkForDeath(); #if defined (RT_OS_WINDOWS) HANDLE ipcSem() { return mIPCSem; } #elif defined (RT_OS_OS2) HMTX ipcSem() { return mIPCSem; } #endif HRESULT onDVDDriveChange(); HRESULT onFloppyDriveChange(); HRESULT onNetworkAdapterChange(INetworkAdapter *networkAdapter); HRESULT onSerialPortChange(ISerialPort *serialPort); HRESULT onParallelPortChange(IParallelPort *parallelPort); HRESULT onVRDPServerChange(); HRESULT onUSBControllerChange(); HRESULT onUSBDeviceAttach (IUSBDevice *aDevice, IVirtualBoxErrorInfo *aError, ULONG aMaskedIfs); HRESULT onUSBDeviceDetach (INPTR GUIDPARAM aId, IVirtualBoxErrorInfo *aError); HRESULT onSharedFolderChange(); bool hasMatchingUSBFilter (const ComObjPtr &aDevice, ULONG *aMaskedIfs); private: struct SnapshotData { SnapshotData() : mLastState (MachineState_Null) {} MachineState_T mLastState; // used when taking snapshot ComObjPtr mSnapshot; ComObjPtr mServerProgress; ComObjPtr mCombinedProgress; // used when saving state Guid mProgressId; Bstr mStateFilePath; }; struct Uninit { enum Reason { Unexpected, Abnormal, Normal }; }; struct Task; struct TakeSnapshotTask; struct DiscardSnapshotTask; struct DiscardCurrentStateTask; friend struct TakeSnapshotTask; friend struct DiscardSnapshotTask; friend struct DiscardCurrentStateTask; void uninit (Uninit::Reason aReason); HRESULT endSavingState (BOOL aSuccess); HRESULT endTakingSnapshot (BOOL aSuccess); typedef std::map , MachineState_T> AffectedMachines; void takeSnapshotHandler (TakeSnapshotTask &aTask); void discardSnapshotHandler (DiscardSnapshotTask &aTask); void discardCurrentStateHandler (DiscardCurrentStateTask &aTask); HRESULT setMachineState (MachineState_T aMachineState); HRESULT updateMachineStateOnClient(); SnapshotData mSnapshotData; /** interprocess semaphore handle (id) for this machine */ #if defined(RT_OS_WINDOWS) HANDLE mIPCSem; Bstr mIPCSemName; #elif defined(RT_OS_OS2) HMTX mIPCSem; Bstr mIPCSemName; #elif defined(VBOX_WITH_SYS_V_IPC_SESSION_WATCHER) int mIPCSem; #else # error "Port me!" #endif static DECLCALLBACK(int) taskHandler (RTTHREAD thread, void *pvUser); }; // 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 VirtualBoxSupportTranslation , public Machine { public: VIRTUALBOXSUPPORTTRANSLATION_OVERRIDE(SnapshotMachine) DECLARE_NOT_AGGREGATABLE(SnapshotMachine) DECLARE_PROTECT_FINAL_CONSTRUCT() BEGIN_COM_MAP(SnapshotMachine) COM_INTERFACE_ENTRY(ISupportErrorInfo) COM_INTERFACE_ENTRY(IMachine) END_COM_MAP() NS_DECL_ISUPPORTS DECLARE_EMPTY_CTOR_DTOR (SnapshotMachine) HRESULT FinalConstruct(); void FinalRelease(); // public initializer/uninitializer for internal purposes only HRESULT init (SessionMachine *aSessionMachine, INPTR GUIDPARAM aSnapshotId, INPTR BSTR aStateFilePath); HRESULT init (Machine *aMachine, const settings::Key &aHWNode, const settings::Key &aHDAsNode, INPTR GUIDPARAM aSnapshotId, INPTR BSTR aStateFilePath); void uninit(); // util::Lockable interface RWLockHandle *lockHandle() const; // public methods only for internal purposes HRESULT onSnapshotChange (Snapshot *aSnapshot); private: Guid mSnapshotId; friend class Snapshot; }; //////////////////////////////////////////////////////////////////////////////// /** * Returns a pointer to the Machine object for this machine that acts like a * parent for complex machine data objects such as shared folders, etc. * * For primary Machine objects and for SnapshotMachine objects, returns this * object's pointer itself. For SessoinMachine objects, returns the peer * (primary) machine pointer. */ inline Machine *Machine::machine() { if (mType == IsSessionMachine) return mPeer; return this; } COM_DECL_READONLY_ENUM_AND_COLLECTION (Machine) #endif // ____H_MACHINEIMPL