| Current File : //usr/share/doc/proftpd-1.3.5e/contrib/mod_quotatab_ldap.html |
<!-- $Id: mod_quotatab_ldap.html,v 1.3 2013-08-14 21:40:18 castaglia Exp $ -->
<!-- $Source: /home/proftpd-core/backup/proftp-cvsroot/proftpd/doc/contrib/mod_quotatab_ldap.html,v $ -->
<html>
<head>
<title>ProFTPD module mod_quotatab_ldap</title>
</head>
<body bgcolor=white>
<hr>
<center>
<h2><b>ProFTPD module <code>mod_quotatab_ldap</code></b></h2>
</center>
<hr><br>
This <code>mod_quotatab</code> submodule is contained in the
<code>mod_quotatab_ldap.c</code>, and is found in the <code>contrib/</code>
area of the ProFTPD source distribution. See the <code>mod_quotatab</code>
<a href="mod_quotatab.html#Installation">installation</a> instructions.
<p>
This submodule provides the LDAP-specific "driver" for retrieving
quota limit table information from an LDAP server.
<h2>Author</h2>
<p>
Please contact John Morrissey <jwm <i>at</i> horde.net> with any
questions, concerns, or suggestions regarding this module.
<p>
<hr><h2><a name="LDAPTables">LDAP Limit Quota Tables</a></h2>
LDAP-based quota tables (<em>source-type</em> of "ldap") can
only be used for limit tables, <b>not</b> for tally tables. The frequent
updates needed for maintaining tally tables mean that LDAP is not well-suited
to handle tally table storage.
<p>
The <code>mod_quotatab_ldap</code> module supports the "ldap" string
for the <em>source-type</em> parameter of the
<a href="mod_quotatab.html#QuotaLimitTable"><code>QuotaLimitTable</code></a>
configuration directive.
<p>
To enable LDAP-provisioned limit tables, you need to configure
<code>mod_ldap</code> to lookup the proper attribute using the
<a href="http://www.proftpd.org/docs/directives/linked/config_ref_LDAPDoQuotaLookups.html"><code>LDAPDoQuotaLookups</code></a> configuration directive.
<p>
The LDAP attribute to be looked up (named <code>ftpQuota</code> by default)
should contain a comma-separated list of 8 values, in the following order:
<pre>
<i>per_session, limit_type, bytes_in_avail, bytes_out_avail, bytes_xfer_avail,
files_in_avail, files_out_avail, files_xfer_avail</i>
</pre>
For example:
<pre>
"false,hard,100,100,100,100,100,100"
</pre>
<p>
An example <code>proftpd.conf</code> configuration might look like:
<pre>
<IfModule mod_quotatab.c>
<IfModule mod_quotatab_ldap.c>
# Enable LDAP quota lookups
LDAPDoQuotaLookups on
# Use an LDAP-based limit table. Note that there is no additional
# information supplied after the source-type: this is intentional.
# mod_ldap handles the rest.
QuotaLimitTable ldap:
</IfModule>
# Use a file-based tally table
QuotaTallyTable file:/usr/local/proftpd/ftpquota.tallytab
</IfModule>
</pre>
<br><hr>
<font size=2><b><i>
© Copyright 2003 TJ Saunders<br>
All Rights Reserved<br>
</i></b></font>
<hr><br>
</body>
</html>