VBoxGuestR3LibHostVersion.cpp revision a70114bc30e757afa26f4a66475f54836a80497c
/* $Id: */
/** @file
* VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, host version check.
*/
/*
* Copyright (C) 2009 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;
* 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.
*/
/*******************************************************************************
* Header Files *
*******************************************************************************/
#include <stdio.h> /* Required for sscanf */
#ifdef RT_OS_WINDOWS
#define WIN32_LEAN_AND_MEAN
#include <windows.h>
#endif
#include "VBGLR3Internal.h"
/**
* Compares two VirtualBox version strings and returns the result.
*
* Requires strings in form of "majorVer.minorVer.build".
*
* @returns 0 if equal, 1 if Ver1 is greater, 2 if Ver2 is greater.
*
* @param pszVer1 First version string to compare.
* @param pszVer2 First version string to compare.
*
* @todo Move this to IPRT and add support for more dots, suffixes and whatnot.
*/
{
/** @todo r=bird: not checking the return code, may be using uninitialized
* variables... I'll fix this when moving into the runtime. */
int rc = 0;
if (iVer1Final > iVer2Final)
rc = 1;
else if (iVer2Final > iVer1Final)
rc = 2;
return rc;
}
/**
* Checks for a Guest Additions update by comparing the installed version on the
* guest and the reported host version.
*
* @returns VBox status code
*
* @param u32ClientId The client id returned by
* VbglR3InfoSvcConnect().
* @param pfUpdate Receives pointer to boolean flag indicating
* whether an update was found or not.
* @param ppszHostVersion Receives pointer of allocated version string.
* The returned pointer must be freed using
* VbglR3GuestPropReadValueFree(). Always set to
* NULL.
* @param ppszGuestVersion Receives pointer of allocated revision string.
* The returned pointer must be freed using
* VbglR3GuestPropReadValueFree(). Always set to
* NULL.
*/
VBGLR3DECL(int) VbglR3HostVersionCheckForUpdate(uint32_t u32ClientId, bool *pfUpdate, char **ppszHostVersion, char **ppszGuestVersion)
{
Assert(u32ClientId > 0);
*ppszHostVersion = NULL;
*ppszGuestVersion = NULL;
/* We assume we have an update initially.
Every block down below is allowed to veto */
*pfUpdate = true;
/* Do we need to do all this stuff? */
char *pszCheckHostVersion;
int rc = VbglR3GuestPropReadValueAlloc(u32ClientId, "/VirtualBox/GuestAdd/CheckHostVersion", &pszCheckHostVersion);
if (RT_FAILURE(rc))
{
if (rc == VERR_NOT_FOUND)
else
}
else
{
/* Only don't do the check if we have a valid "0" in it */
{
LogRel(("No host version update check performed (disabled).\n"));
*pfUpdate = false;
}
}
/* Collect all needed information */
/* Make sure we only notify the user once by comparing the host version with
* the last checked host version (if any) */
{
/* Look up host version */
if (RT_FAILURE(rc))
{
}
else
{
/* Get last checked host version */
char *pszLastCheckedHostVersion;
if (RT_SUCCESS(rc))
{
*pfUpdate = false; /* We already notified this version, skip */
}
{
LogFlow(("Never checked a host version before.\n"));
rc = VINF_SUCCESS;
}
}
/* Look up guest version */
if (RT_SUCCESS(rc))
{
if (RT_FAILURE(rc))
}
}
/* Do the actual version comparison (if needed, see block(s) above) */
{
if (VbglR3HostVersionCompare(*ppszHostVersion, *ppszGuestVersion) == 1) /* Is host version greater than guest add version? */
{
/* Yay, we have an update! */
LogRel(("Guest Additions update found! Please upgrade this machine to the latest Guest Additions.\n"));
}
else
{
/* How sad ... */
*pfUpdate = false;
}
}
/* Cleanup on failure */
if (RT_FAILURE(rc))
{
if (*ppszHostVersion)
{
*ppszHostVersion = NULL;
}
if (*ppszGuestVersion)
{
*ppszGuestVersion = NULL;
}
}
return rc;
}
/** Retrieves the last checked host version.
*
* @returns VBox status code.
*
* @param u32ClientId The client id returned by VbglR3InfoSvcConnect().
* @param ppszVer Receives pointer of allocated version string.
* The returned pointer must be freed using RTStrFree() on VINF_SUCCESS.
*/
{
Assert(u32ClientId > 0);
return VbglR3GuestPropReadValueAlloc(u32ClientId, "/VirtualBox/GuestAdd/HostVerLastChecked", ppszVer);
}
/** Stores the last checked host version for later lookup.
* Requires strings in form of "majorVer.minorVer.build".
*
* @returns VBox status code.
*
* @param u32ClientId The client id returned by VbglR3InfoSvcConnect().
* @param pszVer Pointer to version string to store.
*/
{
Assert(u32ClientId > 0);
}