Warning, /network/telepathy-logger-qt/spec/all.xml is written in an unsupported language. File is not indexed.
0001 <tp:spec 0002 xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0" 0003 xmlns:xi="http://www.w3.org/2001/XInclude"> 0004 0005 <tp:title>Telepathy D-Bus Interface Specification</tp:title> 0006 <tp:version>0.21.8</tp:version> 0007 0008 <tp:copyright>Copyright © 2005-2010 Collabora Limited</tp:copyright> 0009 <tp:copyright>Copyright © 2005-2010 Nokia Corporation</tp:copyright> 0010 <tp:copyright>Copyright © 2006 INdT</tp:copyright> 0011 0012 <tp:license xmlns="http://www.w3.org/1999/xhtml"> 0013 <p>This library is free software; you can redistribute it and/or 0014 modify it under the terms of the GNU Lesser General Public 0015 License as published by the Free Software Foundation; either 0016 version 2.1 of the License, or (at your option) any later version.</p> 0017 0018 <p>This library is distributed in the hope that it will be useful, 0019 but WITHOUT ANY WARRANTY; without even the implied warranty of 0020 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 0021 Lesser General Public License for more details.</p> 0022 0023 <p>You should have received a copy of the GNU Lesser General Public 0024 License along with this library; if not, write to the Free Software 0025 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p> 0026 </tp:license> 0027 0028 <!--<tp:section name="Connection Managers"> 0029 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0030 <p> 0031 A Connection Manager is a factory for connections. 0032 </p> 0033 </tp:docstring> 0034 <xi:include href="Connection_Manager.xml"/> 0035 <xi:include href="Protocol.xml"/> 0036 <xi:include href="Protocol_Interface_Addressing.xml"/> 0037 <xi:include href="Protocol_Interface_Avatars.xml"/> 0038 <xi:include href="Protocol_Interface_Presence.xml"/> 0039 0040 <tp:section name="Connection Object"> 0041 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0042 <p> 0043 Connections represent active protocol sessions. There are a number of core 0044 interfaces which all connections should implement, and a number of optional 0045 interfaces which provide various functionality related to contacts and to 0046 the connection itself. 0047 </p> 0048 </tp:docstring> 0049 <xi:include href="Connection.xml"/> 0050 <xi:include href="Connection_Future.xml"/> 0051 <xi:include href="Connection_Interface_Contacts.xml"/> 0052 <xi:include href="Connection_Interface_Requests.xml"/> 0053 0054 <tp:section name="Contact list interfaces"> 0055 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0056 <p> 0057 On protocols that support contact lists, these interface expose the user's 0058 contact lists, along with presence subscription information and contact 0059 list groups (if supported). 0060 </p> 0061 </tp:docstring> 0062 0063 <xi:include href="Connection_Interface_Contact_List.xml"/> 0064 <xi:include href="Connection_Interface_Contact_Groups.xml"/> 0065 </tp:section> 0066 0067 <tp:section name="Contact metadata interfaces"> 0068 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0069 <p> 0070 These optional Connection interfaces expose metadata about contacts on 0071 this connection—from their current presence through to the type of client 0072 they're connected with—and allow the local user to publish such metadata 0073 back to their contacts. 0074 </p> 0075 </tp:docstring> 0076 0077 <xi:include href="Connection_Interface_Aliasing.xml"/> 0078 <xi:include href="Connection_Interface_Avatars.xml"/> 0079 <xi:include href="Connection_Interface_Capabilities.xml"/> 0080 <xi:include href="Connection_Interface_Client_Types.xml"/> 0081 <xi:include href="Connection_Interface_Contact_Capabilities.xml"/> 0082 <xi:include href="Connection_Interface_Contact_Info.xml"/> 0083 <xi:include href="Connection_Interface_Location.xml"/> 0084 <xi:include href="Connection_Interface_Presence.xml"/> 0085 <xi:include href="Connection_Interface_Renaming.xml"/> 0086 <xi:include href="Connection_Interface_Resources.xml"/> 0087 <xi:include href="Connection_Interface_Simple_Presence.xml"/> 0088 </tp:section> 0089 0090 <tp:section name="Connection feature interfaces"> 0091 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0092 <p> 0093 These optional Connection interfaces expose protocol-specific features, 0094 and allow configuring the running connection. 0095 </p> 0096 </tp:docstring> 0097 0098 <xi:include href="Connection_Interface_Addressing.xml"/> 0099 <xi:include href="Connection_Interface_Anonymity.xml"/> 0100 <xi:include href="Connection_Interface_Balance.xml"/> 0101 <xi:include href="Connection_Interface_Cellular.xml"/> 0102 <xi:include href="Connection_Interface_Communication_Policy.xml"/> 0103 <xi:include href="Connection_Interface_Forwarding.xml"/> 0104 <xi:include href="Connection_Interface_Keepalive.xml"/> 0105 <xi:include href="Connection_Interface_Mail_Notification.xml"/> 0106 <xi:include href="Connection_Interface_Power_Saving.xml"/> 0107 <xi:include href="Connection_Interface_Service_Point.xml"/> 0108 </tp:section> 0109 </tp:section> 0110 0111 <xi:include href="Channel_Bundle.xml"/> 0112 0113 <tp:section name="Channel Object"> 0114 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0115 <p> 0116 A Channel is used by Telepathy to exchange data between local 0117 applications and remote servers. A given connection will have many 0118 channels, each one represented by a D-Bus object. 0119 </p> 0120 <p> 0121 Each Channel has a type, represented by a D-Bus interface, and may 0122 implement one or more additional interfaces from the list of channel 0123 interfaces below. 0124 </p> 0125 </tp:docstring> 0126 <xi:include href="Channel.xml"/> 0127 <xi:include href="Channel_Future.xml"/> 0128 0129 <tp:section name="Channel Types"> 0130 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0131 <p> 0132 Each Channel implements one of the following types: 0133 </p> 0134 </tp:docstring> 0135 <xi:include href="Channel_Type_Call.xml"/> 0136 <xi:include href="Channel_Type_Contact_List.xml"/> 0137 <xi:include href="Channel_Type_Contact_Search.xml"/> 0138 <xi:include href="Channel_Type_DBus_Tube.xml"/> 0139 <xi:include href="Channel_Type_File_Transfer.xml"/> 0140 <xi:include href="Channel_Type_Room_List.xml"/> 0141 <xi:include href="Channel_Type_Server_Authentication.xml"/> 0142 <xi:include href="Channel_Type_Server_TLS_Connection.xml"/> 0143 <xi:include href="Channel_Type_Stream_Tube.xml"/> 0144 <xi:include href="Channel_Type_Streamed_Media.xml"/> 0145 <xi:include href="Channel_Type_Text.xml"/> 0146 <xi:include href="Channel_Type_Tubes.xml"/> 0147 </tp:section> 0148 0149 <tp:section name="Channel Interfaces"> 0150 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0151 <p> 0152 A Channel may also implement one or more of the following interfaces, 0153 depending on its type. Some interfaces are only applicable to particular 0154 channel types, while others may (in principle) appear on any type of 0155 channel. 0156 </p> 0157 </tp:docstring> 0158 0159 <xi:include href="Channel_Interface_Addressing.xml"/> 0160 <xi:include href="Channel_Interface_Anonymity.xml"/> 0161 <xi:include href="Channel_Interface_Destroyable.xml"/> 0162 <xi:include href="Channel_Interface_Group.xml"/> 0163 <xi:include href="Channel_Interface_Password.xml"/> 0164 <xi:include href="Channel_Interface_Room.xml"/> 0165 <xi:include href="Channel_Interface_SASL_Authentication.xml"/> 0166 <xi:include href="Channel_Interface_Securable.xml"/> 0167 <xi:include href="Channel_Interface_Service_Point.xml"/> 0168 <xi:include href="Channel_Interface_Tube.xml"/> 0169 0170 <tp:section name="Text-specific interfaces"> 0171 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0172 <p>These interfaces may only appear on channels of type <tp:dbus-ref 0173 namespace='ofdT.Channel.Type'>Text</tp:dbus-ref>.</p> 0174 </tp:docstring> 0175 0176 <xi:include href="Channel_Interface_Chat_State.xml"/> 0177 <xi:include href="Channel_Interface_HTML.xml"/> 0178 <xi:include href="Channel_Interface_Messages.xml"/> 0179 <xi:include href="Channel_Interface_SMS.xml"/> 0180 </tp:section> 0181 0182 <tp:section name="Streamed Media-related interfaces"> 0183 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0184 <p>These interfaces are only applicable to channels of type <tp:dbus-ref 0185 namespace='ofdT.Channel.Type'>StreamedMedia</tp:dbus-ref>, with the 0186 exception of the <tp:dbus-ref 0187 namespace='ofdT.Channel.Interface'>Hold</tp:dbus-ref> interface, which 0188 may also appear on <tp:dbus-ref 0189 namespace='ofdT.Channel.Type'>Call.DRAFT</tp:dbus-ref> channels.</p> 0190 </tp:docstring> 0191 0192 <xi:include href="Channel_Interface_Call_State.xml"/> 0193 <xi:include href="Channel_Interface_DTMF.xml"/> 0194 <xi:include href="Channel_Interface_Hold.xml"/> 0195 <xi:include href="Channel_Interface_Media_Signalling.xml"/> 0196 </tp:section> 0197 0198 <tp:section name="Conference-related interfaces"> 0199 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0200 <p>These interfaces provide functionality for ad-hoc conference calls and 0201 chat rooms. They are primarily intended for <tp:dbus-ref 0202 namespace='ofdT.Channel.Type'>Text</tp:dbus-ref>, <tp:dbus-ref 0203 namespace='ofdT.Channel.Type'>StreamedMedia</tp:dbus-ref> and 0204 <tp:dbus-ref namespace='ofdT.Channel.Type'>Call.DRAFT</tp:dbus-ref> 0205 channels, but may also appear on other types of channel.</p> 0206 </tp:docstring> 0207 0208 <xi:include href="Channel_Interface_Conference.xml"/> 0209 <xi:include href="Channel_Interface_Splittable.xml"/> 0210 <xi:include href="Channel_Interface_Mergeable_Conference.xml"/> 0211 </tp:section> 0212 </tp:section> 0213 </tp:section> 0214 0215 <tp:section name="Authentication Objects"> 0216 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0217 <p> 0218 A set of objects to be used for authentication purposes, such 0219 as TLS certificates or handshakes for negotiating end-to-end 0220 security. 0221 </p> 0222 </tp:docstring> 0223 <xi:include href="Authentication_TLS_Certificate.xml"/> 0224 </tp:section> 0225 0226 <tp:section name="Media"> 0227 <xi:include href="Media_Session_Handler.xml"/> 0228 <xi:include href="Media_Stream_Handler.xml"/> 0229 </tp:section> 0230 0231 <tp:section name="Calls"> 0232 <xi:include href="Call_Content.xml"/> 0233 <xi:include href="Call_Content_Interface_Media.xml"/> 0234 <xi:include href="Call_Content_Interface_Mute.xml"/> 0235 <xi:include href="Call_Content_Codec_Offer.xml"/> 0236 <xi:include href="Call_Stream.xml"/> 0237 <xi:include href="Call_Stream_Interface_Media.xml"/> 0238 <xi:include href="Call_Stream_Endpoint.xml"/> 0239 </tp:section>--> 0240 0241 <tp:section name="Debugging"> 0242 <xi:include href="Debug.xml"/> 0243 </tp:section> 0244 </tp:section> 0245 0246 <tp:section name="The Account Manager"> 0247 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0248 <p> 0249 The Account Manager is a desktop service that provides account configuration 0250 and can manage the connection managers. In general, clients will use the 0251 account manager to find out about instant messaging accounts and their 0252 associated connections. 0253 </p> 0254 </tp:docstring> 0255 <xi:include href="Account_Manager.xml"/> 0256 <xi:include href="Account.xml"/> 0257 <xi:include href="Account_Interface_Addressing.xml"/> 0258 <xi:include href="Account_Interface_Avatar.xml"/> 0259 <xi:include href="Account_Interface_Storage.xml"/> 0260 </tp:section> 0261 0262 <tp:section name="The Channel Dispatcher"> 0263 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0264 <p> 0265 The Channel Dispatcher is a desktop service whose purpose is to dispatch 0266 incoming Telepathy Channels to the appropriate client (e.g. incoming text 0267 chat, file transfer, tubes, etc.). 0268 </p> 0269 </tp:docstring> 0270 <xi:include href="Channel_Dispatcher.xml"/> 0271 <xi:include href="Channel_Dispatcher_Interface_Operation_List.xml"/> 0272 <xi:include href="Channel_Dispatch_Operation.xml"/> 0273 <xi:include href="Channel_Request.xml"/> 0274 </tp:section> 0275 0276 <tp:section name="Logger"> 0277 <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> 0278 <p> 0279 This allows a client to communicate with Telepathy Logger 0280 </p> 0281 </tp:docstring> 0282 <xi:include href="Logger.xml"/> 0283 </tp:section> 0284 0285 <xi:include href="Properties_Interface.xml"/> 0286 0287 <xi:include href="errors.xml"/> 0288 <xi:include href="generic-types.xml"/> 0289 0290 <!-- Never implemented, vague 0291 <xi:include href="Connection_Interface_Privacy.xml"/> --> 0292 <!-- Causes havoc, never implemented, unclear requirements 0293 <xi:include href="Channel_Interface_Transfer.xml"/> --> 0294 0295 </tp:spec>