VBoxServiceControlExec.cpp revision d4a220c9c1cb851c96d3f7d5c21792a2f8e1a315
/* $Id$ */
/** @file
* VBoxServiceControlExec - Utility functions for process execution.
*/
/*
* Copyright (C) 2010 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.
*/
/*******************************************************************************
* Header Files *
*******************************************************************************/
#include <iprt/semaphore.h>
#include <VBox/VBoxGuestLib.h>
#include "VBoxServiceInternal.h"
#include "VBoxServiceUtils.h"
using namespace guestControl;
extern RTLISTNODE g_GuestControlExecThreads;
/**
* Handle an error event on standard input.
*
* @param hPollSet The polling set.
* @param fPollEvt The event mask returned by RTPollNoResume.
* @param phStdInW The standard input pipe handle.
* @param pStdInBuf The standard input buffer.
*/
static void VBoxServiceControlExecProcHandleStdInErrorEvent(RTPOLLSET hPollSet, uint32_t fPollEvt, PRTPIPE phStdInW,
{
int rc2;
{
}
*phStdInW = NIL_RTPIPE;
pStdInBuf->cbAllocated = 0;
pStdInBuf->fBitBucket = true;
}
/**
* Try write some more data to the standard input of the child.
*
* @returns IPRT status code.
* @param pStdInBuf The standard input buffer.
* @param hStdInW The standard input pipe.
*/
{
if (RT_SUCCESS(rc))
{
}
return rc;
}
/**
* Handle an event indicating we can write to the standard input pipe of the
* child process.
*
* @param hPollSet The polling set.
* @param fPollEvt The event mask returned by RTPollNoResume.
* @param phStdInW The standard input pipe.
* @param pStdInBuf The standard input buffer.
*/
static void VBoxServiceControlExecProcHandleStdInWritableEvent(RTPOLLSET hPollSet, uint32_t fPollEvt, PRTPIPE phStdInW,
{
int rc;
if (!(fPollEvt & RTPOLL_EVT_ERROR))
{
{
/** @todo do we need to do something about this error condition? */
}
{
}
}
else
}
/**
* Handle pending output data or error on standard out, standard error or the
* test pipe.
*
* @returns IPRT status code from client send.
* @param pThread The thread specific data.
* @param hPollSet The polling set.
* @param fPollEvt The event mask returned by RTPollNoResume.
* @param phPipeR The pipe handle.
* @param uHandleId The handle ID.
* @param pszOpcode The opcode for the data upload.
*
* @todo Put the last 4 parameters into a struct!
*/
{
/*
* Try drain the pipe before acting on any errors.
*/
int rc = VINF_SUCCESS;
{
#if 0
#endif
if (RT_SUCCESS(rc))
{
/* Make sure we go another poll round in case there was too much data
for the buffer to hold. */
}
}
else if (RT_FAILURE(rc2))
{
}
/*
* If an error was raised signalled,
*/
if (fPollEvt & RTPOLL_EVT_ERROR)
{
*phPipeR = NIL_RTPIPE;
}
return rc;
}
/**
* Handle a transport event or successful pfnPollIn() call.
*
* @returns IPRT status code from client send.
* @retval VINF_EOF indicates ABORT command.
*
* @param hPollSet The polling set.
* @param fPollEvt The event mask returned by RTPollNoResume.
* @param idPollHnd The handle ID.
* @param hStdInW The standard input pipe.
* @param pStdInBuf The standard input buffer.
*/
static int VBoxServiceControlExecProcHandleTransportEvent(RTPOLLSET hPollSet, uint32_t fPollEvt, uint32_t idPollHnd,
{
int rc = RTPollSetAddPipe(hPollSet, *phStdInW, RTPOLL_EVT_WRITE, 4 /*TXSEXECHNDID_STDIN_WRITABLE*/);
return rc;
}
{
int rc;
int rc2;
bool fProcessAlive = true;
bool fProcessTimedOut = false;
|| hStdOutR != NIL_RTPIPE
|| hStdErrR != NIL_RTPIPE;
? 100 /* need to poll for input */
: 1000; /* need only poll for process exit and aborts */
RTMSINTERVAL cMsPollCur = 0;
/* Assign PID to thread data. */
/*
* Before entering the loop, tell the host that we've started the guest
* and that it's now OK to send input to the process.
*/
/*
* Process input, output, the test pipe and client requests.
*/
while ( RT_SUCCESS(rc)
{
/*
*/
continue;
cMsPollCur = 0; /* no rest until we've checked everything. */
if (RT_SUCCESS(rc2))
{
switch (idPollHnd)
{
case 0 /* TXSEXECHNDID_STDIN */:
break;
case 1 /* TXSEXECHNDID_STDOUT */:
rc = VBoxServiceControlExecProcHandleOutputEvent(pThread, hPollSet, fPollEvt, &hStdOutR, &uStdOutCrc32, 1 /* TXSEXECHNDID_STDOUT */);
break;
case 2 /*TXSEXECHNDID_STDERR */:
rc = VBoxServiceControlExecProcHandleOutputEvent(pThread, hPollSet, fPollEvt, &hStdErrR, &uStdErrCrc32, 2 /*TXSEXECHNDID_STDERR */);
break;
case 4 /* TXSEXECHNDID_STDIN_WRITABLE */:
break;
default:
rc = VBoxServiceControlExecProcHandleTransportEvent(hPollSet, fPollEvt, idPollHnd, &hStdInW, &StdInBuf);
break;
}
break; /* abort command, or client dead or something */
continue;
}
/*
* Check for incoming data.
*/
/*
* Check for process death.
*/
if (fProcessAlive)
{
if (RT_SUCCESS_NP(rc2))
{
fProcessAlive = false;
continue;
}
continue;
{
fProcessAlive = false;
AssertFailed();
}
else
}
/*
* If the process has terminated, we're should head out.
*/
if (!fProcessAlive)
break;
/*
* Check for timed out, killing the process.
*/
if (cMillies != RT_INDEFINITE_WAIT)
{
if (cMsElapsed >= cMillies)
{
VBoxServiceVerbose(3, "Control: Process timed out (%ums elapsed > %ums timeout), killing ...", cMsElapsed, cMillies);
fProcessTimedOut = true;
if ( MsProcessKilled == UINT64_MAX
{
break; /* give up after 20 mins */
continue;
}
cMilliesLeft = 10000;
}
else
}
/* Reset the polling interval since we've done all pending work. */
/*
* Need to exit?
*/
break;
}
/*
* Try kill the process if it's still alive at this point.
*/
if (fProcessAlive)
{
if (MsProcessKilled == UINT64_MAX)
{
RTThreadSleep(500);
}
for (size_t i = 0; i < 10; i++)
{
if (RT_SUCCESS(rc2))
{
fProcessAlive = false;
break;
}
if (i >= 5)
}
}
/*
* If we don't have a client problem (RT_FAILURE(rc) we'll reply to the
* clients exec packet now.
*/
if (RT_SUCCESS(rc))
{
{
}
{
}
{
}
else if (fProcessAlive)
{
VBoxServiceError("Control: Process is alive when it should not!\n");
}
else if (MsProcessKilled != UINT64_MAX)
{
VBoxServiceError("Control: Process has been killed when it should not!\n");
}
{
}
{
}
{
}
else
{
VBoxServiceError("Control: Process has reached an undefined status!\n");
}
}
return rc;
}
/**
* Sets up the redirection / pipe / nothing for one of the standard handles.
*
* @returns IPRT status code. No client replies made.
* @param pszHowTo How to set up this standard handle.
* @param fd Which standard handle it is (0 == stdin, 1 ==
* stdout, 2 == stderr).
* @param ph The generic handle that @a pph may be set
* pointing to. Always set.
* @param pph Pointer to the RTProcCreateExec argument.
* Always set.
* @param phPipe Where to return the end of the pipe that we
* should service. Always set.
*/
{
*phPipe = NIL_RTPIPE;
int rc;
/*
* to represent the "other" end to phPipe.
*/
if (fd == 0) /* stdin? */
{
/* Connect a wrtie pipe specified by phPipe to stdin. */
}
else /* stdout or stderr? */
{
/* Connect a read pipe specified by phPipe to stdout or stderr. */
}
if (RT_FAILURE(rc))
return rc;
return rc;
}
{
// LOCKING
if (*pcbToRead > 0)
{
}
else
{
*pcbToRead = 0;
}
return VINF_SUCCESS;
}
{
// LOCKING
/** @todo Use RTMemCache or RTMemObj here? */
{
break;
}
int rc = VINF_SUCCESS;
{
/** @todo Add offset clamping! */
}
else
rc = VERR_NO_MEMORY;
return rc;
}
/** Allocates and gives back a thread data struct which then can be used by the worker thread. */
{
/* General stuff. */
/* ClientID will be assigned when thread is started! */
/* Specific stuff. */
PVBOXSERVICECTRLTHREADDATAEXEC pData = (PVBOXSERVICECTRLTHREADDATAEXEC)RTMemAlloc(sizeof(VBOXSERVICECTRLTHREADDATAEXEC));
return VERR_NO_MEMORY;
pData->uNumEnvVars = 0;
/* Prepare argument list. */
/* Did we get the same result? */
if (RT_SUCCESS(rc))
{
/* Prepare environment list. */
if (uNumEnvVars)
{
uint32_t i = 0;
{
{
rc = VERR_NO_MEMORY;
break;
}
}
}
/* Adjust time limit value. */
|| (uTimeLimitMS == 0)) ?
/* Init buffers. */
}
if (RT_FAILURE(rc))
{
}
else
{
}
return rc;
}
{
if (pBuf)
{
}
}
/** Frees an allocated thread data structure along with all its allocated parameters. */
{
if (pData)
{
if (pData->uNumEnvVars)
{
}
}
}
{
/*
* Tell the control thread that it can continue
* spawning services.
*/
if (RT_FAILURE(rc))
{
VBoxServiceError("Control: Thread failed to connect to the guest control service, aborted! Error: %Rrc\n", rc);
return rc;
}
/*
* Create the environment.
*/
if (RT_SUCCESS(rc))
{
size_t i;
{
if (RT_FAILURE(rc))
break;
}
if (RT_SUCCESS(rc))
{
/*
* Setup the redirection of the standard stuff.
*/
/** @todo consider supporting: gcc stuff.c >file 2>&1. */
if (RT_SUCCESS(rc))
{
if (RT_SUCCESS(rc))
{
if (RT_SUCCESS(rc))
{
/*
* Create a poll set for the pipes and let the
* transport layer add stuff to it as well.
*/
if (RT_SUCCESS(rc))
{
if (RT_SUCCESS(rc))
rc = RTPollSetAddPipe(hPollSet, hStdOutR, RTPOLL_EVT_READ | RTPOLL_EVT_ERROR, 1 /* TXSEXECHNDID_STDOUT */);
if (RT_SUCCESS(rc))
rc = RTPollSetAddPipe(hPollSet, hStdErrR, RTPOLL_EVT_READ | RTPOLL_EVT_ERROR, 2 /* TXSEXECHNDID_TESTPIPE */);
if (RT_SUCCESS(rc))
{
&hProcess);
if (RT_SUCCESS(rc))
{
/*
* Close the child ends of any pipes and redirected files.
*/
/* Enter the process loop. */
/*
* The handles that are no longer in the set have
* been closed by the above call in order to prevent
* the guest from getting stuck accessing them.
* So, NIL the handles to avoid closing them again.
*/
}
else /* Something went wrong; report error! */
{
if (RT_FAILURE(rc2))
VBoxServiceError("Control: Could not report process start error! Error: %Rrc (process error %Rrc)\n",
}
}
}
}
}
}
}
}
return rc;
}
{
}
{
int rc;
if (pThread)
{
if (RT_SUCCESS(rc))
{
(void *)(PVBOXSERVICECTRLTHREAD*)pThread, 0,
if (RT_FAILURE(rc))
{
VBoxServiceError("Control: RTThreadCreate failed, rc=%Rrc\n, pThread=%p\n",
}
else
{
/* Wait for the thread to initialize. */
{
}
else
{
}
}
if (RT_FAILURE(rc))
}
if (RT_FAILURE(rc))
}
else
rc = VERR_NO_MEMORY;
return rc;
}