Differences

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

--- install_aircrack [2016/02/15 02:50] – [Compiling on FreeBSD] Updated formatting and instructions for FreeBSD mister_x
+++ install_aircrack [2018/04/04 02:32] – Updated for rc5 mister_x
@@ Line 1: / Line 1: @@
 ====== Installing Aircrack-ng from Source ======
 ===== Requirements =====
-==== Linux ====
-  * Kernel headers and gcc as well as make have to be installed on your system. On Debian-based distros (Debian, Ubuntu, Xubuntu, ...), issue the following command in a console to install them:
+  * Autoconf
+  * Automake
+  * Libtool
+  * shtool
+  * OpenSSL development package or libgcrypt development package.
+  * pkg-config (pkgconf on FreeBSD)
-  sudo apt-get install build-essential
+==== Linux ====
-  * OpenSSL (development). It is called openssl-dev or libssl-dev depending on your distribution.
+  * Airmon-ng requires ethtool and rfkill
-  * pkg-config
+  * LibNetlink 1 (libnl-dev) or 3 (libnl-3-dev and libnl-genl-3-dev) development packages. It can be disabled by passing --disable-libnl to configure.
-\\
+  * Kernel headers and gcc as well as make have to be installed on your system (build-essential on Debian based distributions)
-The following is required only if you want [[Airolib-ng]]:
+  * make and Standard C++ Library development package (Debian: libstdc++-dev)
-  * [[http://www.sqlite.org|SQLite]] (development) > 3.3.17 (but latest version is recommended)
+==== Windows (Cygwin) ====
-==== Windows ====
+  * w32api is required
+  * Airpcap: developer directory from the Airpcap CD.
-It requires additional libraries to be installed:
+  * if using clang, libiconv and libiconv-devel
-  * [[http://www.openssl.org|OpenSSL]] (development): openssl-devel
+  * make and Standard C++ Library development package (Debian: libstdc++-dev)
-\\
-The following is required only if you want [[Airolib-ng]]:
-  * SQLite3 (development) > 3.3.17 (but latest version is recommended): libsqlite3-devel
 ==== OS X ====
@@ Line 30: / Line 30: @@
   * sqlite3
-==== FreeBSD ====
+==== FreeBSD, OpenBSD, NetBSD, Solaris ====
 Install the following via pkg:
@@ Line 38: / Line 38: @@
   * pcre
   * sqlite3
+  * gcc5 optional (50-70% speed gains compared to gcc 4)
+===== Optional stuff =====
+  * 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 Airpcap, the 'developer' directory from the CD is required.
+  * For best performance on FreeBSD (50-70% more), install gcc5 via: pkg install gcc5 Then compile with: gmake CC=gcc5 CXX=g++5
+  * rfkill
 ===== Compiling and installing =====
-**Note:** For OS X, use 'gmake' instead of 'make'.
+Notes:
+  * On OS X, *BSD and Solaris, use 'gmake' instead of 'make'.
+  * In order to compile with clang instead of gcc, add 'CC=clang CXX=clang++' to the configure command.
 ==== Current version ====
-It requires some additional libraries:
+   wget http://download.aircrack-ng.org/aircrack-ng-1.2-rc5.tar.gz
-  * OpenSSL (libssl-dev on Debian-based system)
+   tar -zxvf aircrack-ng-1.2-rc5.tar.gz
-  * SQLite > 3.3.17 (latest version is recommended) if you want to use [[Airolib-ng]]
+   cd aircrack-ng-1.2-rc5
+   autoreconf -i
-   wget http://download.aircrack-ng.org/aircrack-ng-1.2-rc3.tar.gz
+   ./configure --with-experimental
-   tar -zxvf aircrack-ng-1.2-rc3.tar.gz
-   cd aircrack-ng-1.2-rc3
    make
    make install
-==== Compiling with Airolib-ng support ====
-Simply append 'sqlite=true' parameter to make and make install:
-  make sqlite=true
-  make sqlite=true install
-==== Compiling with PCRE support ====
-Airodump-ng can match SSID with a regular expression when compiled with PCRE:
-  make pcre=true
-  make pcre=true install
-=== OS X ===
-Change CFLAGS in src/Makefile to point to the macpports install of SQLite3 before compiling. Change the following line:
-  CFLAGS += -Iinclude
-to
-  CFLAGS += -Iinclude -arch i386 -I/opt/local/include -L/opt/local/lib
 ==== Compiling with AirPcap support (cygwin only) ===
   - Copy 'developer' directory from the [[airpcap|AirPcap]] CD at the same level as 'Aircrack-ng' directory
-  - Append 'airpcap=true' parameter to make:
+  - Append '--with-airpcap=../developer' parameter to configure:
-  make airpcap=true
+==== Compiling on *BSD/OSX ====
-  make install
-==== Compiling with Airolib-ng and AirPcap support (cygwin only) ====
+Commands are exactly the same as Linux but instead of **make**, use **gmake** (or **CC=gcc5** or any other installed gcc version).
-Simply append both parameter to make and make install:
+==== Latest Git (development) Sources ====
-  make sqlite=true airpcap=true
+**Note:** Compilation parameters can also be used with the sources from our subversion repository.
-  make sqlite=true install
-==== Compiling on FreeBSD ====
+  git clone https://github.com/aircrack-ng/aircrack-ng
-Commands are exactly the same as Linux but instead of **make**, use **gmake** (or **CC=gcc5** or any other installed gcc version).
-==== Latest SVN (development) Sources ====
-  svn co http://svn.aircrack-ng.org/trunk/ aircrack-ng
   cd aircrack-ng
+  autoreconf -i
+  ./configure
   make
   make install
-==== Latest SVN with Airolib-ng support and experimental (unstable) programs (requires SQLite installed) ====
+==== Legacy ====
-(like [[tkiptun-ng|Tkiptun-ng]], [[easside-ng|Easside-ng (and buddy-ng)]], [[wesside-ng|Wesside-ng]] and [[besside-ng|Besside-ng]])
-  make sqlite=true experimental=true
+   wget http://download.aircrack-ng.org/aircrack-ng-0.9.3.tar.gz
-  make sqlite=true experimental=true install
+   tar -zxvf aircrack-ng-0.9.3.tar.gz
+   cd aircrack-ng-0.9.3
+   make
+   make install
-==== Latest SVN with Airolib-ng and and experimental (unstable) programs plus external scripts ====
+==== ./configure flags ====
-(like [[airoscript-ng|Airoscript-ng]], [[tools#versuck-ng|Versuck-ng]], [[airgraph-ng|Airgraph-ng]] and [[airdrop-ng|Airdrop-ng]])
-  make sqlite=true experimental=true ext_scripts=true
+When configuring, the following flags can be used and combined to adjust the suite to your choosing:
-  make sqlite=true experimental=true ext_scripts=true install
-**Note:** Experimental scripts:
+  * **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.
-  * Each scripts has its own dependencies, for details refer to the "README" file contained in their folder
-==== Nightly Build ====
+  * **with-experimental**: needed to compile tkiptun-ng, easside-ng (and buddy-ng) and wesside-ng. Building besside-ng-crawler requires LibPCAP (development package). On debian based distro, install libpcap-dev
-http://nightly.aircrack-ng.org/ contains a nightly tarball from each day. This is handy if you don't have access to SVN (subversion). Just download and build per building the current version instructions. Optionally you can enable the extra features with "sqlite=true" and "experimental=true" per above.
+  * **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.
-==== Legacy ====
+  * **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-duma**: Compile with DUMA support. DUMA is a library to detect buffer overruns and under-runs. Dependencies (debian): duma
+  * **with-xcode**: Set this flag to true to compile on OS X with Xcode 7+.
+  * **disable-libnl**: Set-up the project to be compiled without libnl (1 or 3). Linux option only.
-   wget http://download.aircrack-ng.org/aircrack-ng-0.9.3.tar.gz
-   tar -zxvf aircrack-ng-0.9.3.tar.gz
-   cd aircrack-ng-0.9.3
-   make
-   make install
 ===== Troubleshooting Tips =====
@@ Line 250: / Line 230: @@
 ====== Installing on Mac OSX ======
+**Important note**: airodump-ng and aireplay-ng will not work under OSX natively. Which means, injection and capture will have to use other means. If you have an intel Mac (any recent-ish Mac is), check out the VMware Fusion option which is mentioned lower on this page.
 The simplest and easiest way to install on Mac OS X is via [[http://www.macports.org/|Macports]]. You simply do "sudo port install aircrack-ng".
@@ Line 255: / Line 237: @@
 Alternatively, use the following instructions:
-Make sure you have Xcode installed on your Mac, which can be found on the installer CD/DVD which came with your Mac.
+  - Make sure you have Xcode installed on your Mac, which can be found on the installer CD/DVD which came with your Mac (or downloaded).
-After getting the source you can do a simple "make && sudo make install" from the untarred directory.
+  - After getting the source you can do a simple "make && sudo make install" from the untarred directory.
-When you use the stable, you need to rename the Makefile.osx to Makefile and when you use the dev version it will autodetect you are using Darwin and compile fine.
+  - When you use the stable, you need to rename the Makefile.osx to Makefile and when you use the dev version it will autodetect you are using Darwin and compile fine.
-Mind you, airodump-ng and aireplay-ng are linux only and will not work under OSX native, so for reinjecting and sniffing you will have to use other means.
-If you have an intel Mac check out the VMware Fusion option which is mentioned lower on this page.
 Optional is openssl-dev and sqlite3 which can be installed through fink