Index: /trunk/src/VBox/Main/idl/VirtualBox.xidl
===================================================================
--- /trunk/src/VBox/Main/idl/VirtualBox.xidl (revision 46774)
+++ /trunk/src/VBox/Main/idl/VirtualBox.xidl (revision 46775)
@@ -16847,7 +16847,29 @@
-->
+
+
+ Internal event reason type.
+
+
+
+ Null value, means "no known reason".
+
+
+ Host is being suspended (power management event).
+
+
+ Host is being resumed (power management event).
+
+
+ Host is running low on battery (power management event).
+
+
+
True enables statistics collection.
+
+
+
+
+
+ Internal method for triggering a VM pause with a specified reason code.
+ The reason code can be interpreted by device/drivers and thus it might
+ behave slightly differently than a normal VM pause.
+
+
+ Virtual machine not in Running state.
+
+
+ Virtual machine error in suspend operation.
+
+
+
+
+
+ Specify the best matching reason code please.
+
+
+
+
+
+ Internal method for triggering a VM resume with a specified reason code.
+ The reason code can be interpreted by device/drivers and thus it might
+ behave slightly differently than a normal VM resume.
+
+
+ Virtual machine not in Paused state.
+
+
+ Virtual machine error in resume operation.
+
+
+
+
+
+ Specify the best matching reason code please.
+
+
+
+
+
+ Internal method for triggering a VM save state with a specified reason
+ code. The reason code can be interpreted by device/drivers and thus it
+ might behave slightly differently than a normal VM save state.
+
+
+ Virtual machine state neither Running nor Paused.
+
+
+ Failed to create directory for saved state file.
+
+
+
+
+
+ Specify the best matching reason code please.
+
+
+ Progress object to track the operation completion.
Index: /trunk/src/VBox/Main/include/ConsoleImpl.h
===================================================================
--- /trunk/src/VBox/Main/include/ConsoleImpl.h (revision 46774)
+++ /trunk/src/VBox/Main/include/ConsoleImpl.h (revision 46775)
@@ -258,4 +258,8 @@
}
void enableVMMStatistics(BOOL aEnable);
+
+ HRESULT pause(Reason_T aReason);
+ HRESULT resume(Reason_T aReason);
+ HRESULT saveState(Reason_T aReason, IProgress **aProgress);
// callback callers (partly; for some events console callbacks are notified
Index: /trunk/src/VBox/Main/include/Global.h
===================================================================
--- /trunk/src/VBox/Main/include/Global.h (revision 46774)
+++ /trunk/src/VBox/Main/include/Global.h (revision 46775)
@@ -194,4 +194,12 @@
/**
+ * Stringify a reason.
+ *
+ * @returns Pointer to a read only string.
+ * @param aReason The reason code.
+ */
+ static const char *stringifyReason(Reason_T aReason);
+
+ /**
* Try convert a COM status code to a VirtualBox status code (VBox/err.h).
*
Index: /trunk/src/VBox/Main/include/HostPower.h
===================================================================
--- /trunk/src/VBox/Main/include/HostPower.h (revision 46774)
+++ /trunk/src/VBox/Main/include/HostPower.h (revision 46775)
@@ -5,5 +5,5 @@
/*
- * Copyright (C) 2006-2010 Oracle Corporation
+ * Copyright (C) 2006-2013 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
@@ -20,5 +20,4 @@
#include "VirtualBoxBase.h"
-#include "MachineImpl.h"
#include
@@ -29,25 +28,18 @@
#endif /* RT_OS_DARWIN */
-typedef enum
-{
- HostPowerEvent_Suspend,
- HostPowerEvent_Resume,
- HostPowerEvent_BatteryLow
-} HostPowerEvent;
-
class HostPowerService
{
public:
- HostPowerService (VirtualBox *aVirtualBox);
+ HostPowerService(VirtualBox *aVirtualBox);
virtual ~HostPowerService();
- void notify (HostPowerEvent aEvent);
+ void notify(Reason_T aReason);
protected:
- VirtualBox *mVirtualBox;
+ VirtualBox *mVirtualBox;
- std::vector< ComPtr > mConsoles;
+ std::vector > mSessionControls;
};
@@ -65,5 +57,5 @@
private:
- static DECLCALLBACK(int) NotificationThread (RTTHREAD ThreadSelf, void *pInstance);
+ static DECLCALLBACK(int) NotificationThread(RTTHREAD ThreadSelf, void *pInstance);
static LRESULT CALLBACK WndProc(HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam);
@@ -79,14 +71,14 @@
public:
- HostPowerServiceDarwin (VirtualBox *aVirtualBox);
+ HostPowerServiceDarwin(VirtualBox *aVirtualBox);
virtual ~HostPowerServiceDarwin();
private:
- static DECLCALLBACK(int) powerChangeNotificationThread (RTTHREAD ThreadSelf, void *pInstance);
- static void powerChangeNotificationHandler (void *pvData, io_service_t service, natural_t messageType, void *pMessageArgument);
- static void lowPowerHandler (void *pvData);
+ static DECLCALLBACK(int) powerChangeNotificationThread(RTTHREAD ThreadSelf, void *pInstance);
+ static void powerChangeNotificationHandler(void *pvData, io_service_t service, natural_t messageType, void *pMessageArgument);
+ static void lowPowerHandler(void *pvData);
- void checkBatteryCriticalLevel (bool *pfCriticalChanged = NULL);
+ void checkBatteryCriticalLevel(bool *pfCriticalChanged = NULL);
/* Private member vars */
Index: /trunk/src/VBox/Main/include/SessionImpl.h
===================================================================
--- /trunk/src/VBox/Main/include/SessionImpl.h (revision 46774)
+++ /trunk/src/VBox/Main/include/SessionImpl.h (revision 46775)
@@ -5,5 +5,5 @@
/*
- * Copyright (C) 2006-2012 Oracle Corporation
+ * Copyright (C) 2006-2013 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
@@ -117,4 +117,7 @@
IProgress *aProgress);
STDMETHOD(EnableVMMStatistics)(BOOL aEnable);
+ STDMETHOD(PauseWithReason)(Reason_T aReason);
+ STDMETHOD(ResumeWithReason)(Reason_T aReason);
+ STDMETHOD(SaveStateWithReason)(Reason_T aReason, IProgress **aProgress);
private:
Index: /trunk/src/VBox/Main/src-all/Global.cpp
===================================================================
--- /trunk/src/VBox/Main/src-all/Global.cpp (revision 46774)
+++ /trunk/src/VBox/Main/src-all/Global.cpp (revision 46775)
@@ -451,4 +451,24 @@
}
+
+/*static*/ const char *
+Global::stringifyReason(Reason_T aReason)
+{
+ switch (aReason)
+ {
+ case Reason_Unspecified: return "unspecified";
+ case Reason_HostSuspend: return "host suspend";
+ case Reason_HostResume: return "host resume";
+ case Reason_HostBatteryLow: return "host battery low";
+ default:
+ {
+ AssertMsgFailed(("%d (%#x)\n", aReason, aReason));
+ static char s_szMsg[48];
+ RTStrPrintf(s_szMsg, sizeof(s_szMsg), "invalid reason %#010x\n", aReason);
+ return s_szMsg;
+ }
+ }
+}
+
/*static*/ int
Global::vboxStatusCodeFromCOM(HRESULT aComStatus)
Index: /trunk/src/VBox/Main/src-client/ConsoleImpl.cpp
===================================================================
--- /trunk/src/VBox/Main/src-client/ConsoleImpl.cpp (revision 46774)
+++ /trunk/src/VBox/Main/src-client/ConsoleImpl.cpp (revision 46775)
@@ -263,9 +263,11 @@
const ComPtr &aServerProgress,
const Utf8Str &aSavedStateFile,
- MachineState_T aMachineStateBefore)
+ MachineState_T aMachineStateBefore,
+ Reason_T aReason)
: VMTask(aConsole, NULL /* aProgress */, aServerProgress,
true /* aUsesVMPtr */),
mSavedStateFile(aSavedStateFile),
- mMachineStateBefore(aMachineStateBefore)
+ mMachineStateBefore(aMachineStateBefore),
+ mReason(aReason)
{}
@@ -273,4 +275,6 @@
/* The local machine state we had before. Required if something fails */
MachineState_T mMachineStateBefore;
+ /* The reason for saving state */
+ Reason_T mReason;
};
@@ -2074,5 +2078,4 @@
{
LogFlowThisFuncEnter();
- LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
CheckComArgOutPointerValid(aProgress);
@@ -2083,4 +2086,5 @@
AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
+ LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
switch (mMachineState)
{
@@ -2206,5 +2210,4 @@
{
LogFlowThisFuncEnter();
- LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
AutoCaller autoCaller(this);
@@ -2213,4 +2216,5 @@
AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
+ LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
if ( mMachineState != MachineState_Running
&& mMachineState != MachineState_Teleporting
@@ -2257,5 +2261,4 @@
LogFlowThisFuncEnter();
- LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
AutoCaller autoCaller(this);
@@ -2264,4 +2267,5 @@
AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
+ LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
AssertReturn(m_pVMMDev, E_FAIL);
PPDMIVMMDEVPORT pVmmDevPort = m_pVMMDev->getVMMDevPort();
@@ -2401,5 +2405,4 @@
LogFlowThisFuncEnter();
- LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
AutoCaller autoCaller(this);
@@ -2408,4 +2411,5 @@
AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
+ LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
if ( mMachineState != MachineState_Running
&& mMachineState != MachineState_Teleporting
@@ -2474,44 +2478,9 @@
LogFlowThisFuncEnter();
- AutoCaller autoCaller(this);
- if (FAILED(autoCaller.rc())) return autoCaller.rc();
-
- AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
-
- switch (mMachineState)
- {
- case MachineState_Running:
- case MachineState_Teleporting:
- case MachineState_LiveSnapshotting:
- break;
-
- case MachineState_Paused:
- case MachineState_TeleportingPausedVM:
- case MachineState_Saving:
- return setError(VBOX_E_INVALID_VM_STATE, tr("Already paused"));
-
- default:
- return setInvalidMachineStateError();
- }
-
- /* get the VM handle. */
- SafeVMPtr ptrVM(this);
- if (!ptrVM.isOk())
- return ptrVM.rc();
-
- LogFlowThisFunc(("Sending PAUSE request...\n"));
-
- /* release the lock before a VMR3* call (EMT will call us back)! */
- alock.release();
-
- int vrc = VMR3Suspend(ptrVM.rawUVM());
-
- HRESULT hrc = S_OK;
- if (RT_FAILURE(vrc))
- hrc = setError(VBOX_E_VM_ERROR, tr("Could not suspend the machine execution (%Rrc)"), vrc);
-
- LogFlowThisFunc(("hrc=%Rhrc\n", hrc));
+ HRESULT rc = pause(Reason_Unspecified);
+
+ LogFlowThisFunc(("rc=%Rhrc\n", rc));
LogFlowThisFuncLeave();
- return hrc;
+ return rc;
}
@@ -2520,41 +2489,5 @@
LogFlowThisFuncEnter();
- AutoCaller autoCaller(this);
- if (FAILED(autoCaller.rc())) return autoCaller.rc();
-
- AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
-
- if (mMachineState != MachineState_Paused)
- return setError(VBOX_E_INVALID_VM_STATE,
- tr("Cannot resume the machine as it is not paused (machine state: %s)"),
- Global::stringifyMachineState(mMachineState));
-
- /* get the VM handle. */
- SafeVMPtr ptrVM(this);
- if (!ptrVM.isOk())
- return ptrVM.rc();
-
- LogFlowThisFunc(("Sending RESUME request...\n"));
-
- /* release the lock before a VMR3* call (EMT will call us back)! */
- alock.release();
-
-#ifdef VBOX_WITH_EXTPACK
- int vrc = mptrExtPackManager->callAllVmPowerOnHooks(this, VMR3GetVM(ptrVM.rawUVM())); /** @todo called a few times too many... */
-#else
- int vrc = VINF_SUCCESS;
-#endif
- if (RT_SUCCESS(vrc))
- {
- if (VMR3GetStateU(ptrVM.rawUVM()) == VMSTATE_CREATED)
- vrc = VMR3PowerOn(ptrVM.rawUVM()); /* (PowerUpPaused) */
- else
- vrc = VMR3Resume(ptrVM.rawUVM());
- }
-
- HRESULT rc = RT_SUCCESS(vrc) ? S_OK :
- setError(VBOX_E_VM_ERROR,
- tr("Could not resume the machine execution (%Rrc)"),
- vrc);
+ HRESULT rc = resume(Reason_Unspecified);
LogFlowThisFunc(("rc=%Rhrc\n", rc));
@@ -2757,148 +2690,6 @@
{
LogFlowThisFuncEnter();
- LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
-
- CheckComArgOutPointerValid(aProgress);
-
- AutoCaller autoCaller(this);
- if (FAILED(autoCaller.rc())) return autoCaller.rc();
-
- AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
-
- if ( mMachineState != MachineState_Running
- && mMachineState != MachineState_Paused)
- {
- return setError(VBOX_E_INVALID_VM_STATE,
- tr("Cannot save the execution state as the machine is not running or paused (machine state: %s)"),
- Global::stringifyMachineState(mMachineState));
- }
-
- /* memorize the current machine state */
- MachineState_T lastMachineState = mMachineState;
-
- if (mMachineState == MachineState_Running)
- {
- /* get the VM handle. */
- SafeVMPtr ptrVM(this);
- if (!ptrVM.isOk())
- return ptrVM.rc();
-
- /* release the lock before a VMR3* call (EMT will call us back)! */
- alock.release();
- int vrc = VMR3Suspend(ptrVM.rawUVM());
- alock.acquire();
-
- HRESULT hrc = S_OK;
- if (RT_FAILURE(vrc))
- hrc = setError(VBOX_E_VM_ERROR, tr("Could not suspend the machine execution (%Rrc)"), vrc);
- if (FAILED(hrc))
- return hrc;
- }
-
- HRESULT rc = S_OK;
- bool fBeganSavingState = false;
- bool fTaskCreationFailed = false;
-
- do
- {
- ComPtr pProgress;
- Bstr stateFilePath;
-
- /*
- * request a saved state file path from the server
- * (this will set the machine state to Saving on the server to block
- * others from accessing this machine)
- */
- rc = mControl->BeginSavingState(pProgress.asOutParam(),
- stateFilePath.asOutParam());
- if (FAILED(rc))
- break;
-
- fBeganSavingState = true;
-
- /* sync the state with the server */
- setMachineStateLocally(MachineState_Saving);
-
- /* ensure the directory for the saved state file exists */
- {
- Utf8Str dir = stateFilePath;
- dir.stripFilename();
- if (!RTDirExists(dir.c_str()))
- {
- int vrc = RTDirCreateFullPath(dir.c_str(), 0700);
- if (RT_FAILURE(vrc))
- {
- rc = setError(VBOX_E_FILE_ERROR,
- tr("Could not create a directory '%s' to save the state to (%Rrc)"),
- dir.c_str(), vrc);
- break;
- }
- }
- }
-
- /* Create a task object early to ensure mpUVM protection is successful. */
- std::auto_ptr task(new VMSaveTask(this, pProgress,
- stateFilePath,
- lastMachineState));
- rc = task->rc();
- /*
- * If we fail here it means a PowerDown() call happened on another
- * thread while we were doing Pause() (which releases the Console lock).
- * We assign PowerDown() a higher precedence than SaveState(),
- * therefore just return the error to the caller.
- */
- if (FAILED(rc))
- {
- fTaskCreationFailed = true;
- break;
- }
-
- /* create a thread to wait until the VM state is saved */
- int vrc = RTThreadCreate(NULL, Console::saveStateThread, (void *)task.get(),
- 0, RTTHREADTYPE_MAIN_WORKER, 0, "VMSave");
- if (RT_FAILURE(vrc))
- {
- rc = setError(E_FAIL, "Could not create VMSave thread (%Rrc)", vrc);
- break;
- }
-
- /* task is now owned by saveStateThread(), so release it */
- task.release();
-
- /* return the progress to the caller */
- pProgress.queryInterfaceTo(aProgress);
- } while (0);
-
- if (FAILED(rc) && !fTaskCreationFailed)
- {
- /* preserve existing error info */
- ErrorInfoKeeper eik;
-
- if (fBeganSavingState)
- {
- /*
- * cancel the requested save state procedure.
- * This will reset the machine state to the state it had right
- * before calling mControl->BeginSavingState().
- */
- mControl->EndSavingState(eik.getResultCode(), eik.getText().raw());
- }
-
- if (lastMachineState == MachineState_Running)
- {
- /* restore the paused state if appropriate */
- setMachineStateLocally(MachineState_Paused);
- /* restore the running state if appropriate */
- SafeVMPtr ptrVM(this);
- if (ptrVM.isOk())
- {
- alock.release();
- VMR3Resume(ptrVM.rawUVM());
- alock.acquire();
- }
- }
- else
- setMachineStateLocally(lastMachineState);
- }
+
+ HRESULT rc = saveState(Reason_Unspecified, aProgress);
LogFlowThisFunc(("rc=%Rhrc\n", rc));
@@ -3361,5 +3152,4 @@
{
LogFlowThisFuncEnter();
- LogFlowThisFunc(("aName='%ls' mMachineState=%d\n", aName, mMachineState));
CheckComArgStrNotEmptyOrNull(aName);
@@ -3370,4 +3160,5 @@
AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
+ LogFlowThisFunc(("aName='%ls' mMachineState=%d\n", aName, mMachineState));
if (Global::IsTransient(mMachineState))
@@ -5921,4 +5712,273 @@
/**
+ * Worker for Console::Pause and internal entry point for pausing a VM for
+ * a specific reason.
+ */
+HRESULT Console::pause(Reason_T aReason)
+{
+ LogFlowThisFuncEnter();
+
+ AutoCaller autoCaller(this);
+ if (FAILED(autoCaller.rc())) return autoCaller.rc();
+
+ AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
+
+ switch (mMachineState)
+ {
+ case MachineState_Running:
+ case MachineState_Teleporting:
+ case MachineState_LiveSnapshotting:
+ break;
+
+ case MachineState_Paused:
+ case MachineState_TeleportingPausedVM:
+ case MachineState_Saving:
+ return setError(VBOX_E_INVALID_VM_STATE, tr("Already paused"));
+
+ default:
+ return setInvalidMachineStateError();
+ }
+
+ /* get the VM handle. */
+ SafeVMPtr ptrVM(this);
+ if (!ptrVM.isOk())
+ return ptrVM.rc();
+
+ /* release the lock before a VMR3* call (EMT will call us back)! */
+ alock.release();
+
+ LogFlowThisFunc(("Sending PAUSE request...\n"));
+ if (aReason != Reason_Unspecified)
+ LogRel(("Pausing VM execution, reason \"%s\"\n", Global::stringifyReason(aReason)));
+
+ /** @todo r=klaus make use of aReason */
+ int vrc = VMR3Suspend(ptrVM.rawUVM());
+
+ HRESULT hrc = S_OK;
+ if (RT_FAILURE(vrc))
+ hrc = setError(VBOX_E_VM_ERROR, tr("Could not suspend the machine execution (%Rrc)"), vrc);
+
+ LogFlowThisFunc(("hrc=%Rhrc\n", hrc));
+ LogFlowThisFuncLeave();
+ return hrc;
+}
+
+/**
+ * Worker for Console::Resume and internal entry point for resuming a VM for
+ * a specific reason.
+ */
+HRESULT Console::resume(Reason_T aReason)
+{
+ LogFlowThisFuncEnter();
+
+ AutoCaller autoCaller(this);
+ if (FAILED(autoCaller.rc())) return autoCaller.rc();
+
+ AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
+
+ if (mMachineState != MachineState_Paused)
+ return setError(VBOX_E_INVALID_VM_STATE,
+ tr("Cannot resume the machine as it is not paused (machine state: %s)"),
+ Global::stringifyMachineState(mMachineState));
+
+ /* get the VM handle. */
+ SafeVMPtr ptrVM(this);
+ if (!ptrVM.isOk())
+ return ptrVM.rc();
+
+ /* release the lock before a VMR3* call (EMT will call us back)! */
+ alock.release();
+
+ LogFlowThisFunc(("Sending RESUME request...\n"));
+ if (aReason != Reason_Unspecified)
+ LogRel(("Resuming VM execution, reason \"%s\"\n", Global::stringifyReason(aReason)));
+
+ /** @todo r=klaus make use of aReason */
+ int vrc;
+ if (VMR3GetStateU(ptrVM.rawUVM()) == VMSTATE_CREATED)
+ {
+#ifdef VBOX_WITH_EXTPACK
+ vrc = mptrExtPackManager->callAllVmPowerOnHooks(this, VMR3GetVM(ptrVM.rawUVM()));
+#else
+ vrc = VINF_SUCCESS;
+#endif
+ if (RT_SUCCESS(vrc))
+ vrc = VMR3PowerOn(ptrVM.rawUVM()); /* (PowerUpPaused) */
+ }
+ else
+ vrc = VMR3Resume(ptrVM.rawUVM());
+
+ HRESULT rc = RT_SUCCESS(vrc) ? S_OK :
+ setError(VBOX_E_VM_ERROR,
+ tr("Could not resume the machine execution (%Rrc)"),
+ vrc);
+
+ LogFlowThisFunc(("rc=%Rhrc\n", rc));
+ LogFlowThisFuncLeave();
+ return rc;
+}
+
+/**
+ * Worker for Console::SaveState and internal entry point for saving state of
+ * a VM for a specific reason.
+ */
+HRESULT Console::saveState(Reason_T aReason, IProgress **aProgress)
+{
+ LogFlowThisFuncEnter();
+
+ CheckComArgOutPointerValid(aProgress);
+
+ AutoCaller autoCaller(this);
+ if (FAILED(autoCaller.rc())) return autoCaller.rc();
+
+ AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
+
+ LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
+ if ( mMachineState != MachineState_Running
+ && mMachineState != MachineState_Paused)
+ {
+ return setError(VBOX_E_INVALID_VM_STATE,
+ tr("Cannot save the execution state as the machine is not running or paused (machine state: %s)"),
+ Global::stringifyMachineState(mMachineState));
+ }
+
+ if (aReason != Reason_Unspecified)
+ LogRel(("Saving state of VM, reason \"%s\"\n", Global::stringifyReason(aReason)));
+
+ /* memorize the current machine state */
+ MachineState_T lastMachineState = mMachineState;
+
+ if (mMachineState == MachineState_Running)
+ {
+ /* get the VM handle. */
+ SafeVMPtr ptrVM(this);
+ if (!ptrVM.isOk())
+ return ptrVM.rc();
+
+ /* release the lock before a VMR3* call (EMT will call us back)! */
+ alock.release();
+ int vrc = VMR3Suspend(ptrVM.rawUVM());
+ alock.acquire();
+
+ HRESULT hrc = S_OK;
+ if (RT_FAILURE(vrc))
+ hrc = setError(VBOX_E_VM_ERROR, tr("Could not suspend the machine execution (%Rrc)"), vrc);
+ if (FAILED(hrc))
+ return hrc;
+ }
+
+ HRESULT rc = S_OK;
+ bool fBeganSavingState = false;
+ bool fTaskCreationFailed = false;
+
+ do
+ {
+ ComPtr pProgress;
+ Bstr stateFilePath;
+
+ /*
+ * request a saved state file path from the server
+ * (this will set the machine state to Saving on the server to block
+ * others from accessing this machine)
+ */
+ rc = mControl->BeginSavingState(pProgress.asOutParam(),
+ stateFilePath.asOutParam());
+ if (FAILED(rc))
+ break;
+
+ fBeganSavingState = true;
+
+ /* sync the state with the server */
+ setMachineStateLocally(MachineState_Saving);
+
+ /* ensure the directory for the saved state file exists */
+ {
+ Utf8Str dir = stateFilePath;
+ dir.stripFilename();
+ if (!RTDirExists(dir.c_str()))
+ {
+ int vrc = RTDirCreateFullPath(dir.c_str(), 0700);
+ if (RT_FAILURE(vrc))
+ {
+ rc = setError(VBOX_E_FILE_ERROR,
+ tr("Could not create a directory '%s' to save the state to (%Rrc)"),
+ dir.c_str(), vrc);
+ break;
+ }
+ }
+ }
+
+ /* Create a task object early to ensure mpUVM protection is successful. */
+ std::auto_ptr task(new VMSaveTask(this, pProgress,
+ stateFilePath,
+ lastMachineState,
+ aReason));
+ rc = task->rc();
+ /*
+ * If we fail here it means a PowerDown() call happened on another
+ * thread while we were doing Pause() (which releases the Console lock).
+ * We assign PowerDown() a higher precedence than SaveState(),
+ * therefore just return the error to the caller.
+ */
+ if (FAILED(rc))
+ {
+ fTaskCreationFailed = true;
+ break;
+ }
+
+ /* create a thread to wait until the VM state is saved */
+ int vrc = RTThreadCreate(NULL, Console::saveStateThread, (void *)task.get(),
+ 0, RTTHREADTYPE_MAIN_WORKER, 0, "VMSave");
+ if (RT_FAILURE(vrc))
+ {
+ rc = setError(E_FAIL, "Could not create VMSave thread (%Rrc)", vrc);
+ break;
+ }
+
+ /* task is now owned by saveStateThread(), so release it */
+ task.release();
+
+ /* return the progress to the caller */
+ pProgress.queryInterfaceTo(aProgress);
+ } while (0);
+
+ if (FAILED(rc) && !fTaskCreationFailed)
+ {
+ /* preserve existing error info */
+ ErrorInfoKeeper eik;
+
+ if (fBeganSavingState)
+ {
+ /*
+ * cancel the requested save state procedure.
+ * This will reset the machine state to the state it had right
+ * before calling mControl->BeginSavingState().
+ */
+ mControl->EndSavingState(eik.getResultCode(), eik.getText().raw());
+ }
+
+ if (lastMachineState == MachineState_Running)
+ {
+ /* restore the paused state if appropriate */
+ setMachineStateLocally(MachineState_Paused);
+ /* restore the running state if appropriate */
+ SafeVMPtr ptrVM(this);
+ if (ptrVM.isOk())
+ {
+ alock.release();
+ VMR3Resume(ptrVM.rawUVM());
+ alock.acquire();
+ }
+ }
+ else
+ setMachineStateLocally(lastMachineState);
+ }
+
+ LogFlowThisFunc(("rc=%Rhrc\n", rc));
+ LogFlowThisFuncLeave();
+ return rc;
+}
+
+/**
* Gets called by Session::UpdateMachineState()
* (IInternalSessionControl::updateMachineState()).
@@ -6391,5 +6451,4 @@
LogFlowThisFuncEnter();
- LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
CheckComArgOutPointerValid(aProgress);
@@ -6400,4 +6459,5 @@
AutoWriteLock alock(this COMMA_LOCKVAL_SRC_POS);
+ LogFlowThisFunc(("mMachineState=%d\n", mMachineState));
HRESULT rc = S_OK;
ComObjPtr