VBoxManageSnapshot.cpp revision e48239695d41f806ff02d8a60b97dc20d4822d7a
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * VBoxManage - The 'snapshot' command.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * Copyright (C) 2006-2009 Oracle Corporation
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * available from http://www.virtualbox.org. This file is free software;
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * you can redistribute it and/or modify it under the terms of the GNU
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * General Public License (GPL) as published by the Free Software
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync/*******************************************************************************
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync* Header Files *
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync*******************************************************************************/
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsyncusing namespace com;
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * Helper function used with "VBoxManage snapshot ... dump". Gets called to find the
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * snapshot in the machine's snapshot tree that uses a particular diff image child of
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * a medium.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * Horribly inefficient since we keep re-querying the snapshots tree for each image,
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * but this is for quick debugging only.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param pMedium
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param pThisSnapshot
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param pCurrentSnapshot
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param uMediumLevel
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param uSnapshotLevel
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsyncbool FindAndPrintSnapshotUsingMedium(ComPtr<IMedium> &pMedium,
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // get snapshot machine so we can figure out which diff image this created
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pThisSnapshot, COMGETTER(Machine)(pSnapshotMachine.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // get media attachments
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pSnapshotMachine, COMGETTER(MediumAttachments)(ComSafeArrayAsOutParam(aAttachments)));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync ComPtr<IMediumAttachment> pAttach(aAttachments[i]);
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pAttach, COMGETTER(Type)(&type));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pAttach, COMGETTER(Medium)(pMediumInSnapshot.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // get snapshot name
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pThisSnapshot, COMGETTER(Name)(bstrSnapshotName.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync (pThisSnapshot == pCurrentSnapshot) ? " (CURSNAP)" : "");
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync return true; // found
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // not found: then recurse into child snapshots
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pThisSnapshot, COMGETTER(Children)(ComSafeArrayAsOutParam(aSnapshots)));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync } while (0);
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync return false;
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * Helper function used with "VBoxManage snapshot ... dump". Called from DumpSnapshot()
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * for each hard disk attachment found in a virtual machine. This then writes out the
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * root (base) medium for that hard disk attachment and recurses into the children
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * tree of that medium, correlating it with the snapshots of the machine.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param pCurrentStateMedium constant, the medium listed in the current machine data (latest diff image).
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param pMedium variant, initially the base medium, then a child of the base medium when recursing.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param pRootSnapshot constant, the root snapshot of the machine, if any; this then looks into the child snapshots.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param pCurrentSnapshot constant, the machine's current snapshot (so we can mark it in the output).
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param uLevel variant, the recursion level for output indentation.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsyncvoid DumpMediumWithChildren(ComPtr<IMedium> &pCurrentStateMedium,
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // print this medium
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pMedium, COMGETTER(Name)(bstrMediumName.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync (pCurrentStateMedium == pMedium) ? " (CURSTATE)" : "");
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // find and print the snapshot that uses this particular medium (diff image)
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync FindAndPrintSnapshotUsingMedium(pMedium, pRootSnapshot, pCurrentSnapshot, uLevel, 0);
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // recurse into children
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pMedium, COMGETTER(Children)(ComSafeArrayAsOutParam(aChildren)));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync DumpMediumWithChildren(pCurrentStateMedium, pChild, pRootSnapshot, pCurrentSnapshot, uLevel + 1);
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync } while (0);
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * Implementation for "VBoxManage snapshot ... dump". This goes thru the machine's
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * medium attachments and calls DumpMediumWithChildren() for each hard disk medium found,
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * which then dumps the parent/child tree of that medium together with the corresponding
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * snapshots.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * @param pMachine Machine to dump snapshots for.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // get root snapshot
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pMachine, GetSnapshot(Bstr(""), pSnapshot.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // get current snapshot
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pMachine, COMGETTER(CurrentSnapshot)(pCurrentSnapshot.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync // get media attachments
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pMachine, COMGETTER(MediumAttachments)(ComSafeArrayAsOutParam(aAttachments)));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync ComPtr<IMediumAttachment> pAttach(aAttachments[i]);
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pAttach, COMGETTER(Type)(&type));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pAttach, COMGETTER(Medium)(pCurrentStateMedium.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pCurrentStateMedium, COMGETTER(Base)(pBaseMedium.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(pBaseMedium, COMGETTER(Name)(bstrBaseMediumName.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync RTPrintf("[%RI32] Images and snapshots for medium \"%ls\"\n", i, bstrBaseMediumName.raw());
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync } while (0);
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync * Implementation for all VBoxManage snapshot ... subcommands.
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync /* we need at least a VM and a command */
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync return errorSyntax(USAGE_SNAPSHOT, "Not enough parameters");
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync /* the first argument must be the VM */
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync /* assume it's a UUID */
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync rc = a->virtualBox->GetMachine(bstrMachine, pMachine.asOutParam());
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync /* must be a name */
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR(a->virtualBox, FindMachine(bstrMachine, pMachine.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync /* we have to open a session for this task (new or shared) */
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync rc = pMachine->LockMachine(a->session, LockType_Shared);
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync CHECK_ERROR_BREAK(a->session, COMGETTER(Console)(console.asOutParam()));
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync /* switch based on the command */
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync bool fDelete = false,
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync /* there must be a name */
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync errorSyntax(USAGE_SNAPSHOT, "Missing snapshot name");
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync /* parse the optional arguments */
e0e0c19eefceaf5d4ec40f9466b58a771f50e799vboxsync bool fPause = false;
int ch;
switch (ch)
fPause = true;
if (fPause)
fPause = false;
if (fPause)
if (fRestoreCurrent)
if (fRestoreCurrent)
if (fDelete)