Differences

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

--- install_aircrack [2018/07/11 22:02] – Updated requirements and optional stuff mister_x
+++ install_aircrack [2024/06/20 10:32] (current) – [Linux/BSD/OSX] Fix typo in for installing with macports mister_x
@@ Line 15: / Line 15: @@
   * Airmon-ng requires ethtool and rfkill
+    * If USB bus is present, lsusb
+    * If PCI/PCIe bus is present, lspci
   * 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)
@@ Line 25: / Line 27: @@
   * make and Standard C++ Library development package
-==== OS X ====
+==== MacOS ====
 Install the following via Homebrew (brew):
@@ Line 35: / Line 37: @@
   * shtool
   * pkg-config
+  * hwloc
+  * pcre
+  * sqlite3
+  * libpcap
+  * cmocka (optional)
 ==== FreeBSD, OpenBSD, NetBSD, Solaris ====
@@ Line 44: / Line 51: @@
   * pcre
   * sqlite3
-  * gcc7 optional (50-70% speed gains with gcc 5 compared to gcc 4)
+  * gcc9 (or better)
 ===== Optional stuff =====
@@ Line 54: / Line 61: @@
   * rfkill
   * CMocka
+  * hwloc: strongly recommended, especially on high core count systems where it may give a serious performance boost
@@ Line 64: / Line 72: @@
 ==== Current version ====
-   wget http://download.aircrack-ng.org/aircrack-ng-1.2.tar.gz
+   wget https://download.aircrack-ng.org/aircrack-ng-1.7.tar.gz
-   tar -zxvf aircrack-ng-1.2.tar.gz
+   tar -zxvf aircrack-ng-1.7.tar.gz
-   cd aircrack-ng-1.2
+   cd aircrack-ng-1.7
    autoreconf -i
    ./configure --with-experimental
    make
    make install
+   ldconfig
 ==== Compiling with AirPcap support (cygwin only) ===
@@ Line 79: / Line 88: @@
 ==== 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 ====
+==== Compiling on MacOS ====
 Commands are exactly the same as Linux
@@ Line 94: / Line 103: @@
   make
   make install
+  ldconfig
 ==== ./configure flags ====
@@ Line 121: / Line 130: @@
   * **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.
+  * **enable-maintainer-mode**: It is important to enable this flag when developing with Aircrack-ng. This flag enables additional compile warnings and safety features.
 ===== Troubleshooting Tips =====
+==== error while loading shared libraries: libaircrack-ng.so.0 ====
+Run **ldconfig** as root or with "sudo" to solve the issue.
 ==== "command not found" error message ====
@@ Line 154: / Line 172: @@
   * 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://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.
@@ Line 167: / Line 183: @@
 ===== 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 (MacOS is the exception). In this case, uninstalling the package and installing from sources is the recommended way to go.
-On OSX, install it is via [[http://www.macports.org/|Macports]]. Simply do "sudo port install aircrack-ng".
+On MacOS, install it is via [[https://www.macports.org/|Macports]] or [[https://brew.sh/|brew]]. Simply do "brew install aircrack-ng" or "sudo port install aircrack-ng"
 ===== Windows =====
@@ Line 176: / Line 192: @@
 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.6-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.
-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.6-win\bin" directory and execute the individual commands.
 \\
 \\