tp_protocol_get_name ()

const gchar *
tp_protocol_get_name (TpProtocol *self);

Return the same thing as the protocol-name property, for convenient use in C code. The returned string is valid for as long as self exists.

Since 0.11.11

tp_protocol_get_cm_name ()

const gchar *
tp_protocol_get_cm_name (TpProtocol *self);

Return the “cm-name” property.

Since 0.19.1

tp_protocol_get_params ()

GPtrArray *
tp_protocol_get_params (TpProtocol *self);

Returns an array of parameters supported by this connection manager, without additional memory allocations. The returned array is owned by self , and must not be used after self has been freed.

Since 0.99.1

tp_protocol_dup_params ()

GList *
tp_protocol_dup_params (TpProtocol *self);

Returns a list of parameters supported by this connection manager.

The returned list must be freed by the caller, for instance with g_list_free_full (l, (GDestroyNotify) tp_connection_manager_param_free).

Since 0.17.6

tp_protocol_dup_param_names ()

GStrv
tp_protocol_dup_param_names (TpProtocol *self);

Returns a list of parameter names supported by this connection manager for this protocol.

The result is copied and must be freed by the caller with g_strfreev().

Since 0.11.11

tp_protocol_get_param ()

const TpConnectionManagerParam *
tp_protocol_get_param (TpProtocol *self,
                       const gchar *param);

Since 0.11.11

tp_protocol_dup_param ()

TpConnectionManagerParam *
tp_protocol_dup_param (TpProtocol *self,
                       const gchar *param);

Since 0.17.6

tp_protocol_has_param ()

gboolean
tp_protocol_has_param (TpProtocol *self,
                       const gchar *param);

Since 0.11.11

tp_protocol_can_register ()

gboolean
tp_protocol_can_register (TpProtocol *self);

Return whether a new account can be registered on this protocol, by setting the special "register" parameter to TRUE.

Since 0.11.11

tp_protocol_dup_immutable_properties ()

GVariant *
tp_protocol_dup_immutable_properties (TpProtocol *self);

Return the “protocol-propertiesproperty”.

Since 0.99.8

tp_protocol_get_capabilities ()

TpCapabilities *
tp_protocol_get_capabilities (TpProtocol *self);

Since 0.11.11

tp_protocol_get_english_name ()

const gchar *
tp_protocol_get_english_name (TpProtocol *self);

Since 0.11.11

tp_protocol_get_icon_name ()

const gchar *
tp_protocol_get_icon_name (TpProtocol *self);

Since 0.11.11

tp_protocol_get_vcard_field ()

const gchar *
tp_protocol_get_vcard_field (TpProtocol *self);

Since 0.11.11

tp_protocol_get_authentication_types ()

const gchar * const *
tp_protocol_get_authentication_types (TpProtocol *self);

Since 0.13.9

tp_protocol_identify_account_async ()

void
tp_protocol_identify_account_async (TpProtocol *self,
                                    GVariant *vardict,
                                    GCancellable *cancellable,
                                    GAsyncReadyCallback callback,
                                    gpointer user_data);

Return a string that could identify the account with the given parameters. In most protocols that string is a normalized 'account' parameter, but some protocols have more complex requirements; for instance, on IRC, the 'account' (nickname) is insufficient, and must be combined with a server or network name.

Since 0.99.5

tp_protocol_identify_account_finish ()

gchar *
tp_protocol_identify_account_finish (TpProtocol *self,
                                     GAsyncResult *result,
                                     GError **error);

Interpret the result of tp_protocol_identify_account_async().

Since 0.99.5

tp_protocol_normalize_contact_async ()

void
tp_protocol_normalize_contact_async (TpProtocol *self,
                                     const gchar *contact,
                                     GCancellable *cancellable,
                                     GAsyncReadyCallback callback,
                                     gpointer user_data);

Perform best-effort offline contact normalization. This does syntactic normalization (e.g. transforming case-insensitive text to lower-case), but does not query servers or anything similar.

Since 0.99.5

tp_protocol_normalize_contact_finish ()

gchar *
tp_protocol_normalize_contact_finish (TpProtocol *self,
                                      GAsyncResult *result,
                                      GError **error);

Interpret the result of tp_protocol_normalize_contact_async().

Since 0.99.5

tp_protocol_get_avatar_requirements ()

TpAvatarRequirements *
tp_protocol_get_avatar_requirements (TpProtocol *self);

Return the “avatar-requirements” property

Since 0.15.6

tp_protocol_dup_presence_statuses ()

GList *
tp_protocol_dup_presence_statuses (TpProtocol *self);

Return the presence statuses that might be supported by connections to this protocol.

It is possible that some of these statuses will not actually be supported by a connection: for instance, an XMPP connection manager would include "hidden" in this list, even though not all XMPP servers allow users to be online-but-hidden.

tp_protocol_get_addressable_uri_schemes ()

const gchar * const *
tp_protocol_get_addressable_uri_schemes
                               (TpProtocol *self);

Since 0.99.5

tp_protocol_get_addressable_vcard_fields ()

const gchar * const *
tp_protocol_get_addressable_vcard_fields
                               (TpProtocol *self);

Since 0.99.5

tp_protocol_normalize_contact_uri_async ()

void
tp_protocol_normalize_contact_uri_async
                               (TpProtocol *self,
                                const gchar *uri,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Perform best-effort offline contact normalization, for a contact in the form of a URI. This method will fail if the URI is not in a scheme supported by this protocol or connection manager.

Since 0.99.5

tp_protocol_normalize_contact_uri_finish ()

gchar *
tp_protocol_normalize_contact_uri_finish
                               (TpProtocol *self,
                                GAsyncResult *result,
                                GError **error);

Interpret the result of tp_protocol_normalize_contact_uri_async().

Since 0.99.5

tp_protocol_normalize_vcard_address_async ()

void
tp_protocol_normalize_vcard_address_async
                               (TpProtocol *self,
                                const gchar *field,
                                const gchar *value,
                                GCancellable *cancellable,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Perform best-effort offline contact normalization, for a contact in the form of a vCard field. This method will fail if the vCard field is not supported by this protocol or connection manager.

Since 0.99.5

tp_protocol_normalize_vcard_address_finish ()

gchar *
tp_protocol_normalize_vcard_address_finish
                               (TpProtocol *self,
                                GAsyncResult *result,
                                GError **error);

Interpret the result of tp_protocol_normalize_vcard_address_async().

Since 0.99.5

struct TpProtocol

struct TpProtocol;

A base class for connection managers' protocols.

Since 0.11.11

TpProtocolClass

typedef struct _TpProtocolClass TpProtocolClass;

The class of a TpProtocol.

Since 0.11.11

TP_PROTOCOL_FEATURE_PARAMETERS

#define             TP_PROTOCOL_FEATURE_PARAMETERS

Expands to a call to a function that returns a quark for the parameters feature of a TpProtocol.

When this feature is prepared, the possible parameters for connections to this protocol have been retrieved and are available for use.

Unlike TP_PROTOCOL_FEATURE_CORE, this feature can even be available on connection managers that don't really have Protocol objects (on these older connection managers, the TpProtocol uses information from ConnectionManager methods to provide the list of parameters).

One can ask for a feature to be prepared using the tp_proxy_prepare_async() function, and waiting for it to callback.

Since 0.11.11

TP_PROTOCOL_FEATURE_CORE

#define             TP_PROTOCOL_FEATURE_CORE

Expands to a call to a function that returns a quark for the core feature of a TpProtocol.

When this feature is prepared, at least the following basic information about the protocol is available:

(This feature implies that TP_PROTOCOL_FEATURE_PARAMETERS is also available.)

Unlike TP_PROTOCOL_FEATURE_PARAMETERS, this feature can only become available on connection managers that implement Protocol objects.

One can ask for a feature to be prepared using the tp_proxy_prepare_async() function, and waiting for it to callback.

Since 0.11.11

The “addressable-uri-schemes” property

  “addressable-uri-schemes”  GStrv

A non-NULL GStrv of URI schemes supported by this protocol. If this protocol does not support addressing contacts by URI, the list is empty.

For instance, a SIP connection manager that supports calling contacts by SIP URI (sip:alice@example.com, sips:bob@example.com) or telephone number (tel:+1-555-0123) might have { "sip", "sips", "tel", NULL }.

Flags: Read

Since 0.99.5

The “addressable-vcard-fields” property

  “addressable-vcard-fields” GStrv

A non-NULL GStrv of vCard fields supported by this protocol. If this protocol does not support addressing contacts by a vCard field, the list is empty.

For instance, a SIP connection manager that supports calling contacts by SIP URI (vCard field SIP) or telephone number (vCard field TEL) might have { "sip", "tel", NULL }.

Flags: Read

Since 0.99.5

The “authentication-types” property

  “authentication-types”     GStrv

A non-NULL GStrv of interfaces which provide information as to what kind of authentication channels can possibly appear before the connection reaches the CONNECTED state, or NULL if TP_PROTOCOL_FEATURE_CORE has not been prepared.

Flags: Read

Since 0.13.9

The “avatar-requirements” property

  “avatar-requirements”      gpointer

A TpAvatarRequirements representing the avatar requirements on this protocol, or NULL if TP_PROTOCOL_FEATURE_CORE has not been prepared or if the protocol doesn't support avatars.

Flags: Read

Since 0.15.6

The “capabilities” property

  “capabilities”             TpCapabilities *

The classes of channel that can be requested from connections to this protocol, or NULL if this is unknown or the TP_PROTOCOL_FEATURE_CORE feature has not been prepared.

Flags: Read

Since 0.11.11

The “cm-name” property

  “cm-name”                  gchar *

The name of the connection manager this protocol is on.

Flags: Read / Write / Construct Only

Default value: NULL

Since 0.19.1

The “english-name” property

  “english-name”             gchar *

The name of the protocol in a form suitable for display to users, such as "AIM" or "Yahoo!", or a string based on “protocol-name” (currently constructed by putting the first character in title case, but this is not guaranteed) if no better name is available or the TP_PROTOCOL_FEATURE_CORE feature has not been prepared.

This is effectively in the C locale (international English); user interfaces requiring a localized protocol name should look one up in their own message catalog based on either “protocol-name” or “english-name”, but should use this English version as a fallback if no translated version can be found.

Flags: Read

Default value: NULL

Since 0.11.11

The “icon-name” property

  “icon-name”                gchar *

The name of an icon in the system's icon theme. If none was supplied by the Protocol, or the TP_PROTOCOL_FEATURE_CORE feature has not been prepared, a default is used; currently, this is "im-" plus “protocol-name”.

Flags: Read

Default value: NULL

Since 0.11.11

The “param-names” property

  “param-names”              GStrv

A list of parameter names supported by this connection manager for this protocol, or NULL if TP_PROTOCOL_FEATURE_PARAMETERS has not been prepared.

Flags: Read

Since 0.11.11

The “protocol-name” property

  “protocol-name”            gchar *

The machine-readable name of the protocol, taken from the Telepathy D-Bus Interface Specification, such as "jabber" or "local-xmpp".

Flags: Read / Write / Construct Only

Default value: NULL

Since 0.11.11

The “protocol-properties” property

  “protocol-properties”      GVariant *

The immutable properties of this Protocol, as provided at construction time. This is a G_VARIANT_TYPE_VARDICT GVariant, which must not be modified.

If the immutable properties were not provided at construction time, the TP_PROTOCOL_FEATURE_PARAMETERS and TP_PROTOCOL_FEATURE_CORE features will both be unavailable, and this TpProtocol object will only be useful as a way to access lower-level D-Bus calls.

Flags: Read / Write / Construct Only

Allowed values: GVariant<a{sv}>

Default value: NULL

Since 0.23.3

The “vcard-field” property

  “vcard-field”              gchar *

The most common vCard field used for this protocol's contact identifiers, normalized to lower case, or NULL if there is no such field or the TP_PROTOCOL_FEATURE_CORE feature has not been prepared.

Flags: Read

Default value: NULL

Since 0.11.11