Introduction

SAVI-Perl is a Perl module interface to the Sophos Anti-Virus engine. It allows you to scan files for viruses directly from Perl.

Installation

In order to successfully compile and use SAVI-Perl, you must have already acquired and installed the Sophos Anti-Virus software and API. Information about these products can be found at

http://www.sophos.com/products/software/

If the Sophos library is not in the default search path, edit Makefile.PL and update the -L and -R options appropriately.

After meeting the prerequisites, run the following commands to compile/install:

     perl Makefile.PL
     make
     make install

The file scan.pl in the example directory demonstrates how to use the module to initialize the engine, determine version information, set options, and scan files for viruses. The module also contains some documentation, accessible via either 'man SAVI' or 'perldoc SAVI' after installation.

Changes

0.30 - Added new method $savi->stale() to check whether

virus data needs to be reloaded.

0.25 - Added support for Sun C compiler to s_comput.h in

Sophos include files.

0.20 - Updated to version 4 of the SAVI API.

• Added new method $savi->load_data() to load virus data. This can be used to dynamically refresh virus data when updates are added.
• Added new method $savi->options() returning all valid options for the virus engine in use.
• The $savi->set() method no longer requires the type of the parameter being set to be passed as an argument.
• Added new method $savi->get() to return the current value of a parameter.
• Added new method $savi->scan_fh() to perform a scan on an open filehandle.

0.15 - Updated sample scan.pl script to use the same syntax as

amavisd-new for specifying options.

0.10 - Calling $results->viruses() if the scanned file was not infected

       would result in a segmentation violation. While from a pedantic
       point of view you just really shouldn't do that ;), an empty
       list will now be returned in this case.

     - Added new method $savi->error_string(code) to return a message
       corresponding to the given error code. Updated sample script to
       demonstrate use.

     - Add simple test script to prevent complaints from
       cpan-testers@perl.org :). 

0.05 - First publicly released version.

Feedback/Availability

Please report any bugs or feature requests to <henson@acm.org>.

The latest version of SAVI-Perl is available on CPAN, or via the URL:

http://www.csupomona.edu/~henson/www/projects/SAVI-Perl/