From nobody@FreeBSD.org  Sat Apr 21 02:36:30 2001
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 713FD37B422
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 21 Apr 2001 02:36:29 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f3L9aTj97650;
	Sat, 21 Apr 2001 02:36:29 -0700 (PDT)
	(envelope-from nobody)
Message-Id: <200104210936.f3L9aTj97650@freefall.freebsd.org>
Date: Sat, 21 Apr 2001 02:36:29 -0700 (PDT)
From: d.ougy@bryden.apana.org.au
To: freebsd-gnats-submit@FreeBSD.org
Subject: misleading information in handbook
X-Send-Pr-Version: www-1.0

>Number:         26742
>Category:       misc
>Synopsis:       misleading information in handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Apr 21 02:40:01 PDT 2001
>Closed-Date:    Sun Sep 16 18:47:35 PDT 2001
>Last-Modified:  Sun Sep 16 18:48:27 PDT 2001
>Originator:     Doug Young
>Release:        4.2 RELEASE
>Organization:
>Environment:
4.2 RELEASE
>Description:
According to the official docs, all that needs to be added to the kernel
config file is "options NETGRAPH" ... however that is a sure way to get error messages on boot "module_register: module netgraph already exists!
linker_file_sysinit "netgraph.ko" failed to register! 17"

I found what looks like the solution to these messages at freebsddiary.org

"The above netgraph message can be eliminated by adding the following to
your kernel file, eliminating the need to load the netgraph ether module, which you will need for pppoe to function anyway.
  NETGRAPH_ETHER

In other words, these are the options that you will need to obviate the
need to load any modules.

options NETGRAPH
options NETGRAPH_ETHER
options NETGRAPH_PPPOE
options NETGRAPH_SOCKET


See extract from handbook .... as I read it only "options NETGRAPH"
is necessary, the other lines are "optional". Well I guess they are, but
it sure caused me some lost sleep until I found out was was going on !!

16.4.2. Kernel Configuration
You will need to set the following options in your kernel configuration file and then compile a new kernel.

  a.. options NETGRAPH

Optionally, you can add

  a.. options NETGRAPH_PPPOE

  b.. options NETGRAPH_SOCKET

although if this functionality is not available at runtime, ppp will load the relevant modules on demand
>How-To-Repeat:
compile a kernel with ONLY "options NETGRAPH", not all relevant lines
>Fix:
Alter handbook section "16.4.2. Kernel Configuration" to state ALL netgraph options should be included in kernel config file
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: dd 
Responsible-Changed-When: Sat Apr 28 20:07:21 PDT 2001 
Responsible-Changed-Why:  
docs problem. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=26742 
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Sun Sep 16 18:47:35 PDT 2001 
State-Changed-Why:  
The text has been updated.  You no longer have to configure NETGRAPH 
support for your kernel, it is done automatically if you add 'ppp' to 
your config file.  If there are any more problems with this chapter, 
then please file another PR.  Thanks. 


http://www.FreeBSD.org/cgi/query-pr.cgi?pr=26742 
>Unformatted:
