annotate Doc/lib/libcrypt.tex @ 8831:00a6bb65ff29 legacy-trunk

Getting rid of this ancient stuff.
author Guido van Rossum <guido@python.org>
date Wed, 05 Aug 1998 21:10:09 +0000
parents 760dcf197048
children acfffe14628e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7877
8e5223680a9d Remove all uses of \sectcode; we can now use logical markup everywhere.
Fred Drake <fdrake@acm.org>
parents: 7873
diff changeset
1 \section{Built-in Module \module{crypt}}
8716
760dcf197048 Adjusted to use the new module synopsis support macros.
Fred Drake <fdrake@acm.org>
parents: 7877
diff changeset
2 \declaremodule{builtin}{crypt}
760dcf197048 Adjusted to use the new module synopsis support macros.
Fred Drake <fdrake@acm.org>
parents: 7877
diff changeset
3
760dcf197048 Adjusted to use the new module synopsis support macros.
Fred Drake <fdrake@acm.org>
parents: 7877
diff changeset
4 \modulesynopsis{The \cfunction{crypt()} function used to check \UNIX{} passwords.}
760dcf197048 Adjusted to use the new module synopsis support macros.
Fred Drake <fdrake@acm.org>
parents: 7877
diff changeset
5
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
6
7341
0069f3eba9a2 Use \manpage{} markup for referencing a UNIX man page.
Fred Drake <fdrake@acm.org>
parents: 7277
diff changeset
7 This module implements an interface to the \manpage{crypt}{3} routine,
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
8 which is a one-way hash function based upon a modified DES algorithm;
6959
fedbf9325190 Normalized the word "Unix" to "\UNIX{}".
Fred Drake <fdrake@acm.org>
parents: 5818
diff changeset
9 see the \UNIX{} man page for further details. Possible uses include
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
10 allowing Python scripts to accept typed passwords from the user, or
6959
fedbf9325190 Normalized the word "Unix" to "\UNIX{}".
Fred Drake <fdrake@acm.org>
parents: 5818
diff changeset
11 attempting to crack \UNIX{} passwords with a dictionary.
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
12 \index{crypt(3)}
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
13
7712
0cbc9df882b6 Change "\," to just "," in function signatures. This is easier to maintain,
Fred Drake <fdrake@acm.org>
parents: 7341
diff changeset
14 \begin{funcdesc}{crypt}{word, salt}
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
15 \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
16 2-character string which will be used to select one of 4096 variations
7341
0069f3eba9a2 Use \manpage{} markup for referencing a UNIX man page.
Fred Drake <fdrake@acm.org>
parents: 7277
diff changeset
17 of DES\indexii{cipher}{DES}. The characters in \var{salt} must be
0069f3eba9a2 Use \manpage{} markup for referencing a UNIX man page.
Fred Drake <fdrake@acm.org>
parents: 7277
diff changeset
18 either \code{.}, \code{/}, or an alphanumeric character. Returns the
0069f3eba9a2 Use \manpage{} markup for referencing a UNIX man page.
Fred Drake <fdrake@acm.org>
parents: 7277
diff changeset
19 hashed password as a string, which will be composed of characters from
0069f3eba9a2 Use \manpage{} markup for referencing a UNIX man page.
Fred Drake <fdrake@acm.org>
parents: 7277
diff changeset
20 the same alphabet as the salt.
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
21 \end{funcdesc}
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
22
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
23 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
24 \index{Majewski, Steve}