diff --git a/BUILD_CYGWIN.MD b/BUILD_CYGWIN.MD new file mode 100644 index 000000000..c6e4ec032 --- /dev/null +++ b/BUILD_CYGWIN.MD @@ -0,0 +1,79 @@ +# Compiling hashcat with Cygwin. + + + +Tested on a Windows 7 SP1 x64 machine. + + + +### Installation ### + + + +Go to https://www.cygwin.com , get the setup-x86_64 file and follow the instructions on the website. + + + +Make sure to install additional dependencies necessary for hashcat compilation by selecting the following packages during cygwin installation + + + +``` +libiconv-devel +gcc-core +make +git +``` + + + +### Building ### + + + +Once all that is done, open the cygwin bash (cygwin\cygwin.bat) and type the following command to copy the latest master revision of hashcat repository into cygwin\home\username\hashcat + + + +``` +$ git clone https://github.com/hashcat/hashcat.git +``` + + + +Switch to the newly created folder by running + + + +``` +$ cd hashcat +``` + + + +Now type "make" to start compiling hashcat + + + +``` +$ make +``` + + + +The process may take a while, please be patient. Once it's finished, run hashcat by typing "./hashcat.exe" + + + +``` +$ ./hashcat.exe +``` + + + +### Notes ### + + + +While hashcat will run fine from cygwin bash, running it from a windows shell will require cygwin1.dll and cygiconv-2.dll to be in the same folder with hashcat.exe (the files can be found in cygwin\bin folder). +