Bell 32V development

Work on file usr/man/man8/makekey.8

Co-Authored-By: John Reiser <jfr@research.uucp>
Synthesized-from: 32v

diff --git a/usr/man/man8/makekey.8 b/usr/man/man8/makekey.8
new file mode 100644 (file)
index 0000000..39f96a7
--- /dev/null
+++ b/usr/man/man8/makekey.8
@@ -0,0 +1,49 @@
+.TH MAKEKEY 8 
+.SH NAME
+makekey \- generate encryption key
+.SH SYNOPSIS
+.B /usr/lib/makekey
+.SH DESCRIPTION
+.I Makekey
+improves the usefulness of encryption schemes
+depending on a key by increasing the amount of time required to
+search the key space.
+It reads 10 bytes from its standard input,
+and writes 13 bytes on its standard output.
+The output depends on the input in a way intended
+to be difficult to compute (i.e. to require a substantial
+fraction of a second).
+.PP
+The first eight input bytes
+(the
+.IR "input key" )
+can be arbitrary ASCII characters.
+The last 
+two (the
+.IR salt )
+are best chosen from the set of digits, upper- and lower-case
+letters, and `.' and `/'.
+The salt characters are repeated as the first two characters of the output.
+The remaining 11 output characters are chosen from the same set as the salt
+and constitute the
+.I "output key."
+.PP
+The transformation performed is essentially the following:
+the salt is used to select one of 4096 cryptographic
+machines all based on the National Bureau of Standards
+DES algorithm, but modified in 4096 different ways.
+Using the input key as key,
+a constant string is fed into the machine and recirculated
+a number of times.
+The 64 bits that come out are distributed into the
+66 useful key bits in the result.
+.PP
+.I Makekey
+is intended for programs that perform encryption
+(e.g.
+.I ed
+and
+.IR crypt (1)).
+Usually its input and output will be pipes.
+.SH SEE ALSO
+crypt(1), ed(1)