netgraph: documentation issue? What kernel options? Where to find?

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

netgraph: documentation issue? What kernel options? Where to find?

O. Hartmann-5
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


attachment0 (321 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: netgraph: documentation issue? What kernel options? Where to find?

Ian Lepore-3
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
_______________________________________________
[hidden email] mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-current
To unsubscribe, send any mail to "[hidden email]"
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: netgraph: documentation issue? What kernel options? Where to find?

O. Hartmann-5
Am Sun, 16 Jul 2017 16:29:40 -0600
Ian Lepore <[hidden email]> schrieb:

> 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.
Yes, correct and I did this, too, but pulling in all of the options resulted in failues,
as far as I know NETGRAPH_CAR bailed out (with -DNO_CLEAN, I must confess).

>
> 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.  :)

No, not exactly,
it doesn't tell me which NETGRAPH_XXX I need for a certain service so I have to do
experiments: starting the service with a full install of all modules and see what modules
gets kloaded and then put the appropriate option into the kernel.

In my situation, using ppp/pppoe failed silently when disabling options NETGRAPH_ETHER,
NETGRAPH_PPPOE and the refering kernel modules weren't present.

Since I fight a problem with VLANs and routing on CURRENT, I'd appreciate a more dense
documentation - or a hint.

>
> -- Ian


Thank you very much for the patience,

kind regards

Oliver

--
O. Hartmann

Ich widerspreche der Nutzung oder Übermittlung meiner Daten für
Werbezwecke oder für die Markt- oder Meinungsforschung (§ 28 Abs. 4 BDSG).

attachment0 (321 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: netgraph: documentation issue? What kernel options? Where to find?

Claude Buisson-2
In reply to this post by O. Hartmann-5
On 07/16/2017 22:48, 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
>

Here, using ppoe:

/etc/ppp/ppp.conf
   ...
   set device PPPoE:re0
   ...

and I find:

# kldstat
  ...
  netgraph.ko
  ng_ether.ko
  ng_pppoe.ko
  ng_socket.ko
  ...

Hope this help

CBuisson
_______________________________________________
[hidden email] mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-current
To unsubscribe, send any mail to "[hidden email]"
Loading...