1README for Filter::CBC 0.10. 2 3WHATIS 4 5Filter::CBC is a Perl Source Filter that uses CBC (Cipher Block Chaining) to 6encrypt/decrypt your sourcecode during runtime. 7 8It uses the Filter module by Paul Marquess and Crypt::CBC by Lincoln Stein. 9 10 11INSTALLING 12 13Filter::CBC can be installed easily by using the CPAN module. 14 15perl -MCPAN -e"install Filter::CBC" 16 17or manually by untarring the archive and running the following commands. 18 19 perl Makefile.PM 20 make 21 make test 22 make install 23 24 25TESTING 26 27This module has been tested on Linux 2.4.x (x86) with Perl 5.6.1 28 29 30EXAMPLES & SCRIPTS 31 32Examples are included for all the CBC compatible encryption routines. 33 34The code2cbc.pl script can encrypt your code by asking a number of simple 35questions. The autoencryption feature does the same thing, without the 36questions. code2cbc.pl can be found in the obsolete directory. 37 38The cbc2code.pl script can decrypt encrypted scripts. 39 40 41AUTOFILTER 42 43Filter::CBC can now encrypt your source code on the fly (similar to 44Acme::Bleach). Just add 45 46use Filter::CBC 'Rijndael','my secret key'; 47 48above the chunk you want to encrypt et voila. 49Change the use statement according to your requirements and run it. 50Filter::CBC will now encrypt the source and exit. Your code will not 51be executed at that time. PLEASE backup your code before running it. 52PRETTY PLEASE. 53 54 55REQUIREMENTS 56 57Filter::CBC requires at least 58 59 Filter - http://search.cpan.org/search?dist=Filter 60 61 Crypt::CBC - http://search.cpan.org/search?dist=Crypt-CBC 62 63 Crypt::Rijndael - http://search.cpan.org/search?dist=Crypt-Rijndael 64 65Also any Block Cipher routine you might want to use. 66Among those compatible with CBC are : 67 68 Crypt::Rijndael - http://search.cpan.org/search?dist=Crypt-Rijndael 69 70 Crypt::DES - http://search.cpan.org/search?dist=Crypt-DES 71 72 Crypt::IDEA - http://search.cpan.org/search?dist=Crypt-IDEA 73 74 Crypt::Blowfish - http://search.cpan.org/search?dist=Crypt-Blowfish 75 76 Crypt::GOST - http://search.cpan.org/search?dist=Crypt-GOST 77 78 Crypt::DES_EDE3 - http://search.cpan.org/search?dist=Crypt-DES_EDE3 79 80 Crypt::Twofish - http://search.cpan.org/search?dist=Crypt-Twofish 81 82 Crypt::NULL - http://search.cpan.org/search?dist=Crypt-NULL 83 84 Crypt::TEA - http://search.cpan.org/search?dist=Crypt-TEA 85 86 Crypt::RC6 - http://search.cpan.org/search?dist=Crypt-RC6 87 88 Crypt::Serpent - http://search.cpan.org/search?dist=Crypt-Serpent 89 90 91THANKS A MILLION 92 93Alot of thanks to Ray Brinzer (Petruchio on Perlmonks) for giving an example 94on how to handle parameters with use. 95 96Paul Marquess for writing Filter and pointing out that Filter does what it should and not what I expect it to. 97 98A bunch of monks at Perlmonks for giving some excellent and well appreciated feedback on 99detecting code. Thank you Blakem, Petral, Chipmunk, Tilly, Jepri and Zaxo. 100 101 102AUTHOR 103 104Filter::CBC was written by Hendrik Van Belleghem. Suggestions & Questions 105are welcome at hendrik dot vanbelleghem - at - gmail - dot - com. 106 107Yes, I love fanmail! No, I don't like spam. 108