NameDateSize

..16-Mar-201612 KiB

.travis.yml13-Dec-2013383

AUTHORS18-Sep-201344

ChangeLog13-Dec-201344.9 KiB

common.mak13-Dec-20133 KiB

contrib/18-Sep-20134 KiB

evalrev18-Sep-2013517

INSTALLING13-Dec-20132.7 KiB

lib/18-Sep-20134 KiB

LICENSE18-Sep-201317.6 KiB

LICENSE.OpenSSL18-Sep-20136.1 KiB

Makefile18-Sep-20131.9 KiB

manpages/13-Dec-20134 KiB

packages/13-Dec-20134 KiB

patches/18-Sep-20134 KiB

README18-Sep-20135.3 KiB

README.md18-Sep-20133.4 KiB

scripts/13-Dec-20134 KiB

src/04-Feb-20144 KiB

test/12-Oct-20134 KiB

VERSION13-Dec-20139

README

1Documentation, tutorials, ... can be found on http://www.aircrack-ng.org
2See also manpages and the forum.
3
4Installing
5==========
6
7This version now requires more libraries than 0.X versions to be compiled. 
8See INSTALLING file for more information
9
10OpenWrt Devices
11===============
12
13You can use airodump-ng on OpenWrt devices. You'll have to use specify
14prism0 as interface. Airodump-ng will automatically create it.
15Rq: Aireplay DOESN'T work on OpenWrt (2.4 kernel) with broadcom chipset since the driver doesn't support injection. It *may* work with 2.6 kernels >= 2.6.24 (kamikaze 8.09+ custom-built).
16
17
18Known bugs:
19===========
20
21Drivers
22-------
23
24	Madwifi-ng
25	----------
26	
27	The cause of most of these problems (1, 2 and 3) is that Madwifi-ng cannot easily change the rate in monitor mode.
28	Technically, when changing rate while in monitor mode, the raw socket gets invalidated and we have to get it again.
29	Madwifi-ng is getting replaced by several drivers: ath5k, ath9k and ar9170.
30	
31	
32	Problem 1: No client can associate to an airbase soft AP.
33	Solution 1: None at this time.
34	
35	
36	Problem 2: When changing rate while you are capturing packet makes airodump-ng stall
37	Solution 2: Restart airodump-ng or change rate before starting it.
38	
39	Problem 3: After some time it stops capturing packets and you're really sure no network manager are running at all.
40	Solution 3: That's a known bug in the driver, it may happen at any time (the time before it fails can vary a lot: 
41	            from 5 minutes to 50 or even more). Try (as root) unloading completely the driver with 'madwifi-unload'
42	            and then run 'modprobe ath_pci autocreate=monitor'.
43		  
44	
45	Problem 4: When creating a new VAP airodump-ng takes up to 10-15 seconds to see the first packet
46	Solution 4: It's the behaviour of madwifi-ng, don't worry (... be happy ;)).
47
48
49	Orinoco
50	-------
51
52	Problem: BSSID is not reported correctly or is 00:00:00:00:00:00 or signal is not reported correctly.
53	Solution: None. Consider replacing your card, orinoco is really really old.
54
55
56Aircrack-ng
57-----------
58
59	Aireplay-ng
60	-----------
61
62	Problem: Fakeauth on a WRT54G with WEP (shared authentication) doesn't work.
63	Solution: None at this time (we'll try to fix it for next release).
64
65
66	Airolib-ng
67	----------
68
69	Problem: On windows only, opening/creating a database doesn't work when airolib-ng is in directories containing
70	         special characters like '�', '�', '�', '�', ... (directories containing spaces are not affected).
71	Reason: It's a SQLite issue.
72	Solution: Rename the directory or move the database into another directory.
73
74
75	Airbase-ng
76	----------
77
78	Problem: SSID are not displayed correctly (when scanning for networks) when using airbase-ng with r8187 driver.
79	Reason: Beacons are truncated (the beginning is missing) when sent in the air.
80	Solution: None at this time (we'll try to fix it for next release)
81
82	Airodump-ng
83	-----------
84
85	Problem: Airodump-ng stop working after some time.
86	Solution 1: You may have a network manager running that puts back the card in managed mode. 
87	            You'll have to disable it (the fastest solution is killing the process) then restart airodump-ng.
88	Solution 2: See Problem 3 of Madwifi-ng.
89	
90	Problem: On windows, it doesn't display a list of adapters like the old 0.X
91	Solution: It requires you to develop your own DLL.
92	
93	Cygwin
94	------
95	
96	Problem: Aircrack-ng doesn't build on Cygwin64
97	Solution: None at this time. Build it using 32 bit cygwin.
98	
99	Problem: Aircrack-ng doesn't build with gcc 4.5
100	Solution: Use an older version of gcc such as 4.3 for now (will be fixed in stable release).
101	
102Sample files
103============
104
105wep.open.system.authentication.cap:
106    It show a connexion (authentication then association) to a WEP network (open authentication).
107
108wep.shared.key.authentication.cap:
109    It shows a connexion (authentication then association to a WEP network (shared authentication).
110    The difference with open authentication is that the client has to encrypt a challenge text
111    and send it back (encrypted) to the AP to prove it has the right key.
112
113wpa.cap:
114    This is a sample file with a WPA handshake. It is located in the test/ directory of the install files. 
115    The passphrase is 'biscotte'. Use the password file (password.lst) which is in the same directory.
116
117wpa2.eapol.cap: 
118    This is a sample file with a WPA2 handshake. 
119    It is located in the test/ directory of the install files. 
120    The passphrase is '12345678'. Use the password file (password.lst) which is in the same directory.
121
122test.ivs (http://download.aircrack-ng.org/wiki-files/other/test.ivs): 
123    This is a 128 bit WEP key file.
124    The key is AE:5B:7F:3A:03:D0:AF:9B:F6:8D:A5:E2:C7.
125
126ptw.cap (http://dl.aircrack-ng.org/ptw.cap): 
127    This is a 64 bit WEP key file suitable for the PTW method.
128    The key is '1F:1F:1F:1F:1F'.
129
130wpa-psk-linksys.cap:
131    This is a sample file with a WPA1 handshake along with some encrypted packets.
132    Useful for testing with airdecap-ng. The password is 'dictionary'.
133
134wpa2-psk-linksys.cap:
135    This is a sample file with a WPA2 handshake along with some encrypted packets.
136    Useful for testing with airdecap-ng. The password is 'dictionary'.
137
138password.lst
139    This is a sample wordlist for WPA key cracking. More wordlists can be found at
140    http://www.aircrack-ng.org/doku.php?id=faq#where_can_i_find_good_wordlists
141
142password.db
143    This is a sample airolib-ng database for WPA key cracking.
144

README.md

1# Aircrack-ng
2Aircrack-ng is an 802.11 WEP and WPA-PSK keys cracking program that can recover
3keys once enough data packets have been captured. It implements the standard FMS
4attack along with some optimizations like KoreK attacks, as well as the
5all-new PTW attack, thus making the attack much faster compared to other WEP
6cracking tools.
7
8It can attack WPA1/2 networks with some advanced methods or simply by brute force.
9It can also fully use a multiprocessor system to its full power in order
10to speed up the cracking process.
11
12
13[![Build Status](https://api.travis-ci.org/aircrack-ng/aircrack-ng.png)](https://travis-ci.org/aircrack-ng/aircrack-ng)
14
15
16# Building
17
18## Requirements
19
20 * OpenSSL development package or libgcrypt development package
21 * If you want to use `airolib-ng` and `-r` option in aircrack-ng,
22   SQLite development package `>= 3.3.17` (3.6.X version or better is recommended):
23   `libsqlite3-devel`
24 * On windows, cygwin has to be used and it also requires w32api and gcc-4 package.
25 * If you want to use Airpcap, the 'developer' directory from the CD is required.
26
27## Compilating
28
29 * Compilation:
30
31    `make`
32
33 * Strip debugging symbols:
34
35    `make strip`
36
37 * Installing:
38
39    `make install`
40
41 * Uninstall:
42
43    `make uninstall`
44
45
46###  Makefile flags
47
48When compile and installing, the following flags can be used and combined
49to compile and install the suite:
50
51* **sqlite**:   needed to compile `airolib-ng` and add support for `airolib-ng`
52                databases in aircrack-ng.
53                On cygwin: SQLite has to be compiled manually. See next section.
54
55* **airpcap**:  needed for supporting airpcap devices on windows (cygwin only)
56                REQUIREMENT: Copy 'developers' directory from Airpcap CD one 
57                level below this INSTALLING file
58                Note: Not working yet.
59
60* **unstable**: needed to compile `tkiptun-ng`, `easside-ng` (and `buddy-ng`) and
61                `wesside-ng`
62
63* **ext_scripts**: needed to build `airoscript-ng`, `versuck-ng`, `airgraph-ng` and 
64                   `airdrop-ng`. 
65                   Note: Experimental. Each script has its own dependences.
66                   Note: It's only required in install phase.
67
68* **gcrypt**:   Use libgcrypt crypto library instead of the default OpenSSL.
69                And also use internal fast sha1 implementation (borrowed from GIT)
70
71* **libnl**:    Add support for netlink (nl80211). Linux only.
72    - Requires `libnl1` OR `libnl3`.
73    - Dependencies (debian):
74        +  LibNL 1: `libnl-dev`
75        + LibNL 3: `libnl-3-dev` and `libnl-genl-3-dev`.
76
77#### Examples:
78
79  * Compiling with sqlite and enabling unstable:
80
81    `make sqlite=true unstable=true`
82
83  * Installing:
84
85    `make sqlite=true unstable=true install`
86
87  * Installing, with external scripts:
88
89    `make sqlite=true unstable=true ext_scripts=true`
90
91  * Compiling with gcrypt:
92
93    `make gcrypt=true`
94
95
96# Using precompiled binaries
97
98Linux/BSD:
99 * Use your package manager to download aircrack-ng
100 * In most cases, they have an old version.
101
102Windows:
103 * Install the appropriate "monitor" driver for your card (standard drivers doesn't work for capturing data).
104 * aircrack-ng suite is command line tools. So, you have to open a commandline
105   `Start menu -> Run... -> cmd.exe` then use them
106 * Run the executables without any parameters to have help
107
108# Documentation
109
110
111Documentation, tutorials, ... can be found on http://www.aircrack-ng.org
112
113See also manpages and the forum.
114
115For further information check the [README](README) file
116