VBoxGuestR3LibGuestCtrl.cpp revision 468c2bcb36eb9a032f5dd0fcb34db10bd58e9996
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, guest control.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Copyright (C) 2010 Sun Microsystems, Inc.
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 * 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 * 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 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Clara, CA 95054 USA or visit http://www.sun.com if you need
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * additional information or have any questions.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/*******************************************************************************
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync* Header Files *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync*******************************************************************************/
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/*******************************************************************************
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync* Structures and Typedefs *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync*******************************************************************************/
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncusing namespace guestControl;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Connects to the guest control service.
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.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlConnect(uint32_t *pu32ClientId)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync strcpy(Info.Loc.u.host.achName, "VBoxGuestControlSvc");
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Info.u32ClientID = UINT32_MAX; /* try make valgrid shut up. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CONNECT, &Info, sizeof(Info));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Disconnect from the guest control service.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param u32ClientId The client id returned by VbglR3GuestCtrlConnect().
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlDisconnect(uint32_t u32ClientId)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_DISCONNECT, &Info, sizeof(Info));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Gets a host message.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This will block until a message becomes available.
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.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlGetHostMsg(uint32_t u32ClientId, uint32_t *puMsg, uint32_t *puNumParms)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Msg.hdr.u32Function = GUEST_GET_HOST_MSG; /* Tell the host we want our next command. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync rc = VbglHGCMParmUInt32Get(&Msg.num_parms, puNumParms);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync /* Ok, so now we know what message type and how much parameters there are. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Allocates and gets host data, based on the message id.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This will block until data becomes available.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param u32ClientId The client id returned by VbglR3GuestCtrlConnect().
468c2bcb36eb9a032f5dd0fcb34db10bd58e9996vboxsync * @param ppvData
468c2bcb36eb9a032f5dd0fcb34db10bd58e9996vboxsync * @param uNumParms
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlGetHostCmdExec(uint32_t u32ClientId, uint32_t uNumParms,
468c2bcb36eb9a032f5dd0fcb34db10bd58e9996vboxsync char *pszArgs, uint32_t cbArgs, uint32_t *puNumArgs,
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync char *pszEnv, uint32_t *pcbEnv, uint32_t *puNumEnvVars,
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync Msg.hdr.u32Function = GUEST_GET_HOST_MSG_DATA; /* Tell the host we want the actual data of a command. */
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 int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));