README
1RESTRICTIONS FOR V1.2
2=====================
3
4UNIX: No restrictions.
5
6MS-DOS: MS-DOS pipes (|) can not be used to concatenate several user
7 commands 'idea'. The pipes are treated as a text-streams and not
8 as a binary-streams. Therefore they can not transmit encrypted
9 data.
10
11VMS: VMS translates all upper-case letters given on the command-line
12 to lower-case letters. Therefore the options 'K' and 'H' are not
13 accessible. Note that also key-strings are mapped to there
14 lower-case representation.
15
16
17FILES ON DISKETTE
18=================
19
20idea.c implementation of IDEA (International Data Encryption Algorithm)
21idea.h interface to 'idea.c'
22idea_cmd.c implementation of user command 'idea' (for UNIX, MS-DOS, VMS, ..)
23Makefile describes, how to build user command 'idea'
24
25idea.exe executable user-command 'idea' for MS-DOS
26
27idea.ps description of IDEA (dissertation of Xuejia Lai, chapter 3 only)
28byte_ord.ps description of byte-ordering used for IDEA
29idea_cmd.txt description of user command 'idea'
30manl/idea.l UNIX manual page of user command 'idea' (troff-format of
31 'idea_cmd.txt')
32massey.txt paper: Massey, J.L., "Some information about the IDEA cipher",
33 Sept. 11, 1995
34
35test1 used to check correctness of user command 'idea'.
36 output of 'test1' is 'out' and should be identical to 'Examples'.
37 type 'make test' to run this test
38in sample input data used by 'test1'
39dumphex.c little program used by 'test1'
40
41Examples examples of encrypted data
42README this documentation
43
44
45FTP-SERVER
46==========
47
48This software package can be obtained by executing the following commands:
49
50 [] ftp ftp.isi.ee.ethz.ch
51 Name: anonymous
52 Password: your_e-mail_address
53 cd pub/simpl
54 binary
55 get idea.V1.2.tar.Z
56 quit
57 [] uncompress idea.V1.2.tar.Z
58 [] tar -xf idea.V1.2.tar
59 [] cd idea
60
61
62INSTALLATION
63============
64
65Change the type definitions in 'idea.h' to the representations in your computer
66 typedef int int32; /* signed 32-bit integer (or larger) */
67 typedef unsigned int u_int32; /* unsigned 32-bit integer (or larger) */
68 typedef unsigned short u_int16; /* unsigned 16-bit integer (or larger) */
69 typedef char u_int8; /* unsigned 8-bit integer */
70
71Comment this definition 'idea.h' if you have neither a ANSI-C nor a C++ compiler
72 #define ANSI_C
73
74Modify 'Makefile' to call your compiler (C, ANSI-C or C++).
75 CC = acc
76
77Execute the following commands:
78 man -M . idea display the man page of idea (UNIX)
79 man -t -M . idea print the man page of idea (UNIX)
80 make compile and link the application (general)
81