tools/README.mkpasswd

   1 mkpasswd.c documentation
   2
   3 This is documentation for the updated mkpasswd.c included with a number
   4 of ircd, irc services, and non-IRC related programs
   5
   6 This version of mkpasswd can create Blowfish, MD5, SHA256, and SHA512 crypted
   7 passwords, with either randomly generated or user provided salts.
   8
   9 Options:
  10 -x Generate a SHA256 password
  11 -y Generate a SHA512 password
  12 -m Generate an MD5 password
  13 -b Generate a Blowfish password
  14 -l Specify a length for a random MD5 or Blowfish salt
  15 -r Specify a number of rounds for a Blowfish password
  16    Default 4, no more than 6 recommended
  17 -s Specify a salt, up to 16 for MD5, SHA256, and SHA512
  18    up to 22 for Blowfish
  19 -p Specify a plaintext password to use
  20 -? Get brief help
  21 -h Get extended help
  22
  23 Without the presence of any parameters, it'll generate a SHA512 hash with a
  24 randomly generated salt and prompting for the password (without echo).
  25
  26 An MD5, SHA256, and SHA512 salt consists of up to 16 alphanumeric characters
  27 (plus '.' and '/'), such as 'tGd' or 'J6d4dfG'.
  28
  29 A Blowfish salt consists of up to 22 alphanumeric characters (plus '.' and
  30 '/').  Blowfish also specifies a number of rounds*, by default 4.
  31
  32 Blowfish may not always be available, but MD5, SHA256, and SHA512 are
  33 guaranteed to be.
  34
  35 This program should work anywhere Solanum does; if you find otherwise, file
  36 a bug.
  37
  38  * Blowfish's rounds parameter is a logarithm, not an integer value