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>