1 /**
2  * This file is part of TelepathyQt
3  *
4  * @copyright Copyright (C) 2008 Collabora Ltd. <http://www.collabora.co.uk/>
5  * @copyright Copyright (C) 2008 Nokia Corporation
6  * @license LGPL 2.1
7  *
8  * This library is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * This library 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 GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with this library; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
21  */
22 
23 #ifndef _TelepathyQt_constants_h_HEADER_GUARD_
24 #define _TelepathyQt_constants_h_HEADER_GUARD_
25 
26 #ifndef IN_TP_QT_HEADER
27 #error IN_TP_QT_HEADER
28 #endif
29 
30 /**
31  * \addtogroup typesconstants Types and constants
32  *
33  * Enumerated, flag, structure, list and mapping types and utility constants.
34  */
35 
36 /**
37  * \defgroup utilityconsts Utility string constants
38  * \ingroup typesconstants
39  *
40  * Utility constants which aren't generated from the specification but are
41  * useful for working with the Telepathy protocol.
42  * @{
43  */
44 
45 /**
46  * The prefix for a connection manager's bus name, to which the CM's name (e.g.
47  * "gabble") should be appended.
48  */
49 #define TP_QT_CONNECTION_MANAGER_BUS_NAME_BASE QLatin1String("org.freedesktop.Telepathy.ConnectionManager.")
50 
51 /**
52  * The prefix for a connection manager's object path, to which the CM's name
53  * (e.g. "gabble") should be appended.
54  */
55 #define TP_QT_CONNECTION_MANAGER_OBJECT_PATH_BASE QLatin1String("/org/freedesktop/Telepathy/ConnectionManager/")
56 
57 /**
58  * The prefix for a connection's bus name, to which the CM's name (e.g.
59  * "gabble"), the protocol (e.g. "jabber") and an element
60  * representing the account should be appended.
61  */
62 #define TP_QT_CONNECTION_BUS_NAME_BASE QLatin1String("org.freedesktop.Telepathy.Connection.")
63 
64 /**
65  * The prefix for a connection's object path, to which the CM's name (e.g.
66  * "gabble"), the protocol (e.g. "jabber") and an element
67  * representing the account should be appended.
68  */
69 #define TP_QT_CONNECTION_OBJECT_PATH_BASE QLatin1String("/org/freedesktop/Telepathy/Connection/")
70 
71 /**
72  * The well-known bus name of the Account Manager.
73  *
74  * \see Tp::AccountManager
75  */
76 #define TP_QT_ACCOUNT_MANAGER_BUS_NAME \
77     (QLatin1String("org.freedesktop.Telepathy.AccountManager"))
78 
79 /**
80  * The object path of the Account Manager object.
81  *
82  * \see Tp::AccountManager
83  */
84 #define TP_QT_ACCOUNT_MANAGER_OBJECT_PATH \
85     (QLatin1String("/org/freedesktop/Telepathy/AccountManager"))
86 
87 /**
88  * The well-known bus name of the Channel Dispatcher.
89  */
90 #define TP_QT_CHANNEL_DISPATCHER_BUS_NAME \
91     (QLatin1String("org.freedesktop.Telepathy.ChannelDispatcher"))
92 
93 /**
94  * The object path of the Channel Dispatcherr object.
95  */
96 #define TP_QT_CHANNEL_DISPATCHER_OBJECT_PATH \
97     (QLatin1String("/org/freedesktop/Telepathy/ChannelDispatcher"))
98 
99 /**
100  * The prefix for an Account's object path, to which the CM's name (e.g.
101  * "gabble"), the protocol (e.g. "jabber") and an element
102  * identifying the particular account should be appended.
103  *
104  * \see Tp::Account
105  */
106 #define TP_QT_ACCOUNT_OBJECT_PATH_BASE \
107     (QLatin1String("/org/freedesktop/Telepathy/Account"))
108 
109 /**
110  * The object path of the Debug object of various services.
111  */
112 #define TP_QT_DEBUG_OBJECT_PATH \
113     (QLatin1String("/org/freedesktop/Telepathy/debug"))
114 
115 /**
116  * @}
117  */
118 
119 #include <TelepathyQt/_gen/constants.h>
120 
121 /**
122  * \ingroup errorstrconsts
123  *
124  * The error name "org.freedesktop.DBus.Error.NameHasNoOwner" as a QLatin1String.
125  *
126  * Raised by the D-Bus daemon when looking up the owner of a well-known name,
127  * if no process owns that name.
128  *
129  * Also used by DBusProxy to indicate that the owner of a well-known name
130  * has disappeared (usually indicating that the process owning that name
131  * exited or crashed).
132  */
133 #define TP_QT_DBUS_ERROR_NAME_HAS_NO_OWNER \
134     (QLatin1String("org.freedesktop.DBus.Error.NameHasNoOwner"))
135 
136 /**
137  * \ingroup errorstrconsts
138  *
139  * The error name "org.freedesktop.DBus.Error.UnknownInterface" as a QLatin1String.
140  */
141 #define TP_QT_DBUS_ERROR_UNKNOWN_INTERFACE \
142     (QLatin1String("org.freedesktop.DBus.Error.UnknownInterface"))
143 
144 /**
145  * \ingroup errorstrconsts
146  *
147  * The error name "org.freedesktop.DBus.Error.UnknownMethod" as a QLatin1String.
148  *
149  * Raised by the D-Bus daemon when the method name invoked isn't
150  * known by the object you invoked it on.
151  */
152 #define TP_QT_DBUS_ERROR_UNKNOWN_METHOD \
153     (QLatin1String("org.freedesktop.DBus.Error.UnknownMethod"))
154 
155 /**
156  * \ingroup errorstrconsts
157  *
158  * The error name "org.freedesktop.Telepathy.Qt.Error.ObjectRemoved" as a QLatin1String.
159  */
160 #define TP_QT_ERROR_OBJECT_REMOVED \
161     (QLatin1String("org.freedesktop.Telepathy.Qt.Error.ObjectRemoved"))
162 
163 /**
164  * \ingroup errorstrconsts
165  *
166  * The error name "org.freedesktop.Telepathy.Qt.Error.Inconsistent" as a QLatin1String.
167  */
168 #define TP_QT_ERROR_INCONSISTENT \
169     (QLatin1String("org.freedesktop.Telepathy.Qt.Error.Inconsistent"))
170 
171 /**
172  * \ingroup errorstrconsts
173  *
174  * The error name "org.freedesktop.Telepathy.Qt.Error.Orphaned" as a QLatin1String.
175  *
176  * This error is used when the "parent" proxy of an object gets invalidated. For example, a Channel
177  * whose corresponding Connection is invalidated invalidates itself with this error, as do leftover
178  * StreamTube connections when their parent StreamTubeChannel is invalidated. The invalidation
179  * reason of the parent proxy might provide more information on the cause of the error.
180  */
181 #define TP_QT_ERROR_ORPHANED \
182     (QLatin1String("org.freedesktop.Telepathy.Qt.Error.Orphaned"))
183 
184 #endif
185