This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

trf-intro(n)                                                                                    trf-intro(n)



NAME
       trf-intro - Introduction to Trf

SYNOPSIS
       package require Tcl  ?8.2?

       package require Trf  ?2.1p2?


DESCRIPTION
       The package Trf provides a number of commands which take data and transform them in various ways.

BACKGROUND
       The  implementation  of  Trf began as proof-of-concept of the validity and usefulness of the "stacked
       channel" patches to the core. These patches allow the writing of extensions to the generic I/O system
       of the core which are able to intercept all read/write operations on designated channels, thus giving
       it the ability to transform the data flowing through these channels as desired.

       This allows things like transparent encryption, compression, charset recoding, etc.

       Since version 8.2 of the tcl core the aforementioned patches are part of the tcl core itself,  chang-ing changing
       ing the status of trf from "extension requiring core patches" to "normal extension".

       Other packages built upon either the stackd channels directly, or Trf are:

       [1]    TrfCrypt, by myself, contains various encryption systems

       [2]    TLS, an SSL/TLS implementation by Matt Newman.

       [3]    Tcl MIME by Marshall Rose.

API
       The  commands provide by trf can be placed into the three categories listed below. Note that all com-mands commands
       mands are added to the global namespace.

       Encodings
              The encoding commands either take some data and return the same data in encoded form, or  take
              encoded data and return a decoded result.

              [1]    oct

              [2]    hex

              [3]    oct

              [4]    base64

              [5]    uuencode

              [6]    ascii85

              [7]    otp_words

              [8]    quoted-printable


       Message Digests
              The  second  category  are message digests in general, simple ones like crc, and cryptographi-cally cryptographically
              cally strong algorithms like md5.

              [1]    crc-zlib

              [2]    crc

              [3]    adler

              [4]    md2

              [5]    md5

              [6]    md5_otp

              [7]    sha

              [8]    sha1

              [9]    sha1_otp

              [10]   haval

              [11]   ripemd-160

              [12]   ripemd-128


       Miscellaneous
              At last a number of commands not readily placed into categories providing  password  crypting,
              general transformations, data compression, error correction and others.

              [1]    crypt

              [2]    md5crypt

              [3]    transform

              [4]    rs_ecc

              [5]    zip

              [6]    bz2

              [7]    unstack

SEE ALSO
       adler,  ascii85,  base64,  bz2,  crc,  crc-zlib, crypt, haval, hex, md2, md5, md5_otp, md5crypt, oct,
       otp_words, quoted-printable, ripemd-128, ripemd-160, rs_ecc, sha, sha1,  sha1_otp,  transform,  uuen-code, uuencode,
       code, zip

KEYWORDS
       compression, encoding, error correction, message digest, transformation

COPYRIGHT
       Copyright (c) 1996-2003, Andreas Kupries <andreas_kupries@users.sourceforge.net>




Trf transformer commands                            2.1p2                                       trf-intro(n)