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 <QIODevice>
#include <QString>
 
// MythTV headers
#include "mythbaseexp.h"
#include "mythchrono.h"
 
enum MythSystemFlag {
    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, 
};
 
enum MythSignal : std::uint8_t {
    kSignalNone,
    kSignalUnknown,
    kSignalHangup,
    kSignalInterrupt,
    kSignalContinue,
    kSignalQuit,
    kSignalSegfault,
    kSignalKill,
    kSignalUser1,
    kSignalUser2,
    kSignalTerm,
    kSignalStop,
};
 
class MBASE_PUBLIC MythSystem
{
  public:
    enum Priority : std::uint8_t {
        kIdlePriority   = 0, 
        kLowestPriority,
        kLowPriority,
        kNormalPriority,   
        kHighPriority,
        kHighestPriority,
        kTimeCriticalPriority,
        kInheritPriority, 
    };
 
    static MythSystem *Create(
        const QStringList &args,
        uint flags = kMSNone,
        const QString& startPath = QString(),
        Priority cpuPriority = kInheritPriority,
        Priority diskPriority = kInheritPriority);
 
    static MythSystem *Create(
        const QString& args,
        uint flags = kMSNone,
        const QString& startPath = QString(),
        Priority cpuPriority = kInheritPriority,
        Priority diskPriority = kInheritPriority);
 
    virtual ~MythSystem(void) = default;
 
    // Deleted functions should be public.
    MythSystem(const MythSystem&) = delete; // no-implementation
    MythSystem& operator= (const MythSystem&) = delete; // no-implementation
 
    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(std::chrono::milliseconds timeout = 0ms) = 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;
};
 
#endif // MYTHSYSTEM_H_
 
/* vim:ts=4:sw=4:ai:et:si:sts=4 */