xxteac v0.93 release notes:

Hi folks,

This program utilizes the "Corrected Block TEA" (also known as XXTEA)
encryption algorithm by Roger Needham and David Wheeler, published in 1998.
I have slightly modified the cipher to be able to use arbitary length
(powers of 2) key sizes.
There may be bugs and I am grateful if you report them to me.
Thank you in advance!

To compile and install this program (xxteac), try one
of the following methods:


Download and unzip the xxteac package:
---------------------------------------
0)

tar xzf xxteac-0.93.tar.gz
cd xxteac-0.93

INSTALLING METHODS:
--------------------
1) Standard: (use this method if your build tools are up to date).

./configure
make
make install

If step 1 gives you an error message, try step 2.


MANUAL INSTALLATION:
---------------------
2) Brute force: (Use this method if step 1 failed).

cd xxteac-0.93 (if you are not there already...)
cd src           (go to the source directory)

gcc -O3 -Wall xxteac.c -o xxteac
cp -f ./xxteac /usr/local/bin  (Replace "/usr/local/bin" with a target directory
where you want to install the executable).

Optionally take a local copy of the manual "xxteac.1":
------------------------------------------------------
cd ../man
mkdir -p /usr/local/man/man1
cp -f xxteac.1 /usr/local/man/man1

That should be all.
(Maybe you want to add "/usr/local/man" to your MANPATH if it's not
already there... (Maybe /usr/local/share/man too?)
If you don't use GCC, then just compile and link xxteac.c with
your favorite tools. I have no experience how it works though.
-------------------------------------------------------------------------------

USING XXTEAC:
-------------------

To use xxteac, you need a 1024 byte password file.
The size may be bigger than that but not smaller.
It can be any binary file, I used a JPG picture to test encryption and
decryption of files with xxteac.
Here is how I made my password file:
In a UN*X system, "dd if=photo.jpg of=key.1024 skip=3 bs=1024 count=1".

I don't recommend using this method however - i leave it to you
how to create a good password file. Just remember that it is
a secret file for authorized eyes only. It should be as random as possible.
You need this file to decrypt your previously encrypted files too,
so don't loose it.

And finally, here is how to encrypt a file using xxteac:
Assuming you want to encrypt a file called "secret.txt"
using a password file called "key.1024", type
xxteac secret.txt -enc -file key.1024 -o secret.enc
This creates an encrypted file called "secret.enc" and you
can decrypt it by typing:
xxteac secret.enc -dec -file key.1024 -o secret2.txt

See man(1) xxteac also.

If you use this program, you agree that you do so at your own risk.
Please see the included General Public License in the file "COPYING"
for more information. Thank you!

  - Niko Kiiskinen



PS.
If you have any questions about this program or
if you want to report a bug, my email address
is nkiiskin[at]yahoo[dot]com
