FRISK Software International


f-prot-qmail - Qmail plugin for F-Prot Antivirus Mail Scanner






f-prot-qmail is a plugin for Qmail that allows the user to scan messages passing through a Qmail mailsystem with the F-Prot Antivirus Mail Scanner. f-prot-qmail uses the same interface of receiving messages and envelope information as the qmail-queue(8)
utility in the Qmail distribution.
To achieve in-transit scanning of mail messages in Qmail you must rename the qmail-queue application to qmail-queue.orig , and put f-prot-qmail in its place with the same name and file permissions as the original qmail-queue. Usually this means setting qmailq as the file's owner and qmail as the file's group.
The f-prot-qmail utility depends on the F-Prot Antivirus Mail Scanner ( ) listening in server mode on port 11200. For more information on F-Prot Antivirus Mail Scanner and its server mode, refer to the
manual page.
The f-prot-qmail utility will make a copy of each message in /tmp with the name /tmp/fi<pid>.<random>. It will then create another file called /tmp/fo<pid>.<random> and then contact the Mail Scanner and supply it with both filenames. When the Mail Scanner replies that it has finished, f-prot-qmail will execute qmail-queue.orig and supply it with a clean message and the envelope information handed to f-prot-qmail.



Here are the instructions for moving qmail-queue and putting f-prot-qmail in its place:

    # cd /var/qmail/bin
    # mv qmail-queue qmail-queue.orig
    # cp /opt/f-prot/tools/f-prot-qmail ./qmail-queue
    # chown qmailq.qmail qmail-queue
    # chmod 4711 qmail-queue



Since f-prot-qmail (now renamed as qmail-queue) is executed for each incoming mail, the startup penalty can be significant for busy mailservers. To reduce overhead f-prot-qmail will first check the variable FP_QMAIL_LOGLEVEL in /etc/f-prot.conf to determine the amount of information to write to the system logs. Then it checks if FP_QMAIL_LOGLEVEL is set in the environment, and if so it will override the value from the config file. If FP_QMAIL_LOGLEVEL is not set in the config file nor in the environment FP_LOGLEVEL will be used instead. Note that /etc/f-prot.conf is sh compatible and can thus be "sourced" by the environment that runs qmail, making it unnecessary for f-prot-qmail to parse the file itself upon each startup. See /etc/f-prot.conf and your systems manual page for syslog for more information on log levels.



For information about Licensing, see the LICENSE file that comes with F-Prot Antivirus.



Please direct any feedback to:

Updates will be advertised on:




F-PROT Antivirus
- for Windows
- for UNIX
- for Exchange
F-PROT Antivirus
- for Windows
- for UNIX
- for Exchange
Stay up to date with life cycle policies for F-PROT Antivirus for Windows.
Definitions of common antivirus terminology.