httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From (David Robinson)
Subject DirectoryIndex documentation
Date Tue, 25 Jul 1995 14:46:00 GMT
The documentation for DirectoryIndex is a bit misleading, as it seems to
allow URL paths to anywhere on the server. It also seems possible to
hang apache, both with an infinite loop like
DirectoryIndex /
but more strangely, with
DirectoryIndex /~drtr/zzz.html

A revised entry for srm.conf.html follows; could someone upload it to
hyperreal? (The transatlantic link is half down at the moment.)


<H1><A name="index">DirectoryIndex</A></H1>

<P>(n.b. this extends the NCSA httpd 1.3 syntax to a relative URL rather than
a filename, and allow multiple URLs )

<blockquote><code>DirectoryIndex</code> <em>Local-URL Local-URL ...</em>

<P>This specifies what document the server returns when the user specifies
a NULL file at the end of a directory name. The <em>Local-URL</em> a a URL
of a document on the server relative to the requested directory;
it is usually simply the name of a file in the directory. For example  Most
people use a file called <code>index.html</code>; so
<blockquote><code>DirectoryIndex index.html</code></blockquote>
means that a request for
would actually return the document

<P>Apache allows you to define any number of these documents,
and Apache will search for each in turn, until it finds a match or it
has exauhsted all the documents. e.g.

<blockquote><code>DirectoryIndex index.html index.txt /cgi-bin/</code>

<P>Typically, you'll set <CODE>DirectoryIndex</CODE> to
<CODE>index.html</CODE>.  You may want to set it to <CODE>index</CODE>,
thus allowing <a href="content-negotiation.html">content-negotiation</a> to
work for an HTML 2.0 document named "index.html" and an HTML 3.0 document named

View raw message