From 5c6e3738cd2179600c24bc1241eb5daa584ccc47 Mon Sep 17 00:00:00 2001 From: Guido van Rossum Date: Wed, 10 Apr 1996 16:18:20 +0000 Subject: Added lost docs for crypt module. --- Doc/lib.tex | 1 + Doc/lib/lib.tex | 1 + Doc/lib/libcrypt.tex | 21 +++++++++++++++++++++ Doc/lib/libunix.tex | 3 +++ Doc/libcrypt.tex | 21 +++++++++++++++++++++ Doc/libunix.tex | 3 +++ 6 files changed, 50 insertions(+) create mode 100644 Doc/lib/libcrypt.tex create mode 100644 Doc/libcrypt.tex 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}. -- cgit v0.12