For some reason when I merged 802.1p support, the new documentation file was
authorRussell Bryant <russell@russellbryant.com>
Wed, 2 May 2007 15:17:26 +0000 (15:17 +0000)
committerRussell Bryant <russell@russellbryant.com>
Wed, 2 May 2007 15:17:26 +0000 (15:17 +0000)
not properly added.  Thanks to IgorG for pointing it out!  :)

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@62671 65c4cc65-6c06-0410-ace0-fbb531ad65f3

doc/qos.tex [moved from doc/ip-tos.tex with 70% similarity]

similarity index 70%
rename from doc/ip-tos.tex
rename to doc/qos.tex
index aa753b5..c4d06e8 100644 (file)
@@ -5,14 +5,22 @@ 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
 congested with other traffic. 
 
+Also asterisk running on Linux can set 802.1p CoS marks in VLAN packets 
+for all used VoIP protocols. It is useful when you are working in switched 
+enviropment. For maping skb->priority and VLAN CoS mark you need to use 
+command "vconfig set_egress_map [vlan-device] [skb-priority] [vlan-qos]".
+
 \subsubsection{SIP}
 
 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
-signalling packets are set to.  tos\_audio controls what TOS RTP audio
+"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
 packets are set to.  tos\_video controls what TOS RTP video packets are
 set to.  
 
+There are four parameters to control 802.1p CoS: "cos\_sip", "cos\_audio", 
+"cos\_video" and "cos\_text". It's behavior the same as writen above.
+
 There is a "tos" parameter that is supported for backwards
 compatibility.  The tos parameter should be avoided in sip.conf
 because it sets all three tos settings in sip.conf to the same value.
@@ -29,6 +37,14 @@ IAX packets generated by an IAXy cannot have different TOS settings
 based upon the type of packet.  However different IAXy devices can
 have different TOS settings.
 
+\subsubsection{H.323}
+Also support TOS and CoS. 
+
+\subsubsection{MGCP}
+Also support TOS and CoS.
+
+\subsubsection{IP TOS values}
+
 The allowable values for any of the tos* parameters are:
 CS0, CS1, CS2, CS3, CS4, CS5, CS6, CS7, AF11, AF12, AF13,
 AF21, AF22, AF23, AF31, AF32, AF33, AF41, AF42, AF43 and
@@ -41,6 +57,12 @@ deprecated because they set the IP TOS using the outdated "IP
 precedence" model as defined in RFC 791 and RFC 1349. They still
 work in this version of Asterisk, but will be removed in future releases.
 
+\subsubsection{802.1p CoS values}
+
+As 802.1p uses 3 bites from VLAN header, there are parameter can take 
+integer values from 0 to 7.
+
+
 \begin{verbatim}
 ===========================================
 Configuration  Parameter       Recommended
@@ -49,15 +71,31 @@ File                                Setting
 sip.conf       tos\_sip        cs3
 sip.conf       tos\_audio      ef
 sip.conf       tos\_video      af41
+sip.conf       tos\_text       af41
+sip.conf       cos\_sip        4
+sip.conf       cos\_audio      6
+sip.conf       cos\_video      5
+sip.conf       cos\_text       0
 -------------------------------------------
 iax.conf       tos             ef
+iax.conf       cos             6       
 -------------------------------------------
 iaxprov.conf   tos             ef
+-------------------------------------------
+mgcp.conf      tos             ef
+mgcp.conf      cos             6
+-------------------------------------------
+h323.conf      tos             ef
+h323.conf      cos             6
 ===========================================
 \end{verbatim}
 
 \subsubsection{Reference}
 
+IEEE 802.1Q Standard:
+http://standards.ieee.org/getieee802/download/802.1Q-1998.pdf
+Related protocols: IEEE 802.3, 802.2, 802.1D, 802.1Q
+
 RFC 2474 - "Definition of the Differentiated Services Field
 (DS field) in the IPv4 and IPv6 Headers", Nichols, K., et al,
 December 1998.