Added lost docs for crypt module.

6 files changed, 50 insertions, 0 deletions

diff --git a/Doc/lib.tex b/Doc/lib.tex
index dad66dd..513f81a 100644
--- a/Doc/lib.tex
+++ b/Doc/lib.tex
@@ -116,6 +116,7 @@ to Python and how to embed it in other applications.
 \input{libppath}		% == posixpath
 \input{libpwd}
 \input{libgrp}
+\input{libcrypt}
 \input{libdbm}
 \input{libgdbm}
 \input{libtermios}
diff --git a/Doc/lib/lib.tex b/Doc/lib/lib.tex
index dad66dd..513f81a 100644
--- a/Doc/lib/lib.tex
+++ b/Doc/lib/lib.tex
@@ -116,6 +116,7 @@ to Python and how to embed it in other applications.
 \input{libppath}		% == posixpath
 \input{libpwd}
 \input{libgrp}
+\input{libcrypt}
 \input{libdbm}
 \input{libgdbm}
 \input{libtermios}
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}
diff --git a/Doc/lib/libunix.tex b/Doc/lib/libunix.tex
index fe92d97..895c6e5 100644
--- a/Doc/lib/libunix.tex
+++ b/Doc/lib/libunix.tex
@@ -18,6 +18,9 @@ some or many variants of it.  Here's an overview:
 \item[grp]
 --- The group database (\code{getgrnam()} and friends).
 
+\item[crypt]
+--- The (\code{crypt()} function used to check Unix passwords).
+
 \item[dbm]
 --- The standard ``database'' interface, based on \code{ndbm}.
 
diff --git a/Doc/libcrypt.tex b/Doc/libcrypt.tex
new file mode 100644
index 0000000..e44f7b2
--- /dev/null
+++ b/Doc/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}
diff --git a/Doc/libunix.tex b/Doc/libunix.tex
index fe92d97..895c6e5 100644
--- a/Doc/libunix.tex
+++ b/Doc/libunix.tex
@@ -18,6 +18,9 @@ some or many variants of it.  Here's an overview:
 \item[grp]
 --- The group database (\code{getgrnam()} and friends).
 
+\item[crypt]
+--- The (\code{crypt()} function used to check Unix passwords).
+
 \item[dbm]
 --- The standard ``database'' interface, based on \code{ndbm}.