1 /* -*- mode: C; c-file-style: "gnu" -*- */ 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 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 70 unsigned int buffer_outstanding : 1; /**< Someone is using the buffer to read */ 71 72 unsigned int corrupted : 1; /**< We got broken data, and are no longer working */ 73 74 DBusValidity corruption_reason; /**< why we were corrupted */ 75 }; 76 77 78 /** How many bits are in the changed_stamp used to validate iterators */ 79 #define CHANGED_STAMP_BITS 21 80 81 /** 82 * @brief Internals of DBusMessage 83 * 84 * Object representing a message received from or to be sent to 85 * another application. This is an opaque object, all members 86 * are private. 87 */ 88 struct DBusMessage 89 { 90 DBusAtomic refcount; /**< Reference count */ 91 92 DBusHeader header; /**< Header network data and associated cache */ 93 94 DBusString body; /**< Body network data. */ 95 96 char byte_order; /**< Message byte order. */ 97 98 unsigned int locked : 1; /**< Message being sent, no modifications allowed. */ 99 100 #ifndef DBUS_DISABLE_CHECKS 101 unsigned int in_cache : 1; /**< Has been "freed" since it's in the cache (this is a debug feature) */ 102 #endif 103 104 DBusList *size_counters; /**< 0-N DBusCounter used to track message size. */ 105 long size_counter_delta; /**< Size we incremented the size counters by. */ 106 107 dbus_uint32_t changed_stamp : CHANGED_STAMP_BITS; /**< Incremented when iterators are invalidated. */ 108 109 DBusDataSlotList slot_list; /**< Data stored by allocated integer ID */ 110 111 #ifndef DBUS_DISABLE_CHECKS 112 int generation; /**< _dbus_current_generation when message was created */ 113 #endif 114 }; 115 116 dbus_bool_t _dbus_message_iter_get_args_valist (DBusMessageIter *iter, 117 DBusError *error, 118 int first_arg_type, 119 va_list var_args); 120 121 /** @} */ 122 123 DBUS_END_DECLS 124 125 #endif /* DBUS_MESSAGE_H */ 126