<!-- $Id: mod_dynmasq.html,v 1.2 2007/10/11 16:28:27 castaglia Exp $ -->
<!-- $Source: /cvsroot/proftp/proftpd/doc/contrib/mod_dynmasq.html,v $ -->
<html>
<head>
<title>ProFTPD module mod_dynmasq</title>
</head>
<body bgcolor=white>
<hr>
<center>
<h2><b>ProFTPD module <code>mod_dynmasq</code></b></h2>
</center>
<hr><br>
The <code>mod_dynmasq</code> module is designed for those sites that
use the <code>MasqueradeAddress</code> directive in conjunction with DNS
names whose addresses periodically change, <i>e.g.</i> "dyndns"
addresses. The <code>proftpd</code> daemon is not aware of any changes
to the IP address for a <code>MasqueradeAddress</code> that happen after
the daemon has started up. The <code>mod_dynmasq</code> module periodically
checks all configured <code>MasqueradeAddress</code> directives and resolves
their IP addresses, updating the stored addresses as needed.
<p>
This module is contained in the <code>mod_dynmasq.c</code> file for
ProFTPD 1.2.10 and later, and is not compiled by default. Installation
instructions are discussed <a href="#Installation">here</a>.
<p>
The most current version of <code>mod_dynmasq</code> is distributed with
the <code>proftpd</code> source distribution.
<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="#DynMasqRefresh">DynMasqRefresh</a>
</ul>
<hr>
<h2><a name="DynMasqRefresh">DynMasqRefresh</a></h2>
<strong>Syntax:</strong> DynMasqRefresh <em>secs</em><br>
<strong>Default:</strong> None<br>
<strong>Context:</strong> "server config"<br>
<strong>Module:</strong> mod_dynmasq<br>
<strong>Compatibility:</strong> 1.2.10
<p>
The <code>DynMasqRefresh</code> directive configures the amount of time,
in seconds, between <code>mod_dynmasq</code>'s checking and updating of
all <code>MasqueradeAddress</code> directives. If no
<code>DynMasqRefresh</code> directive is configured, then the module will
do no checking.
<p>
The process of resolving a DNS name to its IP address can, depending on
the DNS configuration, take a noticeable amount of time. This, combined
with the number of <code>MasqueradeAddress</code> directives in your
<code>proftpd.conf</code>, can cause <code>mod_dynmasq</code> to make
the daemon unavailable while it resolves all addresses. Therefore it
is highly recommended that the configured interval be as long as possible,
for example for 8 hours.
<p>
Example:
<pre>
<IfModule mod_dynmasq.c>
# Refresh any configured MasqueradeAddress directives every 8 hours
DynMasqRefresh 28800
</IfModule>
</pre>
<p>
See also:
<p>
<hr>
<h2><a name="Installation">Installation</a></h2>
To install the <code>mod_dynmasq</code> module, follow the usual steps for
using third-party modules in proftpd:
<pre>
./configure --with-modules=mod_dynmasq
make
make install
</pre>
<p>
<hr><br>
Author: <i>$Author: castaglia $</i><br>
Last Updated: <i>$Date: 2007/10/11 16:28:27 $</i><br>
<br><hr>
<font size=2><b><i>
© Copyright 2004-2007 TJ Saunders<br>
All Rights Reserved<br>
</i></b></font>
<hr><br>
</body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
8f7c9a275934eff59b20e5b18a0129a0
>
files
>
71
