1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */ 2 /* dbus-message-private.h header shared between dbus-message.c and dbus-message-util.c 3 * 4 * Copyright (C) 2005 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_MESSAGE_PRIVATE_H 24 #define DBUS_MESSAGE_PRIVATE_H 25 26 #include <dbus/dbus-message.h> 27 #include <dbus/dbus-message-internal.h> 28 #include <dbus/dbus-string.h> 29 #include <dbus/dbus-dataslot.h> 30 #include <dbus/dbus-marshal-header.h> 31 32 DBUS_BEGIN_DECLS 33 34 /** 35 * @addtogroup DBusMessageInternals 36 * @{ 37 */ 38 39 /** 40 * @typedef DBusMessageLoader 41 * 42 * The DBusMessageLoader object encapsulates the process of converting 43 * a byte stream into a series of DBusMessage. It buffers the incoming 44 * bytes as efficiently as possible, and generates a queue of 45 * messages. DBusMessageLoader is typically used as part of a 46 * DBusTransport implementation. The DBusTransport then hands off 47 * the loaded messages to a DBusConnection, making the messages 48 * visible to the application. 49 * 50 * @todo write tests for break-loader that a) randomly delete header 51 * fields and b) set string fields to zero-length and other funky 52 * values. 53 * 54 */ 55 56 /** 57 * Implementation details of DBusMessageLoader. 58 * All members are private. 59 */ 60 struct DBusMessageLoader 61 { 62 int refcount; /**< Reference count. */ 63 64 DBusString data; /**< Buffered data */ 65 66 DBusList *messages; /**< Complete messages. */ 67 68 long max_message_size; /**< Maximum size of a message */ 69 long max_message_unix_fds; /**< Maximum unix fds in a message */ 70 71 DBusValidity corruption_reason; /**< why we were corrupted */ 72 73 unsigned int corrupted : 1; /**< We got broken data, and are no longer working */ 74 75 unsigned int buffer_outstanding : 1; /**< Someone is using the buffer to read */ 76 77 #ifdef HAVE_UNIX_FD_PASSING 78 unsigned int unix_fds_outstanding : 1; /**< Someone is using the unix fd array to read */ 79 80 int *unix_fds; /**< File descriptors that have been read from the transport but not yet been handed to any message. Array will be allocated at first use. */ 81 unsigned n_unix_fds_allocated; /**< Number of file descriptors this array has space for */ 82 unsigned n_unix_fds; /**< Number of valid file descriptors in array */ 83 #endif 84 }; 85 86 87 /** How many bits are in the changed_stamp used to validate iterators */ 88 #define CHANGED_STAMP_BITS 21 89 90 /** 91 * @brief Internals of DBusMessage 92 * 93 * Object representing a message received from or to be sent to 94 * another application. This is an opaque object, all members 95 * are private. 96 */ 97 struct DBusMessage 98 { 99 DBusAtomic refcount; /**< Reference count */ 100 101 DBusHeader header; /**< Header network data and associated cache */ 102 103 DBusString body; /**< Body network data. */ 104 105 unsigned int locked : 1; /**< Message being sent, no modifications allowed. */ 106 107 #ifndef DBUS_DISABLE_CHECKS 108 unsigned int in_cache : 1; /**< Has been "freed" since it's in the cache (this is a debug feature) */ 109 #endif 110 111 DBusList *counters; /**< 0-N DBusCounter used to track message size/unix fds. */ 112 long size_counter_delta; /**< Size we incremented the size counters by. */ 113 114 dbus_uint32_t changed_stamp : CHANGED_STAMP_BITS; /**< Incremented when iterators are invalidated. */ 115 116 DBusDataSlotList slot_list; /**< Data stored by allocated integer ID */ 117 118 #ifndef DBUS_DISABLE_CHECKS 119 int generation; /**< _dbus_current_generation when message was created */ 120 #endif 121 122 #ifdef HAVE_UNIX_FD_PASSING 123 int *unix_fds; 124 /**< Unix file descriptors associated with this message. These are 125 closed when the message is destroyed, hence make sure to dup() 126 them when adding or removing them here. */ 127 unsigned n_unix_fds; /**< Number of valid fds in the array */ 128 unsigned n_unix_fds_allocated; /**< Allocated size of the array */ 129 130 long unix_fd_counter_delta; /**< Size we incremented the unix fd counter by */ 131 #endif 132 }; 133 134 dbus_bool_t _dbus_message_iter_get_args_valist (DBusMessageIter *iter, 135 DBusError *error, 136 int first_arg_type, 137 va_list var_args); 138 139 /** @} */ 140 141 DBUS_END_DECLS 142 143 #endif /* DBUS_MESSAGE_H */ 144