User Tools

Site Tools


install_aircrack

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
install_aircrack [2018/07/11 03:52]
mister_x [OS X] Updated OSX requirements
install_aircrack [2018/11/22 00:11]
mister_x [Linux/BSD/OSX] General updates and Linux packages
Line 10: Line 10:
   * shtool   * shtool
   * OpenSSL development package or libgcrypt development package.   * OpenSSL development package or libgcrypt development package.
-  * pkg-config ​(pkgconf on FreeBSD)+  * pkg-config
  
 ==== Linux ==== ==== Linux ====
Line 22: Line 22:
  
   * w32api is required   * w32api is required
-  * Airpcap: developer directory from the Airpcap CD. 
   * if using clang, libiconv and libiconv-devel   * if using clang, libiconv and libiconv-devel
   * make and Standard C++ Library development package   * make and Standard C++ Library development package
Line 51: Line 50:
   * If you want SSID filtering with regular expression in airodump-ng (-essid-regex) pcre development package is required.   * If you want SSID filtering with regular expression in airodump-ng (-essid-regex) pcre development package is required.
   * If you want to use airolib-ng and '​-r'​ option in aircrack-ng,​ SQLite development package >= 3.3.17 (3.6.X version or better is recommended)   * If you want to use airolib-ng and '​-r'​ option in aircrack-ng,​ SQLite development package >= 3.3.17 (3.6.X version or better is recommended)
-  * If you want to use Airpcap, the '​developer'​ directory from the CD is required.+  * If you want to use Airpcap, the '​developer'​ directory from the CD is required. It can be downloaded [[https://​support.riverbed.com/​content/​support/​software/​steelcentral-npm/​airpcap.html|here]].
   * For best performance on FreeBSD (50-70% more), install gcc5 via: pkg install gcc5 Then compile with: gmake CC=gcc5 CXX=g++5   * For best performance on FreeBSD (50-70% more), install gcc5 via: pkg install gcc5 Then compile with: gmake CC=gcc5 CXX=g++5
   * rfkill   * rfkill
   * CMocka   * CMocka
 +  * hwloc: strongly recommended,​ especially on high core count systems where it may give a serious performance boost
  
  
Line 65: Line 65:
 ==== Current version ==== ==== Current version ====
  
-   ​wget ​http://​download.aircrack-ng.org/​aircrack-ng-1.2.tar.gz +   ​wget ​https://​download.aircrack-ng.org/​aircrack-ng-1.4.tar.gz 
-   tar -zxvf aircrack-ng-1.2.tar.gz +   tar -zxvf aircrack-ng-1.4.tar.gz 
-   cd aircrack-ng-1.2+   cd aircrack-ng-1.4
    ​autoreconf -i    ​autoreconf -i
    ​./​configure --with-experimental    ​./​configure --with-experimental
Line 78: Line 78:
   - Append '- -with-airpcap=../​developer'​ parameter to configure:   - Append '- -with-airpcap=../​developer'​ parameter to configure:
  
-==== Compiling on *BSD/OSX ====+==== Compiling on *BSD ====
  
-Commands are exactly the same as Linux but instead of **make**, use **gmake** (with **CC=gcc5 CXX=g++5** or any other installed ​gcc version).+Commands are exactly the same as Linux but instead of **make**, use **gmake** (with **CC=gcc5 CXX=g++5** or any more recent ​gcc version ​installed).
  
 +==== Compiling on OS X ====
 +
 +Commands are exactly the same as Linux
 ==== Latest Git (development) Sources ==== ==== Latest Git (development) Sources ====
  
Line 98: Line 101:
 When configuring,​ the following flags can be used and combined to adjust the suite to your choosing: When configuring,​ the following flags can be used and combined to adjust the suite to your choosing:
  
-  * **with-airpcap=DIR**:​ needed for supporting airpcap devices on windows (cygwin or msys2 only) Replace DIR above with the absolute location to the root of the extracted source code from the Airpcap CD or downloaded SDK available online.+  * **with-airpcap=DIR**:​ needed for supporting airpcap devices on windows (cygwin or msys2 only) Replace DIR above with the absolute location to the root of the extracted source code from the Airpcap CD or downloaded SDK available online. ​Required on Windows to build besside-ng, besside-ng-crawler,​ easside-ng, tkiptun-ng and wesside-ng when building experimental tools. The developer pack (Compatible with version 4.1.1 and 4.1.3) can be downloaded at https://​support.riverbed.com/​content/​support/​software/​steelcentral-npm/​airpcap.html
  
-  * **with-experimental**:​ needed to compile tkiptun-ng, easside-ng ​(and buddy-ngand wesside-ng. ​Building besside-ng-crawler requires LibPCAP (development package). On debian based distro, install libpcap-dev+  * **with-experimental**:​ needed to compile tkiptun-ng, easside-ngbuddy-ng, buddy-ng-crawler,​ airventriloquist ​and wesside-ng. ​libpcap ​development package ​is also required to compile most of the tools. If not present, not all experimental tools will be built. On Cygwin, libpcap is not present and the Airpcap SDK replaces it. See --with-airpcap option above. On debian based distro, install libpcap-dev
  
-  * **with-ext-scripts**:​ needed to build airoscript-ng,​ versuck-ng, airgraph-ng and airdrop-ng. Note: Experimental. ​Each script has its own dependences. Note: It's only required in install phase.+  * **with-ext-scripts**:​ needed to build airoscript-ng,​ versuck-ng, airgraph-ng and airdrop-ng. Note: Each script has its own dependencies. Note: It's only required in install phase.
  
   * **with-gcrypt**:​ Use libgcrypt crypto library instead of the default OpenSSL. And also use internal fast sha1 implementation (borrowed from GIT) Dependency (Debian): libgcrypt20-dev   * **with-gcrypt**:​ Use libgcrypt crypto library instead of the default OpenSSL. And also use internal fast sha1 implementation (borrowed from GIT) Dependency (Debian): libgcrypt20-dev
Line 112: Line 115:
   * **disable-libnl**:​ Set-up the project to be compiled without libnl (1 or 3). Linux option only.   * **disable-libnl**:​ Set-up the project to be compiled without libnl (1 or 3). Linux option only.
  
 +  * **without-opt**:​ Do not enable stack protector (on GCC 4.9 and above).
 +
 +  * **enable-shared**:​ Make OSdep a shared library.
 +
 +  * **disable-shared**:​ When combined with enable-static,​ it will statically compile Aircrack-ng.
 +
 +  * **with-avx512**:​ On x86, add support for AVX512 instructions in aircrack-ng. Only use it when the current CPU supports AVX512.
 +
 +  * **with-static-simd=**:​ Compile a single optimization in aircrack-ng binary. Useful when compiling statically and/or for space-constrained devices. Valid SIMD options: x86-sse2, x86-avx, x86-avx2, x86-avx512, ppc-altivec,​ ppc-power8, arm-neon, arm-asimd. Must be used with --enable-static --disable-shared. When using those 2 options, the default is to compile the generic optimization in the binary. **--with-static-simd** merely allows to choose another one.
  
 ===== Troubleshooting Tips ===== ===== Troubleshooting Tips =====
Line 146: Line 158:
   * Add the directories to your PATH.  See the one or more of the following web sites for details of how to do this:   * Add the directories to your PATH.  See the one or more of the following web sites for details of how to do this:
  
-   http://​www.linuxheadquarters.com/​howto/​basic/​path.shtml +   https://​www.cyberciti.biz/​faq/​howto-print-path-variable/​
-   http://​www.cyberciti.biz/​faq/​howto-print-path-variable/​+
    ​http://​www.troubleshooters.com/​linux/​prepostpath.htm    ​http://​www.troubleshooters.com/​linux/​prepostpath.htm
-   ​http://​linux.about.com/​od/​linux101/​l/​blnewbie3_1_4.htm 
  
   * Change to the particular directory with "​cd"​ and then run the commands from within the directory. Don't forget to add "​./"​ in front of each command.   * Change to the particular directory with "​cd"​ and then run the commands from within the directory. Don't forget to add "​./"​ in front of each command.
Line 159: Line 169:
 ===== Linux/​BSD/​OSX ===== ===== Linux/​BSD/​OSX =====
  
-Open your package ​manager ​and install '​Aircrack-ng' package. Be sure to check that the version offered is up-to-date -- it often isn't.+With the exception of Linux penetration testing distributions,​ packages are usually out of date (OS X is the exception). In this case, uninstalling the package and installing from sources is the recommended way to go. 
 + 
 +We offer packages for a number of Linux distributions in 64 bit thanks to [[https://​packagecloud.io/​aircrack-ng/​|PackageCloud.io]] so you can use your distro'package ​manager ​to install and keep Aircrack-ng ​up to date: 
 + 
 + 
 +  * Debian 
 +  * Ubuntu 
 +  * Mint 
 +  * SLES 
 +  * OpenSuse 
 +  * Fedora 
 +  * RHEL 
 +  * CentOS 
 +  * Amazon Linux 
 +  * Elementary OS 
 + 
 +While most folks want to use our "​[[https://​packagecloud.io/​aircrack-ng/​release/​install|release]]"​ packages, "​[[https://​packagecloud.io/​aircrack-ng/​git/​install|git]]"​ packages are available too for those who decide ​to use bleeding edge. 
 + 
 +More details about them can be found in our [[https://​aircrack-ng.blogspot.com/​2018/​10/​aircrack-ng-packages.html|blog post]].
  
-On OSX, install it is via [[http://​www.macports.org/​|Macports]]. Simply do "​sudo ​port install aircrack-ng"​.+On OSX, install it is via [[https://​www.macports.org/​|Macports]] or [[https://​brew.sh/​|brew]]. Simply do "brew install aircrack-ng"​ or "​sudo ​ports install aircrack-ng"​
  
 ===== Windows ===== ===== Windows =====
Line 168: Line 196:
 Here are the steps to follow for Windows: Here are the steps to follow for Windows:
  
-  * Download the latest version of the Aircrack-ng suite for Windows to your PC. The link for the zip file can be found on the [[http://​aircrack-ng.org|Wiki home page]].+  * Download the latest version of the Aircrack-ng suite for Windows to your computer. The link for the zip file can be found on the [[https://​aircrack-ng.org|Wiki home page]].
  
-  * Unzip the contents of the Aircrack-ng zip file into "​C:​\"​. This will create a directory called "​aircrack-ng-1.2-win". This directory name will vary based on the exact version that you downloaded. ​ This main directory contains three subdirectories - "​bin",​ "​src"​ and "​test"​.+  * Unzip the contents of the Aircrack-ng zip file into "​C:​\"​. This will create a directory called "​aircrack-ng-1.4-win". This directory name will vary based on the exact version that you downloaded. ​ This main directory contains three subdirectories - "​bin",​ "​src"​ and "​test"​.
  
-Prior to using the software, make sure to install the drivers for your particular wireless card. See this [[install_drivers#​windows|link]] for the instructions.+Prior to using the software, make sure to install the drivers for your particular wireless card. See this [[install_drivers#​windows|link]] for the instructions. We currently only support Airpcap; other adapters may be supported but require development of your own DLL so the different tools can interact with it.
  
 To now use the Aircrack-ng suite, start Windows Explorer and double click on **Aircrack-ng GUI.exe** inside "​bin"​ subdirectory. ​ The GUI requires .NET version 4.6.1 to run. To now use the Aircrack-ng suite, start Windows Explorer and double click on **Aircrack-ng GUI.exe** inside "​bin"​ subdirectory. ​ The GUI requires .NET version 4.6.1 to run.
  
-Alternatively,​ open a command prompt (Start menu -> Execute -> cmd.exe) and change to the  "​C:​\aircrack-ng-1.2-win\bin"​ directory and execute the individual commands. ​+Alternatively,​ open a command prompt (Start menu -> Execute -> cmd.exe) and change to the  "​C:​\aircrack-ng-1.4-win\bin"​ directory and execute the individual commands. ​
 \\ \\
 \\ \\
install_aircrack.txt · Last modified: 2019/04/07 22:56 by mister_x