head	1.3;
access;
symbols
	RELENG_8_4:1.3.0.2
	RELENG_9_1_0_RELEASE:1.1.16.1.4.2
	RELENG_9_1:1.1.16.1.0.4
	RELENG_9_1_BP:1.1.16.1
	RELENG_8_3_0_RELEASE:1.1.10.1.8.1
	RELENG_8_3:1.1.10.1.0.8
	RELENG_8_3_BP:1.1.10.1
	RELENG_9_0_0_RELEASE:1.1.16.1.2.1
	RELENG_9_0:1.1.16.1.0.2
	RELENG_9_0_BP:1.1.16.1
	RELENG_9:1.1.0.16
	RELENG_9_BP:1.1
	RELENG_7_4_0_RELEASE:1.1.14.1
	RELENG_8_2_0_RELEASE:1.1.10.1.6.1
	RELENG_7_4:1.1.0.14
	RELENG_7_4_BP:1.1
	RELENG_8_2:1.1.10.1.0.6
	RELENG_8_2_BP:1.1.10.1
	RELENG_8_1_0_RELEASE:1.1.10.1.4.1
	RELENG_8_1:1.1.10.1.0.4
	RELENG_8_1_BP:1.1.10.1
	RELENG_7_3_0_RELEASE:1.1.12.1
	RELENG_7_3:1.1.0.12
	RELENG_7_3_BP:1.1
	RELENG_8_0_0_RELEASE:1.1.10.1.2.1
	RELENG_8_0:1.1.10.1.0.2
	RELENG_8_0_BP:1.1.10.1
	RELENG_8:1.1.0.10
	RELENG_8_BP:1.1
	RELENG_7_2_0_RELEASE:1.1.8.1
	RELENG_7_2:1.1.0.8
	RELENG_7_2_BP:1.1
	RELENG_7_1_0_RELEASE:1.1.6.1
	RELENG_7_1:1.1.0.6
	RELENG_7_1_BP:1.1
	RELENG_7_0_0_RELEASE:1.1
	RELENG_7_0:1.1.0.4
	RELENG_7_0_BP:1.1
	RELENG_7:1.1.0.2
	RELENG_7_BP:1.1;
locks; strict;
comment	@# @;


1.3
date	2012.11.17.01.54.11;	author svnexp;	state Exp;
branches
	1.3.2.1;
next	1.2;

1.2
date	2011.12.30.00.04.11;	author uqs;	state Exp;
branches;
next	1.1;

1.1
date	2006.08.05.05.13.31;	author sam;	state Exp;
branches
	1.1.2.1
	1.1.6.1
	1.1.8.1
	1.1.10.1
	1.1.12.1
	1.1.14.1
	1.1.16.1;
next	;

1.3.2.1
date	2012.11.17.01.54.11;	author svnexp;	state dead;
branches;
next	1.3.2.2;

1.3.2.2
date	2013.03.28.13.05.59;	author svnexp;	state Exp;
branches;
next	;

1.1.2.1
date	2012.11.17.08.08.15;	author svnexp;	state Exp;
branches;
next	;

1.1.6.1
date	2008.11.25.02.59.29;	author kensmith;	state Exp;
branches;
next	;

1.1.8.1
date	2009.04.15.03.14.26;	author kensmith;	state Exp;
branches;
next	;

1.1.10.1
date	2009.08.03.08.13.06;	author kensmith;	state Exp;
branches
	1.1.10.1.2.1
	1.1.10.1.4.1
	1.1.10.1.6.1
	1.1.10.1.8.1;
next	1.1.10.2;

1.1.10.2
date	2012.11.17.10.37.14;	author svnexp;	state Exp;
branches;
next	;

1.1.10.1.2.1
date	2009.10.25.01.10.29;	author kensmith;	state Exp;
branches;
next	;

1.1.10.1.4.1
date	2010.06.14.02.09.06;	author kensmith;	state Exp;
branches;
next	;

1.1.10.1.6.1
date	2010.12.21.17.09.25;	author kensmith;	state Exp;
branches;
next	;

1.1.10.1.8.1
date	2012.03.03.06.15.13;	author kensmith;	state Exp;
branches;
next	1.1.10.1.8.2;

1.1.10.1.8.2
date	2012.11.17.08.25.48;	author svnexp;	state Exp;
branches;
next	;

1.1.12.1
date	2010.02.10.00.26.20;	author kensmith;	state Exp;
branches;
next	;

1.1.14.1
date	2010.12.21.17.10.29;	author kensmith;	state Exp;
branches;
next	1.1.14.2;

1.1.14.2
date	2012.11.17.08.17.40;	author svnexp;	state Exp;
branches;
next	;

1.1.16.1
date	2011.09.23.00.51.37;	author kensmith;	state Exp;
branches
	1.1.16.1.2.1
	1.1.16.1.4.1;
next	1.1.16.2;

1.1.16.2
date	2012.11.17.11.37.36;	author svnexp;	state Exp;
branches;
next	;

1.1.16.1.2.1
date	2011.11.11.04.20.22;	author kensmith;	state Exp;
branches;
next	1.1.16.1.2.2;

1.1.16.1.2.2
date	2012.11.17.08.37.32;	author svnexp;	state Exp;
branches;
next	;

1.1.16.1.4.1
date	2012.08.05.23.54.33;	author kensmith;	state Exp;
branches;
next	1.1.16.1.4.2;

1.1.16.1.4.2
date	2012.11.17.08.48.24;	author svnexp;	state Exp;
branches;
next	;


desc
@@


1.3
log
@Switching exporter and resync
@
text
@$FreeBSD: head/tools/tools/net80211/wlaninject/README 228975 2011-12-30 00:04:11Z uqs $

This tool generates raw 802.11 frames.  The resulting frame will
depend on the capabilities of the hardware.  Some hardware mangles
the 802.11 header [e.g. wi] other hardware does not [e.g. ath].
This tool does not deal with layers above 802.11.  A payload from
a file must be supplied if, for example, IP data needs to be sent.

Refer to the usage for a complete list of options.  Here, the most
relevant will be described.  There are three types of switches:

physical layer	Physical parameters for transmission
		[such as iface and chan].
802.11 header	Fields in the 802.11 header.
802.11 body	The payload of the 802.11 frame.  This includes
		management information elements.

Interesting physical layer options.
-----------------------------------
-i The network interface to use to TX; defaults to ath0.
-c The channel to TX on; defaults to 1.
-N Mark transmitted frames such that no ACK is expected. In practice,
   this will disable any retransmission done by the card.  This
   way, you are sure that a single copy of your packet will be TXed.
-V Verify that the packet you TXed did indeed fly in the air as
   expected.  This is done by sniffing on a second network interface
   and comparing the received frame to what was sent.  This option
   is especially useful because some cards mangle 802.11 header
   fields such as duration and fragment numbers.
-W The WME AC to use for transmission.  Symbolic names are used:
	ac_be, be	best effort
	ac_bk, bk	background
	ac_vi, vi	video
	ac_vo, vo	voice
-X The rate to use for transmission; defaults to 1Mbps.
-P The txpower to use; defaults to the maximum permitted by the driver.

Interesting 802.11 header options.
----------------------------------
-t The 802.11 frame type.  Symbolic names are:
	mgt	Management frame
	ctl	Control frame
	data	Data frame
   Otherwise the numerical type must be supplied.
-s The 802.11 frame subtype.  At this point, the length of the 802.11 header
   will be calculated.  Symbolic names are:
	preq, probereq	Probe Request
	auth		Authenticate
	areq, assocreq	Association Request
	data		Data
   Otherwise the numerical subtype must be supplied.
-4 The 4th MAC addr used for WDS.  Make sure you specify this before
   -s so the header length is calculated correctly.
-l Override the length of the packet.  This is useful for sending
   truncated packets.
-b Specify a file which will be used as a payload inside the 802.11
   frame.  The length should be calculated automatically correctly.

Interesting 802.11 payload options.
-----------------------------------
This is mainly used for management frames.  For data frames, -b
would typically be used.

-e Add an information element.  You can supply multiple -e options,
   but make sure you add them in the expected order.  The format
   of the information element is a list of 2 digit hex numbers.
   That is, 010203...  The first hexdigit is the type of the IE.
   Therefore, 00616161 should correspond to the SSID IE of 'aaa'.
   The length is calculated automatically---you do not need to
   supply it.
-S Add an SSID IE with the data specified in ascii; e.g. -S 'aaa'
   is the equivalent of -e 0061616161.
-R Add an IE of 11b supported rates.   

Examples:
---------

wlaninject -t data -s data -i ral0 -V ath0 -m -n 1 -f 1

Transmit a data frame on ral0 and verify the transmission on ath0.
The frame is sent with sequence number 1, fragment number 1, and
the MoreFrag bit marked in the 802.11 header.
@


1.3.2.1
log
@file README was added on branch RELENG_8_4 on 2013-03-28 13:05:59 +0000
@
text
@d1 82
@


1.3.2.2
log
@## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/248810
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
@
text
@a0 82
$FreeBSD: releng/8.4/tools/tools/net80211/wlaninject/README 160995 2006-08-05 05:13:31Z sam $

This tool generates raw 802.11 frames.  The resulting frame will
depend on the capabilities of the hardware.  Some hardware mangles
the 802.11 header [e.g. wi] other hardware does not [e.g. ath].
This tool does not deal with layers above 802.11.  A payload from
a file must be supplied if, for example, IP data needs to be sent.

Refer to the usage for a complete list of options.  Here, the most
relevant will be described.  There are three types of switches:

physical layer	Physical parameters for transmission
		[such as iface and chan].
802.11 header	Fields in the 802.11 header.
802.11 body	The payload of the 802.11 frame.  This includes
		management information elements.

Interesting physical layer options.
-----------------------------------
-i The network interface to use to TX; defaults to ath0.
-c The channel to TX on; defaults to 1.
-N Mark transmitted frames such that no ACK is expected. In practice,
   this will disable any retransmission done by the card.  This
   way, you are sure that a single copy of your packet will be TXed.
-V Verify that the packet you TXed did indeed fly in the air as
   expected.  This is done by sniffing on a second network interface
   and comparing the received frame to what was sent.  This option
   is especially useful because some cards mangle 802.11 header
   fields such as duration and fragment numbers.
-W The WME AC to use for transmission.  Symbolic names are used:
	ac_be, be	best effort
	ac_bk, bk	background
	ac_vi, vi	video
	ac_vo, vo	voice
-X The rate to use for transmission; defaults to 1Mbps.
-P The txpower to use; defaults to the maximum permitted by the driver.

Interesting 802.11 header options.
----------------------------------
-t The 802.11 frame type.  Symbolic names are:
	mgt	Management frame
	ctl	Control frame
	data	Data frame
   Otherwise the numerical type must be supplied.
-s The 802.11 frame subtype.  At this point, the length of the 802.11 header
   will be calculated.  Symbolic names are:
	preq, probereq	Probe Request
	auth		Authenticate
	areq, assocreq	Assocation Request
	data		Data
   Otherwise the numerical subtype must be supplied.
-4 The 4th MAC addr used for WDS.  Make sure you specify this before
   -s so the header length is calculated correctly.
-l Override the length of the packet.  This is useful for sending
   truncated packets.
-b Specify a file which will be used as a payload inside the 802.11
   frame.  The length should be calculated automatically correctly.

Interesting 802.11 payload options.
-----------------------------------
This is mainly used for management frames.  For data frames, -b
would typically be used.

-e Add an information element.  You can supply multiple -e options,
   but make sure you add them in the expected order.  The format
   of the information element is a list of 2 digit hex numbers.
   That is, 010203...  The first hexdigit is the type of the IE.
   Therefore, 00616161 should correspond to the SSID IE of 'aaa'.
   The length is calculated automatically---you do not need to
   supply it.
-S Add an SSID IE with the data specified in ascii; e.g. -S 'aaa'
   is the equivalent of -e 0061616161.
-R Add an IE of 11b supported rates.   

Examples:
---------

wlaninject -t data -s data -i ral0 -V ath0 -m -n 1 -f 1

Transmit a data frame on ral0 and verify the transmission on ath0.
The frame is sent with sequence number 1, fragment number 1, and
the MoreFrag bit marked in the 802.11 header.
@


1.2
log
@SVN rev 228975 on 2011-12-30 00:04:11Z by uqs

Spelling fixes for tools/

Add some $FreeBSD$ tags so svn will allow the commit.
@
text
@d1 1
a1 1
$FreeBSD$
@


1.1
log
@802.11 packet injection test tool

Submitted by:	Andrea Bittau <a.bittau@@cs.ucl.ac.uk>
@
text
@d49 1
a49 1
	areq, assocreq	Assocation Request
@


1.1.2.1
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: stable/7/tools/tools/net80211/wlaninject/README 160995 2006-08-05 05:13:31Z sam $
@


1.1.16.1
log
@SVN rev 225736 on 2011-09-23 00:51:37Z by kensmith

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by:	re (implicit)
@
text
@@


1.1.16.2
log
@## SVN ##
## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/ 242902
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ## r242902 | dteske | 2012-11-11 23:29:45 +0000 (Sun, 11 Nov 2012) | 10 lines
## SVN ##
## SVN ## Fix a regression introduced by SVN r211417 that saw the breakage of a feature
## SVN ## documented in usr.sbin/sysinstall/help/shortcuts.hlp (reproduced below):
## SVN ##
## SVN ## If /usr/sbin/sysinstall is linked to another filename, say
## SVN ## `/usr/local/bin/configPackages', then the basename will be used
## SVN ## as an implicit command name.
## SVN ##
## SVN ## Reviewed by:	adrian (co-mentor)
## SVN ## Approved by:	adrian (co-mentor)
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ##
@
text
@d1 1
a1 1
$FreeBSD: stable/9/tools/tools/net80211/wlaninject/README 160995 2006-08-05 05:13:31Z sam $
@


1.1.16.1.4.1
log
@SVN rev 239080 on 2012-08-05 23:54:33Z by kensmith

Copy stable/9 to releng/9.1 as part of the 9.1-RELEASE release process.

Approved by:	re (implicit)
@
text
@@


1.1.16.1.4.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/9.1/tools/tools/net80211/wlaninject/README 160995 2006-08-05 05:13:31Z sam $
@


1.1.16.1.2.1
log
@SVN rev 227445 on 2011-11-11 04:20:22Z by kensmith

Copy stable/9 to releng/9.0 as part of the FreeBSD 9.0-RELEASE release
cycle.

Approved by:	re (implicit)
@
text
@@


1.1.16.1.2.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/9.0/tools/tools/net80211/wlaninject/README 160995 2006-08-05 05:13:31Z sam $
@


1.1.14.1
log
@SVN rev 216618 on 2010-12-21 17:10:29Z by kensmith

Copy stable/7 to releng/7.4 in preparation for FreeBSD-7.4 release.

Approved by:	re (implicit)
@
text
@@


1.1.14.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/7.4/tools/tools/net80211/wlaninject/README 160995 2006-08-05 05:13:31Z sam $
@


1.1.12.1
log
@SVN rev 203736 on 2010-02-10 00:26:20Z by kensmith

Copy stable/7 to releng/7.3 as part of the 7.3-RELEASE process.

Approved by:	re (implicit)
@
text
@@


1.1.10.1
log
@SVN rev 196045 on 2009-08-03 08:13:06Z by kensmith

Copy head to stable/8 as part of 8.0 Release cycle.

Approved by:	re (Implicit)
@
text
@@


1.1.10.2
log
@## SVN ##
## SVN ## Exported commit - http://svnweb.freebsd.org/changeset/base/ 242909
## SVN ## CVS IS DEPRECATED: http://wiki.freebsd.org/CvsIsDeprecated
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ## r242909 | dim | 2012-11-12 07:47:19 +0000 (Mon, 12 Nov 2012) | 20 lines
## SVN ##
## SVN ## MFC r242625:
## SVN ##
## SVN ## Remove duplicate const specifiers in many drivers (I hope I got all of
## SVN ## them, please let me know if not).  Most of these are of the form:
## SVN ##
## SVN ## static const struct bzzt_type {
## SVN ##       [...list of members...]
## SVN ## } const bzzt_devs[] = {
## SVN ##       [...list of initializers...]
## SVN ## };
## SVN ##
## SVN ## The second const is unnecessary, as arrays cannot be modified anyway,
## SVN ## and if the elements are const, the whole thing is const automatically
## SVN ## (e.g. it is placed in .rodata).
## SVN ##
## SVN ## I have verified this does not change the binary output of a full kernel
## SVN ## build (except for build timestamps embedded in the object files).
## SVN ##
## SVN ## Reviewed by:	yongari, marius
## SVN ##
## SVN ## ------------------------------------------------------------------------
## SVN ##
@
text
@d1 1
a1 1
$FreeBSD: stable/8/tools/tools/net80211/wlaninject/README 160995 2006-08-05 05:13:31Z sam $
@


1.1.10.1.8.1
log
@SVN rev 232438 on 2012-03-03 06:15:13Z by kensmith

Copy stable/8 to releng/8.3 as part of 8.3-RELEASE release cycle.

Approved by:	re (implicit)
@
text
@@


1.1.10.1.8.2
log
@Switch importer
@
text
@d1 1
a1 1
$FreeBSD: releng/8.3/tools/tools/net80211/wlaninject/README 160995 2006-08-05 05:13:31Z sam $
@


1.1.10.1.6.1
log
@SVN rev 216617 on 2010-12-21 17:09:25Z by kensmith

Copy stable/8 to releng/8.2 in preparation for FreeBSD-8.2 release.

Approved by:	re (implicit)
@
text
@@


1.1.10.1.4.1
log
@SVN rev 209145 on 2010-06-14 02:09:06Z by kensmith

Copy stable/8 to releng/8.1 in preparation for 8.1-RC1.

Approved by:	re (implicit)
@
text
@@


1.1.10.1.2.1
log
@SVN rev 198460 on 2009-10-25 01:10:29Z by kensmith

Copy stable/8 to releng/8.0 as part of 8.0-RELEASE release procedure.

Approved by:	re (implicit)
@
text
@@


1.1.8.1
log
@SVN rev 191087 on 2009-04-15 03:14:26Z by kensmith

Create releng/7.2 from stable/7 in preparation for 7.2-RELEASE.

Approved by:	re (implicit)
@
text
@@


1.1.6.1
log
@SVN rev 185281 on 2008-11-25 02:59:29Z by kensmith

Create releng/7.1 in preparation for moving into RC phase of 7.1 release
cycle.

Approved by:	re (implicit)
@
text
@@

