<html><head><title>ProFTPD module mod_clamav</title></head><body bgcolor="white"> <hr> <center> <h2><b>ProFTPD module <code>mod_clamav</code></b></h2> </center> <hr><br> The <code>mod_clamav</code> module is designed to scan files immediately upon upload through FTP for viruses. If the file is found to be infected, it is immediately removed from the system, and a message is logged. If the file is found to be free of viruses, the FTP client is sent an optional message stating the file was scanned. <br><br> This module is best employed in scenarios where many users are using a system that is maintained by another entity. In this scenario, the administrator of the machine is helping to ensure that no viruses are spread to other users. <p> <b>Warning:</b> If you are using a newer version of ClamAV, such as 0.88, then there was a newly introduced timeout for sessions, which causes this module to experience problems. See: <a href="http://lists.clamav.net/message/20060128.173434.bce66f06.en.html">http://lists.clamav.net/message/20060128.173434.bce66f06.en.html</a> </p><p> This module was compiled and tested against ProFTPD 1.2.10. Installation instructions are discussed <a href="#Installation">here</a>. </p><p> The most current version of <code>mod_clamav</code> can be found at: </p><pre> <a href="http://www.uglyboxindustries.com/">http://www.UglyBoxIndustries.com/</a> </pre> <h2>Author</h2> <p> Please contact Joseph Benden <joe <i>at</i> thrallingpenguin.com> with any questions, concerns, or suggestions regarding this module. </p><h2>Directives</h2> <ul> <li><a href="#ClamAV">ClamAV</a> </li><li><a href="#ClamWarn">ClamWarn</a> </li><li><a href="#ClamLocalSocket">ClamLocalSocket</a> </li></ul> <hr> <h2><a name="ClamWarn">ClamWarn</a></h2> <strong>Syntax:</strong>ClamWarn <em>boolean</em><br> <strong>Default:</strong> Off<br> <strong>Context:</strong> server config, <VirtualHost>, <Global>, <Anonymous><br> <strong>Module:</strong> mod_clamav<br> <strong>Compatibility:</strong> 1.2.10 <p> The <code>ClamWarn</code> directive will configure if the <code>mod_clamav</code>'s virus scanning results are displayed to the remote FTP client. This is desirable if your FTP clients are having troubles with the returned results of <code>mod_clamav</code>. If no <code>ClamWarn</code> directive is configured, then the module will return no results. </p><hr> <h2><a name="ClamAV">ClamAV</a></h2> <strong>Syntax:</strong> ClamAV <em>boolean</em><br> <strong>Default:</strong> Off<br> <strong>Context:</strong> server config, <VirtualHost>, <Global>, <Anonymous><br> <strong>Module:</strong> mod_clamav<br> <strong>Compatibility:</strong> 1.2.10 <p> The <code>ClamAV</code> directive will configure if the <code>mod_clamav</code>'s virus scanning and virus removal features are active. If no <code>ClamAV</code> directive is configured, then the module will do no virus scanning. </p><p> Example: </p><pre> <IfModule mod_clamav.c> # Enable virus scanning and removal ClamAV on # Specify the UNIX Local Socket ClamLocalSocket /tmp/clamd </IfModule> </pre> <p> See also: </p><hr> <h2><a name="ClamLocalSocket">ClamLocalSocket</a></h2> <strong>Syntax:</strong>ClamLocalSocket <em>string</em><br> <strong>Default:</strong> None<br> <strong>Context:</strong> server config, <Global><br> <strong>Module:</strong> mod_clamav<br> <strong>Compatibility:</strong> 1.2.10 <p> The <code>ClamLocalSocket</code> directive will configure the UNIX socket used to connect to the Clamd daemon process. If no <code>ClamLocalSocket</code> directive is configured, then the module will do no scanning. </p><p> Example: </p><pre> <IfModule mod_clamav.c> # Enable virus scanning and removal ClamAV on # Specify the UNIX Local Socket ClamLocalSocket /tmp/clamd </IfModule> </pre> <p> </p><hr> <h2><a name="Installation">Installation</a></h2> To install <code>mod_clamav</code>, copy the <code>mod_clamav.c</code> file into <pre> <i>proftpd-dir</i>/contrib/ </pre> Unpack the latest proftpd-1.2.<i>x</i> source code, then follow the usual steps for using third-party modules in proftpd: <pre> ./configure --with-modules=mod_clamav make make install </pre> <p> </p><hr><br> Author: <i>Joseph Benden, Sr.</i><br> Last Updated: <i>01/27/2006 2:43 PM</i><br> <br><hr> <font size="2"><b><i> © Copyright 2005-2006 Thralling Penguin LLC.<br> All Rights Reserved<br> </i></b></font> <hr><br> </body></html>