<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>
distrib
>
Mandriva
>
2008.0
>
x86_64
>
media
>
main-backports-src
>
by-pkgid
>
43742945d611736e6e3dda2185b2f9fe
>
files
>
5
