dbus/dbus-spawn.h

   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
  32 DBUS_BEGIN_DECLS
  33
  34 typedef void (* DBusSpawnChildSetupFunc) (void *user_data);
  35
  36 typedef struct DBusBabysitter DBusBabysitter;
  37
  38 typedef void (* DBusBabysitterFinishedFunc) (DBusBabysitter *sitter,
  39                                              void           *user_data);
  40
  41 dbus_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);
  47 void        _dbus_babysitter_set_result_function  (DBusBabysitter            *sitter,
  48                                                    DBusBabysitterFinishedFunc finished,
  49                                                    void                      *user_data);
  50 DBusBabysitter* _dbus_babysitter_ref              (DBusBabysitter            *sitter);
  51 void        _dbus_babysitter_unref                (DBusBabysitter            *sitter);
  52 void        _dbus_babysitter_kill_child           (DBusBabysitter            *sitter);
  53 dbus_bool_t _dbus_babysitter_get_child_exited     (DBusBabysitter            *sitter);
  54 void        _dbus_babysitter_set_child_exit_error (DBusBabysitter            *sitter,
  55                                                    DBusError                 *error);
  56 dbus_bool_t _dbus_babysitter_get_child_exit_status (DBusBabysitter           *sitter,
  57                                                     int                      *status);
  58 dbus_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
  65 DBUS_END_DECLS
  66
  67 #endif /* DBUS_SPAWN_H */