annotate Doc/lib/libcrypt.tex @ 5817:48b94de85bf3 legacy-trunk

Extensive changes by AMK.
author Guido van Rossum <guido@python.org>
date Thu, 17 Jul 1997 16:29:42 +0000
parents b218f294b726
children 3468ea8645ca
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
1 \section{Built-in module {\tt crypt}}
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
2 \bimodindex{crypt}
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
3
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
4 This module implements an interface to the crypt({\bf 3}) routine,
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
5 which is a one-way hash function based upon a modified DES algorithm;
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
6 see the Unix man page for further details. Possible uses include
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
7 allowing Python scripts to accept typed passwords from the user, or
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
8 attempting to crack Unix passwords with a dictionary.
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
9 \index{crypt(3)}
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
10
4728
b218f294b726 (lib<all sorts of stuff>.tex):
Fred Drake <fdrake@acm.org>
parents: 3509
diff changeset
11 \renewcommand{\indexsubitem}{(in module crypt)}
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
12 \begin{funcdesc}{crypt}{word\, salt}
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
13 \var{word} will usually be a user's password. \var{salt} is a
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
14 2-character string which will be used to select one of 4096 variations
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
15 of DES. The characters in \var{salt} must be either \code{.},
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
16 \code{/}, or an alphanumeric character. Returns the hashed password
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
17 as a string, which will be composed of characters from the same
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
18 alphabet as the salt.
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
19 \end{funcdesc}
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
20
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
21 The module and documentation were written by Steve Majewski.
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
22 \index{Majewski, Steve}