Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 30 Nov 2001 01:44:08 -0800
From:      "Ted Mittelstaedt" <tedm@toybox.placo.com>
To:        "Julian Elischer" <julian@elischer.org>
Cc:        <A180009977889@aol.com>, <hackers@FreeBSD.ORG>, <questions@FreeBSD.ORG>
Subject:   RE: Netgraph
Message-ID:  <001601c17983$8e7fc760$1401a8c0@tedm.placo.com>
In-Reply-To: <Pine.BSF.4.21.0111300059061.22768-100000@InterJet.elischer.org>

next in thread | previous in thread | raw e-mail | index | archive | help
>-----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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?001601c17983$8e7fc760$1401a8c0>