Menu

Tree [caa946] master /
 History

HTTPS access


File Date Author Commit
 apparmor 2015-08-30 Moshe Kaplan Moshe Kaplan [19e131] Added initial apparmor profiles for remaining u...
 build 2018-02-20 Joseph Benden Joseph Benden [75c7ec] Windows: Do not attempt to use stackguard compi...
 contrib 2017-10-20 Thomas d'Otreppe Thomas d'Otreppe [9b6aa3] Fix a bunch of typos.
 lib 2018-01-01 Thomas d'Otreppe Thomas d'Otreppe [8ccc64] Updated copyrights.
 manpages 2018-03-02 Thomas d'Otreppe Thomas d'Otreppe [9f1432] Airodump-ng: Added support for HT channels.
 packages 2017-05-27 Thomas d'Otreppe Thomas d'Otreppe [164858] Updated all aircrack-ng URL to use HTTPS.
 patches 2017-10-29 Thomas d'Otreppe Thomas d'Otreppe [1f47ae] HostAPd-WPE: Fixed apt-get command for dependen...
 scripts 2018-03-06 Thomas d'Otreppe Thomas d'Otreppe [3532a1] Airgraph-ng: Handle SSID with double quotes (Cl...
 src 2018-03-09 Thomas d'Otreppe Thomas d'Otreppe [96aa6e] Airolib-ng: Use common function to cleanup hash...
 test 2018-01-23 Joseph Benden Joseph Benden [812280] Fixed a few problems with Cygwin 64-bit.
 .gitignore 2018-01-12 Joseph Benden Joseph Benden [9dc5f0] Merge new autotools build system.
 .travis.yml 2018-01-15 Joseph Benden Joseph Benden [ac4550] Removed the SIMD flag testing from Travis CI.
 AUTHORS 2008-02-26 Thomas d'Otreppe Thomas d'Otreppe [3fb427] Moved 1.0-dev to trunk.
 ChangeLog 2018-03-07 Thomas d'Otreppe Thomas d'Otreppe [c10156] Updated Changelog.
 INSTALLING 2018-03-07 Thomas d'Otreppe Thomas d'Otreppe [e3f262] Updated INSTALLING file.
 LICENSE 2008-02-26 Thomas d'Otreppe Thomas d'Otreppe [3fb427] Moved 1.0-dev to trunk.
 LICENSE.OpenSSL 2008-02-26 Thomas d'Otreppe Thomas d'Otreppe [3fb427] Moved 1.0-dev to trunk.
 Makefile.am 2018-01-12 Joseph Benden Joseph Benden [9dc5f0] Merge new autotools build system.
 README 2017-10-22 Thomas d'Otreppe Thomas d'Otreppe [b814c2] Added WPS 2.0 test pcap.
 README.md 2018-03-07 Thomas d'Otreppe Thomas d'Otreppe [e4aef7] README.md: Updated description.
 VERSION 2016-02-14 Thomas d'Otreppe Thomas d'Otreppe [18467e] Prepare for 1.2rc4.
 appveyor.yml 2018-03-16 Joseph Benden Joseph Benden [caa946] AppVeyor: do not halt on catgets
 autogen.sh 2018-01-12 Joseph Benden Joseph Benden [9dc5f0] Merge new autotools build system.
 configure.ac 2018-01-22 Joseph Benden Joseph Benden [916d8b] Changed bug reporting location.
 evalrev 2013-05-24 Thomas d'Otreppe Thomas d'Otreppe [4ed134] Fixed building with revision number when downlo...

Read Me

Documentation, tutorials, ... can be found on https://www.aircrack-ng.org
See also manpages and the forum.

Installing
==========

This version now requires more libraries than 0.X versions to be compiled. 
See INSTALLING file for more information

OpenWrt Devices
===============

You can use airodump-ng on OpenWrt devices. You'll have to use specify
prism0 as interface. Airodump-ng will automatically create it.
Rq: 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).


Known bugs:
===========

Drivers
-------

	Madwifi-ng
	----------
	
	The cause of most of these problems (1, 2 and 3) is that Madwifi-ng cannot easily change the rate in monitor mode.
	Technically, when changing rate while in monitor mode, the raw socket gets invalidated and we have to get it again.
	Madwifi-ng is getting replaced by several drivers: ath5k, ath9k and ar9170.
	
	
	Problem 1: No client can associate to an airbase soft AP.
	Solution: Use a more recent driver. Madwifi-ng has been deprecated for years.
	
	
	Problem 2: When changing rate while you are capturing packet makes airodump-ng stall
	Solution 2: Restart airodump-ng or change rate before starting it.
	
	Problem 3: After some time it stops capturing packets and you're really sure no network manager are running at all.
	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: 
	            from 5 minutes to 50 or even more). Try (as root) unloading completely the driver with 'madwifi-unload'
	            and then run 'modprobe ath_pci autocreate=monitor'.
		  
	
	Problem 4: When creating a new VAP airodump-ng takes up to 10-15 seconds to see the first packet
	Solution 4: It's the behavior of madwifi-ng, don't worry (... be happy ;)).


	Orinoco
	-------

	Problem: BSSID is not reported correctly or is 00:00:00:00:00:00 or signal is not reported correctly.
	Solution: None. Consider replacing your card, orinoco is really really old.


Aircrack-ng
-----------

	Aireplay-ng
	-----------

	Problem: Fakeauth on a WRT54G with WEP (shared authentication) doesn't work.
	Solution: None at this time (we'll try to fix it in an upcoming release).


	Airolib-ng
	----------

	Problem: On windows only, opening/creating a database doesn't work when airolib-ng is in directories containing
	         special characters like 'ç', 'é', 'è', 'à', ... (directories containing spaces are not affected).
	Reason: It's a SQLite issue.
	Solution: Rename the directory or move the database into another directory.


	Airodump-ng
	-----------

	Problem: Airodump-ng stop working after some time.
	Solution 1: You may have a network manager running that puts back the card in managed mode. 
	            You'll have to disable it (the fastest solution is killing the process) then restart airodump-ng.
	Solution 2: See Problem 3 of Madwifi-ng.
	
	Problem: On windows, it doesn't display a list of adapters like the old 0.X
	Solution: It requires you to develop your own DLL.

	Problem: Handshake is not captured/detected
	Reason: You might be too far and your signal is bad (or too close with a signal too strong).
	        Another possibility is that Airodump-ng didn't detect the handshake properly due to
	        being far apart in the capture.
	Solution 1: Check out our tutorial 'WPA Packet Capture Explained' in the wiki.
	Solution 2: Try running Aircrack-ng on your capture, it might detect the capture.
	Solution 3: Check out our wpaclean tool.
	Note: It will be fixed in an upcoming release.

	Cygwin
	------
	
	Problem: Aircrack-ng doesn't build on Cygwin64
	Solution: None at this time. Build it using 32 bit cygwin.

	Problem: /usr/include/sys/reent.h:14:20: fatal error: stddef.h: No such file or directory
	Solution: It happens because the gcc and g++ version are different. Make sure they are the same.
	
Sample files
============

wep.open.system.authentication.cap:
    It show a connexion (authentication then association) to a WEP network (open authentication).

wep.shared.key.authentication.cap:
    It shows a connexion (authentication then association to a WEP network (shared authentication).
    The difference with open authentication is that the client has to encrypt a challenge text
    and send it back (encrypted) to the AP to prove it has the right key.

wpa.cap:
    This is a sample file with a WPA handshake. It is located in the test/ directory of the install files. 
    The passphrase is 'biscotte'. Use the password file (password.lst) which is in the same directory.

wpa2.eapol.cap: 
    This is a sample file with a WPA2 handshake. 
    It is located in the test/ directory of the install files. 
    The passphrase is '12345678'. Use the password file (password.lst) which is in the same directory.

test.ivs (http://download.aircrack-ng.org/wiki-files/other/test.ivs): 
    This is a 128 bit WEP key file.
    The key is AE:5B:7F:3A:03:D0:AF:9B:F6:8D:A5:E2:C7.

wep_64_ptw.cap (http://dl.aircrack-ng.org/ptw.cap): 
    This is a 64 bit WEP key file suitable for the PTW method.
    The key is '1F:1F:1F:1F:1F'.

wpa-psk-linksys.cap:
    This is a sample file with a WPA1 handshake along with some encrypted packets.
    Useful for testing with airdecap-ng. The password is 'dictionary'.

wpa2-psk-linksys.cap:
    This is a sample file with a WPA2 handshake along with some encrypted packets.
    Useful for testing with airdecap-ng. The password is 'dictionary'.

wps2.0.pcap:
    This is a test file with WPS 2.0 beacon.

password.lst
    This is a sample wordlist for WPA key cracking. More wordlists can be found at
    https://www.aircrack-ng.org/doku.php?id=faq#where_can_i_find_good_wordlists

password.db
    This is a sample airolib-ng database for WPA key cracking.

pingreply.c
    Replies to all ping requests. Useful for testing sniffing/injecting packets with airtun-ng.

Chinese-SSID-Name.pcap
    Contains a beacon with an SSID displayed in Chinese.

verify_inject.py
    Testing DNS requests using airtun-ng.


More sample pcap are available from Wireshark: 
    https://wiki.wireshark.org/SampleCaptures#Wifi_.2F_Wireless_LAN_captures_.2F_802.11
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.