summaryrefslogtreecommitdiffstats
path: root/system/clamav/README
blob: 67a4f9c5a95c0309c01d72d7129b9270caa27595 (plain)
Clam AntiVirus is a GPL anti-virus toolkit for UNIX. The main purpose
of this software is the integration with mail servers (attachment
scanning). The package provides a flexible and scalable multi-threaded
daemon, a command line scanner, and a tool for automatic updating via
Internet.

This build script should build a package that "just works" after install.
You will need to specify a two-letter country code (such as "us") as an
argument to the COUNTRY variable when running the build script (this will
default to "us" if nothing is specified).  For example:
  COUNTRY=nl ./clamav.SlackBuild

The package contains a start/stop script: /etc/rc.d/rc.clamav.
I would suggest calling this script from /etc/rc.d/rc.M just
before Sendmail is started with code like:

# Starting ClamAV daemons
if [ -x /etc/rc.d/rc.clamav ]; then
  /etc/rc.d/rc.clamav start
fi

The start/stop script will start: clamd, freshclam and clamav-milter.

** ClamAV, Amavisd-new and SpamAssassin **
You might want to use amavisd-new to act as an intermediary between Sendmail
and ClamAV (and possible SpamAssassin too). Amavisd-new can be downloaded at
http://www.ijs.si/software/amavisd/

For clamd to be able to scan messages, when called by Amavisd-new, you must
add "clamav" to the "amavis" group (provided that clamd.conf contains the
"User clamav" directive), e.g. run:

  # usermod -G $(id -Gn clamav | tr ' ' ','),amavis clamav

Be sure to enable "AllowSupplementaryGroups" in clamd.conf and restart clamd.
Also, to enable Amavisd-new to scan ClamAV's log files and produce nice
statistics, the reverse must be done too; add user "amavis" to the group
"clamav" as follows:

  # usermod -G $(id -Gn amavis | tr ' ' ','),clamav amavis

Add the rc.amavisd script to your /etc/rc.d/rc.M script between the start of
clamav and sendmail, so that the relevant section looks like this:

# Starting ClamAV daemon:
if [ -x /etc/rc.d/rc.clamav ]; then
  /etc/rc.d/rc.clamav start
fi

# Starting Amavisd daemon:
if [ -x /etc/rc.d/rc.amavisd ]; then
  /etc/rc.d/rc.amavisd start
fi

# Start the sendmail daemon:
if [ -x /etc/rc.d/rc.sendmail ]; then
  . /etc/rc.d/rc.sendmail start
fi