oclHashcat build documentation
=
# Revision:
-* 1.1
+* 1.3
# Authors:
* Gabriele Gristina <<matrix@hashcat.net>>
* Christoph Heuwieser <<dropdead@hashcat.net>>
+* magnum <<john.magnum@hushmail.com>>
-# Dependencies
+# Building oclHashcat for Linux and OSX
-To compile **oclHashcat** the following third party libraries are required:
-
-- ADL_SDK v8.0 ( http://developer.amd.com/tools-and-sdks/graphics-development/display-library-adl-sdk/ )
-- NVAPI R352 ( https://developer.nvidia.com/nvapi )
-- GDK v352_55 ( https://developer.nvidia.com/gpu-deployment-kit )
-
-The next thing to do is download all the third party libraries listed above and put these files into the *deps/tmp* directory.
-
-The following files are needed inside the *deps/tmp* directory:
-
- ADL_SDK8.zip
- R352-developer.zip
- gdk_linux_amd64_352_55_release.run
-
-# Building oclHashcat
-First get a copy of **oclHashcat** repository
+Get a copy of the **oclHashcat** repository
```sh
$ git clone https://github.com/hashcat/oclHashcat.git
```
-Install the dependencies
+
+Run "make"
```sh
-$ cd oclHashcat
-$ sudo ./tools/deps.sh
+$ make
```
-Run "make all"
+# Install oclHashcat for Linux
+
+The install target is linux FHS compatible and can be used like this:
```sh
-$ make all
+$ make install
```
-Useful tricks:
-- build only *Linux* binaries
+If you install it, cached kernels, session files, restore- and pot-files etc. will go to $HOME/.hashcat/
+
+# Building oclHashcat for Windows
+
+Get a copy of the **oclHashcat** repository
+
```sh
-$ make linux
+$ git clone https://github.com/hashcat/oclHashcat.git
```
-- build only *Windows* binaries
+
+Basically all you need is the OpenCL Headers.
+
+Simply clone into the reference Implementation:
+
```sh
-$ make windows
+$ mkdir -p deps/OpenCL-Headers
+$ git clone https://github.com/KhronosGroup/OpenCL-Headers deps/OpenCL-Headers/CL
```
+```sh
+$ make win32 win64
+```
=
Enjoy your fresh **oclHashcat** binaries ;)