README
1
2 Tcl Data transformations (Tcl-Trf)
3 (Version 2.1.4 / MAY-06-2009)
4
5 Andreas Kupries (andreas_kupries@users.sourceforge.net)
6
7This directory contains a freely distributable extension to Tcl/Tk called Tcl
8Data transformations (Tcl-Trf). The collection of provided transformation
9procedures includes:
10
11* Generation of message digests (hash values, checksums)
12
13 MD2, MD5, SHA/SHS, SHA-1, HAVAL, RIPEMD-128, -160
14 CRC (polynomial used by PGP)
15 ADLER (based upon zlib)
16
17* Conversion from and to various data encodings:
18
19 dual, octal, hexadecimal representation
20 uuencoding, base64-encoding, ASCII85-encoding
21
22* A reed-solomon error correcting coder.
23
24* (De)Compression based on zlib 1.0.4 or higher (1.1.3 is current)
25 (if available as shared library)
26
27* Data encryption:
28
29 Was removed from the base package, but is available
30 separately (TrfCrypt).
31
32
33Example applications distributed with the package are:
34
35* 'tools/md', a message digest generator.
36 Upwardly compatible to 'md5sum'.
37
38Tcl-Trf is developed for Tcl 7.6 or higher. It is a pure Tcl extension,
39Tk is not required. The extension requires a patched core. Patch files
40for 7.6, 8.0 and 8.0a2 are part of the distribution. The plus-patches
41maintained by Jan Nijtmans (nijtmans@nici.kun.nl) contain this patch too .
42
43Supporting (optional) packages are:
44
45* memchan 1.0 or higher (required by testsuite, by same author)
46
47 See http://www.oche.de/~akupries/soft/memchan/
48
49* zlib-1.0.4 or higher (1.1.3 is current!)
50
51 See http://www.cdrom.com/pub/infozip/zlib/
52
53* SSLeay or OpenSSL
54
55 See http://www.ssleay.org/
56 or http://www.openssl.org/
57
58Packages built upon the fundament provided by Trf are
59
60* TrfCrypt, contains various encryption systems, by myself.
61
62 See http://www.oche.de/~akupries/soft/trfcrypt/
63
64* TLS, an SSL/TLS implementation for all valid Tcl channels,
65 by Matt Newman <matt@novadigm.com>
66
67 See http://www.sensus.org/tcl/tls.htm
68 http://www.sensus.org/tcl/tls11.tgz
69
70
71This distribution contains the source code for Tcl-Trf + documentation
72describing commands (-> latex) and c-level interfaces (-> man-pages).
73
74
75
76COMPILING/USING Tcl-Trf
77
78To compile Tcl-Trf please follow the instructions in the HTML
79documentation (file: doc/html/trf_compile.html).
80
81To report bugs, bug fixes, descriptions of interesting Tcl-Trf
82applications, and suggested improvements:
83
84+) Send email to andreas_kupries@users.sourceforge.net
85
86or
87
88+) Post an article to the newsgroup comp.lang.tcl
89
90
91PLATFORMS
92 tested:
93 Linux 2.0.29 (gcc 2.7.2.3) Development system
94 IRIX 6.2 (cc only)
95 ULTRIX 4.1 (both cc and gcc)
96 ULTRIX 4.4 (cc 3.0)
97 HP-UX-9 (both cc and gcc)
98 HP-UX-10.2
99 Solaris 2.5 (gcc only)
100
101 Other machines and OS's should work too.
102
103Feedback about other OS's and compilers is appreciated. Please
104help me in making this package better.
105
README.tea
1
2 Tcl Data transformations (Tcl-Trf)
3 (Version 2.1.4 / MAY-06-2009)
4
5 Andreas Kupries (a.kupries@westend.com)
6
7This is the README file for the TEA compliant building of the Trf
8extension.
9
10Please follow the instructions in the HTML file
11
12 doc/html/trf_ctea.html
13
14for compilation and installation of this package, independent of wether
15you are on a Unix or Windows machine. Beware that in case of Windows TEA
16uses the Cygwin tools from Cygnus (www.cygnus.com) for compilation and
17linking.
18
19After that, enjoy it.
20