df54412bd2e80772790af041edfca22a3d62c788
[monky] / src / dbus / dbus-connection-internal.h
1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2 /* dbus-connection-internal.h DBusConnection internal interfaces
3  *
4  * Copyright (C) 2002  Red Hat Inc.
5  *
6  * Licensed under the Academic Free License version 2.1
7  * 
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  * GNU General Public License for more details.
17  * 
18  * You should have received a copy of the GNU General Public License
19  * along with this program; if not, write to the Free Software
20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
21  *
22  */
23 #ifndef DBUS_CONNECTION_INTERNAL_H
24 #define DBUS_CONNECTION_INTERNAL_H
25
26 #include <dbus/dbus-internals.h>
27 #include <dbus/dbus-connection.h>
28 #include <dbus/dbus-message.h>
29 #include <dbus/dbus-transport.h>
30 #include <dbus/dbus-resources.h>
31 #include <dbus/dbus-list.h>
32 #include <dbus/dbus-timeout.h>
33 #include <dbus/dbus-dataslot.h>
34
35 DBUS_BEGIN_DECLS
36
37 typedef enum
38 {
39   DBUS_ITERATION_DO_WRITING = 1 << 0, /**< Write messages out. */
40   DBUS_ITERATION_DO_READING = 1 << 1, /**< Read messages in. */
41   DBUS_ITERATION_BLOCK      = 1 << 2  /**< Block if nothing to do. */
42 } DBusIterationFlags;
43
44 /** default timeout value when waiting for a message reply, 25 seconds */
45 #define _DBUS_DEFAULT_TIMEOUT_VALUE (25 * 1000)
46
47 void              _dbus_connection_lock                        (DBusConnection     *connection);
48 void              _dbus_connection_unlock                      (DBusConnection     *connection);
49 DBusConnection *  _dbus_connection_ref_unlocked                (DBusConnection     *connection);
50 void              _dbus_connection_unref_unlocked              (DBusConnection     *connection);
51 dbus_bool_t       _dbus_connection_queue_received_message      (DBusConnection     *connection,
52                                                                 DBusMessage        *message);
53 void              _dbus_connection_queue_received_message_link (DBusConnection     *connection,
54                                                                 DBusList           *link);
55 dbus_bool_t       _dbus_connection_has_messages_to_send_unlocked (DBusConnection     *connection);
56 DBusMessage*      _dbus_connection_get_message_to_send         (DBusConnection     *connection);
57 void              _dbus_connection_message_sent                (DBusConnection     *connection,
58                                                                 DBusMessage        *message);
59 dbus_bool_t       _dbus_connection_add_watch_unlocked          (DBusConnection     *connection,
60                                                                 DBusWatch          *watch);
61 void              _dbus_connection_remove_watch_unlocked       (DBusConnection     *connection,
62                                                                 DBusWatch          *watch);
63 void              _dbus_connection_toggle_watch_unlocked       (DBusConnection     *connection,
64                                                                 DBusWatch          *watch,
65                                                                 dbus_bool_t         enabled);
66 dbus_bool_t       _dbus_connection_handle_watch                (DBusWatch          *watch,
67                                                                 unsigned int        condition,
68                                                                 void               *data);
69 dbus_bool_t       _dbus_connection_add_timeout_unlocked        (DBusConnection     *connection,
70                                                                 DBusTimeout        *timeout);
71 void              _dbus_connection_remove_timeout_unlocked     (DBusConnection     *connection,
72                                                                 DBusTimeout        *timeout);
73 void              _dbus_connection_toggle_timeout_unlocked     (DBusConnection     *connection,
74                                                                 DBusTimeout        *timeout,
75                                                                 dbus_bool_t         enabled);
76 DBusConnection*   _dbus_connection_new_for_transport           (DBusTransport      *transport);
77 void              _dbus_connection_do_iteration_unlocked       (DBusConnection     *connection,
78                                                                 unsigned int        flags,
79                                                                 int                 timeout_milliseconds);
80 void              _dbus_connection_close_possibly_shared       (DBusConnection     *connection);
81 void              _dbus_connection_close_if_only_one_ref       (DBusConnection     *connection);
82
83 DBusPendingCall*  _dbus_pending_call_new                       (DBusConnection     *connection,
84                                                                 int                 timeout_milliseconds,
85                                                                 DBusTimeoutHandler  timeout_handler);
86 void              _dbus_pending_call_notify                    (DBusPendingCall    *pending);
87 void              _dbus_connection_remove_pending_call         (DBusConnection     *connection,
88                                                                 DBusPendingCall    *pending);
89 void              _dbus_connection_block_pending_call          (DBusPendingCall    *pending);
90 void              _dbus_pending_call_complete_and_unlock       (DBusPendingCall    *pending,
91                                                                 DBusMessage        *message);
92 dbus_bool_t       _dbus_connection_send_and_unlock             (DBusConnection     *connection,
93                                                                 DBusMessage        *message,
94                                                                 dbus_uint32_t      *client_serial);
95
96 void              _dbus_connection_queue_synthesized_message_link (DBusConnection *connection,
97                                                                    DBusList *link);
98 void              _dbus_connection_test_get_locks                 (DBusConnection *conn,
99                                                                    DBusMutex **mutex_loc,
100                                                                    DBusMutex **dispatch_mutex_loc,
101                                                                    DBusMutex **io_path_mutex_loc,
102                                                                    DBusCondVar **dispatch_cond_loc,
103                                                                    DBusCondVar **io_path_cond_loc);
104
105 /* This _dbus_bus_* stuff doesn't really belong here, but dbus-bus-internal.h seems
106  * silly for one function
107  */
108 /**
109  * @addtogroup DBusBusInternals
110  * @{
111  */
112
113 void           _dbus_bus_notify_shared_connection_disconnected_unlocked (DBusConnection *connection);
114
115 /** @} */
116
117
118 DBUS_END_DECLS
119
120 #endif /* DBUS_CONNECTION_INTERNAL_H */