Introduce System::executeEnv and System::executeBackgroundEnv

1 files changed, 27 insertions, 1 deletions

diff --git a/include/mts/MTS_System.h b/include/mts/MTS_System.h
index d51a5ea..24dc616 100644
--- a/include/mts/MTS_System.h
+++ b/include/mts/MTS_System.h
@@ -78,6 +78,18 @@ namespace MTS {
              */
             static int32_t execute(const std::string& cmd, const std::vector<std::string>& argv, std::string& result);
 
+            //! Execute application with specified arguments and environment variables inheritance.
+            /*!
+             * A safer alternative to System::cmd that allows to execute applications with controlled
+             * list of arguments and inherited environment variables bypasing the system shell.
+             *
+             * \param  cmd    name of the application to be executed
+             * \param  argv   vector of arguments (excluding argument zero)
+             * \param  result stdout output from the application is stored here
+             * \return result code as for std::system and UNIX pclose
+             */
+            static int32_t executeEnv(const std::string& cmd, const std::vector<std::string>& argv, std::string& result);
+
             //! Spawn a process and open pipe with the specified type (READ or WRITE)
             /*!
             * A safer alternative to POSIX popen that allows to execute applications with controlled
@@ -92,6 +104,20 @@ namespace MTS {
             */
             static bool executeBackground(const std::string& cmd, const std::vector<std::string>& argv, PipeType type, ChildHandle& child);
 
+            //! Spawn a process and open pipe with the specified type (READ or WRITE)
+            /*!
+            * A safer alternative to POSIX popen that allows to execute applications with controlled
+            * list of arguments  and inherited environment variables bypasing the system shell.
+            * If succeded, information about the spawned process is written to the \p child structure.
+            *
+            * \param  cmd   name of the application to be executed
+            * \param  argv  vector of arguments (excluding argument zero)
+            * \param  type  open pipe for read from child or write to child
+            * \param  child on success is populated with child process information, on failure is not defined
+            * \return true  on success, false on failure
+            */
+            static bool executeBackgroundEnv(const std::string& cmd, const std::vector<std::string>& argv, PipeType type, ChildHandle& child);
+
             //! Close the pipe and wait for a child to finish execution
             /*!
             * \param  child  structure with child process information as populated by executeBackground
@@ -102,7 +128,7 @@ namespace MTS {
         private:
 
             //! Spawn a process and open pipe with the specified type (READ or WRITE)
-            static bool executeBackground(const std::string& cmd, char* const argv[], PipeType type, ChildHandle& child);
+            static bool executeBackground(const std::string& cmd, char* const argv[], bool env, PipeType type, ChildHandle& child);
 
             //! Utility method. Cast argument to a C pointer required by some C-style functions.
             static inline char* castArgument(const std::string& arg);