SAVI - Perl module interface to Sophos Anti-Virus Engine
Creates a new instance of the virus scanning engine. Returns a reference to an object of type SAVI on success or a numeric error code on failure.
Explicitly loads or reloads virus data. Virus data is automatically loaded the first time it is needed, or can be explicitly loaded with this function. This function can also be used to refresh virus data within an existing SAVI object. The optional parameters define where the main virus data and the ancillary ide files can be found. If neither are supplied, the default environment variable SAV_IDE is used. If the second parameter is not supplied the value of the first will be used for both. Returns undef on success or a numeric error code on failure.
Returns a reference to an object of type SAVI::version on success, a numeric error code in the case of failure of the underlying API call, or undef upon failure to allocate memory.
Returns true if the virus data in use is stale and should be reloaded. This is implemented by saving the mtime of the IDE directory when the virus data is loaded and comparing the current mtime of that directory to the saved value. If the current mtime is greater than the saved value, the virus data is assumed to be stale.
Returns an array listing valid options for the in-use version of the SAVI engine.
Sets the given parameter to the given value. Returns undef on success and a numeric error code on failure.
Returns the current value of the given parameter. $error is undef on success and a numeric error code on failure.
Initiates a scan on the given file. Returns a reference to an object of type SAVI::results on success, or a numeric error code on failure.
Initiates a scan on the given file handle. Returns a reference to an object of type SAVI::results on success, or a numeric error code on failure.
Returns an error message corresponding to the given code. Can also be called as SAVI->error_string(code) if the failure resulted from initializing the $savi object itself.
Returns the version number of the product.
Returns the major portion of the version number of the virus engine.
Returns the minor portion of the version number of the virus engine.
Returns the number of viruses recognized by the engine.
Returns a list of references to objects of type SAVI::ide, describing what virus definition files are in use.
Returns the name of the virus definition file.
Returns the release date of the virus definition file.
Returns true if the scan discovered a virus.
Returns a list of the viruses discovered by the scan.
Paul B. Henson <henson@acm.org>
perl(1).
To install SAVI, copy and paste the appropriate command in to your terminal.
cpanm
cpanm SAVI
CPAN shell
perl -MCPAN -e shell install SAVI
For more information on module installation, please visit the detailed CPAN module installation guide.