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..6d059b792 --- /dev/null +++ b/BUILD_WSL.md @@ -0,0 +1,31 @@ +# Compiling hashcat for Windows with Windows Subsystem for Linux. + +Tested on a Windows 10 (x64 build 18363), should also work to build hashcat for Windows on Linux. + +### Installation ### + +Enable WSL. + +Run bash (win+r 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 +cp hashcat/tools/win-iconv-64.diff win-iconv/ +cd win-iconv/ +sudo make install +``` + +### 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, run a Windows command prompt (win+r cmd) and start hashcat by typing "hashcat.exe" + +``` +hashcat.exe +``` \ No newline at end of file