MDK3(1)

💖 MDK3 — wireless attack tool for IEEE 802.11 networks 💖

okay bestie, welcome to mdk3(1) — yes that's the manual section number, yes I'm folding it in up here because we're not doing boring header lines in this house. this is a whole wireless attack tool for IEEE 802.11 networks and she is iconic and also lowkey a menace. let's get into it 🦋

---

✨ SYNOPSIS ✨

mdk3 <interface> <test_mode> [test_options]

that's it. that's the whole vibe. interface, mode, options. slay 💅

---

🌸 DESCRIPTION 🌸

MDK is a proof-of-concept tool to exploit common IEEE 802.11 protocol weaknesses. that's the entire description, no cap. it's a POC, she's a demo, she's not playing around. periodt.

---

👑 OPTIONS 👑

• --fullhelp — show all the test options. the whole buffet. no secrets here 💖
• --help <test_mode> — show test options just for <test_mode>. like a little one-on-one sesh with your fave mode ✨

🎀 TEST MODES 🎀

• b — Beacon Flood Mode

sends beacon frames to show fake APs at clients.

this can sometimes crash network scanners and even drivers! 💀 not a drill bestie

• a — Authentication DoS mode

sends authentication frames to all APs found in range.

too much clients can freeze or reset some APs 😭

• p — Basic probing and ESSID Bruteforce mode

probes AP and check for answer, useful for checking if SSID has been correctly decloaked or if AP is within your Wi-Fi interface's sending range.

SSID Bruteforcing is also possible with this test mode. the way she multitasks 🫶

• d — Deauthentication / Disassociation Amok Mode

kicks out everybody found from AP. everybody. amok. the name is not subtle and neither is she 💅

• m — Michael shutdown exploitation (TKIP)

cancels all traffic continuously. just. all of it. 🔥

• x — 802.1X tests.
• w — WIDS/WIPS Confusion.

confuse/abuse Intrusion Detection and Prevention Systems. gaslight gatekeep girlboss ✨

• f — MAC filter bruteforce mode

uses a list of known client MAC Addresses and tries to authenticate them to the given AP while dynamically changing its response timeout for best performance. it currently works only on APs who deny an open authentication request properly. picky queen 🎀

• g — WPA Downgrade test

deauthenticates Stations and APs sending WPA encrypted packets.

all the unencrypted and WEP networks will still work. so thoughtful of her 🌸

---

🌈 TEST MODES OPTIONS 🌈

b - Beacon Flood Mode 🐝

sends beacon frames to show fake APs at clients.

this can sometimes crash network scanners and even drivers! 💀

• -n <ssid> — use SSID <ssid> instead of randomly generated ones.
• -f <filename> — read SSIDs from file.
• -v <filename> — read MACs and SSIDs from file. see example file at /usr/share/doc/mdk3/fakeap-example.txt.
• -d — fake Ad-Hoc stations.
• -w — fake WEP encrypted stations.
• -g — fake 802.11b stations (54 Mbit/s).
• -t — fake WPA TKIP encrypted stations.
• -a — fake WPA AES encrypted stations.
• -m — use valid accesspoint MAC from OUI database.
• -h — hop to channel where AP is spoofed.

this makes the test more effective against some devices/drivers but it reduces packet rate due to channel hopping. tradeoffs, bestie 😭

• -c <chan> — fake an AP on channel <chan>. if you want your card to hop on this channel, you have to set -h option, too! don't forget her 🫶
• -s <pps> — set speed in packets per second (default: 50).

a - Authentication DoS mode 👑

sends authentication frames to all APs found in range.

too much clients can freeze or reset some APs 😭

• -a <ap_mac> — test only the specified AP <ap_mac>.
• -m — use a valid client MAC from OUI database.
• -c — do NOT check if the authentication succeeded.
• -i <ap_mac> — perform intelligent test on AP (-a and -c will be ignored).

this test connects clients to the AP and reinjects sniffed data to keep them alive. she's smart smart ✨

• -s <pps> — set speed in packets per second (default: unlimited).

p - Basic probing and ESSID Bruteforce mode 🦋

probes AP and check for answer, useful for checking if SSID has been correctly decloaked or if AP is within your Wi-Fi interface's sending range.

use -f and -t option to enable SSID Bruteforcing. iykyk 💅

• -e <ssid> — set the target SSID.
• -f <filename> — read SSIDs from file, useful to bruteforce hidden networks.
• -t <bssid> — set MAC address of target AP.
• -s <pps> — set speed (default: unlimited; in Bruteforce mode: 300).
• -b <character set> — use full Bruteforce mode (recommended for short SSIDs only!). short and sweet, bestie 🍓

d - Deauthentication / Disassociation Amok Mode 💀

kicks out everybody found from AP. everybody.

• -w <filename> — read file containing MACs not to care about (Whitelist Mode).
• -b <filename> — read file containing MACs to run tests on (Blacklist Mode).
• -s <pps> — set speed in packets per second (default: unlimited).
• -c [chan,chan,chan,...] — enable channel hopping.

without providing any channels, mdk3 will hop an all 14 b/g channels. channel will be changed every 5 seconds. she's got a schedule ⭐

m - Michael shutdown exploitation (TKIP) 🔥

cancels all traffic continuously.

• -t <bssid> — set MAC address of target AP.
• -w <seconds> — seconds between bursts (default: 10).
• -n <ppb> — set packets per burst (default: 70).
• -j — use the new TKIP QoS-Exploit.

needs just a few packets to shut AP down! efficiency queen 👑

• -s <pps> — set speed (default: 400).

x - 802.1X tests. 💜

0 - EAPOL Start packet flooding

• -n <ssid> — set the target SSID.
• -t <bssid> — set MAC address of target AP.
• -w <WPA type> — set WPA type (1: WPA, 2: WPA2/RSN; default: WPA).
• -u <unicast cipher> — set unicast cipher type (1: TKIP, 2: CCMP; default: TKIP).
• -m <multicast cipher> — set multicast cipher type (1: TKIP, 2: CCMP; default: TKIP).
• -s <pps> — set speed (default: 400).

1 - EAPOL Logoff test

• -t <bssid> — set MAC address of target AP.
• -c <bssid> — set MAC address of target STA.
• -s <pps> — set speed (default: 400).

w - WIDS/WIPS/WDS Confusion 🌈

confuses a WDS with multi-authenticated clients which messes up routing tables. chaos but make it technical ✨

• -e <SSID> — set SSID of target WDS network.
• -c [chan,chan,chan...] — use channel hopping.
• -z — activate Zero_Chaos' WIDS exploit (authenticates clients from a WDS to foreign APs to make WIDS go nuts). the name goes HARD and so does the exploit 💅

f - MAC filter bruteforce mode 🎀

uses a list of known client MAC Addresses and tries to authenticate them to the given AP while dynamically changing its response timeout for best performance.

it currently works only on APs who deny an open authentication request properly. standards, bestie 🙈

• -t <bssid> — set MAC address of target AP.
• -m <mac> — set the MAC address range to use (3 bytes, i.e. 00:12:34).

without -m, the internal database will be used. she comes prepared 🫶

• -f <mac> — set the MAC address to begin bruteforcing with (you can't use -f and -m at the same time). pick ONE. not both. choose your fighter 😭

g - WPA Downgrade test ⭐

deauthenticates Stations and APs sending WPA encrypted packets.

all the unencrypted and WEP networks will still work.

• -t <bssid> — set MAC address of target AP.

---

🎀 FILES 🎀

• /usr/share/doc/mdk3/common-ssids.txt.gz — common SSIDs.
• /usr/share/doc/mdk3/fakeap-example.txt — fake AP examples for the Beacon Flood Mode (b).
• /usr/share/doc/mdk3/less-common-ssids.txt.gz — not-so-common SSIDs.
• /usr/share/doc/mdk3/useful2.gz — extra SSIDs.

---

💖 AUTHOR 💖

MDK3 was developed by Pedro Larbig "ASPj" <pedrolarbig@compuserve.de>, with code taken from: aircrack-ng (by Christophe Devine) and kismet (by Mike Kershaw), all with contributions from various authors. giving credit where credit is due, we love to see it 🫶

this manual page was written by Samuel Henrique <samueloph@debian.org> for the Debian project, it was based on mdk3 --fullhelp output and can be used by other projects as well. iconic behavior, honestly 💅

---

🌸 SEE ALSO 🌸

• aircrack-ng(1)

---

okay bestie that's the whole page!! this is mdk3 version 6.0, dated August 2018 — a whole vintage era of wireless chaos. stay safe out there, only test on networks you're allowed to touch, and remember: knowledge is power, using it on someone else's AP is a crime 💀 mwah, go slay responsibly 🎀✨💖