summaryrefslogtreecommitdiffstats
path: root/system/clamav/README
diff options
context:
space:
mode:
Diffstat (limited to 'system/clamav/README')
-rw-r--r--system/clamav/README58
1 files changed, 58 insertions, 0 deletions
diff --git a/system/clamav/README b/system/clamav/README
new file mode 100644
index 0000000000..67a4f9c5a9
--- /dev/null
+++ b/system/clamav/README
@@ -0,0 +1,58 @@
+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