however the caching of partial content is not yet supported by this
module.</p>
- <div class="example"><p><code>
- # Turn on caching<br />
- CacheSocache shmcb<br />
- CacheSocacheMaxSize 102400<br />
- <Location /foo><br />
- <span class="indent">
- CacheEnable socache<br />
- </span>
- </Location><br />
- <br />
- # Fall back to the disk cache<br />
- CacheSocache shmcb<br />
- CacheSocacheMaxSize 102400<br />
- <Location /foo><br />
- <span class="indent">
- CacheEnable socache<br />
- CacheEnable disk<br />
- </span>
- </Location><br />
- </code></p></div>
+ <pre class="prettyprint lang-config">
+# Turn on caching
+CacheSocache shmcb
+CacheSocacheMaxSize 102400
+<Location /foo>
+ CacheEnable socache
+</Location>
+
+# Fall back to the disk cache
+CacheSocache shmcb
+CacheSocacheMaxSize 102400
+<Location /foo>
+ CacheEnable socache
+ CacheEnable disk
+</Location>
+ </pre>
+
<div class="note"><h3>Note:</h3>
<p><code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code> requires the services of
implementations</a> of shared object caches are available to choose
from.</p>
- <div class="example"><p><code>
+ <pre class="prettyprint lang-config">
CacheSocache shmcb
- </code></p></div>
+ </pre>
+
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
responses larger than those cacheable within
<code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code>.</p>
- <div class="example"><p><code>
+ <pre class="prettyprint lang-config">
CacheSocacheMaxSize 102400
- </code></p></div>
+ </pre>
+
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
the cache. This value overrides the freshness lifetime defined for the
document by the HTTP protocol.</p>
- <div class="example"><p><code>
+ <pre class="prettyprint lang-config">
CacheSocacheMaxTime 86400
- </code></p></div>
+ </pre>
+
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
only stored for its freshness lifetime, there will be no opportunity to
revalidate the response to make it fresh again.</p>
- <div class="example"><p><code>
+ <pre class="prettyprint lang-config">
CacheSocacheMinTime 600
- </code></p></div>
+ </pre>
+
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<p>This directive only takes effect when the data is being saved to the
cache, as opposed to data being served from the cache.</p>
- <div class="example"><p><code>
+ <pre class="prettyprint lang-config">
CacheReadSize 102400
- </code></p></div>
+ </pre>
+
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
to ensure that the server does not buffer excessively should data arrive faster
than expected.</p>
- <div class="example"><p><code>
+ <pre class="prettyprint lang-config">
CacheSocacheReadTime 1000
- </code></p></div>
+ </pre>
+
</div>
</div>
accessed. Set to "<code>.</code>" to look in the same directory
as the file:</p>
- <div class="example"><p><code>MetaDir .</code></p></div>
+ <pre class="prettyprint lang-config">MetaDir .</pre>
+
<p>Or, to set it to a subdirectory of the directory containing the
files:</p>
- <div class="example"><p><code>MetaDir .meta</code></p></div>
+ <pre class="prettyprint lang-config">MetaDir .meta</pre>
+
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
</p>
<div class="example"><h3>Example</h3><p><code>
+ <pre class="prettyprint lang-config">
ScriptLog logs/cgi_log
+ </pre>
+
</code></p></div>
<p>This log will be opened as the user the child processes run
write in the directory where the socket is located.</p>
<div class="example"><h3>Example</h3><p><code>
+ <pre class="prettyprint lang-config">
ScriptSock /var/run/cgid.sock
+ </pre>
+
</code></p></div>
supported by iconv.</p>
<div class="example"><h3>Example</h3><p><code>
- <Directory /export/home/trawick/apacheinst/htdocs/convert><br />
- <span class="indent">
- CharsetSourceEnc UTF-16BE<br />
- CharsetDefault ISO-8859-1<br />
- </span>
- </Directory>
+ <pre class="prettyprint lang-config">
+<Directory /export/home/trawick/apacheinst/htdocs/convert>
+ CharsetSourceEnc UTF-16BE
+ CharsetDefault ISO-8859-1
+</Directory>
+ </pre>
+
</code></p></div>
<div class="note">
supported by iconv.</p>
<div class="example"><h3>Example</h3><p><code>
- <Directory /export/home/trawick/apacheinst/htdocs/convert><br />
- <span class="indent">
- CharsetSourceEnc UTF-16BE<br />
- CharsetDefault ISO-8859-1<br />
- </span>
- </Directory>
+ <pre class="prettyprint lang-config">
+<Directory /export/home/trawick/apacheinst/htdocs/convert>
+ CharsetSourceEnc UTF-16BE
+ CharsetDefault ISO-8859-1
+</Directory>
+ </pre>
+
</code></p></div>
<p>The character set names in this example work with the iconv
module.</p>
<div class="example"><h3>Configuring the filter</h3><p><code>
- <Location /data/images><br />
- <span class="indent">
- SetOutputFilter DATA
- </span>
- </Location><br />
+ <pre class="prettyprint lang-config">
+<Location /data/images>
+ SetOutputFilter DATA
+</Location>
+ </pre>
+
</code></p></div>
</div>
<p>To enable <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>, add the following to a
container in your <code>httpd.conf</code> file:</p>
- <div class="example"><p><code>Dav On</code></p></div>
+ <pre class="prettyprint lang-config">Dav On</pre>
+
<p>This enables the DAV file system provider, which is implemented
by the <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> module. Therefore, that module
file using the <code class="directive"><a href="../mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code>
directive:</p>
- <div class="example"><p><code>
+ <pre class="prettyprint lang-config">
DavLockDB /usr/local/apache2/var/DavLock
- </code></p></div>
+ </pre>
+
<p>The directory containing the lock database file must be
writable by the <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code>
requests.</p>
<div class="example"><h3>Full Example</h3><p><code>
- DavLockDB /usr/local/apache2/var/DavLock<br />
- <br />
- <Directory /usr/local/apache2/htdocs/foo><br />
- <span class="indent">
- Require all granted<br />
- Dav On<br />
- <br />
- AuthType Basic<br />
- AuthName DAV<br />
- AuthUserFile user.passwd<br />
- <br />
- <LimitExcept GET POST OPTIONS><br />
- <span class="indent">
- Require user admin<br />
- </span>
- </LimitExcept><br />
- </span>
- </Directory><br />
+ <pre class="prettyprint lang-config">
+DavLockDB /usr/local/apache2/var/DavLock
+
+<Directory /usr/local/apache2/htdocs/foo>
+ Require all granted
+ Dav On
+
+ AuthType Basic
+ AuthName DAV
+ AuthUserFile user.passwd
+
+ <LimitExcept GET POST OPTIONS>
+ Require user admin
+ </LimitExcept>
+</Directory>
+ </pre>
+
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
will run the script, and one of which will allow it to be
downloaded and manipulated with DAV.</p>
-<div class="example"><p><code>
-Alias /phparea /home/gstein/php_files<br />
-Alias /php-source /home/gstein/php_files<br />
+<pre class="prettyprint lang-config">
+Alias /phparea /home/gstein/php_files
+Alias /php-source /home/gstein/php_files
<Location /php-source>
-<span class="indent">
- DAV On<br />
- ForceType text/plain<br />
-</span>
+ DAV On
+ ForceType text/plain
</Location>
-</code></p></div>
+</pre>
+
<p>With this setup, <code>http://example.com/phparea</code> can be
used to access the output of the PHP scripts, and
<p>Use the <code class="directive">Dav</code> directive to enable the
WebDAV HTTP methods for the given container:</p>
- <div class="example"><p><code>
- <Location /foo><br />
- <span class="indent">
- Dav On<br />
- </span>
- </Location>
- </code></p></div>
+ <pre class="prettyprint lang-config">
+<Location /foo>
+ Dav On
+</Location>
+ </pre>
+
<p>The value <code>On</code> is actually an alias for the default
provider <code>filesystem</code> which is served by the <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> module. Note, that once you have DAV enabled
the lock due to network latency.</p>
<div class="example"><h3>Example</h3><p><code>
- <Location /MSWord><br />
- <span class="indent">
- DavMinTimeout 600<br />
- </span>
- </Location>
+ <pre class="prettyprint lang-config">
+<Location /MSWord>
+ DavMinTimeout 600
+</Location>
+ </pre>
+
</code></p></div>
</div>
directive:</p>
<div class="example"><h3>Example</h3><p><code>
+ <pre class="prettyprint lang-config">
Dav filesystem
+ </pre>
+
</code></p></div>
<p>Since <code>filesystem</code> is the default provider for
<div class="example"><h3>Example</h3><p><code>
+ <pre class="prettyprint lang-config">
DavLockDB var/DavLock
+ </pre>
+
</code></p></div>
<p>The directory containing the lock database file must be
locks.</p>
<div class="example"><h3>Example</h3><p><code>
+ <pre class="prettyprint lang-config">
DavGenericLockDB var/DavLock
+ </pre>
+
</code></p></div>
<p>The directory containing the lock database file must be
by the various old modem standards. So, you can browse your site with a 56k
V.92 modem, by adding something like this:</p>
-<div class="example"><p><code>
-<Location /mysite><br />
-ModemStandard V.92<br />
+<pre class="prettyprint lang-config">
+<Location /mysite>
+ ModemStandard V.92
</Location>
-</code></p></div>
+</pre>
+
<p>Previously to do bandwidth rate limiting modules would have to block an entire
thread, for each client, and insert sleeps to slow the bandwidth down.
</table>
<p>Specify what modem standard you wish to simulate.</p>
-<div class="example"><p><code>
-<Location /mysite><br />
-ModemStandard V.26bis<br />
+<pre class="prettyprint lang-config">
+<Location /mysite>
+ ModemStandard V.26bis
</Location>
-</code></p></div>
+</pre>
+
</div>
directory.</p>
<div class="example"><h3>Example</h3><p><code>
+ <pre class="prettyprint lang-config">
DirectoryIndex index.html
+ </pre>
+
</code></p></div>
<p>then a request for <code>http://example.com/docs/</code> would
<p>Note that the documents do not need to be relative to the
directory;</p>
- <div class="example"><p><code>
+ <pre class="prettyprint lang-config">
DirectoryIndex index.html index.txt /cgi-bin/index.pl
- </code></p></div>
+ </pre>
+
<p>would cause the CGI script <code>/cgi-bin/index.pl</code> to be
executed if neither <code>index.html</code> or <code>index.txt</code>
to instead be issued.</p>
<div class="example"><h3>Example</h3><p><code>
+ <pre class="prettyprint lang-config">
DirectoryIndexRedirect on
+ </pre>
+
</code></p></div>
<p>A request for <code>http://example.com/docs/</code> would
be aware that there are possible security implications to doing
this.</p>
- <div class="example"><p><code>
- # see security warning below!<br />
- <Location /some/path><br />
- <span class="indent">
- DirectorySlash Off<br />
- SetHandler some-handler<br />
- </span>
- </Location>
- </code></p></div>
+ <pre class="prettyprint lang-config">
+# see security warning below!
+<Location /some/path>
+ DirectorySlash Off
+ SetHandler some-handler
+</Location>
+ </pre>
+
<div class="warning"><h3>Security Warning</h3>
<p>Turning off the trailing slash redirect may result in an information
<p>Use this to set a handler for any URL that doesn't map to anything
in your filesystem, and would otherwise return HTTP 404 (Not Found).
For example</p>
- <div class="example"><p><code>
- <code>FallbackResource /not-404.php</code>
- </code></p></div>
+ <pre class="prettyprint lang-config">
+ FallbackResource /not-404.php
+ </pre>
+
<p>will cause requests for non-existent files to be handled by
<code>not-404.php</code>, while requests for files that exist
are unaffected.</p>
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, and the use of the <code>-f</code> and
<code>-d</code> tests for file and directory existence. This now
requires only one line of configuration.</p>
- <div class="example"><p><code>
- <code>FallbackResource /index.php</code>
- </code></p></div>
+ <pre class="prettyprint lang-config">
+ FallbackResource /index.php
+ </pre>
+
<p>Existing files, such as images, css files, and so on, will be
served normally.</p>
<p>In a sub-URI, such as <em>http://example.com/blog/</em> this
<em>sub-URI</em> has to be supplied as <var>local-url</var>:</p>
- <div class="example"><p><code>
- <code>
- <Directory /web/example.com/htdocs/blog><br />
- <span class="indent">
- FallbackResource /blog/index.php<br />
- </span>
- </Directory>
- </code>
- </code></p></div>
+ <pre class="prettyprint lang-config">
+<Directory /web/example.com/htdocs/blog>
+ FallbackResource /blog/index.php
+</Directory>
+ </pre>
+
</div>
</div>
the below directives. Additionally, <code class="module"><a href="../mod/mod_dumpio.html">mod_dumpio</a></code>
needs to be configured to <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> <code>trace7</code>:
</p>
- <div class="example"><p><code>
+ <pre class="prettyprint lang-config">
LogLevel dumpio:trace7
- </code></p></div>
+ </pre>
+
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="DumpIOInput" id="DumpIOInput">DumpIOInput</a> <a name="dumpioinput" id="dumpioinput">Directive</a></h2>
<p>Enable dumping of all input.</p>
<div class="example"><h3>Example</h3><p><code>
+ <pre class="prettyprint lang-config">
DumpIOInput On
+ </pre>
+
</code></p></div>
</div>
<p>Enable dumping of all output.</p>
<div class="example"><h3>Example</h3><p><code>
+ <pre class="prettyprint lang-config">
DumpIOOutput On
+ </pre>
+
</code></p></div>
</div>