NAME

       aircrack-ng - a 802.11 WEP / WPA-PSK key cracker

SYNOPSIS

       aircrack-ng [options] <.cap / .ivs file(s)>

DESCRIPTION

       aircrack-ng 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.

OPTIONS

       -H, --help
              Shows the help screen.

       Common options:

       -a <amode>
              Force the attack mode, 1 or wep for WEP and 2 or wpa for WPA-PSK.

       -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  http://www.aircrack-
              ng.org/doku.php?id=faq#how_to_use_spaces_double_quote_and_single_quote_etc._in_ap_names

       -b <bssid>
              Select the target network based on the access point MAC address.

       -p <nbcpu>
              Set this option to the number of CPUs to use (only available on SMP systems). By default, it  uses
              all available CPUs

       -q     If set, no status information is displayed.

       -C <macs>
              Merges all those APs MAC (separated by a comma) into a virtual one.

       -l <file>
              Write the key into a file.

       Static WEP cracking options:

       -c     Search alpha-numeric characters only.

       -t     Search binary coded decimal characters only.

       -h     Search the numeric key for Fritz!BOX

       -d <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 128.

       -i <index>
              Only keep the IVs that have this key index (1 to 4). The default behaviour is to  ignore  the  key
              index in the packet, and use the IV regardless.

       -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).

       -x1    Enable last keybyte bruteforcing (default)

       -x2    Enable last two keybytes bruteforcing.

       -X     Disable bruteforce multithreading (SMP only).

       -s     Shows ASCII version of the key at the right of the screen.

       -y     This is an experimental single brute-force attack which should only  be  used  when  the  standard
              attack mode fails with more than one million IVs.

       -z     Uses PTW (Andrei Pyshkin, Erik Tews and Ralf-Philipp Weinmann) attack (default attack).

       -P <num>
              PTW debug: 1 Disable klein, 2 PTW.

       -K     Use KoreK attacks instead of PTW.

       -D     WEP decloak mode.

       -1     Run only 1 try to crack key with PTW.

       -M <num>
              Specify maximum number of IVs to use.

       WPA-PSK cracking options:

       -w <words>
              Path to a dictionary file for wpa cracking. Specify "-" to use stdin. Here is a list of wordlists:
              http://www.aircrack-ng.org/doku.php?id=faq#where_can_i_find_good_wordlists

       -r <database>
              Path to the airolib-ng database. Cannot be used with '-w'.

AUTHOR

       This  manual page was written by Adam Cecile <gandalf@le-vert.net> 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.

SEE ALSO

       airbase-ng(8)
       airdecap-ng(1)
       airdecloak-ng(1)
       airdriver-ng(8)
       aireplay-ng(8)
       airmon-ng(8)
       airodump-ng(8)
       airolib-ng(1)
       airserv-ng(8)
       airtun-ng(8)
       buddy-ng(1)
       easside-ng(8)
       ivstools(1)
       kstats(1)
       makeivs-ng(1)
       packetforge-ng(1)
       tkiptun-ng(8)
       wesside-ng(8)

Version 1.1                                        April 2010                                     AIRCRACK-NG(1)