| | 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 |
projects / solanum.git / blame_incremental