mac80211-injection.txt 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. How to use packet injection with mac80211
  2. =========================================
  3. mac80211 now allows arbitrary packets to be injected down any Monitor Mode
  4. interface from userland. The packet you inject needs to be composed in the
  5. following format:
  6. [ radiotap header ]
  7. [ ieee80211 header ]
  8. [ payload ]
  9. The radiotap format is discussed in
  10. ./Documentation/networking/radiotap-headers.txt.
  11. Despite many radiotap parameters being currently defined, most only make sense
  12. to appear on received packets. The following information is parsed from the
  13. radiotap headers and used to control injection:
  14. * IEEE80211_RADIOTAP_FLAGS
  15. IEEE80211_RADIOTAP_F_FCS: FCS will be removed and recalculated
  16. IEEE80211_RADIOTAP_F_WEP: frame will be encrypted if key available
  17. IEEE80211_RADIOTAP_F_FRAG: frame will be fragmented if longer than the
  18. current fragmentation threshold.
  19. The injection code can also skip all other currently defined radiotap fields
  20. facilitating replay of captured radiotap headers directly.
  21. Here is an example valid radiotap header defining some parameters
  22. 0x00, 0x00, // <-- radiotap version
  23. 0x0b, 0x00, // <- radiotap header length
  24. 0x04, 0x0c, 0x00, 0x00, // <-- bitmap
  25. 0x6c, // <-- rate
  26. 0x0c, //<-- tx power
  27. 0x01 //<-- antenna
  28. The ieee80211 header follows immediately afterwards, looking for example like
  29. this:
  30. 0x08, 0x01, 0x00, 0x00,
  31. 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF,
  32. 0x13, 0x22, 0x33, 0x44, 0x55, 0x66,
  33. 0x13, 0x22, 0x33, 0x44, 0x55, 0x66,
  34. 0x10, 0x86
  35. Then lastly there is the payload.
  36. After composing the packet contents, it is sent by send()-ing it to a logical
  37. mac80211 interface that is in Monitor mode. Libpcap can also be used,
  38. (which is easier than doing the work to bind the socket to the right
  39. interface), along the following lines:
  40. ppcap = pcap_open_live(szInterfaceName, 800, 1, 20, szErrbuf);
  41. ...
  42. r = pcap_inject(ppcap, u8aSendBuffer, nLength);
  43. You can also find a link to a complete inject application here:
  44. http://wireless.kernel.org/en/users/Documentation/packetspammer
  45. Andy Green <andy@warmcat.com>