Merge pull request #2423 from thatux/wsl_build_docs

added WSL build documentation

BUILD.md

@@ -3,7 +3,7 @@ hashcat build documentation
 
 ### Revision ###
 
-* 1.4
+* 1.5
 
 ### Author ###
 
@@ -33,6 +33,11 @@ $ make install
 
 If you install it, cached kernels, session files, restore- and pot-files etc. will go to $HOME/.hashcat/
 
+
+### Building hashcat for Windows (using Windows Subsystem for Linux) ###
+
+Refer to [BUILD_WSL.md](BUILD_WSL.md)
+
 ### Building hashcat for Windows (using Cygwin) ###
 
 Refer to [BUILD_CYGWIN.md](BUILD_CYGWIN.md)

BUILD_WSL.md

@@ -0,0 +1,36 @@
+# Compiling hashcat for Windows with Windows Subsystem for Linux.
+
+Tested on Windows 10 x64, should also work to build hashcat for Windows on Linux.
+
+### Installation ###
+
+Enable WSL.
+
+Press the win + r key on your keyboard simultaneously and in the "Run" popup window type bash and make sure to install additional dependencies necessary for hashcat compilation
+```
+sudo apt install gcc-mingw-w64-x86-64 make git
+git clone https://github.com/hashcat/hashcat
+git clone https://github.com/win-iconv/win-iconv
+cd win-iconv/
+patch < ../hashcat/tools/win-iconv-64.diff
+sudo make install
+cd ../
+```
+
+### Building ###
+
+You've already cloned the latest master revision of hashcat repository above, so switch to the folder and type "make win" to start compiling hashcat
+```
+cd hashcat/
+make win
+```
+
+The process may take a while, please be patient. Once it's finished, close WSL.
+Press the win + r keys together and (in the "Run" popup window) type cmd, using cd navigate to the hashcat folder e.g.
+```
+cd "C:\Users\user\hashcat"
+```
+and start hashcat by typing
+```
+hashcat.exe
+```