- Second time's the charm? Moving svnroot/ircd-hybrid-8 to

  svnroot/ircd-hybrid/trunk


git-svn-id: svn://svn.ircd-hybrid.org/svnroot/ircd-hybrid/trunk@1592 82007160-df01-0410-b94d-b575c5fd34c7

1 files changed, 50 insertions, 0 deletions

diff --git a/tools/README.mkpasswd b/tools/README.mkpasswd
new file mode 100644
index 0000000..3c179da
--- /dev/null
+++ b/tools/README.mkpasswd
@@ -0,0 +1,50 @@
+$Id$
+
+This is documentation for the mkpasswd.c included in ircd-hybrid-8.
+
+This version of mkpasswd can create both DES and MD5 passwords, with
+either randomly generated or user provided salts.  
+
+Options:
+-6 - Create a SHA-512 password
+-5 - Create a SHA-256 password
+-m - Create an MD5 password
+-b - Create a BlowFish password
+-d - Create a DES password
+-e - Create an Extended DES password
+-l - Specify the length of a random MD5 salt
+-r - Specify a number of rounds for a BlowFish or Extended DES password
+-p - Specify the plaintext password at the command line
+-s - Specify the salt at the command line
+-R - Specify a raw salt passed directly to crypt()
+-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.
+
+Supported Platforms (Known and tested):
+Linux glibc (SHA since glibc 2.7, 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.