dbus-message-private.h revision 98ad8a8ec6626f7f5c78915b6bdf2be688b4839f
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 32DBUS_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 */ 60struct 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 */ 88struct 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 116dbus_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 123DBUS_END_DECLS 124 125#endif /* DBUS_MESSAGE_H */ 126