From owner-freebsd-current@freebsd.org Sun Jul 16 22:29:50 2017 Return-Path: Delivered-To: freebsd-current@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 0887DC7B936 for ; Sun, 16 Jul 2017 22:29:50 +0000 (UTC) (envelope-from ian@freebsd.org) Received: from pmta2.delivery6.ore.mailhop.org (pmta2.delivery6.ore.mailhop.org [54.200.129.228]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id D38B46989C for ; Sun, 16 Jul 2017 22:29:49 +0000 (UTC) (envelope-from ian@freebsd.org) X-MHO-User: 364db2f6-6a76-11e7-a4a1-c9e62e5d9688 X-Report-Abuse-To: https://support.duocircle.com/support/solutions/articles/5000540958-duocircle-standard-smtp-abuse-information X-Originating-IP: 73.78.92.27 X-Mail-Handler: DuoCircle Outbound SMTP Received: from ilsoft.org (unknown [73.78.92.27]) by outbound2.ore.mailhop.org (Halon) with ESMTPSA id 364db2f6-6a76-11e7-a4a1-c9e62e5d9688; Sun, 16 Jul 2017 22:29:21 +0000 (UTC) Received: from rev (rev [172.22.42.240]) by ilsoft.org (8.15.2/8.15.2) with ESMTP id v6GMTeLk004344; Sun, 16 Jul 2017 16:29:40 -0600 (MDT) (envelope-from ian@freebsd.org) Message-ID: <1500244180.22314.61.camel@freebsd.org> Subject: Re: netgraph: documentation issue? What kernel options? Where to find? From: Ian Lepore To: "O. Hartmann" , FreeBSD CURRENT Date: Sun, 16 Jul 2017 16:29:40 -0600 In-Reply-To: <20170716224834.030e004b@thor.intern.walstatt.dynvpn.de> References: <20170716224834.030e004b@thor.intern.walstatt.dynvpn.de> Content-Type: text/plain; charset="ISO-8859-1" X-Mailer: Evolution 3.18.5.1 FreeBSD GNOME Team Port Mime-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 16 Jul 2017 22:29:50 -0000 On Sun, 2017-07-16 at 22:48 +0200, O. Hartmann wrote: > For a small SoC based system, I use a highly customised static kernel > and build the > system via NanoBSD with no kernel modules. > > Tyring to track down some network issues with recent CURRENT I > figured out, that when > using the ppp client to connect via modem to the ISP and there is no  > > options NETGRAPH_ETHER > options NETGRAPH_PPPOE > > in the kernel configuration, the resulting system fails to establish > a ppp session. The > man page states, that a netgraph node is established, but as hard as > I look, I can not > find any(!) information in the man pages what options are > necessary/optional to provide > the correct module statically. > > The same is for many other NETGRAPH_XXX features. Starting from man > page "man 4 > netgraph", section "SEE ALSO", I started tweaking the kernel with > NETGRAPH_XXX, i.e. > ng_vlan -> NETGRAPH_VLAN until the compiler bails out with an error, > for instance > ng_car -> NETGRAPH_CAR. > > I tried to find out what options cover which netgraph module but > there is - right, > nothing I can find on a direct route. > > Since netgraph isn't so brand new (I guess ~ 2000 from the PDFs I > found on the network), > there must be some documentation other than "reading the source > code". > > Please give me some hints where to find the entry point for the > appropriate documented > options for netgraph modules. > > Obviously, some ng_xxx modules are prerequisite for some services to > work properly, as > ppp - but I can't find any hints for "options NETGRAPH_ETHER" or > "options NETGRAPH_PPPOE" > in the manpages (looked at ppp, pppoed).  > > Thanks in advance, > kind regards > > Oliver > I can't help with anything specific to netgraph or its [lack of] docs. For the general question "How do I know what undocumented device or option statement to put in my kernel config to get xxxxx" a good place to start is /usr/src/sys/conf/NOTES.  It's supposed to contain all the options and devices (except some machine/arch-specific stuff).  If you don't find it in NOTES, try "grep -i xxxxx *" in that dir, you may find the thing you're looking for in 'options' or 'files' and get some clues that way. For the netgraph stuff, I see that in NOTES it tells you how to find the manpages for netgraph things, so I guess I accidentally did answer that part too.  :) -- Ian