1
mirror of https://github.com/hashcat/hashcat synced 2024-12-01 20:18:12 +01:00
hashcat/tools/test_modules
R. Yushaev 444d11a74b Add test modules
Add tests for modes 0, 100, 110, 120, 18400, 18600. Update readme.
2018-12-20 19:18:06 +01:00
..
m0.pm Add test modules 2018-12-20 19:18:06 +01:00
m100.pm Add test modules 2018-12-20 19:18:06 +01:00
m110.pm Add test modules 2018-12-20 19:18:06 +01:00
m120.pm Add test modules 2018-12-20 19:18:06 +01:00
m18400.pm Add test modules 2018-12-20 19:18:06 +01:00
m18600.pm Add test modules 2018-12-20 19:18:06 +01:00
README.md Add test modules 2018-12-20 19:18:06 +01:00

Hashcat test modules

Each module provides the two functions module_generate_hash and module_verify_hash. The first parameter to module_generate_hash is the password, which can be either in ASCII or binary (packed) form. The module_verify_hash function accepts a line from the cracks file, without the newline characters.

During single and passthrough tests the module_generate_hash function must provide random values (e.g. salt) for hash generation if necessary. The test.pl script offers a few handy functions like random_hex_string, random_numeric_string and random_bytes. You can implement your own salt generation functions, if your mode has specific requirements.

During verify tests the module_verify_hash function must parse the hash:password line and to calculate a hash by passing all necessary data to module_generate_hash. How you pass it is up to you, as long as the first parameter is the password.

Important: You have to call pack_if_HEX_notation as soon as you have parsed the password, or your tests will fail on passwords in the $HEX[...] format.

Examples