]>
Commit | Line | Data |
---|---|---|
212380e3 | 1 | mkpasswd.c documentation |
212380e3 AC |
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 | ||
8522eb3b | 6 | This version of mkpasswd can create Blowfish, MD5, SHA256, and SHA512 crypted |
212380e3 AC |
7 | passwords, with either randomly generated or user provided salts. |
8 | ||
9 | Options: | |
8522eb3b EM |
10 | -x Generate a SHA256 password |
11 | -y Generate a SHA512 password | |
212380e3 | 12 | -m Generate an MD5 password |
69b2e745 | 13 | -b Generate a Blowfish password |
69b2e745 | 14 | -l Specify a length for a random MD5 or Blowfish salt |
8522eb3b EM |
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 | |
212380e3 AC |
19 | -p Specify a plaintext password to use |
20 | -? Get brief help | |
21 | -h Get extended help | |
22 | ||
8522eb3b EM |
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). | |
212380e3 | 25 | |
8522eb3b EM |
26 | An MD5, SHA256, and SHA512 salt consists of up to 16 alphanumeric characters |
27 | (plus '.' and '/'), such as 'tGd' or 'J6d4dfG'. | |
212380e3 | 28 | |
69b2e745 LS |
29 | A Blowfish salt consists of up to 22 alphanumeric characters (plus '.' and |
30 | '/'). Blowfish also specifies a number of rounds*, by default 4. | |
212380e3 | 31 | |
8522eb3b EM |
32 | Blowfish may not always be available, but MD5, SHA256, and SHA512 are |
33 | guaranteed to be. | |
212380e3 | 34 | |
8522eb3b EM |
35 | This program should work anywhere Charybdis does; if you find otherwise, file |
36 | a bug. | |
212380e3 | 37 | |
8522eb3b | 38 | * Blowfish's rounds parameter is a logarithm, not an integer value |