/usr/include/geany/spawn.h is in geany-common 1.27-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 | /*
* spawn.h - this file is part of Geany, a fast and lightweight IDE
*
* Copyright 2013 Dimitar Toshkov Zhekov <dimitar(dot)zhekov(at)gmail(dot)com>
*
* 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 GEANY_SPAWN_H
#define GEANY_SPAWN_H 1
#include <glib.h>
#ifdef G_OS_WIN32
# define SPAWN_WIFEXITED(status) TRUE
# define SPAWN_WEXITSTATUS(status) (status)
# define SPAWN_WIFSIGNALED(status) FALSE
#else
# include <sys/types.h>
# include <sys/wait.h>
# define SPAWN_WIFEXITED(status) WIFEXITED(status) /**< non-zero if the child exited normally */
# define SPAWN_WEXITSTATUS(status) WEXITSTATUS(status) /**< exit status of a child if exited normally */
# define SPAWN_WIFSIGNALED(status) WIFSIGNALED(status) /**< non-zero if the child exited due to signal */
#endif
G_BEGIN_DECLS
gboolean spawn_check_command(const gchar *command_line, gboolean execute, GError **error);
gboolean spawn_kill_process(GPid pid, GError **error);
gboolean spawn_async(const gchar *working_directory, const gchar *command_line, gchar **argv,
gchar **envp, GPid *child_pid, GError **error);
/** Flags passed to @c spawn_with_callbacks(), which see. */
typedef enum
{
SPAWN_ASYNC = 0x00, /**< Asynchronous execution [default]. */
SPAWN_SYNC = 0x01, /**< Synchronous execution. */
/* buffering modes */
SPAWN_LINE_BUFFERED = 0x00, /**< stdout/stderr are line buffered [default]. */
SPAWN_STDOUT_UNBUFFERED = 0x02, /**< stdout is not buffered. */
SPAWN_STDERR_UNBUFFERED = 0x04, /**< stderr is not buffered. */
SPAWN_UNBUFFERED = 0x06, /**< stdout/stderr are not buffered. */
/* recursive modes */
SPAWN_STDIN_RECURSIVE = 0x08, /**< The stdin callback is recursive. */
SPAWN_STDOUT_RECURSIVE = 0x10, /**< The stdout callback is recursive. */
SPAWN_STDERR_RECURSIVE = 0x20, /**< The stderr callback is recursive. */
SPAWN_RECURSIVE = 0x38 /**< All callbacks are recursive. */
} SpawnFlags;
/**
* Specifies the type of function passed to @c spawn_with_callbacks() as stdout or stderr
* callback.
*
* In unbuffered mode, the @a string may contain nuls, while in line buffered mode, it may
* contain only a single nul as a line termination character at @a string->len - 1. In all
* cases, the @a string will be terminated with a nul character that is not part of the data
* at @a string->len.
*
* If @c G_IO_IN or @c G_IO_PRI are set, the @a string will contain at least one character.
*
* @param string contains the child data if @c G_IO_IN or @c G_IO_PRI are set.
* @param condition the I/O condition which has been satisfied.
* @param data the passed to @c spawn_with_callbacks() with the callback.
*/
typedef void (*SpawnReadFunc)(GString *string, GIOCondition condition, gpointer data);
gboolean spawn_with_callbacks(const gchar *working_directory, const gchar *command_line,
gchar **argv, gchar **envp, SpawnFlags spawn_flags, GIOFunc stdin_cb, gpointer stdin_data,
SpawnReadFunc stdout_cb, gpointer stdout_data, gsize stdout_max_length,
SpawnReadFunc stderr_cb, gpointer stderr_data, gsize stderr_max_length,
GChildWatchFunc exit_cb, gpointer exit_data, GPid *child_pid, GError **error);
/**
* A simple structure used by @c spawn_write_data() to write data to a channel.
* See @c spawn_write_data() for more information.
*/
typedef struct _SpawnWriteData
{
const gchar *ptr; /**< Pointer to the data. May be NULL if the size is 0. */
gsize size; /**< Size of the data. */
} SpawnWriteData;
gboolean spawn_write_data(GIOChannel *channel, GIOCondition condition, SpawnWriteData *data);
gboolean spawn_sync(const gchar *working_directory, const gchar *command_line, gchar **argv,
gchar **envp, SpawnWriteData *stdin_data, GString *stdout_data, GString *stderr_data,
gint *exit_status, GError **error);
G_END_DECLS
#endif /* GEANY_SPAWN_H */
|