From 168c679e6c291ad3f541d076d4abfd42147a46a6 Mon Sep 17 00:00:00 2001 From: Rusty Newton Date: Sat, 17 Aug 2013 18:13:11 +0000 Subject: xml doc changes for 'aor' config object and a few of its options Added or modified text in the xml doc for the 'aor' config object to address a few issues: * help for the 'mailboxes' option didn't make it clear how the "list" should be formatted. * AoR object's involvement in inbound registration wasn't mentioned. * help for the 'contact' option didn't describe how to specify multiple contacts. * help for the 'max_contacts' option didn't tell whether it limited the amount of contacts defined through static configuration. (issue ASTERISK-22118) (closes issue ASTERISK-22118) git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@396902 65c4cc65-6c06-0410-ace0-fbb531ad65f3 --- res/res_pjsip.c | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) (limited to 'res/res_pjsip.c') diff --git a/res/res_pjsip.c b/res/res_pjsip.c index 391fa4462..a40c2c0b8 100644 --- a/res/res_pjsip.c +++ b/res/res_pjsip.c @@ -832,7 +832,8 @@ An AoR is what allows Asterisk to contact an endpoint via res_pjsip. If no AoRs are specified, an endpoint will not be reachable by Asterisk. - Beyond that, an AoR has other uses within Asterisk. + Beyond that, an AoR has other uses within Asterisk, such as inbound + registration. An AoR is a way to allow dialing a group of Contacts that all use the same @@ -841,12 +842,20 @@ This can be used as another way of grouping a list of contacts to dial rather than specifing them each directly when dialing via the dialplan. This must be used in conjuction with the PJSIP_DIAL_CONTACTS. + + Registrations: For Asterisk to match an inbound registration to an endpoint, + the AoR object name must match the user portion of the SIP URI in the "To:" + header of the inbound SIP registration. That will usually be equivalent + to the "user name" set in your hard or soft phones configuration. Permanent contacts assigned to AoR - Contacts included in this list will be called whenever referenced + Contacts specified will be called whenever referenced by chan_pjsip. + + Use a separate "contact=" entry for each contact required. Contacts + are specified using a SIP URI. @@ -855,8 +864,8 @@ Mailbox(es) to be associated with This option applies when an external entity subscribes to an AoR - for message waiting indications. The mailboxes specified here will be - subscribed to. + for message waiting indications. The mailboxes specified will be subscribed to. + More than one mailbox can be specified with a comma-delimited string. Maximum time to keep an AoR @@ -867,7 +876,10 @@ Maximum number of contacts that can bind to an AoR - Maximum number of contacts that can associate with this AoR. + Maximum number of contacts that can associate with this AoR. This value does + not affect the number of contacts that can be added with the "contact" option. + It only limits contacts added through external interaction, such as + registration. This should be set to 1 and remove_existing set to yes if you -- cgit v1.2.3