From nobody@FreeBSD.org  Tue Feb 12 20:13:28 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 B118E16A46B
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 12 Feb 2008 20:13:28 +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 A32B813C468
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 12 Feb 2008 20:13:28 +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 m1CKBCQI030035
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 12 Feb 2008 20:11:12 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.2/8.14.1/Submit) id m1CKBCrc030034;
	Tue, 12 Feb 2008 20:11:12 GMT
	(envelope-from nobody)
Message-Id: <200802122011.m1CKBCrc030034@www.freebsd.org>
Date: Tue, 12 Feb 2008 20:11:12 GMT
From: Yuri <yuri@tsoft.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: ifconfig doesn't recognize 'inet' command when setting up wireless card
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         120566
>Category:       kern
>Synopsis:       [request]: ifconfig(8) make order of arguments more free then it is
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-net
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Feb 12 20:20:00 UTC 2008
>Closed-Date:    
>Last-Modified:  Fri Feb 15 13:15:00 UTC 2008
>Originator:     Yuri
>Release:        
>Organization:
n/a
>Environment:
FreeBSD xxx.xxx.xxx 7.0-PRERELEASE FreeBSD 7.0-PRERELEASE #2: Sat Feb  9 01:52:05 PST 2008     root@xxx.xxx.xxx:/usr/obj/usr/src/sys/GENERIC  i386

>Description:
I have Linksys PCI wireless card which recognizes as ral0 and works fine.

But when I follow instructions from
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-wireless.html
and trying to set up wireless access point many commands recommended in the
handbook fail, for example:

> ifconfig ral0 ssid freebsdap wepmode on weptxkey 3 wepkey 3:0x3456789012 mode 11g mediaopt hostap inet 192.168.0.1 netmask 255.255.255.0
> ifconfig: inet: bad value

This is not a show-stopper but a serious usability issue.
People who follow Handbook will fail miserably.

>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Wed Feb 13 20:00:29 UTC 2008 
Responsible-Changed-Why:  
vwe points out that this is more likely a documentation bug. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=120566 

From: Volker <volker@vwsoft.com>
To: bug-followup@FreeBSD.org, yuri@tsoft.com
Cc:  
Subject: Re: docs/120566: ifconfig(8) doesn't recognize 'inet' command when
 setting up wireless card
Date: Wed, 13 Feb 2008 21:56:11 +0100

 > vwe points out that this is more likely a documentation bug.
 
 To clarify this:
 
 > ifconfig ral0 ssid freebsdap wepmode on weptxkey 3 \
 >  wepkey 3:0x3456789012 mode 11g mediaopt hostap \
 >  inet 192.168.0.1 netmask 255.255.255.0
 > ifconfig: inet: bad value
 
 -> this fails but:
 
 ifconfig [ifname] [af] [a.dd.re.ss] (wlan settings here)
 
 works well:
 
 # ifconfig ndis0 inet 192.168.20.3/24 wepmode off mode 11g
 # ifconfig ndis0
 ndis0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu
 1500
 	ether 00:1a:73:ad:a4:67
 	inet 192.168.20.3 netmask 0xffffff00 broadcast 192.168.20.255
 	media: IEEE 802.11 Wireless Ethernet autoselect mode 11g (autoselect)
 	status: no carrier
 	ssid "" channel 1 (2412 Mhz 11g)
 	authmode OPEN privacy OFF bmiss 7 scanvalid 60 protmode CTS bintval 0
 
 Just give the keyword 'inet' and the IP address right after the
 interface name. man ifconfig(8) and ath(4) is fine.

From: Yuri <yuri@tsoft.com>
To: bug-followup@FreeBSD.org, yuri@tsoft.com
Cc:  
Subject: Re: docs/120566: ifconfig(8) doesn't recognize 'inet' command when
 setting up wireless card
Date: Wed, 13 Feb 2008 16:07:44 -0800

 Doesn't it make more sense to have a freedom in the order of keywords?
 Seems like logically for the most part order doesn't matter.
 Maybe 'ifconfig' should be fixed instead being more intelligent and 
 applying all supplied arguments no matter what order they are supplied?
 
Responsible-Changed-From-To: freebsd-doc->freebsd-net 
Responsible-Changed-By: remko 
Responsible-Changed-When: Fri Feb 15 13:12:56 UTC 2008 
Responsible-Changed-Why:  
Big axe: redirect this to -net, we might want to do something 
with the location of the variables (e.g. now you have to specify 
them in a prefixed form which is also documented, we might want 
to make sure that we dont have to be this explicit about the 
form). I'll make it a feature request as well. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=120566 
Class-Changed-From-To: sw-bug->change-request 
Class-Changed-By: remko 
Class-Changed-When: Fri Feb 15 13:14:08 UTC 2008 
Class-Changed-Why:  
this is actually a request to change documented behaviour 

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