summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libcrypt.tex
diff options
context:
space:
mode:
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}