[asterisk-commits] oej: branch 1.4 r171837 - /branches/1.4/configs/sip.conf.sample

[SVN commits to the Asterisk project]

Author: oej
Date: Wed Jan 28 07:07:27 2009
New Revision: 171837

URL: http://svn.digium.com/svn-view/asterisk?view=rev&rev=171837
Log:
Add a better explanation of the difference between the device namespace and the dialplan for newbies.

Modified:
    branches/1.4/configs/sip.conf.sample

Modified: branches/1.4/configs/sip.conf.sample
URL: http://svn.digium.com/svn-view/asterisk/branches/1.4/configs/sip.conf.sample?view=diff&rev=171837&r1=171836&r2=171837
==============================================================================
--- branches/1.4/configs/sip.conf.sample (original)
+++ branches/1.4/configs/sip.conf.sample Wed Jan 28 07:07:27 2009
@@ -22,6 +22,25 @@
 ;   module reload chan_sip.so     Reload configuration file
 ;                                 Active SIP peers will not be reconfigured
 ;
+;------- Naming devices ------------------------------------------------------
+;
+; When naming devices, make sure you understand how Asterisk matches calls
+; that come in.
+;	1. Asterisk checks the SIP From: address username and matches against
+;	   names of devices with type=user 
+;	   The name is the text between square brackets [name]
+;	2. Asterisk checks the IP address (and port number) that the INVITE
+;	   was sent from and matches against any devices with type=peer
+;
+; Don't mix extensions with the names of the devices. Devices need a unique
+; name. The device name is *not* used as phone numbers. Phone numbers are
+; anything you declare as an extension in the dialplan (extensions.conf).
+;
+; Note: The parameter "username" is not the username and in most cases is
+;       not needed at all. Check below. In later releases, it's renamed
+;       to "defaultuser" which is a better name, since it is used in 
+;       combination with the "defaultip" setting.
+;-----------------------------------------------------------------------------
 
 [general]
 context=default                 ; Default context for incoming calls