docs/78096: Add info on setting up ATLQ

[Brad Davis]

>Number:         78096
>Category:       docs
>Synopsis:       Add info on setting up ATLQ
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Feb 25 21:20:08 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Brad Davis
>Release:        FreeBSD 5.4-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD mccaffrey.house.so14k.com 5.4-PRERELEASE FreeBSD 5.4-PRERELEASE #0: Thu Feb 24 17:03:44 MST 2005 root at mccaffrey.house.so14k.com:/usr/obj/usr/src/sys/SMP i386
>Description:
	After working with mlaier@, simon@ and trhodes@, this is what we came up with.
>How-To-Repeat:
>Fix:

--- doc-ori/en_US.ISO8859-1/books/handbook/firewalls/chapter.sgml	Fri Feb 25 13:31:41 2005
+++ doc/en_US.ISO8859-1/books/handbook/firewalls/chapter.sgml	Fri Feb 25 14:05:54 2005
@@ -198,7 +198,7 @@
   </sect1>
 
   <sect1 id="firewalls-pf">
-    <title>The Packet Filter (PF) Firewall</title>
+    <title>The Packet Filter (PF) Firewall and ALTQ</title>
 
     <indexterm>
       <primary>firewall</primary>
@@ -211,9 +211,9 @@
       contained <acronym>PF</acronym> as an integrated part of the
       base system was &os; 5.3 in November 2004.
       <acronym>PF</acronym> is a complete, fully featured firewall
-      that contains <acronym>ALTQ</acronym> for bandwidth usage
-      management in a way similar to what DUMMYNET provides in
-      <acronym>IPFW</acronym>.  The OpenBSD project does an
+      that contains <acronym>ALTQ</acronym> (Alternate Queuing) for
+      bandwidth usage management in a way similar to what DUMMYNET
+      provides in <acronym>IPFW</acronym>.  The OpenBSD project does an
       outstanding job of maintaining the PF users' guide that it will
       not be made part of this handbook firewall section as that would
       just be duplicated effort.</para>
@@ -356,6 +356,61 @@
         enable the following option as well:</para>
 
       <programlisting>gateway_enable="YES"            # Enable as Lan gateway</programlisting>
+
+    </sect2>
+    <sect2>
+      <title>Enabling ALTQ</title>
+
+      <para>ALTQ is only avaliable by compiling the options into the
+        &os; Kernel.</para>
+
+      <para>ALTQ is not supported by all of the avaliable network card
+        drivers.  Please see the &man.altq.4; manual page for a list of
+        drivers that are supported in your release of &os;.
+
+    </sect2>
+    <sect2>
+      <title>ALTQ Kernel options</title>
+
+      <para>ALTQ is composed of many different parts to give the
+        functionality required.  The avaliable options are:</para>
+
+      <programlisting>options         ALTQ
+options         ALTQ_CBQ        # Class Bases Queuing
+options         ALTQ_RED        # Random Early Detection
+options         ALTQ_RIO        # RED In/Out
+options         ALTQ_HFSC       # Hierarchical Packet Scheduler
+options         ALTQ_PRIQ       # Priority Queuing
+options         ALTQ_NOPCC      # Required for SMP build</programlisting>
+
+      <para><literal>options ALTQ</literal> enables the ALTQ framework.</para>
+
+      <para><literal>options ALTQ_CBQ</literal> enables Class Based
+        Queuing (CBQ).  CBQ allows you to divide a connections's
+        bandwidth into different classes or queues.</para>
+
+      <para><literal>options ALTQ_RED</literal> enables Random Early
+        Detection (RED).  RED is used to avoid network congestion.  RED
+        does this by measuring the length of the queue and comparing
+        it to the minimum and maximum thresholds for the queue.  If the
+        queue is over the maximum all new packets will be dropped.  True
+        to its name, RED drops packets from different connections
+        randomly.</para>
+
+      <para><literal>options ALTQ_RIO</literal> enables Random Early
+        Detection In and Out.</para>
+
+      <para><literal>options ALTQ_HFSC</literal> enables Hierarchical
+        Fair Service Curve Packet Scheduler.  See <ulink
+        url="http://www-2.cs.cmu.edu/~hzhang/HFSC/main.html"></ulink>
+        for more info.</para>
+
+      <para><literal>options ALTQ_PRIQ</literal> enables Priority
+        Queuing (PRIQ).  PRIQ will always pass traffic that is in a
+        higher queue first.</para>
+
+      <para><literal>options ALTQ_NOPCC</literal> enables SMP support
+        for ALTQ.  This option is required on SMP systems.</para>
 
     </sect2>
   </sect1>
>Release-Note:
>Audit-Trail:
>Unformatted: