Bug 76750

Summary: Fix wording about what version of FreeBSD PF can be used in.
Product: Documentation Reporter: Brad Davis <so14k>
Component: Books & ArticlesAssignee: Giorgos Keramidas <keramida>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Brad Davis 2005-01-27 12:00:36 UTC
	Fix wording about what version of FreeBSD PF can be used in.
Comment 1 Brad Davis 2005-01-27 12:39:16 UTC
--- doc-ori/en_US.ISO8859-1/books/handbook/firewalls/chapter.sgml
Thu Jan 27 02:39:18 2005
+++ doc/en_US.ISO8859-1/books/handbook/firewalls/chapter.sgml   Thu Jan
27 05:35:46 2005
@@ -206,9 +206,14 @@
       not be made part of this handbook firewall section as that would
       just be duplicated effort.</para>
 
-    <para>For older 5.X version of &os; you can find
-      <acronym>PF</acronym> in the &os; ports collection here:
-      <filename role="package">security/pf</filename>.</para>
+    <para>For versions of &os; younger than 5.0 and older than 5.3 you
+      can find <acronym>PF</acronym> in the &os; ports collection here:
+      <filename role="package">security/pf</filename>. It is strongly
+      recommended to upgrade to 5.3</para>
+
+    <note>
+      <para><acronym>PF</acronym> is not avaliable for &os; 4.</para>
+    </note>
 
     <para>More info can be found at the PF for &os; web site: <ulink
       url="http://pf4freebsd.love2party.net/"></ulink>.</para>
Comment 2 Giorgos Keramidas freebsd_committer freebsd_triage 2005-01-27 12:45:02 UTC
On 2005-01-27 04:59, Brad Davis <so14k@so14k.com> wrote:
> -    <para>For older 5.X version of &os; you can find
> -      <acronym>PF</acronym> in the &os; ports collection here:
> +    <para>For versions of &os; younger than 5.0 and older than 5.3 you
> +      can find <acronym>PF</acronym> in the &os; ports collection here:
>        <filename role="package">security/pf</filename>.</para>

pf(9) is, AFAIK, included as part of the base system in releases `older
than 5.3'.  So the correction is not 100% true.

> +      <para><acronym>PF</acronym> is not avaliable for &os; 4.</para>

Typo: s/avaliable/available/.
Comment 3 Giorgos Keramidas 2005-01-27 13:40:48 UTC
On 2005-01-27 14:15, Max Laier <max@love2party.net> wrote:
>On Thursday 27 January 2005 13:50, Giorgos Keramidas wrote:
>>On 2005-01-27 04:59, Brad Davis <so14k@so14k.com> wrote:
>>> -    <para>For older 5.X version of &os; you can find
>>> -      <acronym>PF</acronym> in the &os; ports collection here:
>>> +    <para>For versions of &os; younger than 5.0 and older than 5.3 you
>>> +      can find <acronym>PF</acronym> in the &os; ports collection here:
>>>        <filename role="package">security/pf</filename>.</para>
>>
>> pf(9) is, AFAIK, included as part of the base system in releases
>> `older than 5.3'.  So the correction is not 100% true.
>
> 5.3 was the first *release* with PF included.  5.2.1, 5.1 and 5.0(not
> sure) can be supported from security/pf.  One should note, that the
> port is outdated (OpenBSD 3.4) and no longer maintained.  I'll remove
> the port with the release of 5.4 (and will correct the firewall
> chapter accordingly).  4.x can get pf from KAME snapshots, btw.

Thanks for the very informative reply Max :-)

What is, in your opinion, the best thing to do?  Currently, the text of
the Handbook reads:

%    24.4 The Packet Filter (PF) Firewall
%
%    As of July 2003 the OpenBSD firewall software application known
%    as PF was ported to FreeBSD and was made available in the FreeBSD
%    ports collection; the first release that contained PF as an
%    integrated part of the base system was FreeBSD 5.3 in November
%    2004. [...]
%
%    For older 5.X version of FreeBSD you can find PF in the FreeBSD
%    ports collection here: security/pf.

If I am reading your reply correctly, we don't need to change anything;
the Handbook text describes correctly PF as part of the base system
after 5.3-RELEASE and points everyone else to the port.  The only thing
that could probably be added is "4.x can get pf from KAME snapshots".

- Giorgos
Comment 4 Giorgos Keramidas freebsd_committer freebsd_triage 2005-01-27 15:28:04 UTC
State Changed
From-To: open->closed

Committed, thanks. 


Comment 5 Giorgos Keramidas freebsd_committer freebsd_triage 2005-01-27 15:28:04 UTC
Responsible Changed
From-To: freebsd-doc->keramida