更新linphone sdk

chenqiyang

2022-09-02 6a99d9bf65aa5878cb409945ed2bdbdcb916d047

 Shared.IOS.HDLLinphoneSDK/Shared.IOS.HDLLinphoneSDK/Library/linphone.framework/Headers/proxy_config.h

old mode 100644
new mode 100755
@@ -21,6 +21,7 @@
#define LINPHONE_PROXY_CONFIG_H

#include "linphone/types.h"
#include "linphone/sipsetup.h"

#ifdef __cplusplus
extern "C" {
@@ -32,38 +33,31 @@
**/

/**
 * Creates an empty proxy config.
 * @deprecated, use #linphone_core_create_proxy_config instead
 * @donotwrap
**/
LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneProxyConfig *linphone_proxy_config_new(void);

/**
 * Acquire a reference to the proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The same proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The same proxy config. @notnil
**/
LINPHONE_PUBLIC LinphoneProxyConfig *linphone_proxy_config_ref(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC LinphoneProxyConfig *linphone_proxy_config_ref(LinphoneProxyConfig *proxy_config);

/**
 * Release reference to the proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
**/
LINPHONE_PUBLIC void linphone_proxy_config_unref(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC void linphone_proxy_config_unref(LinphoneProxyConfig *proxy_config);

/**
 * Retrieve the user pointer associated with the proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The user pointer associated with the proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The user pointer associated with the proxy config. @maybenil
**/
LINPHONE_PUBLIC void *linphone_proxy_config_get_user_data(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC void *linphone_proxy_config_get_user_data(const LinphoneProxyConfig *proxy_config);

/**
 * Assign a user pointer to the proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] ud The user pointer to associate with the proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param user_data The user pointer to associate with the proxy config. @maybenil
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_user_data(LinphoneProxyConfig *cfg, void *ud);
LINPHONE_PUBLIC void linphone_proxy_config_set_user_data(LinphoneProxyConfig *proxy_config, void *user_data);

/**
 * Sets the proxy address
@@ -72,48 +66,39 @@
 * - IP address: sip:87.98.157.38
 * - IP address with port: sip:87.98.157.38:5062
 * - hostnames : sip:sip.example.net
 * 
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param server_address the proxy address to set. @maybenil
**/
LINPHONE_PUBLIC LinphoneStatus linphone_proxy_config_set_server_addr(LinphoneProxyConfig *cfg, const char *server_addr);

/**
 * @deprecated Use linphone_proxy_config_set_identity_address()
 * @donotwrap
**/
LINPHONE_PUBLIC   LINPHONE_DEPRECATED LinphoneStatus linphone_proxy_config_set_identity(LinphoneProxyConfig *cfg, const char *identity);
LINPHONE_PUBLIC LinphoneStatus linphone_proxy_config_set_server_addr(LinphoneProxyConfig *proxy_config, const char *server_address);

/**
 * Sets the user identity as a SIP address.
 *
 * This identity is normally formed with display name, username and domain, such
 * as:
 * Alice <sip:alice@example.net>
 * as: Alice <sip:alice@example.net>
 * The REGISTER messages will have from and to set to this identity.
 *
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param identity the #LinphoneAddress of the identity to set @maybenil
**/
LINPHONE_PUBLIC LinphoneStatus linphone_proxy_config_set_identity_address(LinphoneProxyConfig *cfg, const LinphoneAddress *identity);

/**
 * Sets a SIP route.
 * When a route is set, all outgoing calls will go to the route's destination if this proxy
 * is the default one (see linphone_core_set_default_proxy() ).
 * @return -1 if route is invalid, 0 otherwise.
**/
LINPHONE_PUBLIC LinphoneStatus linphone_proxy_config_set_route(LinphoneProxyConfig *cfg, const char *route);
LINPHONE_PUBLIC LinphoneStatus linphone_proxy_config_set_identity_address(LinphoneProxyConfig *proxy_config, const LinphoneAddress *identity);

/**
 * Sets a list of SIP route.
 * When a route is set, all outgoing calls will go to the route's destination if this proxy
 * is the default one (see linphone_core_set_default_proxy() ).
 * @param[in] cfg the #LinphoneProxyConfig
 * @param[in] routes A \bctbx_list{const char *} of routes
 * is the default one (see linphone_core_set_default_proxy_config() ).
 * @param proxy_config the #LinphoneProxyConfig @notnil
 * @param routes A \bctbx_list{const char *} of routes @maybenil
 * @return -1 if routes are invalid, 0 otherwise.
**/
LINPHONE_PUBLIC LinphoneStatus linphone_proxy_config_set_routes(LinphoneProxyConfig *cfg, const bctbx_list_t *routes);
LINPHONE_PUBLIC LinphoneStatus linphone_proxy_config_set_routes(LinphoneProxyConfig *proxy_config, const bctbx_list_t *routes);

/**
 * Sets the registration expiration time in seconds.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param expires the expiration time to set
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_expires(LinphoneProxyConfig *cfg, int expires);
LINPHONE_PUBLIC void linphone_proxy_config_set_expires(LinphoneProxyConfig *proxy_config, int expires);

#define linphone_proxy_config_expires linphone_proxy_config_set_expires

@@ -121,10 +106,10 @@
 * @brief Indicates  either or not, REGISTRATION must be issued for this #LinphoneProxyConfig.
 *
 * In case this #LinphoneProxyConfig has been added to #LinphoneCore, follows the linphone_proxy_config_edit() rule.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param val if true, registration will be engaged
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param enable if true, registration will be engaged
 */
LINPHONE_PUBLIC void linphone_proxy_config_enable_register(LinphoneProxyConfig *cfg, bool_t val);
LINPHONE_PUBLIC void linphone_proxy_config_enable_register(LinphoneProxyConfig *proxy_config, bool_t enable);

#define linphone_proxy_config_enableregister linphone_proxy_config_enable_register

@@ -136,188 +121,185 @@
 * proxy configuration (such as identity, proxy address and so on).
 * Once the modifications are done, then the application must call
 * linphone_proxy_config_done() to commit the changes.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
**/
LINPHONE_PUBLIC void linphone_proxy_config_edit(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC void linphone_proxy_config_edit(LinphoneProxyConfig *proxy_config);

/**
 * Commits modification made to the proxy configuration.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return 0 if successful, -1 otherwise
**/
LINPHONE_PUBLIC LinphoneStatus linphone_proxy_config_done(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC LinphoneStatus linphone_proxy_config_done(LinphoneProxyConfig *proxy_config);

/**
 * @brief Indicates either or not, PUBLISH must be issued for this #LinphoneProxyConfig.
 *
 * In case this #LinphoneProxyConfig has been added to #LinphoneCore, follows the #linphone_proxy_config_edit() rule.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param val if TRUE, publish will be engaged
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param enable if TRUE, publish will be engaged
 */
LINPHONE_PUBLIC void linphone_proxy_config_enable_publish(LinphoneProxyConfig *cfg, bool_t val);
LINPHONE_PUBLIC void linphone_proxy_config_enable_publish(LinphoneProxyConfig *proxy_config, bool_t enable);

/**
 * Set the publish expiration time in second.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param expires in second
 * */
LINPHONE_PUBLIC void linphone_proxy_config_set_publish_expires(LinphoneProxyConfig *cfg, int expires);
LINPHONE_PUBLIC void linphone_proxy_config_set_publish_expires(LinphoneProxyConfig *proxy_config, int expires);

/**
 * get the publish expiration time in second. Default value is the registration expiration value.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return expires in second
 * */
LINPHONE_PUBLIC int linphone_proxy_config_get_publish_expires(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC int linphone_proxy_config_get_publish_expires(const LinphoneProxyConfig *proxy_config);

/**
 * Sets whether liblinphone should replace "+" by international calling prefix in dialed numbers (passed to
 * #linphone_core_invite ).
 * #linphone_core_invite() ).
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param enable TRUE to replace + by the international prefix, FALSE otherwise.
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_dial_escape_plus(LinphoneProxyConfig *cfg, bool_t val);
LINPHONE_PUBLIC void linphone_proxy_config_set_dial_escape_plus(LinphoneProxyConfig *proxy_config, bool_t enable);

/**
 * Sets a dialing prefix to be automatically prepended when inviting a number with
 * linphone_core_invite();
 * This dialing prefix shall usually be the country code of the country where the user is living, without "+".
 *
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param prefix the prefix to set (withouth the +) @maybenil
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_dial_prefix(LinphoneProxyConfig *cfg, const char *prefix);
LINPHONE_PUBLIC void linphone_proxy_config_set_dial_prefix(LinphoneProxyConfig *proxy_config, const char *prefix);

 /**
 * Indicates whether quality statistics during call should be stored and sent to a collector according to RFC 6035.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] enable True to store quality statistics and send them to the collector, false to disable it.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param enable True to store quality statistics and send them to the collector, false to disable it.
 */
LINPHONE_PUBLIC void linphone_proxy_config_enable_quality_reporting(LinphoneProxyConfig *cfg, bool_t enable);
LINPHONE_PUBLIC void linphone_proxy_config_enable_quality_reporting(LinphoneProxyConfig *proxy_config, bool_t enable);

/**
 * Indicates whether quality statistics during call should be stored and sent to a collector according to RFC 6035.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return True if quality repotring is enabled, false otherwise.
 */
LINPHONE_PUBLIC bool_t linphone_proxy_config_quality_reporting_enabled(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC bool_t linphone_proxy_config_quality_reporting_enabled(LinphoneProxyConfig *proxy_config);

 /**
 * Set the route of the collector end-point when using quality reporting. This SIP address
 * should be used on server-side to process packets directly before discarding packets. Collector address
 * should be a non existing account and will not receive any messages.
 * If NULL, reports will be send to the proxy domain.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] collector route of the collector end-point, if NULL PUBLISH will be sent to the proxy domain.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param collector route of the collector end-point, if NULL PUBLISH will be sent to the proxy domain. @maybenil
 */
LINPHONE_PUBLIC void linphone_proxy_config_set_quality_reporting_collector(LinphoneProxyConfig *cfg, const char *collector);
LINPHONE_PUBLIC void linphone_proxy_config_set_quality_reporting_collector(LinphoneProxyConfig *proxy_config, const char *collector);

 /**
 * Get the route of the collector end-point when using quality reporting. This SIP address
 * should be used on server-side to process packets directly before discarding packets. Collector address
 * should be a non existing account and will not receive any messages.
 * If NULL, reports will be send to the proxy domain.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The SIP address of the collector end-point.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The SIP address of the collector end-point. @maybenil
 */
LINPHONE_PUBLIC const char *linphone_proxy_config_get_quality_reporting_collector(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const char *linphone_proxy_config_get_quality_reporting_collector(const LinphoneProxyConfig *proxy_config);

/**
 * Set the interval between 2 interval reports sending when using quality reporting. If call exceed interval size, an
 * interval report will be sent to the collector. On call termination, a session report will be sent
 * for the remaining period. Value must be 0 (disabled) or positive.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] interval The interval in seconds, 0 means interval reports are disabled.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param interval The interval in seconds, 0 means interval reports are disabled.
 */
LINPHONE_PUBLIC void linphone_proxy_config_set_quality_reporting_interval(LinphoneProxyConfig *cfg, int interval);
LINPHONE_PUBLIC void linphone_proxy_config_set_quality_reporting_interval(LinphoneProxyConfig *proxy_config, int interval);

/**
 * Get the interval between interval reports when using quality reporting.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The interval in seconds, 0 means interval reports are disabled.
 */

LINPHONE_PUBLIC int linphone_proxy_config_get_quality_reporting_interval(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC int linphone_proxy_config_get_quality_reporting_interval(LinphoneProxyConfig *proxy_config);

/**
 * Get the registration state of the given proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The registration state of the proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The #LinphoneRegistrationState of the proxy config.
**/
LINPHONE_PUBLIC LinphoneRegistrationState linphone_proxy_config_get_state(const LinphoneProxyConfig *cfg);

/**
 * @return a boolean indicating that the user is sucessfully registered on the proxy.
 * @deprecated Use linphone_proxy_config_get_state() instead.
 * @donotwrap
**/
LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_proxy_config_is_registered(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC LinphoneRegistrationState linphone_proxy_config_get_state(const LinphoneProxyConfig *proxy_config);

/**
 * Get the domain name of the given proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The domain name of the proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The domain name of the proxy config. @maybenil
**/
LINPHONE_PUBLIC const char *linphone_proxy_config_get_domain(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const char *linphone_proxy_config_get_domain(const LinphoneProxyConfig *proxy_config);

/**
 * Get the realm of the given proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The realm of the proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The realm of the proxy config. @maybenil
**/
LINPHONE_PUBLIC const char *linphone_proxy_config_get_realm(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const char *linphone_proxy_config_get_realm(const LinphoneProxyConfig *proxy_config);

/**
 * Set the realm of the given proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] realm New realm value.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param realm New realm value. @maybenil
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_realm(LinphoneProxyConfig *cfg, const char * realm);

/**
 * @return the route set for this proxy configuration.
 * @deprecated Use linphone_proxy_config_get_routes() instead.
**/
LINPHONE_PUBLIC const char *linphone_proxy_config_get_route(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC void linphone_proxy_config_set_realm(LinphoneProxyConfig *proxy_config, const char * realm);

/**
 * Gets the list of the routes set for this proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return \bctbx_list{const char *} the list of routes.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The list of routes as string. \bctbx_list{const char *} @maybenil
 */
LINPHONE_PUBLIC const bctbx_list_t* linphone_proxy_config_get_routes(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const bctbx_list_t* linphone_proxy_config_get_routes(const LinphoneProxyConfig *proxy_config);

/**
 * @return the SIP identity that belongs to this proxy configuration.
 * Gets the identity addres of the proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return the SIP identity that belongs to this proxy configuration. @maybenil
**/
LINPHONE_PUBLIC const LinphoneAddress *linphone_proxy_config_get_identity_address(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const LinphoneAddress *linphone_proxy_config_get_identity_address(const LinphoneProxyConfig *proxy_config);

/**
 * @deprecated use linphone_proxy_config_get_identity_address()
 * @donotwrap
**/
LINPHONE_PUBLIC LINPHONE_DEPRECATED const char *linphone_proxy_config_get_identity(const LinphoneProxyConfig *cfg);

/**
 * Gets if the PUBLISH is enabled.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return TRUE if PUBLISH request is enabled for this proxy.
**/
LINPHONE_PUBLIC bool_t linphone_proxy_config_publish_enabled(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC bool_t linphone_proxy_config_publish_enabled(const LinphoneProxyConfig *proxy_config);

/**
 * @return the proxy's SIP address.
 * Gets the proxy config proxy address.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return the proxy's SIP address. @maybenil
**/
LINPHONE_PUBLIC   const char *linphone_proxy_config_get_server_addr(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC   const char *linphone_proxy_config_get_server_addr(const LinphoneProxyConfig *proxy_config);

#define linphone_proxy_config_get_addr linphone_proxy_config_get_server_addr

/**
 * Gets the proxy config expires
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return the duration of registration.
**/
LINPHONE_PUBLIC int linphone_proxy_config_get_expires(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC int linphone_proxy_config_get_expires(const LinphoneProxyConfig *proxy_config);

/**
 * Returns whether the proxy config is enabled or not.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return TRUE if registration to the proxy is enabled.
**/
LINPHONE_PUBLIC bool_t linphone_proxy_config_register_enabled(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC bool_t linphone_proxy_config_register_enabled(const LinphoneProxyConfig *proxy_config);

/**
 * Refresh a proxy registration.
 * This is useful if for example you resuming from suspend, thus IP address may have changed.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
**/
LINPHONE_PUBLIC void linphone_proxy_config_refresh_register(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC void linphone_proxy_config_refresh_register(LinphoneProxyConfig *proxy_config);

/**
 * Prevent a proxy config from refreshing its registration.
@@ -325,131 +307,116 @@
 * refreshes are sent.
 * However, linphone_core_set_network_reachable(lc,TRUE) will always request the proxy configs to refresh their registrations.
 * The refreshing operations can be resumed with linphone_proxy_config_refresh_register().
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
**/
LINPHONE_PUBLIC void linphone_proxy_config_pause_register(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC void linphone_proxy_config_pause_register(LinphoneProxyConfig *proxy_config);

/**
 * Return the contact address of the proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return a #LinphoneAddress correspong to the contact address of the proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return a #LinphoneAddress correspong to the contact address of the proxy config. @maybenil
**/
LINPHONE_PUBLIC const LinphoneAddress* linphone_proxy_config_get_contact(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const LinphoneAddress* linphone_proxy_config_get_contact(const LinphoneProxyConfig *proxy_config);

/**
 * @return previously set contact parameters.
 * Returns the contact parameters.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return previously set contact parameters. @maybenil
**/
LINPHONE_PUBLIC const char *linphone_proxy_config_get_contact_parameters(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const char *linphone_proxy_config_get_contact_parameters(const LinphoneProxyConfig *proxy_config);

/**
 * Set optional contact parameters that will be added to the contact information sent in the registration.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param contact_params a string contaning the additional parameters in text form, like "myparam=something;myparam2=something_else"
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param contact_params a string contaning the additional parameters in text form, like "myparam=something;myparam2=something_else" @maybenil
 *
 * The main use case for this function is provide the proxy additional information regarding the user agent, like for example unique identifier or apple push id.
 * As an example, the contact address in the SIP register sent will look like <sip:joe@15.128.128.93:50421>;apple-push-id=43143-DFE23F-2323-FA2232.
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_contact_parameters(LinphoneProxyConfig *cfg, const char *contact_params);
LINPHONE_PUBLIC void linphone_proxy_config_set_contact_parameters(LinphoneProxyConfig *proxy_config, const char *contact_params);

/**
 * Set optional contact parameters that will be added to the contact information sent in the registration, inside the URI.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param contact_uri_params a string containing the additional parameters in text form, like "myparam=something;myparam2=something_else"
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param contact_uri_params a string containing the additional parameters in text form, like "myparam=something;myparam2=something_else" @maybenil
 *
 * The main use case for this function is provide the proxy additional information regarding the user agent, like for example unique identifier or apple push id.
 * As an example, the contact address in the SIP register sent will look like <sip:joe@15.128.128.93:50421;apple-push-id=43143-DFE23F-2323-FA2232>.
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_contact_uri_parameters(LinphoneProxyConfig *cfg, const char *contact_uri_params);
LINPHONE_PUBLIC void linphone_proxy_config_set_contact_uri_parameters(LinphoneProxyConfig *proxy_config, const char *contact_uri_params);

/**
 * @return previously set contact URI parameters.
 * Returns the contact URI parameters.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return previously set contact URI parameters. @maybenil
**/
LINPHONE_PUBLIC const char* linphone_proxy_config_get_contact_uri_parameters(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const char* linphone_proxy_config_get_contact_uri_parameters(const LinphoneProxyConfig *proxy_config);

/**
 * Get the #LinphoneCore object to which is associated the #LinphoneProxyConfig.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The #LinphoneCore object to which is associated the #LinphoneProxyConfig.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The #LinphoneCore object to which is associated the #LinphoneProxyConfig. @notnil
**/
LINPHONE_PUBLIC LinphoneCore * linphone_proxy_config_get_core(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC LinphoneCore * linphone_proxy_config_get_core(const LinphoneProxyConfig *proxy_config);

/**
 * @return whether liblinphone should replace "+" by "00" in dialed numbers (passed to
 * #linphone_core_invite ).
 *
 * Returns whether or not the + should be replaced by 00.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return whether liblinphone should replace "+" by "00" in dialed numbers (passed to #linphone_core_invite()).
**/
LINPHONE_PUBLIC bool_t linphone_proxy_config_get_dial_escape_plus(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC bool_t linphone_proxy_config_get_dial_escape_plus(const LinphoneProxyConfig *proxy_config);

/**
 * @return dialing prefix.
 * Gets the prefix set for this proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return dialing prefix. @maybenil
**/
LINPHONE_PUBLIC   const char * linphone_proxy_config_get_dial_prefix(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC   const char * linphone_proxy_config_get_dial_prefix(const LinphoneProxyConfig *proxy_config);

/**
 * Get the reason why registration failed when the proxy config state is LinphoneRegistrationFailed.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The reason why registration failed for this proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The #LinphoneReason why registration failed for this proxy config.
**/
LINPHONE_PUBLIC LinphoneReason linphone_proxy_config_get_error(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC LinphoneReason linphone_proxy_config_get_error(const LinphoneProxyConfig *proxy_config);

/**
 * Get detailed information why registration failed when the proxy config state is LinphoneRegistrationFailed.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The details why registration failed for this proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The #LinphoneErrorInfo explaining why registration failed for this proxy config. @notnil
**/
LINPHONE_PUBLIC const LinphoneErrorInfo *linphone_proxy_config_get_error_info(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const LinphoneErrorInfo *linphone_proxy_config_get_error_info(const LinphoneProxyConfig *proxy_config);

/**
 * Get the transport from either service route, route or addr.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The transport as a string (I.E udp, tcp, tls, dtls)
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The transport as a string (I.E udp, tcp, tls, dtls) @notnil
**/
LINPHONE_PUBLIC const char* linphone_proxy_config_get_transport(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const char* linphone_proxy_config_get_transport(const LinphoneProxyConfig *proxy_config);

/**
 * Destroys a proxy config.
 * @note: #LinphoneProxyConfig that have been removed from #LinphoneCore with
 * linphone_core_remove_proxy_config() must not be freed.
 * @deprecated
 * @donotwrap
**/
LINPHONE_PUBLIC LINPHONE_DEPRECATED void linphone_proxy_config_destroy(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC void linphone_proxy_config_set_sip_setup(LinphoneProxyConfig *proxy_config, const char *type);

LINPHONE_PUBLIC void linphone_proxy_config_set_sip_setup(LinphoneProxyConfig *cfg, const char *type);
LINPHONE_PUBLIC SipSetupContext *linphone_proxy_config_get_sip_setup_context(LinphoneProxyConfig *proxy_config);

LINPHONE_PUBLIC SipSetupContext *linphone_proxy_config_get_sip_setup_context(LinphoneProxyConfig *cfg);

LINPHONE_PUBLIC SipSetup *linphone_proxy_config_get_sip_setup(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC SipSetup *linphone_proxy_config_get_sip_setup(LinphoneProxyConfig *proxy_config);

/**
 * Detect if the given input is a phone number or not.
 * @param proxy #LinphoneProxyConfig argument, unused yet but may contain useful data. Can be NULL.
 * @param username string to parse.
 * @param proxy_config #LinphoneProxyConfig argument, unused yet but may contain useful data. Can be NULL. @maybenil
 * @param username string to parse. @notnil
 * @return TRUE if input is a phone number, FALSE otherwise.
**/
LINPHONE_PUBLIC bool_t linphone_proxy_config_is_phone_number(LinphoneProxyConfig *proxy, const char *username);

/**
 * See linphone_proxy_config_normalize_phone_number
 * @param proxy #LinphoneProxyConfig object containing country code and/or escape symbol. If NULL passed, will use default configuration.
 * @param username the string to parse
 * @param result the newly normalized number
 * @param result_len the size of the normalized number \a result
 * @return TRUE if a phone number was recognized, FALSE otherwise.
 * @deprecated use linphone_proxy_config_normalize_phone_number()
 * @donotwrap
 */
LINPHONE_PUBLIC LINPHONE_DEPRECATED bool_t linphone_proxy_config_normalize_number(LinphoneProxyConfig *proxy, const char *username, char *result, size_t result_len);
LINPHONE_PUBLIC bool_t linphone_proxy_config_is_phone_number(LinphoneProxyConfig *proxy_config, const char *username);

/**
 * Normalize a human readable phone number into a basic string. 888-444-222 becomes 888444222
 * or +33888444222 depending on the #LinphoneProxyConfig object.
 * This function will always generate a normalized username if input is a phone number.
 * @param proxy #LinphoneProxyConfig object containing country code and/or escape symbol. If NULL passed, will use default configuration.
 * @param username the string to parse
 * @return NULL if input is an invalid phone number, normalized phone number from username input otherwise.
 * @param proxy_config #LinphoneProxyConfig object containing country code and/or escape symbol. If NULL passed, will use default configuration. @maybenil
 * @param username the string to parse @notnil
 * @return NULL if input is an invalid phone number, normalized phone number from username input otherwise. @maybenil
*/
LINPHONE_PUBLIC char* linphone_proxy_config_normalize_phone_number(LinphoneProxyConfig *proxy, const char *username);
LINPHONE_PUBLIC char* linphone_proxy_config_normalize_phone_number(LinphoneProxyConfig *proxy_config, const char *username);

/**
 * Normalize a human readable sip uri into a fully qualified LinphoneAddress.
@@ -460,110 +427,103 @@
 * - if no sip: is present, prepend it.
 *
 * The result is a syntactically correct SIP address.
 * @param proxy #LinphoneProxyConfig object containing country code, escape symbol and/or domain name. Can be NULL if domain is already provided.
 * @param username the string to parse
 * @return NULL if invalid input, normalized sip address otherwise.
 * @param proxy_config #LinphoneProxyConfig object containing country code, escape symbol and/or domain name. Can be NULL if domain is already provided. @maybenil
 * @param username the string to parse @notnil
 * @return NULL if invalid input, normalized sip address otherwise. @maybenil
*/
LINPHONE_PUBLIC LinphoneAddress* linphone_proxy_config_normalize_sip_uri(LinphoneProxyConfig *proxy, const char *username);
LINPHONE_PUBLIC LinphoneAddress* linphone_proxy_config_normalize_sip_uri(LinphoneProxyConfig *proxy_config, const char *username);

/**
 * Set default privacy policy for all calls routed through this proxy.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param privacy #LinphonePrivacy to configure privacy
 * */
LINPHONE_PUBLIC void linphone_proxy_config_set_privacy(LinphoneProxyConfig *cfg, LinphonePrivacyMask privacy);
LINPHONE_PUBLIC void linphone_proxy_config_set_privacy(LinphoneProxyConfig *proxy_config, LinphonePrivacyMask privacy);

/**
 * Get default privacy policy for all calls routed through this proxy.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return Privacy mode
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return Privacy mode as #LinphonePrivacyMask
 * */
LINPHONE_PUBLIC LinphonePrivacyMask linphone_proxy_config_get_privacy(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC LinphonePrivacyMask linphone_proxy_config_get_privacy(const LinphoneProxyConfig *proxy_config);

/**
 * Set the http file transfer server to be used for content type application/vnd.gsma.rcs-ft-http+xml
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param server_url URL of the file server like https://file.linphone.org/upload.php
 * Url may be like: "https://file.linphone.org/upload.php".
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param server_url URL of the file server. @maybenil
 * @warning That function isn't implemented yet.
 * @donotwrap
 * */
LINPHONE_PUBLIC void linphone_proxy_config_set_file_transfer_server(LinphoneProxyConfig *cfg, const char * server_url);
LINPHONE_PUBLIC void linphone_proxy_config_set_file_transfer_server(LinphoneProxyConfig *proxy_config, const char * server_url);

/**
 * Get the http file transfer server to be used for content type application/vnd.gsma.rcs-ft-http+xml
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return URL of the file server like https://file.linphone.org/upload.php
 * Url may be like: "https://file.linphone.org/upload.php".
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return URL of the file server. @maybenil
 * @warning That function isn't implemented yet.
 * @donotwrap
 * */
LINPHONE_PUBLIC const char* linphone_proxy_config_get_file_transfer_server(const LinphoneProxyConfig *cfg);

/**
 * Indicates whether AVPF/SAVPF must be used for calls using this proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] enable True to enable AVPF/SAVF, false to disable it.
 * @deprecated use linphone_proxy_config_set_avpf_mode()
 * @donotwrap
 */
LINPHONE_DEPRECATED LINPHONE_PUBLIC void linphone_proxy_config_enable_avpf(LinphoneProxyConfig *cfg, bool_t enable);
LINPHONE_PUBLIC const char* linphone_proxy_config_get_file_transfer_server(const LinphoneProxyConfig *proxy_config);

/**
 * Indicates whether AVPF/SAVPF is being used for calls using this proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return True if AVPF/SAVPF is enabled, false otherwise.
 */
LINPHONE_PUBLIC bool_t linphone_proxy_config_avpf_enabled(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC bool_t linphone_proxy_config_avpf_enabled(LinphoneProxyConfig *proxy_config);

/**
 * Set the interval between regular RTCP reports when using AVPF/SAVPF.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] interval The interval in seconds (between 0 and 5 seconds).
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param interval The interval in seconds (between 0 and 5 seconds).
 */
LINPHONE_PUBLIC void linphone_proxy_config_set_avpf_rr_interval(LinphoneProxyConfig *cfg, uint8_t interval);
LINPHONE_PUBLIC void linphone_proxy_config_set_avpf_rr_interval(LinphoneProxyConfig *proxy_config, uint8_t interval);

/**
 * Get the interval between regular RTCP reports when using AVPF/SAVPF.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The interval in seconds.
 */
LINPHONE_PUBLIC uint8_t linphone_proxy_config_get_avpf_rr_interval(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC uint8_t linphone_proxy_config_get_avpf_rr_interval(const LinphoneProxyConfig *proxy_config);

/**
 * Get enablement status of RTCP feedback (also known as AVPF profile).
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return the enablement mode, which can be #LinphoneAVPFDefault (use LinphoneCore's mode), #LinphoneAVPFEnabled (avpf is enabled), or #LinphoneAVPFDisabled (disabled).
**/
LINPHONE_PUBLIC LinphoneAVPFMode linphone_proxy_config_get_avpf_mode(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC LinphoneAVPFMode linphone_proxy_config_get_avpf_mode(const LinphoneProxyConfig *proxy_config);

/**
 * Enable the use of RTCP feedback (also known as AVPF profile).
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] mode the enablement mode, which can be #LinphoneAVPFDefault (use LinphoneCore's mode), #LinphoneAVPFEnabled (avpf is enabled), or #LinphoneAVPFDisabled (disabled).
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param mode the enablement mode, which can be #LinphoneAVPFDefault (use LinphoneCore's mode), #LinphoneAVPFEnabled (avpf is enabled), or #LinphoneAVPFDisabled (disabled).
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_avpf_mode(LinphoneProxyConfig *cfg, LinphoneAVPFMode mode);
LINPHONE_PUBLIC void linphone_proxy_config_set_avpf_mode(LinphoneProxyConfig *proxy_config, LinphoneAVPFMode mode);

/**
 * Obtain the value of a header sent by the server in last answer to REGISTER.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param header_name the header name for which to fetch corresponding value
 * @return the value of the queried header.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param header_name the header name for which to fetch corresponding value @notnil
 * @return the value of the queried header. @maybenil
**/
LINPHONE_PUBLIC const char *linphone_proxy_config_get_custom_header(LinphoneProxyConfig *cfg, const char *header_name);
LINPHONE_PUBLIC const char *linphone_proxy_config_get_custom_header(LinphoneProxyConfig *proxy_config, const char *header_name);

/**
 * Set the value of a custom header sent to the server in REGISTERs request.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param header_name the header name
 * @param header_value the header's value
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param header_name the header name @notnil
 * @param header_value the header's value @maybenil
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_custom_header(LinphoneProxyConfig *cfg, const char *header_name, const char *header_value);
LINPHONE_PUBLIC void linphone_proxy_config_set_custom_header(LinphoneProxyConfig *proxy_config, const char *header_name, const char *header_value);

/**
 * Find authentication info matching proxy config, if any, similarly to linphone_core_find_auth_info.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return a #LinphoneAuthInfo matching proxy config criteria if possible, NULL if nothing can be found.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return a #LinphoneAuthInfo matching proxy config criteria if possible, NULL if nothing can be found. @maybenil
**/
LINPHONE_PUBLIC const LinphoneAuthInfo* linphone_proxy_config_find_auth_info(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const LinphoneAuthInfo* linphone_proxy_config_find_auth_info(const LinphoneProxyConfig *proxy_config);

/**
 * Get the persistent reference key associated to the proxy config.
@@ -571,10 +531,10 @@
 * The reference key can be for example an id to an external database.
 * It is stored in the config file, thus can survive to process exits/restarts.
 *
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The reference key string that has been associated to the proxy config, or NULL if none has been associated.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The reference key string that has been associated to the proxy config, or NULL if none has been associated. @maybenil
**/
LINPHONE_PUBLIC const char * linphone_proxy_config_get_ref_key(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const char * linphone_proxy_config_get_ref_key(const LinphoneProxyConfig *proxy_config);

/**
 * Associate a persistent reference key to the proxy config.
@@ -582,18 +542,18 @@
 * The reference key can be for example an id to an external database.
 * It is stored in the config file, thus can survive to process exits/restarts.
 *
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] refkey The reference key string to associate to the proxy config.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param refkey The reference key string to associate to the proxy config. @maybenil
**/
LINPHONE_PUBLIC void linphone_proxy_config_set_ref_key(LinphoneProxyConfig *cfg, const char *refkey);
LINPHONE_PUBLIC void linphone_proxy_config_set_ref_key(LinphoneProxyConfig *proxy_config, const char *refkey);

/**
 * Get the dependency of a #LinphoneProxyConfig.
 *
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The proxy config this one is dependent upon, or NULL if not marked dependent
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The proxy config this one is dependent upon, or NULL if not marked dependent. @maybenil
 **/
LINPHONE_PUBLIC LinphoneProxyConfig *linphone_proxy_config_get_dependency(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC LinphoneProxyConfig *linphone_proxy_config_get_dependency(LinphoneProxyConfig *proxy_config);

/**
 * Mark   this proxy configuration as being dependent on the given one.
@@ -607,81 +567,109 @@
 *
 * This mecanism must be enabled before the proxy configuration is added to the core
 *
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] depends_on The reference key of a master #LinphoneProxyConfig
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param depends_on The #LinphoneProxyConfig this one shall be depend on. @maybenil
 **/
LINPHONE_PUBLIC void linphone_proxy_config_set_dependency(LinphoneProxyConfig *cfg, LinphoneProxyConfig *dependency);
LINPHONE_PUBLIC void linphone_proxy_config_set_dependency(LinphoneProxyConfig *proxy_config, LinphoneProxyConfig *depends_on);

/**
 * Get the idkey property of a #LinphoneProxyConfig.
 *
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return The idkey string, or NULL
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The idkey string, or NULL. @maybenil
 **/
LINPHONE_PUBLIC const char *linphone_proxy_config_get_idkey(LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const char *linphone_proxy_config_get_idkey(LinphoneProxyConfig *proxy_config);

/**
 * Set the idkey property on the given proxy configuration.
 * This property can the be referenced by another proxy config 'depends_on' to create a dependency relation between them.
 * @see linphone_proxy_config_set_depends_on()
 *
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] idkey The idkey string to associate to the given #LinphoneProxyConfig
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param idkey The idkey string to associate to the given #LinphoneProxyConfig. @maybenil
 **/
LINPHONE_PUBLIC void linphone_proxy_config_set_idkey(LinphoneProxyConfig *cfg, const char *idkey);
LINPHONE_PUBLIC void linphone_proxy_config_set_idkey(LinphoneProxyConfig *proxy_config, const char *idkey);

/**
 * Get The policy that is used to pass through NATs/firewalls when using this proxy config.
 * If it is set to NULL, the default NAT policy from the core will be used instead.
 * @param[in] cfg #LinphoneProxyConfig object
 * @return #LinphoneNatPolicy object in use.
 * @param proxy_config #LinphoneProxyConfig object @notnil
 * @return #LinphoneNatPolicy object in use. @maybenil
 * @see linphone_core_get_nat_policy()
 */
LINPHONE_PUBLIC LinphoneNatPolicy * linphone_proxy_config_get_nat_policy(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC LinphoneNatPolicy * linphone_proxy_config_get_nat_policy(const LinphoneProxyConfig *proxy_config);

/**
 * Set the policy to use to pass through NATs/firewalls when using this proxy config.
 * If it is set to NULL, the default NAT policy from the core will be used instead.
 * @param[in] cfg #LinphoneProxyConfig object
 * @param[in] policy #LinphoneNatPolicy object
 * @param proxy_config #LinphoneProxyConfig object @notnil
 * @param policy #LinphoneNatPolicy object. @maybenil
 * @see linphone_core_set_nat_policy()
 */
LINPHONE_PUBLIC void linphone_proxy_config_set_nat_policy(LinphoneProxyConfig *cfg, LinphoneNatPolicy *policy);
LINPHONE_PUBLIC void linphone_proxy_config_set_nat_policy(LinphoneProxyConfig *proxy_config, LinphoneNatPolicy *policy);

/**
 * Set the conference factory uri.
 * @param[in] cfg A #LinphoneProxyConfig object
 * @param[in] uri The uri of the conference factory
 * @param proxy_config A #LinphoneProxyConfig object @notnil
 * @param uri The uri of the conference factory. @maybenil
 */
LINPHONE_PUBLIC void linphone_proxy_config_set_conference_factory_uri(LinphoneProxyConfig *cfg, const char *uri);
LINPHONE_PUBLIC void linphone_proxy_config_set_conference_factory_uri(LinphoneProxyConfig *proxy_config, const char *uri);

/**
 * Get the conference factory uri.
 * @param[in] cfg A #LinphoneProxyConfig object
 * @return The uri of the conference factory
 * @param proxy_config A #LinphoneProxyConfig object @notnil
 * @return The uri of the conference factory. @maybenil
 */
LINPHONE_PUBLIC const char * linphone_proxy_config_get_conference_factory_uri(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC const char * linphone_proxy_config_get_conference_factory_uri(const LinphoneProxyConfig *proxy_config);

/**
 * Indicates whether to add to the contact parameters the push notification information.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param[in] allow True to allow push notification information, false otherwise.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param allow TRUE to allow push notification information, FALSE otherwise.
 */
LINPHONE_PUBLIC void linphone_proxy_config_set_push_notification_allowed(LinphoneProxyConfig *cfg, bool_t allow);
LINPHONE_PUBLIC void linphone_proxy_config_set_push_notification_allowed(LinphoneProxyConfig *proxy_config, bool_t allow);

/**
 * Indicates whether to add to the contact parameters the push notification information.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @return True if push notification informations should be added, false otherwise.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return TRUE if push notification informations should be added, FALSE otherwise.
 */
LINPHONE_PUBLIC bool_t linphone_proxy_config_is_push_notification_allowed(const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC bool_t linphone_proxy_config_is_push_notification_allowed(const LinphoneProxyConfig *proxy_config);

/**
 * Return the unread chat message count for a given proxy config.
 * @param[in] cfg #LinphoneProxyConfig object.
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @return The unread chat message count.
 */
LINPHONE_PUBLIC int linphone_proxy_config_get_unread_chat_message_count (const LinphoneProxyConfig *cfg);
LINPHONE_PUBLIC int linphone_proxy_config_get_unread_chat_message_count (const LinphoneProxyConfig *proxy_config);

/************ */
/* DEPRECATED */
/* ********** */

/**
 * Sets a SIP route.
 * When a route is set, all outgoing calls will go to the route's destination if this proxy
 * is the default one (see linphone_core_set_default_proxy_config() ).
 * @param proxy_config #LinphoneProxyConfig object. @notnil
 * @param route the SIP route to set @maybenil
 * @return -1 if route is invalid, 0 otherwise.
 * @deprecated 08/07/2020 use linphone_proxy_config_set_routes() instead
**/
LINPHONE_PUBLIC LINPHONE_DEPRECATED LinphoneStatus linphone_proxy_config_set_route(LinphoneProxyConfig *proxy_config, const char *route);

/**
 * @return the route set for this proxy configuration.
 * @deprecated 09/03/2018 Use linphone_proxy_config_get_routes() instead.
 * @donotwrap
**/
LINPHONE_PUBLIC LINPHONE_DEPRECATED const char *linphone_proxy_config_get_route(const LinphoneProxyConfig *proxy_config);

/**
 * @deprecated 29/07/2015 use linphone_proxy_config_get_identity_address()
 * @donotwrap
**/
LINPHONE_PUBLIC LINPHONE_DEPRECATED const char *linphone_proxy_config_get_identity(const LinphoneProxyConfig *cfg);

/**
 * @}