kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-09-05 12:16:00 +00:00
Code Issues Packages Projects Releases Wiki Activity

Fix typo (thanks, North) and update docs for IP-tos settings

Browse Source 
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@15614 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Olle Johansson
2006-03-28 17:18:02 +00:00
parent d0bc6c20a7
commit 5edae1cba0
2 changed files with 33 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
acl.c
View File

@@ -313,7 +313,7 @@ int ast_str2tos(const char *value, unsigned int *tos)
else else
return -1; return -1;
ast_log(LOG_WARNING, "tos value %s is deprecated. See doc/ip-tos.txt for more information.", value); ast_log(LOG_WARNING, "TOS value %s is deprecated. Please see doc/ip-tos.txt for more information.\n", value);
return 0; return 0;
} }

46
doc/ip-tos.txt
View File

@@ -4,42 +4,43 @@ IP Type of Service settings for VoIP channels
Asterisk can set the Type of Service (TOS) byte on outgoing IP packets Asterisk can set the Type of Service (TOS) byte on outgoing IP packets
for various protocols. The TOS byte is used by the network to provide for various protocols. The TOS byte is used by the network to provide
some level of Quality of Service (QoS) even if the network is some level of Quality of Service (QoS) even if the network is
congested with other traffic. For more information on Quality of congested with other traffic.
Service for VoIP networks see the "Enterprise QoS Solution Reference
Network Design Guide" version 3.3 from Cisco at:
<http://www.cisco.com/application/pdf/en/us/guest/netsol/ns432/c649/ccmigration_09186a008049b062.pdf>
* SIP
-----
In sip.conf, there are three parameters that control the TOS settings: In sip.conf, there are three parameters that control the TOS settings:
tos_sip, tos_audio, and tos_video. tos_sip controls what TOS SIP call "tos_sip", "tos_audio", and "tos_video". tos_sip controls what TOS SIP call
signalling packets are set to. tos_audio controls what TOS RTP audio signalling packets are set to. tos_audio controls what TOS RTP audio
packets are set to. tos_video controls what TOS RTP video packets are packets are set to. tos_video controls what TOS RTP video packets are
set to. There is a "tos" parameter that is supported for backwards set to.
There is a "tos" parameter that is supported for backwards
compatibility. The tos parameter should be avoided in sip.conf compatibility. The tos parameter should be avoided in sip.conf
because it sets all three tos settings in sip.conf to the same value. because it sets all three tos settings in sip.conf to the same value.
In iax.conf, there is a tos parameter that sets the global default TOS * IAX2
------
In iax.conf, there is a "tos" parameter that sets the global default TOS
for IAX packets generated by chan_iax2. Since IAX connections combine for IAX packets generated by chan_iax2. Since IAX connections combine
signalling, audio, and video into one UDP stream, it is not possible signalling, audio, and video into one UDP stream, it is not possible
to set the TOS separately for the different types of traffic. to set the TOS separately for the different types of traffic.
In iaxprov.conf, there is a tos parameter that tells the IAXy what TOS In iaxprov.conf, there is a "tos" parameter that tells the IAXy what TOS
to set on packets it generates. As with the parameter in iax.conf, to set on packets it generates. As with the parameter in iax.conf,
IAX packets generated by an IAXy cannot have different TOS settings IAX packets generated by an IAXy cannot have different TOS settings
based upon the type of packet. However different IAXy devices can based upon the type of packet. However different IAXy devices can
have different TOS settings. have different TOS settings.
The allowable values for any of the tos* parameters are: The allowable values for any of the tos* parameters are:
CS0, CS1, CS2, CS3, CS4, CS5, CS6, CS7, AF11, AF12, AF13,
be (best effort), cs1, af11, af12, af13, cs2, af21, af22, af23, cs3, AF21, AF22, AF23, AF31, AF32, AF33, AF41, AF42, AF43 and
af31, af32, af33, cs4, af41, af42, af42, ef (expedited forwarding), ef (expedited forwarding),
lowdelay, throughput, reliability, mincost, none
The tos* parameters also take numeric values. The tos* parameters also take numeric values.
The lowdelay, throughput, reliability, mincost, and none values are The lowdelay, throughput, reliability, mincost, and none values are
deprecated because they set the IP TOS using the outdated "IP deprecated because they set the IP TOS using the outdated "IP
prececence" model as defined in RFC 791 and RFC 1349. prececence" model as defined in RFC 791 and RFC 1349. They still
work in this version of Asterisk, but will be removed in future releases.
=========================================== ===========================================
Configuation Parameter Recommended Configuation Parameter Recommended
@@ -54,6 +55,17 @@ iax.conf tos ef
iaxprov.conf tos ef iaxprov.conf tos ef
=========================================== ===========================================
* REFERENCE
-----------
RFC 2474 - "Definition of the Differentiated Services Field
(DS field) in the IPv4 and IPv6 Headers", Nichols, K., et al,
December 1998.
IANA Assignments, DSCP registry
Differentiated Services Field Codepoints
http://www.iana.org/assignments/dscp-registry
To get the most out of setting the TOS on packets generated by To get the most out of setting the TOS on packets generated by
Asterisk, you will need to ensure that your network handles packets Asterisk, you will need to ensure that your network handles packets
with a TOS properly. For Cisco devices, see the previously mentioned with a TOS properly. For Cisco devices, see the previously mentioned
@@ -61,3 +73,9 @@ with a TOS properly. For Cisco devices, see the previously mentioned
systems see the "Linux Advanced Routing & Traffic Control HOWTO" at systems see the "Linux Advanced Routing & Traffic Control HOWTO" at
<http://www.lartc.org/>. <http://www.lartc.org/>.
For more information on Quality of
Service for VoIP networks see the "Enterprise QoS Solution Reference
Network Design Guide" version 3.3 from Cisco at:
<http://www.cisco.com/application/pdf/en/us/guest/netsol/ns432/c649/ccmigration_09186a008049b062.pdf>