Merged revisions 56569 via svnmerge from
[asterisk/asterisk.git] / doc / ip-tos.txt
1 IP Type of Service settings for VoIP channels
2 ---------------------------------------------
3
4 Asterisk can set the Type of Service (TOS) byte on outgoing IP packets
5 for various protocols.  The TOS byte is used by the network to provide
6 some level of Quality of Service (QoS) even if the network is
7 congested with other traffic. 
8
9 * SIP
10 -----
11 In sip.conf, there are three parameters that control the TOS settings:
12 "tos_sip", "tos_audio", and "tos_video".  tos_sip controls what TOS SIP call
13 signalling packets are set to.  tos_audio controls what TOS RTP audio
14 packets are set to.  tos_video controls what TOS RTP video packets are
15 set to.  
16
17 * IAX2
18 ------
19 In iax.conf, there is a "tos" parameter that sets the global default TOS
20 for IAX packets generated by chan_iax2.  Since IAX connections combine
21 signalling, audio, and video into one UDP stream, it is not possible
22 to set the TOS separately for the different types of traffic.
23
24 In iaxprov.conf, there is a "tos" parameter that tells the IAXy what TOS
25 to set on packets it generates.  As with the parameter in iax.conf,
26 IAX packets generated by an IAXy cannot have different TOS settings
27 based upon the type of packet.  However different IAXy devices can
28 have different TOS settings.
29
30 The allowable values for any of the tos* parameters are:
31 CS0, CS1, CS2, CS3, CS4, CS5, CS6, CS7, AF11, AF12, AF13,
32 AF21, AF22, AF23, AF31, AF32, AF33, AF41, AF42, AF43 and
33 ef (expedited forwarding),
34
35 The tos* parameters also take numeric values.
36
37 The lowdelay, throughput, reliability, mincost, and none values are no
38 longer supported in this version of Asterisk.
39
40 ===========================================
41 Configuration   Parameter       Recommended
42 File                            Setting
43 -------------------------------------------
44 sip.conf        tos_sip         cs3
45 sip.conf        tos_audio       ef
46 sip.conf        tos_video       af41
47 -------------------------------------------
48 iax.conf        tos             ef
49 -------------------------------------------
50 iaxprov.conf    tos             ef
51 ===========================================
52
53
54 * REFERENCE
55 -----------
56 RFC 2474 - "Definition of the Differentiated Services Field
57 (DS field) in the IPv4 and IPv6 Headers", Nichols, K., et al,
58 December 1998.
59
60 IANA Assignments, DSCP registry
61 Differentiated Services Field Codepoints
62 http://www.iana.org/assignments/dscp-registry
63
64 To get the most out of setting the TOS on packets generated by
65 Asterisk, you will need to ensure that your network handles packets
66 with a TOS properly.  For Cisco devices, see the previously mentioned
67 "Enterprise QoS Solution Reference Network Design Guide".  For Linux
68 systems see the "Linux Advanced Routing & Traffic Control HOWTO" at
69 <http://www.lartc.org/>.
70
71 For more information on Quality of
72 Service for VoIP networks see the "Enterprise QoS Solution Reference
73 Network Design Guide" version 3.3 from Cisco at:
74
75 <http://www.cisco.com/application/pdf/en/us/guest/netsol/ns432/c649/ccmigration_09186a008049b062.pdf>
76