dbus/dbus-transport.h

   1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
   2 /* dbus-transport.h DBusTransport object (internal to D-BUS implementation)
   3  *
   4  * Copyright (C) 2002, 2004  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 #ifndef DBUS_TRANSPORT_H
  24 #define DBUS_TRANSPORT_H
  25
  26 #include <dbus/dbus-internals.h>
  27 #include <dbus/dbus-connection.h>
  28 #include <dbus/dbus-protocol.h>
  29 #include <dbus/dbus-address.h>
  30
  31 DBUS_BEGIN_DECLS
  32
  33 typedef struct DBusTransport DBusTransport;
  34
  35 DBusTransport*     _dbus_transport_open                   (DBusAddressEntry           *entry,
  36                                                            DBusError                  *error);
  37 DBusTransport*     _dbus_transport_ref                    (DBusTransport              *transport);
  38 void               _dbus_transport_unref                  (DBusTransport              *transport);
  39 void               _dbus_transport_disconnect             (DBusTransport              *transport);
  40 dbus_bool_t        _dbus_transport_get_is_connected       (DBusTransport              *transport);
  41 dbus_bool_t        _dbus_transport_peek_is_authenticated  (DBusTransport              *transport);
  42 dbus_bool_t        _dbus_transport_try_to_authenticate    (DBusTransport              *transport);
  43 dbus_bool_t        _dbus_transport_get_is_anonymous       (DBusTransport              *transport);
  44 dbus_bool_t        _dbus_transport_can_pass_unix_fd       (DBusTransport              *transport);
  45 dbus_bool_t        _dbus_transport_can_send_sync_call     (DBusTransport              *transport);
  46
  47 const char*        _dbus_transport_get_address            (DBusTransport              *transport);
  48 const char*        _dbus_transport_get_server_id          (DBusTransport              *transport);
  49 dbus_bool_t        _dbus_transport_handle_watch           (DBusTransport              *transport,
  50                                                            DBusWatch                  *watch,
  51                                                            unsigned int                condition);
  52 dbus_bool_t        _dbus_transport_set_connection         (DBusTransport              *transport,
  53                                                            DBusConnection             *connection);
  54 void               _dbus_transport_do_iteration           (DBusTransport              *transport,
  55                                                            unsigned int                flags,
  56                                                            int                         timeout_milliseconds);
  57 DBusDispatchStatus _dbus_transport_get_dispatch_status    (DBusTransport              *transport);
  58 dbus_bool_t        _dbus_transport_queue_messages         (DBusTransport              *transport);
  59
  60 void               _dbus_transport_set_max_message_size   (DBusTransport              *transport,
  61                                                            long                        size);
  62 long               _dbus_transport_get_max_message_size   (DBusTransport              *transport);
  63 void               _dbus_transport_set_max_received_size  (DBusTransport              *transport,
  64                                                            long                        size);
  65 long               _dbus_transport_get_max_received_size  (DBusTransport              *transport);
  66
  67 void               _dbus_transport_set_max_message_unix_fds (DBusTransport              *transport,
  68                                                              long                        n);
  69 long               _dbus_transport_get_max_message_unix_fds (DBusTransport              *transport);
  70 void               _dbus_transport_set_max_received_unix_fds(DBusTransport              *transport,
  71                                                              long                        n);
  72 long               _dbus_transport_get_max_received_unix_fds(DBusTransport              *transport);
  73
  74 dbus_bool_t        _dbus_transport_get_socket_fd          (DBusTransport              *transport,
  75                                                            DBusSocket                 *fd_p);
  76 dbus_bool_t        _dbus_transport_get_unix_user          (DBusTransport              *transport,
  77                                                            unsigned long              *uid);
  78 dbus_bool_t        _dbus_transport_get_unix_process_id     (DBusTransport              *transport,
  79                                                            unsigned long              *pid);
  80 dbus_bool_t        _dbus_transport_get_adt_audit_session_data (DBusTransport              *transport,
  81                                                                void                      **data,
  82                                                                int                        *data_size);
  83 void               _dbus_transport_set_unix_user_function (DBusTransport              *transport,
  84                                                            DBusAllowUnixUserFunction   function,
  85                                                            void                       *data,
  86                                                            DBusFreeFunction            free_data_function,
  87                                                            void                      **old_data,
  88                                                            DBusFreeFunction           *old_free_data_function);
  89 dbus_bool_t        _dbus_transport_get_windows_user       (DBusTransport              *transport,
  90                                                            char                      **windows_sid_p);
  91 dbus_bool_t        _dbus_transport_get_linux_security_label (DBusTransport            *transport,
  92                                                            char                      **label_p);
  93
  94 void               _dbus_transport_set_windows_user_function (DBusTransport              *transport,
  95                                                               DBusAllowWindowsUserFunction   function,
  96                                                               void                       *data,
  97                                                               DBusFreeFunction            free_data_function,
  98                                                               void                      **old_data,
  99                                                               DBusFreeFunction           *old_free_data_function);
 100 dbus_bool_t        _dbus_transport_set_auth_mechanisms    (DBusTransport              *transport,
 101                                                            const char                **mechanisms);
 102 void               _dbus_transport_set_allow_anonymous    (DBusTransport              *transport,
 103                                                            dbus_bool_t                 value);
 104 int                _dbus_transport_get_pending_fds_count  (DBusTransport              *transport);
 105 void               _dbus_transport_set_pending_fds_function (DBusTransport *transport,
 106                                                              void (* callback) (void *),
 107                                                              void *data);
 108
 109 dbus_bool_t        _dbus_transport_assure_protocol_version (DBusTransport             *transport,
 110                                                             DBusMessage              **message);
 111 DBusMessage*       _dbus_transport_send_sync_call          (DBusTransport             *transport,
 112                                                             DBusMessage               *message);
 113 dbus_bool_t        _dbus_transport_get_overflowed          (DBusTransport             *transport);
 114
 115 /* if DBUS_ENABLE_STATS */
 116 void _dbus_transport_get_stats (DBusTransport  *transport,
 117                                 dbus_uint32_t  *queue_bytes,
 118                                 dbus_uint32_t  *queue_fds,
 119                                 dbus_uint32_t  *peak_queue_bytes,
 120                                 dbus_uint32_t  *peak_queue_fds);
 121
 122 DBUS_END_DECLS
 123
 124 #endif /* DBUS_TRANSPORT_H */