| Current File : //usr/share/doc/proftpd-1.3.5e/contrib/mod_ratio.html |
<!-- $Id: mod_ratio.html,v 1.1 2013-10-03 06:33:19 castaglia Exp $ -->
<!-- $Source: /home/proftpd-core/backup/proftp-cvsroot/proftpd/doc/contrib/mod_ratio.html,v $ -->
<html>
<head>
<title>ProFTPD module mod_ratio</title>
</head>
<body bgcolor=white>
<hr>
<center>
<h2><b>ProFTPD module <code>mod_ratio</code></b></h2>
</center>
<hr><br>
<p>
The <code>mod_ratio</code> module
<p>
This module is contained in the <code>mod_ratio.c</code> file for
ProFTPD 1.3.<i>x</i>, and is not compiled by default. Installation
instructions are discussed <a href="#Installation">here</a>; a discussion
on <a href="#Usage">usage</a> is also available.
<p>
The most current version of <code>mod_ratio</code> is distributed with the
ProFTPD source code.
<h2>Author</h2>
<p>
Please contact TJ Saunders <tj <i>at</i> castaglia.org> with any
questions, concerns, or suggestions regarding this module.
<h2>Directives</h2>
<ul>
<li><a href="#AnonRatio">AnonRatio</a>
<li><a href="#ByteRatioErrMsg">ByteRatioErrMsg</a>
<li><a href="#CwdRatioMsg">CwdRatioMsg</a>
<li><a href="#FileRatioErrMsg">FileRatioErrMsg</a>
<li><a href="#GroupRatio">GroupRatio</a>
<li><a href="#HostRatio">HostRatio</a>
<li><a href="#LeechRatioMsg">LeechRatioMsg</a>
<li><a href="#RatioFile">RatioFile</a>
<li><a href="#Ratios">Ratios</a>
<li><a href="#RatioTempFile">RatioTempFile</a>
<li><a href="#SaveRatios">Ratios</a>
<li><a href="#UserRatio">UserRatio</a>
</ul>
<p>
<hr>
<h2><a name="AnonRatio">AnonRatio</a></h2>
<strong>Syntax:</strong> AnonRatio <em>name file-ratio file-credit byte-ratio byte-credit</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>AnonRatio</code> directive
<p>
<hr>
<h2><a name="ByteRatioErrMsg">ByteRatioErrMsg</a></h2>
<strong>Syntax:</strong> ByteRatioErrMsg <em>message</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>ByteRatioErrMsg</code> directive
<p>
<hr>
<h2><a name="CwdRatioMsg">CwdRatioMsg</a></h2>
<strong>Syntax:</strong> CwdRatioMsg <em>message</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>CwdRatioMsg</code> directive
<p>
<hr>
<h2><a name="FileRatioErrMsg">FileRatioErrMsg</a></h2>
<strong>Syntax:</strong> FileRatioErrMsg <em>message</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>FileRatioErrMsg</code> directive
<p>
<hr>
<h2><a name="GroupRatio">GroupRatio</a></h2>
<strong>Syntax:</strong> GroupRatio <em>name file-ratio file-credit byte-ratio byte-credit</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>GroupRatio</code> directive
<p>
<hr>
<h2><a name="HostRatio">HostRatio</a></h2>
<strong>Syntax:</strong> HostRatio <em>name file-ratio file-credit byte-ratio byte-credit</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>HostRatio</code> directive
<p>
<hr>
<h2><a name="LeechRatioMsg">LeechRatioMsg</a></h2>
<strong>Syntax:</strong> LeechRatioMsg <em>message</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>LeechRatioMsg</code> directive
<p>
<hr>
<h2><a name="RatioFile">RatioFile</a></h2>
<strong>Syntax:</strong> RatioFile <em>path</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>RatioFile</code> directive
<p>
<hr>
<h2><a name="Ratios">Ratios</a></h2>
<strong>Syntax:</strong> Ratios <em>on|off</em><br>
<strong>Default:</strong> Off<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>Ratios</code> directive
<p>
<hr>
<h2><a name="RatioTempFile">RatioTempFile</a></h2>
<strong>Syntax:</strong> RatioTempFile <em>path</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>RatioTempFile</code> directive
<p>
<hr>
<h2><a name="SaveRatios">SaveRatios</a></h2>
<strong>Syntax:</strong> SaveRatios <em>on|off</em><br>
<strong>Default:</strong> Off<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>SaveRatios</code> directive
<p>
<hr>
<h2><a name="UserRatio">UserRatio</a></h2>
<strong>Syntax:</strong> UserRatio <em>name file-ratio file-credit byte-ratio byte-credit</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config", <VirtualHost>, <Global>, <Directory>, <Anonymous><br>
<strong>Module:</strong> mod_ratio<br>
<strong>Compatibility:</strong> 1.2.2 and later
<p>
The <code>UserRatio</code> directive
<p>
<hr>
<h2><a name="Installation">Installation</a></h2>
The <code>mod_ratio</code> module is distributed with ProFTPD. Simply follow
the normal steps for using third-party modules in proftpd:
<pre>
./configure --with-modules=mod_ratio
make
make install
</pre>
Alternatively, <code>mod_ratio</code> can be built as a DSO module:
<pre>
./configure --enable-dso --with-shared=mod_ratio ...
</pre>
Then follow the usual steps:
<pre>
make
make install
</pre>
<p>
For those with an existing ProFTPD installation, you can use the
<code>prxs</code> tool to add <code>mod_ratio</code>, as a DSO module, to
your existing server:
<pre>
# prxs -c -i -d mod_ratio.c
</pre>
<p>
<hr><br>
<h2><a name="Usage">Usage</a></h2>
To use <code>mod_ratio</code>
<p>
<hr><br>
Author: <i>$Author: castaglia $</i><br>
Last Updated: <i>$Date: 2013-10-03 06:33:19 $</i><br>
<br><hr>
<font size=2><b><i>
© Copyright 2013 TJ Saunders<br>
All Rights Reserved<br>
</i></b></font>
<hr><br>
</body>
</html>