Commit 429ff87b authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by David S. Miller
Browse files

docs: networking: convert mac80211-injection.txt to ReST 



- add SPDX header;
- adjust title markup;
- mark code blocks and literals as such;
- mark tables as such;
- adjust identation, whitespaces and blank lines;
- add to networking/index.rst.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent a6b93e65

Documentation/networking/index.rst

+1 −0
Original line number Original line Diff line number Diff line
@@ -77,6 +77,7 @@ Contents: 
   l2tp

   l2tp

   lapb-module

   lapb-module

   ltpc

   ltpc

   mac80211-injection





.. only::  subproject and html

.. only::  subproject and html

Documentation/networking/mac80211-injection.txt→Documentation/networking/mac80211-injection.rst

+24 −15
Original line number Original line Diff line number Diff line 
.. SPDX-License-Identifier: GPL-2.0



=========================================

How to use packet injection with mac80211

How to use packet injection with mac80211

=========================================

=========================================





mac80211 now allows arbitrary packets to be injected down any Monitor Mode

mac80211 now allows arbitrary packets to be injected down any Monitor Mode

interface from userland.  The packet you inject needs to be composed in the

interface from userland.  The packet you inject needs to be composed in the

following format:

following format::





 [ radiotap header  ]

 [ radiotap header  ]

 [ ieee80211 header ]

 [ ieee80211 header ]
@@ -18,15 +21,19 @@ radiotap headers and used to control injection: 




 * IEEE80211_RADIOTAP_FLAGS

 * IEEE80211_RADIOTAP_FLAGS





   IEEE80211_RADIOTAP_F_FCS: FCS will be removed and recalculated

   =========================  ===========================================

   IEEE80211_RADIOTAP_F_WEP: frame will be encrypted if key available

   IEEE80211_RADIOTAP_F_FCS   FCS will be removed and recalculated

   IEEE80211_RADIOTAP_F_FRAG: frame will be fragmented if longer than the

   IEEE80211_RADIOTAP_F_WEP   frame will be encrypted if key available

   IEEE80211_RADIOTAP_F_FRAG  frame will be fragmented if longer than the

			      current fragmentation threshold.

			      current fragmentation threshold.

   =========================  ===========================================





 * IEEE80211_RADIOTAP_TX_FLAGS

 * IEEE80211_RADIOTAP_TX_FLAGS





   IEEE80211_RADIOTAP_F_TX_NOACK: frame should be sent without waiting for

   =============================  ========================================

   IEEE80211_RADIOTAP_F_TX_NOACK  frame should be sent without waiting for

				  an ACK even if it is a unicast frame

				  an ACK even if it is a unicast frame

   =============================  ========================================





 * IEEE80211_RADIOTAP_RATE

 * IEEE80211_RADIOTAP_RATE
@@ -37,8 +44,10 @@ radiotap headers and used to control injection: 
   HT rate for the transmission (only for devices without own rate control).

   HT rate for the transmission (only for devices without own rate control).

   Also some flags are parsed

   Also some flags are parsed





   IEEE80211_RADIOTAP_MCS_SGI: use short guard interval

   ============================  ========================

   IEEE80211_RADIOTAP_MCS_BW_40: send in HT40 mode

   IEEE80211_RADIOTAP_MCS_SGI    use short guard interval

   IEEE80211_RADIOTAP_MCS_BW_40  send in HT40 mode

   ============================  ========================





 * IEEE80211_RADIOTAP_DATA_RETRIES

 * IEEE80211_RADIOTAP_DATA_RETRIES
@@ -54,14 +63,14 @@ radiotap headers and used to control injection: 
	IEEE80211_RADIOTAP_VHT_FLAG_SGI: use short guard interval

	IEEE80211_RADIOTAP_VHT_FLAG_SGI: use short guard interval





   bandwidth field

   bandwidth field

   1: send using 40MHz channel width

	* 1: send using 40MHz channel width

   4: send using 80MHz channel width

	* 4: send using 80MHz channel width

   11: send using 160MHz channel width

	* 11: send using 160MHz channel width





The injection code can also skip all other currently defined radiotap fields

The injection code can also skip all other currently defined radiotap fields

facilitating replay of captured radiotap headers directly.

facilitating replay of captured radiotap headers directly.





Here is an example valid radiotap header defining some parameters

Here is an example valid radiotap header defining some parameters::





	0x00, 0x00, // <-- radiotap version

	0x00, 0x00, // <-- radiotap version

	0x0b, 0x00, // <- radiotap header length

	0x0b, 0x00, // <- radiotap header length
@@ -71,7 +80,7 @@ Here is an example valid radiotap header defining some parameters 
	0x01 //<-- antenna

	0x01 //<-- antenna





The ieee80211 header follows immediately afterwards, looking for example like

The ieee80211 header follows immediately afterwards, looking for example like

this:

this::





	0x08, 0x01, 0x00, 0x00,

	0x08, 0x01, 0x00, 0x00,

	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,

	0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
@@ -84,7 +93,7 @@ Then lastly there is the payload. 
After composing the packet contents, it is sent by send()-ing it to a logical

After composing the packet contents, it is sent by send()-ing it to a logical

mac80211 interface that is in Monitor mode.  Libpcap can also be used,

mac80211 interface that is in Monitor mode.  Libpcap can also be used,

(which is easier than doing the work to bind the socket to the right

(which is easier than doing the work to bind the socket to the right

interface), along the following lines:

interface), along the following lines:::





	ppcap = pcap_open_live(szInterfaceName, 800, 1, 20, szErrbuf);

	ppcap = pcap_open_live(szInterfaceName, 800, 1, 20, szErrbuf);

	...

	...

MAINTAINERS

+1 −1
Original line number Original line Diff line number Diff line
@@ -10079,7 +10079,7 @@ S: Maintained 
W:	https://wireless.wiki.kernel.org/

W:	https://wireless.wiki.kernel.org/

T:	git git://git.kernel.org/pub/scm/linux/kernel/git/jberg/mac80211.git

T:	git git://git.kernel.org/pub/scm/linux/kernel/git/jberg/mac80211.git

T:	git git://git.kernel.org/pub/scm/linux/kernel/git/jberg/mac80211-next.git

T:	git git://git.kernel.org/pub/scm/linux/kernel/git/jberg/mac80211-next.git

F:	Documentation/networking/mac80211-injection.txt

F:	Documentation/networking/mac80211-injection.rst

F:	Documentation/networking/mac80211_hwsim/mac80211_hwsim.rst

F:	Documentation/networking/mac80211_hwsim/mac80211_hwsim.rst

F:	drivers/net/wireless/mac80211_hwsim.[ch]

F:	drivers/net/wireless/mac80211_hwsim.[ch]

F:	include/net/mac80211.h

F:	include/net/mac80211.h

net/mac80211/tx.c

+1 −1
Original line number Original line Diff line number Diff line
@@ -2144,7 +2144,7 @@ static bool ieee80211_parse_tx_radiotap(struct ieee80211_local *local, 




		/*

		/*

		 * Please update the file

		 * Please update the file

		 * Documentation/networking/mac80211-injection.txt

		 * Documentation/networking/mac80211-injection.rst

		 * when parsing new fields here.

		 * when parsing new fields here.

		 */

		 */