Bug 116588 - No IPFW tables or dummynet in Handbook
Summary: No IPFW tables or dummynet in Handbook
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: Tom Jones
URL:
Keywords:
Depends on:
Blocks: handbook-2022
  Show dependency treegraph
 
Reported: 2007-09-24 00:10 UTC by Cristian KLEIN
Modified: 2022-12-30 11:59 UTC (History)
3 users (show)

See Also:


Attachments
file.diff (6.52 KB, patch)
2007-09-24 00:10 UTC, Cristian KLEIN
no flags Details | Diff
firewalls_chapter.diff (9.86 KB, patch)
2014-05-26 06:11 UTC, Sevan Janiyan
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
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 …