From owner-freebsd-doc@FreeBSD.ORG Wed Jan 6 00:50:08 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 511921065792 for ; Wed, 6 Jan 2010 00:50:08 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id BEA428FC1B for ; Wed, 6 Jan 2010 00:50:07 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id o060o7wD099465 for ; Wed, 6 Jan 2010 00:50:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id o060o7VF099464; Wed, 6 Jan 2010 00:50:07 GMT (envelope-from gnats) Resent-Date: Wed, 6 Jan 2010 00:50:07 GMT Resent-Message-Id: <201001060050.o060o7VF099464@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Matthew Thyer Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 02C28106568B for ; Wed, 6 Jan 2010 00:49:40 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id CC9118FC12 for ; Wed, 6 Jan 2010 00:49:39 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o060nd4s024697 for ; Wed, 6 Jan 2010 00:49:39 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id o060ndRJ024696; Wed, 6 Jan 2010 00:49:39 GMT (envelope-from nobody) Message-Id: <201001060049.o060ndRJ024696@www.freebsd.org> Date: Wed, 6 Jan 2010 00:49:39 GMT From: Matthew Thyer To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/142367: wlan(4) does not document requirement for kernel option "IEEE80211_DEBUG" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 06 Jan 2010 00:50:08 -0000 >Number: 142367 >Category: docs >Synopsis: wlan(4) does not document requirement for kernel option "IEEE80211_DEBUG" >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Jan 06 00:50:07 UTC 2010 >Closed-Date: >Last-Modified: >Originator: Matthew Thyer >Release: 8-STABLE >Organization: >Environment: FreeBSD soekris-builder8 8.0-STABLE FreeBSD 8.0-STABLE #0 r200974: Fri Dec 25 12 :30:51 CST 2009 root@soekris-builder8:/usr/obj/usr/src/sys/MYGENERIC i386 >Description: Use of the "wlandebug" command produces the error message: wlandebug: sysctl-get(net.wlan.0.debug): No such file or directory This is due to the "IEEE80211_DEBUG" option not being present in the GENERIC ker nel (for both 8-STABLE and HEAD). The wlan(4) manual page does not describe the need for this kernel option and so the end user has to search the web to gain a clue as to what the problem is. I suggest that this requirement be mentioned in the "DEBUGGING" section of the w lan(4) manual page. Sam Leffler notes this requirement in a message to the FreeBSD-CURRENT mailing l ist with Message-ID: 481A2748.7080801@freebsd.org, Subject: "Re: Connection prob lems with wme enabled" & date: "Thu, 01 May 2008 13:25:44 -0700". Quote: "Looks like I failed to include IEEE80211_DEBUG in the default kernel configs; you'll need that to get wlan debug msgs." >How-To-Repeat: Run "wlandebug" with a GENERIC kernel and you'll get the error message: wlandebug: sysctl-get(net.wlan.0.debug): No such file or directory >Fix: Add text to the "DEBUGGING" section of the wlan(4) manual page similar to: The kernel option "IEEE80211_DEBUG" is required to use debugging controls. Patch attached with submission follows: --- /usr/src/share/man/man4/wlan.4 2009-12-24 15:14:38.000000000 +1030 +++ /usr/src/share/man/man4/wlan.4.new 2010-01-06 11:01:04.000000000 +1030 @@ -156,6 +156,8 @@ defines the initial value of the debugging flags for each cloned .Nm interface; this is useful to enable debug messages during interface creation. +.Pp +The kernel option "IEEE80211_DEBUG" is required to use debugging controls. .Sh COMPATIBILITY The module name of .Nm >Release-Note: >Audit-Trail: >Unformatted: