subprocess.h

Go to the documentation of this file.

/** @file
*   @author Bram de Greve (bram@cocamware.com)
*   @author Tom De Muer (tom@cocamware.com)
*
*   *** BEGIN LICENSE INFORMATION ***
*
*   The contents of this file are subject to the Common Public Attribution License
*   Version 1.0 (the "License"); you may not use this file except in compliance with
*   the License. You may obtain a copy of the License at
*   http://lass.sourceforge.net/cpal-license. The License is based on the
*   Mozilla Public License Version 1.1 but Sections 14 and 15 have been added to cover
*   use of software over a computer network and provide for limited attribution for
*   the Original Developer. In addition, Exhibit A has been modified to be consistent
*   with Exhibit B.
*
*   Software distributed under the License is distributed on an "AS IS" basis, WITHOUT
*   WARRANTY OF ANY KIND, either express or implied. See the License for the specific
*   language governing rights and limitations under the License.
*
*   The Original Code is LASS - Library of Assembled Shared Sources.
*
*   The Initial Developer of the Original Code is Bram de Greve and Tom De Muer.
*   The Original Developer is the Initial Developer.
*
*   All portions of the code written by the Initial Developer are:
*   Copyright (C) 2004-2015 the Initial Developer.
*   All Rights Reserved.
*
*   Contributor(s):
*
*   Alternatively, the contents of this file may be used under the terms of the
*   GNU General Public License Version 2 or later (the GPL), in which case the
*   provisions of GPL are applicable instead of those above.  If you wish to allow use
*   of your version of this file only under the terms of the GPL and not to allow
*   others to use your version of this file under the CPAL, indicate your decision by
*   deleting the provisions above and replace them with the notice and other
*   provisions required by the GPL License. If you do not delete the provisions above,
*   a recipient may use your version of this file under either the CPAL or the GPL.
*
*   *** END LICENSE INFORMATION ***
*/
 
#ifndef LASS_GUARDIAN_OF_INCLUSION_UTIL_SUBPROCESS_H
#define LASS_GUARDIAN_OF_INCLUSION_UTIL_SUBPROCESS_H
 
#include "util_common.h"
#include "non_copyable.h"
 
namespace lass
{
namespace util
{
namespace impl
{
    class SubprocessImpl;
}
 
namespace experimental
{
 
/** Barebone implementation to run subprocesses.
 *
 *  @warning this primarly exists to test io::MessagePipe and io::SharedMemory, and is not tested beyond that!
 */
class LASS_DLL Subprocess: public util::NonCopyable
{
public:
    typedef std::vector<std::string> TArgs;
    typedef std::vector<std::wstring> TWArgs;
 
    explicit Subprocess(const TArgs& args);
    explicit Subprocess(const TWArgs& args);
    ~Subprocess();
 
    void run();
    int join();
    void detach();
    void kill();
    void sendSignal(int signal); // only meaningfull on linux.
 
    bool isRunning() const;
    bool isDetached() const;
    int exitCode() const;
 
private:
 
    void enforceStarted() const;
    void enforceNotDetached() const;
    bool checkExitCode(bool join=false) const;
 
    impl::SubprocessImpl* pimpl_;
    mutable int exitCode_;
    mutable bool hasExitCode_;
    bool isStarted_;
    bool isDetached_;
};
 
}
 
}
}
 
#endif
 
// EOF