Bug 116588

Summary: No IPFW tables or dummynet in Handbook
Product: Documentation Reporter: Cristian KLEIN <cristi>
Component: Books & ArticlesAssignee: Tom Jones <thj>
Status: Open ---    
Severity: Affects Only Me CC: doc, pauamma, thj
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Bug Depends on:    
Bug Blocks: 263315    
Attachments:
Description Flags
file.diff
none
firewalls_chapter.diff none

Description Cristian KLEIN 2007-09-24 00:10:01 UTC 
The handbook does not mention anything about how to configure dummynet or how to use tables in IPFW. I personally consider that these two things add a lot of value to IPFW and a least some examples must be included in the Handbook.

Fix: Apply the attached patch like this:

cd /usr/doc/books/handbook/firewalls
patch < ipfw-dummynet-tables.patch
cd ..
make


Patch attached with submission follows:
Comment 1 Cristian KLEIN 2007-09-24 00:40:27 UTC 
I'm really sorry for the noise. The patch does not specify how to load dummynet.
Please add the following line somewhere in section "firewalls-ipfw-dummynet":

<para>In order to use dummynet, you will have to load it by adding the
following line to <filename>/boot/loader.conf</filename>:</para>

<programlisting>dummynet_load="YES"</programlisting>
Comment 2 Remko Lodder freebsd_committer freebsd_triage 2008-02-21 14:25:09 UTC 
Responsible Changed
From-To: freebsd-doc->remko

I'll take it.
Comment 3 Remko Lodder freebsd_committer freebsd_triage 2012-09-27 08:43:55 UTC 
Responsible Changed
From-To: remko->freebsd-doc

I have held this locked for too long, reassign to the pool
Comment 4 Sevan Janiyan 2014-05-26 06:11:45 UTC 
Attached is an updated diff which adds instructions for dummynet & 
utilising tables alongside adjustments highlighted by igor.

One issue which I was unable to fix was
450:bad tag indent:      <para>By default, <application>PF</application> 
reads its
Comment 5 Eitan Adler freebsd_committer freebsd_triage 2017-12-31 08:01:43 UTC 
For bugs matching the following criteria:

Status: In Progress Changed: (is less than) 2014-06-01

Reset to default assignee and clear in-progress tags.

Mail being skipped
Comment 6 Graham Perrin freebsd_committer freebsd_triage 2021-12-28 13:18:08 UTC 
Now five mentions of dummynet, please see for example: 

<https://docs.freebsd.org/en/books/handbook/firewalls/#firewalls-intro>
Comment 7 Pau Amma 2022-04-16 12:50:58 UTC 
thj@, are you still working on this or planning to?
Comment 8 Graham Perrin freebsd_committer freebsd_triage 2022-12-30 11:59:35 UTC 
Triage, batch edit (just one): 

* for twenty-eight FreeBSD Handbook-related reports that had gained a 
  personal assignee, prior group/list assignee doc@ was 
  missing from the CC list.

Gentle hint: <https://wiki.freebsd.org/Bugzilla/> ▶ do, don't …