8.1.x/tools/README.mkpasswd

mkpasswd.c documentation
$Id: README.mkpasswd,v 1.6 2005/04/24 12:43:09 michael Exp $

This is documentation for the mkpasswd.c included in ircd-hybrid-7.

This version of mkpasswd can create both DES and MD5 passwords, with
either randomly generated or user provided salts.  

Options:
-m - Create an MD5 password
-d - Create a DES password
-l - Specify the length of a random MD5 salt
-p - Specify the plaintext password at the command line
-s - Specify the salt at the command line
-h - Get help

Without the presence of any parameters, it'll behave like the old mkpasswd,
creating a DES password with a randomly generated salt and prompting for
the password (without echo).

A DES salt is a pair of alphanumeric characters ('.' and '/' are permitted
as well), such as 'a4' or 'Td'.

An MD5 salt consists of up to 16 (though most implementations limit you to
8) alphanumeric characters (plus '.' and '/'),
such as 'tGd' or 'J6d4dfG'.

Known bugs:
Blowfish (on OpenBSD) is not yet supported
The encryption algorithms supported depend on your system's crypt()
  implementation.
The maximum length of an MD5 salt is limited to your systems crypt()
  implementation, typically 8.
crypt.c (MD5 implementation) is included, but not yet compiled into the
  program for systems that do not support MD5.

Supported Platforms (Known and tested):
Linux glibc (DES and MD5)
FreeBSD 3.x (DES (MD5 maybe))
FreeBSD 4.x (DES and MD5)
Solaris 2.5-2.6 (DES only)
Cygwin 1.1.4 (DES only)
Prior Cygwin with the MD5 libcrypt (MD5 only)
OpenBSD 2.7 (don't link with -lcrypt) (DES and MD5, no Blowfish support)
Mac OS-X (Darwin) (don't link with -lcrypt) (DES only)

Other systems probably work, but they haven't been amply tested.
Revision:	30
Committed:	Sun Oct 2 20:03:27 2005 UTC (20 years, 9 months ago) by adx
Original Path:	*ircd-hybrid/tools/README.mkpasswd*
File size:	1712 byte(s)
Log Message:	- imported sources - can be moved later according to the directory/branching scheme, but we need the svn up
#	User	Rev	Content
1	adx	30	mkpasswd.c documentation
2			$Id: README.mkpasswd,v 1.6 2005/04/24 12:43:09 michael Exp $
3
4			This is documentation for the mkpasswd.c included in ircd-hybrid-7.
5
6			This version of mkpasswd can create both DES and MD5 passwords, with
7			either randomly generated or user provided salts.
8
9			Options:
10			-m - Create an MD5 password
11			-d - Create a DES password
12			-l - Specify the length of a random MD5 salt
13			-p - Specify the plaintext password at the command line
14			-s - Specify the salt at the command line
15			-h - Get help
16
17			Without the presence of any parameters, it'll behave like the old mkpasswd,
18			creating a DES password with a randomly generated salt and prompting for
19			the password (without echo).
20
21			A DES salt is a pair of alphanumeric characters ('.' and '/' are permitted
22			as well), such as 'a4' or 'Td'.
23
24			An MD5 salt consists of up to 16 (though most implementations limit you to
25			8) alphanumeric characters (plus '.' and '/'),
26			such as 'tGd' or 'J6d4dfG'.
27
28			Known bugs:
29			Blowfish (on OpenBSD) is not yet supported
30			The encryption algorithms supported depend on your system's crypt()
31			implementation.
32			The maximum length of an MD5 salt is limited to your systems crypt()
33			implementation, typically 8.
34			crypt.c (MD5 implementation) is included, but not yet compiled into the
35			program for systems that do not support MD5.
36
37			Supported Platforms (Known and tested):
38			Linux glibc (DES and MD5)
39			FreeBSD 3.x (DES (MD5 maybe))
40			FreeBSD 4.x (DES and MD5)
41			Solaris 2.5-2.6 (DES only)
42			Cygwin 1.1.4 (DES only)
43			Prior Cygwin with the MD5 libcrypt (MD5 only)
44			OpenBSD 2.7 (don't link with -lcrypt) (DES and MD5, no Blowfish support)
45			Mac OS-X (Darwin) (don't link with -lcrypt) (DES only)
46
47			Other systems probably work, but they haven't been amply tested.