]>
Commit | Line | Data |
---|---|---|
212380e3 AC |
1 | mkpasswd.c documentation |
2 | $Id: README.mkpasswd 6 2005-09-10 01:02:21Z nenolod $ | |
3 | ||
4 | This is documentation for the updated mkpasswd.c included with a number | |
5 | of ircd, irc services, and non-IRC related programs | |
6 | ||
7 | This version of mkpasswd can create DES, Extended DES, BlowFish, and MD5 | |
8 | passwords, with either randomly generated or user provided salts. | |
9 | ||
10 | Options: | |
11 | -m Generate an MD5 password | |
12 | -d Generate a DES password | |
13 | -b Generate a BlowFish password | |
14 | -e Generate an Extended (BSDi) DES password | |
15 | -l Specify a length for a random MD5 or BlowFish salt | |
16 | -r Specify a number of rounds for a BlowFish or Extended DES password | |
17 | BlowFish: no more than 6 recommended, no less than 4 accepted | |
18 | Extended DES: default of 25 | |
19 | -s Specify a salt, 2 alphanumeric characters for DES, up to 16 for MD5, | |
20 | up to 22 for BlowFish, 2 for Extended DES | |
21 | -p Specify a plaintext password to use | |
22 | -? Get brief help | |
23 | -h Get extended help | |
24 | ||
25 | Without the presence of any parameters, it'll behave like the old mkpasswd, | |
26 | creating a DES password with a randomly generated salt and prompting for | |
27 | the password (without echo). | |
28 | ||
29 | A DES salt is a pair of alphanumeric characters ('.' and '/' are permitted | |
30 | as well), such as 'a4' or 'Td'. | |
31 | ||
32 | An MD5 salt consists of up to 16 (though most implementations limit you to | |
33 | 8) alphanumeric characters (plus '.' and '/'), | |
34 | such as 'tGd' or 'J6d4dfG'. | |
35 | ||
36 | A BlowFish salt consists of up to 22 alphanumeric characters (plus '.' and | |
37 | '/'). BlowFish also specifies a number of rounds*, by default 4. | |
38 | ||
39 | Known bugs: | |
40 | The encryption algorithms supported depend on your system's crypt() | |
41 | implementation. | |
42 | The maximum length of an MD5 salt is limited to your systems crypt() | |
43 | implementation, typically 8. | |
44 | ||
45 | Supported Platforms (Known and tested): | |
46 | Linux glibc (DES and MD5) | |
47 | FreeBSD 3.x (DES (MD5 maybe)) | |
48 | FreeBSD 4.x (DES, MD5, BlowFish, Extended DES) | |
49 | Solaris 2.5-2.6 (DES only) | |
50 | Cygwin 1.1.4 (DES only) | |
51 | Prior Cygwin with the MD5 libcrypt (MD5 only) | |
52 | OpenBSD 2.7 (don't link with -lcrypt) (DES, MD5, Blowfish) | |
53 | Mac OS-X (Darwin) (don't link with -lcrypt) (DES only) | |
54 | ||
55 | An MMK build script is included, as well as an MD5 crypt() implementation | |
56 | ||
57 | Other systems probably work, but they haven't been amply tested. | |
58 | ||
59 | * BlowFish's rounds parameter is a logarithm, not an integer value |