/// @brief An abstraction for finding and executing programs.
class Program {
/// Opaque handle for target specific data.
- void *Data;
+ void *Data;
unsigned Pid_;
public:
Program();
- ~Program();
-
+ ~Program();
+
/// Return process ID of this program.
unsigned GetPid() { return Pid_; }
///< program.
);
+ /// This function terminates the program.
+ /// @returns true if an error occured.
+ /// @see Execute
+ /// @brief Terminates the program.
+ bool Kill
+ ( std::string* ErrMsg = 0 ///< If non-zero, provides a pointer to a string
+ ///< instance in which error messages will be returned. If the string
+ ///< is non-empty upon return an error occurred while invoking the
+ ///< program.
+ );
+
/// This static constructor (factory) will attempt to locate a program in
/// the operating system's file system using some pre-determined set of
/// locations to search (e.g. the PATH on Unix).
}
+bool
+Program::Kill(std::string* ErrMsg) {
+ if (Pid_ == 0) {
+ MakeErrMsg(ErrMsg, "Process not started!");
+ return true;
+ }
+
+ return (kill(Pid_, SIGKILL) == 0);
+}
+
bool Program::ChangeStdinToBinary(){
// Do nothing, as Unix doesn't differentiate between text and binary.
return false;
Program::Program() : Pid_(0), Data(0) {}
Program::~Program() {
- if (Data) {
- HANDLE hProcess = (HANDLE) Data;
- CloseHandle(hProcess);
- Data = 0;
- }
+ if (Data) {
+ HANDLE hProcess = (HANDLE) Data;
+ CloseHandle(hProcess);
+ Data = 0;
+ }
}
// This function just uses the PATH environment variable to find the program.
/// ArgNeedsQuotes - Check whether argument needs to be quoted when calling
/// CreateProcess.
-static bool ArgNeedsQuotes(const char *Str) {
+static bool ArgNeedsQuotes(const char *Str) {
return Str[0] == '\0' || strchr(Str, ' ') != 0;
}
CloseHandle(Data);
Data = 0;
}
-
+
if (!path.canExecute()) {
if (ErrMsg)
*ErrMsg = "program not executable";
}
Pid_ = pi.dwProcessId;
Data = pi.hProcess;
-
+
// Make sure these get closed no matter what.
AutoHandle hThread(pi.hThread);
}
HANDLE hProcess = (HANDLE) Data;
-
+
// Wait for the process to terminate.
DWORD millisecondsToWait = INFINITE;
if (secondsToWait > 0)
return status;
}
+bool
+Program::Kill(std::string* ErrMsg) {
+ if (Data == 0) {
+ MakeErrMsg(ErrMsg, "Process not started!");
+ return true;
+ }
+
+ HANDLE hProcess = reinterpret_cast<HANDLE>(Data);
+ return TerminateProcess(hProcess, 1);
+}
+
bool Program::ChangeStdinToBinary(){
int result = _setmode( _fileno(stdin), _O_BINARY );
return result == -1;