|| || || || || || || ||

---

Manager.h

Go to the documentation of this file.

#ifndef Impala_Process_Manager_h
#define Impala_Process_Manager_h

namespace Impala
{
namespace Process
{

/****************************************************************************
This class serves as an interface for implementations of process management.
*****************************************************************************/

class Manager
{

public:

    // process state codes:
    static const int STATE_RUNNING = -1;
    static const int STATE_TERM_SUCCESS = 0;
    static const int STATE_TERM_ERROR = 1;
    static const int STATE_TERM_ABNORMAL = 2;
    static const int STATE_UNKNOWN = 9;

    static const int WAIT_INTERVAL_SEC = 5;

    virtual ~Manager()
    {
    }

    // Creates a process for the specified command line.
    // See the CreateProcess() function of the Win platform SDK for info on setting application and cmd line.
    // Returns handle for referencing the created process upon successful creation; 0 otherwise.
    virtual int Create(const std::string& cmdLine, std::string application = "") = 0;

    virtual int GetManagedProcessCount() const = 0;

    virtual bool IsRunning(int handle) = 0;

    // Did the process terminate with or witout errors, or forced?
    virtual bool IsTerminated(int handle) = 0;

    // Makes the manager sleep, and return on wakeup.
    virtual void Sleep(int sec) = 0;

    // Blocks until the process completes, crashes,
    // or runs longer than its specified max something (SK). 
    // Returns the process' termination code.
    //virtual int WaitFor(int handle) = 0; // SK: not used

    // Attempts to kill the process for the specified handle.
    virtual void Kill(int handle) = 0;

    // If necessary kills and then removes the process for the specified handle from the manager.
    virtual void Remove(int handle) = 0;

    // Is the process still running, did it terminate successfully, with errors or abnormally?
    virtual int GetState(int handle) = 0;

    // Returns the process' exit code as returned by the OS
    virtual int GetExitCode(int handle) = 0;

protected:

private:

}; // class

} // namespace 
} // namespace 

#endif

---