GuestImpl.cpp revision cbf5a4260109bea05e1492f0b375b11a738cfb1d
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * VirtualBox COM class implementation
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Copyright (C) 2006-2008 Sun Microsystems, Inc.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * available from http://www.virtualbox.org. This file is free software;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * you can redistribute it and/or modify it under the terms of the GNU
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * General Public License (GPL) as published by the Free Software
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * additional information or have any questions.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/////////////////////////////////////////////////////////////////////////////
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync// constructor / destructor
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/////////////////////////////////////////////////////////////////////////////
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync// public methods only for internal purposes
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/////////////////////////////////////////////////////////////////////////////
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Initializes the guest object.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync /* Enclose the state transition NotReady->InInit->Ready */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync /* mData.mAdditionsActive is FALSE */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync /* Confirm a successful initialization when it's the case */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync HRESULT ret = mParent->machine()->COMGETTER(MemoryBalloonSize)(&aMemoryBalloonSize);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync mMemoryBalloonSize = 0; /* Default is no ballooning */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync mStatUpdateInterval = 0; /* Default is not to report guest statistics at all */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync /* Clear statistics. */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (unsigned i = 0 ; i < GUESTSTATTYPE_MAX; i++)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Uninitializes the instance and sets the ready flag to FALSE.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Called either from FinalRelease() or by the parent when it gets destroyed.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync /* Enclose the state transition Ready->InUninit->NotReady */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync// IGuest properties
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync/////////////////////////////////////////////////////////////////////////////
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::COMGETTER(OSTypeId) (BSTR *aOSTypeId)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync // redirect the call to IMachine if no additions are installed
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync return mParent->machine()->COMGETTER(OSTypeId)(aOSTypeId);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::COMGETTER(AdditionsActive) (BOOL *aAdditionsActive)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::COMGETTER(AdditionsVersion) (BSTR *aAdditionsVersion)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync mData.mAdditionsVersion.cloneTo(aAdditionsVersion);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::COMGETTER(SupportsSeamless) (BOOL *aSupportsSeamless)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::COMGETTER(SupportsGraphics) (BOOL *aSupportsGraphics)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::COMGETTER(MemoryBalloonSize) (ULONG *aMemoryBalloonSize)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::COMSETTER(MemoryBalloonSize) (ULONG aMemoryBalloonSize)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync HRESULT ret = mParent->machine()->COMSETTER(MemoryBalloonSize)(aMemoryBalloonSize);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync /* forward the information to the VMM device */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync vmmDev->getVMMDevPort()->pfnSetMemoryBalloon(vmmDev->getVMMDevPort(), aMemoryBalloonSize);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::COMGETTER(StatisticsUpdateInterval)(ULONG *aUpdateInterval)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::COMSETTER(StatisticsUpdateInterval)(ULONG aUpdateInterval)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync /* forward the information to the VMM device */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync vmmDev->getVMMDevPort()->pfnSetStatisticsInterval(vmmDev->getVMMDevPort(), aUpdateInterval);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::InternalGetStatistics(ULONG aCpuId, ULONG *aCpuUser, ULONG *aCpuKernel, ULONG *aCpuIdle,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync ULONG *aMemTotal, ULONG *aMemFree, ULONG *aMemBalloon, ULONG *aMemCache,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *aCpuUser = mCurrentGuestStat[GUESTSTATTYPE_CPUUSER];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *aCpuKernel = mCurrentGuestStat[GUESTSTATTYPE_CPUKERNEL];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *aCpuIdle = mCurrentGuestStat[GUESTSTATTYPE_CPUIDLE];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *aMemTotal = mCurrentGuestStat[GUESTSTATTYPE_MEMTOTAL];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *aMemFree = mCurrentGuestStat[GUESTSTATTYPE_MEMFREE];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *aMemBalloon = mCurrentGuestStat[GUESTSTATTYPE_MEMBALLOON];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *aMemCache = mCurrentGuestStat[GUESTSTATTYPE_MEMCACHE];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *aPageTotal = mCurrentGuestStat[GUESTSTATTYPE_PAGETOTAL];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *aPageFree = mCurrentGuestStat[GUESTSTATTYPE_PAGEFREE];
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncHRESULT Guest::SetStatistic(ULONG aCpuId, GUESTSTATTYPE enmType, ULONG aVal)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncSTDMETHODIMP Guest::SetCredentials(IN_BSTR aUserName, IN_BSTR aPassword,
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (FAILED(autoCaller.rc())) return autoCaller.rc();
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync /* forward the information to the VMM device */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync uint32_t u32Flags = VMMDEV_SETCREDENTIALS_GUESTLOGON;
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync vmmDev->getVMMDevPort()->pfnSetCredentials(vmmDev->getVMMDevPort(),
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync Utf8Str(aUserName).raw(), Utf8Str(aPassword).raw(),
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync tr("VMM device is not available (is the VM running?)"));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Creates the argument list as an array used for executing a program.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * @returns VBox status code.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * @todo Respect spaces when quoting for arguments, e.g. "c:\\program files\\".
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * @todo Handle empty ("") argguments.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncint Guest::prepareExecuteArgs(const char *pszArgs, void **ppvList, uint32_t *pcbList, uint32_t *pcArgs)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync int rc = RTGetOptArgvFromString(&ppaArg, &iArgs, pszArgs, NULL);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync for (int i=0; i<iArgs; i++)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync if (i > 0) /* Insert space as delimiter. */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync rc = RTStrAAppendN(&pszTemp, ppaArg[i], strlen(ppaArg[i]));
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync *pcbList = strlen(pszTemp) + 1; /* Include zero termination. */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * Appends environment variables to the environment block. Each var=value pair is separated
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * by NULL (\0) sequence. The whole block will be stored in one blob and disassembled on the
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * guest side later to fit into the HGCM param structure.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync * @returns VBox status code.
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsyncint Guest::prepareExecuteEnv(const char *pszEnv, void **ppvList, uint32_t *pcbList, uint32_t *pcEnv)
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync uint32_t cbNewLen = *pcbList + cbLen + 1; /* Include zero termination. */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync char *pvTmp = (char*)RTMemRealloc(*ppvList, cbNewLen);
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync pvTmp[cbNewLen - 1] = '\0'; /* Add zero termination. */
4fd606d1f5abe38e1f42c38de1d2e895166bd0f4vboxsync /* Reset counters. */
return rc;
#ifndef VBOX_WITH_GUEST_CONTROL
using namespace guestControl;
if (aFlags != 0)
return E_INVALIDARG;
using namespace guestControl;
void *pvArgs;
for (unsigned i = 0; i < uNumEnv; i++)
if (vmmDev)
i, paParms);
vrc);
return rc;