VBoxGuestR3LibCpuHotPlug.cpp revision e6660f4933111b0649ffa77483102881f4e75c3b
/* $Id$ */
/** @file
* VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, CPU Hot Plugging.
*/
/*
* Copyright (C) 2010 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;
* you can redistribute it and/or modify it under the terms of the GNU
* 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.
*
* 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 "VBGLR3Internal.h"
/**
* Initialize CPU hot plugging.
*
* This will enable the CPU hot plugging events.
*
* @returns VBox status code.
*/
VBGLR3DECL(int) VbglR3CpuHotPlugInit(void)
{
int rc = VbglR3CtlFilterMask(VMMDEV_EVENT_CPU_HOTPLUG, 0);
if (RT_FAILURE(rc))
return rc;
VMMDevCpuHotPlugStatusRequest Req;
vmmdevInitRequest(&Req.header, VMMDevReq_SetCpuHotPlugStatus);
Req.enmStatusType = VMMDevCpuStatusType_Enable;
rc = vbglR3GRPerform(&Req.header);
if (RT_FAILURE(rc))
VbglR3CtlFilterMask(0, VMMDEV_EVENT_CPU_HOTPLUG);
return rc;
}
/**
* Terminate CPU hot plugging.
*
* This will disable the CPU hot plugging events.
*
* @returns VBox status.
*/
VBGLR3DECL(int) VbglR3CpuHotPlugTerm(void)
{
/* Clear the events. */
VbglR3CtlFilterMask(0, VMMDEV_EVENT_CPU_HOTPLUG);
VMMDevCpuHotPlugStatusRequest Req;
vmmdevInitRequest(&Req.header, VMMDevReq_SetCpuHotPlugStatus);
Req.enmStatusType = VMMDevCpuStatusType_Disable;
return vbglR3GRPerform(&Req.header);
}
/**
* Waits for a CPU hot plugging event and retrive the data associated with it.
*
* @returns VBox status code.
* @param penmEventType Where to store the event type on success.
* @param pidCpuCore Where to store the CPU core ID on success.
* @param pidCpuPackage Where to store the CPU package ID on success.
*/
VBGLR3DECL(int) VbglR3CpuHotPlugWaitForEvent(VMMDevCpuEventType *penmEventType, uint32_t *pidCpuCore, uint32_t *pidCpuPackage)
{
AssertPtrReturn(penmEventType, VERR_INVALID_POINTER);
AssertPtrReturn(pidCpuCore, VERR_INVALID_POINTER);
AssertPtrReturn(pidCpuPackage, VERR_INVALID_POINTER);
VBoxGuestWaitEventInfo waitEvent;
waitEvent.u32TimeoutIn = RT_INDEFINITE_WAIT;
waitEvent.u32EventMaskIn = VMMDEV_EVENT_CPU_HOTPLUG;
waitEvent.u32Result = VBOXGUEST_WAITEVENT_ERROR;
waitEvent.u32EventFlagsOut = 0;
int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_WAITEVENT, &waitEvent, sizeof(waitEvent));
if (RT_SUCCESS(rc))
{
/* did we get the right event? */
if (waitEvent.u32EventFlagsOut & VMMDEV_EVENT_CPU_HOTPLUG)
{
VMMDevGetCpuHotPlugRequest Req;
/* get the CPU hot plugging request */
vmmdevInitRequest(&Req.header, VMMDevReq_GetCpuHotPlugRequest);
Req.idCpuCore = UINT32_MAX;
Req.idCpuPackage = UINT32_MAX;
Req.enmEventType = VMMDevCpuEventType_None;
rc = vbglR3GRPerform(&Req.header);
if (RT_SUCCESS(rc))
{
*penmEventType = Req.enmEventType;
*pidCpuCore = Req.idCpuCore;
*pidCpuPackage = Req.idCpuPackage;
return VINF_SUCCESS;
}
}
else
rc = VERR_TRY_AGAIN;
}
return rc;
}