conf/124253: Broken command in the handbook for configuring a wireless access point

[Serguei Michtchenko]

>Number:         124253
>Category:       conf
>Synopsis:       Broken command in the handbook for configuring a wireless access point
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jun 04 00:20:01 UTC 2008
>Closed-Date:
>Last-Modified:
>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 at 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:
>Unformatted: