Installation

See on ClamAV™ website for installation instructions for your system (packages exists for different Linux versions).

Configuration

Configure the TCPSocket option (normally in clamd.conf). This is the port on which ClamAV will be listening for commands from the plugin. If you set it to the default value of 9321, you won't need to configure the plugin.

# The port on which ClamAV listens for commands
TCPSocket  9321

Installation

Type this command in your Grail application directory

$> grails install-plugin clamav

or if you have a plugin archive locally.

$> grails install-plugin /path/to/grails-clamav-0.1.zip

Configuration

In grails-app/conf/Config.groovy you can add following entries:

• clamav.host=xxx (the host on which the ClamAV daemon runs. Default is localhost)
• clamav.port=xxx (the port on which ClamAV daemon is listening. Must match the TCPSocket configuration option of ClamAV daemon. Default is 9321)

Validator

The plugin registers a new validator named freeOfVirus that you can use in validation like any other constraint. For example like:

class Foo
{
  ...
  byte[] binaryData
  ...
  static constraints = {
    binaryData(freeOfVirus: true)
  }
}

Service

The plugin provides a service named clamAVService that implements the simple AntiVirusService interface. You can uses in your controllers like any other service.

Example:

class TestController
{
  def clamAVService // will be injected

  def test = {
    def f = new File(...)
    def virus
    f.withInputStream {
      virus = clamAVService.scan(it)
    }
    render(text: (virus ? "Virus found: $virus" : "Ok"))
  }
}