You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by wr...@apache.org on 2007/12/05 19:38:26 UTC
svn commit: r601462 - /httpd/mod_ftp/trunk/docs/manual/mod/mod_ftp.html.en
Author: wrowe
Date: Wed Dec 5 10:38:25 2007
New Revision: 601462
URL: http://svn.apache.org/viewvc?rev=601462&view=rev
Log:
Regenerate
Modified:
httpd/mod_ftp/trunk/docs/manual/mod/mod_ftp.html.en
Modified: httpd/mod_ftp/trunk/docs/manual/mod/mod_ftp.html.en
URL: http://svn.apache.org/viewvc/httpd/mod_ftp/trunk/docs/manual/mod/mod_ftp.html.en?rev=601462&r1=601461&r2=601462&view=diff
==============================================================================
--- httpd/mod_ftp/trunk/docs/manual/mod/mod_ftp.html.en (original)
+++ httpd/mod_ftp/trunk/docs/manual/mod/mod_ftp.html.en Wed Dec 5 10:38:25 2007
@@ -13,11 +13,11 @@
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
-<p class="apache">Apache HTTP Server Version 2.3</p>
+<p class="apache">Apache HTTP Server Version 2.2</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<div id="path">
-<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.2</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Apache Module mod_ftp</h1>
<div class="toplang">
@@ -39,7 +39,8 @@
control modules, mod_ssl and any dynamic content generator to
provide veratile, scalable and secure FTP services.</p>
- <p>Further details, discussion and examples are provided in the <a href="../ftp/">FTP documentation</a>.</p>
+ <p>Further details, discussion and examples are provided in the
+ <a href="../ftp/">FTP documentation</a>.</p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
@@ -49,6 +50,7 @@
<li><img alt="" src="../images/down.gif" /> <a href="#ftpdatablocksize">FTPDataBlockSize</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ftpdirumask">FTPDirUmask</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ftpdocrootenv">FTPDocRootEnv</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#ftpepsvignorefamily">FTPEPSVIgnoreFamily</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ftpexitmessage">FTPExitMessage</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ftphomedir">FTPHomeDir</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#ftpimplicitssl">FTPImplicitSSL</a></li>
@@ -84,9 +86,10 @@
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
</table>
- <p>You must define a <code class="directive">Listen</code> directive to
- listen for FTP requests. This directive is <strong>not</strong>
- inherited from the global configuration file.</p>
+ <p>You must define a <code class="directive">Listen</code> directive to
+ listen for FTP requests.</p>
+ <div class="note">This directive is <strong>not</strong> inherited from the
+ global configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -96,27 +99,27 @@
client</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPActiveRange <em>min [max]</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>If this directive is not specified, the server will use
- random high-numbered ports</code></td></tr>
+ an arbitrary ephemeral high-numbered port</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
</table>
<p>This directive defines the port or ports that mod_ftp will
- use when making an active connection to the client. It accepts
+ use when making an active connection to the client. It accepts
one or two arguments. If only one argument is given, the server
will always use that port. If two arguments are given, the
server will treat them as a range of ports to be used.</p>
-
- <div class="note"><p>By default, Apache will not allow the FTP server to use
- privileged ports for active connections. If you specify a
- port range under 1024 in FTPActiveRange, the server will
- default to a random high-level port instead.
- </p>
- </div>
- <div class="example"><p><code>FTPActiveRange 5050</code></p><p>Force the server to use port 5050</p><p><code>FTPActiveRange 5050 5080</code></p><p>Allow the server to use any port between 5050 and 5080,
- inclusive.</p></div>
- <div class="note">This directive is inherited to all virtual hosts from
- the global configuration file.</div>
+ <div class="note">Use a sufficient range to satisfy all client requests! Between
+ the time that the client makes a data channel request following the
+ <code>PORT</code> or <code>EPRT</code> request, and the point at
+ which the server has connected to the client, the origin port
+ may be unavailable to any other client.</div>
+ <div class="note">By default, the operating system will not allow the FTP server
+ to use privileged ports for active connections. If you specify a
+ port range below 1024 with FTPActiveRange, the server will fail
+ to satisfy the <code>PORT</code> or <code>EPRT</code> request!</div>
+ <div class="example"><p><code>FTPActiveRange 5050</code></p><p>Force the server to use port 5050</p><p><code>FTPActiveRange 5050 5080</code></p><p>Allow the server to use any port between 5050 and 5080,
+ inclusive.</p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -125,7 +128,7 @@
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set initial login message</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPBannerMessage
<em>message</em>|<em>file:/path/to/file</em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code><em>none</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
@@ -134,9 +137,9 @@
the client on initial connection. This can either be a string,
or a path to a file. The message can contain a variety of
meta-characters:</p>
- <table>
- <tr><th><code>%T</code></th><td>Local time (in the form <code>Mon Apr 29
- 20:36:48 2002</code>)</td></tr>
+ <table>
+ <tr><th><code>%T</code></th><td>Local time (in the form
+ <code>Mon Apr 29 20:36:48 2002</code>)</td></tr>
<tr><th><code>%C</code></th><td>Current working directory</td></tr>
<tr><th><code>%h</code></th><td>Remote host</td></tr>
<tr><th><code>%L</code></th><td>Local host</td></tr>
@@ -146,26 +149,30 @@
<tr><th><code>%A</code></th><td>Local IP-address</td></tr>
<tr><th><code>%u</code></th><td>Remote user</td></tr>
<tr><th><code>%f</code></th><td>Number of files transferred</td></tr>
- <tr><th><code>%t</code></th><td>Total number of bytes downloaded</td></tr>
+ <tr><th><code>%t</code></th><td>Total bytes downloaded</td></tr>
<tr><th><code>%x</code></th><td>Number of data transfers</td></tr>
<tr><th><code>%b</code></th><td>Total traffic for the session (both
control and data)</td></tr>
</table>
- <div class="note">This directive is inherited to all virtual hosts from the
- global configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FTPDataBlockSize" id="FTPDataBlockSize">FTPDataBlockSize</a> <a name="ftpdatablocksize" id="ftpdatablocksize">Directive</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Block size in bytes to use during data transfers</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code /></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code /></td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Block size in bytes between control channel tests</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPDataBlockSize <em>bytes</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>48000 bytes</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
</table>
- <div class="note">Not documented</div>
+ <p>When mod_ftp is transmitting data via the operating system,
+ it's not possible to monitor the control channel for <code>ABOR</code>
+ signals. FTPDataBlockSize partitions the transfer; between each block
+ mod_ftp will see if there is a pending control channel request, or if
+ the socket is ready to send more data, and proceed to the next block.
+ Based on anticipated bandwidth, set this value to a reasonable window
+ of time in which the server should answer the control channel.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -174,11 +181,16 @@
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the umask for created directory</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPDirUmask <em>umask</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unknown</code></td></tr>
-<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
+<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
</table>
- <div class="note">Not documented</div>
+ <p>This directive sets the permission mask for directory creation
+ access. The default is 022 which gives the owner complete
+ access and disables write access for the group and other
+ users.</p>
+ <div class="note">This directive is not supported on Windows.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -187,7 +199,7 @@
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the DocumentRoot based on the given environment
variable, such as a per-user LDAP property</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPDocRootEnv <em>envvar</em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code><em>unset</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
@@ -202,7 +214,29 @@
the value of an environment variable based on the logged in
user or another condition (similar to <code class="module"><a href="../mod/mod_env.html">mod_env</a></code>
or <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code> to change FTP's Document Root
- on a per-user basis.</p>
+ on a per-user basis.</p>
+ <div class="note">This directive is <strong>not</strong> inherited from the
+ global configuration file.</div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="FTPEPSVIgnoreFamily" id="FTPEPSVIgnoreFamily">FTPEPSVIgnoreFamily</a> <a name="ftpepsvignorefamily" id="ftpepsvignorefamily">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Force EPSV to ignore the requested IP family
+ (IPv4 vs. IPv6)</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPEPSVIgnoreFamily <em>On</em></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
+<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
+</table>
+ <p>This directive allows the client's <code>EPSV</code> request to bind
+ to the local address, ignoring IPv4 vs. IPv6 requested by the client,
+ in order to work around network address translation which presented
+ an apparently different family.
+ You may find this useful when the FTP Server is behind a firewall.</p>
+ <div class="note">This directive is <strong>not</strong> inherited from the global
+ configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -211,7 +245,7 @@
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set logout message</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPExitMessage
<em>message</em>|<em>file:/path/to/file</em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code /></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code><em>none</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
@@ -220,8 +254,6 @@
path to a file. The message can contain a variety of
meta-characters (see
<code class="directive"><a href="#ftpbannermessage">FTPBannerMessage</a></code>).</p>
- <div class="note">This directive is inherited to all virtual hosts from the
- global configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -230,7 +262,7 @@
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the path to directory
containing user's home directories</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPHomeDir /directory</code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code><em>unset</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
@@ -239,15 +271,17 @@
but is actually relative to the configured
<code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> for the server. For
example, <code>FTPHomeDir /home</code> will cause the Apache FTP
- Server to look for the user home in the directory <code class="directive"><a href="../mod/code.html#documentroot">DocumentRoot</a></code><code>/home/</code><code>username</code>
- (where <em>username</em> is the login name of the user).</p>
+ Server to look for the user home in the directory <code class="directive"><a href="../mod/code.html#documentroot">DocumentRoot</a></code><code>/home/</code><code>username</code>
+ (where <em>username</em> is the login name of the user).</p>
<p>If <code class="directive">FTPHomeDir</code> has been specified and
the home directory for the user does not exist, the server logs
an error and user is logged into the root
("<code>/</code>") directory. If you want the home
directory created automatically, see the
<code class="directive">CreateHomeDirs</code> option to the
- <code class="directive"><a href="#ftpoptions">FTPOptions</a></code> directive.</p>
+ <code class="directive"><a href="#ftpoptions">FTPOptions</a></code> directive.</p>
+ <div class="note">This directive is <strong>not</strong> inherited from the
+ global configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -284,7 +318,7 @@
<p>This directive confines the user to the directory tree in
which they were placed upon login. The user can access any
subdirectory of their default directory, but cannot access the
- parent directory or any other related directories.</p>
+ parent directory or any other related directories.</p>
<p>If the <code class="directive"><a href="#ftphomedir">FTPHomeDir</a></code>
directive is not used, then <code class="directive">FTPJailUser</code>
has no effect. This combination of directives can be very
@@ -299,7 +333,7 @@
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the location for the Login Limit DB file</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPLimitDBFile <em>file-path</em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code><em>unset</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
@@ -341,7 +375,7 @@
<p>This directive allows the administrator to limit the total
number of concurrent/simultaneous FTP logins. For example, if
set to 10, no more than 10 FTP logins would be allowed. The
- default value is 0 (unlimited).</p>
+ default value is 0 (unlimited).</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -374,8 +408,6 @@
<p>This directive controls the number of failed
<em>attempts</em> to log in that are allowed before breaking
the connection and logging the failed attempts.</p>
- <div class="note">This directive is inherited to all virtual hosts from the
- global configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -407,15 +439,15 @@
accept queue until another client disconnects.</p>
</dd>
<dt><code>CreateHomeDirs</code></dt>
- <dd><p>This option causes the server to automatically create a
- home directory in the location specified by the
+ <dd><p>This option causes the server to automatically create a
+ home directory in the location specified by the
<code class="directive"><a href="#ftphomedir">FTPHomeDir</a></code> directive.
If the <code class="directive"><a href="#ftphomedir">FTPHomeDir</a></code>
directive is not specified, this option has no effect.</p>
<div class="note"><p>Setting this option on an anonymous site is not
recommended. This is because a directory is created for
each unique user (usually identified by their email
- address) that logs onto the server. </p>
+ address) that logs onto the server. </p>
<p>This option will only work if the <code class="directive"><a href="#ftphomedir">FTPHomeDir</a></code> directories are
accessible to the process owner of the Apache HTTP Server,
typically on UNIX systems the user
@@ -439,7 +471,7 @@
<div class="note"><p>
Setting this option will cause commands that request
multiple files to fail and should be used with
- caution.</p>
+ caution.</p>
</div>
</dd>
<dt><code>NLSTisLIST</code></dt>
@@ -452,7 +484,7 @@
<div class="note">
<p>Setting this option will cause commands that request
multiple files to fail and should be used with
- caution.</p>
+ caution.</p>
</div>
</dd>
<dt><code>LISTisNLST</code></dt>
@@ -462,7 +494,7 @@
<code class="directive">NLSTisLIST</code>, the output is a list of
files without details. If the -l option is passed to
<code>LIST</code> requests, details will be provided,
- whether this option is set or not.</p>
+ whether this option is set or not.</p>
</dd>
<dt><code>ShowUnAuthorizedFiles</code></dt>
<dd><p>This option causes
@@ -470,7 +502,7 @@
authorization to retrieve and directories that the user
does not have authorization to enter (<code>cd</code> will
fail) when it receives a <code>LIST</code> or similar
- <code>NLST</code> command. These commands will then behave
+ <code>NLST</code> command. These commands will then behave
as most standard FTP servers, where users see the list of
all files and directories, even those they are not allowed
to access.</p>
@@ -481,20 +513,24 @@
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FTPPASVaddr" id="FTPPASVaddr">FTPPASVaddr</a> <a name="ftppasvaddr" id="ftppasvaddr">Directive</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the allowed PASV server IP address for the data
- channel</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the apparent server IP address for PASV data
+ channels</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPPASVAddr <em>IP address</em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>The server's actual IP address of the control channel
+ connection.</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
</table>
- <p>This directive allows you to specify a different <em>IP
- address</em> to be sent on replies to <code>PASV</code> requests.
- You will find this useful when the FTP Server is behind a
- firewall.</p>
+ <p>This directive allows you to specify a different <em>IP address</em>
+ to be presented to the client in response to <code>PASV</code>
+ requests. It has no effect on the IP address the server will
+ listen on, use <code class="directive"><a href="#ftppasvbindaddr">FTPPASVbindaddr</a></code>
+ instead to affect the IP address of the actual data connection.</p>
+ <p>You may find this useful when the FTP Server is behind a firewall.
+ It has <em>no</em> effect on <code>EPSV</code> requests.</p>
<div class="note">This directive is <strong>not</strong> inherited from the global
- configuration file.</div>
+ configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -503,58 +539,69 @@
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set and bind the allowed PASV server IP address for
the data channel</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPPASVbindaddr <em>IP address</em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>The specified FTPPASVaddr, or in it's absense, the server's
+ actual IP address of the control channel connection.</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
</table>
- <p>This directive is identical to
- <code class="directive"><a href="#ftppasvaddr">FTPPASVaddr</a></code> except
- that the Apache FTP Server attempts to bind to the specified
- <em>IP address</em>.</p>
+ <p>This directive is similar to the
+ <code class="directive"><a href="#ftppasvaddr">FTPPASVaddr</a></code> directive,
+ except that the Apache FTP Server attempts to bind to the specified
+ <em>IP address</em>, and note that any
+ <code class="directive"><a href="#ftppasvaddr">FTPPASVaddr</a></code> directive
+ continues to override the address presented to the client.</p>
+ <p>You may find this useful when the FTP Server is behind a firewall.
+ It has <em>no</em> effect on <code>EPSV</code> requests.</p>
<div class="note">This directive is <strong>not</strong> inherited from the
- global configuration file.</div>
+ global configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FTPPASVrange" id="FTPPASVrange">FTPPASVrange</a> <a name="ftppasvrange" id="ftppasvrange">Directive</a></h2>
<table class="directive">
-<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the allowed PASV port range</td></tr>
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the allowed passive port range</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPPASVrange <em>number number</em></code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>If this directive is not specified, the server will use
+ an arbitrary ephemeral high-numbered port</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
</table>
<p>This directive defines the port range (<em>number</em> to
- <em>number</em> inclusive) to be used for passive connections.
- This directive is designed for use in environments where you
- only want to open a specific range of ports on your
- firewall.</p>
- <div class="note">This directive is inherited to all virtual hosts from the
- global configuration file.</div>
+ <em>number</em> inclusive) to be used for all passive connections,
+ including <code>PASV</code> and <code>EPSV</code> requests.
+ This directive is designed for use in environments where you
+ only want to open a specific range of ports on your
+ firewall.</p>
+ <div class="note">Use a sufficient range to satisfy all client requests!
+ Between the time that the server answers a <code>PASV</code>
+ or <code>EPSV</code> request, and the point at which the client
+ connects to the indiciated port, that specific port is
+ unavailable to any other client.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="FTPReadmeMessage" id="FTPReadmeMessage">FTPReadmeMessage</a> <a name="ftpreadmemessage" id="ftpreadmemessage">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set per-directory Readme file</td></tr>
-<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPReadmeMessage
+<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPReadmeMessage
<em>message</em>|<em>file:/path/to/file</em>
</code></td></tr>
-<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>Unset</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code><em>none</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>Any</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
</table><p>This directive sets a <em>message</em> that is displayed
to the client upon entering a new directory. This can either
be a string, or a path to a file. The message can contain a
- variety of meta-characters (see <code class="directive"><a href="#ftpbannermessage">FTPBannerMessage</a></code>).</p>
+ variety of meta-characters (see <code class="directive"><a href="#ftpbannermessage">FTPBannerMessage</a></code>).</p>
<p>When this directive is placed in the <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> container, the README
message will apply to all directories. When it is used in a
<code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>
container or placed in an <code>.htaccess</code> file, only
- that directory will inherit the README message.</p>
+ that directory will inherit the README message.</p>
<p>Configuring a README message for a directory will also override any
global README messages.</p>
@@ -573,8 +620,6 @@
will wait during a data transfer. If no data is sent to the
client in this amount of time, the data connection is
closed.</p>
- <div class="note">This directive is inherited to all virtual hosts from the
- global configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -591,8 +636,6 @@
allowed between commands sent by the client. If no commands
are received in this amount of time, the user is
disconnected.</p>
- <div class="note">This directive is inherited to all virtual hosts from the
- global configuration file.</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -608,9 +651,7 @@
<p>This directive sets the amount of <em>time</em> in seconds
that a user has to send a username to the server. If the
username is not received in this amount of time, the user is
- disconnected.</p>
- <div class="note">This directive is inherited to all virtual hosts from the
- global configuration file.</div>
+ disconnected.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -619,16 +660,15 @@
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Set the umask for created files</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>FTPUmask <em>umask</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>FTPUmask 022</code></td></tr>
-<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host</td></tr>
+<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>External</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_ftp</td></tr>
</table>
<p>This directive sets the permission mask for file creation
access. The default is 022 which gives the owner complete
access and disables write access for the group and other
- users.</p>
- <div class="note">This directive is inherited to all virtual
- hosts from the global configuration file.</div>
+ users.</p>
<div class="note">This directive is not supported on Windows.</div>
</div>
@@ -636,6 +676,6 @@
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/mod/mod_ftp.html" title="English"> en </a></p>
</div><div id="footer">
-<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="apache">Copyright 2007 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
</body></html>