src/spawn.h

   1 /*
   2  *      spawn.h - this file is part of Geany, a fast and lightweight IDE
   3  *
   4  *      Copyright 2013 Dimitar Toshkov Zhekov <dimitar(dot)zhekov(at)gmail(dot)com>
   5  *
   6  *      This program is free software; you can redistribute it and/or modify
   7  *      it under the terms of the GNU General Public License as published by
   8  *      the Free Software Foundation; either version 2 of the License, or
   9  *      (at your option) any later version.
  10  *
  11  *      This program is distributed in the hope that it will be useful,
  12  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *      GNU General Public License for more details.
  15  *
  16  *      You should have received a copy of the GNU General Public License along
  17  *      with this program; if not, write to the Free Software Foundation, Inc.,
  18  *      51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  19  */
  20
  21
  22 #ifndef GEANY_SPAWN_H
  23 #define GEANY_SPAWN_H 1
  24
  25 #include <glib.h>
  26
  27 #ifdef G_OS_WIN32
  28 # define WIFEXITED(status) TRUE
  29 # define WEXITSTATUS(status) (status)
  30 # define WIFSIGNALLED(status) FALSE
  31 #else
  32 # include <sys/types.h>
  33 # include <sys/wait.h>
  34 #endif
  35
  36 gchar *spawn_get_program_name(const gchar *command_line, GError **error);
  37
  38 gboolean spawn_check_command(const gchar *command_line, gboolean execute, GError **error);
  39
  40 gboolean spawn_kill_process(GPid pid, GError **error);
  41
  42 gboolean spawn_async_with_pipes(const gchar *working_directory, const gchar *command_line,
  43         gchar **argv, gchar **envp, GPid *child_pid, gint *stdin_fd, gint *stdout_fd,
  44         gint *stderr_fd, GError **error);
  45
  46 gboolean spawn_async(const gchar *working_directory, const gchar *command_line, gchar **argv,
  47         gchar **envp, GPid *child_pid, GError **error);
  48
  49 /** Flags passed to @c spawn_with_callbacks(), which see. */
  50 typedef enum
  51 {
  52         SPAWN_ASYNC                = 0x00,  /**< Asynchronous execution [default]. */
  53         SPAWN_SYNC                 = 0x01,  /**< Synchronous execution. */
  54         /* buffering modes */
  55         SPAWN_LINE_BUFFERED        = 0x00,  /**< stdout/stderr are line buffered [default]. */
  56         SPAWN_STDOUT_UNBUFFERED    = 0x02,  /**< stdout is not buffered. */
  57         SPAWN_STDERR_UNBUFFERED    = 0x04,  /**< stderr is not buffered. */
  58         SPAWN_UNBUFFERED           = 0x06,  /**< stdout/stderr are not buffered. */
  59         /* recursive modes */
  60         SPAWN_STDIN_RECURSIVE      = 0x08,  /**< The stdin callback is recursive. */
  61         SPAWN_STDOUT_RECURSIVE     = 0x10,  /**< The stdout callback is recursive. */
  62         SPAWN_STDERR_RECURSIVE     = 0x20,  /**< The stderr callback is recursive. */
  63         SPAWN_RECURSIVE            = 0x38   /**< All callbacks are recursive. */
  64 } SpawnFlags;
  65
  66 /**
  67  *  Specifies the type of function passed to @c spawn_with_callbacks() as stdout or stderr
  68  *  callback.
  69  *
  70  *  In unbuffered mode, the @a string may contain nuls, while in line buffered mode, it may
  71  *  contain only a single nul as a line termination character at @a string->len - 1. In all
  72  *  cases, the @a string will be terminated with a nul character that is not part of the data
  73  *  at @a string->len.
  74  *
  75  *  If @c G_IO_IN or @c G_IO_PRI are set, the @a string will contain at least one character.
  76  *
  77  *  @param string contains the child data if @c G_IO_IN or @c G_IO_PRI are set.
  78  *  @param condition the I/O condition which has been satisfied.
  79  *  @param data the passed to @c spawn_with_callbacks() with the callback.
  80  */
  81 typedef void (*SpawnReadFunc)(GString *string, GIOCondition condition, gpointer data);
  82
  83 gboolean spawn_with_callbacks(const gchar *working_directory, const gchar *command_line,
  84         gchar **argv, gchar **envp, SpawnFlags spawn_flags, GIOFunc stdin_cb, gpointer stdin_data,
  85         SpawnReadFunc stdout_cb, gpointer stdout_data, gsize stdout_max_length,
  86         SpawnReadFunc stderr_cb, gpointer stderr_data, gsize stderr_max_length,
  87         GChildWatchFunc exit_cb, gpointer exit_data, GPid *child_pid, GError **error);
  88
  89 /**
  90  *  A simple structure used by @c spawn_write_data() to write data to a channel.
  91  *  See @c spawn_write_data() for more information.
  92  */
  93 typedef struct _SpawnWriteData
  94 {
  95         const gchar *ptr;   /**< Pointer to the data. May be NULL if the size is 0. */
  96         gsize size;         /**< Size of the data. */
  97 } SpawnWriteData;
  98
  99 gboolean spawn_write_data(GIOChannel *channel, GIOCondition condition, SpawnWriteData *data);
 100
 101 void spawn_get_exit_status_cb(GPid pid, gint status, gpointer exit_status);
 102
 103 gboolean spawn_sync(const gchar *working_directory, const gchar *command_line, gchar **argv,
 104         gchar **envp, SpawnWriteData *stdin_data, GString *stdout_data, GString *stderr_data,
 105         gint *exit_status, GError **error);
 106
 107 #endif  /* GEANY_SPAWN_H */