NAME

mp64 - high-performance word generator with a per-position configurable charset

SYNOPSIS

mp64 [options]... mask

DESCRIPTION

Maskprocessor is a fast word list generator. It enumerates all combinations from a given user-defined keyspace and outputs the results. Since it supports different alphabets (which also can be combined) at different positions in the generation template ('mask'), this approach allows a more fine-tunable generation of candidates than using 'naive' brute force enumeration of words. Masks are defined using the description also used in the Hashcat password recovery utility.

High-Performance word generator with a per-position configureable charset

* Startup:

-V, --version

Print version

-h, --help

Print help

* Increment:

-i, --increment=NUM:NUM

Enable increment mode. 1st NUM=start, 2nd NUM=stop Example: -i 4:8 searches lengths 4-8 (inclusive)

* Misc:

--combinations

Calculate number of combinations

--hex-charset

Assume charset is given in hex

-q, --seq-max=NUM

Maximum number of multiple sequential characters

-r, --occurrence-max=NUM

Maximum number of occurrence of a character

* Resources:

-s, --start-at=WORD

Start at specific position

-l, --stop-at=WORD

Stop at specific position

* Files:

-o, --output-file=FILE

Output-file

* Custom charsets:

-1, --custom-charset1=CS

User-defineable charsets

-2, --custom-charset2=CS

Example:

-3, --custom-charset3=CS --custom-charset1=?dabcdef

-4, --custom-charset4=CS

sets charset ?1 to 0123456789abcdef

* Built-in charsets:

?l = abcdefghijklmnopqrstuvwxyz ?u = ABCDEFGHIJKLMNOPQRSTUVWXYZ ?d = 0123456789 ?s = !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~ ?a = ?l?u?d?s ?b = 0x00 - 0xff

MASKS

For each position of the generated password candidates we need to configure a placeholder. If a password we want to crack has the length 8, our mask must consist of 8 placeholders. A mask is a simple string that configures the keyspace of the password candidate engine using placeholders. A placeholder can be either a custom charset variable, a built-in charset variable or a static letter. A variable is indicated by the ? letter followed by one of the built-in charset (l, u, d, s, a) or one of the custom charset variable names (1, 2, 3, 4). A static letter is not indicated by a letter. An exception is if we want the static letter ? itself, which must be written as ??.

BUILTIN CHARSETS

?l = abcdefghijklmnopqrstuvwxyz, ?u = ABCDEFGHIJKLMNOPQRSTUVWXYZ, ?d = 0123456789, ?s = (space)!"#$%&'()*+,-./:;<=>?@[]^_`{|}~, ?a = ?l?u?d?s, ?b = 0x00-0xff

CUSTOM CHARSETS

There are four command line parameters to configure four custom charsets: --custom-charset1=CS, --custom-charset2=CS, --custom-charset3=CS, --custom-charset4=CS.

These command line parameters have four analogous shortcuts called -1, -2, -3 and -4. You can specify the chars directly on the command line.

PASSWORD LENGTH INCREMENT

A Mask attack is always specific to a password length. For example, if we use the mask ????l?l?l?l?l?l?l?l??? we can only crack a password of the length 8. But if the password we try to crack has the length 7 we will not find it. That is why we have to repeat the attack several times, each time with one placeholder added to the mask. This is transparently automated by using the '--increment' flag.

?l -> ?l?l -> ?l?l?l -> ?l?l?l?l -> ?l?l?l?l?l -> ?l?l?l?l?l?l -> ?l?l?l?l?l?l?l -> ?l?l?l?l?l?l?l?l

REPORTING BUGS

Please report bugs upstream to the maskprocessor issue tracker on GitHub: https://github.com/hashcat/maskprocessor/issues

COPYRIGHT

This tool is developed and maintained by Jens Steube under the MIT License.