From owner-freebsd-bugs@FreeBSD.ORG Thu Oct 13 02:00:31 2005 Return-Path: X-Original-To: freebsd-bugs@hub.freebsd.org Delivered-To: freebsd-bugs@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7253616A41F for ; Thu, 13 Oct 2005 02:00:31 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6B7D743D53 for ; Thu, 13 Oct 2005 02:00:30 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j9D20UiB091568 for ; Thu, 13 Oct 2005 02:00:30 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j9D20UM0091567; Thu, 13 Oct 2005 02:00:30 GMT (envelope-from gnats) Resent-Date: Thu, 13 Oct 2005 02:00:30 GMT Resent-Message-Id: <200510130200.j9D20UM0091567@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-bugs@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Marc Haase Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 602D616A41F for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Cc: 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 - X-BeenThere: freebsd-bugs@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 13 Oct 2005 02:00:31 -0000 >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: