isposted v0.93 readme
---------------------

isposted is a quick'n'dirty perl script that checks the easynews (http://www.easynews.com) web based
news server for the presence of a given file.

I agree this is not terribly useful, but I can think of some case you'll need this script
- To see if a copyrighted/internal file is present on the news... nah; forget about it
- To see if a file is present on the news before a repost.
- It's a neat way to make some MD5 collisions tests against a 10To database... :)

This script does not (entirely) rely on the file name. URL of easynews files are based on a
file content analysis. This script checks the MD5 & CRC32 of the file, and reconstruct the possible
URL of this file. It then checks the website to see if this file is indeed present or not.


Installation
------------

First, you need to add your easynews username/password in the isposted.pl script
then,

	*Unix / *BSD
	------------

	You might need 3 additionals modules LWP, MD5 and CRC32 (http://www.cpan.org)
	You can get them in the /requested/unix directory

	Check that the perl path is ok in the script header


	Windows
	-------

	Change the value of $scriptforwindows to 1 in the script header

	If you haven't perl, I suggest you download ActivePerl
	http://www.activestate.com/Products/Download/Get.plex?id=ASPNPerl
	
	The current version already include the LWP module.
	You'll need the MD5.pm located in the /requested/windows directory
	Copy it to <activeperl_install>/lib
	 and
	copy the CRC32.pm located in the /requested/windows directory
	to <activeperl_install>/lib/file

	
Usage
-----

./isposted.pl filename


Performance
-----------

Unix version rely on Perl/C module, it's then quite fast to get the MD5/CRC32
even for large files. It needs ~11s for a 32MB file on a PII/266

Beware that windows version does rely (as; as far as I know, Perl/C modules
for MD5 & CRC32 are unavailable) on pure Perl modules. The MD5 & CRC32 generation
is then *extremely* slow. Only try this script on files larger than 1MB at your
own risk...


Anything
--------

No need to say that this is totally freeware... Feel free to change it the way you want.
Just tell me : cariad@adnx.net ICQ:#30225246
As you've got it, I suppose you don't care about where to get this package, but anyway,
it's here : http://www.adnx.net/cariad/isposted


-- Cariad