mythsystem.h

Go to the documentation of this file.

/* -*- Mode: c++ -*-
 *  Class MythSystem
 *
 *  Copyright (C) Daniel Kristjansson 2013
 *  Copyright (C) Gavin Hurlbut 2012
 *  Copyright (C) Issac Richards 2008
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License as published by
 *   the Free Software Foundation; either version 2 of the License, or
 *   (at your option) any later version.
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with this program; if not, write to the Free Software
 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA
 */

#ifndef MYTHSYSTEM_H_
#define MYTHSYSTEM_H_

// Qt headers
#include <QString>

// MythTV headers
#include "mythbaseexp.h"

typedef enum MythSystemMask {
    kMSNone               = 0x00000000,
    kMSDontBlockInputDevs = 0x00000001, 
    kMSDontDisableDrawing = 0x00000002, 
    kMSRunBackground      = 0x00000004, 
    kMSProcessEvents      = 0x00000008, 
    kMSStdIn              = 0x00000020, 
    kMSStdOut             = 0x00000040, 
    kMSStdErr             = 0x00000080, 
    kMSRunShell           = 0x00000200, 
    kMSAnonLog            = 0x00000800, 
    kMSAutoCleanup        = 0x00004000, 
    kMSLowExitVal         = 0x00008000, 
    // ^ FIXME Eliminate? appears to be a hack for some "ubuntu", but
    //                    doesn't appear to be needed with ubuntu 12.04
    kMSDisableUDPListener = 0x00010000, 
    kMSPropagateLogs      = 0x00020000, 
} MythSystemMask;

typedef enum MythSignal {
    kSignalNone,
    kSignalUnknown,
    kSignalHangup,
    kSignalInterrupt,
    kSignalContinue,
    kSignalQuit,
    kSignalSegfault,
    kSignalKill,
    kSignalUser1,
    kSignalUser2,
    kSignalTerm,
    kSignalStop,
} MythSignal;

class QStringList;
class QIODevice;

class MBASE_PUBLIC MythSystem
{
  public:
    typedef enum Priority {
        kIdlePriority   = 0, 
        kLowestPriority,
        kLowPriority,
        kNormalPriority,   
        kHighPriority,
        kHighestPriority,
        kTimeCriticalPriority,
        kInheritPriority, 
    } Priority;

    static MythSystem *Create(
        const QStringList &args,
        uint flags = kMSNone,
        QString startPath = QString(),
        Priority cpuPriority = kInheritPriority,
        Priority diskPriority = kInheritPriority);

    static MythSystem *Create(
        QString args,
        uint flags = kMSNone,
        QString startPath = QString(),
        Priority cpuPriority = kInheritPriority,
        Priority diskPriority = kInheritPriority);

    virtual ~MythSystem(void) = default;

    virtual uint GetFlags(void) const = 0;

    virtual QString GetStartingPath(void) const = 0;

    virtual Priority GetCPUPriority(void) const = 0;

    virtual Priority GetDiskPriority(void) const = 0;

    virtual bool Wait(uint timeout_ms = 0) = 0;

    virtual QIODevice *GetStandardInputStream(void) = 0;

    virtual QIODevice *GetStandardOutputStream(void) = 0;

    virtual QIODevice *GetStandardErrorStream(void) = 0;

    virtual void Signal(MythSignal) = 0;

    virtual int GetExitCode(void) const = 0;

  protected:
    MythSystem() = default;

  private:
    MythSystem(const MythSystem&); // no-implementation
    MythSystem& operator= (const MythSystem&); // no-implementation
};

#endif // MYTHSYSTEM_H_

/* vim:ts=4:sw=4:ai:et:si:sts=4 */