README for Filter::CBC 0.09
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 beatnik - at - quickndirty - dot - org.
Yes, I love fanmail! No, I don't like spam.