[asterisk-commits] newtonr: branch 12 r407587 - /branches/12/configs/pjsip.conf.sample

[SVN commits to the Asterisk project]

Author: newtonr
Date: Thu Feb  6 13:57:51 2014
New Revision: 407587

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=407587
Log:
configs/pjsip.conf.sample: Configuration section naming in pjsip.conf.sample needs a little clarification

There is a bit of nuance to how you name things in pjsip.conf. This is a documentation patch to at least clear it up a little for users.

Review: https://reviewboard.asterisk.org/r/3180/

Modified:
    branches/12/configs/pjsip.conf.sample

Modified: branches/12/configs/pjsip.conf.sample
URL: http://svnview.digium.com/svn/asterisk/branches/12/configs/pjsip.conf.sample?view=diff&rev=407587&r1=407586&r2=407587
==============================================================================
--- branches/12/configs/pjsip.conf.sample (original)
+++ branches/12/configs/pjsip.conf.sample Thu Feb  6 13:57:51 2014
@@ -75,6 +75,33 @@
 ; The following sections show example configurations for various scenarios.
 ; Most require a couple or more configuration types configured in concert.
 
+;=============================================================================
+
+; Naming of Configuration Sections
+;
+; Configuration section names are denoted with enclosing brackets,
+; e.g. [6001]
+; In most cases, you can name a section whatever makes sense to you. For example
+; you might name a transport [transport-udp-nat] to help you remember how that
+; section is being used. However, in some cases, ("endpoint" and "aor" types)
+; the section name has a relationship to its function.
+;
+; Depending on the modules loaded, Asterisk can match SIP requests to an
+; endpoint or aor in a few ways:
+;
+; 1) Match a section name for endpoint type sections to the username in the
+;    "From" header of inbound SIP requests.
+; 2) Match a section name for aor type sections to the username in the "To"
+;    header of inbound SIP REGISTER requests.
+; 3) With an identify type section configured, match an inbound SIP request of
+;    any type to an endpoint or aor based on the IP source address of the
+;    request.
+;
+; Note that sections can have the same name as long as their "type" options are
+; set to different values. In most cases it makes sense to have associated
+; configuration sections use the same name, as you'll see in the examples within
+; this file.
+
 ;===============EXAMPLE TRANSPORTS============================================
 ;
 ; A few examples for potential transport options.
@@ -186,10 +213,6 @@
 ; You can define multiple contact addresses in SIP URI format in multiple
 ; "contact=" entries.
 ;
-; Section Naming
-;
-; Sections can have the same name as long as their "type="
-; options are set to different values.
 
 ;[mytrunk]
 ;type=endpoint