From owner-freebsd-pf@FreeBSD.ORG Thu Sep 16 04:03:08 2004 Return-Path: Delivered-To: freebsd-pf@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 674) id 5B20C16A4D0; Thu, 16 Sep 2004 04:03:08 +0000 (GMT) Delivered-To: mlaier@vampire.homelinux.org Received: (qmail 22908 invoked by uid 1005); 7 May 2004 21:09:45 -0000 Delivered-To: max@vampire.homelinux.org Received: (qmail 22905 invoked from network); 7 May 2004 21:09:45 -0000 Received: from moutng.kundenserver.de (212.227.126.173) by pd9e39e29.dip.t-dialin.net with SMTP; 7 May 2004 21:09:45 -0000 Received: from [212.227.126.158] (helo=mxng08.kundenserver.de) by moutng.kundenserver.de with esmtp (Exim 3.35 #1) id 1BMCbK-0008NZ-00 for max@vampire.homelinux.org; Fri, 07 May 2004 23:09:46 +0200 Received: from [206.53.239.180] (helo=turing.freelists.org) by mxng08.kundenserver.de with esmtp (Exim 3.35 #1) id 1BMCbK-00020G-00 for max@love2party.net; Fri, 07 May 2004 23:09:46 +0200 Received: from localhost (localhost [127.0.0.1])ESMTP id 4CA7672CA1A; Fri, 7 May 2004 15:55:34 -0500 (EST) Received: from turing.freelists.org ([127.0.0.1]) by localhost (turing [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 25517-14; Fri, 7 May 2004 15:55:34 -0500 (EST) Received: from turing (localhost [127.0.0.1])ESMTP id B4C7572C98A; Fri, 7 May 2004 15:55:33 -0500 (EST) Received: with ECARTIS (v1.0.0; list pf4freebsd); Fri, 07 May 2004 15:55:19 -0500 (EST) X-Original-To: pf4freebsd@freelists.org Delivered-To: pf4freebsd@freelists.org Received: from localhost (localhost [127.0.0.1])ESMTP id 8542B72CA1A for ; Fri, 7 May 2004 15:55:13 -0500 (EST) Received: from turing.freelists.org ([127.0.0.1]) by localhost (turing [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 25610-11 for ; Fri, 7 May 2004 15:55:13 -0500 (EST) Received: from moutng.kundenserver.de (moutng.kundenserver.de [212.227.126.189])ESMTP id E92F172CAC2 for ; Fri, 7 May 2004 15:55:12 -0500 (EST) Received: from [212.227.126.207] (helo=mrelayng.kundenserver.de) by moutng.kundenserver.de with esmtp (Exim 3.35 #1) id 1BMCaw-0000XS-00; Fri, 07 May 2004 23:09:22 +0200 Received: from [217.227.158.41] (helo=donor.laier.local) by mrelayng.kundenserver.de with asmtp (TLSv1:RC4-MD5:128) (Exim 3.35 #1) id 1BMCaw-0001Hh-00; Fri, 07 May 2004 23:09:22 +0200 From: Max Laier To: pf4freebsd@freelists.org User-Agent: KMail/1.6.1 MIME-Version: 1.0 Content-type: text/plain; charset=us-ascii Message-Id: <200405072309.31455.max@love2party.net> X-Provags-ID: kundenserver.de abuse@kundenserver.de auth:e28873fbe4dbe612ce62ab869898ff08 X-Virus-Scanned: by amavisd-new at freelists.org X-archive-position: 294 X-ecartis-version: Ecartis v1.0.0 Sender: pf4freebsd-bounce@freelists.org Errors-To: pf4freebsd-bounce@freelists.org X-original-sender: max@love2party.net Precedence: normal X-list: pf4freebsd X-Virus-Scanned: by amavisd-new at freelists.org Content-Transfer-Encoding: quoted-printable X-Provags-Forward: max@love2party.net -> max@vampire.homelinux.org X-UID: 412 X-Length: 6698 X-Mailman-Approved-At: Thu, 16 Sep 2004 04:04:15 +0000 cc: freebsd-doc@freebsd.org Subject: [pf4freebsd] Looking for pf @ FreeBSD documentation X-BeenThere: freebsd-pf@freebsd.org X-Mailman-Version: 2.1.1 Reply-To: pf4freebsd@freelists.org List-Id: Technical discussion and general questions about packet filter (pf) List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Date: Thu, 16 Sep 2004 04:03:08 -0000 X-Original-Date: Fri, 7 May 2004 23:09:10 +0200 X-List-Received-Date: Thu, 16 Sep 2004 04:03:08 -0000 All, as some of you know, pf is now part of the FreeBSD tree as contributed=20 software. This, however, is not documented in any non-manpage way, yet. H= ence=20 I write this, to initiate such documentation and hope for your help in=20 creating such. For a start, it'd be great to have an article to explain about pf and giv= e=20 pointers how to get started with it. A tutorial which explains how to set= up a=20 simple dial-up ppp + NAT firewall would also be great (as I believe that = the=20 pf in-kernel NAT is more than an alternative to the existing options). Th= ere=20 are such documents available for OpenBSD already, most noteable the PF FA= Q on=20 the OpenBSD homepage. The copyright for this document have been clarified= by=20 a recent commit: http://marc.theaimsgroup.com/?l=3Dopenbsd-cvs&m=3D108389500216473&w=3D2=20 which makes it a prime candidate for reference. Thanks to Nick Holland an= d=20 Joel Knight for this! They asked for permission to use FreeBSD changes to= the=20 documentation, which is common sense imo and should not be a problem. Mor= e=20 links to (OpenBSD) documentation are available from: http://pf4freebsd.love2party.net/ http://www.benzedrine.cx/pf.html http://www.openbsd.org/ Questions: Q: What version to document? A: At the moment we are still level with OpenBSD 3.4, but an update to Op= enBSD=20 3.5 will happen in a bit. As it should take some time to get documenta= tion=20 ready I think documenting 3.5 would be best. There will be some quirks= with=20 the interface handling, which I will explain in detail once we have pa= tches=20 ready. Q: While writting I found that XYZ is strange, can you change it? A: By all means, yes! Writting documentation helps to find bugs and stran= ge=20 stuff in the implementation (rc.d e.g.). If you find such things pleas= e=20 take them to me, or the lists (see CC list). Q: What about ALTQ? A: Work is in progress ... but nothing final yet. I consider documenting = the=20 ability of pf in that area helpful to advocate an ALTQ import ;) And e= ven=20 if it does not get imported into the base system, there will always be= =20 external patches to support the releases. Q: ??? A: Bring additional question to me, or follow-up to this thread. I am not= =20 subscribed to -doc so please CC me on what is going on there. I did ch= oose=20 not to write the doc myself, as I am not a native speaker and neither = much=20 of an admin, so I have a somewhat limited view on pf. Also this is a g= ood=20 way to get more eyes on pf and to improof the general infrastructure. With *your* help!!! Looking forward to hearing from you! Thanks in advance! (BCC'ed -current, thread is supposed to life in -doc or the pf4freebsd li= st). --=20 Best regards, | mlaier@freebsd.org Max Laier | ICQ #67774661 http://pf4freebsd.love2party.net/ | mlaier@EFnet -- Attached file included as plaintext by Ecartis -- -- Desc: signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQBAm/sLXyyEoT62BG0RApyNAJ9mujYDufOWLf6A5D+Fv1il354pUACePfdG 3cxkK1KjAU3caiE/cQcXG3Q=3D =3DKSgT -----END PGP SIGNATURE-----