ExternalProgram.h

Go to the documentation of this file.

/*---------------------------------------------------------------------\
|                                                                      |
|                      __   __    ____ _____ ____                      |
|                      \ \ / /_ _/ ___|_   _|___ \                     |
|                       \ V / _` \___ \ | |   __) |                    |
|                        | | (_| |___) || |  / __/                     |
|                        |_|\__,_|____/ |_| |_____|                    |
|                                                                      |
|                               core system                            |
|                                                        (C) SuSE GmbH |
\----------------------------------------------------------------------/

   File:       ExternalProgram.h

   Author:     Andreas Schwab <schwab@suse.de>
   Maintainer: Thomas Roelz <tom@suse.de>

/-*/

#ifndef ExternalProgram_h
#define ExternalProgram_h

#include <map>
#include <string>

#include <y2util/ExternalDataSource.h>
#include <y2util/Pathname.h>

class ExternalProgram : public ExternalDataSource
{

public:
    enum Stderr_Disposition {
        Normal_Stderr,
        Discard_Stderr,
        Stderr_To_Stdout,
        Stderr_To_FileDesc
    };

    typedef std::map<std::string,std::string> Environment;

    ExternalProgram (std::string commandline,
                     Stderr_Disposition stderr_disp = Normal_Stderr,
                     bool use_pty = false, int stderr_fd = -1, bool default_locale = false,
                     const Pathname& root = "", bool pty_trans = true);

    ExternalProgram (const char *const *argv,
                     Stderr_Disposition stderr_disp = Normal_Stderr,
                     bool use_pty = false, int stderr_fd = -1, bool default_locale = false,
                     const Pathname& root = "", bool pty_trans = true);

    ExternalProgram (const char *const *argv, const Environment & environment,
                     Stderr_Disposition stderr_disp = Normal_Stderr,
                     bool use_pty = false, int stderr_fd = -1, bool default_locale = false,
                     const Pathname& root = "", bool pty_trans = true);

    ExternalProgram (const char *binpath, const char *const *argv_1,
                     bool use_pty = false, bool pty_trans = true);


    ExternalProgram (const char *binpath, const char *const *argv_1, const Environment & environment,
                     bool use_pty = false, bool pty_trans = true);


    ~ExternalProgram();

    int close();

    bool kill();

    bool running();

    pid_t getpid() { return pid; }

    static void renumber_fd (int origfd, int newfd);

protected:
    int checkStatus( int );

private:

    bool use_pty;

    bool disable_pty_trans;

    pid_t pid;
    int _exitStatus;

    void start_program (const char *const *argv, const Environment & environment,
                        Stderr_Disposition stderr_disp = Normal_Stderr,
                        int stderr_fd = -1, bool default_locale = false,
                        const char* root = NULL);

    // disable LF to CRLF translation on the terminal file descriptor
    bool disableCRLFTranslation(int fd);
};

#endif // ExternalProgram_h