1 03/05/84  encode
 2 
 3 Syntax:  encode path1A {path2A ... path1N path2N} {-control_args}
 4 
 5 
 6 Function: enciphers a segment's contents according to a key that is
 7 not stored in the system.
 8 
 9 
10 Arguments:
11 path1N
12    is the pathname of a segment to be enciphered.  The star convention
13    is allowed.
14 path2N
15    is the pathname of an enciphered segment to be produced.  If the
16    last path2 is omitted, it is assumed to be the same as path1.  The
17    equal convention is allowed.  The code suffix is always appended to
18    path2.
19 
20 
21 Control arguments:
22 -key STR
23    specifies the encipherment key STR on the command line and does not
24    query for one. This control argument is useful in exec_com's for
25    multiple invocations of the command with the same key.
26 
27 
28 Notes: The enciphered segment has the same length as the original
29 segment.  The encode command requests an encipherment key (from one to
30 11 characters not including space, semicolon, or tab).  Printing on
31 the terminal is suppressed while the key is typed.  The command then
32 requests that the key be typed again, to guard against the possibility
33 of mistyping the key.  If the two keys do not match, the key is
34 requested twice again.  All segments specified in an invocation of
35 encode are enciphered with the same key.