VBoxGuestR3LibGuestCtrl.cpp revision ed24120b1d8a2eddf4291a9654cf45b2372135ab
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/* $Id$ */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** @file
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, guest control.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/*
e64031e20c39650a7bc902a3e1aba613b9415deevboxsync * Copyright (C) 2010 Oracle Corporation
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * available from http://www.virtualbox.org. This file is free software;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * you can redistribute it and/or modify it under the terms of the GNU
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * General Public License (GPL) as published by the Free Software
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * The contents of this file may alternatively be used under the terms
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * of the Common Development and Distribution License Version 1.0
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * VirtualBox OSE distribution, in which case the provisions of the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * CDDL are applicable instead of those of the GPL.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * You may elect to license modified versions of this file under the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * terms and conditions of either the GPL or the CDDL or both.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/*******************************************************************************
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync* Header Files *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync*******************************************************************************/
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/string.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/mem.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/assert.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/cpp/autores.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/stdarg.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <VBox/log.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <VBox/HostServices/GuestControlSvc.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include "VBGLR3Internal.h"
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/*******************************************************************************
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync* Structures and Typedefs *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync*******************************************************************************/
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncusing namespace guestControl;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/**
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Connects to the guest control service.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param pu32ClientId Where to put the client id on success. The client id
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * must be passed to all the other calls to the service.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlConnect(uint32_t *pu32ClientId)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync{
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VBoxGuestHGCMConnectInfo Info;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Info.result = VERR_WRONG_ORDER;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Info.Loc.type = VMMDevHGCMLoc_LocalHost_Existing;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync RT_ZERO(Info.Loc.u);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync strcpy(Info.Loc.u.host.achName, "VBoxGuestControlSvc");
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Info.u32ClientID = UINT32_MAX; /* try make valgrid shut up. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CONNECT, &Info, sizeof(Info));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync {
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync rc = Info.result;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *pu32ClientId = Info.u32ClientID;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync }
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync return rc;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync}
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/**
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Disconnect from the guest control service.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param u32ClientId The client id returned by VbglR3GuestCtrlConnect().
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlDisconnect(uint32_t u32ClientId)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync{
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VBoxGuestHGCMDisconnectInfo Info;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Info.result = VERR_WRONG_ORDER;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Info.u32ClientID = u32ClientId;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_DISCONNECT, &Info, sizeof(Info));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync rc = Info.result;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync return rc;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync}
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/**
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Gets a host message.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This will block until a message becomes available.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param u32ClientId The client id returned by VbglR3GuestCtrlConnect().
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param puMsg Where to store the message id.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param puNumParms Where to store the number of parameters which will be received
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * in a second call to the host.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
6747811f5505e9275a79882daf73942490558270vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlGetHostMsg(uint32_t u32ClientId, uint32_t *puMsg, uint32_t *puNumParms, uint32_t u32Timeout)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync{
5d69af51557e9e9db029ecd243e820383af49b18vboxsync AssertPtr(puMsg);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync AssertPtr(puNumParms);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VBoxGuestCtrlHGCMMsgType Msg;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync Msg.hdr.result = VERR_WRONG_ORDER;
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync Msg.hdr.u32ClientID = u32ClientId;
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync Msg.hdr.u32Function = GUEST_GET_HOST_MSG; /* Tell the host we want our next command. */
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync Msg.hdr.cParms = 2; /* Just peek for the next message! */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmUInt32Set(&Msg.msg, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmUInt32Set(&Msg.num_parms, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync {
5d69af51557e9e9db029ecd243e820383af49b18vboxsync rc = VbglHGCMParmUInt32Get(&Msg.msg, puMsg);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync if (RT_SUCCESS(rc))
5d69af51557e9e9db029ecd243e820383af49b18vboxsync rc = VbglHGCMParmUInt32Get(&Msg.num_parms, puNumParms);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync if (RT_SUCCESS(rc))
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync rc = Msg.hdr.result;
5d69af51557e9e9db029ecd243e820383af49b18vboxsync /* Ok, so now we know what message type and how much parameters there are. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync }
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync return rc;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync}
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/**
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Allocates and gets host data, based on the message id.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This will block until data becomes available.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param u32ClientId The client id returned by VbglR3GuestCtrlConnect().
468c2bcb36eb9a032f5dd0fcb34db10bd58e9996vboxsync * @param uNumParms
de210ca38246009981a22de928a52566c8c53970vboxsync ** @todo Docs!
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
68e97031354932600728a42c3d454abf04f8c8d1vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecGetHostCmd(uint32_t u32ClientId, uint32_t uNumParms,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync uint32_t *puContext,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync char *pszCmd, uint32_t cbCmd,
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync uint32_t *puFlags,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync char *pszArgs, uint32_t cbArgs, uint32_t *puNumArgs,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync char *pszEnv, uint32_t *pcbEnv, uint32_t *puNumEnvVars,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync char *pszStdIn, uint32_t cbStdIn,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync char *pszStdOut, uint32_t cbStdOut,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync char *pszStdErr, uint32_t cbStdErr,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync char *pszUser, uint32_t cbUser,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync char *pszPassword, uint32_t cbPassword,
468c2bcb36eb9a032f5dd0fcb34db10bd58e9996vboxsync uint32_t *puTimeLimit)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync{
68e97031354932600728a42c3d454abf04f8c8d1vboxsync AssertPtr(puContext);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pszCmd);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(puFlags);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pszArgs);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(puNumArgs);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pszEnv);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pcbEnv);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(puNumEnvVars);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pszStdIn);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pszStdOut);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pszStdOut);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pszStdErr);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pszUser);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(pszPassword);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync AssertPtr(puTimeLimit);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VBoxGuestCtrlHGCMMsgExecCmd Msg;
468c2bcb36eb9a032f5dd0fcb34db10bd58e9996vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Msg.hdr.result = VERR_WRONG_ORDER;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Msg.hdr.u32ClientID = u32ClientId;
5d69af51557e9e9db029ecd243e820383af49b18vboxsync Msg.hdr.u32Function = GUEST_GET_HOST_MSG;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Msg.hdr.cParms = uNumParms;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
68e97031354932600728a42c3d454abf04f8c8d1vboxsync VbglHGCMParmUInt32Set(&Msg.context, 0); /** @todo Put this some header struct! */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmPtrSet(&Msg.cmd, pszCmd, cbCmd);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmUInt32Set(&Msg.flags, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmUInt32Set(&Msg.num_args, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmPtrSet(&Msg.args, pszArgs, cbArgs);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmUInt32Set(&Msg.num_env, 0);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync VbglHGCMParmUInt32Set(&Msg.cb_env, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmPtrSet(&Msg.env, pszEnv, *pcbEnv);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmPtrSet(&Msg.std_in, pszStdIn, cbStdIn);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmPtrSet(&Msg.std_out, pszStdOut, cbStdOut);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmPtrSet(&Msg.std_err, pszStdErr, cbStdErr);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmPtrSet(&Msg.username, pszUser, cbUser);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmPtrSet(&Msg.password, pszPassword, cbPassword);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync VbglHGCMParmUInt32Set(&Msg.timeout, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync {
5d69af51557e9e9db029ecd243e820383af49b18vboxsync int rc2 = Msg.hdr.result;
5d69af51557e9e9db029ecd243e820383af49b18vboxsync if (RT_FAILURE(rc2))
5d69af51557e9e9db029ecd243e820383af49b18vboxsync {
5d69af51557e9e9db029ecd243e820383af49b18vboxsync rc = rc2;
5d69af51557e9e9db029ecd243e820383af49b18vboxsync }
5d69af51557e9e9db029ecd243e820383af49b18vboxsync else
5d69af51557e9e9db029ecd243e820383af49b18vboxsync {
68e97031354932600728a42c3d454abf04f8c8d1vboxsync Msg.context.GetUInt32(puContext);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync Msg.flags.GetUInt32(puFlags);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync Msg.num_args.GetUInt32(puNumArgs);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync Msg.num_env.GetUInt32(puNumEnvVars);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync Msg.cb_env.GetUInt32(pcbEnv);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync Msg.timeout.GetUInt32(puTimeLimit);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync }
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync }
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync return rc;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync}
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync/**
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * Allocates and gets host data, based on the message id.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync *
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * This will block until data becomes available.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync *
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * @returns VBox status code.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * @param u32ClientId The client id returned by VbglR3GuestCtrlConnect().
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * @param uNumParms
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync ** @todo Docs!
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync */
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecGetHostCmdOutput(uint32_t u32ClientId, uint32_t uNumParms,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync uint32_t *puContext, uint32_t *puPID,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync uint32_t *puHandle, uint32_t *puFlags)
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync{
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync AssertPtr(puContext);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync AssertPtr(puPID);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VBoxGuestCtrlHGCMMsgExecOut Msg;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.hdr.result = VERR_WRONG_ORDER;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.hdr.u32ClientID = u32ClientId;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.hdr.u32Function = GUEST_GET_HOST_MSG;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.hdr.cParms = uNumParms;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VbglHGCMParmUInt32Set(&Msg.context, 0); /** @todo Put this some header struct! */
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VbglHGCMParmUInt32Set(&Msg.pid, 0);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VbglHGCMParmUInt32Set(&Msg.handle, 0);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VbglHGCMParmUInt32Set(&Msg.flags, 0);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync if (RT_SUCCESS(rc))
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync {
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync int rc2 = Msg.hdr.result;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync if (RT_FAILURE(rc2))
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync {
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync rc = rc2;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync }
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync else
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync {
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.context.GetUInt32(puContext);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.pid.GetUInt32(puPID);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.handle.GetUInt32(puHandle);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.flags.GetUInt32(puFlags);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync }
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync }
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync return rc;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync}
de210ca38246009981a22de928a52566c8c53970vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync/**
de210ca38246009981a22de928a52566c8c53970vboxsync * Reports the process status (along with some other stuff) to the host.
de210ca38246009981a22de928a52566c8c53970vboxsync *
de210ca38246009981a22de928a52566c8c53970vboxsync * @returns VBox status code.
de210ca38246009981a22de928a52566c8c53970vboxsync ** @todo Docs!
de210ca38246009981a22de928a52566c8c53970vboxsync */
f8df398d066204e2bf0ba209ea3554fc113fb484vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecReportStatus(uint32_t u32ClientId,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync uint32_t u32Context,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync uint32_t u32PID,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync uint32_t u32Status,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync uint32_t u32Flags,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync void *pvData,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync uint32_t cbData)
de210ca38246009981a22de928a52566c8c53970vboxsync{
de210ca38246009981a22de928a52566c8c53970vboxsync VBoxGuestCtrlHGCMMsgExecStatus Msg;
de210ca38246009981a22de928a52566c8c53970vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync Msg.hdr.result = VERR_WRONG_ORDER;
de210ca38246009981a22de928a52566c8c53970vboxsync Msg.hdr.u32ClientID = u32ClientId;
de210ca38246009981a22de928a52566c8c53970vboxsync Msg.hdr.u32Function = GUEST_EXEC_SEND_STATUS;
68e97031354932600728a42c3d454abf04f8c8d1vboxsync Msg.hdr.cParms = 5;
de210ca38246009981a22de928a52566c8c53970vboxsync
68e97031354932600728a42c3d454abf04f8c8d1vboxsync VbglHGCMParmUInt32Set(&Msg.context, u32Context);
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync VbglHGCMParmUInt32Set(&Msg.pid, u32PID);
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync VbglHGCMParmUInt32Set(&Msg.status, u32Status);
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync VbglHGCMParmUInt32Set(&Msg.flags, u32Flags);
de210ca38246009981a22de928a52566c8c53970vboxsync VbglHGCMParmPtrSet(&Msg.data, pvData, cbData);
de210ca38246009981a22de928a52566c8c53970vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
de210ca38246009981a22de928a52566c8c53970vboxsync if (RT_SUCCESS(rc))
de210ca38246009981a22de928a52566c8c53970vboxsync {
de210ca38246009981a22de928a52566c8c53970vboxsync int rc2 = Msg.hdr.result;
de210ca38246009981a22de928a52566c8c53970vboxsync if (RT_FAILURE(rc2))
de210ca38246009981a22de928a52566c8c53970vboxsync rc = rc2;
de210ca38246009981a22de928a52566c8c53970vboxsync }
f8df398d066204e2bf0ba209ea3554fc113fb484vboxsync return rc;
de210ca38246009981a22de928a52566c8c53970vboxsync}
de210ca38246009981a22de928a52566c8c53970vboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync/**
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * Sends output (from stdout/stderr) from a running process.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync *
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * @returns VBox status code.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync ** @todo Docs!
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync */
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecSendOut(uint32_t u32ClientId,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync uint32_t u32Context,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync uint32_t u32PID,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync uint32_t u32Handle,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync uint32_t u32Flags,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync void *pvData,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync uint32_t cbData)
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync{
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VBoxGuestCtrlHGCMMsgExecOut Msg;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.hdr.result = VERR_WRONG_ORDER;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.hdr.u32ClientID = u32ClientId;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.hdr.u32Function = GUEST_EXEC_SEND_OUTPUT;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync Msg.hdr.cParms = 5;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VbglHGCMParmUInt32Set(&Msg.context, u32Context);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VbglHGCMParmUInt32Set(&Msg.pid, u32PID);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VbglHGCMParmUInt32Set(&Msg.handle, u32Handle);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VbglHGCMParmUInt32Set(&Msg.flags, u32Flags);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync VbglHGCMParmPtrSet(&Msg.data, pvData, cbData);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync if (RT_SUCCESS(rc))
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync {
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync int rc2 = Msg.hdr.result;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync if (RT_FAILURE(rc2))
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync rc = rc2;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync }
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync return rc;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync}
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync