1
mirror of https://github.com/hashcat/hashcat synced 2024-12-12 17:13:55 +01:00
Go to file
2016-04-17 17:48:48 +02:00
charsets Initial commit 2015-12-04 15:47:52 +01:00
docs Add note about fixed issue #288 in changes.txt 2016-04-17 11:02:31 +02:00
extra/tab_completion Allow and support vector-width 16, which is current maximum for 2016-02-18 08:51:45 +01:00
include Do not modify the original positions of mac1, mac2, nonce1 and nonce2 in hccap files 2016-04-17 10:44:14 +02:00
masks Initial commit 2015-12-04 15:47:52 +01:00
obj Initial commit 2015-12-04 15:47:52 +01:00
OpenCL Cleanup -m 9820 kernels to latest standard 2016-04-17 17:46:18 +02:00
rules Update unix-ninja's leetspeak file 2016-01-07 16:35:14 -05:00
src Add some additional information to error-text in read_restore() 2016-04-17 17:48:48 +02:00
tools Added new hash mode -m 125 = ArubaOS 2016-04-10 00:58:28 +02:00
.editorconfig Add an .editorconfig file enforcing some of the code style. See 2015-12-10 17:11:36 +01:00
.gitignore Added support for build without ADL/NVML/NVAPI (issue #120) 2016-01-20 20:55:09 +01:00
example0.cmd More cleanup 2015-12-15 13:23:32 +01:00
example0.hash Initial commit 2015-12-04 15:47:52 +01:00
example0.sh the example*.sh files should now also use the native binary, only when we use the packaging we need to use .bin 2016-01-03 18:34:38 +01:00
example400.cmd More cleanup 2015-12-15 13:23:32 +01:00
example400.hash Initial commit 2015-12-04 15:47:52 +01:00
example400.sh the example*.sh files should now also use the native binary, only when we use the packaging we need to use .bin 2016-01-03 18:34:38 +01:00
example500.cmd More cleanup 2015-12-15 13:23:32 +01:00
example500.hash Initial commit 2015-12-04 15:47:52 +01:00
example500.sh the example*.sh files should now also use the native binary, only when we use the packaging we need to use .bin 2016-01-03 18:34:38 +01:00
example.dict Initial commit 2015-12-04 15:47:52 +01:00
hashcat_tuning.hctab Add another example of an old budget GPU that benefits from higher vector width than returned by preferred 2016-02-23 20:53:55 +01:00
hashcat.hcstat Initial commit 2015-12-04 15:47:52 +01:00
Makefile Initial commit 2015-12-04 15:47:52 +01:00
README.md Update README.md 2015-12-06 16:42:19 +01:00

oclHashcat

oclHashcat is the world's fastest and most advanced GPGPU-based password recovery utility, supporting five unique modes of attack for over 170 highly-optimized hashing algorithms. oclHashcat currently supports AMD (OpenCL) and Nvidia (CUDA) graphics processors on GNU/Linux and Windows 7/8/10, and has facilities to help enable distributed password cracking.

License

oclHashcat is licensed under the MIT license. Refer to docs/license.txt for more information.

Installation

Download the latest release and unpack it in the desired location. Please remember to use 7z x when unpacking the archive from the command line to ensure full file paths remain intact.

Usage/Help

Please refer to the Hashcat Wiki and the output of --help for usage information and general help. A list of frequently asked questions may also be found here. The Hashcat Forums also contain a plethora of information.

Building

Refer to docs/BUILD.md for instructions on how to build oclHashcat from source.

Contributing

Contributions are welcome and encouraged, provided your code is of sufficient quality. Before submitting a pull request, please ensure your code adheres to the following requirements:

  1. Licensed under MIT license, or dedicated to public domain (BSD, GPL, etc. code is incompatible)
  2. Adheres to either C89, C90, or C99 standards
  3. Compiles cleanly with no warnings when compiled with -W -Wall -std=c99
  4. Uses Allman-style code blocks & indentation
  5. Uses 2-spaces as indentation or a tab if it's required (for example: Makefiles)
  6. Uses lower-case function and variable names
  7. Avoids the use of ! and uses positive conditionals wherever possible (e.g., if (foo == 0) instead of if (!foo), and if (foo) instead of if (foo !=0))
  8. Use code like array[index + 0] if you also need to do array[index + 1], to keep it aligned

You can use GNU Indent to help assist you with the style requirements:

indent -st -bad -bap -sc -bl -bli0 -ncdw -nce -cli0 -cbi0 -pcs -cs -npsl -bs -nbc -bls -blf -lp -i2 -ts2 -nut -l1024 -nbbo -fca -lc1024 -fc1

Your pull request should fully describe the functionality you are adding/removing or the problem you are solving. Regardless of whether your patch modifies one line or one thousand lines, you must describe what has prompted and/or motivated the change.

Solve only one problem in each pull request. If you're fixing a bug and adding a new feature, you need to make two separate pull requests. If you're fixing three bugs, you need to make three separate pull requests. If you're adding four new features, you need to make four separate pull requests. So on, and so forth.

If your patch fixes a bug, please be sure there is an issue open for the bug before submitting a pull request. If your patch aims to improve performance or optimizes an algorithm, be sure to quantify your optimizations and document the trade-offs, and back up your claims with benchmarks and metrics.

In order to maintain the quality and integrity of the oclHashcat source tree, all pull requests must be reviewed and signed off by at least two board members before being merged. The project lead has the ultimate authority in deciding whether to accept or reject a pull request. Do not be discouraged if your pull request is rejected!

Happy Cracking!