From owner-freebsd-hackers Fri Nov 30 1:44:22 2001 Delivered-To: freebsd-hackers@freebsd.org Received: from mail.freebsd-corp-net-guide.com (mail.freebsd-corp-net-guide.com [206.29.169.15]) by hub.freebsd.org (Postfix) with ESMTP id B9D1137B41B; Fri, 30 Nov 2001 01:44:16 -0800 (PST) Received: from tedm.placo.com (nat-rtr.freebsd-corp-net-guide.com [206.29.168.154]) by mail.freebsd-corp-net-guide.com (8.11.1/8.11.1) with SMTP id fAU9i8R57475; Fri, 30 Nov 2001 01:44:08 -0800 (PST) (envelope-from tedm@toybox.placo.com) From: "Ted Mittelstaedt" To: "Julian Elischer" Cc: , , Subject: RE: Netgraph Date: Fri, 30 Nov 2001 01:44:08 -0800 Message-ID: <001601c17983$8e7fc760$1401a8c0@tedm.placo.com> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook 8.5, Build 4.71.2173.0 Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V4.72.3155.0 In-Reply-To: Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG >-----Original Message----- >From: Julian Elischer [mailto:julian@elischer.org] >Sent: Friday, November 30, 2001 1:01 AM >To: Ted Mittelstaedt >Cc: A180009977889@aol.com; hackers@FreeBSD.ORG; questions@FreeBSD.ORG >Subject: RE: Netgraph > > > > >On Fri, 30 Nov 2001, Ted Mittelstaedt wrote: > >> >-----Original Message----- >> >> If there is anything wrong with netgraph is that there's a lack of >examples of >> setting up common configurations in the handbook, man pages, and other >> documents. > >/usr/share/examples/netgraph gives examples of some common >configurations. > Oh dang, I should have checked there. But really, this info needs to be in the ngctl man page. >> Also, speaking as a writer, section 4 of the manual page on netgraph is >> extremely >> hard to digest, within the first paragraph alone they redefine the >meaning of >> the words "graph", "node", "hook", and "edge" I understand it's because of >> the modularness of the software but this is a man page that needs >to be a lot >> less >> abbreviated. > >Suggestions welcome.. :-) > The biggest problem with those man pages is that they tell you exactly what the stuff does but not exactly why you would want to do it. I actually sent in a proposal to BSDcon to give a presentation on building network routers with FreeBSD, with a big D&P show of different systems tied together. Discussion of Netgraph would have been part of this of course and while I was writing that part I could have modified the man pages. But it wasn't picked up and I set it aside. Maybe sometime in the future I'll pick it up again. Ted Mittelstaedt tedm@toybox.placo.com Author of: The FreeBSD Corporate Networker's Guide Book website: http://www.freebsd-corp-net-guide.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message