//===== Copyright (C) 1996-2005, Valve Corporation, All rights reserved. ======//
//
// Purpose: 
//
//===========================================================================//

#ifndef IPROCESSUTILS_H
#define IPROCESSUTILS_H

#ifdef _WIN32
#pragma once
#endif


#include "appframework/IAppSystem.h"


//-----------------------------------------------------------------------------
// Handle to a process
//-----------------------------------------------------------------------------
typedef int ProcessHandle_t;
enum
{
	PROCESS_HANDLE_INVALID = 0,
};


//-----------------------------------------------------------------------------
// Interface version
//-----------------------------------------------------------------------------
#define PROCESS_UTILS_INTERFACE_VERSION "VProcessUtils001"


//-----------------------------------------------------------------------------
// Interface for makefiles to build differently depending on where they are run from
//-----------------------------------------------------------------------------
abstract_class IProcessUtils : public IAppSystem
{
public:
	// Starts, stops a process
	virtual ProcessHandle_t StartProcess( const char *pCommandLine, bool bConnectStdPipes ) = 0;
	virtual ProcessHandle_t StartProcess( int argc, const char **argv, bool bConnectStdPipes ) = 0;
	virtual void CloseProcess( ProcessHandle_t hProcess ) = 0;
	virtual void AbortProcess( ProcessHandle_t hProcess ) = 0;

	// Returns true if a process is complete
	virtual bool IsProcessComplete( ProcessHandle_t hProcess ) = 0;

	// Waits until a process is complete
	virtual void WaitUntilProcessCompletes( ProcessHandle_t hProcess ) = 0;

	// Methods used to write input into a process
	virtual int SendProcessInput( ProcessHandle_t hProcess, char *pBuf, int nBufLen ) = 0;

	// Methods used to read	output back from a process
	virtual int GetProcessOutputSize( ProcessHandle_t hProcess ) = 0;
	virtual int GetProcessOutput( ProcessHandle_t hProcess, char *pBuf, int nBufLen ) = 0;
	
	// Returns the exit code for the process. Doesn't work unless the process is complete
	virtual int GetProcessExitCode( ProcessHandle_t hProcess ) = 0;
};


#endif // IPROCESSUTILS_H
