aircrack-ng - a 802.11 WEP / WPA-PSK key cracker
[options] <input file(s)>
is an 802.11 WEP and WPA/WPA2-PSK key cracking program.
It can recover the WEP key once enough encrypted packets have been captured with
airodump-ng. This part of the aircrack-ng suite determines the WEP key using
two fundamental methods. The first method is via the PTW approach (Pyshkin,
Tews, Weinmann). The main advantage of the PTW approach is that very few data
packets are required to crack the WEP key. The second method is the FMS/KoreK
method. The FMS/KoreK method incorporates various statistical attacks to
discover the WEP key and uses these in combination with brute forcing.
Additionally, the program offers a dictionary method for determining the WEP
key. For cracking WPA/WPA2 pre-shared keys, a wordlist (file or stdin) or an
airolib-ng has to be used.
- Capture files (.cap, .pcap), IVS (.ivs) or Hascat HCCAPX
- Common options:
- -a <amode>
- Force the attack mode, 1 or wep for WEP and 2 or wpa for
- -e <essid>
- Select the target network based on the ESSID. This option
is also required for WPA cracking if the SSID is cloaked. For SSID
containing special characters, see
- -b <bssid> or --bssid <bssid>
- Select the target network based on the access point MAC
- -p <nbcpu>
- Set this option to the number of CPUs to use (only
available on SMP systems). By default, it uses all available CPUs
- If set, no status information is displayed.
- -C <macs> or --combine <macs>
- Merges all those APs MAC (separated by a comma) into a
- -l <file>
- Write the key into a file. Overwrites the file if it
- Static WEP cracking options:
- Search alpha-numeric characters only.
- Search binary coded decimal characters only.
- Search the numeric key for Fritz!BOX
- -d <mask> or --debug <mask>
- Specify mask of the key. For example: A1:XX:CF
- -m <maddr>
- Only keep the IVs coming from packets that match this MAC
address. Alternatively, use -m ff:ff:ff:ff:ff:ff to use all and every IVs,
regardless of the network (this disables ESSID and BSSID filtering).
- -n <nbits>
- Specify the length of the key: 64 for 40-bit WEP, 128 for
104-bit WEP, etc., until 512 bits of length. The default value is
- -i <index>
- Only keep the IVs that have this key index (1 to 4). The
default behavior is to ignore the key index in the packet, and use the IV
- -f <fudge>
- By default, this parameter is set to 2. Use a higher value
to increase the bruteforce level: cracking will take more time, but with a
higher likelihood of success.
- -k <korek>
- There are 17 KoreK attacks. Sometimes one attack creates a
huge false positive that prevents the key from being found, even with lots
of IVs. Try -k 1, -k 2, ... -k 17 to disable each attack selectively.
- -x or -x0
- Disable last keybytes bruteforce (not advised).
- Enable last keybyte bruteforcing (default)
- Enable last two keybytes bruteforcing.
- Disable bruteforce multithreading (SMP only).
- Shows ASCII version of the key at the right of the
- This is an experimental single brute-force attack which
should only be used when the standard attack mode fails with more than one
- Uses PTW (Andrei Pyshkin, Erik Tews and Ralf-Philipp
Weinmann) attack (default attack).
- -P <num> or --ptw-debug <num>
- PTW debug: 1 Disable klein, 2 PTW.
- Use KoreK attacks instead of PTW.
- -D or --wep-decloak
- WEP decloak mode.
- -1 or --oneshot
- Run only 1 try to crack key with PTW.
- -M <num>
- Specify maximum number of IVs to use.
- WEP and WPA-PSK cracking options
- -w <words>
- Path to a dictionary file for wpa cracking. Separate
filenames with comma when using multiple dictionaries. Specify
"-" to use stdin. Here is a list of wordlists:
In order to use a dictionary with hexadecimal values, prefix the
dictionary with "h:". Each byte in each key must be separated by
':'. When using with WEP, key length should be specified using -n.
- -N <file> or --new-session <file>
- Create a new cracking session. It allows to interrupt
cracking session and restart at a later time (using -R or
--restore-session). Status files are saved every 5 minutes. It does not
overwrite existing session file.
- -R <file> or --restore-session
- Restore and continue a previously saved cracking session.
This parameter is to be used alone, no other parameter should be specified
when starting aircrack-ng (all the required information is in the session
- WPA-PSK options:
- -E <file>
- Create Elcomsoft Wireless Security Auditor (EWSA) Project
- -j <file>
- Create Hashcat v3.6+ Capture file (HCCAPX).
- -J <file>
- Create Hashcat Capture file (HCCAP).
- WPA cracking speed test.
- -Z <sec>
- WPA cracking speed test execution length in seconds.
- -r <database>
- Path to the airolib-ng database. Cannot be used with
- SIMD selection:
- Aircrack-ng automatically loads and uses the fastest
optimization based on instructions available for your CPU. This options
allows to force another optimization. Choices depend on the CPU and the
following are all the possibilities that may be compiled regardless of the
CPU type: generic, sse2, avx, avx2, avx512, neon, asimd, altivec,
- Shows a list of the available SIMD architectures, for this
machine, separated by a space character.
- Other options:
- -H or --help
- Show help screen
- -u or --cpu-detect
- Provide information on the number of CPUs and MMX/SSE
This manual page was written by Adam Cecile <email@example.com> for the
Debian system (but may be used by others). Permission is granted to copy,
distribute and/or modify this document under the terms of the GNU General
Public License, Version 2 or any later version published by the Free Software
Foundation On Debian systems, the complete text of the GNU General Public
License can be found in /usr/share/common-licenses/GPL.