Create, manage and search contacts. More...

Typedefs
typedef struct _LinphoneMagicSearch	LinphoneMagicSearch
	A LinphoneMagicSearch is used to search for contacts from various sources: More...

typedef struct _LinphoneMagicSearchCbs	LinphoneMagicSearchCbs
	LinphoneMagicSearchCbs is an interface to be notified of results of contact searches initiated from the LinphoneMagicSearch. More...

typedef struct _LinphoneSearchResult	LinphoneSearchResult
	The LinphoneSearchResult object represents a result of a search initiated from a LinphoneMagicSearch.

typedef struct _LinphoneCardDavParams	LinphoneCardDavParams
	The LinphoneCardDavParams object represents a remote CardDAV server used by LinphoneMagicSearch as a plugin source.

typedef struct _LinphoneRemoteContactDirectory	LinphoneRemoteContactDirectory
	Object that represents a remote contact directory such as a LDAP or CardDAV server; used as a LinphoneMagicSearch source.

typedef struct _LinphoneFriendPhoneNumber	LinphoneFriendPhoneNumber
	Object that represents a LinphoneFriend's phone number.

typedef struct _LinphoneFriendDevice	LinphoneFriendDevice
	Object that represents a LinphoneFriend's device (name, trust level) for a given SIP address.

Functions
LinphoneRemoteContactDirectory *	linphone_core_create_card_dav_remote_contact_directory (LinphoneCore core, LinphoneCardDavParams params)
	Creates a new CardDAV server params object that may be used later by LinphoneMagicSearch to query contacts. More...

LinphoneRemoteContactDirectory *	linphone_core_create_ldap_remote_contact_directory (LinphoneCore core, LinphoneLdapParams params)
	Creates a new CardDAV server params object that may be used later by LinphoneMagicSearch to query contacts. More...

void	linphone_core_add_remote_contact_directory (LinphoneCore core, LinphoneRemoteContactDirectory remoteContactDirectory)
	Adds a LinphoneRemoteContactDirectory object previously created to the Core, to be used later by LinphoneMagicSearch to query contacts using either LDAP or CardDAV. More...

void	linphone_core_remove_remote_contact_directory (LinphoneCore core, LinphoneRemoteContactDirectory remoteContactDirectory)
	Removes a LinphoneRemoteContactDirectory object previously added to the Core. More...

bctbx_list_t *	linphone_core_get_remote_contact_directories (LinphoneCore *core)
	Gets the list of currently configured LDAP or CardDAV remote servers used by LinphoneMagicSearch. More...

LinphoneCardDavParams *	linphone_core_create_card_dav_params (LinphoneCore *core)
	Creates a new CardDAV server params object that may be used later by LinphoneMagicSearch to query contacts. More...

LinphoneCardDavParams *	linphone_card_dav_params_clone (const LinphoneCardDavParams *params)
	Instantiates a new LinphoneCardDavParams with values from source. More...

LinphoneCardDavParams *	linphone_card_dav_params_ref (LinphoneCardDavParams *params)
	Takes a reference on a LinphoneCardDavParams. More...

void	linphone_card_dav_params_unref (LinphoneCardDavParams *params)
	Releases a LinphoneCardDavParams. More...

bctbx_list_t *	linphone_card_dav_params_get_user_input_fields (const LinphoneCardDavParams *params)
	Gets the list of vCard RFC fields to use to match user input text on. More...

void	linphone_card_dav_params_set_user_input_fields (LinphoneCardDavParams params, bctbx_list_t list)
	Sets the list of vCard RFC fields to use to match user input text on. More...

bctbx_list_t *	linphone_card_dav_params_get_domain_fields (const LinphoneCardDavParams *params)
	Gets the list of vCard RFC fields to use to match the domain filter on. More...

void	linphone_card_dav_params_set_domain_fields (LinphoneCardDavParams params, const bctbx_list_t list)
	Sets the list of vCard RFC fields to use to match the domain filter on. More...

bool_t	linphone_card_dav_params_get_use_exact_match_policy (const LinphoneCardDavParams *params)
	Gets the matching policy: TRUE if the remote vCard value must match the filter exactly, FALSE if it only needs to contain the filter. More...

void	linphone_card_dav_params_set_use_exact_match_policy (LinphoneCardDavParams *params, bool_t exact_match)
	Sets the matching policy: TRUE if the remote vCard value must match the filter exactly, FALSE if it only needs to contain the filter. More...

LinphoneRemoteContactDirectory *	linphone_remote_contact_directory_ref (LinphoneRemoteContactDirectory *remote_contact_directory)
	Takes a reference on a LinphoneRemoteContactDirectory. More...

void	linphone_remote_contact_directory_unref (LinphoneRemoteContactDirectory *remote_contact_directory)
	Releases a LinphoneRemoteContactDirectory. More...

LinphoneRemoteContactDirectoryType	linphone_remote_contact_directory_get_type (const LinphoneRemoteContactDirectory *remote_contact_directory)
	Gets the type of remote contact directory (LDAP, CardDAV). More...

LinphoneCardDavParams *	linphone_remote_contact_directory_get_card_dav_params (LinphoneRemoteContactDirectory *remote_contact_directory)
	Gets the CardDAV remote contact directory if linphone_remote_contact_directory_get_type() returns CardDAV. More...

LinphoneLdapParams *	linphone_remote_contact_directory_get_ldap_params (LinphoneRemoteContactDirectory *remote_contact_directory)
	Gets the LDAP remote_contact_directory if linphone_remote_contact_directory_get_type() returns LDAP. More...

const char *	linphone_remote_contact_directory_get_server_url (const LinphoneRemoteContactDirectory *remote_contact_directory)
	Gets the configured remote contact directory server URL. More...

void	linphone_remote_contact_directory_set_server_url (LinphoneRemoteContactDirectory remote_contact_directory, const char server_url)
	Sets the server URL to use to reach the remote contact directory server. More...

unsigned int	linphone_remote_contact_directory_get_limit (const LinphoneRemoteContactDirectory *remote_contact_directory)
	Gets the maximum number of results to fetch, 0 means no limit. More...

void	linphone_remote_contact_directory_set_limit (LinphoneRemoteContactDirectory *remote_contact_directory, unsigned int limit)
	Sets the maximum number of results to fetch, 0 means no limit. More...

unsigned int	linphone_remote_contact_directory_get_min_characters (const LinphoneRemoteContactDirectory *remote_contact_directory)
	Gets the minimum number of characters to have before sending the query to the server. More...

void	linphone_remote_contact_directory_set_min_characters (LinphoneRemoteContactDirectory *remote_contact_directory, unsigned int min)
	Sets the minimum number of characters to have before sending the query to the server. More...

unsigned int	linphone_remote_contact_directory_get_timeout (const LinphoneRemoteContactDirectory *remote_contact_directory)
	Gets the timeout (in seconds) after which the query is abandonned. More...

void	linphone_remote_contact_directory_set_timeout (LinphoneRemoteContactDirectory *remote_contact_directory, unsigned int seconds)
	Sets the timeout (in seconds) after which the query is abandonned. More...

Detailed Description

Create, manage and search contacts.

Typedef Documentation

◆ LinphoneMagicSearch

typedef struct _LinphoneMagicSearch LinphoneMagicSearch

A LinphoneMagicSearch is used to search for contacts from various sources:

LinphoneFriendList
Ldap connection (see LinphoneLdap)
Remote CardDAV server (see LinphoneCardDavParams)
Call logs, conferences and existing chat rooms.
See also
linphone_magic_search_get_contacts_list_async()

◆ LinphoneMagicSearchCbs

typedef struct _LinphoneMagicSearchCbs LinphoneMagicSearchCbs

LinphoneMagicSearchCbs is an interface to be notified of results of contact searches initiated from the LinphoneMagicSearch.

See also: linphone_magic_search_add_callbacks()

Function Documentation

◆ linphone_card_dav_params_clone()

LinphoneCardDavParams* linphone_card_dav_params_clone ( const LinphoneCardDavParams * params )

Instantiates a new LinphoneCardDavParams with values from source.

Parameters

params The LinphoneCardDavParams object to be cloned.

Returns: The newly created LinphoneCardDavParams object.

◆ linphone_card_dav_params_get_domain_fields()

bctbx_list_t* linphone_card_dav_params_get_domain_fields ( const LinphoneCardDavParams * params )

Gets the list of vCard RFC fields to use to match the domain filter on.

For example you can use "IMPP".

Parameters

The	LinphoneCardDavParams object.

Returns: The list of vCard fields to make the query on using domain filter.

◆ linphone_card_dav_params_get_use_exact_match_policy()

bool_t linphone_card_dav_params_get_use_exact_match_policy ( const LinphoneCardDavParams * params )

Gets the matching policy: TRUE if the remote vCard value must match the filter exactly, FALSE if it only needs to contain the filter.

Parameters

The	LinphoneCardDavParams object.

Returns: The matching policy: TRUE if the remote vCard value must match the filter exactly, FALSE if it only needs to contain the filter.

◆ linphone_card_dav_params_get_user_input_fields()

bctbx_list_t* linphone_card_dav_params_get_user_input_fields ( const LinphoneCardDavParams * params )

Gets the list of vCard RFC fields to use to match user input text on.

For example you can use "FN", "N", "IMPP", "ORG", etc...

Parameters

The	LinphoneCardDavParams object.

Returns: The list of vCard fields to make the query on using user input.

◆ linphone_card_dav_params_ref()

LinphoneCardDavParams* linphone_card_dav_params_ref ( LinphoneCardDavParams * params )

Takes a reference on a LinphoneCardDavParams.

Parameters

params The LinphoneCardDavParams object.

Returns: the same LinphoneCardDavParams object.

◆ linphone_card_dav_params_set_domain_fields()

void linphone_card_dav_params_set_domain_fields	(	LinphoneCardDavParams *	params,
		const bctbx_list_t *	list
	)

Sets the list of vCard RFC fields to use to match the domain filter on.

For example you can use "IMPP".

Parameters

The	LinphoneCardDavParams object.
list	the list of vCard RFC fields to use to match the domain filter on.

◆ linphone_card_dav_params_set_use_exact_match_policy()

void linphone_card_dav_params_set_use_exact_match_policy	(	LinphoneCardDavParams *	params,
		bool_t	exact_match
	)

Sets the matching policy: TRUE if the remote vCard value must match the filter exactly, FALSE if it only needs to contain the filter.

Parameters

The	LinphoneCardDavParams object.
exact_match	the policy to use: TRUE if the remote vCard value must match the filter exactly, FALSE if it only needs to contain the filter.

◆ linphone_card_dav_params_set_user_input_fields()

void linphone_card_dav_params_set_user_input_fields	(	LinphoneCardDavParams *	params,
		bctbx_list_t *	list
	)

Sets the list of vCard RFC fields to use to match user input text on.

For example you can use "FN", "N", "IMPP", "ORG", etc...

Parameters

The	LinphoneCardDavParams object.
list	the list of vCard RFC fields to use to match user input text on.

◆ linphone_card_dav_params_unref()

void linphone_card_dav_params_unref ( LinphoneCardDavParams * params )

Releases a LinphoneCardDavParams.

Parameters

params The LinphoneCardDavParams object.

◆ linphone_core_add_remote_contact_directory()

void linphone_core_add_remote_contact_directory	(	LinphoneCore *	core,
		LinphoneRemoteContactDirectory *	remoteContactDirectory
	)

Adds a LinphoneRemoteContactDirectory object previously created to the Core, to be used later by LinphoneMagicSearch to query contacts using either LDAP or CardDAV.

Parameters

core	LinphoneCore object.
remoteContactDirectory	the newly created LinphoneRemoteContactDirectory to add.

◆ linphone_core_create_card_dav_params()

LinphoneCardDavParams* linphone_core_create_card_dav_params ( LinphoneCore * core )

Creates a new CardDAV server params object that may be used later by LinphoneMagicSearch to query contacts.

Parameters

core	LinphoneCore object.

Returns: a new LinphoneCardDavParams object to configure, and then use it to create a LinphoneRemoteContactDirectory using linphone_core_create_card_dav_remote_contact_directory().

◆ linphone_core_create_card_dav_remote_contact_directory()

LinphoneRemoteContactDirectory* linphone_core_create_card_dav_remote_contact_directory	(	LinphoneCore *	core,
		LinphoneCardDavParams *	params
	)

Creates a new CardDAV server params object that may be used later by LinphoneMagicSearch to query contacts.

Parameters

core	LinphoneCore object.
params	the LinphoneCardDavParams to configure this remote contact directory.

Returns: a new LinphoneRemoteContactDirectory object to configure, and then add using linphone_core_add_remote_contact_directory().

◆ linphone_core_create_ldap_remote_contact_directory()

LinphoneRemoteContactDirectory* linphone_core_create_ldap_remote_contact_directory	(	LinphoneCore *	core,
		LinphoneLdapParams *	params
	)

Creates a new CardDAV server params object that may be used later by LinphoneMagicSearch to query contacts.

Parameters

core	LinphoneCore object.
params	the LinphoneLdapParams to configure this remote contact directory.

Returns: a new LinphoneRemoteContactDirectory object to configure, and then add using linphone_core_add_remote_contact_directory().

◆ linphone_core_get_remote_contact_directories()

bctbx_list_t* linphone_core_get_remote_contact_directories ( LinphoneCore * core )

Gets the list of currently configured LDAP or CardDAV remote servers used by LinphoneMagicSearch.

Parameters

core	LinphoneCore object.

Returns: the list of LinphoneRemoteContactDirectory currently configured, if any.

◆ linphone_core_remove_remote_contact_directory()

void linphone_core_remove_remote_contact_directory	(	LinphoneCore *	core,
		LinphoneRemoteContactDirectory *	remoteContactDirectory
	)

Removes a LinphoneRemoteContactDirectory object previously added to the Core.

Parameters

core	LinphoneCore object.
remoteContactDirectory	the LinphoneRemoteContactDirectory to remove.

◆ linphone_remote_contact_directory_get_card_dav_params()

LinphoneCardDavParams* linphone_remote_contact_directory_get_card_dav_params ( LinphoneRemoteContactDirectory * remote_contact_directory )

Gets the CardDAV remote contact directory if linphone_remote_contact_directory_get_type() returns CardDAV.

Parameters

remote_contact_directory The LinphoneRemoteContactDirectory object.

Returns: the LinphoneCardDavParams or NULL if not of CardDAV type.

◆ linphone_remote_contact_directory_get_ldap_params()

LinphoneLdapParams* linphone_remote_contact_directory_get_ldap_params ( LinphoneRemoteContactDirectory * remote_contact_directory )

Gets the LDAP remote_contact_directory if linphone_remote_contact_directory_get_type() returns LDAP.

Parameters

remote_contact_directory The LinphoneRemoteContactDirectory object.

Returns: the LinphoneLdapParams or NULL if not of LDAP type.

◆ linphone_remote_contact_directory_get_limit()

unsigned int linphone_remote_contact_directory_get_limit ( const LinphoneRemoteContactDirectory * remote_contact_directory )

Gets the maximum number of results to fetch, 0 means no limit.

Parameters

remote_contact_directory The LinphoneRemoteContactDirectory object.

Returns: the maximum number of results, 0 means no limit.

◆ linphone_remote_contact_directory_get_min_characters()

unsigned int linphone_remote_contact_directory_get_min_characters ( const LinphoneRemoteContactDirectory * remote_contact_directory )

Gets the minimum number of characters to have before sending the query to the server.

Parameters

remote_contact_directory The LinphoneRemoteContactDirectory object.

Returns: The mininum number of characters to have before sending the query.

◆ linphone_remote_contact_directory_get_server_url()

const char* linphone_remote_contact_directory_get_server_url ( const LinphoneRemoteContactDirectory * remote_contact_directory )

Gets the configured remote contact directory server URL.

Parameters

remote_contact_directory The LinphoneRemoteContactDirectory object.

Returns: the remote contact directory server URL.

◆ linphone_remote_contact_directory_get_timeout()

unsigned int linphone_remote_contact_directory_get_timeout ( const LinphoneRemoteContactDirectory * remote_contact_directory )

Gets the timeout (in seconds) after which the query is abandonned.

Parameters

remote_contact_directory The LinphoneRemoteContactDirectory object.

Returns: The timeout (in seconds) after which the query is considered to be timed-out.

◆ linphone_remote_contact_directory_get_type()

LinphoneRemoteContactDirectoryType linphone_remote_contact_directory_get_type ( const LinphoneRemoteContactDirectory * remote_contact_directory )

Gets the type of remote contact directory (LDAP, CardDAV).

Parameters

remote_contact_directory The LinphoneRemoteContactDirectory object.

Returns: the LinphoneRemoteContactDirectoryType of this remote contact directory.

◆ linphone_remote_contact_directory_ref()

LinphoneRemoteContactDirectory* linphone_remote_contact_directory_ref ( LinphoneRemoteContactDirectory * remote_contact_directory )

Takes a reference on a LinphoneRemoteContactDirectory.

Parameters

remote_contact_directory The LinphoneRemoteContactDirectory object.

Returns: the same LinphoneRemoteContactDirectory object.

◆ linphone_remote_contact_directory_set_limit()

void linphone_remote_contact_directory_set_limit	(	LinphoneRemoteContactDirectory *	remote_contact_directory,
		unsigned int	limit
	)

Sets the maximum number of results to fetch, 0 means no limit.

Parameters

remote_contact_directory	The LinphoneRemoteContactDirectory object.
limit	the maximum number of results to return.

◆ linphone_remote_contact_directory_set_min_characters()

void linphone_remote_contact_directory_set_min_characters	(	LinphoneRemoteContactDirectory *	remote_contact_directory,
		unsigned int	min
	)

Sets the minimum number of characters to have before sending the query to the server.

Parameters

remote_contact_directory	The LinphoneRemoteContactDirectory object.
min	the minimum characters to have in user input filter before sending the query.

◆ linphone_remote_contact_directory_set_server_url()

void linphone_remote_contact_directory_set_server_url	(	LinphoneRemoteContactDirectory *	remote_contact_directory,
		const char *	server_url
	)

Sets the server URL to use to reach the remote contact directory server.

Parameters

remote_contact_directory	The LinphoneRemoteContactDirectory object.
server_url	the remote contact directory server URL.

◆ linphone_remote_contact_directory_set_timeout()

void linphone_remote_contact_directory_set_timeout	(	LinphoneRemoteContactDirectory *	remote_contact_directory,
		unsigned int	seconds
	)

Sets the timeout (in seconds) after which the query is abandonned.

Parameters

remote_contact_directory	The LinphoneRemoteContactDirectory object.
seconds	the number of seconds before considering the query as timed-out.

◆ linphone_remote_contact_directory_unref()

void linphone_remote_contact_directory_unref ( LinphoneRemoteContactDirectory * remote_contact_directory )

Releases a LinphoneRemoteContactDirectory.

Parameters

remote_contact_directory The LinphoneRemoteContactDirectory object.

Typedefs

Functions

Detailed Description

Typedef Documentation

◆ LinphoneMagicSearch

◆ LinphoneMagicSearchCbs

Function Documentation

◆ linphone_card_dav_params_clone()

◆ linphone_card_dav_params_get_domain_fields()

◆ linphone_card_dav_params_get_use_exact_match_policy()

◆ linphone_card_dav_params_get_user_input_fields()

◆ linphone_card_dav_params_ref()

◆ linphone_card_dav_params_set_domain_fields()

◆ linphone_card_dav_params_set_use_exact_match_policy()

◆ linphone_card_dav_params_set_user_input_fields()

◆ linphone_card_dav_params_unref()

◆ linphone_core_add_remote_contact_directory()

◆ linphone_core_create_card_dav_params()

◆ linphone_core_create_card_dav_remote_contact_directory()

◆ linphone_core_create_ldap_remote_contact_directory()

◆ linphone_core_get_remote_contact_directories()

◆ linphone_core_remove_remote_contact_directory()

◆ linphone_remote_contact_directory_get_card_dav_params()

◆ linphone_remote_contact_directory_get_ldap_params()

◆ linphone_remote_contact_directory_get_limit()

◆ linphone_remote_contact_directory_get_min_characters()

◆ linphone_remote_contact_directory_get_server_url()

◆ linphone_remote_contact_directory_get_timeout()

◆ linphone_remote_contact_directory_get_type()

◆ linphone_remote_contact_directory_ref()

◆ linphone_remote_contact_directory_set_limit()

◆ linphone_remote_contact_directory_set_min_characters()

◆ linphone_remote_contact_directory_set_server_url()

◆ linphone_remote_contact_directory_set_timeout()

◆ linphone_remote_contact_directory_unref()