diff options
author | Benny Prijono <bennylp@teluu.com> | 2010-06-20 08:58:26 +0000 |
---|---|---|
committer | Benny Prijono <bennylp@teluu.com> | 2010-06-20 08:58:26 +0000 |
commit | 1ebdfe9fb3ec2c155ec09d31f82748ecfdf9c86e (patch) | |
tree | d14101455fb4753a518726a16b20ed5ad2b09363 /pjsip/include | |
parent | 8d35b8f739dbad39422332ecb8376cc18a858f2e (diff) |
Fixed #1086 (New option to update the Contact URI in a single REGISTER request): added contact_rewrite_method account config to control this. Default is to use the new mechanism, i.e. the single REGISTER method.
git-svn-id: http://svn.pjsip.org/repos/pjproject/trunk@3213 74dad513-b988-da41-8d7b-12977e46ad98
Diffstat (limited to 'pjsip/include')
-rw-r--r-- | pjsip/include/pjsua-lib/pjsua.h | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/pjsip/include/pjsua-lib/pjsua.h b/pjsip/include/pjsua-lib/pjsua.h index 01d1f801..2826c9fa 100644 --- a/pjsip/include/pjsua-lib/pjsua.h +++ b/pjsip/include/pjsua-lib/pjsua.h @@ -1900,6 +1900,30 @@ PJ_DECL(pj_status_t) pjsua_transport_close( pjsua_transport_id id, /** + * This macro specifies the default value for \a contact_rewrite_method + * field in pjsua_acc_config. I specifies how Contact update will be + * done with the registration, if \a allow_contact_rewrite is enabled in + * the account config. + * + * If set to 1, the Contact update will be done by sending unregistration + * to the currently registered Contact, while simultaneously sending new + * registration (with different Call-ID) for the updated Contact. + * + * If set to 2, the Contact update will be done in a single, current + * registration session, by removing the current binding (by setting its + * Contact's expires parameter to zero) and adding a new Contact binding, + * all done in a single request. + * + * Value 1 is the legacy behavior. + * + * Default value: 2 + */ +#ifndef PJSUA_CONTACT_REWRITE_METHOD +# define PJSUA_CONTACT_REWRITE_METHOD 2 +#endif + + +/** * This structure describes account configuration to be specified when * adding a new account with #pjsua_acc_add(). Application MUST initialize * this structure first by calling #pjsua_acc_config_default(). @@ -2106,11 +2130,32 @@ typedef struct pjsua_acc_config * This will also update the public name of UDP transport if STUN is * configured. * + * See also contact_rewrite_method field. + * * Default: 1 (yes) */ pj_bool_t allow_contact_rewrite; /** + * Specify how Contact update will be done with the registration, if + * \a allow_contact_rewrite is enabled. + * + * If set to 1, the Contact update will be done by sending unregistration + * to the currently registered Contact, while simultaneously sending new + * registration (with different Call-ID) for the updated Contact. + * + * If set to 2, the Contact update will be done in a single, current + * registration session, by removing the current binding (by setting its + * Contact's expires parameter to zero) and adding a new Contact binding, + * all done in a single request. + * + * Value 1 is the legacy behavior. + * + * Default value: PJSUA_CONTACT_REWRITE_METHOD (2) + */ + int contact_rewrite_method; + + /** * Set the interval for periodic keep-alive transmission for this account. * If this value is zero, keep-alive will be disabled for this account. * The keep-alive transmission will be sent to the registrar's address, |