VBoxGuestR3LibHostVersion.cpp revision c58f1213e628a545081c70e26c6b67a841cff880
/* $Id: */
/** @file
* VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, host version check.
*/
/*
* Copyright (C) 2011 Oracle Corporation
*
* 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.
*
* The contents of this file may alternatively be used under the terms
* of the Common Development and Distribution License Version 1.0
* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
* VirtualBox OSE distribution, in which case the provisions of the
* CDDL are applicable instead of those of the GPL.
*
* You may elect to license modified versions of this file under the
* terms and conditions of either the GPL or the CDDL or both.
*/
/*******************************************************************************
* Header Files *
*******************************************************************************/
#include <stdio.h> /* Required for sscanf */
#ifdef RT_OS_WINDOWS
#define WIN32_LEAN_AND_MEAN
#include <windows.h>
#endif
#include "VBGLR3Internal.h"
/**
* 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))
{
NULL /* Revision not needed here */);
if (RT_FAILURE(rc))
}
}
/* Do the actual version comparison (if needed, see block(s) above) */
{
if (RTStrVersionCompare(*ppszHostVersion, *ppszGuestVersion) > 0) /* 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);
}