D-Bus  1.11.10
dbus-connection.c
1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
2 /* dbus-connection.c DBusConnection object
3  *
4  * Copyright (C) 2002-2006 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  *
22  */
23 
24 #include <config.h>
25 #include "dbus-shared.h"
26 #include "dbus-connection.h"
27 #include "dbus-list.h"
28 #include "dbus-timeout.h"
29 #include "dbus-transport.h"
30 #include "dbus-watch.h"
31 #include "dbus-connection-internal.h"
32 #include "dbus-pending-call-internal.h"
33 #include "dbus-list.h"
34 #include "dbus-hash.h"
35 #include "dbus-message-internal.h"
36 #include "dbus-message-private.h"
37 #include "dbus-threads.h"
38 #include "dbus-protocol.h"
39 #include "dbus-dataslot.h"
40 #include "dbus-string.h"
41 #include "dbus-signature.h"
42 #include "dbus-pending-call.h"
43 #include "dbus-object-tree.h"
44 #include "dbus-threads-internal.h"
45 #include "dbus-bus.h"
46 #include "dbus-marshal-basic.h"
47 
48 #ifdef DBUS_DISABLE_CHECKS
49 #define TOOK_LOCK_CHECK(connection)
50 #define RELEASING_LOCK_CHECK(connection)
51 #define HAVE_LOCK_CHECK(connection)
52 #else
53 #define TOOK_LOCK_CHECK(connection) do { \
54  _dbus_assert (!(connection)->have_connection_lock); \
55  (connection)->have_connection_lock = TRUE; \
56  } while (0)
57 #define RELEASING_LOCK_CHECK(connection) do { \
58  _dbus_assert ((connection)->have_connection_lock); \
59  (connection)->have_connection_lock = FALSE; \
60  } while (0)
61 #define HAVE_LOCK_CHECK(connection) _dbus_assert ((connection)->have_connection_lock)
62 /* A "DO_NOT_HAVE_LOCK_CHECK" is impossible since we need the lock to check the flag */
63 #endif
64 
65 #define TRACE_LOCKS 1
66 
67 #define CONNECTION_LOCK(connection) do { \
68  if (TRACE_LOCKS) { _dbus_verbose ("LOCK\n"); } \
69  _dbus_rmutex_lock ((connection)->mutex); \
70  TOOK_LOCK_CHECK (connection); \
71  } while (0)
72 
73 #define CONNECTION_UNLOCK(connection) _dbus_connection_unlock (connection)
74 
75 #define SLOTS_LOCK(connection) do { \
76  _dbus_rmutex_lock ((connection)->slot_mutex); \
77  } while (0)
78 
79 #define SLOTS_UNLOCK(connection) do { \
80  _dbus_rmutex_unlock ((connection)->slot_mutex); \
81  } while (0)
82 
83 #define DISPATCH_STATUS_NAME(s) \
84  ((s) == DBUS_DISPATCH_COMPLETE ? "complete" : \
85  (s) == DBUS_DISPATCH_DATA_REMAINS ? "data remains" : \
86  (s) == DBUS_DISPATCH_NEED_MEMORY ? "need memory" : \
87  "???")
88 
206 static void
207 _dbus_connection_trace_ref (DBusConnection *connection,
208  int old_refcount,
209  int new_refcount,
210  const char *why)
211 {
212 #ifdef DBUS_ENABLE_VERBOSE_MODE
213  static int enabled = -1;
214 
215  _dbus_trace_ref ("DBusConnection", connection, old_refcount, new_refcount,
216  why, "DBUS_CONNECTION_TRACE", &enabled);
217 #endif
218 }
219 
224 
229 {
232  void *user_data;
234 };
235 
236 
241 {
245 };
246 
247 #if HAVE_DECL_MSG_NOSIGNAL
248 static dbus_bool_t _dbus_modify_sigpipe = FALSE;
249 #else
250 static dbus_bool_t _dbus_modify_sigpipe = TRUE;
251 #endif
252 
257 {
291  dbus_uint32_t client_serial;
306  char *server_guid;
308  /* These two MUST be bools and not bitfields, because they are protected by a separate lock
309  * from connection->mutex and all bitfields in a word have to be read/written together.
310  * So you can't have a different lock for different bitfields in the same word.
311  */
315  unsigned int shareable : 1;
317  unsigned int exit_on_disconnect : 1;
319  unsigned int route_peer_messages : 1;
321  unsigned int disconnected_message_arrived : 1;
329 #ifndef DBUS_DISABLE_CHECKS
330  unsigned int have_connection_lock : 1;
331 #endif
332 
333 #if defined(DBUS_ENABLE_CHECKS) || defined(DBUS_ENABLE_ASSERT)
334  int generation;
335 #endif
336 };
337 
338 static DBusDispatchStatus _dbus_connection_get_dispatch_status_unlocked (DBusConnection *connection);
339 static void _dbus_connection_update_dispatch_status_and_unlock (DBusConnection *connection,
340  DBusDispatchStatus new_status);
341 static void _dbus_connection_last_unref (DBusConnection *connection);
342 static void _dbus_connection_acquire_dispatch (DBusConnection *connection);
343 static void _dbus_connection_release_dispatch (DBusConnection *connection);
344 static DBusDispatchStatus _dbus_connection_flush_unlocked (DBusConnection *connection);
345 static void _dbus_connection_close_possibly_shared_and_unlock (DBusConnection *connection);
346 static dbus_bool_t _dbus_connection_get_is_connected_unlocked (DBusConnection *connection);
347 static dbus_bool_t _dbus_connection_peek_for_reply_unlocked (DBusConnection *connection,
348  dbus_uint32_t client_serial);
349 
350 static DBusMessageFilter *
351 _dbus_message_filter_ref (DBusMessageFilter *filter)
352 {
353 #ifdef DBUS_DISABLE_ASSERT
354  _dbus_atomic_inc (&filter->refcount);
355 #else
356  dbus_int32_t old_value;
357 
358  old_value = _dbus_atomic_inc (&filter->refcount);
359  _dbus_assert (old_value > 0);
360 #endif
361 
362  return filter;
363 }
364 
365 static void
366 _dbus_message_filter_unref (DBusMessageFilter *filter)
367 {
368  dbus_int32_t old_value;
369 
370  old_value = _dbus_atomic_dec (&filter->refcount);
371  _dbus_assert (old_value > 0);
372 
373  if (old_value == 1)
374  {
375  if (filter->free_user_data_function)
376  (* filter->free_user_data_function) (filter->user_data);
377 
378  dbus_free (filter);
379  }
380 }
381 
387 void
389 {
390  CONNECTION_LOCK (connection);
391 }
392 
398 void
400 {
401  DBusList *expired_messages;
402  DBusList *iter;
403 
404  if (TRACE_LOCKS)
405  {
406  _dbus_verbose ("UNLOCK\n");
407  }
408 
409  /* If we had messages that expired (fell off the incoming or outgoing
410  * queues) while we were locked, actually release them now */
411  expired_messages = connection->expired_messages;
412  connection->expired_messages = NULL;
413 
414  RELEASING_LOCK_CHECK (connection);
415  _dbus_rmutex_unlock (connection->mutex);
416 
417  for (iter = _dbus_list_pop_first_link (&expired_messages);
418  iter != NULL;
419  iter = _dbus_list_pop_first_link (&expired_messages))
420  {
421  DBusMessage *message = iter->data;
422 
423  dbus_message_unref (message);
424  _dbus_list_free_link (iter);
425  }
426 }
427 
435 static void
436 _dbus_connection_wakeup_mainloop (DBusConnection *connection)
437 {
438  if (connection->wakeup_main_function)
439  (*connection->wakeup_main_function) (connection->wakeup_main_data);
440 }
441 
442 #ifdef DBUS_ENABLE_EMBEDDED_TESTS
443 
455 void
456 _dbus_connection_test_get_locks (DBusConnection *connection,
457  DBusMutex **mutex_loc,
458  DBusMutex **dispatch_mutex_loc,
459  DBusMutex **io_path_mutex_loc,
460  DBusCondVar **dispatch_cond_loc,
461  DBusCondVar **io_path_cond_loc)
462 {
463  *mutex_loc = (DBusMutex *) connection->mutex;
464  *dispatch_mutex_loc = (DBusMutex *) connection->dispatch_mutex;
465  *io_path_mutex_loc = (DBusMutex *) connection->io_path_mutex;
466  *dispatch_cond_loc = connection->dispatch_cond;
467  *io_path_cond_loc = connection->io_path_cond;
468 }
469 #endif
470 
479 void
481  DBusList *link)
482 {
483  DBusPendingCall *pending;
484  dbus_uint32_t reply_serial;
485  DBusMessage *message;
486 
488 
490  link);
491  message = link->data;
492 
493  /* If this is a reply we're waiting on, remove timeout for it */
494  reply_serial = dbus_message_get_reply_serial (message);
495  if (reply_serial != 0)
496  {
497  pending = _dbus_hash_table_lookup_int (connection->pending_replies,
498  reply_serial);
499  if (pending != NULL)
500  {
504 
506  }
507  }
508 
509 
510 
511  connection->n_incoming += 1;
512 
513  _dbus_connection_wakeup_mainloop (connection);
514 
515  _dbus_verbose ("Message %p (%s %s %s %s '%s' reply to %u) added to incoming queue %p, %d incoming\n",
516  message,
518  dbus_message_get_path (message) ?
519  dbus_message_get_path (message) :
520  "no path",
521  dbus_message_get_interface (message) ?
522  dbus_message_get_interface (message) :
523  "no interface",
524  dbus_message_get_member (message) ?
525  dbus_message_get_member (message) :
526  "no member",
527  dbus_message_get_signature (message),
529  connection,
530  connection->n_incoming);
531 
532  _dbus_message_trace_ref (message, -1, -1,
533  "_dbus_conection_queue_received_message_link");
534 }
535 
544 void
546  DBusList *link)
547 {
548  HAVE_LOCK_CHECK (connection);
549 
550  _dbus_list_append_link (&connection->incoming_messages, link);
551 
552  connection->n_incoming += 1;
553 
554  _dbus_connection_wakeup_mainloop (connection);
555 
556  _dbus_message_trace_ref (link->data, -1, -1,
557  "_dbus_connection_queue_synthesized_message_link");
558 
559  _dbus_verbose ("Synthesized message %p added to incoming queue %p, %d incoming\n",
560  link->data, connection, connection->n_incoming);
561 }
562 
563 
573 {
574  HAVE_LOCK_CHECK (connection);
575  return connection->outgoing_messages != NULL;
576 }
577 
589 {
590  dbus_bool_t v;
591 
592  _dbus_return_val_if_fail (connection != NULL, FALSE);
593 
594  CONNECTION_LOCK (connection);
596  CONNECTION_UNLOCK (connection);
597 
598  return v;
599 }
600 
610 {
611  HAVE_LOCK_CHECK (connection);
612 
613  return _dbus_list_get_last (&connection->outgoing_messages);
614 }
615 
624 void
626  DBusMessage *message)
627 {
628  DBusList *link;
629 
630  HAVE_LOCK_CHECK (connection);
631 
632  /* This can be called before we even complete authentication, since
633  * it's called on disconnect to clean up the outgoing queue.
634  * It's also called as we successfully send each message.
635  */
636 
637  link = _dbus_list_get_last_link (&connection->outgoing_messages);
638  _dbus_assert (link != NULL);
639  _dbus_assert (link->data == message);
640 
641  _dbus_list_unlink (&connection->outgoing_messages,
642  link);
643  _dbus_list_prepend_link (&connection->expired_messages, link);
644 
645  connection->n_outgoing -= 1;
646 
647  _dbus_verbose ("Message %p (%s %s %s %s '%s') removed from outgoing queue %p, %d left to send\n",
648  message,
650  dbus_message_get_path (message) ?
651  dbus_message_get_path (message) :
652  "no path",
653  dbus_message_get_interface (message) ?
654  dbus_message_get_interface (message) :
655  "no interface",
656  dbus_message_get_member (message) ?
657  dbus_message_get_member (message) :
658  "no member",
659  dbus_message_get_signature (message),
660  connection, connection->n_outgoing);
661 
662  /* It's OK that in principle we call the notify function, because for the
663  * outgoing limit, there isn't one */
664  _dbus_message_remove_counter (message, connection->outgoing_counter);
665 
666  /* The message will actually be unreffed when we unlock */
667 }
668 
671  DBusWatch *watch);
673 typedef void (* DBusWatchRemoveFunction) (DBusWatchList *list,
674  DBusWatch *watch);
676 typedef void (* DBusWatchToggleFunction) (DBusWatchList *list,
677  DBusWatch *watch,
678  dbus_bool_t enabled);
679 
680 static dbus_bool_t
681 protected_change_watch (DBusConnection *connection,
682  DBusWatch *watch,
683  DBusWatchAddFunction add_function,
684  DBusWatchRemoveFunction remove_function,
685  DBusWatchToggleFunction toggle_function,
686  dbus_bool_t enabled)
687 {
688  dbus_bool_t retval;
689 
690  HAVE_LOCK_CHECK (connection);
691 
692  /* The original purpose of protected_change_watch() was to hold a
693  * ref on the connection while dropping the connection lock, then
694  * calling out to the app. This was a broken hack that did not
695  * work, since the connection was in a hosed state (no WatchList
696  * field) while calling out.
697  *
698  * So for now we'll just keep the lock while calling out. This means
699  * apps are not allowed to call DBusConnection methods inside a
700  * watch function or they will deadlock.
701  *
702  * The "real fix" is to use the _and_unlock() pattern found
703  * elsewhere in the code, to defer calling out to the app until
704  * we're about to drop locks and return flow of control to the app
705  * anyway.
706  *
707  * See http://lists.freedesktop.org/archives/dbus/2007-July/thread.html#8144
708  */
709 
710  if (connection->watches)
711  {
712  if (add_function)
713  retval = (* add_function) (connection->watches, watch);
714  else if (remove_function)
715  {
716  retval = TRUE;
717  (* remove_function) (connection->watches, watch);
718  }
719  else
720  {
721  retval = TRUE;
722  (* toggle_function) (connection->watches, watch, enabled);
723  }
724  return retval;
725  }
726  else
727  return FALSE;
728 }
729 
730 
744  DBusWatch *watch)
745 {
746  return protected_change_watch (connection, watch,
748  NULL, NULL, FALSE);
749 }
750 
760 void
762  DBusWatch *watch)
763 {
764  protected_change_watch (connection, watch,
765  NULL,
767  NULL, FALSE);
768 }
769 
780 void
782  DBusWatch *watch,
783  dbus_bool_t enabled)
784 {
785  _dbus_assert (watch != NULL);
786 
787  protected_change_watch (connection, watch,
788  NULL, NULL,
790  enabled);
791 }
792 
795  DBusTimeout *timeout);
798  DBusTimeout *timeout);
801  DBusTimeout *timeout,
802  dbus_bool_t enabled);
803 
804 static dbus_bool_t
805 protected_change_timeout (DBusConnection *connection,
806  DBusTimeout *timeout,
807  DBusTimeoutAddFunction add_function,
808  DBusTimeoutRemoveFunction remove_function,
809  DBusTimeoutToggleFunction toggle_function,
810  dbus_bool_t enabled)
811 {
812  dbus_bool_t retval;
813 
814  HAVE_LOCK_CHECK (connection);
815 
816  /* The original purpose of protected_change_timeout() was to hold a
817  * ref on the connection while dropping the connection lock, then
818  * calling out to the app. This was a broken hack that did not
819  * work, since the connection was in a hosed state (no TimeoutList
820  * field) while calling out.
821  *
822  * So for now we'll just keep the lock while calling out. This means
823  * apps are not allowed to call DBusConnection methods inside a
824  * timeout function or they will deadlock.
825  *
826  * The "real fix" is to use the _and_unlock() pattern found
827  * elsewhere in the code, to defer calling out to the app until
828  * we're about to drop locks and return flow of control to the app
829  * anyway.
830  *
831  * See http://lists.freedesktop.org/archives/dbus/2007-July/thread.html#8144
832  */
833 
834  if (connection->timeouts)
835  {
836  if (add_function)
837  retval = (* add_function) (connection->timeouts, timeout);
838  else if (remove_function)
839  {
840  retval = TRUE;
841  (* remove_function) (connection->timeouts, timeout);
842  }
843  else
844  {
845  retval = TRUE;
846  (* toggle_function) (connection->timeouts, timeout, enabled);
847  }
848  return retval;
849  }
850  else
851  return FALSE;
852 }
853 
868  DBusTimeout *timeout)
869 {
870  return protected_change_timeout (connection, timeout,
872  NULL, NULL, FALSE);
873 }
874 
884 void
886  DBusTimeout *timeout)
887 {
888  protected_change_timeout (connection, timeout,
889  NULL,
891  NULL, FALSE);
892 }
893 
904 void
906  DBusTimeout *timeout,
907  dbus_bool_t enabled)
908 {
909  protected_change_timeout (connection, timeout,
910  NULL, NULL,
912  enabled);
913 }
914 
915 static dbus_bool_t
916 _dbus_connection_attach_pending_call_unlocked (DBusConnection *connection,
917  DBusPendingCall *pending)
918 {
919  dbus_uint32_t reply_serial;
920  DBusTimeout *timeout;
921 
922  HAVE_LOCK_CHECK (connection);
923 
924  reply_serial = _dbus_pending_call_get_reply_serial_unlocked (pending);
925 
926  _dbus_assert (reply_serial != 0);
927 
928  timeout = _dbus_pending_call_get_timeout_unlocked (pending);
929 
930  if (timeout)
931  {
932  if (!_dbus_connection_add_timeout_unlocked (connection, timeout))
933  return FALSE;
934 
936  reply_serial,
937  pending))
938  {
939  _dbus_connection_remove_timeout_unlocked (connection, timeout);
940 
942  HAVE_LOCK_CHECK (connection);
943  return FALSE;
944  }
945 
947  }
948  else
949  {
951  reply_serial,
952  pending))
953  {
954  HAVE_LOCK_CHECK (connection);
955  return FALSE;
956  }
957  }
958 
960 
961  HAVE_LOCK_CHECK (connection);
962 
963  return TRUE;
964 }
965 
966 static void
967 free_pending_call_on_hash_removal (void *data)
968 {
969  DBusPendingCall *pending;
970  DBusConnection *connection;
971 
972  if (data == NULL)
973  return;
974 
975  pending = data;
976 
977  connection = _dbus_pending_call_get_connection_unlocked (pending);
978 
979  HAVE_LOCK_CHECK (connection);
980 
982  {
985 
987  }
988 
989  /* FIXME 1.0? this is sort of dangerous and undesirable to drop the lock
990  * here, but the pending call finalizer could in principle call out to
991  * application code so we pretty much have to... some larger code reorg
992  * might be needed.
993  */
994  _dbus_connection_ref_unlocked (connection);
996  CONNECTION_LOCK (connection);
997  _dbus_connection_unref_unlocked (connection);
998 }
999 
1000 static void
1001 _dbus_connection_detach_pending_call_unlocked (DBusConnection *connection,
1002  DBusPendingCall *pending)
1003 {
1004  /* This ends up unlocking to call the pending call finalizer, which is unexpected to
1005  * say the least.
1006  */
1009 }
1010 
1011 static void
1012 _dbus_connection_detach_pending_call_and_unlock (DBusConnection *connection,
1013  DBusPendingCall *pending)
1014 {
1015  /* The idea here is to avoid finalizing the pending call
1016  * with the lock held, since there's a destroy notifier
1017  * in pending call that goes out to application code.
1018  *
1019  * There's an extra unlock inside the hash table
1020  * "free pending call" function FIXME...
1021  */
1025 
1029 
1031 
1033 }
1034 
1043 void
1045  DBusPendingCall *pending)
1046 {
1047  CONNECTION_LOCK (connection);
1048  _dbus_connection_detach_pending_call_and_unlock (connection, pending);
1049 }
1050 
1060 static dbus_bool_t
1061 _dbus_connection_acquire_io_path (DBusConnection *connection,
1062  int timeout_milliseconds)
1063 {
1064  dbus_bool_t we_acquired;
1065 
1066  HAVE_LOCK_CHECK (connection);
1067 
1068  /* We don't want the connection to vanish */
1069  _dbus_connection_ref_unlocked (connection);
1070 
1071  /* We will only touch io_path_acquired which is protected by our mutex */
1072  CONNECTION_UNLOCK (connection);
1073 
1074  _dbus_verbose ("locking io_path_mutex\n");
1075  _dbus_cmutex_lock (connection->io_path_mutex);
1076 
1077  _dbus_verbose ("start connection->io_path_acquired = %d timeout = %d\n",
1078  connection->io_path_acquired, timeout_milliseconds);
1079 
1080  we_acquired = FALSE;
1081 
1082  if (connection->io_path_acquired)
1083  {
1084  if (timeout_milliseconds != -1)
1085  {
1086  _dbus_verbose ("waiting %d for IO path to be acquirable\n",
1087  timeout_milliseconds);
1088 
1089  if (!_dbus_condvar_wait_timeout (connection->io_path_cond,
1090  connection->io_path_mutex,
1091  timeout_milliseconds))
1092  {
1093  /* We timed out before anyone signaled. */
1094  /* (writing the loop to handle the !timedout case by
1095  * waiting longer if needed is a pain since dbus
1096  * wraps pthread_cond_timedwait to take a relative
1097  * time instead of absolute, something kind of stupid
1098  * on our part. for now it doesn't matter, we will just
1099  * end up back here eventually.)
1100  */
1101  }
1102  }
1103  else
1104  {
1105  while (connection->io_path_acquired)
1106  {
1107  _dbus_verbose ("waiting for IO path to be acquirable\n");
1108  _dbus_condvar_wait (connection->io_path_cond,
1109  connection->io_path_mutex);
1110  }
1111  }
1112  }
1113 
1114  if (!connection->io_path_acquired)
1115  {
1116  we_acquired = TRUE;
1117  connection->io_path_acquired = TRUE;
1118  }
1119 
1120  _dbus_verbose ("end connection->io_path_acquired = %d we_acquired = %d\n",
1121  connection->io_path_acquired, we_acquired);
1122 
1123  _dbus_verbose ("unlocking io_path_mutex\n");
1124  _dbus_cmutex_unlock (connection->io_path_mutex);
1125 
1126  CONNECTION_LOCK (connection);
1127 
1128  HAVE_LOCK_CHECK (connection);
1129 
1130  _dbus_connection_unref_unlocked (connection);
1131 
1132  return we_acquired;
1133 }
1134 
1142 static void
1143 _dbus_connection_release_io_path (DBusConnection *connection)
1144 {
1145  HAVE_LOCK_CHECK (connection);
1146 
1147  _dbus_verbose ("locking io_path_mutex\n");
1148  _dbus_cmutex_lock (connection->io_path_mutex);
1149 
1150  _dbus_assert (connection->io_path_acquired);
1151 
1152  _dbus_verbose ("start connection->io_path_acquired = %d\n",
1153  connection->io_path_acquired);
1154 
1155  connection->io_path_acquired = FALSE;
1156  _dbus_condvar_wake_one (connection->io_path_cond);
1157 
1158  _dbus_verbose ("unlocking io_path_mutex\n");
1159  _dbus_cmutex_unlock (connection->io_path_mutex);
1160 }
1161 
1197 void
1199  DBusPendingCall *pending,
1200  unsigned int flags,
1201  int timeout_milliseconds)
1202 {
1203  _dbus_verbose ("start\n");
1204 
1205  HAVE_LOCK_CHECK (connection);
1206 
1207  if (connection->n_outgoing == 0)
1208  flags &= ~DBUS_ITERATION_DO_WRITING;
1209 
1210  if (_dbus_connection_acquire_io_path (connection,
1211  (flags & DBUS_ITERATION_BLOCK) ? timeout_milliseconds : 0))
1212  {
1213  HAVE_LOCK_CHECK (connection);
1214 
1215  if ( (pending != NULL) && _dbus_pending_call_get_completed_unlocked(pending))
1216  {
1217  _dbus_verbose ("pending call completed while acquiring I/O path");
1218  }
1219  else if ( (pending != NULL) &&
1220  _dbus_connection_peek_for_reply_unlocked (connection,
1222  {
1223  _dbus_verbose ("pending call completed while acquiring I/O path (reply found in queue)");
1224  }
1225  else
1226  {
1228  flags, timeout_milliseconds);
1229  }
1230 
1231  _dbus_connection_release_io_path (connection);
1232  }
1233 
1234  HAVE_LOCK_CHECK (connection);
1235 
1236  _dbus_verbose ("end\n");
1237 }
1238 
1250 {
1251  DBusConnection *connection;
1252  DBusWatchList *watch_list;
1253  DBusTimeoutList *timeout_list;
1254  DBusHashTable *pending_replies;
1255  DBusList *disconnect_link;
1256  DBusMessage *disconnect_message;
1257  DBusCounter *outgoing_counter;
1258  DBusObjectTree *objects;
1259 
1260  watch_list = NULL;
1261  connection = NULL;
1262  pending_replies = NULL;
1263  timeout_list = NULL;
1264  disconnect_link = NULL;
1265  disconnect_message = NULL;
1266  outgoing_counter = NULL;
1267  objects = NULL;
1268 
1269  watch_list = _dbus_watch_list_new ();
1270  if (watch_list == NULL)
1271  goto error;
1272 
1273  timeout_list = _dbus_timeout_list_new ();
1274  if (timeout_list == NULL)
1275  goto error;
1276 
1277  pending_replies =
1279  NULL,
1280  (DBusFreeFunction)free_pending_call_on_hash_removal);
1281  if (pending_replies == NULL)
1282  goto error;
1283 
1284  connection = dbus_new0 (DBusConnection, 1);
1285  if (connection == NULL)
1286  goto error;
1287 
1288  _dbus_rmutex_new_at_location (&connection->mutex);
1289  if (connection->mutex == NULL)
1290  goto error;
1291 
1293  if (connection->io_path_mutex == NULL)
1294  goto error;
1295 
1297  if (connection->dispatch_mutex == NULL)
1298  goto error;
1299 
1301  if (connection->dispatch_cond == NULL)
1302  goto error;
1303 
1305  if (connection->io_path_cond == NULL)
1306  goto error;
1307 
1309  if (connection->slot_mutex == NULL)
1310  goto error;
1311 
1312  disconnect_message = dbus_message_new_signal (DBUS_PATH_LOCAL,
1314  "Disconnected");
1315 
1316  if (disconnect_message == NULL)
1317  goto error;
1318 
1319  disconnect_link = _dbus_list_alloc_link (disconnect_message);
1320  if (disconnect_link == NULL)
1321  goto error;
1322 
1323  outgoing_counter = _dbus_counter_new ();
1324  if (outgoing_counter == NULL)
1325  goto error;
1326 
1327  objects = _dbus_object_tree_new (connection);
1328  if (objects == NULL)
1329  goto error;
1330 
1331  if (_dbus_modify_sigpipe)
1333 
1334  /* initialized to 0: use atomic op to avoid mixing atomic and non-atomic */
1335  _dbus_atomic_inc (&connection->refcount);
1336  connection->transport = transport;
1337  connection->watches = watch_list;
1338  connection->timeouts = timeout_list;
1339  connection->pending_replies = pending_replies;
1340  connection->outgoing_counter = outgoing_counter;
1341  connection->filter_list = NULL;
1342  connection->last_dispatch_status = DBUS_DISPATCH_COMPLETE; /* so we're notified first time there's data */
1343  connection->objects = objects;
1344  connection->exit_on_disconnect = FALSE;
1345  connection->shareable = FALSE;
1346  connection->route_peer_messages = FALSE;
1347  connection->disconnected_message_arrived = FALSE;
1348  connection->disconnected_message_processed = FALSE;
1349 
1350 #if defined(DBUS_ENABLE_CHECKS) || defined(DBUS_ENABLE_ASSERT)
1351  connection->generation = _dbus_current_generation;
1352 #endif
1353 
1354  _dbus_data_slot_list_init (&connection->slot_list);
1355 
1356  connection->client_serial = 1;
1357 
1358  connection->disconnect_message_link = disconnect_link;
1359 
1360  CONNECTION_LOCK (connection);
1361 
1362  if (!_dbus_transport_set_connection (transport, connection))
1363  {
1364  CONNECTION_UNLOCK (connection);
1365 
1366  goto error;
1367  }
1368 
1369  _dbus_transport_ref (transport);
1370 
1371  CONNECTION_UNLOCK (connection);
1372 
1373  _dbus_connection_trace_ref (connection, 0, 1, "new_for_transport");
1374  return connection;
1375 
1376  error:
1377  if (disconnect_message != NULL)
1378  dbus_message_unref (disconnect_message);
1379 
1380  if (disconnect_link != NULL)
1381  _dbus_list_free_link (disconnect_link);
1382 
1383  if (connection != NULL)
1384  {
1387  _dbus_rmutex_free_at_location (&connection->mutex);
1391  dbus_free (connection);
1392  }
1393  if (pending_replies)
1394  _dbus_hash_table_unref (pending_replies);
1395 
1396  if (watch_list)
1397  _dbus_watch_list_free (watch_list);
1398 
1399  if (timeout_list)
1400  _dbus_timeout_list_free (timeout_list);
1401 
1402  if (outgoing_counter)
1403  _dbus_counter_unref (outgoing_counter);
1404 
1405  if (objects)
1406  _dbus_object_tree_unref (objects);
1407 
1408  return NULL;
1409 }
1410 
1420 {
1421  dbus_int32_t old_refcount;
1422 
1423  _dbus_assert (connection != NULL);
1424  _dbus_assert (connection->generation == _dbus_current_generation);
1425 
1426  HAVE_LOCK_CHECK (connection);
1427 
1428  old_refcount = _dbus_atomic_inc (&connection->refcount);
1429  _dbus_connection_trace_ref (connection, old_refcount, old_refcount + 1,
1430  "ref_unlocked");
1431 
1432  return connection;
1433 }
1434 
1441 void
1443 {
1444  dbus_int32_t old_refcount;
1445 
1446  HAVE_LOCK_CHECK (connection);
1447 
1448  _dbus_assert (connection != NULL);
1449 
1450  old_refcount = _dbus_atomic_dec (&connection->refcount);
1451 
1452  _dbus_connection_trace_ref (connection, old_refcount, old_refcount - 1,
1453  "unref_unlocked");
1454 
1455  if (old_refcount == 1)
1456  _dbus_connection_last_unref (connection);
1457 }
1458 
1459 static dbus_uint32_t
1460 _dbus_connection_get_next_client_serial (DBusConnection *connection)
1461 {
1462  dbus_uint32_t serial;
1463 
1464  serial = connection->client_serial++;
1465 
1466  if (connection->client_serial == 0)
1467  connection->client_serial = 1;
1468 
1469  return serial;
1470 }
1471 
1487  unsigned int condition,
1488  void *data)
1489 {
1490  DBusConnection *connection;
1491  dbus_bool_t retval;
1492  DBusDispatchStatus status;
1493 
1494  connection = data;
1495 
1496  _dbus_verbose ("start\n");
1497 
1498  CONNECTION_LOCK (connection);
1499 
1500  if (!_dbus_connection_acquire_io_path (connection, 1))
1501  {
1502  /* another thread is handling the message */
1503  CONNECTION_UNLOCK (connection);
1504  return TRUE;
1505  }
1506 
1507  HAVE_LOCK_CHECK (connection);
1508  retval = _dbus_transport_handle_watch (connection->transport,
1509  watch, condition);
1510 
1511  _dbus_connection_release_io_path (connection);
1512 
1513  HAVE_LOCK_CHECK (connection);
1514 
1515  _dbus_verbose ("middle\n");
1516 
1517  status = _dbus_connection_get_dispatch_status_unlocked (connection);
1518 
1519  /* this calls out to user code */
1520  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
1521 
1522  _dbus_verbose ("end\n");
1523 
1524  return retval;
1525 }
1526 
1527 /* Protected by _DBUS_LOCK (shared_connections) */
1528 static DBusHashTable *shared_connections = NULL;
1529 static DBusList *shared_connections_no_guid = NULL;
1530 
1531 static void
1532 close_connection_on_shutdown (DBusConnection *connection)
1533 {
1534  DBusMessage *message;
1535 
1536  dbus_connection_ref (connection);
1538 
1539  /* Churn through to the Disconnected message */
1540  while ((message = dbus_connection_pop_message (connection)))
1541  {
1542  dbus_message_unref (message);
1543  }
1544  dbus_connection_unref (connection);
1545 }
1546 
1547 static void
1548 shared_connections_shutdown (void *data)
1549 {
1550  int n_entries;
1551 
1552  if (!_DBUS_LOCK (shared_connections))
1553  {
1554  /* We'd have initialized locks before adding anything, so there
1555  * can't be anything there. */
1556  return;
1557  }
1558 
1559  /* This is a little bit unpleasant... better ideas? */
1560  while ((n_entries = _dbus_hash_table_get_n_entries (shared_connections)) > 0)
1561  {
1562  DBusConnection *connection;
1563  DBusHashIter iter;
1564 
1565  _dbus_hash_iter_init (shared_connections, &iter);
1566  _dbus_hash_iter_next (&iter);
1567 
1568  connection = _dbus_hash_iter_get_value (&iter);
1569 
1570  _DBUS_UNLOCK (shared_connections);
1571  close_connection_on_shutdown (connection);
1572  if (!_DBUS_LOCK (shared_connections))
1573  _dbus_assert_not_reached ("global locks were already initialized");
1574 
1575  /* The connection should now be dead and not in our hash ... */
1576  _dbus_assert (_dbus_hash_table_get_n_entries (shared_connections) < n_entries);
1577  }
1578 
1579  _dbus_assert (_dbus_hash_table_get_n_entries (shared_connections) == 0);
1580 
1581  _dbus_hash_table_unref (shared_connections);
1582  shared_connections = NULL;
1583 
1584  if (shared_connections_no_guid != NULL)
1585  {
1586  DBusConnection *connection;
1587  connection = _dbus_list_pop_first (&shared_connections_no_guid);
1588  while (connection != NULL)
1589  {
1590  _DBUS_UNLOCK (shared_connections);
1591  close_connection_on_shutdown (connection);
1592  if (!_DBUS_LOCK (shared_connections))
1593  _dbus_assert_not_reached ("global locks were already initialized");
1594  connection = _dbus_list_pop_first (&shared_connections_no_guid);
1595  }
1596  }
1597 
1598  shared_connections_no_guid = NULL;
1599 
1600  _DBUS_UNLOCK (shared_connections);
1601 }
1602 
1603 static dbus_bool_t
1604 connection_lookup_shared (DBusAddressEntry *entry,
1605  DBusConnection **result)
1606 {
1607  _dbus_verbose ("checking for existing connection\n");
1608 
1609  *result = NULL;
1610 
1611  if (!_DBUS_LOCK (shared_connections))
1612  {
1613  /* If it was shared, we'd have initialized global locks when we put
1614  * it in shared_connections. */
1615  return FALSE;
1616  }
1617 
1618  if (shared_connections == NULL)
1619  {
1620  _dbus_verbose ("creating shared_connections hash table\n");
1621 
1622  shared_connections = _dbus_hash_table_new (DBUS_HASH_STRING,
1623  dbus_free,
1624  NULL);
1625  if (shared_connections == NULL)
1626  {
1627  _DBUS_UNLOCK (shared_connections);
1628  return FALSE;
1629  }
1630 
1631  if (!_dbus_register_shutdown_func (shared_connections_shutdown, NULL))
1632  {
1633  _dbus_hash_table_unref (shared_connections);
1634  shared_connections = NULL;
1635  _DBUS_UNLOCK (shared_connections);
1636  return FALSE;
1637  }
1638 
1639  _dbus_verbose (" successfully created shared_connections\n");
1640 
1641  _DBUS_UNLOCK (shared_connections);
1642  return TRUE; /* no point looking up in the hash we just made */
1643  }
1644  else
1645  {
1646  const char *guid;
1647 
1648  guid = dbus_address_entry_get_value (entry, "guid");
1649 
1650  if (guid != NULL)
1651  {
1652  DBusConnection *connection;
1653 
1654  connection = _dbus_hash_table_lookup_string (shared_connections,
1655  guid);
1656 
1657  if (connection)
1658  {
1659  /* The DBusConnection can't be finalized without taking
1660  * the shared_connections lock to remove it from the
1661  * hash. So it's safe to ref the connection here.
1662  * However, it may be disconnected if the Disconnected
1663  * message hasn't been processed yet, in which case we
1664  * want to pretend it isn't in the hash and avoid
1665  * returning it.
1666  *
1667  * The idea is to avoid ever returning a disconnected connection
1668  * from dbus_connection_open(). We could just synchronously
1669  * drop our shared ref to the connection on connection disconnect,
1670  * and then assert here that the connection is connected, but
1671  * that causes reentrancy headaches.
1672  */
1673  CONNECTION_LOCK (connection);
1674  if (_dbus_connection_get_is_connected_unlocked (connection))
1675  {
1676  _dbus_connection_ref_unlocked (connection);
1677  *result = connection;
1678  _dbus_verbose ("looked up existing connection to server guid %s\n",
1679  guid);
1680  }
1681  else
1682  {
1683  _dbus_verbose ("looked up existing connection to server guid %s but it was disconnected so ignoring it\n",
1684  guid);
1685  }
1686  CONNECTION_UNLOCK (connection);
1687  }
1688  }
1689 
1690  _DBUS_UNLOCK (shared_connections);
1691  return TRUE;
1692  }
1693 }
1694 
1695 static dbus_bool_t
1696 connection_record_shared_unlocked (DBusConnection *connection,
1697  const char *guid)
1698 {
1699  char *guid_key;
1700  char *guid_in_connection;
1701 
1702  HAVE_LOCK_CHECK (connection);
1703  _dbus_assert (connection->server_guid == NULL);
1704  _dbus_assert (connection->shareable);
1705 
1706  /* get a hard ref on this connection, even if
1707  * we won't in fact store it in the hash, we still
1708  * need to hold a ref on it until it's disconnected.
1709  */
1710  _dbus_connection_ref_unlocked (connection);
1711 
1712  if (guid == NULL)
1713  {
1714  if (!_DBUS_LOCK (shared_connections))
1715  return FALSE;
1716 
1717  if (!_dbus_list_prepend (&shared_connections_no_guid, connection))
1718  {
1719  _DBUS_UNLOCK (shared_connections);
1720  return FALSE;
1721  }
1722 
1723  _DBUS_UNLOCK (shared_connections);
1724  return TRUE; /* don't store in the hash */
1725  }
1726 
1727  /* A separate copy of the key is required in the hash table, because
1728  * we don't have a lock on the connection when we are doing a hash
1729  * lookup.
1730  */
1731 
1732  guid_key = _dbus_strdup (guid);
1733  if (guid_key == NULL)
1734  return FALSE;
1735 
1736  guid_in_connection = _dbus_strdup (guid);
1737  if (guid_in_connection == NULL)
1738  {
1739  dbus_free (guid_key);
1740  return FALSE;
1741  }
1742 
1743  if (!_DBUS_LOCK (shared_connections))
1744  {
1745  dbus_free (guid_in_connection);
1746  dbus_free (guid_key);
1747  return FALSE;
1748  }
1749 
1750  _dbus_assert (shared_connections != NULL);
1751 
1752  if (!_dbus_hash_table_insert_string (shared_connections,
1753  guid_key, connection))
1754  {
1755  dbus_free (guid_key);
1756  dbus_free (guid_in_connection);
1757  _DBUS_UNLOCK (shared_connections);
1758  return FALSE;
1759  }
1760 
1761  connection->server_guid = guid_in_connection;
1762 
1763  _dbus_verbose ("stored connection to %s to be shared\n",
1764  connection->server_guid);
1765 
1766  _DBUS_UNLOCK (shared_connections);
1767 
1768  _dbus_assert (connection->server_guid != NULL);
1769 
1770  return TRUE;
1771 }
1772 
1773 static void
1774 connection_forget_shared_unlocked (DBusConnection *connection)
1775 {
1776  HAVE_LOCK_CHECK (connection);
1777 
1778  if (!connection->shareable)
1779  return;
1780 
1781  if (!_DBUS_LOCK (shared_connections))
1782  {
1783  /* If it was shared, we'd have initialized global locks when we put
1784  * it in the table; so it can't be there. */
1785  return;
1786  }
1787 
1788  if (connection->server_guid != NULL)
1789  {
1790  _dbus_verbose ("dropping connection to %s out of the shared table\n",
1791  connection->server_guid);
1792 
1793  if (!_dbus_hash_table_remove_string (shared_connections,
1794  connection->server_guid))
1795  _dbus_assert_not_reached ("connection was not in the shared table");
1796 
1797  dbus_free (connection->server_guid);
1798  connection->server_guid = NULL;
1799  }
1800  else
1801  {
1802  _dbus_list_remove (&shared_connections_no_guid, connection);
1803  }
1804 
1805  _DBUS_UNLOCK (shared_connections);
1806 
1807  /* remove our reference held on all shareable connections */
1808  _dbus_connection_unref_unlocked (connection);
1809 }
1810 
1811 static DBusConnection*
1812 connection_try_from_address_entry (DBusAddressEntry *entry,
1813  DBusError *error)
1814 {
1815  DBusTransport *transport;
1816  DBusConnection *connection;
1817 
1818  transport = _dbus_transport_open (entry, error);
1819 
1820  if (transport == NULL)
1821  {
1822  _DBUS_ASSERT_ERROR_IS_SET (error);
1823  return NULL;
1824  }
1825 
1826  connection = _dbus_connection_new_for_transport (transport);
1827 
1828  _dbus_transport_unref (transport);
1829 
1830  if (connection == NULL)
1831  {
1832  _DBUS_SET_OOM (error);
1833  return NULL;
1834  }
1835 
1836 #ifndef DBUS_DISABLE_CHECKS
1837  _dbus_assert (!connection->have_connection_lock);
1838 #endif
1839  return connection;
1840 }
1841 
1842 /*
1843  * If the shared parameter is true, then any existing connection will
1844  * be used (and if a new connection is created, it will be available
1845  * for use by others). If the shared parameter is false, a new
1846  * connection will always be created, and the new connection will
1847  * never be returned to other callers.
1848  *
1849  * @param address the address
1850  * @param shared whether the connection is shared or private
1851  * @param error error return
1852  * @returns the connection or #NULL on error
1853  */
1854 static DBusConnection*
1855 _dbus_connection_open_internal (const char *address,
1856  dbus_bool_t shared,
1857  DBusError *error)
1858 {
1859  DBusConnection *connection;
1860  DBusAddressEntry **entries;
1861  DBusError tmp_error = DBUS_ERROR_INIT;
1862  DBusError first_error = DBUS_ERROR_INIT;
1863  int len, i;
1864 
1865  _DBUS_ASSERT_ERROR_IS_CLEAR (error);
1866 
1867  _dbus_verbose ("opening %s connection to: %s\n",
1868  shared ? "shared" : "private", address);
1869 
1870  if (!dbus_parse_address (address, &entries, &len, error))
1871  return NULL;
1872 
1873  _DBUS_ASSERT_ERROR_IS_CLEAR (error);
1874 
1875  connection = NULL;
1876 
1877  for (i = 0; i < len; i++)
1878  {
1879  if (shared)
1880  {
1881  if (!connection_lookup_shared (entries[i], &connection))
1882  _DBUS_SET_OOM (&tmp_error);
1883  }
1884 
1885  if (connection == NULL)
1886  {
1887  connection = connection_try_from_address_entry (entries[i],
1888  &tmp_error);
1889 
1890  if (connection != NULL && shared)
1891  {
1892  const char *guid;
1893 
1894  connection->shareable = TRUE;
1895 
1896  /* guid may be NULL */
1897  guid = dbus_address_entry_get_value (entries[i], "guid");
1898 
1899  CONNECTION_LOCK (connection);
1900 
1901  if (!connection_record_shared_unlocked (connection, guid))
1902  {
1903  _DBUS_SET_OOM (&tmp_error);
1904  _dbus_connection_close_possibly_shared_and_unlock (connection);
1905  dbus_connection_unref (connection);
1906  connection = NULL;
1907  }
1908  else
1909  CONNECTION_UNLOCK (connection);
1910  }
1911  }
1912 
1913  if (connection)
1914  break;
1915 
1916  _DBUS_ASSERT_ERROR_IS_SET (&tmp_error);
1917 
1918  if (i == 0)
1919  dbus_move_error (&tmp_error, &first_error);
1920  else
1921  dbus_error_free (&tmp_error);
1922  }
1923 
1924  _DBUS_ASSERT_ERROR_IS_CLEAR (error);
1925  _DBUS_ASSERT_ERROR_IS_CLEAR (&tmp_error);
1926 
1927  if (connection == NULL)
1928  {
1929  _DBUS_ASSERT_ERROR_IS_SET (&first_error);
1930  dbus_move_error (&first_error, error);
1931  }
1932  else
1933  dbus_error_free (&first_error);
1934 
1935  dbus_address_entries_free (entries);
1936  return connection;
1937 }
1938 
1947 void
1949 {
1950  _dbus_assert (connection != NULL);
1951  _dbus_assert (connection->generation == _dbus_current_generation);
1952 
1953  CONNECTION_LOCK (connection);
1954  _dbus_connection_close_possibly_shared_and_unlock (connection);
1955 }
1956 
1957 static DBusPreallocatedSend*
1958 _dbus_connection_preallocate_send_unlocked (DBusConnection *connection)
1959 {
1960  DBusPreallocatedSend *preallocated;
1961 
1962  HAVE_LOCK_CHECK (connection);
1963 
1964  _dbus_assert (connection != NULL);
1965 
1966  preallocated = dbus_new (DBusPreallocatedSend, 1);
1967  if (preallocated == NULL)
1968  return NULL;
1969 
1970  preallocated->queue_link = _dbus_list_alloc_link (NULL);
1971  if (preallocated->queue_link == NULL)
1972  goto failed_0;
1973 
1974  preallocated->counter_link = _dbus_list_alloc_link (connection->outgoing_counter);
1975  if (preallocated->counter_link == NULL)
1976  goto failed_1;
1977 
1978  _dbus_counter_ref (preallocated->counter_link->data);
1979 
1980  preallocated->connection = connection;
1981 
1982  return preallocated;
1983 
1984  failed_1:
1985  _dbus_list_free_link (preallocated->queue_link);
1986  failed_0:
1987  dbus_free (preallocated);
1988 
1989  return NULL;
1990 }
1991 
1992 /* Called with lock held, does not update dispatch status */
1993 static void
1994 _dbus_connection_send_preallocated_unlocked_no_update (DBusConnection *connection,
1995  DBusPreallocatedSend *preallocated,
1996  DBusMessage *message,
1997  dbus_uint32_t *client_serial)
1998 {
1999  dbus_uint32_t serial;
2000 
2001  preallocated->queue_link->data = message;
2003  preallocated->queue_link);
2004 
2005  /* It's OK that we'll never call the notify function, because for the
2006  * outgoing limit, there isn't one */
2008  preallocated->counter_link);
2009 
2010  dbus_free (preallocated);
2011  preallocated = NULL;
2012 
2013  dbus_message_ref (message);
2014 
2015  connection->n_outgoing += 1;
2016 
2017  _dbus_verbose ("Message %p (%s %s %s %s '%s') for %s added to outgoing queue %p, %d pending to send\n",
2018  message,
2020  dbus_message_get_path (message) ?
2021  dbus_message_get_path (message) :
2022  "no path",
2023  dbus_message_get_interface (message) ?
2024  dbus_message_get_interface (message) :
2025  "no interface",
2026  dbus_message_get_member (message) ?
2027  dbus_message_get_member (message) :
2028  "no member",
2029  dbus_message_get_signature (message),
2030  dbus_message_get_destination (message) ?
2031  dbus_message_get_destination (message) :
2032  "null",
2033  connection,
2034  connection->n_outgoing);
2035 
2036  if (dbus_message_get_serial (message) == 0)
2037  {
2038  serial = _dbus_connection_get_next_client_serial (connection);
2039  dbus_message_set_serial (message, serial);
2040  if (client_serial)
2041  *client_serial = serial;
2042  }
2043  else
2044  {
2045  if (client_serial)
2046  *client_serial = dbus_message_get_serial (message);
2047  }
2048 
2049  _dbus_verbose ("Message %p serial is %u\n",
2050  message, dbus_message_get_serial (message));
2051 
2052  dbus_message_lock (message);
2053 
2054  /* Now we need to run an iteration to hopefully just write the messages
2055  * out immediately, and otherwise get them queued up
2056  */
2058  NULL,
2059  DBUS_ITERATION_DO_WRITING,
2060  -1);
2061 
2062  /* If stuff is still queued up, be sure we wake up the main loop */
2063  if (connection->n_outgoing > 0)
2064  _dbus_connection_wakeup_mainloop (connection);
2065 }
2066 
2067 static void
2068 _dbus_connection_send_preallocated_and_unlock (DBusConnection *connection,
2069  DBusPreallocatedSend *preallocated,
2070  DBusMessage *message,
2071  dbus_uint32_t *client_serial)
2072 {
2073  DBusDispatchStatus status;
2074 
2075  HAVE_LOCK_CHECK (connection);
2076 
2077  _dbus_connection_send_preallocated_unlocked_no_update (connection,
2078  preallocated,
2079  message, client_serial);
2080 
2081  _dbus_verbose ("middle\n");
2082  status = _dbus_connection_get_dispatch_status_unlocked (connection);
2083 
2084  /* this calls out to user code */
2085  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
2086 }
2087 
2099  DBusMessage *message,
2100  dbus_uint32_t *client_serial)
2101 {
2102  DBusPreallocatedSend *preallocated;
2103 
2104  _dbus_assert (connection != NULL);
2105  _dbus_assert (message != NULL);
2106 
2107  preallocated = _dbus_connection_preallocate_send_unlocked (connection);
2108  if (preallocated == NULL)
2109  {
2110  CONNECTION_UNLOCK (connection);
2111  return FALSE;
2112  }
2113 
2114  _dbus_connection_send_preallocated_and_unlock (connection,
2115  preallocated,
2116  message,
2117  client_serial);
2118  return TRUE;
2119 }
2120 
2145 void
2147 {
2148  dbus_int32_t refcount;
2149 
2150  CONNECTION_LOCK (connection);
2151 
2152  refcount = _dbus_atomic_get (&connection->refcount);
2153  /* The caller should have at least one ref */
2154  _dbus_assert (refcount >= 1);
2155 
2156  if (refcount == 1)
2157  _dbus_connection_close_possibly_shared_and_unlock (connection);
2158  else
2159  CONNECTION_UNLOCK (connection);
2160 }
2161 
2162 
2172 static void
2173 _dbus_memory_pause_based_on_timeout (int timeout_milliseconds)
2174 {
2175  if (timeout_milliseconds == -1)
2176  _dbus_sleep_milliseconds (1000);
2177  else if (timeout_milliseconds < 100)
2178  ; /* just busy loop */
2179  else if (timeout_milliseconds <= 1000)
2180  _dbus_sleep_milliseconds (timeout_milliseconds / 3);
2181  else
2182  _dbus_sleep_milliseconds (1000);
2183 }
2184 
2185 static DBusMessage *
2186 generate_local_error_message (dbus_uint32_t serial,
2187  const char *error_name,
2188  const char *error_msg)
2189 {
2190  DBusMessage *message;
2192  if (!message)
2193  goto out;
2194 
2195  if (!dbus_message_set_error_name (message, error_name))
2196  {
2197  dbus_message_unref (message);
2198  message = NULL;
2199  goto out;
2200  }
2201 
2202  dbus_message_set_no_reply (message, TRUE);
2203 
2204  if (!dbus_message_set_reply_serial (message,
2205  serial))
2206  {
2207  dbus_message_unref (message);
2208  message = NULL;
2209  goto out;
2210  }
2211 
2212  if (error_msg != NULL)
2213  {
2214  DBusMessageIter iter;
2215 
2216  dbus_message_iter_init_append (message, &iter);
2217  if (!dbus_message_iter_append_basic (&iter,
2219  &error_msg))
2220  {
2221  dbus_message_unref (message);
2222  message = NULL;
2223  goto out;
2224  }
2225  }
2226 
2227  out:
2228  return message;
2229 }
2230 
2231 /*
2232  * Peek the incoming queue to see if we got reply for a specific serial
2233  */
2234 static dbus_bool_t
2235 _dbus_connection_peek_for_reply_unlocked (DBusConnection *connection,
2236  dbus_uint32_t client_serial)
2237 {
2238  DBusList *link;
2239  HAVE_LOCK_CHECK (connection);
2240 
2241  link = _dbus_list_get_first_link (&connection->incoming_messages);
2242 
2243  while (link != NULL)
2244  {
2245  DBusMessage *reply = link->data;
2246 
2247  if (dbus_message_get_reply_serial (reply) == client_serial)
2248  {
2249  _dbus_verbose ("%s reply to %d found in queue\n", _DBUS_FUNCTION_NAME, client_serial);
2250  return TRUE;
2251  }
2252  link = _dbus_list_get_next_link (&connection->incoming_messages, link);
2253  }
2254 
2255  return FALSE;
2256 }
2257 
2258 /* This is slightly strange since we can pop a message here without
2259  * the dispatch lock.
2260  */
2261 static DBusMessage*
2262 check_for_reply_unlocked (DBusConnection *connection,
2263  dbus_uint32_t client_serial)
2264 {
2265  DBusList *link;
2266 
2267  HAVE_LOCK_CHECK (connection);
2268 
2269  link = _dbus_list_get_first_link (&connection->incoming_messages);
2270 
2271  while (link != NULL)
2272  {
2273  DBusMessage *reply = link->data;
2274 
2275  if (dbus_message_get_reply_serial (reply) == client_serial)
2276  {
2277  _dbus_list_remove_link (&connection->incoming_messages, link);
2278  connection->n_incoming -= 1;
2279  return reply;
2280  }
2281  link = _dbus_list_get_next_link (&connection->incoming_messages, link);
2282  }
2283 
2284  return NULL;
2285 }
2286 
2287 static void
2288 connection_timeout_and_complete_all_pending_calls_unlocked (DBusConnection *connection)
2289 {
2290  /* We can't iterate over the hash in the normal way since we'll be
2291  * dropping the lock for each item. So we restart the
2292  * iter each time as we drain the hash table.
2293  */
2294 
2295  while (_dbus_hash_table_get_n_entries (connection->pending_replies) > 0)
2296  {
2297  DBusPendingCall *pending;
2298  DBusHashIter iter;
2299 
2300  _dbus_hash_iter_init (connection->pending_replies, &iter);
2301  _dbus_hash_iter_next (&iter);
2302 
2303  pending = _dbus_hash_iter_get_value (&iter);
2305 
2307  connection);
2308 
2314 
2316  CONNECTION_LOCK (connection);
2317  }
2318  HAVE_LOCK_CHECK (connection);
2319 }
2320 
2321 static void
2322 complete_pending_call_and_unlock (DBusConnection *connection,
2323  DBusPendingCall *pending,
2324  DBusMessage *message)
2325 {
2326  _dbus_pending_call_set_reply_unlocked (pending, message);
2327  _dbus_pending_call_ref_unlocked (pending); /* in case there's no app with a ref held */
2328  _dbus_connection_detach_pending_call_and_unlock (connection, pending);
2329 
2330  /* Must be called unlocked since it invokes app callback */
2331  _dbus_pending_call_complete (pending);
2332  dbus_pending_call_unref (pending);
2333 }
2334 
2335 static dbus_bool_t
2336 check_for_reply_and_update_dispatch_unlocked (DBusConnection *connection,
2337  DBusPendingCall *pending)
2338 {
2339  DBusMessage *reply;
2340  DBusDispatchStatus status;
2341 
2342  reply = check_for_reply_unlocked (connection,
2344  if (reply != NULL)
2345  {
2346  _dbus_verbose ("checked for reply\n");
2347 
2348  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): got reply\n");
2349 
2350  complete_pending_call_and_unlock (connection, pending, reply);
2351  dbus_message_unref (reply);
2352 
2353  CONNECTION_LOCK (connection);
2354  status = _dbus_connection_get_dispatch_status_unlocked (connection);
2355  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
2356  dbus_pending_call_unref (pending);
2357 
2358  return TRUE;
2359  }
2360 
2361  return FALSE;
2362 }
2363 
2378 void
2380 {
2381  long start_tv_sec, start_tv_usec;
2382  long tv_sec, tv_usec;
2383  DBusDispatchStatus status;
2384  DBusConnection *connection;
2385  dbus_uint32_t client_serial;
2386  DBusTimeout *timeout;
2387  int timeout_milliseconds, elapsed_milliseconds;
2388 
2389  _dbus_assert (pending != NULL);
2390 
2391  if (dbus_pending_call_get_completed (pending))
2392  return;
2393 
2394  dbus_pending_call_ref (pending); /* necessary because the call could be canceled */
2395 
2396  connection = _dbus_pending_call_get_connection_and_lock (pending);
2397 
2398  /* Flush message queue - note, can affect dispatch status */
2399  _dbus_connection_flush_unlocked (connection);
2400 
2401  client_serial = _dbus_pending_call_get_reply_serial_unlocked (pending);
2402 
2403  /* note that timeout_milliseconds is limited to a smallish value
2404  * in _dbus_pending_call_new() so overflows aren't possible
2405  * below
2406  */
2407  timeout = _dbus_pending_call_get_timeout_unlocked (pending);
2408  _dbus_get_monotonic_time (&start_tv_sec, &start_tv_usec);
2409  if (timeout)
2410  {
2411  timeout_milliseconds = dbus_timeout_get_interval (timeout);
2412 
2413  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): will block %d milliseconds for reply serial %u from %ld sec %ld usec\n",
2414  timeout_milliseconds,
2415  client_serial,
2416  start_tv_sec, start_tv_usec);
2417  }
2418  else
2419  {
2420  timeout_milliseconds = -1;
2421 
2422  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): will block for reply serial %u\n", client_serial);
2423  }
2424 
2425  /* check to see if we already got the data off the socket */
2426  /* from another blocked pending call */
2427  if (check_for_reply_and_update_dispatch_unlocked (connection, pending))
2428  return;
2429 
2430  /* Now we wait... */
2431  /* always block at least once as we know we don't have the reply yet */
2433  pending,
2434  DBUS_ITERATION_DO_READING |
2435  DBUS_ITERATION_BLOCK,
2436  timeout_milliseconds);
2437 
2438  recheck_status:
2439 
2440  _dbus_verbose ("top of recheck\n");
2441 
2442  HAVE_LOCK_CHECK (connection);
2443 
2444  /* queue messages and get status */
2445 
2446  status = _dbus_connection_get_dispatch_status_unlocked (connection);
2447 
2448  /* the get_completed() is in case a dispatch() while we were blocking
2449  * got the reply instead of us.
2450  */
2452  {
2453  _dbus_verbose ("Pending call completed by dispatch\n");
2454  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
2455  dbus_pending_call_unref (pending);
2456  return;
2457  }
2458 
2459  if (status == DBUS_DISPATCH_DATA_REMAINS)
2460  {
2461  if (check_for_reply_and_update_dispatch_unlocked (connection, pending))
2462  return;
2463  }
2464 
2465  _dbus_get_monotonic_time (&tv_sec, &tv_usec);
2466  elapsed_milliseconds = (tv_sec - start_tv_sec) * 1000 +
2467  (tv_usec - start_tv_usec) / 1000;
2468 
2469  if (!_dbus_connection_get_is_connected_unlocked (connection))
2470  {
2471  DBusMessage *error_msg;
2472 
2473  error_msg = generate_local_error_message (client_serial,
2475  "Connection was disconnected before a reply was received");
2476 
2477  /* on OOM error_msg is set to NULL */
2478  complete_pending_call_and_unlock (connection, pending, error_msg);
2479  dbus_pending_call_unref (pending);
2480  return;
2481  }
2482  else if (connection->disconnect_message_link == NULL)
2483  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): disconnected\n");
2484  else if (timeout == NULL)
2485  {
2486  if (status == DBUS_DISPATCH_NEED_MEMORY)
2487  {
2488  /* Try sleeping a bit, as we aren't sure we need to block for reading,
2489  * we may already have a reply in the buffer and just can't process
2490  * it.
2491  */
2492  _dbus_verbose ("dbus_connection_send_with_reply_and_block() waiting for more memory\n");
2493 
2494  _dbus_memory_pause_based_on_timeout (timeout_milliseconds - elapsed_milliseconds);
2495  }
2496  else
2497  {
2498  /* block again, we don't have the reply buffered yet. */
2500  pending,
2501  DBUS_ITERATION_DO_READING |
2502  DBUS_ITERATION_BLOCK,
2503  timeout_milliseconds - elapsed_milliseconds);
2504  }
2505 
2506  goto recheck_status;
2507  }
2508  else if (tv_sec < start_tv_sec)
2509  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): clock set backward\n");
2510  else if (elapsed_milliseconds < timeout_milliseconds)
2511  {
2512  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): %d milliseconds remain\n", timeout_milliseconds - elapsed_milliseconds);
2513 
2514  if (status == DBUS_DISPATCH_NEED_MEMORY)
2515  {
2516  /* Try sleeping a bit, as we aren't sure we need to block for reading,
2517  * we may already have a reply in the buffer and just can't process
2518  * it.
2519  */
2520  _dbus_verbose ("dbus_connection_send_with_reply_and_block() waiting for more memory\n");
2521 
2522  _dbus_memory_pause_based_on_timeout (timeout_milliseconds - elapsed_milliseconds);
2523  }
2524  else
2525  {
2526  /* block again, we don't have the reply buffered yet. */
2528  NULL,
2529  DBUS_ITERATION_DO_READING |
2530  DBUS_ITERATION_BLOCK,
2531  timeout_milliseconds - elapsed_milliseconds);
2532  }
2533 
2534  goto recheck_status;
2535  }
2536 
2537  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): Waited %d milliseconds and got no reply\n",
2538  elapsed_milliseconds);
2539 
2541 
2542  /* unlock and call user code */
2543  complete_pending_call_and_unlock (connection, pending, NULL);
2544 
2545  /* update user code on dispatch status */
2546  CONNECTION_LOCK (connection);
2547  status = _dbus_connection_get_dispatch_status_unlocked (connection);
2548  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
2549  dbus_pending_call_unref (pending);
2550 }
2551 
2557 int
2559 {
2560  return _dbus_transport_get_pending_fds_count (connection->transport);
2561 }
2562 
2570 void
2572  DBusPendingFdsChangeFunction callback,
2573  void *data)
2574 {
2576  callback, data);
2577 }
2578 
2616 dbus_connection_open (const char *address,
2617  DBusError *error)
2618 {
2619  DBusConnection *connection;
2620 
2621  _dbus_return_val_if_fail (address != NULL, NULL);
2622  _dbus_return_val_if_error_is_set (error, NULL);
2623 
2624  connection = _dbus_connection_open_internal (address,
2625  TRUE,
2626  error);
2627 
2628  return connection;
2629 }
2630 
2659 dbus_connection_open_private (const char *address,
2660  DBusError *error)
2661 {
2662  DBusConnection *connection;
2663 
2664  _dbus_return_val_if_fail (address != NULL, NULL);
2665  _dbus_return_val_if_error_is_set (error, NULL);
2666 
2667  connection = _dbus_connection_open_internal (address,
2668  FALSE,
2669  error);
2670 
2671  return connection;
2672 }
2673 
2682 {
2683  dbus_int32_t old_refcount;
2684 
2685  _dbus_return_val_if_fail (connection != NULL, NULL);
2686  _dbus_return_val_if_fail (connection->generation == _dbus_current_generation, NULL);
2687  old_refcount = _dbus_atomic_inc (&connection->refcount);
2688  _dbus_connection_trace_ref (connection, old_refcount, old_refcount + 1,
2689  "ref");
2690 
2691  return connection;
2692 }
2693 
2694 static void
2695 free_outgoing_message (void *element,
2696  void *data)
2697 {
2698  DBusMessage *message = element;
2699  DBusConnection *connection = data;
2700 
2701  _dbus_message_remove_counter (message, connection->outgoing_counter);
2702  dbus_message_unref (message);
2703 }
2704 
2705 /* This is run without the mutex held, but after the last reference
2706  * to the connection has been dropped we should have no thread-related
2707  * problems
2708  */
2709 static void
2710 _dbus_connection_last_unref (DBusConnection *connection)
2711 {
2712  DBusList *link;
2713 
2714  _dbus_verbose ("Finalizing connection %p\n", connection);
2715 
2716  _dbus_assert (_dbus_atomic_get (&connection->refcount) == 0);
2717 
2718  /* You have to disconnect the connection before unref:ing it. Otherwise
2719  * you won't get the disconnected message.
2720  */
2722  _dbus_assert (connection->server_guid == NULL);
2723 
2724  /* ---- We're going to call various application callbacks here, hope it doesn't break anything... */
2726 
2731 
2732  _dbus_watch_list_free (connection->watches);
2733  connection->watches = NULL;
2734 
2735  _dbus_timeout_list_free (connection->timeouts);
2736  connection->timeouts = NULL;
2737 
2738  _dbus_data_slot_list_free (&connection->slot_list);
2739 
2740  link = _dbus_list_get_first_link (&connection->filter_list);
2741  while (link != NULL)
2742  {
2743  DBusMessageFilter *filter = link->data;
2744  DBusList *next = _dbus_list_get_next_link (&connection->filter_list, link);
2745 
2746  filter->function = NULL;
2747  _dbus_message_filter_unref (filter); /* calls app callback */
2748  link->data = NULL;
2749 
2750  link = next;
2751  }
2752  _dbus_list_clear (&connection->filter_list);
2753 
2754  /* ---- Done with stuff that invokes application callbacks */
2755 
2756  _dbus_object_tree_unref (connection->objects);
2757 
2759  connection->pending_replies = NULL;
2760 
2761  _dbus_list_foreach (&connection->outgoing_messages,
2762  free_outgoing_message,
2763  connection);
2764  _dbus_list_clear (&connection->outgoing_messages);
2765 
2766  _dbus_list_foreach (&connection->incoming_messages,
2768  NULL);
2769  _dbus_list_clear (&connection->incoming_messages);
2770 
2771  _dbus_counter_unref (connection->outgoing_counter);
2772 
2773  _dbus_transport_unref (connection->transport);
2774 
2775  if (connection->disconnect_message_link)
2776  {
2777  DBusMessage *message = connection->disconnect_message_link->data;
2778  dbus_message_unref (message);
2780  }
2781 
2784 
2787 
2789 
2790  _dbus_rmutex_free_at_location (&connection->mutex);
2791 
2792  dbus_free (connection);
2793 }
2794 
2814 void
2816 {
2817  dbus_int32_t old_refcount;
2818 
2819  _dbus_return_if_fail (connection != NULL);
2820  _dbus_return_if_fail (connection->generation == _dbus_current_generation);
2821 
2822  old_refcount = _dbus_atomic_dec (&connection->refcount);
2823 
2824  _dbus_connection_trace_ref (connection, old_refcount, old_refcount - 1,
2825  "unref");
2826 
2827  if (old_refcount == 1)
2828  {
2829 #ifndef DBUS_DISABLE_CHECKS
2830  if (_dbus_transport_get_is_connected (connection->transport))
2831  {
2832  _dbus_warn_check_failed ("The last reference on a connection was dropped without closing the connection. This is a bug in an application. See dbus_connection_unref() documentation for details.\n%s",
2833  connection->shareable ?
2834  "Most likely, the application called unref() too many times and removed a reference belonging to libdbus, since this is a shared connection." :
2835  "Most likely, the application was supposed to call dbus_connection_close(), since this is a private connection.");
2836  return;
2837  }
2838 #endif
2839  _dbus_connection_last_unref (connection);
2840  }
2841 }
2842 
2843 /*
2844  * Note that the transport can disconnect itself (other end drops us)
2845  * and in that case this function never runs. So this function must
2846  * not do anything more than disconnect the transport and update the
2847  * dispatch status.
2848  *
2849  * If the transport self-disconnects, then we assume someone will
2850  * dispatch the connection to cause the dispatch status update.
2851  */
2852 static void
2853 _dbus_connection_close_possibly_shared_and_unlock (DBusConnection *connection)
2854 {
2855  DBusDispatchStatus status;
2856 
2857  HAVE_LOCK_CHECK (connection);
2858 
2859  _dbus_verbose ("Disconnecting %p\n", connection);
2860 
2861  /* We need to ref because update_dispatch_status_and_unlock will unref
2862  * the connection if it was shared and libdbus was the only remaining
2863  * refcount holder.
2864  */
2865  _dbus_connection_ref_unlocked (connection);
2866 
2867  _dbus_transport_disconnect (connection->transport);
2868 
2869  /* This has the side effect of queuing the disconnect message link
2870  * (unless we don't have enough memory, possibly, so don't assert it).
2871  * After the disconnect message link is queued, dbus_bus_get/dbus_connection_open
2872  * should never again return the newly-disconnected connection.
2873  *
2874  * However, we only unref the shared connection and exit_on_disconnect when
2875  * the disconnect message reaches the head of the message queue,
2876  * NOT when it's first queued.
2877  */
2878  status = _dbus_connection_get_dispatch_status_unlocked (connection);
2879 
2880  /* This calls out to user code */
2881  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
2882 
2883  /* Could also call out to user code */
2884  dbus_connection_unref (connection);
2885 }
2886 
2929 void
2931 {
2932  _dbus_return_if_fail (connection != NULL);
2933  _dbus_return_if_fail (connection->generation == _dbus_current_generation);
2934 
2935  CONNECTION_LOCK (connection);
2936 
2937 #ifndef DBUS_DISABLE_CHECKS
2938  if (connection->shareable)
2939  {
2940  CONNECTION_UNLOCK (connection);
2941 
2942  _dbus_warn_check_failed ("Applications must not close shared connections - see dbus_connection_close() docs. This is a bug in the application.");
2943  return;
2944  }
2945 #endif
2946 
2947  _dbus_connection_close_possibly_shared_and_unlock (connection);
2948 }
2949 
2950 static dbus_bool_t
2951 _dbus_connection_get_is_connected_unlocked (DBusConnection *connection)
2952 {
2953  HAVE_LOCK_CHECK (connection);
2954  return _dbus_transport_get_is_connected (connection->transport);
2955 }
2956 
2972 {
2973  dbus_bool_t res;
2974 
2975  _dbus_return_val_if_fail (connection != NULL, FALSE);
2976 
2977  CONNECTION_LOCK (connection);
2978  res = _dbus_connection_get_is_connected_unlocked (connection);
2979  CONNECTION_UNLOCK (connection);
2980 
2981  return res;
2982 }
2983 
2994 {
2995  dbus_bool_t res;
2996 
2997  _dbus_return_val_if_fail (connection != NULL, FALSE);
2998 
2999  CONNECTION_LOCK (connection);
3000  res = _dbus_transport_try_to_authenticate (connection->transport);
3001  CONNECTION_UNLOCK (connection);
3002 
3003  return res;
3004 }
3005 
3028 {
3029  dbus_bool_t res;
3030 
3031  _dbus_return_val_if_fail (connection != NULL, FALSE);
3032 
3033  CONNECTION_LOCK (connection);
3034  res = _dbus_transport_get_is_anonymous (connection->transport);
3035  CONNECTION_UNLOCK (connection);
3036 
3037  return res;
3038 }
3039 
3071 char*
3073 {
3074  char *id;
3075 
3076  _dbus_return_val_if_fail (connection != NULL, NULL);
3077 
3078  CONNECTION_LOCK (connection);
3080  CONNECTION_UNLOCK (connection);
3081 
3082  return id;
3083 }
3084 
3104  int type)
3105 {
3106  _dbus_return_val_if_fail (connection != NULL, FALSE);
3107 
3108  if (!dbus_type_is_valid (type))
3109  return FALSE;
3110 
3111  if (type != DBUS_TYPE_UNIX_FD)
3112  return TRUE;
3113 
3114 #ifdef HAVE_UNIX_FD_PASSING
3115  {
3116  dbus_bool_t b;
3117 
3118  CONNECTION_LOCK(connection);
3120  CONNECTION_UNLOCK(connection);
3121 
3122  return b;
3123  }
3124 #endif
3125 
3126  return FALSE;
3127 }
3128 
3142 void
3144  dbus_bool_t exit_on_disconnect)
3145 {
3146  _dbus_return_if_fail (connection != NULL);
3147 
3148  CONNECTION_LOCK (connection);
3149  connection->exit_on_disconnect = exit_on_disconnect != FALSE;
3150  CONNECTION_UNLOCK (connection);
3151 }
3152 
3164 {
3165  DBusPreallocatedSend *preallocated;
3166 
3167  _dbus_return_val_if_fail (connection != NULL, NULL);
3168 
3169  CONNECTION_LOCK (connection);
3170 
3171  preallocated =
3172  _dbus_connection_preallocate_send_unlocked (connection);
3173 
3174  CONNECTION_UNLOCK (connection);
3175 
3176  return preallocated;
3177 }
3178 
3188 void
3190  DBusPreallocatedSend *preallocated)
3191 {
3192  _dbus_return_if_fail (connection != NULL);
3193  _dbus_return_if_fail (preallocated != NULL);
3194  _dbus_return_if_fail (connection == preallocated->connection);
3195 
3196  _dbus_list_free_link (preallocated->queue_link);
3197  _dbus_counter_unref (preallocated->counter_link->data);
3198  _dbus_list_free_link (preallocated->counter_link);
3199  dbus_free (preallocated);
3200 }
3201 
3214 void
3216  DBusPreallocatedSend *preallocated,
3217  DBusMessage *message,
3218  dbus_uint32_t *client_serial)
3219 {
3220  _dbus_return_if_fail (connection != NULL);
3221  _dbus_return_if_fail (preallocated != NULL);
3222  _dbus_return_if_fail (message != NULL);
3223  _dbus_return_if_fail (preallocated->connection == connection);
3224  _dbus_return_if_fail (dbus_message_get_type (message) != DBUS_MESSAGE_TYPE_METHOD_CALL ||
3225  dbus_message_get_member (message) != NULL);
3226  _dbus_return_if_fail (dbus_message_get_type (message) != DBUS_MESSAGE_TYPE_SIGNAL ||
3227  (dbus_message_get_interface (message) != NULL &&
3228  dbus_message_get_member (message) != NULL));
3229 
3230  CONNECTION_LOCK (connection);
3231 
3232 #ifdef HAVE_UNIX_FD_PASSING
3233 
3234  if (!_dbus_transport_can_pass_unix_fd(connection->transport) &&
3235  message->n_unix_fds > 0)
3236  {
3237  /* Refuse to send fds on a connection that cannot handle
3238  them. Unfortunately we cannot return a proper error here, so
3239  the best we can is just return. */
3240  CONNECTION_UNLOCK (connection);
3241  return;
3242  }
3243 
3244 #endif
3245 
3246  _dbus_connection_send_preallocated_and_unlock (connection,
3247  preallocated,
3248  message, client_serial);
3249 }
3250 
3251 static dbus_bool_t
3252 _dbus_connection_send_unlocked_no_update (DBusConnection *connection,
3253  DBusMessage *message,
3254  dbus_uint32_t *client_serial)
3255 {
3256  DBusPreallocatedSend *preallocated;
3257 
3258  _dbus_assert (connection != NULL);
3259  _dbus_assert (message != NULL);
3260 
3261  preallocated = _dbus_connection_preallocate_send_unlocked (connection);
3262  if (preallocated == NULL)
3263  return FALSE;
3264 
3265  _dbus_connection_send_preallocated_unlocked_no_update (connection,
3266  preallocated,
3267  message,
3268  client_serial);
3269  return TRUE;
3270 }
3271 
3301  DBusMessage *message,
3302  dbus_uint32_t *serial)
3303 {
3304  _dbus_return_val_if_fail (connection != NULL, FALSE);
3305  _dbus_return_val_if_fail (message != NULL, FALSE);
3306 
3307  CONNECTION_LOCK (connection);
3308 
3309 #ifdef HAVE_UNIX_FD_PASSING
3310 
3311  if (!_dbus_transport_can_pass_unix_fd(connection->transport) &&
3312  message->n_unix_fds > 0)
3313  {
3314  /* Refuse to send fds on a connection that cannot handle
3315  them. Unfortunately we cannot return a proper error here, so
3316  the best we can is just return. */
3317  CONNECTION_UNLOCK (connection);
3318  return FALSE;
3319  }
3320 
3321 #endif
3322 
3323  return _dbus_connection_send_and_unlock (connection,
3324  message,
3325  serial);
3326 }
3327 
3328 static dbus_bool_t
3329 reply_handler_timeout (void *data)
3330 {
3331  DBusConnection *connection;
3332  DBusDispatchStatus status;
3333  DBusPendingCall *pending = data;
3334 
3335  connection = _dbus_pending_call_get_connection_and_lock (pending);
3336  _dbus_connection_ref_unlocked (connection);
3337 
3339  connection);
3343 
3344  _dbus_verbose ("middle\n");
3345  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3346 
3347  /* Unlocks, and calls out to user code */
3348  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3349  dbus_connection_unref (connection);
3350 
3351  return TRUE;
3352 }
3353 
3398  DBusMessage *message,
3399  DBusPendingCall **pending_return,
3400  int timeout_milliseconds)
3401 {
3402  DBusPendingCall *pending;
3403  dbus_int32_t serial = -1;
3404  DBusDispatchStatus status;
3405 
3406  _dbus_return_val_if_fail (connection != NULL, FALSE);
3407  _dbus_return_val_if_fail (message != NULL, FALSE);
3408  _dbus_return_val_if_fail (timeout_milliseconds >= 0 || timeout_milliseconds == -1, FALSE);
3409 
3410  if (pending_return)
3411  *pending_return = NULL;
3412 
3413  CONNECTION_LOCK (connection);
3414 
3415 #ifdef HAVE_UNIX_FD_PASSING
3416 
3417  if (!_dbus_transport_can_pass_unix_fd(connection->transport) &&
3418  message->n_unix_fds > 0)
3419  {
3420  /* Refuse to send fds on a connection that cannot handle
3421  them. Unfortunately we cannot return a proper error here, so
3422  the best we can do is return TRUE but leave *pending_return
3423  as NULL. */
3424  CONNECTION_UNLOCK (connection);
3425  return TRUE;
3426  }
3427 
3428 #endif
3429 
3430  if (!_dbus_connection_get_is_connected_unlocked (connection))
3431  {
3432  CONNECTION_UNLOCK (connection);
3433 
3434  return TRUE;
3435  }
3436 
3437  pending = _dbus_pending_call_new_unlocked (connection,
3438  timeout_milliseconds,
3439  reply_handler_timeout);
3440 
3441  if (pending == NULL)
3442  {
3443  CONNECTION_UNLOCK (connection);
3444  return FALSE;
3445  }
3446 
3447  /* Assign a serial to the message */
3448  serial = dbus_message_get_serial (message);
3449  if (serial == 0)
3450  {
3451  serial = _dbus_connection_get_next_client_serial (connection);
3452  dbus_message_set_serial (message, serial);
3453  }
3454 
3455  if (!_dbus_pending_call_set_timeout_error_unlocked (pending, message, serial))
3456  goto error;
3457 
3458  /* Insert the serial in the pending replies hash;
3459  * hash takes a refcount on DBusPendingCall.
3460  * Also, add the timeout.
3461  */
3462  if (!_dbus_connection_attach_pending_call_unlocked (connection,
3463  pending))
3464  goto error;
3465 
3466  if (!_dbus_connection_send_unlocked_no_update (connection, message, NULL))
3467  {
3468  _dbus_connection_detach_pending_call_and_unlock (connection,
3469  pending);
3470  goto error_unlocked;
3471  }
3472 
3473  if (pending_return)
3474  *pending_return = pending; /* hand off refcount */
3475  else
3476  {
3477  _dbus_connection_detach_pending_call_unlocked (connection, pending);
3478  /* we still have a ref to the pending call in this case, we unref
3479  * after unlocking, below
3480  */
3481  }
3482 
3483  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3484 
3485  /* this calls out to user code */
3486  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3487 
3488  if (pending_return == NULL)
3489  dbus_pending_call_unref (pending);
3490 
3491  return TRUE;
3492 
3493  error:
3494  CONNECTION_UNLOCK (connection);
3495  error_unlocked:
3496  dbus_pending_call_unref (pending);
3497  return FALSE;
3498 }
3499 
3532 DBusMessage*
3534  DBusMessage *message,
3535  int timeout_milliseconds,
3536  DBusError *error)
3537 {
3538  DBusMessage *reply;
3539  DBusPendingCall *pending;
3540 
3541  _dbus_return_val_if_fail (connection != NULL, NULL);
3542  _dbus_return_val_if_fail (message != NULL, NULL);
3543  _dbus_return_val_if_fail (timeout_milliseconds >= 0 || timeout_milliseconds == -1, NULL);
3544  _dbus_return_val_if_error_is_set (error, NULL);
3545 
3546 #ifdef HAVE_UNIX_FD_PASSING
3547 
3548  CONNECTION_LOCK (connection);
3549  if (!_dbus_transport_can_pass_unix_fd(connection->transport) &&
3550  message->n_unix_fds > 0)
3551  {
3552  CONNECTION_UNLOCK (connection);
3553  dbus_set_error(error, DBUS_ERROR_FAILED, "Cannot send file descriptors on this connection.");
3554  return NULL;
3555  }
3556  CONNECTION_UNLOCK (connection);
3557 
3558 #endif
3559 
3560  if (!dbus_connection_send_with_reply (connection, message,
3561  &pending, timeout_milliseconds))
3562  {
3563  _DBUS_SET_OOM (error);
3564  return NULL;
3565  }
3566 
3567  if (pending == NULL)
3568  {
3569  dbus_set_error (error, DBUS_ERROR_DISCONNECTED, "Connection is closed");
3570  return NULL;
3571  }
3572 
3573  dbus_pending_call_block (pending);
3574 
3575  reply = dbus_pending_call_steal_reply (pending);
3576  dbus_pending_call_unref (pending);
3577 
3578  /* call_complete_and_unlock() called from pending_call_block() should
3579  * always fill this in.
3580  */
3581  _dbus_assert (reply != NULL);
3582 
3583  if (dbus_set_error_from_message (error, reply))
3584  {
3585  dbus_message_unref (reply);
3586  return NULL;
3587  }
3588  else
3589  return reply;
3590 }
3591 
3600 static DBusDispatchStatus
3601 _dbus_connection_flush_unlocked (DBusConnection *connection)
3602 {
3603  /* We have to specify DBUS_ITERATION_DO_READING here because
3604  * otherwise we could have two apps deadlock if they are both doing
3605  * a flush(), and the kernel buffers fill up. This could change the
3606  * dispatch status.
3607  */
3608  DBusDispatchStatus status;
3609 
3610  HAVE_LOCK_CHECK (connection);
3611 
3612  while (connection->n_outgoing > 0 &&
3613  _dbus_connection_get_is_connected_unlocked (connection))
3614  {
3615  _dbus_verbose ("doing iteration in\n");
3616  HAVE_LOCK_CHECK (connection);
3618  NULL,
3619  DBUS_ITERATION_DO_READING |
3620  DBUS_ITERATION_DO_WRITING |
3621  DBUS_ITERATION_BLOCK,
3622  -1);
3623  }
3624 
3625  HAVE_LOCK_CHECK (connection);
3626  _dbus_verbose ("middle\n");
3627  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3628 
3629  HAVE_LOCK_CHECK (connection);
3630  return status;
3631 }
3632 
3638 void
3640 {
3641  /* We have to specify DBUS_ITERATION_DO_READING here because
3642  * otherwise we could have two apps deadlock if they are both doing
3643  * a flush(), and the kernel buffers fill up. This could change the
3644  * dispatch status.
3645  */
3646  DBusDispatchStatus status;
3647 
3648  _dbus_return_if_fail (connection != NULL);
3649 
3650  CONNECTION_LOCK (connection);
3651 
3652  status = _dbus_connection_flush_unlocked (connection);
3653 
3654  HAVE_LOCK_CHECK (connection);
3655  /* Unlocks and calls out to user code */
3656  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3657 
3658  _dbus_verbose ("end\n");
3659 }
3660 
3671 static dbus_bool_t
3672 _dbus_connection_read_write_dispatch (DBusConnection *connection,
3673  int timeout_milliseconds,
3674  dbus_bool_t dispatch)
3675 {
3676  DBusDispatchStatus dstatus;
3677  dbus_bool_t progress_possible;
3678 
3679  /* Need to grab a ref here in case we're a private connection and
3680  * the user drops the last ref in a handler we call; see bug
3681  * https://bugs.freedesktop.org/show_bug.cgi?id=15635
3682  */
3683  dbus_connection_ref (connection);
3684  dstatus = dbus_connection_get_dispatch_status (connection);
3685 
3686  if (dispatch && dstatus == DBUS_DISPATCH_DATA_REMAINS)
3687  {
3688  _dbus_verbose ("doing dispatch\n");
3689  dbus_connection_dispatch (connection);
3690  CONNECTION_LOCK (connection);
3691  }
3692  else if (dstatus == DBUS_DISPATCH_NEED_MEMORY)
3693  {
3694  _dbus_verbose ("pausing for memory\n");
3695  _dbus_memory_pause_based_on_timeout (timeout_milliseconds);
3696  CONNECTION_LOCK (connection);
3697  }
3698  else
3699  {
3700  CONNECTION_LOCK (connection);
3701  if (_dbus_connection_get_is_connected_unlocked (connection))
3702  {
3703  _dbus_verbose ("doing iteration\n");
3705  NULL,
3706  DBUS_ITERATION_DO_READING |
3707  DBUS_ITERATION_DO_WRITING |
3708  DBUS_ITERATION_BLOCK,
3709  timeout_milliseconds);
3710  }
3711  }
3712 
3713  HAVE_LOCK_CHECK (connection);
3714  /* If we can dispatch, we can make progress until the Disconnected message
3715  * has been processed; if we can only read/write, we can make progress
3716  * as long as the transport is open.
3717  */
3718  if (dispatch)
3719  progress_possible = connection->n_incoming != 0 ||
3720  connection->disconnect_message_link != NULL;
3721  else
3722  progress_possible = _dbus_connection_get_is_connected_unlocked (connection);
3723 
3724  CONNECTION_UNLOCK (connection);
3725 
3726  dbus_connection_unref (connection);
3727 
3728  return progress_possible; /* TRUE if we can make more progress */
3729 }
3730 
3731 
3768  int timeout_milliseconds)
3769 {
3770  _dbus_return_val_if_fail (connection != NULL, FALSE);
3771  _dbus_return_val_if_fail (timeout_milliseconds >= 0 || timeout_milliseconds == -1, FALSE);
3772  return _dbus_connection_read_write_dispatch(connection, timeout_milliseconds, TRUE);
3773 }
3774 
3798 dbus_bool_t
3800  int timeout_milliseconds)
3801 {
3802  _dbus_return_val_if_fail (connection != NULL, FALSE);
3803  _dbus_return_val_if_fail (timeout_milliseconds >= 0 || timeout_milliseconds == -1, FALSE);
3804  return _dbus_connection_read_write_dispatch(connection, timeout_milliseconds, FALSE);
3805 }
3806 
3807 /* We need to call this anytime we pop the head of the queue, and then
3808  * update_dispatch_status_and_unlock needs to be called afterward
3809  * which will "process" the disconnected message and set
3810  * disconnected_message_processed.
3811  */
3812 static void
3813 check_disconnected_message_arrived_unlocked (DBusConnection *connection,
3814  DBusMessage *head_of_queue)
3815 {
3816  HAVE_LOCK_CHECK (connection);
3817 
3818  /* checking that the link is NULL is an optimization to avoid the is_signal call */
3819  if (connection->disconnect_message_link == NULL &&
3820  dbus_message_is_signal (head_of_queue,
3822  "Disconnected"))
3823  {
3824  connection->disconnected_message_arrived = TRUE;
3825  }
3826 }
3827 
3847 DBusMessage*
3849 {
3850  DBusDispatchStatus status;
3851  DBusMessage *message;
3852 
3853  _dbus_return_val_if_fail (connection != NULL, NULL);
3854 
3855  _dbus_verbose ("start\n");
3856 
3857  /* this is called for the side effect that it queues
3858  * up any messages from the transport
3859  */
3860  status = dbus_connection_get_dispatch_status (connection);
3861  if (status != DBUS_DISPATCH_DATA_REMAINS)
3862  return NULL;
3863 
3864  CONNECTION_LOCK (connection);
3865 
3866  _dbus_connection_acquire_dispatch (connection);
3867 
3868  /* While a message is outstanding, the dispatch lock is held */
3869  _dbus_assert (connection->message_borrowed == NULL);
3870 
3871  connection->message_borrowed = _dbus_list_get_first (&connection->incoming_messages);
3872 
3873  message = connection->message_borrowed;
3874 
3875  check_disconnected_message_arrived_unlocked (connection, message);
3876 
3877  /* Note that we KEEP the dispatch lock until the message is returned */
3878  if (message == NULL)
3879  _dbus_connection_release_dispatch (connection);
3880 
3881  CONNECTION_UNLOCK (connection);
3882 
3883  _dbus_message_trace_ref (message, -1, -1, "dbus_connection_borrow_message");
3884 
3885  /* We don't update dispatch status until it's returned or stolen */
3886 
3887  return message;
3888 }
3889 
3898 void
3900  DBusMessage *message)
3901 {
3902  DBusDispatchStatus status;
3903 
3904  _dbus_return_if_fail (connection != NULL);
3905  _dbus_return_if_fail (message != NULL);
3906  _dbus_return_if_fail (message == connection->message_borrowed);
3907  _dbus_return_if_fail (connection->dispatch_acquired);
3908 
3909  CONNECTION_LOCK (connection);
3910 
3911  _dbus_assert (message == connection->message_borrowed);
3912 
3913  connection->message_borrowed = NULL;
3914 
3915  _dbus_connection_release_dispatch (connection);
3916 
3917  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3918  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3919 
3920  _dbus_message_trace_ref (message, -1, -1, "dbus_connection_return_message");
3921 }
3922 
3932 void
3934  DBusMessage *message)
3935 {
3936  DBusMessage *pop_message;
3937  DBusDispatchStatus status;
3938 
3939  _dbus_return_if_fail (connection != NULL);
3940  _dbus_return_if_fail (message != NULL);
3941  _dbus_return_if_fail (message == connection->message_borrowed);
3942  _dbus_return_if_fail (connection->dispatch_acquired);
3943 
3944  CONNECTION_LOCK (connection);
3945 
3946  _dbus_assert (message == connection->message_borrowed);
3947 
3948  pop_message = _dbus_list_pop_first (&connection->incoming_messages);
3949  _dbus_assert (message == pop_message);
3950  (void) pop_message; /* unused unless asserting */
3951 
3952  connection->n_incoming -= 1;
3953 
3954  _dbus_verbose ("Incoming message %p stolen from queue, %d incoming\n",
3955  message, connection->n_incoming);
3956 
3957  connection->message_borrowed = NULL;
3958 
3959  _dbus_connection_release_dispatch (connection);
3960 
3961  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3962  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3963  _dbus_message_trace_ref (message, -1, -1,
3964  "dbus_connection_steal_borrowed_message");
3965 }
3966 
3967 /* See dbus_connection_pop_message, but requires the caller to own
3968  * the lock before calling. May drop the lock while running.
3969  */
3970 static DBusList*
3971 _dbus_connection_pop_message_link_unlocked (DBusConnection *connection)
3972 {
3973  HAVE_LOCK_CHECK (connection);
3974 
3975  _dbus_assert (connection->message_borrowed == NULL);
3976 
3977  if (connection->n_incoming > 0)
3978  {
3979  DBusList *link;
3980 
3981  link = _dbus_list_pop_first_link (&connection->incoming_messages);
3982  connection->n_incoming -= 1;
3983 
3984  _dbus_verbose ("Message %p (%s %s %s %s sig:'%s' serial:%u) removed from incoming queue %p, %d incoming\n",
3985  link->data,
3987  dbus_message_get_path (link->data) ?
3988  dbus_message_get_path (link->data) :
3989  "no path",
3992  "no interface",
3993  dbus_message_get_member (link->data) ?
3994  dbus_message_get_member (link->data) :
3995  "no member",
3997  dbus_message_get_serial (link->data),
3998  connection, connection->n_incoming);
3999 
4000  _dbus_message_trace_ref (link->data, -1, -1,
4001  "_dbus_connection_pop_message_link_unlocked");
4002 
4003  check_disconnected_message_arrived_unlocked (connection, link->data);
4004 
4005  return link;
4006  }
4007  else
4008  return NULL;
4009 }
4010 
4011 /* See dbus_connection_pop_message, but requires the caller to own
4012  * the lock before calling. May drop the lock while running.
4013  */
4014 static DBusMessage*
4015 _dbus_connection_pop_message_unlocked (DBusConnection *connection)
4016 {
4017  DBusList *link;
4018 
4019  HAVE_LOCK_CHECK (connection);
4020 
4021  link = _dbus_connection_pop_message_link_unlocked (connection);
4022 
4023  if (link != NULL)
4024  {
4025  DBusMessage *message;
4026 
4027  message = link->data;
4028 
4029  _dbus_list_free_link (link);
4030 
4031  return message;
4032  }
4033  else
4034  return NULL;
4035 }
4036 
4037 static void
4038 _dbus_connection_putback_message_link_unlocked (DBusConnection *connection,
4039  DBusList *message_link)
4040 {
4041  HAVE_LOCK_CHECK (connection);
4042 
4043  _dbus_assert (message_link != NULL);
4044  /* You can't borrow a message while a link is outstanding */
4045  _dbus_assert (connection->message_borrowed == NULL);
4046  /* We had to have the dispatch lock across the pop/putback */
4047  _dbus_assert (connection->dispatch_acquired);
4048 
4050  message_link);
4051  connection->n_incoming += 1;
4052 
4053  _dbus_verbose ("Message %p (%s %s %s '%s') put back into queue %p, %d incoming\n",
4054  message_link->data,
4056  dbus_message_get_interface (message_link->data) ?
4057  dbus_message_get_interface (message_link->data) :
4058  "no interface",
4059  dbus_message_get_member (message_link->data) ?
4060  dbus_message_get_member (message_link->data) :
4061  "no member",
4062  dbus_message_get_signature (message_link->data),
4063  connection, connection->n_incoming);
4064 
4065  _dbus_message_trace_ref (message_link->data, -1, -1,
4066  "_dbus_connection_putback_message_link_unlocked");
4067 }
4068 
4088 DBusMessage*
4090 {
4091  DBusMessage *message;
4092  DBusDispatchStatus status;
4093 
4094  _dbus_verbose ("start\n");
4095 
4096  /* this is called for the side effect that it queues
4097  * up any messages from the transport
4098  */
4099  status = dbus_connection_get_dispatch_status (connection);
4100  if (status != DBUS_DISPATCH_DATA_REMAINS)
4101  return NULL;
4102 
4103  CONNECTION_LOCK (connection);
4104  _dbus_connection_acquire_dispatch (connection);
4105  HAVE_LOCK_CHECK (connection);
4106 
4107  message = _dbus_connection_pop_message_unlocked (connection);
4108 
4109  _dbus_verbose ("Returning popped message %p\n", message);
4110 
4111  _dbus_connection_release_dispatch (connection);
4112 
4113  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4114  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
4115 
4116  return message;
4117 }
4118 
4126 static void
4127 _dbus_connection_acquire_dispatch (DBusConnection *connection)
4128 {
4129  HAVE_LOCK_CHECK (connection);
4130 
4131  _dbus_connection_ref_unlocked (connection);
4132  CONNECTION_UNLOCK (connection);
4133 
4134  _dbus_verbose ("locking dispatch_mutex\n");
4135  _dbus_cmutex_lock (connection->dispatch_mutex);
4136 
4137  while (connection->dispatch_acquired)
4138  {
4139  _dbus_verbose ("waiting for dispatch to be acquirable\n");
4140  _dbus_condvar_wait (connection->dispatch_cond,
4141  connection->dispatch_mutex);
4142  }
4143 
4144  _dbus_assert (!connection->dispatch_acquired);
4145 
4146  connection->dispatch_acquired = TRUE;
4147 
4148  _dbus_verbose ("unlocking dispatch_mutex\n");
4149  _dbus_cmutex_unlock (connection->dispatch_mutex);
4150 
4151  CONNECTION_LOCK (connection);
4152  _dbus_connection_unref_unlocked (connection);
4153 }
4154 
4162 static void
4163 _dbus_connection_release_dispatch (DBusConnection *connection)
4164 {
4165  HAVE_LOCK_CHECK (connection);
4166 
4167  _dbus_verbose ("locking dispatch_mutex\n");
4168  _dbus_cmutex_lock (connection->dispatch_mutex);
4169 
4170  _dbus_assert (connection->dispatch_acquired);
4171 
4172  connection->dispatch_acquired = FALSE;
4173  _dbus_condvar_wake_one (connection->dispatch_cond);
4174 
4175  _dbus_verbose ("unlocking dispatch_mutex\n");
4176  _dbus_cmutex_unlock (connection->dispatch_mutex);
4177 }
4178 
4179 static void
4180 _dbus_connection_failed_pop (DBusConnection *connection,
4181  DBusList *message_link)
4182 {
4184  message_link);
4185  connection->n_incoming += 1;
4186 }
4187 
4188 /* Note this may be called multiple times since we don't track whether we already did it */
4189 static void
4190 notify_disconnected_unlocked (DBusConnection *connection)
4191 {
4192  HAVE_LOCK_CHECK (connection);
4193 
4194  /* Set the weakref in dbus-bus.c to NULL, so nobody will get a disconnected
4195  * connection from dbus_bus_get(). We make the same guarantee for
4196  * dbus_connection_open() but in a different way since we don't want to
4197  * unref right here; we instead check for connectedness before returning
4198  * the connection from the hash.
4199  */
4201 
4202  /* Dump the outgoing queue, we aren't going to be able to
4203  * send it now, and we'd like accessors like
4204  * dbus_connection_get_outgoing_size() to be accurate.
4205  */
4206  if (connection->n_outgoing > 0)
4207  {
4208  DBusList *link;
4209 
4210  _dbus_verbose ("Dropping %d outgoing messages since we're disconnected\n",
4211  connection->n_outgoing);
4212 
4213  while ((link = _dbus_list_get_last_link (&connection->outgoing_messages)))
4214  {
4215  _dbus_connection_message_sent_unlocked (connection, link->data);
4216  }
4217  }
4218 }
4219 
4220 /* Note this may be called multiple times since we don't track whether we already did it */
4221 static DBusDispatchStatus
4222 notify_disconnected_and_dispatch_complete_unlocked (DBusConnection *connection)
4223 {
4224  HAVE_LOCK_CHECK (connection);
4225 
4226  if (connection->disconnect_message_link != NULL)
4227  {
4228  _dbus_verbose ("Sending disconnect message\n");
4229 
4230  /* If we have pending calls, queue their timeouts - we want the Disconnected
4231  * to be the last message, after these timeouts.
4232  */
4233  connection_timeout_and_complete_all_pending_calls_unlocked (connection);
4234 
4235  /* We haven't sent the disconnect message already,
4236  * and all real messages have been queued up.
4237  */
4239  connection->disconnect_message_link);
4240  connection->disconnect_message_link = NULL;
4241 
4243  }
4244 
4245  return DBUS_DISPATCH_COMPLETE;
4246 }
4247 
4248 static DBusDispatchStatus
4249 _dbus_connection_get_dispatch_status_unlocked (DBusConnection *connection)
4250 {
4251  HAVE_LOCK_CHECK (connection);
4252 
4253  if (connection->n_incoming > 0)
4255  else if (!_dbus_transport_queue_messages (connection->transport))
4257  else
4258  {
4259  DBusDispatchStatus status;
4260  dbus_bool_t is_connected;
4261 
4262  status = _dbus_transport_get_dispatch_status (connection->transport);
4263  is_connected = _dbus_transport_get_is_connected (connection->transport);
4264 
4265  _dbus_verbose ("dispatch status = %s is_connected = %d\n",
4266  DISPATCH_STATUS_NAME (status), is_connected);
4267 
4268  if (!is_connected)
4269  {
4270  /* It's possible this would be better done by having an explicit
4271  * notification from _dbus_transport_disconnect() that would
4272  * synchronously do this, instead of waiting for the next dispatch
4273  * status check. However, probably not good to change until it causes
4274  * a problem.
4275  */
4276  notify_disconnected_unlocked (connection);
4277 
4278  /* I'm not sure this is needed; the idea is that we want to
4279  * queue the Disconnected only after we've read all the
4280  * messages, but if we're disconnected maybe we are guaranteed
4281  * to have read them all ?
4282  */
4283  if (status == DBUS_DISPATCH_COMPLETE)
4284  status = notify_disconnected_and_dispatch_complete_unlocked (connection);
4285  }
4286 
4287  if (status != DBUS_DISPATCH_COMPLETE)
4288  return status;
4289  else if (connection->n_incoming > 0)
4291  else
4292  return DBUS_DISPATCH_COMPLETE;
4293  }
4294 }
4295 
4296 static void
4297 _dbus_connection_update_dispatch_status_and_unlock (DBusConnection *connection,
4298  DBusDispatchStatus new_status)
4299 {
4300  dbus_bool_t changed;
4301  DBusDispatchStatusFunction function;
4302  void *data;
4303 
4304  HAVE_LOCK_CHECK (connection);
4305 
4306  _dbus_connection_ref_unlocked (connection);
4307 
4308  changed = new_status != connection->last_dispatch_status;
4309 
4310  connection->last_dispatch_status = new_status;
4311 
4312  function = connection->dispatch_status_function;
4313  data = connection->dispatch_status_data;
4314 
4315  if (connection->disconnected_message_arrived &&
4316  !connection->disconnected_message_processed)
4317  {
4318  connection->disconnected_message_processed = TRUE;
4319 
4320  /* this does an unref, but we have a ref
4321  * so we should not run the finalizer here
4322  * inside the lock.
4323  */
4324  connection_forget_shared_unlocked (connection);
4325 
4326  if (connection->exit_on_disconnect)
4327  {
4328  CONNECTION_UNLOCK (connection);
4329 
4330  _dbus_verbose ("Exiting on Disconnected signal\n");
4331  _dbus_exit (1);
4332  _dbus_assert_not_reached ("Call to exit() returned");
4333  }
4334  }
4335 
4336  /* We drop the lock */
4337  CONNECTION_UNLOCK (connection);
4338 
4339  if (changed && function)
4340  {
4341  _dbus_verbose ("Notifying of change to dispatch status of %p now %d (%s)\n",
4342  connection, new_status,
4343  DISPATCH_STATUS_NAME (new_status));
4344  (* function) (connection, new_status, data);
4345  }
4346 
4347  dbus_connection_unref (connection);
4348 }
4349 
4377 {
4378  DBusDispatchStatus status;
4379 
4380  _dbus_return_val_if_fail (connection != NULL, DBUS_DISPATCH_COMPLETE);
4381 
4382  _dbus_verbose ("start\n");
4383 
4384  CONNECTION_LOCK (connection);
4385 
4386  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4387 
4388  CONNECTION_UNLOCK (connection);
4389 
4390  return status;
4391 }
4392 
4396 static DBusHandlerResult
4397 _dbus_connection_peer_filter_unlocked_no_update (DBusConnection *connection,
4398  DBusMessage *message)
4399 {
4400  dbus_bool_t sent = FALSE;
4401  DBusMessage *ret = NULL;
4402  DBusList *expire_link;
4403 
4404  if (connection->route_peer_messages && dbus_message_get_destination (message) != NULL)
4405  {
4406  /* This means we're letting the bus route this message */
4408  }
4409 
4411  {
4413  }
4414 
4415  /* Preallocate a linked-list link, so that if we need to dispose of a
4416  * message, we can attach it to the expired list */
4417  expire_link = _dbus_list_alloc_link (NULL);
4418 
4419  if (!expire_link)
4421 
4422  if (dbus_message_is_method_call (message,
4424  "Ping"))
4425  {
4426  ret = dbus_message_new_method_return (message);
4427  if (ret == NULL)
4428  goto out;
4429 
4430  sent = _dbus_connection_send_unlocked_no_update (connection, ret, NULL);
4431  }
4432  else if (dbus_message_is_method_call (message,
4434  "GetMachineId"))
4435  {
4436  DBusString uuid;
4437  DBusError error = DBUS_ERROR_INIT;
4438 
4439  if (!_dbus_string_init (&uuid))
4440  goto out;
4441 
4442  if (_dbus_get_local_machine_uuid_encoded (&uuid, &error))
4443  {
4444  const char *v_STRING;
4445 
4446  ret = dbus_message_new_method_return (message);
4447 
4448  if (ret == NULL)
4449  {
4450  _dbus_string_free (&uuid);
4451  goto out;
4452  }
4453 
4454  v_STRING = _dbus_string_get_const_data (&uuid);
4455  if (dbus_message_append_args (ret,
4456  DBUS_TYPE_STRING, &v_STRING,
4458  {
4459  sent = _dbus_connection_send_unlocked_no_update (connection, ret, NULL);
4460  }
4461  }
4462  else if (dbus_error_has_name (&error, DBUS_ERROR_NO_MEMORY))
4463  {
4464  dbus_error_free (&error);
4465  goto out;
4466  }
4467  else
4468  {
4469  ret = dbus_message_new_error (message, error.name, error.message);
4470  dbus_error_free (&error);
4471 
4472  if (ret == NULL)
4473  goto out;
4474 
4475  sent = _dbus_connection_send_unlocked_no_update (connection, ret,
4476  NULL);
4477  }
4478 
4479  _dbus_string_free (&uuid);
4480  }
4481  else
4482  {
4483  /* We need to bounce anything else with this interface, otherwise apps
4484  * could start extending the interface and when we added extensions
4485  * here to DBusConnection we'd break those apps.
4486  */
4487  ret = dbus_message_new_error (message,
4489  "Unknown method invoked on org.freedesktop.DBus.Peer interface");
4490  if (ret == NULL)
4491  goto out;
4492 
4493  sent = _dbus_connection_send_unlocked_no_update (connection, ret, NULL);
4494  }
4495 
4496 out:
4497  if (ret == NULL)
4498  {
4499  _dbus_list_free_link (expire_link);
4500  }
4501  else
4502  {
4503  /* It'll be safe to unref the reply when we unlock */
4504  expire_link->data = ret;
4505  _dbus_list_prepend_link (&connection->expired_messages, expire_link);
4506  }
4507 
4508  if (!sent)
4510 
4512 }
4513 
4520 static DBusHandlerResult
4521 _dbus_connection_run_builtin_filters_unlocked_no_update (DBusConnection *connection,
4522  DBusMessage *message)
4523 {
4524  /* We just run one filter for now but have the option to run more
4525  if the spec calls for it in the future */
4526 
4527  return _dbus_connection_peer_filter_unlocked_no_update (connection, message);
4528 }
4529 
4574 {
4575  DBusMessage *message;
4576  DBusList *link, *filter_list_copy, *message_link;
4577  DBusHandlerResult result;
4578  DBusPendingCall *pending;
4579  dbus_int32_t reply_serial;
4580  DBusDispatchStatus status;
4581  dbus_bool_t found_object;
4582 
4583  _dbus_return_val_if_fail (connection != NULL, DBUS_DISPATCH_COMPLETE);
4584 
4585  _dbus_verbose ("\n");
4586 
4587  CONNECTION_LOCK (connection);
4588  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4589  if (status != DBUS_DISPATCH_DATA_REMAINS)
4590  {
4591  /* unlocks and calls out to user code */
4592  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
4593  return status;
4594  }
4595 
4596  /* We need to ref the connection since the callback could potentially
4597  * drop the last ref to it
4598  */
4599  _dbus_connection_ref_unlocked (connection);
4600 
4601  _dbus_connection_acquire_dispatch (connection);
4602  HAVE_LOCK_CHECK (connection);
4603 
4604  message_link = _dbus_connection_pop_message_link_unlocked (connection);
4605  if (message_link == NULL)
4606  {
4607  /* another thread dispatched our stuff */
4608 
4609  _dbus_verbose ("another thread dispatched message (during acquire_dispatch above)\n");
4610 
4611  _dbus_connection_release_dispatch (connection);
4612 
4613  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4614 
4615  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
4616 
4617  dbus_connection_unref (connection);
4618 
4619  return status;
4620  }
4621 
4622  message = message_link->data;
4623 
4624  _dbus_verbose (" dispatching message %p (%s %s %s '%s')\n",
4625  message,
4627  dbus_message_get_interface (message) ?
4628  dbus_message_get_interface (message) :
4629  "no interface",
4630  dbus_message_get_member (message) ?
4631  dbus_message_get_member (message) :
4632  "no member",
4633  dbus_message_get_signature (message));
4634 
4636 
4637  /* Pending call handling must be first, because if you do
4638  * dbus_connection_send_with_reply_and_block() or
4639  * dbus_pending_call_block() then no handlers/filters will be run on
4640  * the reply. We want consistent semantics in the case where we
4641  * dbus_connection_dispatch() the reply.
4642  */
4643 
4644  reply_serial = dbus_message_get_reply_serial (message);
4645  pending = _dbus_hash_table_lookup_int (connection->pending_replies,
4646  reply_serial);
4647  if (pending)
4648  {
4649  _dbus_verbose ("Dispatching a pending reply\n");
4650  complete_pending_call_and_unlock (connection, pending, message);
4651  pending = NULL; /* it's probably unref'd */
4652 
4653  CONNECTION_LOCK (connection);
4654  _dbus_verbose ("pending call completed in dispatch\n");
4655  result = DBUS_HANDLER_RESULT_HANDLED;
4656  goto out;
4657  }
4658 
4659  result = _dbus_connection_run_builtin_filters_unlocked_no_update (connection, message);
4661  goto out;
4662 
4663  if (!_dbus_list_copy (&connection->filter_list, &filter_list_copy))
4664  {
4665  _dbus_connection_release_dispatch (connection);
4666  HAVE_LOCK_CHECK (connection);
4667 
4668  _dbus_connection_failed_pop (connection, message_link);
4669 
4670  /* unlocks and calls user code */
4671  _dbus_connection_update_dispatch_status_and_unlock (connection,
4673  dbus_connection_unref (connection);
4674 
4676  }
4677 
4678  _dbus_list_foreach (&filter_list_copy,
4679  (DBusForeachFunction)_dbus_message_filter_ref,
4680  NULL);
4681 
4682  /* We're still protected from dispatch() reentrancy here
4683  * since we acquired the dispatcher
4684  */
4685  CONNECTION_UNLOCK (connection);
4686 
4687  link = _dbus_list_get_first_link (&filter_list_copy);
4688  while (link != NULL)
4689  {
4690  DBusMessageFilter *filter = link->data;
4691  DBusList *next = _dbus_list_get_next_link (&filter_list_copy, link);
4692 
4693  if (filter->function == NULL)
4694  {
4695  _dbus_verbose (" filter was removed in a callback function\n");
4696  link = next;
4697  continue;
4698  }
4699 
4700  _dbus_verbose (" running filter on message %p\n", message);
4701  result = (* filter->function) (connection, message, filter->user_data);
4702 
4704  break;
4705 
4706  link = next;
4707  }
4708 
4709  _dbus_list_foreach (&filter_list_copy,
4710  (DBusForeachFunction)_dbus_message_filter_unref,
4711  NULL);
4712  _dbus_list_clear (&filter_list_copy);
4713 
4714  CONNECTION_LOCK (connection);
4715 
4716  if (result == DBUS_HANDLER_RESULT_NEED_MEMORY)
4717  {
4718  _dbus_verbose ("No memory\n");
4719  goto out;
4720  }
4721  else if (result == DBUS_HANDLER_RESULT_HANDLED)
4722  {
4723  _dbus_verbose ("filter handled message in dispatch\n");
4724  goto out;
4725  }
4726 
4727  /* We're still protected from dispatch() reentrancy here
4728  * since we acquired the dispatcher
4729  */
4730  _dbus_verbose (" running object path dispatch on message %p (%s %s %s '%s')\n",
4731  message,
4733  dbus_message_get_interface (message) ?
4734  dbus_message_get_interface (message) :
4735  "no interface",
4736  dbus_message_get_member (message) ?
4737  dbus_message_get_member (message) :
4738  "no member",
4739  dbus_message_get_signature (message));
4740 
4741  HAVE_LOCK_CHECK (connection);
4742  result = _dbus_object_tree_dispatch_and_unlock (connection->objects,
4743  message,
4744  &found_object);
4745 
4746  CONNECTION_LOCK (connection);
4747 
4749  {
4750  _dbus_verbose ("object tree handled message in dispatch\n");
4751  goto out;
4752  }
4753 
4755  {
4756  DBusMessage *reply;
4757  DBusString str;
4758  DBusPreallocatedSend *preallocated;
4759  DBusList *expire_link;
4760 
4761  _dbus_verbose (" sending error %s\n",
4763 
4764  if (!_dbus_string_init (&str))
4765  {
4767  _dbus_verbose ("no memory for error string in dispatch\n");
4768  goto out;
4769  }
4770 
4771  if (!_dbus_string_append_printf (&str,
4772  "Method \"%s\" with signature \"%s\" on interface \"%s\" doesn't exist\n",
4773  dbus_message_get_member (message),
4774  dbus_message_get_signature (message),
4775  dbus_message_get_interface (message)))
4776  {
4777  _dbus_string_free (&str);
4779  _dbus_verbose ("no memory for error string in dispatch\n");
4780  goto out;
4781  }
4782 
4783  reply = dbus_message_new_error (message,
4785  _dbus_string_get_const_data (&str));
4786  _dbus_string_free (&str);
4787 
4788  if (reply == NULL)
4789  {
4791  _dbus_verbose ("no memory for error reply in dispatch\n");
4792  goto out;
4793  }
4794 
4795  expire_link = _dbus_list_alloc_link (reply);
4796 
4797  if (expire_link == NULL)
4798  {
4799  dbus_message_unref (reply);
4801  _dbus_verbose ("no memory for error send in dispatch\n");
4802  goto out;
4803  }
4804 
4805  preallocated = _dbus_connection_preallocate_send_unlocked (connection);
4806 
4807  if (preallocated == NULL)
4808  {
4809  _dbus_list_free_link (expire_link);
4810  /* It's OK that this is finalized, because it hasn't been seen by
4811  * anything that could attach user callbacks */
4812  dbus_message_unref (reply);
4814  _dbus_verbose ("no memory for error send in dispatch\n");
4815  goto out;
4816  }
4817 
4818  _dbus_connection_send_preallocated_unlocked_no_update (connection, preallocated,
4819  reply, NULL);
4820  /* reply will be freed when we release the lock */
4821  _dbus_list_prepend_link (&connection->expired_messages, expire_link);
4822 
4823  result = DBUS_HANDLER_RESULT_HANDLED;
4824  }
4825 
4826  _dbus_verbose (" done dispatching %p (%s %s %s '%s') on connection %p\n", message,
4828  dbus_message_get_interface (message) ?
4829  dbus_message_get_interface (message) :
4830  "no interface",
4831  dbus_message_get_member (message) ?
4832  dbus_message_get_member (message) :
4833  "no member",
4834  dbus_message_get_signature (message),
4835  connection);
4836 
4837  out:
4838  if (result == DBUS_HANDLER_RESULT_NEED_MEMORY)
4839  {
4840  _dbus_verbose ("out of memory\n");
4841 
4842  /* Put message back, and we'll start over.
4843  * Yes this means handlers must be idempotent if they
4844  * don't return HANDLED; c'est la vie.
4845  */
4846  _dbus_connection_putback_message_link_unlocked (connection,
4847  message_link);
4848  /* now we don't want to free them */
4849  message_link = NULL;
4850  message = NULL;
4851  }
4852  else
4853  {
4854  _dbus_verbose (" ... done dispatching\n");
4855  }
4856 
4857  _dbus_connection_release_dispatch (connection);
4858  HAVE_LOCK_CHECK (connection);
4859 
4860  if (message != NULL)
4861  {
4862  /* We don't want this message to count in maximum message limits when
4863  * computing the dispatch status, below. We have to drop the lock
4864  * temporarily, because finalizing a message can trigger callbacks.
4865  *
4866  * We have a reference to the connection, and we don't use any cached
4867  * pointers to the connection's internals below this point, so it should
4868  * be safe to drop the lock and take it back. */
4869  CONNECTION_UNLOCK (connection);
4870  dbus_message_unref (message);
4871  CONNECTION_LOCK (connection);
4872  }
4873 
4874  if (message_link != NULL)
4875  _dbus_list_free_link (message_link);
4876 
4877  _dbus_verbose ("before final status update\n");
4878  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4879 
4880  /* unlocks and calls user code */
4881  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
4882 
4883  dbus_connection_unref (connection);
4884 
4885  return status;
4886 }
4887 
4951  DBusAddWatchFunction add_function,
4952  DBusRemoveWatchFunction remove_function,
4953  DBusWatchToggledFunction toggled_function,
4954  void *data,
4955  DBusFreeFunction free_data_function)
4956 {
4957  dbus_bool_t retval;
4958 
4959  _dbus_return_val_if_fail (connection != NULL, FALSE);
4960 
4961  CONNECTION_LOCK (connection);
4962 
4963  retval = _dbus_watch_list_set_functions (connection->watches,
4964  add_function, remove_function,
4965  toggled_function,
4966  data, free_data_function);
4967 
4968  CONNECTION_UNLOCK (connection);
4969 
4970  return retval;
4971 }
4972 
5014  DBusAddTimeoutFunction add_function,
5015  DBusRemoveTimeoutFunction remove_function,
5016  DBusTimeoutToggledFunction toggled_function,
5017  void *data,
5018  DBusFreeFunction free_data_function)
5019 {
5020  dbus_bool_t retval;
5021 
5022  _dbus_return_val_if_fail (connection != NULL, FALSE);
5023 
5024  CONNECTION_LOCK (connection);
5025 
5026  retval = _dbus_timeout_list_set_functions (connection->timeouts,
5027  add_function, remove_function,
5028  toggled_function,
5029  data, free_data_function);
5030 
5031  CONNECTION_UNLOCK (connection);
5032 
5033  return retval;
5034 }
5035 
5050 void
5052  DBusWakeupMainFunction wakeup_main_function,
5053  void *data,
5054  DBusFreeFunction free_data_function)
5055 {
5056  void *old_data;
5057  DBusFreeFunction old_free_data;
5058 
5059  _dbus_return_if_fail (connection != NULL);
5060 
5061  CONNECTION_LOCK (connection);
5062  old_data = connection->wakeup_main_data;
5063  old_free_data = connection->free_wakeup_main_data;
5064 
5065  connection->wakeup_main_function = wakeup_main_function;
5066  connection->wakeup_main_data = data;
5067  connection->free_wakeup_main_data = free_data_function;
5068 
5069  CONNECTION_UNLOCK (connection);
5070 
5071  /* Callback outside the lock */
5072  if (old_free_data)
5073  (*old_free_data) (old_data);
5074 }
5075 
5096 void
5098  DBusDispatchStatusFunction function,
5099  void *data,
5100  DBusFreeFunction free_data_function)
5101 {
5102  void *old_data;
5103  DBusFreeFunction old_free_data;
5104 
5105  _dbus_return_if_fail (connection != NULL);
5106 
5107  CONNECTION_LOCK (connection);
5108  old_data = connection->dispatch_status_data;
5109  old_free_data = connection->free_dispatch_status_data;
5110 
5111  connection->dispatch_status_function = function;
5112  connection->dispatch_status_data = data;
5113  connection->free_dispatch_status_data = free_data_function;
5114 
5115  CONNECTION_UNLOCK (connection);
5116 
5117  /* Callback outside the lock */
5118  if (old_free_data)
5119  (*old_free_data) (old_data);
5120 }
5121 
5143  int *fd)
5144 {
5145  _dbus_return_val_if_fail (connection != NULL, FALSE);
5146  _dbus_return_val_if_fail (connection->transport != NULL, FALSE);
5147 
5148 #ifdef DBUS_WIN
5149  /* FIXME do this on a lower level */
5150  return FALSE;
5151 #endif
5152 
5153  return dbus_connection_get_socket(connection, fd);
5154 }
5155 
5173  int *fd)
5174 {
5175  dbus_bool_t retval;
5176  DBusSocket s = DBUS_SOCKET_INIT;
5177 
5178  _dbus_return_val_if_fail (connection != NULL, FALSE);
5179  _dbus_return_val_if_fail (connection->transport != NULL, FALSE);
5180 
5181  CONNECTION_LOCK (connection);
5182 
5183  retval = _dbus_transport_get_socket_fd (connection->transport, &s);
5184 
5185  if (retval)
5186  {
5187  *fd = _dbus_socket_get_int (s);
5188  }
5189 
5190  CONNECTION_UNLOCK (connection);
5191 
5192  return retval;
5193 }
5194 
5195 
5220  unsigned long *uid)
5221 {
5222  dbus_bool_t result;
5223 
5224  _dbus_return_val_if_fail (connection != NULL, FALSE);
5225  _dbus_return_val_if_fail (uid != NULL, FALSE);
5226 
5227  CONNECTION_LOCK (connection);
5228 
5230  result = FALSE;
5231  else
5232  result = _dbus_transport_get_unix_user (connection->transport,
5233  uid);
5234 
5235 #ifdef DBUS_WIN
5236  _dbus_assert (!result);
5237 #endif
5238 
5239  CONNECTION_UNLOCK (connection);
5240 
5241  return result;
5242 }
5243 
5256  unsigned long *pid)
5257 {
5258  dbus_bool_t result;
5259 
5260  _dbus_return_val_if_fail (connection != NULL, FALSE);
5261  _dbus_return_val_if_fail (pid != NULL, FALSE);
5262 
5263  CONNECTION_LOCK (connection);
5264 
5266  result = FALSE;
5267  else
5268  result = _dbus_transport_get_unix_process_id (connection->transport,
5269  pid);
5270 
5271  CONNECTION_UNLOCK (connection);
5272 
5273  return result;
5274 }
5275 
5289  void **data,
5290  dbus_int32_t *data_size)
5291 {
5292  dbus_bool_t result;
5293 
5294  _dbus_return_val_if_fail (connection != NULL, FALSE);
5295  _dbus_return_val_if_fail (data != NULL, FALSE);
5296  _dbus_return_val_if_fail (data_size != NULL, FALSE);
5297 
5298  CONNECTION_LOCK (connection);
5299 
5301  result = FALSE;
5302  else
5304  data,
5305  data_size);
5306  CONNECTION_UNLOCK (connection);
5307 
5308  return result;
5309 }
5310 
5333 void
5335  DBusAllowUnixUserFunction function,
5336  void *data,
5337  DBusFreeFunction free_data_function)
5338 {
5339  void *old_data = NULL;
5340  DBusFreeFunction old_free_function = NULL;
5341 
5342  _dbus_return_if_fail (connection != NULL);
5343 
5344  CONNECTION_LOCK (connection);
5346  function, data, free_data_function,
5347  &old_data, &old_free_function);
5348  CONNECTION_UNLOCK (connection);
5349 
5350  if (old_free_function != NULL)
5351  (* old_free_function) (old_data);
5352 }
5353 
5354 /* Same calling convention as dbus_connection_get_windows_user */
5356 _dbus_connection_get_linux_security_label (DBusConnection *connection,
5357  char **label_p)
5358 {
5359  dbus_bool_t result;
5360 
5361  _dbus_assert (connection != NULL);
5362  _dbus_assert (label_p != NULL);
5363 
5364  CONNECTION_LOCK (connection);
5365 
5367  result = FALSE;
5368  else
5369  result = _dbus_transport_get_linux_security_label (connection->transport,
5370  label_p);
5371 #ifndef __linux__
5372  _dbus_assert (!result);
5373 #endif
5374 
5375  CONNECTION_UNLOCK (connection);
5376 
5377  return result;
5378 }
5379 
5413  char **windows_sid_p)
5414 {
5415  dbus_bool_t result;
5416 
5417  _dbus_return_val_if_fail (connection != NULL, FALSE);
5418  _dbus_return_val_if_fail (windows_sid_p != NULL, FALSE);
5419 
5420  CONNECTION_LOCK (connection);
5421 
5423  result = FALSE;
5424  else
5425  result = _dbus_transport_get_windows_user (connection->transport,
5426  windows_sid_p);
5427 
5428 #ifdef DBUS_UNIX
5429  _dbus_assert (!result);
5430 #endif
5431 
5432  CONNECTION_UNLOCK (connection);
5433 
5434  return result;
5435 }
5436 
5458 void
5461  void *data,
5462  DBusFreeFunction free_data_function)
5463 {
5464  void *old_data = NULL;
5465  DBusFreeFunction old_free_function = NULL;
5466 
5467  _dbus_return_if_fail (connection != NULL);
5468 
5469  CONNECTION_LOCK (connection);
5471  function, data, free_data_function,
5472  &old_data, &old_free_function);
5473  CONNECTION_UNLOCK (connection);
5474 
5475  if (old_free_function != NULL)
5476  (* old_free_function) (old_data);
5477 }
5478 
5505 void
5507  dbus_bool_t value)
5508 {
5509  _dbus_return_if_fail (connection != NULL);
5510 
5511  CONNECTION_LOCK (connection);
5512  _dbus_transport_set_allow_anonymous (connection->transport, value);
5513  CONNECTION_UNLOCK (connection);
5514 }
5515 
5533 void
5535  dbus_bool_t value)
5536 {
5537  _dbus_return_if_fail (connection != NULL);
5538 
5539  CONNECTION_LOCK (connection);
5540  connection->route_peer_messages = value;
5541  CONNECTION_UNLOCK (connection);
5542 }
5543 
5567  DBusHandleMessageFunction function,
5568  void *user_data,
5569  DBusFreeFunction free_data_function)
5570 {
5571  DBusMessageFilter *filter;
5572 
5573  _dbus_return_val_if_fail (connection != NULL, FALSE);
5574  _dbus_return_val_if_fail (function != NULL, FALSE);
5575 
5576  filter = dbus_new0 (DBusMessageFilter, 1);
5577  if (filter == NULL)
5578  return FALSE;
5579 
5580  _dbus_atomic_inc (&filter->refcount);
5581 
5582  CONNECTION_LOCK (connection);
5583 
5584  if (!_dbus_list_append (&connection->filter_list,
5585  filter))
5586  {
5587  _dbus_message_filter_unref (filter);
5588  CONNECTION_UNLOCK (connection);
5589  return FALSE;
5590  }
5591 
5592  /* Fill in filter after all memory allocated,
5593  * so we don't run the free_user_data_function
5594  * if the add_filter() fails
5595  */
5596 
5597  filter->function = function;
5598  filter->user_data = user_data;
5599  filter->free_user_data_function = free_data_function;
5600 
5601  CONNECTION_UNLOCK (connection);
5602  return TRUE;
5603 }
5604 
5617 void
5619  DBusHandleMessageFunction function,
5620  void *user_data)
5621 {
5622  DBusList *link;
5623  DBusMessageFilter *filter;
5624 
5625  _dbus_return_if_fail (connection != NULL);
5626  _dbus_return_if_fail (function != NULL);
5627 
5628  CONNECTION_LOCK (connection);
5629 
5630  filter = NULL;
5631 
5632  link = _dbus_list_get_last_link (&connection->filter_list);
5633  while (link != NULL)
5634  {
5635  filter = link->data;
5636 
5637  if (filter->function == function &&
5638  filter->user_data == user_data)
5639  {
5640  _dbus_list_remove_link (&connection->filter_list, link);
5641  filter->function = NULL;
5642 
5643  break;
5644  }
5645 
5646  link = _dbus_list_get_prev_link (&connection->filter_list, link);
5647  filter = NULL;
5648  }
5649 
5650  CONNECTION_UNLOCK (connection);
5651 
5652 #ifndef DBUS_DISABLE_CHECKS
5653  if (filter == NULL)
5654  {
5655  _dbus_warn_check_failed ("Attempt to remove filter function %p user data %p, but no such filter has been added",
5656  function, user_data);
5657  return;
5658  }
5659 #endif
5660 
5661  /* Call application code */
5662  if (filter->free_user_data_function)
5663  (* filter->free_user_data_function) (filter->user_data);
5664 
5665  filter->free_user_data_function = NULL;
5666  filter->user_data = NULL;
5667 
5668  _dbus_message_filter_unref (filter);
5669 }
5670 
5686 static dbus_bool_t
5687 _dbus_connection_register_object_path (DBusConnection *connection,
5688  dbus_bool_t fallback,
5689  const char *path,
5690  const DBusObjectPathVTable *vtable,
5691  void *user_data,
5692  DBusError *error)
5693 {
5694  char **decomposed_path;
5695  dbus_bool_t retval;
5696 
5697  if (!_dbus_decompose_path (path, strlen (path), &decomposed_path, NULL))
5698  return FALSE;
5699 
5700  CONNECTION_LOCK (connection);
5701 
5702  retval = _dbus_object_tree_register (connection->objects,
5703  fallback,
5704  (const char **) decomposed_path, vtable,
5705  user_data, error);
5706 
5707  CONNECTION_UNLOCK (connection);
5708 
5709  dbus_free_string_array (decomposed_path);
5710 
5711  return retval;
5712 }
5713 
5728  const char *path,
5729  const DBusObjectPathVTable *vtable,
5730  void *user_data,
5731  DBusError *error)
5732 {
5733  _dbus_return_val_if_fail (connection != NULL, FALSE);
5734  _dbus_return_val_if_fail (path != NULL, FALSE);
5735  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5736  _dbus_return_val_if_fail (vtable != NULL, FALSE);
5737 
5738  return _dbus_connection_register_object_path (connection, FALSE, path, vtable, user_data, error);
5739 }
5740 
5758  const char *path,
5759  const DBusObjectPathVTable *vtable,
5760  void *user_data)
5761 {
5762  dbus_bool_t retval;
5763  DBusError error = DBUS_ERROR_INIT;
5764 
5765  _dbus_return_val_if_fail (connection != NULL, FALSE);
5766  _dbus_return_val_if_fail (path != NULL, FALSE);
5767  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5768  _dbus_return_val_if_fail (vtable != NULL, FALSE);
5769 
5770  retval = _dbus_connection_register_object_path (connection, FALSE, path, vtable, user_data, &error);
5771 
5773  {
5774  _dbus_warn ("%s", error.message);
5775  dbus_error_free (&error);
5776  return FALSE;
5777  }
5778 
5779  return retval;
5780 }
5781 
5798  const char *path,
5799  const DBusObjectPathVTable *vtable,
5800  void *user_data,
5801  DBusError *error)
5802 {
5803  _dbus_return_val_if_fail (connection != NULL, FALSE);
5804  _dbus_return_val_if_fail (path != NULL, FALSE);
5805  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5806  _dbus_return_val_if_fail (vtable != NULL, FALSE);
5807 
5808  return _dbus_connection_register_object_path (connection, TRUE, path, vtable, user_data, error);
5809 }
5810 
5830  const char *path,
5831  const DBusObjectPathVTable *vtable,
5832  void *user_data)
5833 {
5834  dbus_bool_t retval;
5835  DBusError error = DBUS_ERROR_INIT;
5836 
5837  _dbus_return_val_if_fail (connection != NULL, FALSE);
5838  _dbus_return_val_if_fail (path != NULL, FALSE);
5839  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5840  _dbus_return_val_if_fail (vtable != NULL, FALSE);
5841 
5842  retval = _dbus_connection_register_object_path (connection, TRUE, path, vtable, user_data, &error);
5843 
5845  {
5846  _dbus_warn ("%s", error.message);
5847  dbus_error_free (&error);
5848  return FALSE;
5849  }
5850 
5851  return retval;
5852 }
5853 
5865  const char *path)
5866 {
5867  char **decomposed_path;
5868 
5869  _dbus_return_val_if_fail (connection != NULL, FALSE);
5870  _dbus_return_val_if_fail (path != NULL, FALSE);
5871  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5872 
5873  if (!_dbus_decompose_path (path, strlen (path), &decomposed_path, NULL))
5874  return FALSE;
5875 
5876  CONNECTION_LOCK (connection);
5877 
5878  _dbus_object_tree_unregister_and_unlock (connection->objects, (const char **) decomposed_path);
5879 
5880  dbus_free_string_array (decomposed_path);
5881 
5882  return TRUE;
5883 }
5884 
5897  const char *path,
5898  void **data_p)
5899 {
5900  char **decomposed_path;
5901 
5902  _dbus_return_val_if_fail (connection != NULL, FALSE);
5903  _dbus_return_val_if_fail (path != NULL, FALSE);
5904  _dbus_return_val_if_fail (data_p != NULL, FALSE);
5905 
5906  *data_p = NULL;
5907 
5908  if (!_dbus_decompose_path (path, strlen (path), &decomposed_path, NULL))
5909  return FALSE;
5910 
5911  CONNECTION_LOCK (connection);
5912 
5913  *data_p = _dbus_object_tree_get_user_data_unlocked (connection->objects, (const char**) decomposed_path);
5914 
5915  CONNECTION_UNLOCK (connection);
5916 
5917  dbus_free_string_array (decomposed_path);
5918 
5919  return TRUE;
5920 }
5921 
5934  const char *parent_path,
5935  char ***child_entries)
5936 {
5937  char **decomposed_path;
5938  dbus_bool_t retval;
5939  _dbus_return_val_if_fail (connection != NULL, FALSE);
5940  _dbus_return_val_if_fail (parent_path != NULL, FALSE);
5941  _dbus_return_val_if_fail (parent_path[0] == '/', FALSE);
5942  _dbus_return_val_if_fail (child_entries != NULL, FALSE);
5943 
5944  if (!_dbus_decompose_path (parent_path, strlen (parent_path), &decomposed_path, NULL))
5945  return FALSE;
5946 
5947  CONNECTION_LOCK (connection);
5948 
5950  (const char **) decomposed_path,
5951  child_entries);
5952  dbus_free_string_array (decomposed_path);
5953 
5954  return retval;
5955 }
5956 
5957 static DBusDataSlotAllocator slot_allocator =
5958  _DBUS_DATA_SLOT_ALLOCATOR_INIT (_DBUS_LOCK_NAME (connection_slots));
5959 
5976 {
5977  return _dbus_data_slot_allocator_alloc (&slot_allocator,
5978  slot_p);
5979 }
5980 
5992 void
5993 dbus_connection_free_data_slot (dbus_int32_t *slot_p)
5994 {
5995  _dbus_return_if_fail (*slot_p >= 0);
5996 
5997  _dbus_data_slot_allocator_free (&slot_allocator, slot_p);
5998 }
5999 
6024  dbus_int32_t slot,
6025  void *data,
6026  DBusFreeFunction free_data_func)
6027 {
6028  DBusFreeFunction old_free_func;
6029  void *old_data;
6030  dbus_bool_t retval;
6031 
6032  _dbus_return_val_if_fail (connection != NULL, FALSE);
6033  _dbus_return_val_if_fail (slot >= 0, FALSE);
6034 
6035  SLOTS_LOCK (connection);
6036 
6037  retval = _dbus_data_slot_list_set (&slot_allocator,
6038  &connection->slot_list,
6039  slot, data, free_data_func,
6040  &old_free_func, &old_data);
6041 
6042  SLOTS_UNLOCK (connection);
6043 
6044  if (retval)
6045  {
6046  /* Do the actual free outside the connection lock */
6047  if (old_free_func)
6048  (* old_free_func) (old_data);
6049  }
6050 
6051  return retval;
6052 }
6053 
6071 void*
6073  dbus_int32_t slot)
6074 {
6075  void *res;
6076 
6077  _dbus_return_val_if_fail (connection != NULL, NULL);
6078  _dbus_return_val_if_fail (slot >= 0, NULL);
6079 
6080  SLOTS_LOCK (connection);
6081 
6082  res = _dbus_data_slot_list_get (&slot_allocator,
6083  &connection->slot_list,
6084  slot);
6085 
6086  SLOTS_UNLOCK (connection);
6087 
6088  return res;
6089 }
6090 
6097 void
6099 {
6100  _dbus_modify_sigpipe = will_modify_sigpipe != FALSE;
6101 }
6102 
6111 void
6113  long size)
6114 {
6115  _dbus_return_if_fail (connection != NULL);
6116 
6117  CONNECTION_LOCK (connection);
6119  size);
6120  CONNECTION_UNLOCK (connection);
6121 }
6122 
6129 long
6131 {
6132  long res;
6133 
6134  _dbus_return_val_if_fail (connection != NULL, 0);
6135 
6136  CONNECTION_LOCK (connection);
6137  res = _dbus_transport_get_max_message_size (connection->transport);
6138  CONNECTION_UNLOCK (connection);
6139  return res;
6140 }
6141 
6150 void
6152  long n)
6153 {
6154  _dbus_return_if_fail (connection != NULL);
6155 
6156  CONNECTION_LOCK (connection);
6158  n);
6159  CONNECTION_UNLOCK (connection);
6160 }
6161 
6168 long
6170 {
6171  long res;
6172 
6173  _dbus_return_val_if_fail (connection != NULL, 0);
6174 
6175  CONNECTION_LOCK (connection);
6177  CONNECTION_UNLOCK (connection);
6178  return res;
6179 }
6180 
6206 void
6208  long size)
6209 {
6210  _dbus_return_if_fail (connection != NULL);
6211 
6212  CONNECTION_LOCK (connection);
6214  size);
6215  CONNECTION_UNLOCK (connection);
6216 }
6217 
6224 long
6226 {
6227  long res;
6228 
6229  _dbus_return_val_if_fail (connection != NULL, 0);
6230 
6231  CONNECTION_LOCK (connection);
6233  CONNECTION_UNLOCK (connection);
6234  return res;
6235 }
6236 
6248 void
6250  long n)
6251 {
6252  _dbus_return_if_fail (connection != NULL);
6253 
6254  CONNECTION_LOCK (connection);
6256  n);
6257  CONNECTION_UNLOCK (connection);
6258 }
6259 
6266 long
6268 {
6269  long res;
6270 
6271  _dbus_return_val_if_fail (connection != NULL, 0);
6272 
6273  CONNECTION_LOCK (connection);
6275  CONNECTION_UNLOCK (connection);
6276  return res;
6277 }
6278 
6289 long
6291 {
6292  long res;
6293 
6294  _dbus_return_val_if_fail (connection != NULL, 0);
6295 
6296  CONNECTION_LOCK (connection);
6297  res = _dbus_counter_get_size_value (connection->outgoing_counter);
6298  CONNECTION_UNLOCK (connection);
6299  return res;
6300 }
6301 
6302 #ifdef DBUS_ENABLE_STATS
6303 void
6304 _dbus_connection_get_stats (DBusConnection *connection,
6305  dbus_uint32_t *in_messages,
6306  dbus_uint32_t *in_bytes,
6307  dbus_uint32_t *in_fds,
6308  dbus_uint32_t *in_peak_bytes,
6309  dbus_uint32_t *in_peak_fds,
6310  dbus_uint32_t *out_messages,
6311  dbus_uint32_t *out_bytes,
6312  dbus_uint32_t *out_fds,
6313  dbus_uint32_t *out_peak_bytes,
6314  dbus_uint32_t *out_peak_fds)
6315 {
6316  CONNECTION_LOCK (connection);
6317 
6318  if (in_messages != NULL)
6319  *in_messages = connection->n_incoming;
6320 
6321  _dbus_transport_get_stats (connection->transport,
6322  in_bytes, in_fds, in_peak_bytes, in_peak_fds);
6323 
6324  if (out_messages != NULL)
6325  *out_messages = connection->n_outgoing;
6326 
6327  if (out_bytes != NULL)
6328  *out_bytes = _dbus_counter_get_size_value (connection->outgoing_counter);
6329 
6330  if (out_fds != NULL)
6331  *out_fds = _dbus_counter_get_unix_fd_value (connection->outgoing_counter);
6332 
6333  if (out_peak_bytes != NULL)
6334  *out_peak_bytes = _dbus_counter_get_peak_size_value (connection->outgoing_counter);
6335 
6336  if (out_peak_fds != NULL)
6337  *out_peak_fds = _dbus_counter_get_peak_unix_fd_value (connection->outgoing_counter);
6338 
6339  CONNECTION_UNLOCK (connection);
6340 }
6341 #endif /* DBUS_ENABLE_STATS */
6342 
6350 long
6352 {
6353  long res;
6354 
6355  _dbus_return_val_if_fail (connection != NULL, 0);
6356 
6357  CONNECTION_LOCK (connection);
6359  CONNECTION_UNLOCK (connection);
6360  return res;
6361 }
6362 
6363 #ifdef DBUS_ENABLE_EMBEDDED_TESTS
6364 
6370 const char*
6371 _dbus_connection_get_address (DBusConnection *connection)
6372 {
6373  return _dbus_transport_get_address (connection->transport);
6374 }
6375 #endif
6376 
dbus_bool_t dbus_error_has_name(const DBusError *error, const char *name)
Checks whether the error is set and has the given name.
Definition: dbus-errors.c:302
DBusHandlerResult _dbus_object_tree_dispatch_and_unlock(DBusObjectTree *tree, DBusMessage *message, dbus_bool_t *found_object)
Tries to dispatch a message by directing it to handler for the object path listed in the message head...
An atomic integer safe to increment or decrement from multiple threads.
Definition: dbus-sysdeps.h:280
void _dbus_pending_call_complete(DBusPendingCall *pending)
Calls notifier function for the pending call and sets the call to completed.
void dbus_connection_set_change_sigpipe(dbus_bool_t will_modify_sigpipe)
This function sets a global flag for whether dbus_connection_new() will set SIGPIPE behavior to SIG_I...
DBusMessage * dbus_message_ref(DBusMessage *message)
Increments the reference count of a DBusMessage.
DBusList * filter_list
List of filters.
void _dbus_transport_set_max_received_unix_fds(DBusTransport *transport, long n)
See dbus_connection_set_max_received_unix_fds().
Internals of DBusTimeout.
Definition: dbus-timeout.c:40
void * user_data
User data for the function.
void dbus_message_lock(DBusMessage *message)
Locks a message.
Definition: dbus-message.c:407
void * _dbus_list_get_last(DBusList **list)
Gets the last data in the list.
Definition: dbus-list.c:596
void _dbus_connection_toggle_watch_unlocked(DBusConnection *connection, DBusWatch *watch, dbus_bool_t enabled)
Toggles a watch and notifies app via connection&#39;s DBusWatchToggledFunction if available.
const char * _dbus_transport_get_server_id(DBusTransport *transport)
Gets the id of the server we are connected to (see dbus_server_get_id()).
dbus_bool_t _dbus_list_prepend(DBusList **list, void *data)
Prepends a value to the list.
Definition: dbus-list.c:292
DBusDispatchStatus
Indicates the status of incoming data on a DBusConnection.
const char * message
public error message field
Definition: dbus-errors.h:51
const char * _dbus_transport_get_address(DBusTransport *transport)
Gets the address of a transport.
DBusFreeFunction free_wakeup_main_data
free wakeup_main_data
Implementation of DBusWatch.
Definition: dbus-watch.c:40
#define NULL
A null pointer, defined appropriately for C or C++.
dbus_bool_t dbus_message_is_method_call(DBusMessage *message, const char *iface, const char *method)
Checks whether the message is a method call with the given interface and member fields.
void(* DBusFreeFunction)(void *memory)
The type of a function which frees a block of memory.
Definition: dbus-memory.h:64
dbus_bool_t _dbus_connection_add_timeout_unlocked(DBusConnection *connection, DBusTimeout *timeout)
Adds a timeout using the connection&#39;s DBusAddTimeoutFunction if available.
DBusList * queue_link
Preallocated link in the queue.
unsigned int have_connection_lock
Used to check locking.
void dbus_message_set_no_reply(DBusMessage *message, dbus_bool_t no_reply)
Sets a flag indicating that the message does not want a reply; if this flag is set, the other end of the connection may (but is not required to) optimize by not sending method return or error replies.
dbus_bool_t _dbus_timeout_list_set_functions(DBusTimeoutList *timeout_list, DBusAddTimeoutFunction add_function, DBusRemoveTimeoutFunction remove_function, DBusTimeoutToggledFunction toggled_function, void *data, DBusFreeFunction free_data_function)
Sets the timeout functions.
Definition: dbus-timeout.c:243
void _dbus_connection_queue_synthesized_message_link(DBusConnection *connection, DBusList *link)
Adds a link + message to the incoming message queue.
DBusConnection * _dbus_pending_call_get_connection_unlocked(DBusPendingCall *pending)
Gets the connection associated with this pending call.
void _dbus_object_tree_free_all_unlocked(DBusObjectTree *tree)
Free all the handlers in the tree.
More memory is needed to continue.
void dbus_free(void *memory)
Frees a block of memory previously allocated by dbus_malloc() or dbus_malloc0().
Definition: dbus-memory.c:702
dbus_bool_t _dbus_hash_table_insert_int(DBusHashTable *table, int key, void *value)
Creates a hash entry with the given key and value.
Definition: dbus-hash.c:1258
dbus_uint32_t dbus_message_get_serial(DBusMessage *message)
Returns the serial of a message or 0 if none has been specified.
void _dbus_condvar_wait(DBusCondVar *cond, DBusCMutex *mutex)
Atomically unlocks the mutex and waits for the conditions variable to be signalled.
Definition: dbus-threads.c:240
void dbus_connection_set_windows_user_function(DBusConnection *connection, DBusAllowWindowsUserFunction function, void *data, DBusFreeFunction free_data_function)
Sets a predicate function used to determine whether a given user ID is allowed to connect...
dbus_bool_t _dbus_condvar_wait_timeout(DBusCondVar *cond, DBusCMutex *mutex, int timeout_milliseconds)
Atomically unlocks the mutex and waits for the conditions variable to be signalled, or for a timeout.
Definition: dbus-threads.c:261
DBusList * _dbus_list_get_last_link(DBusList **list)
Gets the last link in the list.
Definition: dbus-list.c:580
dbus_bool_t dbus_connection_get_windows_user(DBusConnection *connection, char **windows_sid_p)
Gets the Windows user SID of the connection if known.
void _dbus_connection_lock(DBusConnection *connection)
Acquires the connection lock.
dbus_bool_t _dbus_transport_get_socket_fd(DBusTransport *transport, DBusSocket *fd_p)
Get the socket file descriptor, if any.
DBusMessage * dbus_pending_call_steal_reply(DBusPendingCall *pending)
Gets the reply, or returns NULL if none has been received yet.
#define dbus_new(type, count)
Safe macro for using dbus_malloc().
Definition: dbus-memory.h:58
DBusList * disconnect_message_link
Preallocated list node for queueing the disconnection message.
void(* DBusWatchToggledFunction)(DBusWatch *watch, void *data)
Called when dbus_watch_get_enabled() may return a different value than it did before.
void dbus_connection_set_max_message_size(DBusConnection *connection, long size)
Specifies the maximum size message this connection is allowed to receive.
dbus_bool_t dbus_connection_try_register_fallback(DBusConnection *connection, const char *path, const DBusObjectPathVTable *vtable, void *user_data, DBusError *error)
Registers a fallback handler for a given subsection of the object hierarchy.
void _dbus_list_remove_link(DBusList **list, DBusList *link)
Removes a link from the list.
Definition: dbus-list.c:527
void _dbus_timeout_list_free(DBusTimeoutList *timeout_list)
Frees a DBusTimeoutList.
Definition: dbus-timeout.c:215
long dbus_connection_get_outgoing_size(DBusConnection *connection)
Gets the approximate size in bytes of all messages in the outgoing message queue. ...
DBusConnection * dbus_connection_ref(DBusConnection *connection)
Increments the reference count of a DBusConnection.
dbus_bool_t dbus_connection_can_send_type(DBusConnection *connection, int type)
Tests whether a certain type can be send via the connection.
DBusMessage * message_borrowed
Filled in if the first incoming message has been borrowed; dispatch_acquired will be set by the borro...
#define DBUS_TYPE_STRING
Type code marking a UTF-8 encoded, nul-terminated Unicode string.
dbus_bool_t _dbus_get_local_machine_uuid_encoded(DBusString *uuid_str, DBusError *error)
Gets the hex-encoded UUID of the machine this function is executed on.
DBusTimeoutList * _dbus_timeout_list_new(void)
Creates a new timeout list.
Definition: dbus-timeout.c:198
#define _dbus_assert(condition)
Aborts with an error message if the condition is false.
dbus_bool_t dbus_connection_read_write(DBusConnection *connection, int timeout_milliseconds)
This function is intended for use with applications that don&#39;t want to write a main loop and deal wit...
unsigned int shareable
TRUE if libdbus owns a reference to the connection and can return it from dbus_connection_open() more...
void _dbus_list_append_link(DBusList **list, DBusList *link)
Appends a link to the list.
Definition: dbus-list.c:315
Internals of DBusCounter.
#define DBUS_ERROR_INIT
Expands to a suitable initializer for a DBusError on the stack.
Definition: dbus-errors.h:62
void * data
Data stored at this element.
Definition: dbus-list.h:38
DBusFreeFunction free_dispatch_status_data
free dispatch_status_data
DBusMessage * dbus_message_new(int message_type)
Constructs a new message of the given message type.
DBusFreeFunction free_user_data_function
Function to free the user data.
DBusList * incoming_messages
Queue of messages we have received, end of the list received most recently.
void _dbus_warn_check_failed(const char *format,...)
Prints a "critical" warning to stderr when an assertion fails; differs from _dbus_warn primarily in t...
dbus_bool_t _dbus_transport_get_unix_process_id(DBusTransport *transport, unsigned long *pid)
See dbus_connection_get_unix_process_id().
const char * dbus_message_get_signature(DBusMessage *message)
Gets the type signature of the message, i.e.
void _dbus_watch_list_toggle_watch(DBusWatchList *watch_list, DBusWatch *watch, dbus_bool_t enabled)
Sets a watch to the given enabled state, invoking the application&#39;s DBusWatchToggledFunction if appro...
Definition: dbus-watch.c:442
dbus_bool_t _dbus_transport_queue_messages(DBusTransport *transport)
Processes data we&#39;ve read while handling a watch, potentially converting some of it to messages and q...
Message has not had any effect - see if other handlers want it.
Definition: dbus-shared.h:69
void _dbus_transport_set_unix_user_function(DBusTransport *transport, DBusAllowUnixUserFunction function, void *data, DBusFreeFunction free_data_function, void **old_data, DBusFreeFunction *old_free_data_function)
See dbus_connection_set_unix_user_function().
void dbus_message_iter_init_append(DBusMessage *message, DBusMessageIter *iter)
Initializes a DBusMessageIter for appending arguments to the end of a message.
void dbus_connection_set_dispatch_status_function(DBusConnection *connection, DBusDispatchStatusFunction function, void *data, DBusFreeFunction free_data_function)
Set a function to be invoked when the dispatch status changes.
dbus_bool_t dbus_connection_set_data(DBusConnection *connection, dbus_int32_t slot, void *data, DBusFreeFunction free_data_func)
Stores a pointer on a DBusConnection, along with an optional function to be used for freeing the data...
void dbus_error_free(DBusError *error)
Frees an error that&#39;s been set (or just initialized), then reinitializes the error as in dbus_error_i...
Definition: dbus-errors.c:211
void _dbus_watch_list_free(DBusWatchList *watch_list)
Frees a DBusWatchList.
Definition: dbus-watch.c:249
void dbus_connection_set_route_peer_messages(DBusConnection *connection, dbus_bool_t value)
Normally DBusConnection automatically handles all messages to the org.freedesktop.DBus.Peer interface.
void _dbus_object_tree_unregister_and_unlock(DBusObjectTree *tree, const char **path)
Unregisters an object subtree that was registered with the same path.
#define DBUS_INTERFACE_PEER
The interface supported by most dbus peers.
Definition: dbus-shared.h:99
void _dbus_hash_table_unref(DBusHashTable *table)
Decrements the reference count for a hash table, freeing the hash table if the count reaches zero...
Definition: dbus-hash.c:361
void _dbus_connection_close_if_only_one_ref(DBusConnection *connection)
Used internally to handle the semantics of dbus_server_set_new_connection_function().
#define DBUS_INTERFACE_LOCAL
This is a special interface whose methods can only be invoked by the local implementation (messages f...
Definition: dbus-shared.h:105
void dbus_connection_return_message(DBusConnection *connection, DBusMessage *message)
Used to return a message after peeking at it using dbus_connection_borrow_message().
DBusAtomic refcount
Reference count.
DBusCounter * _dbus_counter_ref(DBusCounter *counter)
Increments refcount of the counter.
void dbus_address_entries_free(DBusAddressEntry **entries)
Frees a NULL-terminated array of address entries.
Definition: dbus-address.c:189
dbus_bool_t _dbus_transport_get_windows_user(DBusTransport *transport, char **windows_sid_p)
See dbus_connection_get_windows_user().
Implementation details of DBusPendingCall - all fields are private.
void _dbus_rmutex_new_at_location(DBusRMutex **location_p)
Creates a new mutex or creates a no-op mutex if threads are not initialized.
Definition: dbus-threads.c:53
dbus_bool_t dbus_connection_set_timeout_functions(DBusConnection *connection, DBusAddTimeoutFunction add_function, DBusRemoveTimeoutFunction remove_function, DBusTimeoutToggledFunction toggled_function, void *data, DBusFreeFunction free_data_function)
Sets the timeout functions for the connection.
Implementation details of DBusConnection.
dbus_bool_t dbus_message_has_interface(DBusMessage *message, const char *iface)
Checks if the message has an interface.
void dbus_connection_remove_filter(DBusConnection *connection, DBusHandleMessageFunction function, void *user_data)
Removes a previously-added message filter.
struct DBusMutex DBusMutex
An opaque mutex type provided by the DBusThreadFunctions implementation installed by dbus_threads_ini...
Definition: dbus-threads.h:41
#define _dbus_list_get_prev_link(list, link)
Gets the previous link in the list, or NULL if there are no more links.
Definition: dbus-list.h:117
DBusWatchList * _dbus_watch_list_new(void)
Creates a new watch list.
Definition: dbus-watch.c:232
DBusCounter * outgoing_counter
Counts size of outgoing messages.
dbus_bool_t(* DBusWatchAddFunction)(DBusWatchList *list, DBusWatch *watch)
Function to be called in protected_change_watch() with refcount held.
#define DBUS_MESSAGE_TYPE_ERROR
Message type of an error reply message, see dbus_message_get_type()
DBusList * _dbus_list_alloc_link(void *data)
Allocates a linked list node.
Definition: dbus-list.c:242
dbus_bool_t dbus_connection_get_unix_user(DBusConnection *connection, unsigned long *uid)
Gets the UNIX user ID of the connection if known.
dbus_bool_t dbus_connection_list_registered(DBusConnection *connection, const char *parent_path, char ***child_entries)
Lists the registered fallback handlers and object path handlers at the given parent_path.
const char * dbus_message_get_path(DBusMessage *message)
Gets the object path this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or being emitt...
dbus_bool_t _dbus_string_init(DBusString *str)
Initializes a string.
Definition: dbus-string.c:175
DBusMessage * dbus_message_new_signal(const char *path, const char *iface, const char *name)
Constructs a new message representing a signal emission.
long _dbus_transport_get_max_message_size(DBusTransport *transport)
See dbus_connection_get_max_message_size().
dbus_bool_t _dbus_hash_iter_next(DBusHashIter *iter)
Move the hash iterator forward one step, to the next hash entry.
Definition: dbus-hash.c:543
dbus_bool_t _dbus_list_remove(DBusList **list, void *data)
Removes a value from the list.
Definition: dbus-list.c:415
void dbus_connection_set_max_received_size(DBusConnection *connection, long size)
Sets the maximum total number of bytes that can be used for all messages received on this connection...
DBusDispatchStatusFunction dispatch_status_function
Function on dispatch status changes.
DBusHandlerResult
Results that a message handler can return.
Definition: dbus-shared.h:66
Hash keys are strings.
Definition: dbus-hash.h:69
DBusMessage * _dbus_connection_get_message_to_send(DBusConnection *connection)
Gets the next outgoing message.
DBusList * _dbus_list_pop_first_link(DBusList **list)
Removes the first link in the list and returns it.
Definition: dbus-list.c:628
Hash iterator object.
Definition: dbus-hash.h:49
DBusMessageIter struct; contains no public fields.
Definition: dbus-message.h:51
void dbus_connection_steal_borrowed_message(DBusConnection *connection, DBusMessage *message)
Used to keep a message after peeking at it using dbus_connection_borrow_message().
void * _dbus_list_get_first(DBusList **list)
Gets the first data in the list.
Definition: dbus-list.c:612
dbus_bool_t _dbus_pending_call_get_completed_unlocked(DBusPendingCall *pending)
Checks whether the pending call has received a reply yet, or not.
#define _dbus_list_get_next_link(list, link)
Gets the next link in the list, or NULL if there are no more links.
Definition: dbus-list.h:116
void dbus_connection_free_data_slot(dbus_int32_t *slot_p)
Deallocates a global ID for connection data slots.
#define DBUS_ERROR_UNKNOWN_METHOD
Method name you invoked isn&#39;t known by the object you invoked it on.
const char * dbus_message_get_destination(DBusMessage *message)
Gets the destination of a message or NULL if there is none set.
Internal struct representing a message filter function.
void _dbus_message_add_counter_link(DBusMessage *message, DBusList *link)
Adds a counter to be incremented immediately with the size/unix fds of this message, and decremented by the size/unix fds of this message when this message if finalized.
Definition: dbus-message.c:303
#define DBUS_PATH_LOCAL
The object path used in local/in-process-generated messages.
Definition: dbus-shared.h:82
void(* DBusRemoveTimeoutFunction)(DBusTimeout *timeout, void *data)
Called when libdbus no longer needs a timeout to be monitored by the main loop.
dbus_bool_t _dbus_list_copy(DBusList **list, DBusList **dest)
Copies a list.
Definition: dbus-list.c:697
void _dbus_connection_block_pending_call(DBusPendingCall *pending)
Blocks until a pending call times out or gets a reply.
DBusWatchList * watches
Stores active watches.
DBusRMutex * mutex
Lock on the entire DBusConnection.
dbus_bool_t _dbus_transport_get_is_connected(DBusTransport *transport)
Returns TRUE if the transport has not been disconnected.
dbus_bool_t _dbus_watch_list_set_functions(DBusWatchList *watch_list, DBusAddWatchFunction add_function, DBusRemoveWatchFunction remove_function, DBusWatchToggledFunction toggled_function, void *data, DBusFreeFunction free_data_function)
Sets the watch functions.
Definition: dbus-watch.c:296
dbus_bool_t _dbus_hash_table_remove_int(DBusHashTable *table, int key)
Removes the hash entry for the given key.
Definition: dbus-hash.c:1161
int _dbus_connection_get_pending_fds_count(DBusConnection *connection)
Return how many file descriptors are pending in the loader.
dbus_bool_t dbus_message_set_error_name(DBusMessage *message, const char *error_name)
Sets the name of the error (DBUS_MESSAGE_TYPE_ERROR).
There is more data to potentially convert to messages.
Socket interface.
Definition: dbus-sysdeps.h:149
DBusMessage * dbus_connection_send_with_reply_and_block(DBusConnection *connection, DBusMessage *message, int timeout_milliseconds, DBusError *error)
Sends a message and blocks a certain time period while waiting for a reply.
DBusConnection * dbus_connection_open_private(const char *address, DBusError *error)
Opens a new, dedicated connection to a remote address.
DBusAtomic refcount
Reference count.
const char * dbus_message_get_member(DBusMessage *message)
Gets the interface member being invoked (DBUS_MESSAGE_TYPE_METHOD_CALL) or emitted (DBUS_MESSAGE_TYPE...
DBusPreallocatedSend * dbus_connection_preallocate_send(DBusConnection *connection)
Preallocates resources needed to send a message, allowing the message to be sent without the possibil...
Virtual table that must be implemented to handle a portion of the object path hierarchy.
Internals of DBusMessage.
dbus_bool_t _dbus_pending_call_set_timeout_error_unlocked(DBusPendingCall *pending, DBusMessage *message, dbus_uint32_t serial)
Sets the reply message associated with the pending call to a timeout error.
dbus_bool_t dbus_pending_call_get_completed(DBusPendingCall *pending)
Checks whether the pending call has received a reply yet, or not.
const char * dbus_address_entry_get_value(DBusAddressEntry *entry, const char *key)
Returns a value from a key of an entry.
Definition: dbus-address.c:244
long _dbus_transport_get_max_received_unix_fds(DBusTransport *transport)
See dbus_connection_set_max_received_unix_fds().
Hash keys are integers.
Definition: dbus-hash.h:70
DBUS_PRIVATE_EXPORT void _dbus_rmutex_unlock(DBusRMutex *mutex)
Unlocks a mutex.
Definition: dbus-threads.c:150
#define DBUS_ERROR_OBJECT_PATH_IN_USE
There&#39;s already an object with the requested object path.
#define dbus_new0(type, count)
Safe macro for using dbus_malloc0().
Definition: dbus-memory.h:59
int _dbus_hash_table_get_n_entries(DBusHashTable *table)
Gets the number of hash entries in a hash table.
Definition: dbus-hash.c:1407
dbus_bool_t _dbus_timeout_list_add_timeout(DBusTimeoutList *timeout_list, DBusTimeout *timeout)
Adds a new timeout to the timeout list, invoking the application DBusAddTimeoutFunction if appropriat...
Definition: dbus-timeout.c:314
void _dbus_transport_set_windows_user_function(DBusTransport *transport, DBusAllowWindowsUserFunction function, void *data, DBusFreeFunction free_data_function, void **old_data, DBusFreeFunction *old_free_data_function)
See dbus_connection_set_windows_user_function().
void _dbus_connection_remove_watch_unlocked(DBusConnection *connection, DBusWatch *watch)
Removes a watch using the connection&#39;s DBusRemoveWatchFunction if available.
dbus_bool_t _dbus_transport_get_adt_audit_session_data(DBusTransport *transport, void **data, int *data_size)
See dbus_connection_get_adt_audit_session_data().
dbus_bool_t _dbus_pending_call_is_timeout_added_unlocked(DBusPendingCall *pending)
Checks to see if a timeout has been added.
void * _dbus_hash_iter_get_value(DBusHashIter *iter)
Gets the value of the current entry.
Definition: dbus-hash.c:613
void * dispatch_status_data
Application data for dispatch_status_function.
dbus_uint32_t dbus_bool_t
A boolean, valid values are TRUE and FALSE.
Definition: dbus-types.h:35
dbus_bool_t _dbus_connection_has_messages_to_send_unlocked(DBusConnection *connection)
Checks whether there are messages in the outgoing message queue.
void dbus_connection_set_exit_on_disconnect(DBusConnection *connection, dbus_bool_t exit_on_disconnect)
Set whether _exit() should be called when the connection receives a disconnect signal.
dbus_bool_t dbus_message_is_signal(DBusMessage *message, const char *iface, const char *signal_name)
Checks whether the message is a signal with the given interface and member fields.
DBusTransport * transport
Object that sends/receives messages over network.
DBusDispatchStatus dbus_connection_dispatch(DBusConnection *connection)
Processes any incoming data.
dbus_bool_t dbus_connection_send(DBusConnection *connection, DBusMessage *message, dbus_uint32_t *serial)
Adds a message to the outgoing message queue.
dbus_bool_t _dbus_transport_peek_is_authenticated(DBusTransport *transport)
Returns TRUE if we have been authenticated.
DBusDispatchStatus dbus_connection_get_dispatch_status(DBusConnection *connection)
Gets the current state of the incoming message queue.
All currently available data has been processed.
dbus_bool_t(* DBusAddTimeoutFunction)(DBusTimeout *timeout, void *data)
Called when libdbus needs a new timeout to be monitored by the main loop.
void * dbus_connection_get_data(DBusConnection *connection, dbus_int32_t slot)
Retrieves data previously set with dbus_connection_set_data().
DBusTimeoutList * timeouts
Stores active timeouts.
dbus_bool_t _dbus_object_tree_list_registered_and_unlock(DBusObjectTree *tree, const char **parent_path, char ***child_entries)
Lists the registered fallback handlers and object path handlers at the given parent_path.
dbus_bool_t(* DBusTimeoutAddFunction)(DBusTimeoutList *list, DBusTimeout *timeout)
Function to be called in protected_change_timeout() with refcount held.
long dbus_connection_get_max_message_size(DBusConnection *connection)
Gets the value set by dbus_connection_set_max_message_size().
DBusHashTable * pending_replies
Hash of message serials to DBusPendingCall.
Internals of DBusObjectTree.
void _dbus_warn(const char *format,...)
Prints a warning message to stderr.
void _dbus_counter_unref(DBusCounter *counter)
Decrements refcount of the counter and possibly finalizes the counter.
dbus_int32_t _dbus_atomic_inc(DBusAtomic *atomic)
Atomically increments an integer.
void _dbus_message_remove_counter(DBusMessage *message, DBusCounter *counter)
Removes a counter tracking the size/unix fds of this message, and decrements the counter by the size/...
Definition: dbus-message.c:375
dbus_bool_t _dbus_list_append(DBusList **list, void *data)
Appends a value to the list.
Definition: dbus-list.c:270
dbus_bool_t _dbus_decompose_path(const char *data, int len, char ***path, int *path_len)
Decompose an object path.
dbus_bool_t _dbus_hash_table_insert_string(DBusHashTable *table, char *key, void *value)
Creates a hash entry with the given key and value.
Definition: dbus-hash.c:1224
dbus_bool_t dbus_connection_get_unix_process_id(DBusConnection *connection, unsigned long *pid)
Gets the process ID of the connection if any.
dbus_bool_t dbus_connection_get_is_authenticated(DBusConnection *connection)
Gets whether the connection was authenticated.
void dbus_connection_close(DBusConnection *connection)
Closes a private connection, so no further data can be sent or received.
dbus_bool_t dbus_connection_allocate_data_slot(dbus_int32_t *slot_p)
Allocates an integer ID to be used for storing application-specific data on any DBusConnection.
dbus_bool_t(* DBusAllowUnixUserFunction)(DBusConnection *connection, unsigned long uid, void *data)
Called during authentication to check whether the given UNIX user ID is allowed to connect...
dbus_bool_t _dbus_data_slot_list_set(DBusDataSlotAllocator *allocator, DBusDataSlotList *list, int slot, void *data, DBusFreeFunction free_data_func, DBusFreeFunction *old_free_func, void **old_data)
Stores a pointer in the data slot list, along with an optional function to be used for freeing the da...
dbus_bool_t io_path_acquired
Someone has transport io path (can use the transport to read/write messages)
void _dbus_list_foreach(DBusList **list, DBusForeachFunction function, void *data)
Calls the given function for each element in the list.
Definition: dbus-list.c:759
void(* DBusWakeupMainFunction)(void *data)
Called when the main loop&#39;s thread should be notified that there&#39;s now work to do.
dbus_bool_t _dbus_string_append_printf(DBusString *str, const char *format,...)
Appends a printf-style formatted string to the DBusString.
Definition: dbus-string.c:1114
Internals of DBusAddressEntry.
Definition: dbus-address.c:43
DBusList * outgoing_messages
Queue of messages we need to send, send the end of the list first.
dbus_bool_t dbus_connection_register_object_path(DBusConnection *connection, const char *path, const DBusObjectPathVTable *vtable, void *user_data)
Registers a handler for a given path in the object hierarchy.
void dbus_connection_set_max_message_unix_fds(DBusConnection *connection, long n)
Specifies the maximum number of unix fds a message on this connection is allowed to receive...
DBusObjectTree * objects
Object path handlers registered with this connection.
long dbus_connection_get_outgoing_unix_fds(DBusConnection *connection)
Gets the approximate number of uni fds of all messages in the outgoing message queue.
void(* DBusWatchRemoveFunction)(DBusWatchList *list, DBusWatch *watch)
Function to be called in protected_change_watch() with refcount held.
dbus_uint32_t client_serial
Client serial.
long dbus_connection_get_max_received_size(DBusConnection *connection)
Gets the value set by dbus_connection_set_max_received_size().
DBusCMutex * io_path_mutex
Protects io_path_acquired.
#define DBUS_MESSAGE_TYPE_METHOD_CALL
Message type of a method call message, see dbus_message_get_type()
DBusConnection * dbus_connection_open(const char *address, DBusError *error)
Gets a connection to a remote address.
void _dbus_connection_unref_unlocked(DBusConnection *connection)
Decrements the reference count of a DBusConnection.
dbus_bool_t _dbus_connection_handle_watch(DBusWatch *watch, unsigned int condition, void *data)
A callback for use with dbus_watch_new() to create a DBusWatch.
int _dbus_current_generation
_dbus_current_generation is used to track each time that dbus_shutdown() is called, so we can reinit things after it&#39;s been called.
Definition: dbus-memory.c:782
dbus_bool_t dbus_connection_send_with_reply(DBusConnection *connection, DBusMessage *message, DBusPendingCall **pending_return, int timeout_milliseconds)
Queues a message to send, as with dbus_connection_send(), but also returns a DBusPendingCall used to ...
Object representing an exception.
Definition: dbus-errors.h:48
void _dbus_hash_iter_remove_entry(DBusHashIter *iter)
Removes the current entry from the hash table.
Definition: dbus-hash.c:592
void _dbus_bus_notify_shared_connection_disconnected_unlocked(DBusConnection *connection)
Internal function that checks to see if this is a shared connection owned by the bus and if it is unr...
Definition: dbus-bus.c:387
void _dbus_get_monotonic_time(long *tv_sec, long *tv_usec)
Get current time, as in gettimeofday().
void _dbus_disable_sigpipe(void)
signal (SIGPIPE, SIG_IGN);
dbus_bool_t _dbus_transport_get_is_anonymous(DBusTransport *transport)
See dbus_connection_get_is_anonymous().
void * _dbus_list_pop_first(DBusList **list)
Removes the first value in the list and returns it.
Definition: dbus-list.c:649
dbus_bool_t dbus_connection_get_object_path_data(DBusConnection *connection, const char *path, void **data_p)
Gets the user data passed to dbus_connection_register_object_path() or dbus_connection_register_fallb...
dbus_bool_t dbus_message_append_args(DBusMessage *message, int first_arg_type,...)
Appends fields to a message given a variable argument list.
#define DBUS_ERROR_UNKNOWN_OBJECT
Object you invoked a method on isn&#39;t known.
dbus_bool_t dbus_connection_get_is_anonymous(DBusConnection *connection)
Gets whether the connection is not authenticated as a specific user.
#define DBUS_MESSAGE_TYPE_SIGNAL
Message type of a signal message, see dbus_message_get_type()
dbus_bool_t _dbus_connection_add_watch_unlocked(DBusConnection *connection, DBusWatch *watch)
Adds a watch using the connection&#39;s DBusAddWatchFunction if available.
void dbus_set_error(DBusError *error, const char *name, const char *format,...)
Assigns an error name and message to a DBusError.
Definition: dbus-errors.c:354
dbus_uint32_t dbus_message_get_reply_serial(DBusMessage *message)
Returns the serial that the message is a reply to or 0 if none.
long dbus_connection_get_max_message_unix_fds(DBusConnection *connection)
Gets the value set by dbus_connection_set_max_message_unix_fds().
DBusWakeupMainFunction wakeup_main_function
Function to wake up the mainloop.
dbus_bool_t _dbus_connection_send_and_unlock(DBusConnection *connection, DBusMessage *message, dbus_uint32_t *client_serial)
Like dbus_connection_send(), but assumes the connection is already locked on function entry...
void _dbus_cmutex_unlock(DBusCMutex *mutex)
Unlocks a mutex.
Definition: dbus-threads.c:164
dbus_bool_t(* DBusAllowWindowsUserFunction)(DBusConnection *connection, const char *user_sid, void *data)
Called during authentication to check whether the given Windows user ID is allowed to connect...
DBusDataSlotList slot_list
Data stored by allocated integer ID.
DBusPendingCall * dbus_pending_call_ref(DBusPendingCall *pending)
Increments the reference count on a pending call.
void _dbus_connection_message_sent_unlocked(DBusConnection *connection, DBusMessage *message)
Notifies the connection that a message has been sent, so the message can be removed from the outgoing...
void _dbus_timeout_list_toggle_timeout(DBusTimeoutList *timeout_list, DBusTimeout *timeout, dbus_bool_t enabled)
Sets a timeout to the given enabled state, invoking the application&#39;s DBusTimeoutToggledFunction if a...
Definition: dbus-timeout.c:366
dbus_uint32_t _dbus_pending_call_get_reply_serial_unlocked(DBusPendingCall *pending)
Gets the reply&#39;s serial number.
DBusTransport * _dbus_transport_open(DBusAddressEntry *entry, DBusError *error)
Try to open a new transport for the given address entry.
DBusConnection * _dbus_connection_new_for_transport(DBusTransport *transport)
Creates a new connection for the given transport.
#define _DBUS_UNLOCK(name)
Unlocks a global lock.
unsigned int disconnected_message_arrived
We popped or are dispatching the disconnected message.
void _dbus_string_free(DBusString *str)
Frees a string created by _dbus_string_init().
Definition: dbus-string.c:259
void dbus_connection_set_allow_anonymous(DBusConnection *connection, dbus_bool_t value)
This function must be called on the server side of a connection when the connection is first seen in ...
unsigned int disconnected_message_processed
We did our default handling of the disconnected message, such as closing the connection.
dbus_bool_t _dbus_transport_get_unix_user(DBusTransport *transport, unsigned long *uid)
See dbus_connection_get_unix_user().
void * _dbus_data_slot_list_get(DBusDataSlotAllocator *allocator, DBusDataSlotList *list, int slot)
Retrieves data previously set with _dbus_data_slot_list_set_data().
#define CONNECTION_UNLOCK(connection)
shorter and more visible way to write _dbus_connection_unlock()
void(* DBusTimeoutToggledFunction)(DBusTimeout *timeout, void *data)
Called when dbus_timeout_get_enabled() may return a different value than it did before.
unsigned int route_peer_messages
If TRUE, if org.freedesktop.DBus.Peer messages have a bus name, don&#39;t handle them automatically...
#define TRUE
Expands to "1".
void _dbus_connection_set_pending_fds_function(DBusConnection *connection, DBusPendingFdsChangeFunction callback, void *data)
Register a function to be called whenever the number of pending file descriptors in the loader change...
void _dbus_data_slot_list_init(DBusDataSlotList *list)
Initializes a slot list.
#define _dbus_assert_not_reached(explanation)
Aborts with an error message if called.
Data structure that stores the actual user data set at a given slot.
Definition: dbus-dataslot.h:69
DBusCondVar * io_path_cond
Notify when io_path_acquired is available.
void(* DBusTimeoutToggleFunction)(DBusTimeoutList *list, DBusTimeout *timeout, dbus_bool_t enabled)
Function to be called in protected_change_timeout() with refcount held.
void _dbus_condvar_new_at_location(DBusCondVar **location_p)
This does the same thing as _dbus_condvar_new.
Definition: dbus-threads.c:199
DBusDispatchStatus last_dispatch_status
The last dispatch status we reported to the application.
unsigned int exit_on_disconnect
If TRUE, exit after handling disconnect signal.
dbus_bool_t _dbus_transport_set_connection(DBusTransport *transport, DBusConnection *connection)
Sets the connection using this transport.
#define DBUS_ERROR_FAILED
A generic error; "something went wrong" - see the error message for more.
dbus_bool_t _dbus_watch_list_add_watch(DBusWatchList *watch_list, DBusWatch *watch)
Adds a new watch to the watch list, invoking the application DBusAddWatchFunction if appropriate...
Definition: dbus-watch.c:382
void _dbus_list_free_link(DBusList *link)
Frees a linked list node allocated with _dbus_list_alloc_link.
Definition: dbus-list.c:254
void dbus_move_error(DBusError *src, DBusError *dest)
Moves an error src into dest, freeing src and overwriting dest.
Definition: dbus-errors.c:279
const char * name
public error name field
Definition: dbus-errors.h:50
void * _dbus_object_tree_get_user_data_unlocked(DBusObjectTree *tree, const char **path)
Looks up the data passed to _dbus_object_tree_register() for a handler at the given path...
dbus_bool_t _dbus_object_tree_register(DBusObjectTree *tree, dbus_bool_t fallback, const char **path, const DBusObjectPathVTable *vtable, void *user_data, DBusError *error)
Registers a new subtree in the global object tree.
dbus_bool_t dbus_set_error_from_message(DBusError *error, DBusMessage *message)
Sets a DBusError based on the contents of the given message.
dbus_bool_t(* DBusAddWatchFunction)(DBusWatch *watch, void *data)
Called when libdbus needs a new watch to be monitored by the main loop.
void _dbus_condvar_wake_one(DBusCondVar *cond)
If there are threads waiting on the condition variable, wake up exactly one.
Definition: dbus-threads.c:278
#define DBUS_TYPE_UNIX_FD
Type code marking a unix file descriptor.
void(* DBusWatchToggleFunction)(DBusWatchList *list, DBusWatch *watch, dbus_bool_t enabled)
Function to be called in protected_change_watch() with refcount held.
void dbus_pending_call_unref(DBusPendingCall *pending)
Decrements the reference count on a pending call, freeing it if the count reaches 0...
Object representing a transport such as a socket.
void(* DBusRemoveWatchFunction)(DBusWatch *watch, void *data)
Called when libdbus no longer needs a watch to be monitored by the main loop.
DBusWatchList implementation details.
Definition: dbus-watch.c:214
const char * dbus_message_get_interface(DBusMessage *message)
Gets the interface this message is being sent to (for DBUS_MESSAGE_TYPE_METHOD_CALL) or being emitted...
int n_incoming
Length of incoming queue.
void dbus_connection_set_wakeup_main_function(DBusConnection *connection, DBusWakeupMainFunction wakeup_main_function, void *data, DBusFreeFunction free_data_function)
Sets the mainloop wakeup function for the connection.
DBusMessage * dbus_connection_pop_message(DBusConnection *connection)
Returns the first-received message from the incoming message queue, removing it from the queue...
An allocator that tracks a set of slot IDs.
Definition: dbus-dataslot.h:55
#define DBUS_TYPE_INVALID
Type code that is never equal to a legitimate type code.
Definition: dbus-protocol.h:60
dbus_bool_t dbus_message_set_reply_serial(DBusMessage *message, dbus_uint32_t reply_serial)
Sets the reply serial of a message (the serial of the message this is a reply to).
void _dbus_exit(int code)
Exit the process, returning the given value.
void _dbus_pending_call_queue_timeout_error_unlocked(DBusPendingCall *pending, DBusConnection *connection)
If the pending call hasn&#39;t been timed out, add its timeout error reply to the connection&#39;s incoming m...
Internals of DBusPreallocatedSend.
void dbus_connection_set_unix_user_function(DBusConnection *connection, DBusAllowUnixUserFunction function, void *data, DBusFreeFunction free_data_function)
Sets a predicate function used to determine whether a given user ID is allowed to connect...
void(* DBusDispatchStatusFunction)(DBusConnection *connection, DBusDispatchStatus new_status, void *data)
Called when the return value of dbus_connection_get_dispatch_status() may have changed.
dbus_bool_t _dbus_transport_handle_watch(DBusTransport *transport, DBusWatch *watch, unsigned int condition)
Handles a watch by reading data, writing data, or disconnecting the transport, as appropriate for the...
DBusList * counter_link
Preallocated link in the resource counter.
DBusObjectTree * _dbus_object_tree_new(DBusConnection *connection)
Creates a new object tree, representing a mapping from paths to handler vtables.
void _dbus_watch_list_remove_watch(DBusWatchList *watch_list, DBusWatch *watch)
Removes a watch from the watch list, invoking the application&#39;s DBusRemoveWatchFunction if appropriat...
Definition: dbus-watch.c:415
void dbus_pending_call_block(DBusPendingCall *pending)
Block until the pending call is completed.
dbus_bool_t _dbus_hash_table_remove_string(DBusHashTable *table, const char *key)
Removes the hash entry for the given key.
Definition: dbus-hash.c:1133
void _dbus_timeout_list_remove_timeout(DBusTimeoutList *timeout_list, DBusTimeout *timeout)
Removes a timeout from the timeout list, invoking the application&#39;s DBusRemoveTimeoutFunction if appr...
Definition: dbus-timeout.c:344
int n_outgoing
Length of outgoing queue.
DBusCMutex * dispatch_mutex
Protects dispatch_acquired.
DBUS_PRIVATE_EXPORT DBusPendingCall * _dbus_pending_call_new_unlocked(DBusConnection *connection, int timeout_milliseconds, DBusTimeoutHandler timeout_handler)
Creates a new pending reply object.
dbus_int32_t _dbus_atomic_dec(DBusAtomic *atomic)
Atomically decrement an integer.
void _dbus_pending_call_set_reply_unlocked(DBusPendingCall *pending, DBusMessage *message)
Sets the reply of a pending call with the given message, or if the message is NULL, by timing out the pending call.
void(* DBusTimeoutRemoveFunction)(DBusTimeoutList *list, DBusTimeout *timeout)
Function to be called in protected_change_timeout() with refcount held.
A node in a linked list.
Definition: dbus-list.h:34
dbus_bool_t dbus_connection_set_watch_functions(DBusConnection *connection, DBusAddWatchFunction add_function, DBusRemoveWatchFunction remove_function, DBusWatchToggledFunction toggled_function, void *data, DBusFreeFunction free_data_function)
Sets the watch functions for the connection.
void _dbus_hash_iter_init(DBusHashTable *table, DBusHashIter *iter)
Initializes a hash table iterator.
Definition: dbus-hash.c:517
void _dbus_list_unlink(DBusList **list, DBusList *link)
Removes the given link from the list, but doesn&#39;t free it.
Definition: dbus-list.c:499
void dbus_free_string_array(char **str_array)
Frees a NULL-terminated array of strings.
Definition: dbus-memory.c:750
DBusHandlerResult(* DBusHandleMessageFunction)(DBusConnection *connection, DBusMessage *message, void *user_data)
Called when a message needs to be handled.
DBusTransport * _dbus_transport_ref(DBusTransport *transport)
Increments the reference count for the transport.
dbus_bool_t _dbus_transport_try_to_authenticate(DBusTransport *transport)
Returns TRUE if we have been authenticated.
DBusCondVar * dispatch_cond
Notify when dispatch_acquired is available.
void _dbus_connection_remove_timeout_unlocked(DBusConnection *connection, DBusTimeout *timeout)
Removes a timeout using the connection&#39;s DBusRemoveTimeoutFunction if available.
dbus_bool_t dbus_connection_register_fallback(DBusConnection *connection, const char *path, const DBusObjectPathVTable *vtable, void *user_data)
Registers a fallback handler for a given subsection of the object hierarchy.
void _dbus_rmutex_free_at_location(DBusRMutex **location_p)
Frees a DBusRMutex; does nothing if passed a NULL pointer.
Definition: dbus-threads.c:94
void _dbus_transport_do_iteration(DBusTransport *transport, unsigned int flags, int timeout_milliseconds)
Performs a single poll()/select() on the transport&#39;s file descriptors and then reads/writes data as a...
long _dbus_transport_get_max_received_size(DBusTransport *transport)
See dbus_connection_get_max_received_size().
dbus_bool_t dbus_connection_get_adt_audit_session_data(DBusConnection *connection, void **data, dbus_int32_t *data_size)
Gets the ADT audit data of the connection if any.
long _dbus_transport_get_max_message_unix_fds(DBusTransport *transport)
See dbus_connection_get_max_message_unix_fds().
void * _dbus_hash_table_lookup_string(DBusHashTable *table, const char *key)
Looks up the value for a given string in a hash table of type DBUS_HASH_STRING.
Definition: dbus-hash.c:1059
void * _dbus_hash_table_lookup_int(DBusHashTable *table, int key)
Looks up the value for a given integer in a hash table of type DBUS_HASH_INT.
Definition: dbus-hash.c:1084
void _dbus_transport_set_pending_fds_function(DBusTransport *transport, void(*callback)(void *), void *data)
Register a function to be called whenever the number of pending file descriptors in the loader change...
#define DBUS_ERROR_DISCONNECTED
The connection is disconnected and you&#39;re trying to use it.
DBusCounter * _dbus_counter_new(void)
Creates a new DBusCounter.
void _dbus_cmutex_lock(DBusCMutex *mutex)
Locks a mutex.
Definition: dbus-threads.c:136
void _dbus_connection_queue_received_message_link(DBusConnection *connection, DBusList *link)
Adds a message-containing list link to the incoming message queue, taking ownership of the link and t...
void _dbus_transport_set_allow_anonymous(DBusTransport *transport, dbus_bool_t value)
See dbus_connection_set_allow_anonymous()
void _dbus_connection_close_possibly_shared(DBusConnection *connection)
Closes a shared OR private connection, while dbus_connection_close() can only be used on private conn...
DBusHandleMessageFunction function
Function to call to filter.
#define DBUS_ERROR_NO_MEMORY
There was not enough memory to complete an operation.
void _dbus_connection_remove_pending_call(DBusConnection *connection, DBusPendingCall *pending)
Removes a pending call from the connection, such that the pending reply will be ignored.
dbus_bool_t dbus_message_iter_append_basic(DBusMessageIter *iter, int type, const void *value)
Appends a basic-typed value to the message.
void _dbus_transport_set_max_received_size(DBusTransport *transport, long size)
See dbus_connection_set_max_received_size().
void(* DBusForeachFunction)(void *element, void *data)
Used to iterate over each item in a collection, such as a DBusList.
DBusList * expired_messages
Messages that will be released when we next unlock.
DBusList * _dbus_list_get_first_link(DBusList **list)
Gets the first link in the list.
Definition: dbus-list.c:567
#define FALSE
Expands to "0".
int dbus_message_get_type(DBusMessage *message)
Gets the type of a message.
char * dbus_connection_get_server_id(DBusConnection *connection)
Gets the ID of the server address we are authenticated to, if this connection is on the client side...
dbus_bool_t dbus_connection_get_unix_fd(DBusConnection *connection, int *fd)
Get the UNIX file descriptor of the connection, if any.
int _dbus_transport_get_pending_fds_count(DBusTransport *transport)
Return how many file descriptors are pending in the loader.
void _dbus_list_prepend_link(DBusList **list, DBusList *link)
Prepends a link to the list.
Definition: dbus-list.c:333
DBUS_PRIVATE_EXPORT dbus_bool_t _dbus_register_shutdown_func(DBusShutdownFunction function, void *data)
Register a cleanup function to be called exactly once the next time dbus_shutdown() is called...
Definition: dbus-memory.c:811
#define _DBUS_LOCK(name)
Locks a global lock, initializing it first if necessary.
#define _DBUS_LOCK_NAME(name)
Expands to name of a global lock variable.
dbus_bool_t _dbus_transport_can_pass_unix_fd(DBusTransport *transport)
Returns TRUE if the transport supports sending unix fds.
void _dbus_cmutex_free_at_location(DBusCMutex **location_p)
Frees a DBusCMutex; does nothing if passed a NULL pointer.
Definition: dbus-threads.c:107
char * server_guid
GUID of server if we are in shared_connections, NULL if server GUID is unknown or connection is priva...
dbus_bool_t dbus_connection_get_is_connected(DBusConnection *connection)
Gets whether the connection is currently open.
void dbus_connection_send_preallocated(DBusConnection *connection, DBusPreallocatedSend *preallocated, DBusMessage *message, dbus_uint32_t *client_serial)
Sends a message using preallocated resources.
void dbus_connection_unref(DBusConnection *connection)
Decrements the reference count of a DBusConnection, and finalizes it if the count reaches zero...
dbus_int32_t _dbus_atomic_get(DBusAtomic *atomic)
Atomically get the value of an integer.
Internals of DBusHashTable.
Definition: dbus-hash.c:168
void _dbus_sleep_milliseconds(int milliseconds)
Sleeps the given number of milliseconds.
void _dbus_object_tree_unref(DBusObjectTree *tree)
Decrement the reference count.
dbus_bool_t _dbus_data_slot_allocator_alloc(DBusDataSlotAllocator *allocator, dbus_int32_t *slot_id_p)
Allocates an integer ID to be used for storing data in a DBusDataSlotList.
Definition: dbus-dataslot.c:69
DBUS_PRIVATE_EXPORT DBusPendingCall * _dbus_pending_call_ref_unlocked(DBusPendingCall *pending)
Increments the reference count on a pending call, while the lock on its connection is already held...
DBusMessage * dbus_connection_borrow_message(DBusConnection *connection)
Returns the first-received message from the incoming message queue, leaving it in the queue...
DBusConnection * _dbus_connection_ref_unlocked(DBusConnection *connection)
Increments the reference count of a DBusConnection.
Message has had its effect - no need to run more handlers.
Definition: dbus-shared.h:68
void _dbus_connection_do_iteration_unlocked(DBusConnection *connection, DBusPendingCall *pending, unsigned int flags, int timeout_milliseconds)
Queues incoming messages and sends outgoing messages for this connection, optionally blocking in the ...
char * _dbus_strdup(const char *str)
Duplicates a string.
#define CONNECTION_LOCK(connection)
Internals of DBusPendingCall.
dbus_bool_t dispatch_acquired
Someone has dispatch path (can drain incoming queue)
void _dbus_transport_disconnect(DBusTransport *transport)
Closes our end of the connection to a remote application.
DBusTimeout * _dbus_pending_call_get_timeout_unlocked(DBusPendingCall *pending)
Retrives the timeout.
void _dbus_data_slot_allocator_free(DBusDataSlotAllocator *allocator, dbus_int32_t *slot_id_p)
Deallocates an ID previously allocated with _dbus_data_slot_allocator_alloc().
dbus_bool_t dbus_connection_add_filter(DBusConnection *connection, DBusHandleMessageFunction function, void *user_data, DBusFreeFunction free_data_function)
Adds a message filter.
dbus_bool_t dbus_connection_unregister_object_path(DBusConnection *connection, const char *path)
Unregisters the handler registered with exactly the given path.
long dbus_connection_get_max_received_unix_fds(DBusConnection *connection)
Gets the value set by dbus_connection_set_max_received_unix_fds().
dbus_bool_t dbus_connection_try_register_object_path(DBusConnection *connection, const char *path, const DBusObjectPathVTable *vtable, void *user_data, DBusError *error)
Registers a handler for a given path in the object hierarchy.
void _dbus_connection_unlock(DBusConnection *connection)
Releases the connection lock.
const char * dbus_message_type_to_string(int type)
Utility function to convert a D-Bus message type into a machine-readable string (not translated)...
void _dbus_transport_set_max_message_size(DBusTransport *transport, long size)
See dbus_connection_set_max_message_size().
void dbus_message_unref(DBusMessage *message)
Decrements the reference count of a DBusMessage, freeing the message if the count reaches 0...
void * wakeup_main_data
Application data for wakeup_main_function.
Need more memory in order to return DBUS_HANDLER_RESULT_HANDLED or DBUS_HANDLER_RESULT_NOT_YET_HANDLE...
Definition: dbus-shared.h:70
void dbus_connection_flush(DBusConnection *connection)
Blocks until the outgoing message queue is empty.
void _dbus_condvar_free_at_location(DBusCondVar **location_p)
Frees a condition variable; does nothing if passed a NULL pointer.
Definition: dbus-threads.c:224
dbus_bool_t dbus_connection_has_messages_to_send(DBusConnection *connection)
Checks whether there are messages in the outgoing message queue.
void _dbus_cmutex_new_at_location(DBusCMutex **location_p)
Creates a new mutex or creates a no-op mutex if threads are not initialized.
Definition: dbus-threads.c:77
DBUS_PRIVATE_EXPORT void _dbus_pending_call_unref_and_unlock(DBusPendingCall *pending)
Decrements the reference count on a pending call, freeing it if the count reaches 0...
DBusDispatchStatus _dbus_transport_get_dispatch_status(DBusTransport *transport)
Reports our current dispatch status (whether there&#39;s buffered data to be queued as messages...
void _dbus_pending_call_set_timeout_added_unlocked(DBusPendingCall *pending, dbus_bool_t is_added)
Sets wether the timeout has been added.
DBusConnection * connection
Connection we&#39;d send the message to.
DBusConnection * _dbus_pending_call_get_connection_and_lock(DBusPendingCall *pending)
Gets the connection associated with this pending call.
void _dbus_connection_toggle_timeout_unlocked(DBusConnection *connection, DBusTimeout *timeout, dbus_bool_t enabled)
Toggles a timeout and notifies app via connection&#39;s DBusTimeoutToggledFunction if available...
dbus_bool_t dbus_type_is_valid(int typecode)
Return TRUE if the argument is a valid typecode.
void _dbus_transport_set_max_message_unix_fds(DBusTransport *transport, long n)
See dbus_connection_set_max_message_unix_fds().
void dbus_connection_set_max_received_unix_fds(DBusConnection *connection, long n)
Sets the maximum total number of unix fds that can be used for all messages received on this connecti...
DBusHashTable * _dbus_hash_table_new(DBusHashType type, DBusFreeFunction key_free_function, DBusFreeFunction value_free_function)
Constructs a new hash table.
Definition: dbus-hash.c:285
dbus_bool_t dbus_connection_get_socket(DBusConnection *connection, int *fd)
Gets the underlying Windows or UNIX socket file descriptor of the connection, if any.
void dbus_connection_free_preallocated_send(DBusConnection *connection, DBusPreallocatedSend *preallocated)
Frees preallocated message-sending resources from dbus_connection_preallocate_send().
void dbus_message_set_serial(DBusMessage *message, dbus_uint32_t serial)
Sets the serial number of a message.
Definition: dbus-message.c:277
DBusTimeoutList implementation details.
Definition: dbus-timeout.c:180
dbus_bool_t dbus_parse_address(const char *address, DBusAddressEntry ***entry_result, int *array_len, DBusError *error)
Parses an address string of the form:
Definition: dbus-address.c:363
DBusMessage * dbus_message_new_method_return(DBusMessage *method_call)
Constructs a message that is a reply to a method call.
DBusRMutex * slot_mutex
Lock on slot_list so overall connection lock need not be taken.
void _dbus_transport_unref(DBusTransport *transport)
Decrements the reference count for the transport.
long _dbus_counter_get_unix_fd_value(DBusCounter *counter)
Gets the current value of the unix fd counter.
void _dbus_data_slot_list_free(DBusDataSlotList *list)
Frees the data slot list and all data slots contained in it, calling application-provided free functi...
void _dbus_list_clear(DBusList **list)
Frees all links in the list and sets the list head to NULL.
Definition: dbus-list.c:542
DBUS_EXPORT int dbus_timeout_get_interval(DBusTimeout *timeout)
Gets the timeout interval.
Definition: dbus-timeout.c:444
dbus_bool_t dbus_connection_read_write_dispatch(DBusConnection *connection, int timeout_milliseconds)
This function is intended for use with applications that don&#39;t want to write a main loop and deal wit...
long _dbus_counter_get_size_value(DBusCounter *counter)
Gets the current value of the size counter.
DBusMessage * dbus_message_new_error(DBusMessage *reply_to, const char *error_name, const char *error_message)
Creates a new message that is an error reply to another message.