misc/87355: there is a critical typo that will not allow the bridge to workFreeBSD Handbook Section 26.3.3.2.2 Setting It Up -

[Marc Haase]

>Number:         87355
>Category:       misc
>Synopsis:       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-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Oct 13 02:00:29 GMT 2005
>Closed-Date:
>Last-Modified:
>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 at 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:
>Unformatted: