From nobody@FreeBSD.org  Wed Jun  4 00:18:02 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id CF76E1065673
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  4 Jun 2008 00:18:02 +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 B9D2D8FC15
	for <freebsd-gnats-submit@FreeBSD.org>; Wed,  4 Jun 2008 00:18:02 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m540GBeC088806
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 4 Jun 2008 00:16:11 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.2/8.14.1/Submit) id m540GAPo088805;
	Wed, 4 Jun 2008 00:16:10 GMT
	(envelope-from nobody)
Message-Id: <200806040016.m540GAPo088805@www.freebsd.org>
Date: Wed, 4 Jun 2008 00:16:10 GMT
From: Serguei Michtchenko <sergueim@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Broken command in the handbook for configuring a wireless access point
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         124253
>Category:       docs
>Synopsis:       Broken command in the handbook for configuring a wireless access point
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       handbook
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jun 04 00:20:01 UTC 2008
>Closed-Date:    Sun Feb 24 23:48:45 UTC 2013
>Last-Modified:  Sun Feb 24 23:48:45 UTC 2013
>Originator:     Serguei Michtchenko
>Release:        7.0-RELEASE
>Organization:
>Environment:
FreeBSD basement.gateway.2wire.net 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 19:59:52 UTC 2008     root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386

>Description:
Section "29.3.5 FreeBSD Host Access Points/29.3.5.1 Basic Settings" of the handbook instructs to execute the following command:

# ifconfig ath0 ssid freebsdap mode 11g mediaopt hostap inet 192.168.0.1 netmask 255.255.255.0

and the result is:

ifconfig: inet: bad value

Not sure if this is just a fix for the handbook or a bug in ifconfig.

>How-To-Repeat:
Execute the following command:

# ifconfig ath0 ssid freebsdap mode 11g mediaopt hostap inet 192.168.0.1 netmask 255.255.255.0

the result is:

ifconfig: inet: bad value

>Fix:
Putting "inet ..." as the first parameter fixes the problem and produces desired behaviour:

# ifconfig ath0 inet 192.168.0.1 netmask 255.255.255.0 ssid freebsdap mode 11g mediaopt hostap


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Wed Jun 4 00:52:07 UTC 2008 
Responsible-Changed-Why:  
docs PR. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=124253 
Responsible-Changed-From-To: freebsd-doc->danger 
Responsible-Changed-By: danger 
Responsible-Changed-When: Sat Jun 21 11:56:41 UTC 2008 
Responsible-Changed-Why:  
Take 

http://www.freebsd.org/cgi/query-pr.cgi?pr=124253 
Responsible-Changed-From-To: danger->sam 
Responsible-Changed-By: sam 
Responsible-Changed-When: Tue Jul 1 21:06:17 UTC 2008 
Responsible-Changed-Why:  
the suggested ifconfig line should work; let me check the code 

http://www.freebsd.org/cgi/query-pr.cgi?pr=124253 
State-Changed-From-To: open->open 
State-Changed-By: linimon 
State-Changed-When: Sun Feb 24 22:58:48 UTC 2013 
State-Changed-Why:  
Sam has not been active in some time.  This is a very old PR and is 
probably no longer relevant. 


Responsible-Changed-From-To: sam->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Sun Feb 24 22:58:48 UTC 2013 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=124253 
State-Changed-From-To: open->analyzed 
State-Changed-By: keramida 
State-Changed-When: Sun Feb 24 23:41:28 UTC 2013 
State-Changed-Why:  


Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Sun Feb 24 23:41:28 UTC 2013 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=124253 
State-Changed-From-To: analyzed->closed 
State-Changed-By: keramida 
State-Changed-When: Sun Feb 24 23:48:22 UTC 2013 
State-Changed-Why:  
This used to be true, but it was fixed in svn rev 35578 
by blackend, when he committed this change, among other 
wlan improvements: 

-          <screen>&prompt.root; <userinput>ifconfig <replaceable>ath0</replaceable> up scan</userinput> 
+          <screen>&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> create wlandev <replaceable>ath0</replaceable></userin +&prompt.root; <userinput>ifconfig <replaceable>wlan0</replaceable> up scan</userinput> 

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