forked from Minki/linux
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: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: David S. Miller <davem@davemloft.net>
This commit is contained in:
Mauro Carvalho Chehab
David S. Miller
parent
a6b93e6555
commit
429ff87bca
@ -77,6 +77,7 @@ Contents:
|
||||
l2tp
|
||||
lapb-module
|
||||
ltpc
|
||||
mac80211-injection
|
||||
|
||||
.. only:: subproject and html
|
||||
|
||||
|
||||
@ -1,9 +1,12 @@
|
||||
.. SPDX-License-Identifier: GPL-2.0
|
||||
|
||||
=========================================
|
||||
How to use packet injection with mac80211
|
||||
=========================================
|
||||
|
||||
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
|
||||
following format:
|
||||
following format::
|
||||
|
||||
[ radiotap header ]
|
||||
[ ieee80211 header ]
|
||||
@ -18,15 +21,19 @@ radiotap headers and used to control injection:
|
||||
|
||||
* 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_FRAG: frame will be fragmented if longer than the
|
||||
========================= ===========================================
|
||||
IEEE80211_RADIOTAP_F_FCS FCS will be removed and recalculated
|
||||
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.
|
||||
========================= ===========================================
|
||||
|
||||
* 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
|
||||
============================= ========================================
|
||||
|
||||
* 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).
|
||||
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
|
||||
|
||||
@ -51,17 +60,17 @@ radiotap headers and used to control injection:
|
||||
without own rate control). Also other fields are parsed
|
||||
|
||||
flags field
|
||||
IEEE80211_RADIOTAP_VHT_FLAG_SGI: use short guard interval
|
||||
IEEE80211_RADIOTAP_VHT_FLAG_SGI: use short guard interval
|
||||
|
||||
bandwidth field
|
||||
1: send using 40MHz channel width
|
||||
4: send using 80MHz channel width
|
||||
11: send using 160MHz channel width
|
||||
* 1: send using 40MHz channel width
|
||||
* 4: send using 80MHz channel width
|
||||
* 11: send using 160MHz channel width
|
||||
|
||||
The injection code can also skip all other currently defined radiotap fields
|
||||
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
|
||||
0x0b, 0x00, // <- radiotap header length
|
||||
@ -71,7 +80,7 @@ Here is an example valid radiotap header defining some parameters
|
||||
0x01 //<-- antenna
|
||||
|
||||
The ieee80211 header follows immediately afterwards, looking for example like
|
||||
this:
|
||||
this::
|
||||
|
||||
0x08, 0x01, 0x00, 0x00,
|
||||
0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
|
||||
@ -84,10 +93,10 @@ Then lastly there is the payload.
|
||||
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,
|
||||
(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);
|
||||
...
|
||||
...
|
||||
r = pcap_inject(ppcap, u8aSendBuffer, nLength);
|
||||
|
||||
You can also find a link to a complete inject application here:
|
||||
@ -10079,7 +10079,7 @@ S: Maintained
|
||||
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-next.git
|
||||
F: Documentation/networking/mac80211-injection.txt
|
||||
F: Documentation/networking/mac80211-injection.rst
|
||||
F: Documentation/networking/mac80211_hwsim/mac80211_hwsim.rst
|
||||
F: drivers/net/wireless/mac80211_hwsim.[ch]
|
||||
F: include/net/mac80211.h
|
||||
|
||||
@ -2144,7 +2144,7 @@ static bool ieee80211_parse_tx_radiotap(struct ieee80211_local *local,
|
||||
|
||||
/*
|
||||
* Please update the file
|
||||
* Documentation/networking/mac80211-injection.txt
|
||||
* Documentation/networking/mac80211-injection.rst
|
||||
* when parsing new fields here.
|
||||
*/
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user