<!-- $Id: mod_quotatab_ldap.html,v 1.2 2007/01/02 22:27:53 castaglia Exp $ --> <!-- $Source: /cvsroot/proftp/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="http://www.castaglia.org/proftpd/modules/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>