Skip to content

Commit 21a3c28

Browse files
authored
Update deprecated config parameters (signalwire#42)
1 parent df78fb6 commit 21a3c28

File tree

1 file changed

+21
-19
lines changed

1 file changed

+21
-19
lines changed

docs/FreeSWITCH-Explained/Configuration/Sofia-SIP-Stack/Sofia-Configuration-Files_7144453.mdx

+21-19
Original file line numberDiff line numberDiff line change
@@ -962,7 +962,7 @@ _Default: false_
962962

963963
If true, it passes [RFC 2833](https://tools.ietf.org/html/rfc2833) DTMF's from one side of a bridge to the other, untouched. Otherwise, it decodes and re-encodes them before passing them on.
964964

965-
<param name="pass-rfc2833" value="true"/>
965+
`<param name="pass-rfc2833" value="true"/>`
966966

967967
###### liberal-dtmf
968968

@@ -971,21 +971,21 @@ TODO [RFC 2833](https://tools.ietf.org/html/rfc2833) is obsoleted by [RFC 4733](
971971
_Default: false_
972972
For DTMF negotiation, use this parameter to just always offer 2833 and accept both 2833 and INFO. Use of this parameter is not recommended since its purpose is to try to cope with buggy SIP implementations.
973973

974-
&lt;param name="liberal-dtmf" value="true"/>
974+
`<param name="liberal-dtmf" value="true"/>`
975975

976976
##### SIP Related options
977977

978978
###### enable-timer
979979

980980
This enables or disables support for [RFC 4028](http://tools.ietf.org/html/rfc4028) SIP Session Timers.
981981

982-
&lt;param name="enable-timer" value="false"/>
982+
`<param name="enable-timer" value="false"/>`
983983

984984
###### session-timeout
985985

986986
session timers for all call to expire after the specified seconds Then it will send another invite (re-invite). If not specified defaults to 30 minutes. Some gateways may reject values less than 30 minutes. This values refers to Session-Expires in [RFC 4028](http://tools.ietf.org/html/rfc4028) (The time at which an element will consider the session timed out, if no successful session refresh transaction occurs beforehand)
987987

988-
&lt;param name="session-timeout" value="1800"/>
988+
`<param name="session-timeout" value="1800"/>`
989989

990990
Note: If your switch requires the timer option; for instance, Huawei SoftX3000, it needs this optional field and drops the calls with "Session Timer Check Message Failed", then you may be able to revert back the commit that took away the Require: timer option which is an optional field by:
991991

@@ -999,21 +999,21 @@ make mod_sofia-install
999999

10001000
This enable support for 100rel (100% reliability - PRACK message as defined in [RFC3262](http://tools.ietf.org/html/rfc3262)) This fixes a problem with SIP where provisional messages like "180 Ringing" are not ACK'd and therefore could be dropped over a poor connection without retransmission. \*2009-07-08:\* Enabling this may cause FreeSWITCH to crash, see [FSCORE-392](http://jira.freeswitch.org/browse/FSCORE-392).
10011001

1002-
&lt;param name="enable-100rel" value="true"/>
1002+
`<param name="enable-100rel" value="true"/>`
10031003

10041004
###### minimum-session-expires
10051005

10061006
This sets the "Min-SE" value (in seconds) from [RFC 4028](http://tools.ietf.org/html/rfc4028). This value must not be less than 90 seconds.
10071007

1008-
&lt;param name="minimum-session-expires" value="120"/>
1008+
`<param name="minimum-session-expires" value="120"/>`
10091009

10101010
###### sip-options-respond-503-on-busy
10111011

10121012
When set to true, this param will make FreeSWITCH respond to incoming SIP OPTIONS with 503 "Maximum Calls In Progress" when FS is paused or maximum sessions has been exceeded.
10131013

10141014
When set to false or when not set at all (default behavior), SIP OPTIONS are always responded with 200 "OK".
10151015

1016-
&lt;param name="sip-options-respond-503-on-busy" value="false"/>
1016+
`<param name="sip-options-respond-503-on-busy" value="false"/>`
10171017

10181018
Setting this param to true is especially useful if you're using a proxy such as OpenSIPS or Kamailio with dispatcher module to probe your FreeSWITCH servers by sending SIP OPTIONS.
10191019

@@ -1031,8 +1031,8 @@ Result will be that clients will not re-register at the same time-interval thus
10311031

10321032
For example, if you set:
10331033

1034-
&lt;param name="sip-force-expires" value="1800"/>
1035-
&lt;param name="sip-expires-max-deviation" value="600"/>
1034+
`<param name="sip-force-expires" value="1800"/>`
1035+
`<param name="sip-expires-max-deviation" value="600"/>`
10361036

10371037
then the expires that is responded will be between 1800-600=1200 and 1800+600=2400 seconds.
10381038

@@ -1042,25 +1042,25 @@ This param can be overridden per individual user by setting a _sip-expires-max-d
10421042

10431043
Setting this param will send all outbound transactions to the value set by outbound-proxy.
10441044

1045-
&lt;param name="outbound-proxy" value="127.0.0.1"/>
1045+
`<param name="outbound-proxy" value="127.0.0.1"/>`
10461046

10471047
###### send-display-update
10481048

10491049
Tells FreeSWITCH not to send display UPDATEs to the leg of the call.
10501050

1051-
&lt;param name="send-display-update" value="false"/>
1051+
`<param name="send-display-update" value="false"/>`
10521052

10531053
##### RTP Related options
10541054

10551055
###### auto-jitterbuffer-msec
10561056

10571057
Set this to the size of the [jitterbuffer](../../Codecs-and-Media/JitterBuffer_6587407.mdx#about) you would like to have on all calls coming through this profile.
10581058

1059-
&lt;param name="auto-jitterbuffer-msec" value="120"/>
1059+
`<param name="auto-jitterbuffer-msec" value="120"/>`
10601060

10611061
###### rtp-timer-name
10621062

1063-
&lt;param name="rtp-timer-name" value="soft"/>
1063+
`<param name="rtp-timer-name" value="soft"/>`
10641064

10651065
###### rtp-rewrite-timestamps
10661066

@@ -1070,7 +1070,7 @@ The result is that FreeSWITCH will regenerate and rewrite the timestamps in all
10701070

10711071
This could be necessary to fix audio issues when sending calls to some paranoid and not RFC-compliant gateways (Cirpack is known to require this).
10721072

1073-
&lt;param name="rtp-rewrite-timestamps" value="true"/>
1073+
`<param name="rtp-rewrite-timestamps" value="true"/>`
10741074

10751075

10761076
###### media_timeout
@@ -1081,15 +1081,17 @@ This channel variable configures the number of milliseconds of RTP inactivity (n
10811081

10821082
Example: set the media timeout to 30 seconds
10831083

1084-
&lt;param name="media_timeout" value="30000"/>
1084+
`<X-PRE-PROCESS cmd="set" data="media_timeout=300000"/>`
10851085

10861086
###### media_hold_timeout
10871087

1088-
was: rtp-hold-timeout-sec (deprecated config parameter)
1088+
was: rtp_hold_timeout_sec (deprecated config parameter)
1089+
1090+
`rtp_hold_timeout_sec deprecated use media_timeout variable.`
10891091

10901092
This channel variable configures the number of seconds of RTP inactivity (media silence) for a call placed on hold by an endpoint before FreeSWITCH considers the call disconnected, and hangs up. It is recommended that you use session timers instead, as some phones stop sending media when placed on hold. If this setting is omitted, the default value is "0", which disables the timeout.
10911093

1092-
&lt;param name="media_hold_timeout" value="1800"/>
1094+
`<X-PRE-PROCESS cmd="set" data="media_hold_timeout=1800000"/>`
10931095

10941096
###### rtp-autoflush-during-bridge
10951097

@@ -1099,7 +1101,7 @@ When set to "true" (the default), FreeSWITCH will notice when more than one RTP
10991101

11001102
If rtp-autoflush-during-bridge is set to false, FreeSWITCH will instead preserve all RTP packets on bridged calls, even if it increases the latency or "lag" that callers hear.
11011103

1102-
&lt;param name="rtp-autoflush-during-bridge" value="true"/>
1104+
`<param name="rtp-autoflush-during-bridge" value="true"/>`
11031105

11041106
###### rtp-autoflush
11051107

@@ -1109,7 +1111,7 @@ Unlike "rtp-autoflush-during-bridge", the default is false, meaning that high-la
11091111

11101112
Setting "rtp-autoflush" to true will discard packets to minimize latency when possible. Doing so may cause errors in DTMF recognition, faxes, and other processes that rely on receiving all packets.
11111113

1112-
&lt;param name="rtp-autoflush" value="true"/>
1114+
`<param name="rtp-autoflush" value="true"/>`
11131115

11141116
##### Auth
11151117

0 commit comments

Comments
 (0)