D-Bus  1.10.24
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  char *error_name,
2188  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  if (error_msg != NULL)
2480  dbus_message_unref (error_msg);
2481  dbus_pending_call_unref (pending);
2482  return;
2483  }
2484  else if (connection->disconnect_message_link == NULL)
2485  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): disconnected\n");
2486  else if (timeout == NULL)
2487  {
2488  if (status == DBUS_DISPATCH_NEED_MEMORY)
2489  {
2490  /* Try sleeping a bit, as we aren't sure we need to block for reading,
2491  * we may already have a reply in the buffer and just can't process
2492  * it.
2493  */
2494  _dbus_verbose ("dbus_connection_send_with_reply_and_block() waiting for more memory\n");
2495 
2496  _dbus_memory_pause_based_on_timeout (timeout_milliseconds - elapsed_milliseconds);
2497  }
2498  else
2499  {
2500  /* block again, we don't have the reply buffered yet. */
2502  pending,
2503  DBUS_ITERATION_DO_READING |
2504  DBUS_ITERATION_BLOCK,
2505  timeout_milliseconds - elapsed_milliseconds);
2506  }
2507 
2508  goto recheck_status;
2509  }
2510  else if (tv_sec < start_tv_sec)
2511  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): clock set backward\n");
2512  else if (elapsed_milliseconds < timeout_milliseconds)
2513  {
2514  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): %d milliseconds remain\n", timeout_milliseconds - elapsed_milliseconds);
2515 
2516  if (status == DBUS_DISPATCH_NEED_MEMORY)
2517  {
2518  /* Try sleeping a bit, as we aren't sure we need to block for reading,
2519  * we may already have a reply in the buffer and just can't process
2520  * it.
2521  */
2522  _dbus_verbose ("dbus_connection_send_with_reply_and_block() waiting for more memory\n");
2523 
2524  _dbus_memory_pause_based_on_timeout (timeout_milliseconds - elapsed_milliseconds);
2525  }
2526  else
2527  {
2528  /* block again, we don't have the reply buffered yet. */
2530  NULL,
2531  DBUS_ITERATION_DO_READING |
2532  DBUS_ITERATION_BLOCK,
2533  timeout_milliseconds - elapsed_milliseconds);
2534  }
2535 
2536  goto recheck_status;
2537  }
2538 
2539  _dbus_verbose ("dbus_connection_send_with_reply_and_block(): Waited %d milliseconds and got no reply\n",
2540  elapsed_milliseconds);
2541 
2543 
2544  /* unlock and call user code */
2545  complete_pending_call_and_unlock (connection, pending, NULL);
2546 
2547  /* update user code on dispatch status */
2548  CONNECTION_LOCK (connection);
2549  status = _dbus_connection_get_dispatch_status_unlocked (connection);
2550  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
2551  dbus_pending_call_unref (pending);
2552 }
2553 
2559 int
2561 {
2562  return _dbus_transport_get_pending_fds_count (connection->transport);
2563 }
2564 
2572 void
2574  DBusPendingFdsChangeFunction callback,
2575  void *data)
2576 {
2578  callback, data);
2579 }
2580 
2618 dbus_connection_open (const char *address,
2619  DBusError *error)
2620 {
2621  DBusConnection *connection;
2622 
2623  _dbus_return_val_if_fail (address != NULL, NULL);
2624  _dbus_return_val_if_error_is_set (error, NULL);
2625 
2626  connection = _dbus_connection_open_internal (address,
2627  TRUE,
2628  error);
2629 
2630  return connection;
2631 }
2632 
2661 dbus_connection_open_private (const char *address,
2662  DBusError *error)
2663 {
2664  DBusConnection *connection;
2665 
2666  _dbus_return_val_if_fail (address != NULL, NULL);
2667  _dbus_return_val_if_error_is_set (error, NULL);
2668 
2669  connection = _dbus_connection_open_internal (address,
2670  FALSE,
2671  error);
2672 
2673  return connection;
2674 }
2675 
2684 {
2685  dbus_int32_t old_refcount;
2686 
2687  _dbus_return_val_if_fail (connection != NULL, NULL);
2688  _dbus_return_val_if_fail (connection->generation == _dbus_current_generation, NULL);
2689  old_refcount = _dbus_atomic_inc (&connection->refcount);
2690  _dbus_connection_trace_ref (connection, old_refcount, old_refcount + 1,
2691  "ref");
2692 
2693  return connection;
2694 }
2695 
2696 static void
2697 free_outgoing_message (void *element,
2698  void *data)
2699 {
2700  DBusMessage *message = element;
2701  DBusConnection *connection = data;
2702 
2703  _dbus_message_remove_counter (message, connection->outgoing_counter);
2704  dbus_message_unref (message);
2705 }
2706 
2707 /* This is run without the mutex held, but after the last reference
2708  * to the connection has been dropped we should have no thread-related
2709  * problems
2710  */
2711 static void
2712 _dbus_connection_last_unref (DBusConnection *connection)
2713 {
2714  DBusList *link;
2715 
2716  _dbus_verbose ("Finalizing connection %p\n", connection);
2717 
2718  _dbus_assert (_dbus_atomic_get (&connection->refcount) == 0);
2719 
2720  /* You have to disconnect the connection before unref:ing it. Otherwise
2721  * you won't get the disconnected message.
2722  */
2724  _dbus_assert (connection->server_guid == NULL);
2725 
2726  /* ---- We're going to call various application callbacks here, hope it doesn't break anything... */
2728 
2733 
2734  _dbus_watch_list_free (connection->watches);
2735  connection->watches = NULL;
2736 
2737  _dbus_timeout_list_free (connection->timeouts);
2738  connection->timeouts = NULL;
2739 
2740  _dbus_data_slot_list_free (&connection->slot_list);
2741 
2742  link = _dbus_list_get_first_link (&connection->filter_list);
2743  while (link != NULL)
2744  {
2745  DBusMessageFilter *filter = link->data;
2746  DBusList *next = _dbus_list_get_next_link (&connection->filter_list, link);
2747 
2748  filter->function = NULL;
2749  _dbus_message_filter_unref (filter); /* calls app callback */
2750  link->data = NULL;
2751 
2752  link = next;
2753  }
2754  _dbus_list_clear (&connection->filter_list);
2755 
2756  /* ---- Done with stuff that invokes application callbacks */
2757 
2758  _dbus_object_tree_unref (connection->objects);
2759 
2761  connection->pending_replies = NULL;
2762 
2763  _dbus_list_clear (&connection->filter_list);
2764 
2765  _dbus_list_foreach (&connection->outgoing_messages,
2766  free_outgoing_message,
2767  connection);
2768  _dbus_list_clear (&connection->outgoing_messages);
2769 
2770  _dbus_list_foreach (&connection->incoming_messages,
2772  NULL);
2773  _dbus_list_clear (&connection->incoming_messages);
2774 
2775  _dbus_counter_unref (connection->outgoing_counter);
2776 
2777  _dbus_transport_unref (connection->transport);
2778 
2779  if (connection->disconnect_message_link)
2780  {
2781  DBusMessage *message = connection->disconnect_message_link->data;
2782  dbus_message_unref (message);
2784  }
2785 
2788 
2791 
2793 
2794  _dbus_rmutex_free_at_location (&connection->mutex);
2795 
2796  dbus_free (connection);
2797 }
2798 
2818 void
2820 {
2821  dbus_int32_t old_refcount;
2822 
2823  _dbus_return_if_fail (connection != NULL);
2824  _dbus_return_if_fail (connection->generation == _dbus_current_generation);
2825 
2826  old_refcount = _dbus_atomic_dec (&connection->refcount);
2827 
2828  _dbus_connection_trace_ref (connection, old_refcount, old_refcount - 1,
2829  "unref");
2830 
2831  if (old_refcount == 1)
2832  {
2833 #ifndef DBUS_DISABLE_CHECKS
2834  if (_dbus_transport_get_is_connected (connection->transport))
2835  {
2836  _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",
2837  connection->shareable ?
2838  "Most likely, the application called unref() too many times and removed a reference belonging to libdbus, since this is a shared connection.\n" :
2839  "Most likely, the application was supposed to call dbus_connection_close(), since this is a private connection.\n");
2840  return;
2841  }
2842 #endif
2843  _dbus_connection_last_unref (connection);
2844  }
2845 }
2846 
2847 /*
2848  * Note that the transport can disconnect itself (other end drops us)
2849  * and in that case this function never runs. So this function must
2850  * not do anything more than disconnect the transport and update the
2851  * dispatch status.
2852  *
2853  * If the transport self-disconnects, then we assume someone will
2854  * dispatch the connection to cause the dispatch status update.
2855  */
2856 static void
2857 _dbus_connection_close_possibly_shared_and_unlock (DBusConnection *connection)
2858 {
2859  DBusDispatchStatus status;
2860 
2861  HAVE_LOCK_CHECK (connection);
2862 
2863  _dbus_verbose ("Disconnecting %p\n", connection);
2864 
2865  /* We need to ref because update_dispatch_status_and_unlock will unref
2866  * the connection if it was shared and libdbus was the only remaining
2867  * refcount holder.
2868  */
2869  _dbus_connection_ref_unlocked (connection);
2870 
2871  _dbus_transport_disconnect (connection->transport);
2872 
2873  /* This has the side effect of queuing the disconnect message link
2874  * (unless we don't have enough memory, possibly, so don't assert it).
2875  * After the disconnect message link is queued, dbus_bus_get/dbus_connection_open
2876  * should never again return the newly-disconnected connection.
2877  *
2878  * However, we only unref the shared connection and exit_on_disconnect when
2879  * the disconnect message reaches the head of the message queue,
2880  * NOT when it's first queued.
2881  */
2882  status = _dbus_connection_get_dispatch_status_unlocked (connection);
2883 
2884  /* This calls out to user code */
2885  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
2886 
2887  /* Could also call out to user code */
2888  dbus_connection_unref (connection);
2889 }
2890 
2933 void
2935 {
2936  _dbus_return_if_fail (connection != NULL);
2937  _dbus_return_if_fail (connection->generation == _dbus_current_generation);
2938 
2939  CONNECTION_LOCK (connection);
2940 
2941 #ifndef DBUS_DISABLE_CHECKS
2942  if (connection->shareable)
2943  {
2944  CONNECTION_UNLOCK (connection);
2945 
2946  _dbus_warn_check_failed ("Applications must not close shared connections - see dbus_connection_close() docs. This is a bug in the application.\n");
2947  return;
2948  }
2949 #endif
2950 
2951  _dbus_connection_close_possibly_shared_and_unlock (connection);
2952 }
2953 
2954 static dbus_bool_t
2955 _dbus_connection_get_is_connected_unlocked (DBusConnection *connection)
2956 {
2957  HAVE_LOCK_CHECK (connection);
2958  return _dbus_transport_get_is_connected (connection->transport);
2959 }
2960 
2976 {
2977  dbus_bool_t res;
2978 
2979  _dbus_return_val_if_fail (connection != NULL, FALSE);
2980 
2981  CONNECTION_LOCK (connection);
2982  res = _dbus_connection_get_is_connected_unlocked (connection);
2983  CONNECTION_UNLOCK (connection);
2984 
2985  return res;
2986 }
2987 
2998 {
2999  dbus_bool_t res;
3000 
3001  _dbus_return_val_if_fail (connection != NULL, FALSE);
3002 
3003  CONNECTION_LOCK (connection);
3004  res = _dbus_transport_try_to_authenticate (connection->transport);
3005  CONNECTION_UNLOCK (connection);
3006 
3007  return res;
3008 }
3009 
3032 {
3033  dbus_bool_t res;
3034 
3035  _dbus_return_val_if_fail (connection != NULL, FALSE);
3036 
3037  CONNECTION_LOCK (connection);
3038  res = _dbus_transport_get_is_anonymous (connection->transport);
3039  CONNECTION_UNLOCK (connection);
3040 
3041  return res;
3042 }
3043 
3075 char*
3077 {
3078  char *id;
3079 
3080  _dbus_return_val_if_fail (connection != NULL, NULL);
3081 
3082  CONNECTION_LOCK (connection);
3084  CONNECTION_UNLOCK (connection);
3085 
3086  return id;
3087 }
3088 
3108  int type)
3109 {
3110  _dbus_return_val_if_fail (connection != NULL, FALSE);
3111 
3112  if (!dbus_type_is_valid (type))
3113  return FALSE;
3114 
3115  if (type != DBUS_TYPE_UNIX_FD)
3116  return TRUE;
3117 
3118 #ifdef HAVE_UNIX_FD_PASSING
3119  {
3120  dbus_bool_t b;
3121 
3122  CONNECTION_LOCK(connection);
3124  CONNECTION_UNLOCK(connection);
3125 
3126  return b;
3127  }
3128 #endif
3129 
3130  return FALSE;
3131 }
3132 
3146 void
3148  dbus_bool_t exit_on_disconnect)
3149 {
3150  _dbus_return_if_fail (connection != NULL);
3151 
3152  CONNECTION_LOCK (connection);
3153  connection->exit_on_disconnect = exit_on_disconnect != FALSE;
3154  CONNECTION_UNLOCK (connection);
3155 }
3156 
3168 {
3169  DBusPreallocatedSend *preallocated;
3170 
3171  _dbus_return_val_if_fail (connection != NULL, NULL);
3172 
3173  CONNECTION_LOCK (connection);
3174 
3175  preallocated =
3176  _dbus_connection_preallocate_send_unlocked (connection);
3177 
3178  CONNECTION_UNLOCK (connection);
3179 
3180  return preallocated;
3181 }
3182 
3192 void
3194  DBusPreallocatedSend *preallocated)
3195 {
3196  _dbus_return_if_fail (connection != NULL);
3197  _dbus_return_if_fail (preallocated != NULL);
3198  _dbus_return_if_fail (connection == preallocated->connection);
3199 
3200  _dbus_list_free_link (preallocated->queue_link);
3201  _dbus_counter_unref (preallocated->counter_link->data);
3202  _dbus_list_free_link (preallocated->counter_link);
3203  dbus_free (preallocated);
3204 }
3205 
3218 void
3220  DBusPreallocatedSend *preallocated,
3221  DBusMessage *message,
3222  dbus_uint32_t *client_serial)
3223 {
3224  _dbus_return_if_fail (connection != NULL);
3225  _dbus_return_if_fail (preallocated != NULL);
3226  _dbus_return_if_fail (message != NULL);
3227  _dbus_return_if_fail (preallocated->connection == connection);
3228  _dbus_return_if_fail (dbus_message_get_type (message) != DBUS_MESSAGE_TYPE_METHOD_CALL ||
3229  dbus_message_get_member (message) != NULL);
3230  _dbus_return_if_fail (dbus_message_get_type (message) != DBUS_MESSAGE_TYPE_SIGNAL ||
3231  (dbus_message_get_interface (message) != NULL &&
3232  dbus_message_get_member (message) != NULL));
3233 
3234  CONNECTION_LOCK (connection);
3235 
3236 #ifdef HAVE_UNIX_FD_PASSING
3237 
3238  if (!_dbus_transport_can_pass_unix_fd(connection->transport) &&
3239  message->n_unix_fds > 0)
3240  {
3241  /* Refuse to send fds on a connection that cannot handle
3242  them. Unfortunately we cannot return a proper error here, so
3243  the best we can is just return. */
3244  CONNECTION_UNLOCK (connection);
3245  return;
3246  }
3247 
3248 #endif
3249 
3250  _dbus_connection_send_preallocated_and_unlock (connection,
3251  preallocated,
3252  message, client_serial);
3253 }
3254 
3255 static dbus_bool_t
3256 _dbus_connection_send_unlocked_no_update (DBusConnection *connection,
3257  DBusMessage *message,
3258  dbus_uint32_t *client_serial)
3259 {
3260  DBusPreallocatedSend *preallocated;
3261 
3262  _dbus_assert (connection != NULL);
3263  _dbus_assert (message != NULL);
3264 
3265  preallocated = _dbus_connection_preallocate_send_unlocked (connection);
3266  if (preallocated == NULL)
3267  return FALSE;
3268 
3269  _dbus_connection_send_preallocated_unlocked_no_update (connection,
3270  preallocated,
3271  message,
3272  client_serial);
3273  return TRUE;
3274 }
3275 
3305  DBusMessage *message,
3306  dbus_uint32_t *serial)
3307 {
3308  _dbus_return_val_if_fail (connection != NULL, FALSE);
3309  _dbus_return_val_if_fail (message != NULL, FALSE);
3310 
3311  CONNECTION_LOCK (connection);
3312 
3313 #ifdef HAVE_UNIX_FD_PASSING
3314 
3315  if (!_dbus_transport_can_pass_unix_fd(connection->transport) &&
3316  message->n_unix_fds > 0)
3317  {
3318  /* Refuse to send fds on a connection that cannot handle
3319  them. Unfortunately we cannot return a proper error here, so
3320  the best we can is just return. */
3321  CONNECTION_UNLOCK (connection);
3322  return FALSE;
3323  }
3324 
3325 #endif
3326 
3327  return _dbus_connection_send_and_unlock (connection,
3328  message,
3329  serial);
3330 }
3331 
3332 static dbus_bool_t
3333 reply_handler_timeout (void *data)
3334 {
3335  DBusConnection *connection;
3336  DBusDispatchStatus status;
3337  DBusPendingCall *pending = data;
3338 
3339  connection = _dbus_pending_call_get_connection_and_lock (pending);
3340  _dbus_connection_ref_unlocked (connection);
3341 
3343  connection);
3347 
3348  _dbus_verbose ("middle\n");
3349  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3350 
3351  /* Unlocks, and calls out to user code */
3352  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3353  dbus_connection_unref (connection);
3354 
3355  return TRUE;
3356 }
3357 
3402  DBusMessage *message,
3403  DBusPendingCall **pending_return,
3404  int timeout_milliseconds)
3405 {
3406  DBusPendingCall *pending;
3407  dbus_int32_t serial = -1;
3408  DBusDispatchStatus status;
3409 
3410  _dbus_return_val_if_fail (connection != NULL, FALSE);
3411  _dbus_return_val_if_fail (message != NULL, FALSE);
3412  _dbus_return_val_if_fail (timeout_milliseconds >= 0 || timeout_milliseconds == -1, FALSE);
3413 
3414  if (pending_return)
3415  *pending_return = NULL;
3416 
3417  CONNECTION_LOCK (connection);
3418 
3419 #ifdef HAVE_UNIX_FD_PASSING
3420 
3421  if (!_dbus_transport_can_pass_unix_fd(connection->transport) &&
3422  message->n_unix_fds > 0)
3423  {
3424  /* Refuse to send fds on a connection that cannot handle
3425  them. Unfortunately we cannot return a proper error here, so
3426  the best we can do is return TRUE but leave *pending_return
3427  as NULL. */
3428  CONNECTION_UNLOCK (connection);
3429  return TRUE;
3430  }
3431 
3432 #endif
3433 
3434  if (!_dbus_connection_get_is_connected_unlocked (connection))
3435  {
3436  CONNECTION_UNLOCK (connection);
3437 
3438  return TRUE;
3439  }
3440 
3441  pending = _dbus_pending_call_new_unlocked (connection,
3442  timeout_milliseconds,
3443  reply_handler_timeout);
3444 
3445  if (pending == NULL)
3446  {
3447  CONNECTION_UNLOCK (connection);
3448  return FALSE;
3449  }
3450 
3451  /* Assign a serial to the message */
3452  serial = dbus_message_get_serial (message);
3453  if (serial == 0)
3454  {
3455  serial = _dbus_connection_get_next_client_serial (connection);
3456  dbus_message_set_serial (message, serial);
3457  }
3458 
3459  if (!_dbus_pending_call_set_timeout_error_unlocked (pending, message, serial))
3460  goto error;
3461 
3462  /* Insert the serial in the pending replies hash;
3463  * hash takes a refcount on DBusPendingCall.
3464  * Also, add the timeout.
3465  */
3466  if (!_dbus_connection_attach_pending_call_unlocked (connection,
3467  pending))
3468  goto error;
3469 
3470  if (!_dbus_connection_send_unlocked_no_update (connection, message, NULL))
3471  {
3472  _dbus_connection_detach_pending_call_and_unlock (connection,
3473  pending);
3474  goto error_unlocked;
3475  }
3476 
3477  if (pending_return)
3478  *pending_return = pending; /* hand off refcount */
3479  else
3480  {
3481  _dbus_connection_detach_pending_call_unlocked (connection, pending);
3482  /* we still have a ref to the pending call in this case, we unref
3483  * after unlocking, below
3484  */
3485  }
3486 
3487  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3488 
3489  /* this calls out to user code */
3490  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3491 
3492  if (pending_return == NULL)
3493  dbus_pending_call_unref (pending);
3494 
3495  return TRUE;
3496 
3497  error:
3498  CONNECTION_UNLOCK (connection);
3499  error_unlocked:
3500  dbus_pending_call_unref (pending);
3501  return FALSE;
3502 }
3503 
3536 DBusMessage*
3538  DBusMessage *message,
3539  int timeout_milliseconds,
3540  DBusError *error)
3541 {
3542  DBusMessage *reply;
3543  DBusPendingCall *pending;
3544 
3545  _dbus_return_val_if_fail (connection != NULL, NULL);
3546  _dbus_return_val_if_fail (message != NULL, NULL);
3547  _dbus_return_val_if_fail (timeout_milliseconds >= 0 || timeout_milliseconds == -1, NULL);
3548  _dbus_return_val_if_error_is_set (error, NULL);
3549 
3550 #ifdef HAVE_UNIX_FD_PASSING
3551 
3552  CONNECTION_LOCK (connection);
3553  if (!_dbus_transport_can_pass_unix_fd(connection->transport) &&
3554  message->n_unix_fds > 0)
3555  {
3556  CONNECTION_UNLOCK (connection);
3557  dbus_set_error(error, DBUS_ERROR_FAILED, "Cannot send file descriptors on this connection.");
3558  return NULL;
3559  }
3560  CONNECTION_UNLOCK (connection);
3561 
3562 #endif
3563 
3564  if (!dbus_connection_send_with_reply (connection, message,
3565  &pending, timeout_milliseconds))
3566  {
3567  _DBUS_SET_OOM (error);
3568  return NULL;
3569  }
3570 
3571  if (pending == NULL)
3572  {
3573  dbus_set_error (error, DBUS_ERROR_DISCONNECTED, "Connection is closed");
3574  return NULL;
3575  }
3576 
3577  dbus_pending_call_block (pending);
3578 
3579  reply = dbus_pending_call_steal_reply (pending);
3580  dbus_pending_call_unref (pending);
3581 
3582  /* call_complete_and_unlock() called from pending_call_block() should
3583  * always fill this in.
3584  */
3585  _dbus_assert (reply != NULL);
3586 
3587  if (dbus_set_error_from_message (error, reply))
3588  {
3589  dbus_message_unref (reply);
3590  return NULL;
3591  }
3592  else
3593  return reply;
3594 }
3595 
3604 static DBusDispatchStatus
3605 _dbus_connection_flush_unlocked (DBusConnection *connection)
3606 {
3607  /* We have to specify DBUS_ITERATION_DO_READING here because
3608  * otherwise we could have two apps deadlock if they are both doing
3609  * a flush(), and the kernel buffers fill up. This could change the
3610  * dispatch status.
3611  */
3612  DBusDispatchStatus status;
3613 
3614  HAVE_LOCK_CHECK (connection);
3615 
3616  while (connection->n_outgoing > 0 &&
3617  _dbus_connection_get_is_connected_unlocked (connection))
3618  {
3619  _dbus_verbose ("doing iteration in\n");
3620  HAVE_LOCK_CHECK (connection);
3622  NULL,
3623  DBUS_ITERATION_DO_READING |
3624  DBUS_ITERATION_DO_WRITING |
3625  DBUS_ITERATION_BLOCK,
3626  -1);
3627  }
3628 
3629  HAVE_LOCK_CHECK (connection);
3630  _dbus_verbose ("middle\n");
3631  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3632 
3633  HAVE_LOCK_CHECK (connection);
3634  return status;
3635 }
3636 
3642 void
3644 {
3645  /* We have to specify DBUS_ITERATION_DO_READING here because
3646  * otherwise we could have two apps deadlock if they are both doing
3647  * a flush(), and the kernel buffers fill up. This could change the
3648  * dispatch status.
3649  */
3650  DBusDispatchStatus status;
3651 
3652  _dbus_return_if_fail (connection != NULL);
3653 
3654  CONNECTION_LOCK (connection);
3655 
3656  status = _dbus_connection_flush_unlocked (connection);
3657 
3658  HAVE_LOCK_CHECK (connection);
3659  /* Unlocks and calls out to user code */
3660  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3661 
3662  _dbus_verbose ("end\n");
3663 }
3664 
3675 static dbus_bool_t
3676 _dbus_connection_read_write_dispatch (DBusConnection *connection,
3677  int timeout_milliseconds,
3678  dbus_bool_t dispatch)
3679 {
3680  DBusDispatchStatus dstatus;
3681  dbus_bool_t progress_possible;
3682 
3683  /* Need to grab a ref here in case we're a private connection and
3684  * the user drops the last ref in a handler we call; see bug
3685  * https://bugs.freedesktop.org/show_bug.cgi?id=15635
3686  */
3687  dbus_connection_ref (connection);
3688  dstatus = dbus_connection_get_dispatch_status (connection);
3689 
3690  if (dispatch && dstatus == DBUS_DISPATCH_DATA_REMAINS)
3691  {
3692  _dbus_verbose ("doing dispatch\n");
3693  dbus_connection_dispatch (connection);
3694  CONNECTION_LOCK (connection);
3695  }
3696  else if (dstatus == DBUS_DISPATCH_NEED_MEMORY)
3697  {
3698  _dbus_verbose ("pausing for memory\n");
3699  _dbus_memory_pause_based_on_timeout (timeout_milliseconds);
3700  CONNECTION_LOCK (connection);
3701  }
3702  else
3703  {
3704  CONNECTION_LOCK (connection);
3705  if (_dbus_connection_get_is_connected_unlocked (connection))
3706  {
3707  _dbus_verbose ("doing iteration\n");
3709  NULL,
3710  DBUS_ITERATION_DO_READING |
3711  DBUS_ITERATION_DO_WRITING |
3712  DBUS_ITERATION_BLOCK,
3713  timeout_milliseconds);
3714  }
3715  }
3716 
3717  HAVE_LOCK_CHECK (connection);
3718  /* If we can dispatch, we can make progress until the Disconnected message
3719  * has been processed; if we can only read/write, we can make progress
3720  * as long as the transport is open.
3721  */
3722  if (dispatch)
3723  progress_possible = connection->n_incoming != 0 ||
3724  connection->disconnect_message_link != NULL;
3725  else
3726  progress_possible = _dbus_connection_get_is_connected_unlocked (connection);
3727 
3728  CONNECTION_UNLOCK (connection);
3729 
3730  dbus_connection_unref (connection);
3731 
3732  return progress_possible; /* TRUE if we can make more progress */
3733 }
3734 
3735 
3772  int timeout_milliseconds)
3773 {
3774  _dbus_return_val_if_fail (connection != NULL, FALSE);
3775  _dbus_return_val_if_fail (timeout_milliseconds >= 0 || timeout_milliseconds == -1, FALSE);
3776  return _dbus_connection_read_write_dispatch(connection, timeout_milliseconds, TRUE);
3777 }
3778 
3802 dbus_bool_t
3804  int timeout_milliseconds)
3805 {
3806  _dbus_return_val_if_fail (connection != NULL, FALSE);
3807  _dbus_return_val_if_fail (timeout_milliseconds >= 0 || timeout_milliseconds == -1, FALSE);
3808  return _dbus_connection_read_write_dispatch(connection, timeout_milliseconds, FALSE);
3809 }
3810 
3811 /* We need to call this anytime we pop the head of the queue, and then
3812  * update_dispatch_status_and_unlock needs to be called afterward
3813  * which will "process" the disconnected message and set
3814  * disconnected_message_processed.
3815  */
3816 static void
3817 check_disconnected_message_arrived_unlocked (DBusConnection *connection,
3818  DBusMessage *head_of_queue)
3819 {
3820  HAVE_LOCK_CHECK (connection);
3821 
3822  /* checking that the link is NULL is an optimization to avoid the is_signal call */
3823  if (connection->disconnect_message_link == NULL &&
3824  dbus_message_is_signal (head_of_queue,
3826  "Disconnected"))
3827  {
3828  connection->disconnected_message_arrived = TRUE;
3829  }
3830 }
3831 
3851 DBusMessage*
3853 {
3854  DBusDispatchStatus status;
3855  DBusMessage *message;
3856 
3857  _dbus_return_val_if_fail (connection != NULL, NULL);
3858 
3859  _dbus_verbose ("start\n");
3860 
3861  /* this is called for the side effect that it queues
3862  * up any messages from the transport
3863  */
3864  status = dbus_connection_get_dispatch_status (connection);
3865  if (status != DBUS_DISPATCH_DATA_REMAINS)
3866  return NULL;
3867 
3868  CONNECTION_LOCK (connection);
3869 
3870  _dbus_connection_acquire_dispatch (connection);
3871 
3872  /* While a message is outstanding, the dispatch lock is held */
3873  _dbus_assert (connection->message_borrowed == NULL);
3874 
3875  connection->message_borrowed = _dbus_list_get_first (&connection->incoming_messages);
3876 
3877  message = connection->message_borrowed;
3878 
3879  check_disconnected_message_arrived_unlocked (connection, message);
3880 
3881  /* Note that we KEEP the dispatch lock until the message is returned */
3882  if (message == NULL)
3883  _dbus_connection_release_dispatch (connection);
3884 
3885  CONNECTION_UNLOCK (connection);
3886 
3887  _dbus_message_trace_ref (message, -1, -1, "dbus_connection_borrow_message");
3888 
3889  /* We don't update dispatch status until it's returned or stolen */
3890 
3891  return message;
3892 }
3893 
3902 void
3904  DBusMessage *message)
3905 {
3906  DBusDispatchStatus status;
3907 
3908  _dbus_return_if_fail (connection != NULL);
3909  _dbus_return_if_fail (message != NULL);
3910  _dbus_return_if_fail (message == connection->message_borrowed);
3911  _dbus_return_if_fail (connection->dispatch_acquired);
3912 
3913  CONNECTION_LOCK (connection);
3914 
3915  _dbus_assert (message == connection->message_borrowed);
3916 
3917  connection->message_borrowed = NULL;
3918 
3919  _dbus_connection_release_dispatch (connection);
3920 
3921  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3922  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3923 
3924  _dbus_message_trace_ref (message, -1, -1, "dbus_connection_return_message");
3925 }
3926 
3936 void
3938  DBusMessage *message)
3939 {
3940  DBusMessage *pop_message;
3941  DBusDispatchStatus status;
3942 
3943  _dbus_return_if_fail (connection != NULL);
3944  _dbus_return_if_fail (message != NULL);
3945  _dbus_return_if_fail (message == connection->message_borrowed);
3946  _dbus_return_if_fail (connection->dispatch_acquired);
3947 
3948  CONNECTION_LOCK (connection);
3949 
3950  _dbus_assert (message == connection->message_borrowed);
3951 
3952  pop_message = _dbus_list_pop_first (&connection->incoming_messages);
3953  _dbus_assert (message == pop_message);
3954  (void) pop_message; /* unused unless asserting */
3955 
3956  connection->n_incoming -= 1;
3957 
3958  _dbus_verbose ("Incoming message %p stolen from queue, %d incoming\n",
3959  message, connection->n_incoming);
3960 
3961  connection->message_borrowed = NULL;
3962 
3963  _dbus_connection_release_dispatch (connection);
3964 
3965  status = _dbus_connection_get_dispatch_status_unlocked (connection);
3966  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
3967  _dbus_message_trace_ref (message, -1, -1,
3968  "dbus_connection_steal_borrowed_message");
3969 }
3970 
3971 /* See dbus_connection_pop_message, but requires the caller to own
3972  * the lock before calling. May drop the lock while running.
3973  */
3974 static DBusList*
3975 _dbus_connection_pop_message_link_unlocked (DBusConnection *connection)
3976 {
3977  HAVE_LOCK_CHECK (connection);
3978 
3979  _dbus_assert (connection->message_borrowed == NULL);
3980 
3981  if (connection->n_incoming > 0)
3982  {
3983  DBusList *link;
3984 
3985  link = _dbus_list_pop_first_link (&connection->incoming_messages);
3986  connection->n_incoming -= 1;
3987 
3988  _dbus_verbose ("Message %p (%s %s %s %s sig:'%s' serial:%u) removed from incoming queue %p, %d incoming\n",
3989  link->data,
3991  dbus_message_get_path (link->data) ?
3992  dbus_message_get_path (link->data) :
3993  "no path",
3996  "no interface",
3997  dbus_message_get_member (link->data) ?
3998  dbus_message_get_member (link->data) :
3999  "no member",
4001  dbus_message_get_serial (link->data),
4002  connection, connection->n_incoming);
4003 
4004  _dbus_message_trace_ref (link->data, -1, -1,
4005  "_dbus_connection_pop_message_link_unlocked");
4006 
4007  check_disconnected_message_arrived_unlocked (connection, link->data);
4008 
4009  return link;
4010  }
4011  else
4012  return NULL;
4013 }
4014 
4015 /* See dbus_connection_pop_message, but requires the caller to own
4016  * the lock before calling. May drop the lock while running.
4017  */
4018 static DBusMessage*
4019 _dbus_connection_pop_message_unlocked (DBusConnection *connection)
4020 {
4021  DBusList *link;
4022 
4023  HAVE_LOCK_CHECK (connection);
4024 
4025  link = _dbus_connection_pop_message_link_unlocked (connection);
4026 
4027  if (link != NULL)
4028  {
4029  DBusMessage *message;
4030 
4031  message = link->data;
4032 
4033  _dbus_list_free_link (link);
4034 
4035  return message;
4036  }
4037  else
4038  return NULL;
4039 }
4040 
4041 static void
4042 _dbus_connection_putback_message_link_unlocked (DBusConnection *connection,
4043  DBusList *message_link)
4044 {
4045  HAVE_LOCK_CHECK (connection);
4046 
4047  _dbus_assert (message_link != NULL);
4048  /* You can't borrow a message while a link is outstanding */
4049  _dbus_assert (connection->message_borrowed == NULL);
4050  /* We had to have the dispatch lock across the pop/putback */
4051  _dbus_assert (connection->dispatch_acquired);
4052 
4054  message_link);
4055  connection->n_incoming += 1;
4056 
4057  _dbus_verbose ("Message %p (%s %s %s '%s') put back into queue %p, %d incoming\n",
4058  message_link->data,
4060  dbus_message_get_interface (message_link->data) ?
4061  dbus_message_get_interface (message_link->data) :
4062  "no interface",
4063  dbus_message_get_member (message_link->data) ?
4064  dbus_message_get_member (message_link->data) :
4065  "no member",
4066  dbus_message_get_signature (message_link->data),
4067  connection, connection->n_incoming);
4068 
4069  _dbus_message_trace_ref (message_link->data, -1, -1,
4070  "_dbus_connection_putback_message_link_unlocked");
4071 }
4072 
4092 DBusMessage*
4094 {
4095  DBusMessage *message;
4096  DBusDispatchStatus status;
4097 
4098  _dbus_verbose ("start\n");
4099 
4100  /* this is called for the side effect that it queues
4101  * up any messages from the transport
4102  */
4103  status = dbus_connection_get_dispatch_status (connection);
4104  if (status != DBUS_DISPATCH_DATA_REMAINS)
4105  return NULL;
4106 
4107  CONNECTION_LOCK (connection);
4108  _dbus_connection_acquire_dispatch (connection);
4109  HAVE_LOCK_CHECK (connection);
4110 
4111  message = _dbus_connection_pop_message_unlocked (connection);
4112 
4113  _dbus_verbose ("Returning popped message %p\n", message);
4114 
4115  _dbus_connection_release_dispatch (connection);
4116 
4117  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4118  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
4119 
4120  return message;
4121 }
4122 
4130 static void
4131 _dbus_connection_acquire_dispatch (DBusConnection *connection)
4132 {
4133  HAVE_LOCK_CHECK (connection);
4134 
4135  _dbus_connection_ref_unlocked (connection);
4136  CONNECTION_UNLOCK (connection);
4137 
4138  _dbus_verbose ("locking dispatch_mutex\n");
4139  _dbus_cmutex_lock (connection->dispatch_mutex);
4140 
4141  while (connection->dispatch_acquired)
4142  {
4143  _dbus_verbose ("waiting for dispatch to be acquirable\n");
4144  _dbus_condvar_wait (connection->dispatch_cond,
4145  connection->dispatch_mutex);
4146  }
4147 
4148  _dbus_assert (!connection->dispatch_acquired);
4149 
4150  connection->dispatch_acquired = TRUE;
4151 
4152  _dbus_verbose ("unlocking dispatch_mutex\n");
4153  _dbus_cmutex_unlock (connection->dispatch_mutex);
4154 
4155  CONNECTION_LOCK (connection);
4156  _dbus_connection_unref_unlocked (connection);
4157 }
4158 
4166 static void
4167 _dbus_connection_release_dispatch (DBusConnection *connection)
4168 {
4169  HAVE_LOCK_CHECK (connection);
4170 
4171  _dbus_verbose ("locking dispatch_mutex\n");
4172  _dbus_cmutex_lock (connection->dispatch_mutex);
4173 
4174  _dbus_assert (connection->dispatch_acquired);
4175 
4176  connection->dispatch_acquired = FALSE;
4177  _dbus_condvar_wake_one (connection->dispatch_cond);
4178 
4179  _dbus_verbose ("unlocking dispatch_mutex\n");
4180  _dbus_cmutex_unlock (connection->dispatch_mutex);
4181 }
4182 
4183 static void
4184 _dbus_connection_failed_pop (DBusConnection *connection,
4185  DBusList *message_link)
4186 {
4188  message_link);
4189  connection->n_incoming += 1;
4190 }
4191 
4192 /* Note this may be called multiple times since we don't track whether we already did it */
4193 static void
4194 notify_disconnected_unlocked (DBusConnection *connection)
4195 {
4196  HAVE_LOCK_CHECK (connection);
4197 
4198  /* Set the weakref in dbus-bus.c to NULL, so nobody will get a disconnected
4199  * connection from dbus_bus_get(). We make the same guarantee for
4200  * dbus_connection_open() but in a different way since we don't want to
4201  * unref right here; we instead check for connectedness before returning
4202  * the connection from the hash.
4203  */
4205 
4206  /* Dump the outgoing queue, we aren't going to be able to
4207  * send it now, and we'd like accessors like
4208  * dbus_connection_get_outgoing_size() to be accurate.
4209  */
4210  if (connection->n_outgoing > 0)
4211  {
4212  DBusList *link;
4213 
4214  _dbus_verbose ("Dropping %d outgoing messages since we're disconnected\n",
4215  connection->n_outgoing);
4216 
4217  while ((link = _dbus_list_get_last_link (&connection->outgoing_messages)))
4218  {
4219  _dbus_connection_message_sent_unlocked (connection, link->data);
4220  }
4221  }
4222 }
4223 
4224 /* Note this may be called multiple times since we don't track whether we already did it */
4225 static DBusDispatchStatus
4226 notify_disconnected_and_dispatch_complete_unlocked (DBusConnection *connection)
4227 {
4228  HAVE_LOCK_CHECK (connection);
4229 
4230  if (connection->disconnect_message_link != NULL)
4231  {
4232  _dbus_verbose ("Sending disconnect message\n");
4233 
4234  /* If we have pending calls, queue their timeouts - we want the Disconnected
4235  * to be the last message, after these timeouts.
4236  */
4237  connection_timeout_and_complete_all_pending_calls_unlocked (connection);
4238 
4239  /* We haven't sent the disconnect message already,
4240  * and all real messages have been queued up.
4241  */
4243  connection->disconnect_message_link);
4244  connection->disconnect_message_link = NULL;
4245 
4247  }
4248 
4249  return DBUS_DISPATCH_COMPLETE;
4250 }
4251 
4252 static DBusDispatchStatus
4253 _dbus_connection_get_dispatch_status_unlocked (DBusConnection *connection)
4254 {
4255  HAVE_LOCK_CHECK (connection);
4256 
4257  if (connection->n_incoming > 0)
4259  else if (!_dbus_transport_queue_messages (connection->transport))
4261  else
4262  {
4263  DBusDispatchStatus status;
4264  dbus_bool_t is_connected;
4265 
4266  status = _dbus_transport_get_dispatch_status (connection->transport);
4267  is_connected = _dbus_transport_get_is_connected (connection->transport);
4268 
4269  _dbus_verbose ("dispatch status = %s is_connected = %d\n",
4270  DISPATCH_STATUS_NAME (status), is_connected);
4271 
4272  if (!is_connected)
4273  {
4274  /* It's possible this would be better done by having an explicit
4275  * notification from _dbus_transport_disconnect() that would
4276  * synchronously do this, instead of waiting for the next dispatch
4277  * status check. However, probably not good to change until it causes
4278  * a problem.
4279  */
4280  notify_disconnected_unlocked (connection);
4281 
4282  /* I'm not sure this is needed; the idea is that we want to
4283  * queue the Disconnected only after we've read all the
4284  * messages, but if we're disconnected maybe we are guaranteed
4285  * to have read them all ?
4286  */
4287  if (status == DBUS_DISPATCH_COMPLETE)
4288  status = notify_disconnected_and_dispatch_complete_unlocked (connection);
4289  }
4290 
4291  if (status != DBUS_DISPATCH_COMPLETE)
4292  return status;
4293  else if (connection->n_incoming > 0)
4295  else
4296  return DBUS_DISPATCH_COMPLETE;
4297  }
4298 }
4299 
4300 static void
4301 _dbus_connection_update_dispatch_status_and_unlock (DBusConnection *connection,
4302  DBusDispatchStatus new_status)
4303 {
4304  dbus_bool_t changed;
4305  DBusDispatchStatusFunction function;
4306  void *data;
4307 
4308  HAVE_LOCK_CHECK (connection);
4309 
4310  _dbus_connection_ref_unlocked (connection);
4311 
4312  changed = new_status != connection->last_dispatch_status;
4313 
4314  connection->last_dispatch_status = new_status;
4315 
4316  function = connection->dispatch_status_function;
4317  data = connection->dispatch_status_data;
4318 
4319  if (connection->disconnected_message_arrived &&
4320  !connection->disconnected_message_processed)
4321  {
4322  connection->disconnected_message_processed = TRUE;
4323 
4324  /* this does an unref, but we have a ref
4325  * so we should not run the finalizer here
4326  * inside the lock.
4327  */
4328  connection_forget_shared_unlocked (connection);
4329 
4330  if (connection->exit_on_disconnect)
4331  {
4332  CONNECTION_UNLOCK (connection);
4333 
4334  _dbus_verbose ("Exiting on Disconnected signal\n");
4335  _dbus_exit (1);
4336  _dbus_assert_not_reached ("Call to exit() returned");
4337  }
4338  }
4339 
4340  /* We drop the lock */
4341  CONNECTION_UNLOCK (connection);
4342 
4343  if (changed && function)
4344  {
4345  _dbus_verbose ("Notifying of change to dispatch status of %p now %d (%s)\n",
4346  connection, new_status,
4347  DISPATCH_STATUS_NAME (new_status));
4348  (* function) (connection, new_status, data);
4349  }
4350 
4351  dbus_connection_unref (connection);
4352 }
4353 
4381 {
4382  DBusDispatchStatus status;
4383 
4384  _dbus_return_val_if_fail (connection != NULL, DBUS_DISPATCH_COMPLETE);
4385 
4386  _dbus_verbose ("start\n");
4387 
4388  CONNECTION_LOCK (connection);
4389 
4390  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4391 
4392  CONNECTION_UNLOCK (connection);
4393 
4394  return status;
4395 }
4396 
4400 static DBusHandlerResult
4401 _dbus_connection_peer_filter_unlocked_no_update (DBusConnection *connection,
4402  DBusMessage *message)
4403 {
4404  dbus_bool_t sent = FALSE;
4405  DBusMessage *ret = NULL;
4406  DBusList *expire_link;
4407 
4408  if (connection->route_peer_messages && dbus_message_get_destination (message) != NULL)
4409  {
4410  /* This means we're letting the bus route this message */
4412  }
4413 
4415  {
4417  }
4418 
4419  /* Preallocate a linked-list link, so that if we need to dispose of a
4420  * message, we can attach it to the expired list */
4421  expire_link = _dbus_list_alloc_link (NULL);
4422 
4423  if (!expire_link)
4425 
4426  if (dbus_message_is_method_call (message,
4428  "Ping"))
4429  {
4430  ret = dbus_message_new_method_return (message);
4431  if (ret == NULL)
4432  goto out;
4433 
4434  sent = _dbus_connection_send_unlocked_no_update (connection, ret, NULL);
4435  }
4436  else if (dbus_message_is_method_call (message,
4438  "GetMachineId"))
4439  {
4440  DBusString uuid;
4441  DBusError error = DBUS_ERROR_INIT;
4442 
4443  if (!_dbus_string_init (&uuid))
4444  goto out;
4445 
4446  if (_dbus_get_local_machine_uuid_encoded (&uuid, &error))
4447  {
4448  const char *v_STRING;
4449 
4450  ret = dbus_message_new_method_return (message);
4451 
4452  if (ret == NULL)
4453  {
4454  _dbus_string_free (&uuid);
4455  goto out;
4456  }
4457 
4458  v_STRING = _dbus_string_get_const_data (&uuid);
4459  if (dbus_message_append_args (ret,
4460  DBUS_TYPE_STRING, &v_STRING,
4462  {
4463  sent = _dbus_connection_send_unlocked_no_update (connection, ret, NULL);
4464  }
4465  }
4466  else if (dbus_error_has_name (&error, DBUS_ERROR_NO_MEMORY))
4467  {
4468  dbus_error_free (&error);
4469  goto out;
4470  }
4471  else
4472  {
4473  ret = dbus_message_new_error (message, error.name, error.message);
4474  dbus_error_free (&error);
4475 
4476  if (ret == NULL)
4477  goto out;
4478 
4479  sent = _dbus_connection_send_unlocked_no_update (connection, ret,
4480  NULL);
4481  }
4482 
4483  _dbus_string_free (&uuid);
4484  }
4485  else
4486  {
4487  /* We need to bounce anything else with this interface, otherwise apps
4488  * could start extending the interface and when we added extensions
4489  * here to DBusConnection we'd break those apps.
4490  */
4491  ret = dbus_message_new_error (message,
4493  "Unknown method invoked on org.freedesktop.DBus.Peer interface");
4494  if (ret == NULL)
4495  goto out;
4496 
4497  sent = _dbus_connection_send_unlocked_no_update (connection, ret, NULL);
4498  }
4499 
4500 out:
4501  if (ret == NULL)
4502  {
4503  _dbus_list_free_link (expire_link);
4504  }
4505  else
4506  {
4507  /* It'll be safe to unref the reply when we unlock */
4508  expire_link->data = ret;
4509  _dbus_list_prepend_link (&connection->expired_messages, expire_link);
4510  }
4511 
4512  if (!sent)
4514 
4516 }
4517 
4524 static DBusHandlerResult
4525 _dbus_connection_run_builtin_filters_unlocked_no_update (DBusConnection *connection,
4526  DBusMessage *message)
4527 {
4528  /* We just run one filter for now but have the option to run more
4529  if the spec calls for it in the future */
4530 
4531  return _dbus_connection_peer_filter_unlocked_no_update (connection, message);
4532 }
4533 
4578 {
4579  DBusMessage *message;
4580  DBusList *link, *filter_list_copy, *message_link;
4581  DBusHandlerResult result;
4582  DBusPendingCall *pending;
4583  dbus_int32_t reply_serial;
4584  DBusDispatchStatus status;
4585  dbus_bool_t found_object;
4586 
4587  _dbus_return_val_if_fail (connection != NULL, DBUS_DISPATCH_COMPLETE);
4588 
4589  _dbus_verbose ("\n");
4590 
4591  CONNECTION_LOCK (connection);
4592  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4593  if (status != DBUS_DISPATCH_DATA_REMAINS)
4594  {
4595  /* unlocks and calls out to user code */
4596  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
4597  return status;
4598  }
4599 
4600  /* We need to ref the connection since the callback could potentially
4601  * drop the last ref to it
4602  */
4603  _dbus_connection_ref_unlocked (connection);
4604 
4605  _dbus_connection_acquire_dispatch (connection);
4606  HAVE_LOCK_CHECK (connection);
4607 
4608  message_link = _dbus_connection_pop_message_link_unlocked (connection);
4609  if (message_link == NULL)
4610  {
4611  /* another thread dispatched our stuff */
4612 
4613  _dbus_verbose ("another thread dispatched message (during acquire_dispatch above)\n");
4614 
4615  _dbus_connection_release_dispatch (connection);
4616 
4617  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4618 
4619  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
4620 
4621  dbus_connection_unref (connection);
4622 
4623  return status;
4624  }
4625 
4626  message = message_link->data;
4627 
4628  _dbus_verbose (" dispatching message %p (%s %s %s '%s')\n",
4629  message,
4631  dbus_message_get_interface (message) ?
4632  dbus_message_get_interface (message) :
4633  "no interface",
4634  dbus_message_get_member (message) ?
4635  dbus_message_get_member (message) :
4636  "no member",
4637  dbus_message_get_signature (message));
4638 
4640 
4641  /* Pending call handling must be first, because if you do
4642  * dbus_connection_send_with_reply_and_block() or
4643  * dbus_pending_call_block() then no handlers/filters will be run on
4644  * the reply. We want consistent semantics in the case where we
4645  * dbus_connection_dispatch() the reply.
4646  */
4647 
4648  reply_serial = dbus_message_get_reply_serial (message);
4649  pending = _dbus_hash_table_lookup_int (connection->pending_replies,
4650  reply_serial);
4651  if (pending)
4652  {
4653  _dbus_verbose ("Dispatching a pending reply\n");
4654  complete_pending_call_and_unlock (connection, pending, message);
4655  pending = NULL; /* it's probably unref'd */
4656 
4657  CONNECTION_LOCK (connection);
4658  _dbus_verbose ("pending call completed in dispatch\n");
4659  result = DBUS_HANDLER_RESULT_HANDLED;
4660  goto out;
4661  }
4662 
4663  result = _dbus_connection_run_builtin_filters_unlocked_no_update (connection, message);
4665  goto out;
4666 
4667  if (!_dbus_list_copy (&connection->filter_list, &filter_list_copy))
4668  {
4669  _dbus_connection_release_dispatch (connection);
4670  HAVE_LOCK_CHECK (connection);
4671 
4672  _dbus_connection_failed_pop (connection, message_link);
4673 
4674  /* unlocks and calls user code */
4675  _dbus_connection_update_dispatch_status_and_unlock (connection,
4677  dbus_connection_unref (connection);
4678 
4680  }
4681 
4682  _dbus_list_foreach (&filter_list_copy,
4683  (DBusForeachFunction)_dbus_message_filter_ref,
4684  NULL);
4685 
4686  /* We're still protected from dispatch() reentrancy here
4687  * since we acquired the dispatcher
4688  */
4689  CONNECTION_UNLOCK (connection);
4690 
4691  link = _dbus_list_get_first_link (&filter_list_copy);
4692  while (link != NULL)
4693  {
4694  DBusMessageFilter *filter = link->data;
4695  DBusList *next = _dbus_list_get_next_link (&filter_list_copy, link);
4696 
4697  if (filter->function == NULL)
4698  {
4699  _dbus_verbose (" filter was removed in a callback function\n");
4700  link = next;
4701  continue;
4702  }
4703 
4704  _dbus_verbose (" running filter on message %p\n", message);
4705  result = (* filter->function) (connection, message, filter->user_data);
4706 
4708  break;
4709 
4710  link = next;
4711  }
4712 
4713  _dbus_list_foreach (&filter_list_copy,
4714  (DBusForeachFunction)_dbus_message_filter_unref,
4715  NULL);
4716  _dbus_list_clear (&filter_list_copy);
4717 
4718  CONNECTION_LOCK (connection);
4719 
4720  if (result == DBUS_HANDLER_RESULT_NEED_MEMORY)
4721  {
4722  _dbus_verbose ("No memory\n");
4723  goto out;
4724  }
4725  else if (result == DBUS_HANDLER_RESULT_HANDLED)
4726  {
4727  _dbus_verbose ("filter handled message in dispatch\n");
4728  goto out;
4729  }
4730 
4731  /* We're still protected from dispatch() reentrancy here
4732  * since we acquired the dispatcher
4733  */
4734  _dbus_verbose (" running object path dispatch on message %p (%s %s %s '%s')\n",
4735  message,
4737  dbus_message_get_interface (message) ?
4738  dbus_message_get_interface (message) :
4739  "no interface",
4740  dbus_message_get_member (message) ?
4741  dbus_message_get_member (message) :
4742  "no member",
4743  dbus_message_get_signature (message));
4744 
4745  HAVE_LOCK_CHECK (connection);
4746  result = _dbus_object_tree_dispatch_and_unlock (connection->objects,
4747  message,
4748  &found_object);
4749 
4750  CONNECTION_LOCK (connection);
4751 
4753  {
4754  _dbus_verbose ("object tree handled message in dispatch\n");
4755  goto out;
4756  }
4757 
4759  {
4760  DBusMessage *reply;
4761  DBusString str;
4762  DBusPreallocatedSend *preallocated;
4763  DBusList *expire_link;
4764 
4765  _dbus_verbose (" sending error %s\n",
4767 
4768  if (!_dbus_string_init (&str))
4769  {
4771  _dbus_verbose ("no memory for error string in dispatch\n");
4772  goto out;
4773  }
4774 
4775  if (!_dbus_string_append_printf (&str,
4776  "Method \"%s\" with signature \"%s\" on interface \"%s\" doesn't exist\n",
4777  dbus_message_get_member (message),
4778  dbus_message_get_signature (message),
4779  dbus_message_get_interface (message)))
4780  {
4781  _dbus_string_free (&str);
4783  _dbus_verbose ("no memory for error string in dispatch\n");
4784  goto out;
4785  }
4786 
4787  reply = dbus_message_new_error (message,
4789  _dbus_string_get_const_data (&str));
4790  _dbus_string_free (&str);
4791 
4792  if (reply == NULL)
4793  {
4795  _dbus_verbose ("no memory for error reply in dispatch\n");
4796  goto out;
4797  }
4798 
4799  expire_link = _dbus_list_alloc_link (reply);
4800 
4801  if (expire_link == NULL)
4802  {
4803  dbus_message_unref (reply);
4805  _dbus_verbose ("no memory for error send in dispatch\n");
4806  goto out;
4807  }
4808 
4809  preallocated = _dbus_connection_preallocate_send_unlocked (connection);
4810 
4811  if (preallocated == NULL)
4812  {
4813  _dbus_list_free_link (expire_link);
4814  /* It's OK that this is finalized, because it hasn't been seen by
4815  * anything that could attach user callbacks */
4816  dbus_message_unref (reply);
4818  _dbus_verbose ("no memory for error send in dispatch\n");
4819  goto out;
4820  }
4821 
4822  _dbus_connection_send_preallocated_unlocked_no_update (connection, preallocated,
4823  reply, NULL);
4824  /* reply will be freed when we release the lock */
4825  _dbus_list_prepend_link (&connection->expired_messages, expire_link);
4826 
4827  result = DBUS_HANDLER_RESULT_HANDLED;
4828  }
4829 
4830  _dbus_verbose (" done dispatching %p (%s %s %s '%s') on connection %p\n", message,
4832  dbus_message_get_interface (message) ?
4833  dbus_message_get_interface (message) :
4834  "no interface",
4835  dbus_message_get_member (message) ?
4836  dbus_message_get_member (message) :
4837  "no member",
4838  dbus_message_get_signature (message),
4839  connection);
4840 
4841  out:
4842  if (result == DBUS_HANDLER_RESULT_NEED_MEMORY)
4843  {
4844  _dbus_verbose ("out of memory\n");
4845 
4846  /* Put message back, and we'll start over.
4847  * Yes this means handlers must be idempotent if they
4848  * don't return HANDLED; c'est la vie.
4849  */
4850  _dbus_connection_putback_message_link_unlocked (connection,
4851  message_link);
4852  /* now we don't want to free them */
4853  message_link = NULL;
4854  message = NULL;
4855  }
4856  else
4857  {
4858  _dbus_verbose (" ... done dispatching\n");
4859  }
4860 
4861  _dbus_connection_release_dispatch (connection);
4862  HAVE_LOCK_CHECK (connection);
4863 
4864  if (message != NULL)
4865  {
4866  /* We don't want this message to count in maximum message limits when
4867  * computing the dispatch status, below. We have to drop the lock
4868  * temporarily, because finalizing a message can trigger callbacks.
4869  *
4870  * We have a reference to the connection, and we don't use any cached
4871  * pointers to the connection's internals below this point, so it should
4872  * be safe to drop the lock and take it back. */
4873  CONNECTION_UNLOCK (connection);
4874  dbus_message_unref (message);
4875  CONNECTION_LOCK (connection);
4876  }
4877 
4878  if (message_link != NULL)
4879  _dbus_list_free_link (message_link);
4880 
4881  _dbus_verbose ("before final status update\n");
4882  status = _dbus_connection_get_dispatch_status_unlocked (connection);
4883 
4884  /* unlocks and calls user code */
4885  _dbus_connection_update_dispatch_status_and_unlock (connection, status);
4886 
4887  dbus_connection_unref (connection);
4888 
4889  return status;
4890 }
4891 
4955  DBusAddWatchFunction add_function,
4956  DBusRemoveWatchFunction remove_function,
4957  DBusWatchToggledFunction toggled_function,
4958  void *data,
4959  DBusFreeFunction free_data_function)
4960 {
4961  dbus_bool_t retval;
4962 
4963  _dbus_return_val_if_fail (connection != NULL, FALSE);
4964 
4965  CONNECTION_LOCK (connection);
4966 
4967  retval = _dbus_watch_list_set_functions (connection->watches,
4968  add_function, remove_function,
4969  toggled_function,
4970  data, free_data_function);
4971 
4972  CONNECTION_UNLOCK (connection);
4973 
4974  return retval;
4975 }
4976 
5018  DBusAddTimeoutFunction add_function,
5019  DBusRemoveTimeoutFunction remove_function,
5020  DBusTimeoutToggledFunction toggled_function,
5021  void *data,
5022  DBusFreeFunction free_data_function)
5023 {
5024  dbus_bool_t retval;
5025 
5026  _dbus_return_val_if_fail (connection != NULL, FALSE);
5027 
5028  CONNECTION_LOCK (connection);
5029 
5030  retval = _dbus_timeout_list_set_functions (connection->timeouts,
5031  add_function, remove_function,
5032  toggled_function,
5033  data, free_data_function);
5034 
5035  CONNECTION_UNLOCK (connection);
5036 
5037  return retval;
5038 }
5039 
5054 void
5056  DBusWakeupMainFunction wakeup_main_function,
5057  void *data,
5058  DBusFreeFunction free_data_function)
5059 {
5060  void *old_data;
5061  DBusFreeFunction old_free_data;
5062 
5063  _dbus_return_if_fail (connection != NULL);
5064 
5065  CONNECTION_LOCK (connection);
5066  old_data = connection->wakeup_main_data;
5067  old_free_data = connection->free_wakeup_main_data;
5068 
5069  connection->wakeup_main_function = wakeup_main_function;
5070  connection->wakeup_main_data = data;
5071  connection->free_wakeup_main_data = free_data_function;
5072 
5073  CONNECTION_UNLOCK (connection);
5074 
5075  /* Callback outside the lock */
5076  if (old_free_data)
5077  (*old_free_data) (old_data);
5078 }
5079 
5100 void
5102  DBusDispatchStatusFunction function,
5103  void *data,
5104  DBusFreeFunction free_data_function)
5105 {
5106  void *old_data;
5107  DBusFreeFunction old_free_data;
5108 
5109  _dbus_return_if_fail (connection != NULL);
5110 
5111  CONNECTION_LOCK (connection);
5112  old_data = connection->dispatch_status_data;
5113  old_free_data = connection->free_dispatch_status_data;
5114 
5115  connection->dispatch_status_function = function;
5116  connection->dispatch_status_data = data;
5117  connection->free_dispatch_status_data = free_data_function;
5118 
5119  CONNECTION_UNLOCK (connection);
5120 
5121  /* Callback outside the lock */
5122  if (old_free_data)
5123  (*old_free_data) (old_data);
5124 }
5125 
5147  int *fd)
5148 {
5149  _dbus_return_val_if_fail (connection != NULL, FALSE);
5150  _dbus_return_val_if_fail (connection->transport != NULL, FALSE);
5151 
5152 #ifdef DBUS_WIN
5153  /* FIXME do this on a lower level */
5154  return FALSE;
5155 #endif
5156 
5157  return dbus_connection_get_socket(connection, fd);
5158 }
5159 
5177  int *fd)
5178 {
5179  dbus_bool_t retval;
5180  DBusSocket s = DBUS_SOCKET_INIT;
5181 
5182  _dbus_return_val_if_fail (connection != NULL, FALSE);
5183  _dbus_return_val_if_fail (connection->transport != NULL, FALSE);
5184 
5185  CONNECTION_LOCK (connection);
5186 
5187  retval = _dbus_transport_get_socket_fd (connection->transport, &s);
5188 
5189  if (retval)
5190  {
5191  *fd = _dbus_socket_get_int (s);
5192  }
5193 
5194  CONNECTION_UNLOCK (connection);
5195 
5196  return retval;
5197 }
5198 
5199 
5224  unsigned long *uid)
5225 {
5226  dbus_bool_t result;
5227 
5228  _dbus_return_val_if_fail (connection != NULL, FALSE);
5229  _dbus_return_val_if_fail (uid != NULL, FALSE);
5230 
5231  CONNECTION_LOCK (connection);
5232 
5234  result = FALSE;
5235  else
5236  result = _dbus_transport_get_unix_user (connection->transport,
5237  uid);
5238 
5239 #ifdef DBUS_WIN
5240  _dbus_assert (!result);
5241 #endif
5242 
5243  CONNECTION_UNLOCK (connection);
5244 
5245  return result;
5246 }
5247 
5260  unsigned long *pid)
5261 {
5262  dbus_bool_t result;
5263 
5264  _dbus_return_val_if_fail (connection != NULL, FALSE);
5265  _dbus_return_val_if_fail (pid != NULL, FALSE);
5266 
5267  CONNECTION_LOCK (connection);
5268 
5270  result = FALSE;
5271  else
5272  result = _dbus_transport_get_unix_process_id (connection->transport,
5273  pid);
5274 
5275  CONNECTION_UNLOCK (connection);
5276 
5277  return result;
5278 }
5279 
5293  void **data,
5294  dbus_int32_t *data_size)
5295 {
5296  dbus_bool_t result;
5297 
5298  _dbus_return_val_if_fail (connection != NULL, FALSE);
5299  _dbus_return_val_if_fail (data != NULL, FALSE);
5300  _dbus_return_val_if_fail (data_size != NULL, FALSE);
5301 
5302  CONNECTION_LOCK (connection);
5303 
5305  result = FALSE;
5306  else
5308  data,
5309  data_size);
5310  CONNECTION_UNLOCK (connection);
5311 
5312  return result;
5313 }
5314 
5337 void
5339  DBusAllowUnixUserFunction function,
5340  void *data,
5341  DBusFreeFunction free_data_function)
5342 {
5343  void *old_data = NULL;
5344  DBusFreeFunction old_free_function = NULL;
5345 
5346  _dbus_return_if_fail (connection != NULL);
5347 
5348  CONNECTION_LOCK (connection);
5350  function, data, free_data_function,
5351  &old_data, &old_free_function);
5352  CONNECTION_UNLOCK (connection);
5353 
5354  if (old_free_function != NULL)
5355  (* old_free_function) (old_data);
5356 }
5357 
5358 /* Same calling convention as dbus_connection_get_windows_user */
5360 _dbus_connection_get_linux_security_label (DBusConnection *connection,
5361  char **label_p)
5362 {
5363  dbus_bool_t result;
5364 
5365  _dbus_assert (connection != NULL);
5366  _dbus_assert (label_p != NULL);
5367 
5368  CONNECTION_LOCK (connection);
5369 
5371  result = FALSE;
5372  else
5373  result = _dbus_transport_get_linux_security_label (connection->transport,
5374  label_p);
5375 #ifndef __linux__
5376  _dbus_assert (!result);
5377 #endif
5378 
5379  CONNECTION_UNLOCK (connection);
5380 
5381  return result;
5382 }
5383 
5417  char **windows_sid_p)
5418 {
5419  dbus_bool_t result;
5420 
5421  _dbus_return_val_if_fail (connection != NULL, FALSE);
5422  _dbus_return_val_if_fail (windows_sid_p != NULL, FALSE);
5423 
5424  CONNECTION_LOCK (connection);
5425 
5427  result = FALSE;
5428  else
5429  result = _dbus_transport_get_windows_user (connection->transport,
5430  windows_sid_p);
5431 
5432 #ifdef DBUS_UNIX
5433  _dbus_assert (!result);
5434 #endif
5435 
5436  CONNECTION_UNLOCK (connection);
5437 
5438  return result;
5439 }
5440 
5462 void
5465  void *data,
5466  DBusFreeFunction free_data_function)
5467 {
5468  void *old_data = NULL;
5469  DBusFreeFunction old_free_function = NULL;
5470 
5471  _dbus_return_if_fail (connection != NULL);
5472 
5473  CONNECTION_LOCK (connection);
5475  function, data, free_data_function,
5476  &old_data, &old_free_function);
5477  CONNECTION_UNLOCK (connection);
5478 
5479  if (old_free_function != NULL)
5480  (* old_free_function) (old_data);
5481 }
5482 
5509 void
5511  dbus_bool_t value)
5512 {
5513  _dbus_return_if_fail (connection != NULL);
5514 
5515  CONNECTION_LOCK (connection);
5516  _dbus_transport_set_allow_anonymous (connection->transport, value);
5517  CONNECTION_UNLOCK (connection);
5518 }
5519 
5537 void
5539  dbus_bool_t value)
5540 {
5541  _dbus_return_if_fail (connection != NULL);
5542 
5543  CONNECTION_LOCK (connection);
5544  connection->route_peer_messages = value;
5545  CONNECTION_UNLOCK (connection);
5546 }
5547 
5571  DBusHandleMessageFunction function,
5572  void *user_data,
5573  DBusFreeFunction free_data_function)
5574 {
5575  DBusMessageFilter *filter;
5576 
5577  _dbus_return_val_if_fail (connection != NULL, FALSE);
5578  _dbus_return_val_if_fail (function != NULL, FALSE);
5579 
5580  filter = dbus_new0 (DBusMessageFilter, 1);
5581  if (filter == NULL)
5582  return FALSE;
5583 
5584  _dbus_atomic_inc (&filter->refcount);
5585 
5586  CONNECTION_LOCK (connection);
5587 
5588  if (!_dbus_list_append (&connection->filter_list,
5589  filter))
5590  {
5591  _dbus_message_filter_unref (filter);
5592  CONNECTION_UNLOCK (connection);
5593  return FALSE;
5594  }
5595 
5596  /* Fill in filter after all memory allocated,
5597  * so we don't run the free_user_data_function
5598  * if the add_filter() fails
5599  */
5600 
5601  filter->function = function;
5602  filter->user_data = user_data;
5603  filter->free_user_data_function = free_data_function;
5604 
5605  CONNECTION_UNLOCK (connection);
5606  return TRUE;
5607 }
5608 
5621 void
5623  DBusHandleMessageFunction function,
5624  void *user_data)
5625 {
5626  DBusList *link;
5627  DBusMessageFilter *filter;
5628 
5629  _dbus_return_if_fail (connection != NULL);
5630  _dbus_return_if_fail (function != NULL);
5631 
5632  CONNECTION_LOCK (connection);
5633 
5634  filter = NULL;
5635 
5636  link = _dbus_list_get_last_link (&connection->filter_list);
5637  while (link != NULL)
5638  {
5639  filter = link->data;
5640 
5641  if (filter->function == function &&
5642  filter->user_data == user_data)
5643  {
5644  _dbus_list_remove_link (&connection->filter_list, link);
5645  filter->function = NULL;
5646 
5647  break;
5648  }
5649 
5650  link = _dbus_list_get_prev_link (&connection->filter_list, link);
5651  filter = NULL;
5652  }
5653 
5654  CONNECTION_UNLOCK (connection);
5655 
5656 #ifndef DBUS_DISABLE_CHECKS
5657  if (filter == NULL)
5658  {
5659  _dbus_warn_check_failed ("Attempt to remove filter function %p user data %p, but no such filter has been added\n",
5660  function, user_data);
5661  return;
5662  }
5663 #endif
5664 
5665  /* Call application code */
5666  if (filter->free_user_data_function)
5667  (* filter->free_user_data_function) (filter->user_data);
5668 
5669  filter->free_user_data_function = NULL;
5670  filter->user_data = NULL;
5671 
5672  _dbus_message_filter_unref (filter);
5673 }
5674 
5690 static dbus_bool_t
5691 _dbus_connection_register_object_path (DBusConnection *connection,
5692  dbus_bool_t fallback,
5693  const char *path,
5694  const DBusObjectPathVTable *vtable,
5695  void *user_data,
5696  DBusError *error)
5697 {
5698  char **decomposed_path;
5699  dbus_bool_t retval;
5700 
5701  if (!_dbus_decompose_path (path, strlen (path), &decomposed_path, NULL))
5702  return FALSE;
5703 
5704  CONNECTION_LOCK (connection);
5705 
5706  retval = _dbus_object_tree_register (connection->objects,
5707  fallback,
5708  (const char **) decomposed_path, vtable,
5709  user_data, error);
5710 
5711  CONNECTION_UNLOCK (connection);
5712 
5713  dbus_free_string_array (decomposed_path);
5714 
5715  return retval;
5716 }
5717 
5732  const char *path,
5733  const DBusObjectPathVTable *vtable,
5734  void *user_data,
5735  DBusError *error)
5736 {
5737  _dbus_return_val_if_fail (connection != NULL, FALSE);
5738  _dbus_return_val_if_fail (path != NULL, FALSE);
5739  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5740  _dbus_return_val_if_fail (vtable != NULL, FALSE);
5741 
5742  return _dbus_connection_register_object_path (connection, FALSE, path, vtable, user_data, error);
5743 }
5744 
5762  const char *path,
5763  const DBusObjectPathVTable *vtable,
5764  void *user_data)
5765 {
5766  dbus_bool_t retval;
5767  DBusError error = DBUS_ERROR_INIT;
5768 
5769  _dbus_return_val_if_fail (connection != NULL, FALSE);
5770  _dbus_return_val_if_fail (path != NULL, FALSE);
5771  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5772  _dbus_return_val_if_fail (vtable != NULL, FALSE);
5773 
5774  retval = _dbus_connection_register_object_path (connection, FALSE, path, vtable, user_data, &error);
5775 
5777  {
5778  _dbus_warn ("%s\n", error.message);
5779  dbus_error_free (&error);
5780  return FALSE;
5781  }
5782 
5783  return retval;
5784 }
5785 
5802  const char *path,
5803  const DBusObjectPathVTable *vtable,
5804  void *user_data,
5805  DBusError *error)
5806 {
5807  _dbus_return_val_if_fail (connection != NULL, FALSE);
5808  _dbus_return_val_if_fail (path != NULL, FALSE);
5809  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5810  _dbus_return_val_if_fail (vtable != NULL, FALSE);
5811 
5812  return _dbus_connection_register_object_path (connection, TRUE, path, vtable, user_data, error);
5813 }
5814 
5834  const char *path,
5835  const DBusObjectPathVTable *vtable,
5836  void *user_data)
5837 {
5838  dbus_bool_t retval;
5839  DBusError error = DBUS_ERROR_INIT;
5840 
5841  _dbus_return_val_if_fail (connection != NULL, FALSE);
5842  _dbus_return_val_if_fail (path != NULL, FALSE);
5843  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5844  _dbus_return_val_if_fail (vtable != NULL, FALSE);
5845 
5846  retval = _dbus_connection_register_object_path (connection, TRUE, path, vtable, user_data, &error);
5847 
5849  {
5850  _dbus_warn ("%s\n", error.message);
5851  dbus_error_free (&error);
5852  return FALSE;
5853  }
5854 
5855  return retval;
5856 }
5857 
5869  const char *path)
5870 {
5871  char **decomposed_path;
5872 
5873  _dbus_return_val_if_fail (connection != NULL, FALSE);
5874  _dbus_return_val_if_fail (path != NULL, FALSE);
5875  _dbus_return_val_if_fail (path[0] == '/', FALSE);
5876 
5877  if (!_dbus_decompose_path (path, strlen (path), &decomposed_path, NULL))
5878  return FALSE;
5879 
5880  CONNECTION_LOCK (connection);
5881 
5882  _dbus_object_tree_unregister_and_unlock (connection->objects, (const char **) decomposed_path);
5883 
5884  dbus_free_string_array (decomposed_path);
5885 
5886  return TRUE;
5887 }
5888 
5901  const char *path,
5902  void **data_p)
5903 {
5904  char **decomposed_path;
5905 
5906  _dbus_return_val_if_fail (connection != NULL, FALSE);
5907  _dbus_return_val_if_fail (path != NULL, FALSE);
5908  _dbus_return_val_if_fail (data_p != NULL, FALSE);
5909 
5910  *data_p = NULL;
5911 
5912  if (!_dbus_decompose_path (path, strlen (path), &decomposed_path, NULL))
5913  return FALSE;
5914 
5915  CONNECTION_LOCK (connection);
5916 
5917  *data_p = _dbus_object_tree_get_user_data_unlocked (connection->objects, (const char**) decomposed_path);
5918 
5919  CONNECTION_UNLOCK (connection);
5920 
5921  dbus_free_string_array (decomposed_path);
5922 
5923  return TRUE;
5924 }
5925 
5938  const char *parent_path,
5939  char ***child_entries)
5940 {
5941  char **decomposed_path;
5942  dbus_bool_t retval;
5943  _dbus_return_val_if_fail (connection != NULL, FALSE);
5944  _dbus_return_val_if_fail (parent_path != NULL, FALSE);
5945  _dbus_return_val_if_fail (parent_path[0] == '/', FALSE);
5946  _dbus_return_val_if_fail (child_entries != NULL, FALSE);
5947 
5948  if (!_dbus_decompose_path (parent_path, strlen (parent_path), &decomposed_path, NULL))
5949  return FALSE;
5950 
5951  CONNECTION_LOCK (connection);
5952 
5954  (const char **) decomposed_path,
5955  child_entries);
5956  dbus_free_string_array (decomposed_path);
5957 
5958  return retval;
5959 }
5960 
5961 static DBusDataSlotAllocator slot_allocator =
5962  _DBUS_DATA_SLOT_ALLOCATOR_INIT (_DBUS_LOCK_NAME (connection_slots));
5963 
5980 {
5981  return _dbus_data_slot_allocator_alloc (&slot_allocator,
5982  slot_p);
5983 }
5984 
5996 void
5997 dbus_connection_free_data_slot (dbus_int32_t *slot_p)
5998 {
5999  _dbus_return_if_fail (*slot_p >= 0);
6000 
6001  _dbus_data_slot_allocator_free (&slot_allocator, slot_p);
6002 }
6003 
6028  dbus_int32_t slot,
6029  void *data,
6030  DBusFreeFunction free_data_func)
6031 {
6032  DBusFreeFunction old_free_func;
6033  void *old_data;
6034  dbus_bool_t retval;
6035 
6036  _dbus_return_val_if_fail (connection != NULL, FALSE);
6037  _dbus_return_val_if_fail (slot >= 0, FALSE);
6038 
6039  SLOTS_LOCK (connection);
6040 
6041  retval = _dbus_data_slot_list_set (&slot_allocator,
6042  &connection->slot_list,
6043  slot, data, free_data_func,
6044  &old_free_func, &old_data);
6045 
6046  SLOTS_UNLOCK (connection);
6047 
6048  if (retval)
6049  {
6050  /* Do the actual free outside the connection lock */
6051  if (old_free_func)
6052  (* old_free_func) (old_data);
6053  }
6054 
6055  return retval;
6056 }
6057 
6075 void*
6077  dbus_int32_t slot)
6078 {
6079  void *res;
6080 
6081  _dbus_return_val_if_fail (connection != NULL, NULL);
6082  _dbus_return_val_if_fail (slot >= 0, NULL);
6083 
6084  SLOTS_LOCK (connection);
6085 
6086  res = _dbus_data_slot_list_get (&slot_allocator,
6087  &connection->slot_list,
6088  slot);
6089 
6090  SLOTS_UNLOCK (connection);
6091 
6092  return res;
6093 }
6094 
6101 void
6103 {
6104  _dbus_modify_sigpipe = will_modify_sigpipe != FALSE;
6105 }
6106 
6115 void
6117  long size)
6118 {
6119  _dbus_return_if_fail (connection != NULL);
6120 
6121  CONNECTION_LOCK (connection);
6123  size);
6124  CONNECTION_UNLOCK (connection);
6125 }
6126 
6133 long
6135 {
6136  long res;
6137 
6138  _dbus_return_val_if_fail (connection != NULL, 0);
6139 
6140  CONNECTION_LOCK (connection);
6141  res = _dbus_transport_get_max_message_size (connection->transport);
6142  CONNECTION_UNLOCK (connection);
6143  return res;
6144 }
6145 
6154 void
6156  long n)
6157 {
6158  _dbus_return_if_fail (connection != NULL);
6159 
6160  CONNECTION_LOCK (connection);
6162  n);
6163  CONNECTION_UNLOCK (connection);
6164 }
6165 
6172 long
6174 {
6175  long res;
6176 
6177  _dbus_return_val_if_fail (connection != NULL, 0);
6178 
6179  CONNECTION_LOCK (connection);
6181  CONNECTION_UNLOCK (connection);
6182  return res;
6183 }
6184 
6210 void
6212  long size)
6213 {
6214  _dbus_return_if_fail (connection != NULL);
6215 
6216  CONNECTION_LOCK (connection);
6218  size);
6219  CONNECTION_UNLOCK (connection);
6220 }
6221 
6228 long
6230 {
6231  long res;
6232 
6233  _dbus_return_val_if_fail (connection != NULL, 0);
6234 
6235  CONNECTION_LOCK (connection);
6237  CONNECTION_UNLOCK (connection);
6238  return res;
6239 }
6240 
6252 void
6254  long n)
6255 {
6256  _dbus_return_if_fail (connection != NULL);
6257 
6258  CONNECTION_LOCK (connection);
6260  n);
6261  CONNECTION_UNLOCK (connection);
6262 }
6263 
6270 long
6272 {
6273  long res;
6274 
6275  _dbus_return_val_if_fail (connection != NULL, 0);
6276 
6277  CONNECTION_LOCK (connection);
6279  CONNECTION_UNLOCK (connection);
6280  return res;
6281 }
6282 
6293 long
6295 {
6296  long res;
6297 
6298  _dbus_return_val_if_fail (connection != NULL, 0);
6299 
6300  CONNECTION_LOCK (connection);
6301  res = _dbus_counter_get_size_value (connection->outgoing_counter);
6302  CONNECTION_UNLOCK (connection);
6303  return res;
6304 }
6305 
6306 #ifdef DBUS_ENABLE_STATS
6307 void
6308 _dbus_connection_get_stats (DBusConnection *connection,
6309  dbus_uint32_t *in_messages,
6310  dbus_uint32_t *in_bytes,
6311  dbus_uint32_t *in_fds,
6312  dbus_uint32_t *in_peak_bytes,
6313  dbus_uint32_t *in_peak_fds,
6314  dbus_uint32_t *out_messages,
6315  dbus_uint32_t *out_bytes,
6316  dbus_uint32_t *out_fds,
6317  dbus_uint32_t *out_peak_bytes,
6318  dbus_uint32_t *out_peak_fds)
6319 {
6320  CONNECTION_LOCK (connection);
6321 
6322  if (in_messages != NULL)
6323  *in_messages = connection->n_incoming;
6324 
6325  _dbus_transport_get_stats (connection->transport,
6326  in_bytes, in_fds, in_peak_bytes, in_peak_fds);
6327 
6328  if (out_messages != NULL)
6329  *out_messages = connection->n_outgoing;
6330 
6331  if (out_bytes != NULL)
6332  *out_bytes = _dbus_counter_get_size_value (connection->outgoing_counter);
6333 
6334  if (out_fds != NULL)
6335  *out_fds = _dbus_counter_get_unix_fd_value (connection->outgoing_counter);
6336 
6337  if (out_peak_bytes != NULL)
6338  *out_peak_bytes = _dbus_counter_get_peak_size_value (connection->outgoing_counter);
6339 
6340  if (out_peak_fds != NULL)
6341  *out_peak_fds = _dbus_counter_get_peak_unix_fd_value (connection->outgoing_counter);
6342 
6343  CONNECTION_UNLOCK (connection);
6344 }
6345 #endif /* DBUS_ENABLE_STATS */
6346 
6354 long
6356 {
6357  long res;
6358 
6359  _dbus_return_val_if_fail (connection != NULL, 0);
6360 
6361  CONNECTION_LOCK (connection);
6363  CONNECTION_UNLOCK (connection);
6364  return res;
6365 }
6366 
6367 #ifdef DBUS_ENABLE_EMBEDDED_TESTS
6368 
6374 const char*
6375 _dbus_connection_get_address (DBusConnection *connection)
6376 {
6377  return _dbus_transport_get_address (connection->transport);
6378 }
6379 #endif
6380 
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:279
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
void(* DBusTimeoutToggledFunction)(DBusTimeout *timeout, void *data)
Called when dbus_timeout_get_enabled() may return a different value than it did before.
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:239
void(* DBusRemoveWatchFunction)(DBusWatch *watch, void *data)
Called when libdbus no longer needs a watch to be monitored by the main loop.
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:701
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:1248
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.
DBUS_PRIVATE_EXPORT 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.
dbus_bool_t(* DBusWatchAddFunction)(DBusWatchList *list, DBusWatch *watch)
Function to be called in protected_change_watch() with refcount held.
void(* DBusDispatchStatusFunction)(DBusConnection *connection, DBusDispatchStatus new_status, void *data)
Called when the return value of dbus_connection_get_dispatch_status() may have changed.
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:211
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:194
#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 &quot;critical&quot; 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(* DBusWakeupMainFunction)(void *data)
Called when the main loop&#39;s thread should be notified that there&#39;s now work to do.
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.
#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.
void(* DBusTimeoutToggleFunction)(DBusTimeoutList *list, DBusTimeout *timeout, dbus_bool_t enabled)
Function to be called in protected_change_timeout() with refcount held.
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.
void(* DBusWatchRemoveFunction)(DBusWatchList *list, DBusWatch *watch)
Function to be called in protected_change_watch() with refcount held.
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
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:1151
DBUS_PRIVATE_EXPORT 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:148
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.
dbus_bool_t(* DBusAddWatchFunction)(DBusWatch *watch, void *data)
Called when libdbus needs a new watch to be monitored by the main loop.
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().
DBusHandlerResult(* DBusHandleMessageFunction)(DBusConnection *connection, DBusMessage *message, void *user_data)
Called when a message needs to be handled.
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:1397
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:310
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.
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.
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_bool_t(* DBusAddTimeoutFunction)(DBusTimeout *timeout, void *data)
Called when libdbus needs a new timeout to be monitored by the main loop.
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:1214
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 _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
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.
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.
DBUS_PRIVATE_EXPORT 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:781
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
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...
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
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:362
dbus_uint32_t _dbus_pending_call_get_reply_serial_unlocked(DBusPendingCall *pending)
Gets the reply&#39;s serial number.
void(* DBusWatchToggleFunction)(DBusWatchList *list, DBusWatch *watch, dbus_bool_t enabled)
Function to be called in protected_change_watch() with refcount held.
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()
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 &quot;1&quot;.
DBUS_PRIVATE_EXPORT 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 _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; &quot;something went wrong&quot; - 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.
void(* DBusTimeoutRemoveFunction)(DBusTimeoutList *list, DBusTimeout *timeout)
Function to be called in protected_change_timeout() with refcount held.
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 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.
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...
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:1123
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:340
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.
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:749
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:1049
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:1074
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.
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...
#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 &quot;0&quot;.
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:810
#define _DBUS_LOCK(name)
Locks a global lock, initializing it first if necessary.
dbus_bool_t dbus_parse_address(const char *address, DBusAddressEntry ***entry, int *array_len, DBusError *error)
Parses an address string of the form:
Definition: dbus-address.c:363
#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
void(* DBusWatchToggledFunction)(DBusWatch *watch, void *data)
Called when dbus_watch_get_enabled() may return a different value than it did before.
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...
DBUS_PRIVATE_EXPORT 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(* DBusRemoveTimeoutFunction)(DBusTimeout *timeout, void *data)
Called when libdbus no longer needs a timeout to be monitored by the main loop.
DBUS_PRIVATE_EXPORT 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:176
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_bool_t(* DBusTimeoutAddFunction)(DBusTimeoutList *list, DBusTimeout *timeout)
Function to be called in protected_change_timeout() with refcount held.
DBUS_EXPORT int dbus_timeout_get_interval(DBusTimeout *timeout)
Gets the timeout interval.
Definition: dbus-timeout.c:416
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.