Update build.md

pull/1973/head
jsteube 5 years ago
parent 2e4423021a
commit a3adcc0995

@ -1,37 +1,45 @@
hashcat build documentation hashcat build documentation
= =
# Revision:
### Revision ###
* 1.4 * 1.4
# Author: see docs/credits.txt ### Author ###
See docs/credits.txt
# Building hashcat for Linux, macOS and Windows (using Cygwin or MSYS2) ### Building hashcat for Linux, macOS and Windows (using Cygwin) ###
Get a copy of the **hashcat** repository Get a copy of the **hashcat** repository
```sh ```
$ git clone https://github.com/hashcat/hashcat.git $ git clone https://github.com/hashcat/hashcat.git
``` ```
Run "make" Run "make"
```sh ```
$ make $ make
``` ```
# Install hashcat for Linux ### Building hashcat for Windows (using MSYS2) ###
Refer to [BUILD_MSYS2.md](BUILD_MSYS2.md)
### Install hashcat for Linux ###
The install target is linux FHS compatible and can be used like this: The install target is linux FHS compatible and can be used like this:
```sh ```
$ make install $ make install
``` ```
If you install it, cached kernels, session files, restore- and pot-files etc. will go to $HOME/.hashcat/ If you install it, cached kernels, session files, restore- and pot-files etc. will go to $HOME/.hashcat/
# Building hashcat for Windows from Linux ### Building hashcat for Windows from Linux ###
```sh ```
$ make win $ make win
``` ```

@ -2,35 +2,45 @@
Tested on a Windows 7 SP1 x64 machine. Tested on a Windows 7 SP1 x64 machine.
### Installation ###
Go to https://www.msys2.org/ and follow the instructions on the main page (steps 1 to 7). Go to https://www.msys2.org/ and follow the instructions on the main page (steps 1 to 7).
Install additional dependencies required to compile hashcat by running the following commands: Install additional dependencies required to compile hashcat by running the following commands:
```sh
```
$ pacman -S git $ pacman -S git
$ pacman -S make $ pacman -S make
$ pacman -S gcc $ pacman -S gcc
$ pacman -S libiconv-devel $ pacman -S libiconv-devel
``` ```
### Building ###
Once all that is done, type the following command to copy the latest master revision of hashcat repository into msys64\home\username\hashcat Once all that is done, type the following command to copy the latest master revision of hashcat repository into msys64\home\username\hashcat
```sh
```
$ git clone https://github.com/hashcat/hashcat.git $ git clone https://github.com/hashcat/hashcat.git
``` ```
Switch to the newly created folder by runnig Switch to the newly created folder by runnig
```sh
```
$ cd hashcat $ cd hashcat
``` ```
Now type "make" to start compiling hashcat Now type "make" to start compiling hashcat
```sh
```
$ make $ make
``` ```
The process may take a while, please be patient. The process may take a while, please be patient. Once it's finished, run hashcat by typing "./hashcat.exe".
Once it's finished, run hashcat by typing "./hashcat.exe".
```sh ```
$ ./hashcat.exe $ ./hashcat.exe
``` ```
### Notes ###
While hashcat will run fine from msys shell, running it from a windows shell will require msys-iconv-2.dll and msys-2.0.dll to be in the same folder with hashcat.exe (the files can be found in msys64\usr\bin). While hashcat will run fine from msys shell, running it from a windows shell will require msys-iconv-2.dll and msys-2.0.dll to be in the same folder with hashcat.exe (the files can be found in msys64\usr\bin).
Loading…
Cancel
Save