From nobody@FreeBSD.org  Thu Nov  4 21:21:39 2010
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 AD7251065670
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  4 Nov 2010 21:21:39 +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 9BE558FC12
	for <freebsd-gnats-submit@FreeBSD.org>; Thu,  4 Nov 2010 21:21: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 oA4LLd7L032537
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 4 Nov 2010 21:21:39 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id oA4LLdlI032536;
	Thu, 4 Nov 2010 21:21:39 GMT
	(envelope-from nobody)
Message-Id: <201011042121.oA4LLdlI032536@www.freebsd.org>
Date: Thu, 4 Nov 2010 21:21:39 GMT
From: Jared <rhyous@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: No example for scanning for SSIDs in ifconfig(8) man page
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         151952
>Category:       docs
>Synopsis:       No example for scanning for SSIDs in ifconfig(8) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    gjb
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 04 21:30:08 UTC 2010
>Closed-Date:    Sat Mar 19 00:37:33 UTC 2011
>Last-Modified:  Sat Mar 19 00:40:09 UTC 2011
>Originator:     Jared
>Release:        FreeBSD 8.1
>Organization:
Rhyous.com
>Environment:
FreeBSD slc-jab.ld.landesk.com 8.1-RELEASE-p1 FreeBSD 8.1-RELEASE-p1 #8: Tue Oct 19 00:11:06 MDT 2010     jared@slc-jab.ld.landesk.com:/usr/obj/usr/src/sys/KRNL0  amd64

>Description:
I couldn't remember off the top of my head how to scan for wireless access points.

I look at the ifconfig man page and while the scan option existed, using it wasn't obvious.


The man page wasn't very helpful for something that is very needed for a laptop these days.
>How-To-Repeat:
n/a
>Fix:
Add another example to the ifconfig(8) examples section:

Scan for Wireless Access Points and display the SSID, BSSID, Channel, Rate, etc...
    ifconfig wlan0 scan


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: gjb 
State-Changed-When: Sat Mar 12 19:07:56 UTC 2011 
State-Changed-Why:  
Patched in HEAD.  MFC in 1 week. 



Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Sat Mar 12 19:07:56 UTC 2011 
Responsible-Changed-Why:  
I'll take this. 


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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/151952: commit references a PR
Date: Sat, 12 Mar 2011 19:05:49 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Sat Mar 12 19:05:39 2011
 New Revision: 219574
 URL: http://svn.freebsd.org/changeset/base/219574
 
 Log:
   Add example of using 'scan' for wireless networks, similarly to
   OpenBSD's ifconfig(8).
   
   PR:		151952
   Submitted by:	Jared (rhyous of yahoo com)
   MFC after:	1 week
 
 Modified:
   head/sbin/ifconfig/ifconfig.8
 
 Modified: head/sbin/ifconfig/ifconfig.8
 ==============================================================================
 --- head/sbin/ifconfig/ifconfig.8	Sat Mar 12 17:05:18 2011	(r219573)
 +++ head/sbin/ifconfig/ifconfig.8	Sat Mar 12 19:05:39 2011	(r219574)
 @@ -2537,6 +2537,10 @@ Create the software network interface
  Destroy the software network interface
  .Li gif1 :
  .Dl # ifconfig gif1 destroy
 +.Pp
 +Scan for wireless networks using
 +.Li wlan0 :
 +.Dl # ifconfig wlan0 scan
  .Sh DIAGNOSTICS
  Messages indicating the specified interface does not exist, the
  requested address is unknown, or the user is not privileged and
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: gjb 
State-Changed-When: Sat Mar 19 00:37:15 UTC 2011 
State-Changed-Why:  
Patched in stable/8 and stable/7.  Thanks! 


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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/151952: commit references a PR
Date: Sat, 19 Mar 2011 00:34:27 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Sat Mar 19 00:34:12 2011
 New Revision: 219765
 URL: http://svn.freebsd.org/changeset/base/219765
 
 Log:
   MFC 219574,219575:
   - Add example of using 'scan' for wireless networks, similarly to
     OpenBSD's ifconfig(8)[1].
   - remove unneeded newline
   
   PR:		151952 [1]
 
 Modified:
   stable/8/sbin/ifconfig/ifconfig.8
 Directory Properties:
   stable/8/sbin/ifconfig/   (props changed)
 
 Modified: stable/8/sbin/ifconfig/ifconfig.8
 ==============================================================================
 --- stable/8/sbin/ifconfig/ifconfig.8	Sat Mar 19 00:31:35 2011	(r219764)
 +++ stable/8/sbin/ifconfig/ifconfig.8	Sat Mar 19 00:34:12 2011	(r219765)
 @@ -2508,7 +2508,6 @@ to use 100baseTX, full duplex Ethernet m
  .Dl # ifconfig xl0 media 100baseTX mediaopt full-duplex
  .Pp
  Label the em0 interface as an uplink:
 -.Pp
  .Dl # ifconfig em0 description \&"Uplink to Gigabit Switch 2\&"
  .Pp
  Create the software network interface
 @@ -2518,6 +2517,10 @@ Create the software network interface
  Destroy the software network interface
  .Li gif1 :
  .Dl # ifconfig gif1 destroy
 +.Pp
 +Scan for wireless networks using
 +.Li wlan0 :
 +.Dl # ifconfig wlan0 scan
  .Sh DIAGNOSTICS
  Messages indicating the specified interface does not exist, the
  requested address is unknown, or the user is not privileged and
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/151952: commit references a PR
Date: Sat, 19 Mar 2011 00:35:21 +0000 (UTC)

 Author: gjb (doc committer)
 Date: Sat Mar 19 00:35:11 2011
 New Revision: 219766
 URL: http://svn.freebsd.org/changeset/base/219766
 
 Log:
   MFC 219574:
   - Add example of using 'scan' for wireless networks, similarly to
     OpenBSD's ifconfig(8).
   - wlan0 isn't available on 7.x, so substitute ath0 for wlan0 in the
     example.
   
   PR:		151952
 
 Modified:
   stable/7/sbin/ifconfig/ifconfig.8
 Directory Properties:
   stable/7/sbin/ifconfig/   (props changed)
 
 Modified: stable/7/sbin/ifconfig/ifconfig.8
 ==============================================================================
 --- stable/7/sbin/ifconfig/ifconfig.8	Sat Mar 19 00:34:12 2011	(r219765)
 +++ stable/7/sbin/ifconfig/ifconfig.8	Sat Mar 19 00:35:11 2011	(r219766)
 @@ -1946,6 +1946,10 @@ Create the software network interface
  Destroy the software network interface
  .Li gif1 :
  .Dl # ifconfig gif1 destroy
 +.Pp
 +Scan for wireless networks using
 +.Li ath0 :
 +.Dl # ifconfig ath0 scan
  .Sh DIAGNOSTICS
  Messages indicating the specified interface does not exist, the
  requested address is unknown, or the user is not privileged and
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
