VBox/Main/SystemPropertiesImpl.cpp

	SystemPropertiesImpl.cpp revision 26d2a42f095ded346df2e41cc4837cb426b4753a
c936b605260fac01308e3f63b869f401321c52b3vboxsync/* $Id$ */
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync/** @file
c936b605260fac01308e3f63b869f401321c52b3vboxsync *
c936b605260fac01308e3f63b869f401321c52b3vboxsync * VirtualBox COM class implementation
c936b605260fac01308e3f63b869f401321c52b3vboxsync */
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync/*
c936b605260fac01308e3f63b869f401321c52b3vboxsync * Copyright (C) 2006-2008 Sun Microsystems, Inc.
c936b605260fac01308e3f63b869f401321c52b3vboxsync *
c936b605260fac01308e3f63b869f401321c52b3vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
c936b605260fac01308e3f63b869f401321c52b3vboxsync * available from http://www.virtualbox.org. This file is free software;
c936b605260fac01308e3f63b869f401321c52b3vboxsync * you can redistribute it and/or modify it under the terms of the GNU
c936b605260fac01308e3f63b869f401321c52b3vboxsync * General Public License (GPL) as published by the Free Software
c936b605260fac01308e3f63b869f401321c52b3vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
c936b605260fac01308e3f63b869f401321c52b3vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
c936b605260fac01308e3f63b869f401321c52b3vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
c936b605260fac01308e3f63b869f401321c52b3vboxsync *
c936b605260fac01308e3f63b869f401321c52b3vboxsync * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
c936b605260fac01308e3f63b869f401321c52b3vboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
c936b605260fac01308e3f63b869f401321c52b3vboxsync * additional information or have any questions.
c936b605260fac01308e3f63b869f401321c52b3vboxsync */
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync#include "SystemPropertiesImpl.h"
c936b605260fac01308e3f63b869f401321c52b3vboxsync#include "VirtualBoxImpl.h"
c936b605260fac01308e3f63b869f401321c52b3vboxsync#include "MachineImpl.h"
c936b605260fac01308e3f63b869f401321c52b3vboxsync#include "Logging.h"
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync// generated header
c936b605260fac01308e3f63b869f401321c52b3vboxsync#include "SchemaDefs.h"
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync#include <iprt/path.h>
c936b605260fac01308e3f63b869f401321c52b3vboxsync#include <iprt/dir.h>
c936b605260fac01308e3f63b869f401321c52b3vboxsync#include <VBox/param.h>
c936b605260fac01308e3f63b869f401321c52b3vboxsync#include <VBox/err.h>
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync// defines
c936b605260fac01308e3f63b869f401321c52b3vboxsync/////////////////////////////////////////////////////////////////////////////
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync// constructor / destructor
c936b605260fac01308e3f63b869f401321c52b3vboxsync/////////////////////////////////////////////////////////////////////////////
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsyncDEFINE_EMPTY_CTOR_DTOR (SystemProperties)
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsyncHRESULT SystemProperties::FinalConstruct()
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
c936b605260fac01308e3f63b869f401321c52b3vboxsync    return S_OK;
c936b605260fac01308e3f63b869f401321c52b3vboxsync}
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsyncvoid SystemProperties::FinalRelease()
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
c936b605260fac01308e3f63b869f401321c52b3vboxsync    uninit ();
c936b605260fac01308e3f63b869f401321c52b3vboxsync}
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync// public methods only for internal purposes
c936b605260fac01308e3f63b869f401321c52b3vboxsync/////////////////////////////////////////////////////////////////////////////
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync/**
c936b605260fac01308e3f63b869f401321c52b3vboxsync * Initializes the system information object.
c936b605260fac01308e3f63b869f401321c52b3vboxsync *
c936b605260fac01308e3f63b869f401321c52b3vboxsync * @returns COM result indicator
c936b605260fac01308e3f63b869f401321c52b3vboxsync */
c936b605260fac01308e3f63b869f401321c52b3vboxsyncHRESULT SystemProperties::init (VirtualBox *aParent)
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
c936b605260fac01308e3f63b869f401321c52b3vboxsync    LogFlowThisFunc (("aParent=%p\n", aParent));
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    ComAssertRet (aParent, E_FAIL);
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /* Enclose the state transition NotReady->InInit->Ready */
c936b605260fac01308e3f63b869f401321c52b3vboxsync    AutoInitSpan autoInitSpan (this);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    AssertReturn (autoInitSpan.isOk(), E_FAIL);
c936b605260fac01308e3f63b869f401321c52b3vboxsync
5ea40b04201696e445c4eeb0d1a238543aeb9167vboxsync    unconst (mParent) = aParent;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    setDefaultMachineFolder (NULL);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    setDefaultHardDiskFolder (NULL);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    setDefaultHardDiskFormat (NULL);
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    setRemoteDisplayAuthLibrary (NULL);
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    mHWVirtExEnabled = false;
c936b605260fac01308e3f63b869f401321c52b3vboxsync    mLogHistoryCount = 3;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    HRESULT rc = S_OK;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /* Fetch info of all available hd backends. */
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /// @todo NEWMEDIA VDBackendInfo needs to be improved to let us enumerate
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /// any number of backends
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /// @todo We currently leak memory because it's not actually clear what to
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /// free in structures returned by VDBackendInfo. Must be fixed ASAP!
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    VDBACKENDINFO aVDInfo [100];
c936b605260fac01308e3f63b869f401321c52b3vboxsync    unsigned cEntries;
c936b605260fac01308e3f63b869f401321c52b3vboxsync    int vrc = VDBackendInfo (RT_ELEMENTS (aVDInfo), aVDInfo, &cEntries);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    AssertRC (vrc);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    if (RT_SUCCESS (vrc))
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync    {
c936b605260fac01308e3f63b869f401321c52b3vboxsync        for (unsigned i = 0; i < cEntries; ++ i)
c936b605260fac01308e3f63b869f401321c52b3vboxsync        {
c936b605260fac01308e3f63b869f401321c52b3vboxsync            ComObjPtr <HardDiskFormat> hdf;
c936b605260fac01308e3f63b869f401321c52b3vboxsync            rc = hdf.createObject();
c936b605260fac01308e3f63b869f401321c52b3vboxsync            CheckComRCBreakRC (rc);
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync            rc = hdf->init (&aVDInfo [i]);
c936b605260fac01308e3f63b869f401321c52b3vboxsync            CheckComRCBreakRC (rc);
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync            mHardDiskFormats.push_back (hdf);
c936b605260fac01308e3f63b869f401321c52b3vboxsync        }
c936b605260fac01308e3f63b869f401321c52b3vboxsync    }
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /* Confirm a successful initialization */
c936b605260fac01308e3f63b869f401321c52b3vboxsync    if (SUCCEEDED (rc))
c936b605260fac01308e3f63b869f401321c52b3vboxsync        autoInitSpan.setSucceeded();
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    return rc;
c936b605260fac01308e3f63b869f401321c52b3vboxsync}
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync/**
c936b605260fac01308e3f63b869f401321c52b3vboxsync *  Uninitializes the instance and sets the ready flag to FALSE.
c936b605260fac01308e3f63b869f401321c52b3vboxsync *  Called either from FinalRelease() or by the parent when it gets destroyed.
c936b605260fac01308e3f63b869f401321c52b3vboxsync */
c936b605260fac01308e3f63b869f401321c52b3vboxsyncvoid SystemProperties::uninit()
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
c936b605260fac01308e3f63b869f401321c52b3vboxsync    LogFlowThisFunc (("\n"));
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /* Enclose the state transition Ready->InUninit->NotReady */
c936b605260fac01308e3f63b869f401321c52b3vboxsync    AutoUninitSpan autoUninitSpan (this);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    if (autoUninitSpan.uninitDone())
c936b605260fac01308e3f63b869f401321c52b3vboxsync        return;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    unconst (mParent).setNull();
c936b605260fac01308e3f63b869f401321c52b3vboxsync}
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync// ISystemProperties properties
c936b605260fac01308e3f63b869f401321c52b3vboxsync/////////////////////////////////////////////////////////////////////////////
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsyncSTDMETHODIMP SystemProperties::COMGETTER(MinGuestRAM)(ULONG *minRAM)
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
c936b605260fac01308e3f63b869f401321c52b3vboxsync    if (!minRAM)
c936b605260fac01308e3f63b869f401321c52b3vboxsync        return E_POINTER;
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync    AutoCaller autoCaller (this);
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync    CheckComRCReturnRC (autoCaller.rc());
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync    /* no need to lock, this is const */
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync    *minRAM = SchemaDefs::MinGuestRAM;
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    return S_OK;
c936b605260fac01308e3f63b869f401321c52b3vboxsync}
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsyncSTDMETHODIMP SystemProperties::COMGETTER(MaxGuestRAM)(ULONG *maxRAM)
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
c936b605260fac01308e3f63b869f401321c52b3vboxsync    if (!maxRAM)
c936b605260fac01308e3f63b869f401321c52b3vboxsync        return E_POINTER;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    AutoCaller autoCaller (this);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    CheckComRCReturnRC (autoCaller.rc());
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /* no need to lock, this is const */
c936b605260fac01308e3f63b869f401321c52b3vboxsync    *maxRAM = SchemaDefs::MaxGuestRAM;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    return S_OK;
c936b605260fac01308e3f63b869f401321c52b3vboxsync}
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsyncSTDMETHODIMP SystemProperties::COMGETTER(MinGuestVRAM)(ULONG *minVRAM)
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
c936b605260fac01308e3f63b869f401321c52b3vboxsync    if (!minVRAM)
c936b605260fac01308e3f63b869f401321c52b3vboxsync        return E_POINTER;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    AutoCaller autoCaller (this);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    CheckComRCReturnRC (autoCaller.rc());
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /* no need to lock, this is const */
c936b605260fac01308e3f63b869f401321c52b3vboxsync    *minVRAM = SchemaDefs::MinGuestVRAM;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    return S_OK;
c936b605260fac01308e3f63b869f401321c52b3vboxsync}
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsyncSTDMETHODIMP SystemProperties::COMGETTER(MaxGuestVRAM)(ULONG *maxVRAM)
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
c936b605260fac01308e3f63b869f401321c52b3vboxsync    if (!maxVRAM)
c936b605260fac01308e3f63b869f401321c52b3vboxsync        return E_POINTER;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    AutoCaller autoCaller (this);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    CheckComRCReturnRC (autoCaller.rc());
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /* no need to lock, this is const */
c936b605260fac01308e3f63b869f401321c52b3vboxsync    *maxVRAM = SchemaDefs::MaxGuestVRAM;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    return S_OK;
c936b605260fac01308e3f63b869f401321c52b3vboxsync}
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsyncSTDMETHODIMP SystemProperties::COMGETTER(MaxGuestMonitors)(ULONG *maxMonitors)
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync    if (!maxMonitors)
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync        return E_POINTER;
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync    AutoCaller autoCaller (this);
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync    CheckComRCReturnRC (autoCaller.rc());
90e8b000bdf708e8465e9c2cd7ecf1339c27c4aavboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /* no need to lock, this is const */
c936b605260fac01308e3f63b869f401321c52b3vboxsync    *maxMonitors = SchemaDefs::MaxGuestMonitors;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    return S_OK;
c936b605260fac01308e3f63b869f401321c52b3vboxsync}
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsyncSTDMETHODIMP SystemProperties::COMGETTER(MaxVDISize)(ULONG64 *maxVDISize)
c936b605260fac01308e3f63b869f401321c52b3vboxsync{
c936b605260fac01308e3f63b869f401321c52b3vboxsync    if (!maxVDISize)
c936b605260fac01308e3f63b869f401321c52b3vboxsync        return E_POINTER;
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    AutoCaller autoCaller (this);
c936b605260fac01308e3f63b869f401321c52b3vboxsync    CheckComRCReturnRC (autoCaller.rc());
c936b605260fac01308e3f63b869f401321c52b3vboxsync
c936b605260fac01308e3f63b869f401321c52b3vboxsync    /** The BIOS supports currently 32 bit LBA numbers (implementing the full
c936b605260fac01308e3f63b869f401321c52b3vboxsync     * 48 bit range is in theory trivial, but the crappy compiler makes things
c936b605260fac01308e3f63b869f401321c52b3vboxsync     * more difficult). This translates to almost 2 TBytes (to be on the safe
c936b605260fac01308e3f63b869f401321c52b3vboxsync     * side, the reported limit is 1 MiByte less than that, as the total number
c936b605260fac01308e3f63b869f401321c52b3vboxsync     * of sectors should fit in 32 bits, too), which should bei enough for
c936b605260fac01308e3f63b869f401321c52b3vboxsync     * the moment. The virtual ATA disks support complete LBA48 (although for
c936b605260fac01308e3f63b869f401321c52b3vboxsync     * example iSCSI is also currently limited to 32 bit LBA), so the
     * theoretical maximum disk size is 128 PiByte. The user interface cannot
     * cope with this in a reasonable way yet. */
    /* no need to lock, this is const */
    *maxVDISize = 2048 * 1024 - 1;

    return S_OK;
}

STDMETHODIMP SystemProperties::COMGETTER(NetworkAdapterCount)(ULONG *count)
{
    if (!count)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* no need to lock, this is const */
    *count = SchemaDefs::NetworkAdapterCount;

    return S_OK;
}

STDMETHODIMP SystemProperties::COMGETTER(SerialPortCount)(ULONG *count)
{
    if (!count)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* no need to lock, this is const */
    *count = SchemaDefs::SerialPortCount;

    return S_OK;
}

STDMETHODIMP SystemProperties::COMGETTER(ParallelPortCount)(ULONG *count)
{
    if (!count)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* no need to lock, this is const */
    *count = SchemaDefs::ParallelPortCount;

    return S_OK;
}

STDMETHODIMP SystemProperties::COMGETTER(MaxBootPosition)(ULONG *aMaxBootPosition)
{
    if (!aMaxBootPosition)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* no need to lock, this is const */
    *aMaxBootPosition = SchemaDefs::MaxBootPosition;

    return S_OK;
}

STDMETHODIMP SystemProperties::COMGETTER(DefaultMachineFolder) (BSTR *aDefaultMachineFolder)
{
    if (!aDefaultMachineFolder)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoReadLock alock (this);

    mDefaultMachineFolderFull.cloneTo (aDefaultMachineFolder);

    return S_OK;
}

STDMETHODIMP SystemProperties::COMSETTER(DefaultMachineFolder) (INPTR BSTR aDefaultMachineFolder)
{
    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* VirtualBox::saveSettings() needs a write lock */
    AutoMultiWriteLock2 alock (mParent, this);

    HRESULT rc = setDefaultMachineFolder (aDefaultMachineFolder);
    if (SUCCEEDED (rc))
        rc = mParent->saveSettings();

    return rc;
}

STDMETHODIMP SystemProperties::COMGETTER(DefaultHardDiskFolder) (BSTR *aDefaultHardDiskFolder)
{
    if (!aDefaultHardDiskFolder)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoReadLock alock (this);

    mDefaultHardDiskFolderFull.cloneTo (aDefaultHardDiskFolder);

    return S_OK;
}

STDMETHODIMP SystemProperties::COMSETTER(DefaultHardDiskFolder) (INPTR BSTR aDefaultHardDiskFolder)
{
    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* VirtualBox::saveSettings() needs a write lock */
    AutoMultiWriteLock2 alock (mParent, this);

    HRESULT rc = setDefaultHardDiskFolder (aDefaultHardDiskFolder);
    if (SUCCEEDED (rc))
        rc = mParent->saveSettings();

    return rc;
}

STDMETHODIMP SystemProperties::
COMGETTER(HardDiskFormats) (ComSafeArrayOut (IHardDiskFormat *, aHardDiskFormats))
{
    if (ComSafeArrayOutIsNull (aHardDiskFormats))
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoReadLock alock (this);

    SafeIfaceArray <IHardDiskFormat> hardDiskFormats (mHardDiskFormats);
    hardDiskFormats.detachTo (ComSafeArrayOutArg (aHardDiskFormats));

    return S_OK;
}

STDMETHODIMP SystemProperties::COMGETTER(DefaultHardDiskFormat) (BSTR *aDefaultHardDiskFormat)
{
    if (!aDefaultHardDiskFormat)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoReadLock alock (this);

    mDefaultHardDiskFormat.cloneTo (aDefaultHardDiskFormat);

    return S_OK;
}

STDMETHODIMP SystemProperties::COMSETTER(DefaultHardDiskFormat) (INPTR BSTR aDefaultHardDiskFormat)
{
    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* VirtualBox::saveSettings() needs a write lock */
    AutoMultiWriteLock2 alock (mParent, this);

    HRESULT rc = setDefaultHardDiskFormat (aDefaultHardDiskFormat);
    if (SUCCEEDED (rc))
        rc = mParent->saveSettings();

    return rc;
}

STDMETHODIMP SystemProperties::COMGETTER(RemoteDisplayAuthLibrary) (BSTR *aRemoteDisplayAuthLibrary)
{
    if (!aRemoteDisplayAuthLibrary)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoReadLock alock (this);

    mRemoteDisplayAuthLibrary.cloneTo (aRemoteDisplayAuthLibrary);

    return S_OK;
}

STDMETHODIMP SystemProperties::COMSETTER(RemoteDisplayAuthLibrary) (INPTR BSTR aRemoteDisplayAuthLibrary)
{
    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* VirtualBox::saveSettings() needs a write lock */
    AutoMultiWriteLock2 alock (mParent, this);

    HRESULT rc = setRemoteDisplayAuthLibrary (aRemoteDisplayAuthLibrary);
    if (SUCCEEDED (rc))
        rc = mParent->saveSettings();

    return rc;
}

STDMETHODIMP SystemProperties::COMGETTER(WebServiceAuthLibrary) (BSTR *aWebServiceAuthLibrary)
{
    if (!aWebServiceAuthLibrary)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoReadLock alock (this);

    mWebServiceAuthLibrary.cloneTo (aWebServiceAuthLibrary);

    return S_OK;
}

STDMETHODIMP SystemProperties::COMSETTER(WebServiceAuthLibrary) (INPTR BSTR aWebServiceAuthLibrary)
{
    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* VirtualBox::saveSettings() needs a write lock */
    AutoMultiWriteLock2 alock (mParent, this);

    HRESULT rc = setWebServiceAuthLibrary (aWebServiceAuthLibrary);
    if (SUCCEEDED (rc))
        rc = mParent->saveSettings();

    return rc;
}

STDMETHODIMP SystemProperties::COMGETTER(HWVirtExEnabled) (BOOL *enabled)
{
    if (!enabled)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoReadLock alock (this);

    *enabled = mHWVirtExEnabled;

    return S_OK;
}

STDMETHODIMP SystemProperties::COMSETTER(HWVirtExEnabled) (BOOL enabled)
{
    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* VirtualBox::saveSettings() needs a write lock */
    AutoMultiWriteLock2 alock (mParent, this);

    mHWVirtExEnabled = enabled;

    HRESULT rc = mParent->saveSettings();

    return rc;
}

STDMETHODIMP SystemProperties::COMGETTER(LogHistoryCount) (ULONG *count)
{
    if (!count)
        return E_POINTER;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoReadLock alock (this);

    *count = mLogHistoryCount;

    return S_OK;
}

STDMETHODIMP SystemProperties::COMSETTER(LogHistoryCount) (ULONG count)
{
    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    /* VirtualBox::saveSettings() needs a write lock */
    AutoMultiWriteLock2 alock (mParent, this);

    mLogHistoryCount = count;

    HRESULT rc = mParent->saveSettings();

    return rc;
}

// public methods only for internal purposes
/////////////////////////////////////////////////////////////////////////////

HRESULT SystemProperties::loadSettings (const settings::Key &aGlobal)
{
    using namespace settings;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoWriteLock alock (this);

    AssertReturn (!aGlobal.isNull(), E_FAIL);

    HRESULT rc = S_OK;

    Key properties = aGlobal.key ("SystemProperties");

    Bstr bstr;

    bstr = properties.stringValue ("defaultMachineFolder");
    rc = setDefaultMachineFolder (bstr);
    CheckComRCReturnRC (rc);

    bstr = properties.stringValue ("defaultHardDiskFolder");
    rc = setDefaultHardDiskFolder (bstr);
    CheckComRCReturnRC (rc);

    bstr = properties.stringValue ("defaultHardDiskFormat");
    rc = setDefaultHardDiskFormat (bstr);
    CheckComRCReturnRC (rc);

    bstr = properties.stringValue ("remoteDisplayAuthLibrary");
    rc = setRemoteDisplayAuthLibrary (bstr);
    CheckComRCReturnRC (rc);

    bstr = properties.stringValue ("webServiceAuthLibrary");
    rc = setWebServiceAuthLibrary (bstr);
    CheckComRCReturnRC (rc);

    /* Note: not <BOOL> because Win32 defines BOOL as int */
    mHWVirtExEnabled = properties.valueOr <bool> ("HWVirtExEnabled", false);

    mLogHistoryCount = properties.valueOr <ULONG> ("LogHistoryCount", 3);

    return S_OK;
}

HRESULT SystemProperties::saveSettings (settings::Key &aGlobal)
{
    using namespace settings;

    AutoCaller autoCaller (this);
    CheckComRCReturnRC (autoCaller.rc());

    AutoReadLock alock (this);

    ComAssertRet (!aGlobal.isNull(), E_FAIL);

    /* first, delete the entry */
    Key properties = aGlobal.findKey ("SystemProperties");
    if (!properties.isNull())
        properties.zap();
    /* then, recreate it */
    properties = aGlobal.createKey ("SystemProperties");

    if (mDefaultMachineFolder)
        properties.setValue <Bstr> ("defaultMachineFolder", mDefaultMachineFolder);

    if (mDefaultHardDiskFolder)
        properties.setValue <Bstr> ("defaultHardDiskFolder", mDefaultHardDiskFolder);

    if (mDefaultHardDiskFormat)
        properties.setValue <Bstr> ("defaultHardDiskFormat", mDefaultHardDiskFormat);

    if (mRemoteDisplayAuthLibrary)
        properties.setValue <Bstr> ("remoteDisplayAuthLibrary", mRemoteDisplayAuthLibrary);

    if (mWebServiceAuthLibrary)
        properties.setValue <Bstr> ("webServiceAuthLibrary", mWebServiceAuthLibrary);

    properties.setValue <bool> ("HWVirtExEnabled", !!mHWVirtExEnabled);

    properties.setValue <ULONG> ("LogHistoryCount", mLogHistoryCount);

    return S_OK;
}

/**
 * Rerurns a hard disk format object corresponding to the given format
 * identifier or null if no such format.
 *
 * @param aFormat   Format identifier.
 *
 * @return ComObjPtr<HardDiskFormat>
 */
ComObjPtr <HardDiskFormat> SystemProperties::hardDiskFormat (const BSTR aFormat)
{
    ComObjPtr <HardDiskFormat> format;

    AutoCaller autoCaller (this);
    AssertComRCReturn (autoCaller.rc(), format);

    AutoReadLock alock (this);

    for (HardDiskFormatList::const_iterator it = mHardDiskFormats.begin();
         it != mHardDiskFormats.end(); ++ it)
    {
        /* HardDiskFormat is all const, no need to lock */

        if ((*it)->id() == aFormat)
        {
            format = *it;
            break;
        }
    }

    return format;
}

// private methods
/////////////////////////////////////////////////////////////////////////////

HRESULT SystemProperties::setDefaultMachineFolder (const BSTR aPath)
{
    Utf8Str path;
    if (aPath && *aPath)
        path = aPath;
    else
        path = "Machines";

    /* get the full file name */
    Utf8Str folder;
    int vrc = mParent->calculateFullPath (path, folder);
    if (RT_FAILURE (vrc))
        return setError (E_FAIL,
            tr ("Invalid default machine folder '%ls' (%Rrc)"),
            path.raw(), vrc);

    mDefaultMachineFolder = path;
    mDefaultMachineFolderFull = folder;

    return S_OK;
}

HRESULT SystemProperties::setDefaultHardDiskFolder (const BSTR aPath)
{
    Utf8Str path;
    if (aPath && *aPath)
        path = aPath;
    else
        path = "HardDisks";

    /* get the full file name */
    Utf8Str folder;
    int vrc = mParent->calculateFullPath (path, folder);
    if (RT_FAILURE (vrc))
        return setError (E_FAIL,
            tr ("Invalid default hard disk folder '%ls' (%Rrc)"),
            path.raw(), vrc);

    mDefaultHardDiskFolder = path;
    mDefaultHardDiskFolderFull = folder;

    return S_OK;
}

HRESULT SystemProperties::setDefaultHardDiskFormat (const BSTR aFormat)
{
    if (aFormat && *aFormat)
        mDefaultHardDiskFormat = aFormat;
    else
        mDefaultHardDiskFormat = "VDI";

    return S_OK;
}

HRESULT SystemProperties::setRemoteDisplayAuthLibrary (const BSTR aPath)
{
    if (aPath && *aPath)
        mRemoteDisplayAuthLibrary = aPath;
    else
        mRemoteDisplayAuthLibrary = "VRDPAuth";

    return S_OK;
}

HRESULT SystemProperties::setWebServiceAuthLibrary (const BSTR aPath)
{
    if (aPath && *aPath)
        mWebServiceAuthLibrary = aPath;
    else
        mWebServiceAuthLibrary = "VRDPAuth";

    return S_OK;
}