[Asterisk-doc] docs conf-files.xml,1.6,1.7

blitzrage asterisk-doc@lists.digium.com
Wed, 2 Jun 2004 21:53:20 +0000


Comments:
Update of /cvsroot/asterisk/docs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv2040/docs

Modified Files:
	conf-files.xml 
Log Message:
blitzrage
- information about rtp.conf and parking.conf in chapter 3
Index: conf-files.xml
===================================================================
RCS file: /cvsroot/asterisk/docs/conf-files.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** conf-files.xml	2 Jun 2004 00:46:58 -0000	1.6
--- conf-files.xml	2 Jun 2004 21:53:14 -0000	1.7
***************
*** 257,261 ****
  		<sect2>
  			<title>parking.conf</title>
! 			<para/>
  		</sect2>
  		<sect2>
--- 257,303 ----
  		<sect2>
  			<title>parking.conf</title>
! 			<para>
! 			The <filename>parking.conf</filename> file controls the extension numbers for
! 			call parking.  Call parking allows a caller to be placed into an extension where
! 			you can retrieve the call from any other phone attached to Asterisk.  This is
! 			done by transfering the user to the "call parking" extension.  Once transfered
! 			to that extension, Asterisk will announce the extension that the call can
! 			be retrieved from.
! 			</para>
! 			
! 			<para>
! 			For example, lets say John Smith calls Company XYZ and asks for Jane Doe.
! 			Instead of transfering the call to a specific extension, you could place the
! 			caller into call parking where Asterisk will tell you which extension the
! 			call has been placed into.  You could then announce over a PA system for
! 			John Smith to call that extension number where he could retrieve the call
! 			no matter where he was in the building.
! 			</para>
! 
! 			<para>
! 			The following is an example <filename>parking.conf</filename> configuration:
! 
! 			<programlisting>
! 			[general]
! 			parkext => 501 <lineannotation>; What ext. to dial to park</lineannotation>
! 			parkpos => 502-520 <lineannotation>; What extensions to park calls on
! 			</lineannotation>
! 			context => parkedcalls <lineannotation>; Which context parked calls are in
! 			</lineannotation>
! 			parkingtime => 45	<lineannotation>; Number of seconds a call can be parked 
! 			for (default is 45 seconds)</lineannotation>
! 			</programlisting>
! 
! 			To park a call you will press '#' to transfer the caller to an extension.
! 			<varname>parkext</varname> is the configurable extension number to dial in
! 			order to park the caller.  Once parked, Asterisk will announce the extension
! 			which the caller has been parked in.  This will be in the range specified
! 			by <varname>parkpos</varname>.  Parked calls are placed into the context
! 			defined by <varname>context</varname>.  This allows you to use things like
! 			Music On Hold (MOH) for your parked callers.  <varname>parkingtime</varname>
! 			is the timeout time that the caller will be left parked until the original
! 			extension from where the call was parked will ring to tell the operator
! 			that the call has not been un-parked yet.
! 			</para>
  		</sect2>
  		<sect2>
***************
*** 277,281 ****
  		<sect2>
  			<title>rtp.conf</title>
! 			<para/>
  		</sect2>
  		<sect2>
--- 319,355 ----
  		<sect2>
  			<title>rtp.conf</title>
! 			<para>
! 			The SIP protocol uses port 5060 for control messages between the two
! 			talking end points.  However the RTP audio stream comes over a different
! 			range of ports which need to be opened on any firewall, or forwarded to
! 			any NAT'd Asterisk box.  This can be configured in the <filename>rtp.conf
! 			</filename> file located in <filename class='directory'>/etc/asterisk/</filename>.
! 			</para>
! 
! 			<para>
! 			By default Asterisk will accept RTP messages in the range of 10000 through
! 			20000.  Many people may not need this large of a range, and very well may
! 			not want to open that many ports on their firewall.  If you want to change
! 			the range the Asterisk will listen for the RTP stream on, you simply
! 			need to change the start and stop range.  The following is the default
! 			example that comes with the sample configuration files
! 			</para>
! 
! 			<informalexample>
! 			<programlisting>
! 			; RTP Configuration
! 			[general]
! 
! 			; RTP start and RTP end configure start and end addresses
! 			rtpstart=10000
! 			rtpend=20000
! 			</programlisting>
! 			</informalexample>
! 
! 			<para>
! 			<varname>rtpstart</varname> is the first port that Asterisk will accept RTP
! 			data on and <varname>rtpend</varname> is the last port that Asterisk will
! 			accept RTP data on.  Simply change these values to suit your needs.
! 			</para>
  		</sect2>
  		<sect2>