---

SubProcess.h

Go to the documentation of this file.

#ifndef CLASSLIB_SUB_PROCESS_H
# define CLASSLIB_SUB_PROCESS_H

//<<<<<< INCLUDES                                                       >>>>>>

# include "classlib/sysapi/system.h"

namespace lat {
//<<<<<< PUBLIC DEFINES                                                 >>>>>>
//<<<<<< PUBLIC CONSTANTS                                               >>>>>>
//<<<<<< PUBLIC TYPES                                                   >>>>>>

class IOChannel;
class Pipe;

//<<<<<< PUBLIC VARIABLES                                               >>>>>>
//<<<<<< PUBLIC FUNCTIONS                                               >>>>>>
//<<<<<< CLASS DECLARATIONS                                             >>>>>>

class SubProcess
{
    // FIXME: block SIGPIPE -> EPIPE -> throw? (write only; read -> eof)
    // FIXME: Allow redirect of unpiped file descriptors (e.g. output to
    //   child -> allow redirect of stderr, stdout)
    // FIXME: set options on handle inheritance
    // FIXME: set options on env inheritance
    // FIXME: wait with timeout?
public:
    // FIXME: Merge with/continue from IOFlags?
    enum Flags {
        Read            = 1,            //< Make a read subprocess chain
        Write           = 2,            //< Make a write subprocess chain
        First           = 4,            //< First subprocess in a chain
        Last            = 8,            //< Last subprocess in a chain
        One             = First | Last, //< Single-subprocess chain
        Synchronous     = 16,           //< Run synchronously
        Search          = 32,           //< Search path for command
        NoCloseInput    = 64,           //< Don't close input pipe in parent
        NoCloseOutput   = 128           //< Don't close output pipe in parent
        // CleanEnv     = 256           //< Clean up safe environment
        // CloseFds     = 512           //< Close all "other" file descriptors
    };

    SubProcess (void);
    SubProcess (const char **argz, unsigned flags = One);
    SubProcess (const char **argz, unsigned flags,
                Pipe *pipe, IOChannel *other = 0);
    SubProcess (const char **argz, unsigned flags,
                SubProcess *input, IOChannel *output = 0);
    SubProcess (const char **argz, unsigned flags,
                IOChannel *input, IOChannel *output = 0);
    virtual ~SubProcess (void);

    virtual pid_t       run (const char **argz, unsigned flags = One);
    virtual pid_t       run (const char **argz, unsigned flags,
                             Pipe *pipe, IOChannel *other = 0);
    virtual pid_t       run (const char **argz, unsigned flags,
                             SubProcess *input, IOChannel *output = 0);
    virtual pid_t       run (const char **argz, unsigned flags,
                             IOChannel *input, IOChannel *output = 0);

    virtual IOChannel * input (void) const;
    virtual IOChannel * output (void) const;
    virtual Pipe *      pipe (void) const;
    virtual pid_t       pid (void) const;

    virtual void        detach (void);
    virtual void        terminate (void);
    virtual bool        done (void);
    virtual int         wait (void);

    static bool         exitNormal (int waitcode);
    static bool         exitBySignal (int waitcode);
    static int          exitStatus (int waitcode);
    static int          exitSignal (int waitcode);

private:
    pid_t               dorun (const char **argz, unsigned flags,
                               IOChannel *input, IOChannel *output,
                               IOChannel *cleanup);
    pid_t               sysrun (const char **argz, unsigned flags,
                                IOChannel *input, IOChannel *output,
                                IOChannel *cleanup);
    void                sysdetach (void);

    int                 m_status;
    IOChannel           *m_input;
    IOChannel           *m_output;
    Pipe                *m_pipe;
# ifdef _WIN32
    void                *m_sub;
    unsigned long       m_pid;
# else
    pid_t               m_sub;
# endif

    // undefined, no semantics
    SubProcess (const SubProcess &x);
    SubProcess &operator= (const SubProcess &x);
};

//<<<<<< INLINE PUBLIC FUNCTIONS                                        >>>>>>
//<<<<<< INLINE MEMBER FUNCTIONS                                        >>>>>>

} // namespace lat
#endif // CLASSLIB_SUB_PROCESS_H

---