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