annotate Doc/lib/libcrypt.tex @ 10123:bc287c6cfa23 legacy-trunk

Restructured a bit.
author Guido van Rossum <guido@python.org>
date Mon, 08 Feb 1999 22:27:18 +0000
parents acfffe14628e
children 61224459bb09
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
8918
acfffe14628e New section header style.
Fred Drake <fdrake@acm.org>
parents: 8716
diff changeset
1 \section{\module{crypt} ---
acfffe14628e New section header style.
Fred Drake <fdrake@acm.org>
parents: 8716
diff changeset
2 The \cfunction{crypt()} function used to check \UNIX{} passwords.}
8716
760dcf197048 Adjusted to use the new module synopsis support macros.
Fred Drake <fdrake@acm.org>
parents: 7877
diff changeset
3 \declaremodule{builtin}{crypt}
760dcf197048 Adjusted to use the new module synopsis support macros.
Fred Drake <fdrake@acm.org>
parents: 7877
diff changeset
4
760dcf197048 Adjusted to use the new module synopsis support macros.
Fred Drake <fdrake@acm.org>
parents: 7877
diff changeset
5 \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
6
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
7
7341
0069f3eba9a2 Use \manpage{} markup for referencing a UNIX man page.
Fred Drake <fdrake@acm.org>
parents: 7277
diff changeset
8 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
9 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
10 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
11 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
12 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
13 \index{crypt(3)}
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
14
7712
0cbc9df882b6 Change "\," to just "," in function signatures. This is easier to maintain,
Fred Drake <fdrake@acm.org>
parents: 7341
diff changeset
15 \begin{funcdesc}{crypt}{word, salt}
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
16 \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
17 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
18 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
19 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
20 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
21 the same alphabet as the salt.
3509
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
22 \end{funcdesc}
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
23
558dce6553d9 Added lost docs for crypt module.
Guido van Rossum <guido@python.org>
parents:
diff changeset
24 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
25 \index{Majewski, Steve}