From nobody@FreeBSD.org  Thu Oct 13 01:53:03 2005
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 602D616A41F
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 13 Oct 2005 01:53:03 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 2713943D48
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 13 Oct 2005 01:53:03 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id j9D1r29N082360
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 13 Oct 2005 01:53:02 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id j9D1r2mE082337;
	Thu, 13 Oct 2005 01:53:02 GMT
	(envelope-from nobody)
Message-Id: <200510130153.j9D1r2mE082337@www.freebsd.org>
Date: Thu, 13 Oct 2005 01:53:02 GMT
From: Marc Haase <mahaase@ucsd.edu>
To: freebsd-gnats-submit@FreeBSD.org
Subject: there is a critical typo that will not allow the bridge to workFreeBSD Handbook Section 26.3.3.2.2 Setting It Up -
X-Send-Pr-Version: www-2.3

>Number:         87355
>Category:       docs
>Synopsis:       [patch] there is a critical typo that will not allow the bridge to workFreeBSD Handbook Section 26.3.3.2.2 Setting It Up -
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Oct 13 02:00:29 GMT 2005
>Closed-Date:    Sat Oct 29 16:36:00 GMT 2005
>Last-Modified:  Sat Oct 29 16:36:00 GMT 2005
>Originator:     Marc Haase
>Release:        5.4-Stable
>Organization:
none
>Environment:
FreeBSD magik.kicks-ass.net 5.4-RELEASE FreeBSD 5.4-RELEASE #0: Sun May  8 10:21:06 UTC 2005     root@harlow.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386     
>Description:
              Not really a bug in the system, it is a bug in the FreeBSD
Handbook: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-wireless.html

Section 26.3.3.2.2
states that you should

# sysctl net.link.ether.bridge.enable=1
# sysctl net.link.ether.bridge.config="wi0,xl0"
# sysctl net.inet.ip.forwarding=1

On FreeBSD versions earlier than 5.2, you need to use the following
options instead:

# sysctl net.link.ether.bridge=1
# sysctl net.link.ether.bridge_cfg="wi0,xl0"
# sysctl net.inet.ip.forwarding=1


but the line # sysctl net.link.ether.bridge.config="wi0,xl0"

has a comma between wi0 and x10 that should not be there

this little error in the handbook has made me spend about 4-5 hours trying
to debug it.

The manual pages for the wi and ath both have the correct syntax.  Please
fix this so that other users trying to set up a bridge will not run into
this problem... I had absolutely no idea what was wrong - and neither did
the first 3 ppl that tried to help me.
>How-To-Repeat:
              
>Fix:
              Just change the line in the handbook from
# sysctl net.link.ether.bridge.config="wi0,xl0"
to
# sysctl net.link.ether.bridge.config="wi0 xl0"
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Thu Oct 13 04:31:39 GMT 2005 
Responsible-Changed-Why:  
Documentation bug. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=87355 
State-Changed-From-To: open->closed 
State-Changed-By: remko 
State-Changed-When: Sat Oct 29 16:35:20 GMT 2005 
State-Changed-Why:  
I adopted the information tin the handbook to match with 
reality.  It will appear after the next scheduled docbuild. 
Thanks for the information! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=87355 
>Unformatted:
