summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libcrypt.tex
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1996-04-10 16:18:20 (GMT)
committerGuido van Rossum <guido@python.org>1996-04-10 16:18:20 (GMT)
commit5c6e3738cd2179600c24bc1241eb5daa584ccc47 (patch)
treea16e0bac90fc41188d12f6f39819e61e053b6580 /Doc/lib/libcrypt.tex
parent4bffb8b3b51e6111d62ec852ee7ebf179be9c9ad (diff)
downloadcpython-5c6e3738cd2179600c24bc1241eb5daa584ccc47.zip
cpython-5c6e3738cd2179600c24bc1241eb5daa584ccc47.tar.gz
cpython-5c6e3738cd2179600c24bc1241eb5daa584ccc47.tar.bz2
Added lost docs for crypt module.
Diffstat (limited to 'Doc/lib/libcrypt.tex')
-rw-r--r--Doc/lib/libcrypt.tex21
1 files changed, 21 insertions, 0 deletions
diff --git a/Doc/lib/libcrypt.tex b/Doc/lib/libcrypt.tex
new file mode 100644
index 0000000..e44f7b2
--- /dev/null
+++ b/Doc/lib/libcrypt.tex
@@ -0,0 +1,21 @@
+\section{Built-in module {\tt crypt}}
+\bimodindex{crypt}
+
+This module implements an interface to the crypt({\bf 3}) routine,
+which is a one-way hash function based upon a modified DES algorithm;
+see the Unix man page for further details. Possible uses include
+allowing Python scripts to accept typed passwords from the user, or
+attempting to crack Unix passwords with a dictionary.
+\index{crypt(3)}
+
+\begin{funcdesc}{crypt}{word\, salt}
+\var{word} will usually be a user's password. \var{salt} is a
+2-character string which will be used to select one of 4096 variations
+of DES. The characters in \var{salt} must be either \code{.},
+\code{/}, or an alphanumeric character. Returns the hashed password
+as a string, which will be composed of characters from the same
+alphabet as the salt.
+\end{funcdesc}
+
+The module and documentation were written by Steve Majewski.
+\index{Majewski, Steve}