Date: Thu, 13 Oct 2005 01:53:02 GMT From: Marc Haase <mahaase@ucsd.edu> To: freebsd-gnats-submit@FreeBSD.org Subject: 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 - Message-ID: <200510130153.j9D1r2mE082337@www.freebsd.org> Resent-Message-ID: <200510130200.j9D20UM0091567@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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@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:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200510130153.j9D1r2mE082337>