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.