211 lines
7.0 KiB
C++
211 lines
7.0 KiB
C++
// -*- c++ -*-
|
|
// Generated by gtkmmproc -- DO NOT MODIFY!
|
|
#ifndef _GLIBMM_SPAWN_H
|
|
#define _GLIBMM_SPAWN_H
|
|
|
|
|
|
/* $Id: spawn.hg,v 1.4 2004/03/02 23:29:57 murrayc Exp $ */
|
|
|
|
/* Copyright (C) 2002 The gtkmm Development Team
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the Free
|
|
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
*/
|
|
|
|
|
|
#include <string>
|
|
#include <sigc++/sigc++.h>
|
|
#include <glibmm/arrayhandle.h>
|
|
#include <glibmm/error.h>
|
|
|
|
#include <glibmmconfig.h>
|
|
GLIBMM_USING_STD(string)
|
|
|
|
|
|
namespace Glib
|
|
{
|
|
|
|
typedef GPid Pid;
|
|
|
|
/** @addtogroup glibmmEnums Enums and Flags */
|
|
|
|
/**
|
|
* @ingroup glibmmEnums
|
|
* @par Bitwise operators:
|
|
* <tt>%SpawnFlags operator|(SpawnFlags, SpawnFlags)</tt><br>
|
|
* <tt>%SpawnFlags operator&(SpawnFlags, SpawnFlags)</tt><br>
|
|
* <tt>%SpawnFlags operator^(SpawnFlags, SpawnFlags)</tt><br>
|
|
* <tt>%SpawnFlags operator~(SpawnFlags)</tt><br>
|
|
* <tt>%SpawnFlags& operator|=(SpawnFlags&, SpawnFlags)</tt><br>
|
|
* <tt>%SpawnFlags& operator&=(SpawnFlags&, SpawnFlags)</tt><br>
|
|
* <tt>%SpawnFlags& operator^=(SpawnFlags&, SpawnFlags)</tt><br>
|
|
*/
|
|
enum SpawnFlags
|
|
{
|
|
SPAWN_LEAVE_DESCRIPTORS_OPEN = 1 << 0,
|
|
SPAWN_DO_NOT_REAP_CHILD = 1 << 1,
|
|
SPAWN_SEARCH_PATH = 1 << 2,
|
|
SPAWN_STDOUT_TO_DEV_NULL = 1 << 3,
|
|
SPAWN_STDERR_TO_DEV_NULL = 1 << 4,
|
|
SPAWN_CHILD_INHERITS_STDIN = 1 << 5,
|
|
SPAWN_FILE_AND_ARGV_ZERO = 1 << 6
|
|
};
|
|
|
|
/** @ingroup glibmmEnums */
|
|
inline SpawnFlags operator|(SpawnFlags lhs, SpawnFlags rhs)
|
|
{ return static_cast<SpawnFlags>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs)); }
|
|
|
|
/** @ingroup glibmmEnums */
|
|
inline SpawnFlags operator&(SpawnFlags lhs, SpawnFlags rhs)
|
|
{ return static_cast<SpawnFlags>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs)); }
|
|
|
|
/** @ingroup glibmmEnums */
|
|
inline SpawnFlags operator^(SpawnFlags lhs, SpawnFlags rhs)
|
|
{ return static_cast<SpawnFlags>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs)); }
|
|
|
|
/** @ingroup glibmmEnums */
|
|
inline SpawnFlags operator~(SpawnFlags flags)
|
|
{ return static_cast<SpawnFlags>(~static_cast<unsigned>(flags)); }
|
|
|
|
/** @ingroup glibmmEnums */
|
|
inline SpawnFlags& operator|=(SpawnFlags& lhs, SpawnFlags rhs)
|
|
{ return (lhs = static_cast<SpawnFlags>(static_cast<unsigned>(lhs) | static_cast<unsigned>(rhs))); }
|
|
|
|
/** @ingroup glibmmEnums */
|
|
inline SpawnFlags& operator&=(SpawnFlags& lhs, SpawnFlags rhs)
|
|
{ return (lhs = static_cast<SpawnFlags>(static_cast<unsigned>(lhs) & static_cast<unsigned>(rhs))); }
|
|
|
|
/** @ingroup glibmmEnums */
|
|
inline SpawnFlags& operator^=(SpawnFlags& lhs, SpawnFlags rhs)
|
|
{ return (lhs = static_cast<SpawnFlags>(static_cast<unsigned>(lhs) ^ static_cast<unsigned>(rhs))); }
|
|
|
|
|
|
/** @defgroup Spawn Spawning Processes
|
|
* Process launching with fork()/exec().
|
|
* @{
|
|
*/
|
|
|
|
/** Exception class for errors occuring when spawning processes.
|
|
*/
|
|
class SpawnError : public Glib::Error
|
|
{
|
|
public:
|
|
enum Code
|
|
{
|
|
FORK,
|
|
READ,
|
|
CHDIR,
|
|
ACCES,
|
|
PERM,
|
|
TOOBIG,
|
|
NOEXEC,
|
|
NAMETOOLONG,
|
|
NOENT,
|
|
NOMEM,
|
|
NOTDIR,
|
|
LOOP,
|
|
TXTBUSY,
|
|
IO,
|
|
NFILE,
|
|
MFILE,
|
|
INVAL,
|
|
ISDIR,
|
|
LIBBAD
|
|
};
|
|
|
|
SpawnError(Code error_code, const Glib::ustring& error_message);
|
|
explicit SpawnError(GError* gobject);
|
|
Code code() const;
|
|
|
|
#ifndef DOXYGEN_SHOULD_SKIP_THIS
|
|
private:
|
|
|
|
#ifdef GLIBMM_EXCEPTIONS_ENABLED
|
|
static void throw_func(GError* gobject);
|
|
#else
|
|
//When not using exceptions, we just pass the Exception object around without throwing it:
|
|
static std::auto_ptr<Glib::Error> throw_func(GError* gobject);
|
|
#endif //GLIBMM_EXCEPTIONS_ENABLED
|
|
|
|
friend void wrap_init(); // uses throw_func()
|
|
#endif
|
|
};
|
|
|
|
|
|
void spawn_async_with_pipes(const std::string& working_directory,
|
|
const Glib::ArrayHandle<std::string>& argv,
|
|
const Glib::ArrayHandle<std::string>& envp,
|
|
SpawnFlags flags = SpawnFlags(0),
|
|
const sigc::slot<void>& child_setup = sigc::slot<void>(),
|
|
Pid* child_pid = 0,
|
|
int* standard_input = 0,
|
|
int* standard_output = 0,
|
|
int* standard_error = 0);
|
|
|
|
void spawn_async_with_pipes(const std::string& working_directory,
|
|
const Glib::ArrayHandle<std::string>& argv,
|
|
SpawnFlags flags = SpawnFlags(0),
|
|
const sigc::slot<void>& child_setup = sigc::slot<void>(),
|
|
Pid* child_pid = 0,
|
|
int* standard_input = 0,
|
|
int* standard_output = 0,
|
|
int* standard_error = 0);
|
|
|
|
void spawn_async(const std::string& working_directory,
|
|
const Glib::ArrayHandle<std::string>& argv,
|
|
const Glib::ArrayHandle<std::string>& envp,
|
|
SpawnFlags flags = SpawnFlags(0),
|
|
const sigc::slot<void>& child_setup = sigc::slot<void>(),
|
|
Pid* child_pid = 0);
|
|
|
|
void spawn_async(const std::string& working_directory,
|
|
const Glib::ArrayHandle<std::string>& argv,
|
|
SpawnFlags flags = SpawnFlags(0),
|
|
const sigc::slot<void>& child_setup = sigc::slot<void>(),
|
|
Pid* child_pid = 0);
|
|
|
|
void spawn_sync(const std::string& working_directory,
|
|
const Glib::ArrayHandle<std::string>& argv,
|
|
const Glib::ArrayHandle<std::string>& envp,
|
|
SpawnFlags flags = SpawnFlags(0),
|
|
const sigc::slot<void>& child_setup = sigc::slot<void>(),
|
|
std::string* standard_output = 0,
|
|
std::string* standard_error = 0,
|
|
int* exit_status = 0);
|
|
|
|
void spawn_sync(const std::string& working_directory,
|
|
const Glib::ArrayHandle<std::string>& argv,
|
|
SpawnFlags flags = SpawnFlags(0),
|
|
const sigc::slot<void>& child_setup = sigc::slot<void>(),
|
|
std::string* standard_output = 0,
|
|
std::string* standard_error = 0,
|
|
int* exit_status = 0);
|
|
|
|
void spawn_command_line_async(const std::string& command_line);
|
|
|
|
void spawn_command_line_sync(const std::string& command_line,
|
|
std::string* standard_output = 0,
|
|
std::string* standard_error = 0,
|
|
int* exit_status = 0);
|
|
|
|
void spawn_close_pid(Pid pid);
|
|
|
|
/** @} group Spawn */
|
|
|
|
} // namespace Glib
|
|
|
|
|
|
#endif /* _GLIBMM_SPAWN_H */
|
|
|