RCU::Shell Namespace Reference

Functions
void	exec (const std::string &cmd)
	effects: execute the given command guarantee: strong failures: out of memory II failures: system failure failures: command failure
std::string	exec_read (const std::string &cmd)
	effects: execute the given command and return the output returns: the output of the command guarantee: strong failures: out of memory III failures: system failure failures: command failure
std::string	exec_read (const std::string &cmd, int &rc)
	effects: execute the given command and return the output returns: the output of the command guarantee: strong failures: out of memory III failures: system failure failures: command failure
std::string	quote (const std::string &name)
	effects: quote the given name to protect it from the shell returns: the quoted name guarantee: strong failures: out of memory II

Function Documentation

exec()

void RCU::Shell::exec

(

const std::string &

cmd

)

effects: execute the given command guarantee: strong failures: out of memory II failures: system failure failures: command failure

Definition at line 27 of file ShellExec.cxx.

    {
      if (gSystem->Exec (cmd.c_str()) != 0)
        throw std::runtime_error ("command failed: " + cmd);
    }

exec_read() [1/2]

std::string RCU::Shell::exec_read

(

const std::string &

cmd

)

effects: execute the given command and return the output returns: the output of the command guarantee: strong failures: out of memory III failures: system failure failures: command failure

Definition at line 35 of file ShellExec.cxx.

    {
      int rc = 0;
      std::string result = exec_read (cmd, rc);
      if (rc != 0)
        throw std::runtime_error ("command failed: " + cmd + "\nwith output:\n" + result);
      return result;
    }

exec_read() [2/2]

std::string RCU::Shell::exec_read	(	const std::string &	cmd,
		int &	rc )

effects: execute the given command and return the output returns: the output of the command guarantee: strong failures: out of memory III failures: system failure failures: command failure

Definition at line 46 of file ShellExec.cxx.

    {
      std::unique_ptr<FILE, int (*)(FILE*)> pipe (popen (cmd.c_str(), "r"), pclose);
      if (pipe == nullptr)
        throw std::runtime_error ("failed to run command: " + cmd);
 
      std::string result;
      std::vector<char> buffer (1024);
      size_t read;
      while ((read = fread (&buffer[0], 1, buffer.size(), pipe.get())) > 0)
      {
    result.append (&buffer[0], read);
      }
      rc = pclose (pipe.release());
      return result;
    }

quote()

std::string RCU::Shell::quote

(

const std::string &

name

)

effects: quote the given name to protect it from the shell returns: the quoted name guarantee: strong failures: out of memory II

Definition at line 65 of file ShellExec.cxx.

    {
      // wrap the argument in single quotes, which protects every
      // character from the shell (including newlines); an embedded
      // single quote is emitted as the standard '\'' sequence
      std::string result = "'";
      for (char c : name)
      {
    if (c == '\'')
      result += "'\\''";
    else
      result += c;
      }
      result += "'";
      return result;
    }