Connections

A Connection object in Telepathy represents an active (or activatable) protocol session. Connections are created by the appropriate Connection Manager.

A connection can be located on the D-Bus session bus via the well-known name org.freedesktop.Telepathy.Connection.cm.proto.account, where cm is the name of the Connection Manager that created the connection (e.g. gabble, salut) and proto is the name of a Telepathy Protocol (e.g. jabber, msn, irc). The connection object can then be retrieved from the path /org/freedesktop/Telepathy/Connection/cm/proto/account.

Depending on what features are supported by the protocol, a given connection will implement more interfaces than just Connection. The interfaces supported by a given connection can be retreived using the GetInterfaces method once the connection is in the CONNECTED state. The supported list of interfaces doesn't change during the life on a connection, so it is expected that a client will retreive this once the connection is CONNECTED.

Interfaces that a connection might support are: