README for Filter::CBC 0.10.

WHATIS

Filter::CBC is a Perl Source Filter that uses CBC (Cipher Block Chaining) to encrypt/decrypt your sourcecode during runtime.

It uses the Filter module by Paul Marquess and Crypt::CBC by Lincoln Stein.

INSTALLING

Filter::CBC can be installed easily by using the CPAN module.

perl -MCPAN -e"install Filter::CBC"

or manually by untarring the archive and running the following commands.

perl Makefile.PM
make
make test
make install

TESTING

This module has been tested on Linux 2.4.x (x86) with Perl 5.6.1

EXAMPLES & SCRIPTS

Examples are included for all the CBC compatible encryption routines.

The code2cbc.pl script can encrypt your code by asking a number of simple questions. The autoencryption feature does the same thing, without the questions. code2cbc.pl can be found in the obsolete directory.

The cbc2code.pl script can decrypt encrypted scripts.

AUTOFILTER

Filter::CBC can now encrypt your source code on the fly (similar to Acme::Bleach). Just add

use Filter::CBC 'Rijndael','my secret key';

above the chunk you want to encrypt et voila. Change the use statement according to your requirements and run it. Filter::CBC will now encrypt the source and exit. Your code will not be executed at that time. PLEASE backup your code before running it. PRETTY PLEASE.

REQUIREMENTS

Filter::CBC requires at least

Filter - http://search.cpan.org/search?dist=Filter

Crypt::CBC - http://search.cpan.org/search?dist=Crypt-CBC

Crypt::Rijndael - http://search.cpan.org/search?dist=Crypt-Rijndael

Also any Block Cipher routine you might want to use. Among those compatible with CBC are :

Crypt::Rijndael - http://search.cpan.org/search?dist=Crypt-Rijndael

Crypt::DES - http://search.cpan.org/search?dist=Crypt-DES

Crypt::IDEA - http://search.cpan.org/search?dist=Crypt-IDEA

Crypt::Blowfish - http://search.cpan.org/search?dist=Crypt-Blowfish

Crypt::GOST - http://search.cpan.org/search?dist=Crypt-GOST

Crypt::DES_EDE3 - http://search.cpan.org/search?dist=Crypt-DES_EDE3

Crypt::Twofish - http://search.cpan.org/search?dist=Crypt-Twofish

Crypt::NULL - http://search.cpan.org/search?dist=Crypt-NULL

Crypt::TEA - http://search.cpan.org/search?dist=Crypt-TEA

Crypt::RC6 - http://search.cpan.org/search?dist=Crypt-RC6

Crypt::Serpent - http://search.cpan.org/search?dist=Crypt-Serpent

THANKS A MILLION

Alot of thanks to Ray Brinzer (Petruchio on Perlmonks) for giving an example on how to handle parameters with use.

Paul Marquess for writing Filter and pointing out that Filter does what it should and not what I expect it to.

A bunch of monks at Perlmonks for giving some excellent and well appreciated feedback on detecting code. Thank you Blakem, Petral, Chipmunk, Tilly, Jepri and Zaxo.

AUTHOR

Filter::CBC was written by Hendrik Van Belleghem. Suggestions & Questions are welcome at hendrik dot vanbelleghem - at - gmail - dot - com.

Yes, I love fanmail! No, I don't like spam.