1/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2/* dbus-spawn.h Wrapper around fork/exec
3 *
4 * Copyright (C) 2002, 2003  Red Hat, Inc.
5 * Copyright (C) 2003 CodeFactory AB
6 *
7 * Licensed under the Academic Free License version 2.1
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
22 *
23 */
24
25#ifndef DBUS_SPAWN_H
26#define DBUS_SPAWN_H
27
28#include <dbus/dbus-string.h>
29#include <dbus/dbus-errors.h>
30#include <dbus/dbus-watch.h>
31
32DBUS_BEGIN_DECLS
33
34typedef void (* DBusSpawnChildSetupFunc) (void *user_data);
35
36typedef struct DBusBabysitter DBusBabysitter;
37
38typedef void (* DBusBabysitterFinishedFunc) (DBusBabysitter *sitter,
39                                             void           *user_data);
40
41dbus_bool_t _dbus_spawn_async_with_babysitter     (DBusBabysitter           **sitter_p,
42                                                   char                     **argv,
43                                                   char                     **env,
44                                                   DBusSpawnChildSetupFunc    child_setup,
45                                                   void                      *user_data,
46                                                   DBusError                 *error);
47void        _dbus_babysitter_set_result_function  (DBusBabysitter            *sitter,
48                                                   DBusBabysitterFinishedFunc finished,
49                                                   void                      *user_data);
50DBusBabysitter* _dbus_babysitter_ref              (DBusBabysitter            *sitter);
51void        _dbus_babysitter_unref                (DBusBabysitter            *sitter);
52void        _dbus_babysitter_kill_child           (DBusBabysitter            *sitter);
53dbus_bool_t _dbus_babysitter_get_child_exited     (DBusBabysitter            *sitter);
54void        _dbus_babysitter_set_child_exit_error (DBusBabysitter            *sitter,
55                                                   DBusError                 *error);
56dbus_bool_t _dbus_babysitter_get_child_exit_status (DBusBabysitter           *sitter,
57                                                    int                      *status);
58dbus_bool_t _dbus_babysitter_set_watch_functions  (DBusBabysitter            *sitter,
59                                                   DBusAddWatchFunction       add_function,
60                                                   DBusRemoveWatchFunction    remove_function,
61                                                   DBusWatchToggledFunction   toggled_function,
62                                                   void                      *data,
63                                                   DBusFreeFunction           free_data_function);
64
65DBUS_END_DECLS
66
67#endif /* DBUS_SPAWN_H */
68