process.hh

Go to the documentation of this file.

#ifndef UTILMM_PROCESS_H
#define UTILMM_PROCESS_H
#include "utilmm/config/config.h"
#include <utilmm/system/system.hh>
#include <boost/noncopyable.hpp>
#include <boost/filesystem/path.hpp>

#include <string>
#include <map>
#include <list>
#include <signal.h>

namespace utilmm
{
    class process
    {
    public:
        static const int InvalidHandle = -1;
        enum Stream { Stdout = 1, Stderr = 2 };

    private:
        typedef std::list<process*>::iterator ProcessHandle;
        ProcessHandle m_handle;

        boost::filesystem::path m_wdir;
        typedef std::list<std::string> CommandLine;
        CommandLine m_cmdline;

        typedef std::map<std::string, std::string> Env;
        Env m_env;

        struct output_file : public utilmm::auto_close
        {
            bool is_null() const;
            void redirect(FILE* stream);
        };
        output_file m_stdout, m_stderr;
        output_file& get_stream(Stream stream);

        bool  m_running;
        pid_t m_pid;
        bool  m_normalexit;
        int   m_status;

        bool m_do_setpgid;
        pid_t m_pgid;

        bool wait(bool hang);
        void send_child_error(int fd, int error_type);
        void process_child_error(int fd);

    public:
        class already_running : public std::exception {};
    
        process();
        ~process();

        void set_workdir(boost::filesystem::path const& dir);
        boost::filesystem::path workdir() const;
        
        std::list<std::string> cmdline() const;
        void push(const std::string& arg);
        process& operator << (std::string const& newarg);
        void clear();

        void start();

        void signal(int signo = SIGINT);

        static void install_sigint_handler();

        static void killall();
        
        void wait();

        void detach();

        void erase_redirection(Stream stream);

        void redirect_to( Stream stream, int   handle, bool auto_close = true);
        void redirect_to( Stream stream, FILE* handle, bool auto_close = true);
        void redirect_to( Stream stream, boost::filesystem::path const& file);


        void set_environment(const std::string& key, const std::string& value);
        std::string environment(const std::string& key) const;
        void clear_environment();

        void set_pgid(pid_t pid);

        bool exit_normal() const;
        int exit_status() const;

        pid_t pid() const;
        bool  running();
    };
}

#endif