text: /**
   * Author......: See docs/credits.txt
   * License.....: MIT
   */
  
  #include "common.h"
  #include "types.h"
  #include "memory.h"
  #include "shared.h"
  #include "interface.h"
  #include "usage.h"
  
  static const char *const USAGE_MINI[] =
  {
    "Usage: hashcat [options]... hash|hashfile|hccapxfile [dictionary|mask|directory]...",
    "",
    "Try --help for more help.",
    NULL
  };
  
  static const char *const USAGE_BIG_PRE_HASHMODES[] =
  {
    "Usage: hashcat [options]... hash|hashfile|hccapxfile [dictionary|mask|directory]...",
    "",
    "- [ Options ] -",
    "",
    " Options Short / Long           | Type | Description                                          | Example",
    "================================+======+======================================================+=======================",
    " -m, --hash-type                | Num  | Hash-type, see references below                      | -m 1000",
    " -a, --attack-mode              | Num  | Attack-mode, see references below                    | -a 3",
    " -V, --version                  |      | Print version                                        |",
    " -h, --help                     |      | Print help                                           |",
    "     --quiet                    |      | Suppress output                                      |",
    "     --hex-charset              |      | Assume charset is given in hex                       |",
    "     --hex-salt                 |      | Assume salt is given in hex                          |",
    "     --hex-wordlist             |      | Assume words in wordlist are given in hex            |",
    "     --force                    |      | Ignore warnings                                      |",
    "     --status                   |      | Enable automatic update of the status screen         |",
    "     --status-json              |      | Enable JSON format for status ouput                  |",
    "     --status-timer             | Num  | Sets seconds between status screen updates to X      | --status-timer=1",
    "     --stdin-timeout-abort      | Num  | Abort if there is no input from stdin for X seconds  | --stdin-timeout-abort=300",
    "     --machine-readable         |      | Display the status view in a machine-readable format |",
    "     --keep-guessing            |      | Keep guessing the hash after it has been cracked     |",
    "     --self-test-disable        |      | Disable self-test functionality on startup           |",
    "     --loopback                 |      | Add new plains to induct directory                   |",
    "     --markov-hcstat2           | File | Specify hcstat2 file to use                          | --markov-hcstat2=my.hcstat2",
    "     --markov-disable           |      | Disables markov-chains, emulates classic brute-force |",
    "     --markov-classic           |      | Enables classic markov-chains, no per-position       |",
    " -t, --markov-threshold         | Num  | Threshold X when to stop accepting new markov-chains | -t 50",
    "     --runtime                  | Num  | Abort session after X seconds of runtime             | --runtime=10",
    "     --session                  | Str  | Define specific session name                         | --session=mysession",
    "     --restore                  |      | Restore session from --session                       |",
    "     --restore-disable          |      | Do not write restore file                            |",
    "     --restore-file-path        | File | Specific path to restore file                        | --restore-file-path=x.restore",
    " -o, --outfile                  | File | Define outfile for recovered hash                    | -o outfile.txt",
    "     --outfile-format           | Str  | Outfile format to use, separated with commas         | --outfile-format=1,3",
    "     --outfile-autohex-disable  |      | Disable the use of $HEX[] in output plains           |",
    "     --outfile-check-timer      | Num  | Sets seconds between outfile checks to X             | --outfile-check=30",
    "     --wordlist-autohex-disable |      | Disable the conversion of $HEX[] from the wordlist   |",
    " -p, --separator                | Char | Separator char for hashlists and outfile             | -p :",
    "     --stdout                   |      | Do not crack a hash, instead print candidates only   |",
    "     --show                     |      | Compare hashlist with potfile; show cracked hashes   |",
    "     --left                     |      | Compare hashlist with potfile; show uncracked hashes |",
    "     --username                 |      | Enable ignoring of usernames in hashfile             |",
    "     --remove                   |      | Enable removal of hashes once they are cracked       |",
    "     --remove-timer             | Num  | Update input hash file each X seconds                | --remove-timer=30",
    "     --potfile-disable          |      | Do not write potfile                                 |",
    "     --potfile-path             | File | Specific path to potfile                             | --potfile-path=my.pot",
    "     --encoding-from            | Code | Force internal wordlist encoding from X              | --encoding-from=iso-8859-15",
    "     --encoding-to              | Code | Force internal wordlist encoding to X                | --encoding-to=utf-32le",
    "     --debug-mode               | Num  | Defines the debug mode (hybrid only by using rules)  | --debug-mode=4",
    "     --debug-file               | File | Output file for debugging rules                      | --debug-file=good.log",
    "     --induction-dir            | Dir  | Specify the induction directory to use for loopback  | --induction=inducts",
    "     --outfile-check-dir        | Dir  | Specify the outfile directory to monitor for plains  | --outfile-check-dir=x",
    "     --logfile-disable          |      | Disable the logfile                                  |",
    "     --hccapx-message-pair      | Num  | Load only message pairs from hccapx matching X       | --hccapx-message-pair=2",
    "     --nonce-error-corrections  | Num  | The BF size range to replace AP's nonce last bytes   | --nonce-error-corrections=16",
    "     --keyboard-layout-mapping  | File | Keyboard layout mapping table for special hash-modes | --keyb=german.hckmap",
    "     --truecrypt-keyfiles       | File | Keyfiles to use, separated with commas               | --truecrypt-keyf=x.png",
    "     --veracrypt-keyfiles       | File | Keyfiles to use, separated with commas               | --veracrypt-keyf=x.txt",
    "     --veracrypt-pim-start      | Num  | VeraCrypt personal iterations multiplier start       | --veracrypt-pim-start=450",
    "     --veracrypt-pim-stop       | Num  | VeraCrypt personal iterations multiplier stop        | --veracrypt-pim-stop=500",
    " -b, --benchmark                |      | Run benchmark of selected hash-modes                 |",
    "     --benchmark-all            |      | Run benchmark of all hash-modes (requires -b)        |",
    "     --speed-only               |      | Return expected speed of the attack, then quit       |",
    "     --progress-only            |      | Return ideal progress step size and time to process  |",
    " -c, --segment-size             | Num  | Sets size in MB to cache from the wordfile to X      | -c 32",
    "     --bitmap-min               | Num  | Sets minimum bits allowed for bitmaps to X           | --bitmap-min=24",
    "     --bitmap-max               | Num  | Sets maximum bits allowed for bitmaps to X           | --bitmap-max=24",
    "     --cpu-affinity             | Str  | Locks to CPU devices, separated with commas          | --cpu-affinity=1,2,3",
    "     --hook-threads             | Num  | Sets number of threads for a hook (per compute unit) | --hook-threads=8",
    "     --example-hashes           |      | Show an example hash for each hash-mode              |",
    "     --backend-ignore-cuda      |      | Do not try to open CUDA interface on startup         |",
    "     --backend-ignore-opencl    |      | Do not try to open OpenCL interface on startup       |",
    " -I, --backend-info             |      | Show info about detected backend API devices         | -I",
    " -d, --backend-devices          | Str  | Backend devices to use, separated with commas        | -d 1",
    " -D, --opencl-device-types      | Str  | OpenCL device-types to use, separated with commas    | -D 1",
    " -O, --optimized-kernel-enable  |      | Enable optimized kernels (limits password length)    |",
    " -w, --workload-profile         | Num  | Enable a specific workload profile, see pool below   | -w 3",
    " -n, --kernel-accel             | Num  | Manual workload tuning, set outerloop step size to X | -n 64",
    " -u, --kernel-loops             | Num  | Manual workload tuning, set innerloop step size to X | -u 256",
    " -T, --kernel-threads           | Num  | Manual workload tuning, set thread count to X        | -T 64",
    "     --backend-vector-width     | Num  | Manually override backend vector-width to X          | --backend-vector=4",
    "     --spin-damp                | Num  | Use CPU for device synchronization, in percent       | --spin-damp=10",
    "     --hwmon-disable            |      | Disable temperature and fanspeed reads and triggers  |",
    "     --hwmon-temp-abort         | Num  | Abort if temperature reaches X degrees Celsius       | --hwmon-temp-abort=100",
    "     --scrypt-tmto              | Num  | Manually override TMTO value for scrypt to X         | --scrypt-tmto=3",
    " -s, --skip                     | Num  | Skip X words from the start                          | -s 1000000",
    " -l, --limit                    | Num  | Limit X words from the start + skipped words         | -l 1000000",
    "     --keyspace                 |      | Show keyspace base:mod values and quit               |",
    " -j, --rule-left                | Rule | Single rule applied to each word from left wordlist  | -j 'c'",
    " -k, --rule-right               | Rule | Single rule applied to each word from right wordlist | -k '^-'",
    " -r, --rules-file               | File | Multiple rules applied to each word from wordlists   | -r rules/best64.rule",
    " -g, --generate-rules           | Num  | Generate X random rules                              | -g 10000",
    "     --generate-rules-func-min  | Num  | Force min X functions per rule                       |",
    "     --generate-rules-func-max  | Num  | Force max X functions per rule                       |",
    "     --generate-rules-seed      | Num  | Force RNG seed set to X                              |",
    " -1, --custom-charset1          | CS   | User-defined charset ?1                              | -1 ?l?d?u",
    " -2, --custom-charset2          | CS   | User-defined charset ?2                              | -2 ?l?d?s",
    " -3, --custom-charset3          | CS   | User-defined charset ?3                              |",
    " -4, --custom-charset4          | CS   | User-defined charset ?4                              |",
    " -i, --increment                |      | Enable mask increment mode                           |",
    "     --increment-min            | Num  | Start mask incrementing at X                         | --increment-min=4",
    "     --increment-max            | Num  | Stop mask incrementing at X                          | --increment-max=8",
    " -S, --slow-candidates          |      | Enable slower (but advanced) candidate generators    |",
    #ifdef WITH_BRAIN
    "     --brain-server             |      | Enable brain server                                  |",
    "     --brain-server-timer       | Num  | Update the brain server dump each X seconds (min:60) | --brain-server-timer=300",
    " -z, --brain-client             |      | Enable brain client, activates -S                    |",
    "     --brain-client-features    | Num  | Define brain client features, see below              | --brain-client-features=3",
    "     --brain-host               | Str  | Brain server host (IP or domain)                     | --brain-host=127.0.0.1",
    "     --brain-port               | Port | Brain server port                                    | --brain-port=13743",
    "     --brain-password           | Str  | Brain server authentication password                 | --brain-password=bZfhCvGUSjRq",
    "     --brain-session            | Hex  | Overrides automatically calculated brain session     | --brain-session=0x2ae611db",
    "     --brain-session-whitelist  | Hex  | Allow given sessions only, separated with commas     | --brain-session-whitelist=0x2ae611db",
    #endif
    "",
    "- [ Hash modes ] -",
    "",
    "      # | Name                                             | Category",
    "  ======+==================================================+======================================",
    NULL
  };
  
  static const char *const USAGE_BIG_POST_HASHMODES[] =
  {
    #ifdef WITH_BRAIN
    "- [ Brain Client Features ] -",
    "",
    "  # | Features",
    " ===+========",
    "  1 | Send hashed passwords",
    "  2 | Send attack positions",
    "  3 | Send hashed passwords and attack positions",
    "",
    #endif
    "- [ Outfile Formats ] -",
    "",
    "  # | Format",
    " ===+========",
    "  1 | hash[:salt]",
    "  2 | plain",
    "  3 | hex_plain",
    "  4 | crack_pos",
    "  5 | timestamp absolute",
    "  6 | timestamp relative",
    "",
    "- [ Rule Debugging Modes ] -",
    "",
    "  # | Format",
    " ===+========",
    "  1 | Finding-Rule",
    "  2 | Original-Word",
    "  3 | Original-Word:Finding-Rule",
    "  4 | Original-Word:Finding-Rule:Processed-Word",
    "",
    "- [ Attack Modes ] -",
    "",
    "  # | Mode",
    " ===+======",
    "  0 | Straight",
    "  1 | Combination",
    "  3 | Brute-force",
    "  6 | Hybrid Wordlist + Mask",
    "  7 | Hybrid Mask + Wordlist",
    "",
    "- [ Built-in Charsets ] -",
    "",
    "  ? | Charset",
    " ===+=========",
    "  l | abcdefghijklmnopqrstuvwxyz",
    "  u | ABCDEFGHIJKLMNOPQRSTUVWXYZ",
    "  d | 0123456789",
    "  h | 0123456789abcdef",
    "  H | 0123456789ABCDEF",
    "  s |  !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~",
    "  a | ?l?u?d?s",
    "  b | 0x00 - 0xff",
    "",
    "- [ OpenCL Device Types ] -",
    "",
    "  # | Device Type",
    " ===+=============",
    "  1 | CPU",
    "  2 | GPU",
    "  3 | FPGA, DSP, Co-Processor",
    "",
    "- [ Workload Profiles ] -",
    "",
    "  # | Performance | Runtime | Power Consumption | Desktop Impact",
    " ===+=============+=========+===================+=================",
    "  1 | Low         |   2 ms  | Low               | Minimal",
    "  2 | Default     |  12 ms  | Economic          | Noticeable",
    "  3 | High        |  96 ms  | High              | Unresponsive",
    "  4 | Nightmare   | 480 ms  | Insane            | Headless",
    "",
    "- [ Basic Examples ] -",
    "",
    "  Attack-          | Hash- |",
    "  Mode             | Type  | Example command",
    " ==================+=======+==================================================================",
    "  Wordlist         | $P$   | hashcat -a 0 -m 400 example400.hash example.dict",
    "  Wordlist + Rules | MD5   | hashcat -a 0 -m 0 example0.hash example.dict -r rules/best64.rule",
    "  Brute-Force      | MD5   | hashcat -a 3 -m 0 example0.hash ?a?a?a?a?a?a",
    "  Combinator       | MD5   | hashcat -a 1 -m 0 example0.hash example.dict example.dict",
    "",
    "If you still have no idea what just happened, try the following pages:",
    "",
    "* https://hashcat.net/wiki/#howtos_videos_papers_articles_etc_in_the_wild",
    "* https://hashcat.net/faq/",
    NULL
  };
  
  typedef struct usage_sort
  {
    u32   hash_mode;
    char *hash_name;
    u32   hash_category;
  
  } usage_sort_t;
  
  static int sort_by_usage (const void *p1, const void *p2)
  {
    const usage_sort_t *u1 = (const usage_sort_t *) p1;
    const usage_sort_t *u2 = (const usage_sort_t *) p2;
  
    if (u1->hash_category > u2->hash_category) return  1;
    if (u1->hash_category < u2->hash_category) return -1;
  
    const int rc_name = strncmp (u1->hash_name + 1, u2->hash_name + 1, 15); // yes, strange...
  
    if (rc_name > 0) return  1;
    if (rc_name < 0) return -1;
  
    if (u1->hash_mode > u2->hash_mode) return  1;
    if (u1->hash_mode < u2->hash_mode) return -1;
  
    return 0;
  }
  
  void usage_mini_print (const char *progname)
  {
    for (int i = 0; USAGE_MINI[i] != NULL; i++)
    {
      printf (USAGE_MINI[i], progname);
  
      fwrite (EOL, strlen (EOL), 1, stdout);
    }
  }
  
  void usage_big_print (hashcat_ctx_t *hashcat_ctx)
  {
    const folder_config_t *folder_config = hashcat_ctx->folder_config;
    const hashconfig_t    *hashconfig    = hashcat_ctx->hashconfig;
          user_options_t  *user_options  = hashcat_ctx->user_options;
  
    char *modulefile = (char *) hcmalloc (HCBUFSIZ_TINY);
  
    usage_sort_t *usage_sort_buf = (usage_sort_t *) hccalloc (MODULE_HASH_MODES_MAXIMUM, sizeof (usage_sort_t));
  
    int usage_sort_cnt = 0;
  
    for (int i = 0; i < MODULE_HASH_MODES_MAXIMUM; i++)
    {
      user_options->hash_mode = i;
  
      module_filename (folder_config, i, modulefile, HCBUFSIZ_TINY);
  
      if (hc_path_exist (modulefile) == false) continue;
  
      const int rc = hashconfig_init (hashcat_ctx);
  
      if (rc == 0)
      {
        usage_sort_buf[usage_sort_cnt].hash_mode     = hashconfig->hash_mode;
        usage_sort_buf[usage_sort_cnt].hash_name     = hcstrdup (hashconfig->hash_name);
        usage_sort_buf[usage_sort_cnt].hash_category = hashconfig->hash_category;
  
        usage_sort_cnt++;
      }
  
      hashconfig_destroy (hashcat_ctx);
    }
  
    hcfree (modulefile);
  
    qsort (usage_sort_buf, usage_sort_cnt, sizeof (usage_sort_t), sort_by_usage);
  
    for (int i = 0; USAGE_BIG_PRE_HASHMODES[i] != NULL; i++)
    {
      printf ("%s", USAGE_BIG_PRE_HASHMODES[i]);
  
      fwrite (EOL, strlen (EOL), 1, stdout);
    }
  
    //hc_fwrite (EOL, strlen (EOL), 1, stdout);
  
    for (int i = 0; i < usage_sort_cnt; i++)
    {
      printf ("%7u | %-48s | %s", usage_sort_buf[i].hash_mode, usage_sort_buf[i].hash_name, strhashcategory (usage_sort_buf[i].hash_category));
  
      fwrite (EOL, strlen (EOL), 1, stdout);
    }
  
    fwrite (EOL, strlen (EOL), 1, stdout);
  
    for (int i = 0; i < usage_sort_cnt; i++)
    {
      hcfree (usage_sort_buf[i].hash_name);
    }
  
    hcfree (usage_sort_buf);
  
    for (int i = 0; USAGE_BIG_POST_HASHMODES[i] != NULL; i++)
    {
      printf ("%s", USAGE_BIG_POST_HASHMODES[i]);
  
      fwrite (EOL, strlen (EOL), 1, stdout);
    }
  
    fwrite (EOL, strlen (EOL), 1, stdout);
  }
  