diff --git a/BUILD.md b/BUILD.md index 6cca7149e..9a71eb9be 100644 --- a/BUILD.md +++ b/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) diff --git a/BUILD_WSL.md b/BUILD_WSL.md new file mode 100644 index 000000000..814eaa326 --- /dev/null +++ b/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 +``` \ No newline at end of file