~ubuntu-branches/ubuntu/maverick/dbus/maverick-proposed

« back to all changes in this revision

Viewing changes to dbus/dbus-connection.h

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Riddell
  • Date: 2010-09-27 13:06:32 UTC
  • mfrom: (1.1.23 upstream)
  • Revision ID: james.westby@ubuntu.com-20100927130632-bqs145trvchd2lmf
Tags: 1.4.0-0ubuntu1
* New upstream release
 - Fixes https://bugs.freedesktop.org/show_bug.cgi?id=17754 Race condition in protected_change_timeout
 - Requested by various upstream KDE developers http://lists.kde.org/?t=128514970000004&r=1&w=2

Show diffs side-by-side

added added

removed removed

Lines of Context:
168
168
typedef DBusHandlerResult (* DBusHandleMessageFunction) (DBusConnection     *connection,
169
169
                                                         DBusMessage        *message,
170
170
                                                         void               *user_data);
171
 
 
 
171
DBUS_EXPORT
172
172
DBusConnection*    dbus_connection_open                         (const char                 *address,
173
173
                                                                 DBusError                  *error);
 
174
DBUS_EXPORT
174
175
DBusConnection*    dbus_connection_open_private                 (const char                 *address,
175
176
                                                                 DBusError                  *error);
 
177
DBUS_EXPORT
176
178
DBusConnection*    dbus_connection_ref                          (DBusConnection             *connection);
 
179
DBUS_EXPORT
177
180
void               dbus_connection_unref                        (DBusConnection             *connection);
 
181
DBUS_EXPORT
178
182
void               dbus_connection_close                        (DBusConnection             *connection);
 
183
DBUS_EXPORT
179
184
dbus_bool_t        dbus_connection_get_is_connected             (DBusConnection             *connection);
 
185
DBUS_EXPORT
180
186
dbus_bool_t        dbus_connection_get_is_authenticated         (DBusConnection             *connection);
 
187
DBUS_EXPORT
181
188
dbus_bool_t        dbus_connection_get_is_anonymous             (DBusConnection             *connection);
 
189
DBUS_EXPORT
182
190
char*              dbus_connection_get_server_id                (DBusConnection             *connection);
 
191
DBUS_EXPORT
 
192
dbus_bool_t        dbus_connection_can_send_type                (DBusConnection             *connection,
 
193
                                                                 int                         type);
 
194
 
 
195
DBUS_EXPORT
183
196
void               dbus_connection_set_exit_on_disconnect       (DBusConnection             *connection,
184
197
                                                                 dbus_bool_t                 exit_on_disconnect);
 
198
DBUS_EXPORT
185
199
void               dbus_connection_flush                        (DBusConnection             *connection);
 
200
DBUS_EXPORT
186
201
dbus_bool_t        dbus_connection_read_write_dispatch          (DBusConnection             *connection,
187
202
                                                                 int                         timeout_milliseconds);
 
203
DBUS_EXPORT
188
204
dbus_bool_t        dbus_connection_read_write                   (DBusConnection             *connection,
189
205
                                                                 int                         timeout_milliseconds);
 
206
DBUS_EXPORT
190
207
DBusMessage*       dbus_connection_borrow_message               (DBusConnection             *connection);
 
208
DBUS_EXPORT
191
209
void               dbus_connection_return_message               (DBusConnection             *connection,
192
210
                                                                 DBusMessage                *message);
 
211
DBUS_EXPORT
193
212
void               dbus_connection_steal_borrowed_message       (DBusConnection             *connection,
194
213
                                                                 DBusMessage                *message);
 
214
DBUS_EXPORT
195
215
DBusMessage*       dbus_connection_pop_message                  (DBusConnection             *connection);
 
216
DBUS_EXPORT
196
217
DBusDispatchStatus dbus_connection_get_dispatch_status          (DBusConnection             *connection);
 
218
DBUS_EXPORT
197
219
DBusDispatchStatus dbus_connection_dispatch                     (DBusConnection             *connection);
 
220
DBUS_EXPORT
198
221
dbus_bool_t        dbus_connection_has_messages_to_send         (DBusConnection *connection);
 
222
DBUS_EXPORT
199
223
dbus_bool_t        dbus_connection_send                         (DBusConnection             *connection,
200
224
                                                                 DBusMessage                *message,
201
225
                                                                 dbus_uint32_t              *client_serial);
 
226
DBUS_EXPORT
202
227
dbus_bool_t        dbus_connection_send_with_reply              (DBusConnection             *connection,
203
228
                                                                 DBusMessage                *message,
204
229
                                                                 DBusPendingCall           **pending_return,
205
230
                                                                 int                         timeout_milliseconds);
 
231
DBUS_EXPORT
206
232
DBusMessage *      dbus_connection_send_with_reply_and_block    (DBusConnection             *connection,
207
233
                                                                 DBusMessage                *message,
208
234
                                                                 int                         timeout_milliseconds,
209
235
                                                                 DBusError                  *error);
 
236
DBUS_EXPORT
210
237
dbus_bool_t        dbus_connection_set_watch_functions          (DBusConnection             *connection,
211
238
                                                                 DBusAddWatchFunction        add_function,
212
239
                                                                 DBusRemoveWatchFunction     remove_function,
213
240
                                                                 DBusWatchToggledFunction    toggled_function,
214
241
                                                                 void                       *data,
215
242
                                                                 DBusFreeFunction            free_data_function);
 
243
DBUS_EXPORT
216
244
dbus_bool_t        dbus_connection_set_timeout_functions        (DBusConnection             *connection,
217
245
                                                                 DBusAddTimeoutFunction      add_function,
218
246
                                                                 DBusRemoveTimeoutFunction   remove_function,
219
247
                                                                 DBusTimeoutToggledFunction  toggled_function,
220
248
                                                                 void                       *data,
221
249
                                                                 DBusFreeFunction            free_data_function);
 
250
DBUS_EXPORT
222
251
void               dbus_connection_set_wakeup_main_function     (DBusConnection             *connection,
223
252
                                                                 DBusWakeupMainFunction      wakeup_main_function,
224
253
                                                                 void                       *data,
225
254
                                                                 DBusFreeFunction            free_data_function);
 
255
DBUS_EXPORT
226
256
void               dbus_connection_set_dispatch_status_function (DBusConnection             *connection,
227
257
                                                                 DBusDispatchStatusFunction  function,
228
258
                                                                 void                       *data,
229
259
                                                                 DBusFreeFunction            free_data_function);
 
260
DBUS_EXPORT
230
261
dbus_bool_t        dbus_connection_get_unix_user                (DBusConnection             *connection,
231
262
                                                                 unsigned long              *uid);
 
263
DBUS_EXPORT
232
264
dbus_bool_t        dbus_connection_get_unix_process_id          (DBusConnection             *connection,
233
265
                                                                 unsigned long              *pid);
 
266
DBUS_EXPORT
234
267
dbus_bool_t        dbus_connection_get_adt_audit_session_data   (DBusConnection             *connection,
235
268
                                                                 void                      **data,
236
269
                                                                 dbus_int32_t               *data_size);
 
270
DBUS_EXPORT
237
271
void               dbus_connection_set_unix_user_function       (DBusConnection             *connection,
238
272
                                                                 DBusAllowUnixUserFunction   function,
239
273
                                                                 void                       *data,
240
274
                                                                 DBusFreeFunction            free_data_function);
 
275
DBUS_EXPORT
241
276
dbus_bool_t        dbus_connection_get_windows_user             (DBusConnection             *connection,
242
277
                                                                 char                      **windows_sid_p); 
 
278
DBUS_EXPORT
243
279
void               dbus_connection_set_windows_user_function    (DBusConnection             *connection,
244
280
                                                                 DBusAllowWindowsUserFunction function,
245
281
                                                                 void                       *data,
246
282
                                                                 DBusFreeFunction            free_data_function);
 
283
DBUS_EXPORT
247
284
void               dbus_connection_set_allow_anonymous          (DBusConnection             *connection,
248
285
                                                                 dbus_bool_t                 value);
 
286
DBUS_EXPORT
249
287
void               dbus_connection_set_route_peer_messages      (DBusConnection             *connection,
250
288
                                                                 dbus_bool_t                 value);
251
289
 
252
290
 
253
291
/* Filters */
254
292
 
 
293
DBUS_EXPORT
255
294
dbus_bool_t dbus_connection_add_filter    (DBusConnection            *connection,
256
295
                                           DBusHandleMessageFunction  function,
257
296
                                           void                      *user_data,
258
297
                                           DBusFreeFunction           free_data_function);
 
298
DBUS_EXPORT
259
299
void        dbus_connection_remove_filter (DBusConnection            *connection,
260
300
                                           DBusHandleMessageFunction  function,
261
301
                                           void                      *user_data);
262
302
 
263
303
 
264
304
/* Other */
 
305
DBUS_EXPORT
265
306
dbus_bool_t dbus_connection_allocate_data_slot (dbus_int32_t     *slot_p);
 
307
DBUS_EXPORT
266
308
void        dbus_connection_free_data_slot     (dbus_int32_t     *slot_p);
 
309
DBUS_EXPORT
267
310
dbus_bool_t dbus_connection_set_data           (DBusConnection   *connection,
268
311
                                                dbus_int32_t      slot,
269
312
                                                void             *data,
270
313
                                                DBusFreeFunction  free_data_func);
 
314
DBUS_EXPORT
271
315
void*       dbus_connection_get_data           (DBusConnection   *connection,
272
316
                                                dbus_int32_t      slot);
273
317
 
 
318
DBUS_EXPORT
274
319
void        dbus_connection_set_change_sigpipe (dbus_bool_t       will_modify_sigpipe); 
275
320
 
 
321
DBUS_EXPORT
276
322
void dbus_connection_set_max_message_size  (DBusConnection *connection,
277
323
                                            long            size);
 
324
DBUS_EXPORT
278
325
long dbus_connection_get_max_message_size  (DBusConnection *connection);
 
326
DBUS_EXPORT
279
327
void dbus_connection_set_max_received_size (DBusConnection *connection,
280
328
                                            long            size);
 
329
DBUS_EXPORT
281
330
long dbus_connection_get_max_received_size (DBusConnection *connection);
 
331
 
 
332
DBUS_EXPORT
 
333
void dbus_connection_set_max_message_unix_fds (DBusConnection *connection,
 
334
                                               long            n);
 
335
DBUS_EXPORT
 
336
long dbus_connection_get_max_message_unix_fds (DBusConnection *connection);
 
337
DBUS_EXPORT
 
338
void dbus_connection_set_max_received_unix_fds(DBusConnection *connection,
 
339
                                               long            n);
 
340
DBUS_EXPORT
 
341
long dbus_connection_get_max_received_unix_fds(DBusConnection *connection);
 
342
 
 
343
DBUS_EXPORT
282
344
long dbus_connection_get_outgoing_size     (DBusConnection *connection);
 
345
DBUS_EXPORT
 
346
long dbus_connection_get_outgoing_unix_fds (DBusConnection *connection);
283
347
 
 
348
DBUS_EXPORT
284
349
DBusPreallocatedSend* dbus_connection_preallocate_send       (DBusConnection       *connection);
 
350
DBUS_EXPORT
285
351
void                  dbus_connection_free_preallocated_send (DBusConnection       *connection,
286
352
                                                              DBusPreallocatedSend *preallocated);
 
353
DBUS_EXPORT
287
354
void                  dbus_connection_send_preallocated      (DBusConnection       *connection,
288
355
                                                              DBusPreallocatedSend *preallocated,
289
356
                                                              DBusMessage          *message,
324
391
  void (* dbus_internal_pad4) (void *); /**< Reserved for future expansion */
325
392
};
326
393
 
 
394
DBUS_EXPORT
327
395
dbus_bool_t dbus_connection_try_register_object_path (DBusConnection              *connection,
328
396
                                                      const char                  *path,
329
397
                                                      const DBusObjectPathVTable  *vtable,
330
398
                                                      void                        *user_data,
331
399
                                                      DBusError                   *error);
332
400
 
 
401
DBUS_EXPORT
333
402
dbus_bool_t dbus_connection_register_object_path   (DBusConnection              *connection,
334
403
                                                    const char                  *path,
335
404
                                                    const DBusObjectPathVTable  *vtable,
336
405
                                                    void                        *user_data);
337
406
 
 
407
DBUS_EXPORT
338
408
dbus_bool_t dbus_connection_try_register_fallback (DBusConnection              *connection,
339
409
                                                   const char                  *path,
340
410
                                                   const DBusObjectPathVTable  *vtable,
341
411
                                                   void                        *user_data,
342
412
                                                   DBusError                   *error);
343
413
 
 
414
DBUS_EXPORT
344
415
dbus_bool_t dbus_connection_register_fallback      (DBusConnection              *connection,
345
416
                                                    const char                  *path,
346
417
                                                    const DBusObjectPathVTable  *vtable,
347
418
                                                    void                        *user_data);
 
419
DBUS_EXPORT
348
420
dbus_bool_t dbus_connection_unregister_object_path (DBusConnection              *connection,
349
421
                                                    const char                  *path);
350
422
 
 
423
DBUS_EXPORT
351
424
dbus_bool_t dbus_connection_get_object_path_data   (DBusConnection              *connection,
352
425
                                                    const char                  *path,
353
426
                                                    void                       **data_p);
354
427
 
 
428
DBUS_EXPORT
355
429
dbus_bool_t dbus_connection_list_registered        (DBusConnection              *connection,
356
430
                                                    const char                  *parent_path,
357
431
                                                    char                      ***child_entries);
358
432
 
 
433
DBUS_EXPORT
359
434
dbus_bool_t dbus_connection_get_unix_fd            (DBusConnection              *connection,
360
435
                                                    int                         *fd);
 
436
DBUS_EXPORT
361
437
dbus_bool_t dbus_connection_get_socket             (DBusConnection              *connection,
362
438
                                                    int                         *fd);
363
439
 
370
446
 */
371
447
 
372
448
#ifndef DBUS_DISABLE_DEPRECATED
 
449
DBUS_EXPORT
373
450
DBUS_DEPRECATED int dbus_watch_get_fd      (DBusWatch        *watch);
374
451
#endif
375
452
 
 
453
DBUS_EXPORT
376
454
int          dbus_watch_get_unix_fd (DBusWatch        *watch);
 
455
DBUS_EXPORT
377
456
int          dbus_watch_get_socket  (DBusWatch        *watch);
 
457
DBUS_EXPORT
378
458
unsigned int dbus_watch_get_flags   (DBusWatch        *watch);
 
459
DBUS_EXPORT
379
460
void*        dbus_watch_get_data    (DBusWatch        *watch);
 
461
DBUS_EXPORT
380
462
void         dbus_watch_set_data    (DBusWatch        *watch,
381
463
                                     void             *data,
382
464
                                     DBusFreeFunction  free_data_function);
 
465
DBUS_EXPORT
383
466
dbus_bool_t  dbus_watch_handle      (DBusWatch        *watch,
384
467
                                     unsigned int      flags);
 
468
DBUS_EXPORT
385
469
dbus_bool_t  dbus_watch_get_enabled (DBusWatch        *watch);
386
470
 
387
471
/** @} */
391
475
 * @{
392
476
 */
393
477
 
 
478
DBUS_EXPORT
394
479
int         dbus_timeout_get_interval (DBusTimeout      *timeout);
 
480
DBUS_EXPORT
395
481
void*       dbus_timeout_get_data     (DBusTimeout      *timeout);
 
482
DBUS_EXPORT
396
483
void        dbus_timeout_set_data     (DBusTimeout      *timeout,
397
484
                                       void             *data,
398
485
                                       DBusFreeFunction  free_data_function);
 
486
DBUS_EXPORT
399
487
dbus_bool_t dbus_timeout_handle       (DBusTimeout      *timeout);
 
488
DBUS_EXPORT
400
489
dbus_bool_t dbus_timeout_get_enabled  (DBusTimeout      *timeout);
401
490
 
402
491
/** @} */