src - OpenBSD base system

diff options


context:
space:
mode:

author	Henning Brauer <henning@cvs.openbsd.org>	2002-10-07 20:51:34 +0000
committer	Henning Brauer <henning@cvs.openbsd.org>	2002-10-07 20:51:34 +0000
commit	7fa1d28795f1a4bfed78b1b72aea15da37af2b41 (patch)
tree	3cef7fb654e7cf7f733e17f51f6201df34c7d62a
parent	0d976423350c2c6fb5a6df51f06c7f219b9d7f2d (diff)

gone to the big harddrive in the sky

Diffstat

-rw-r--r--

usr.sbin/httpd/htdocs/manual/mod/mod_alias.html

395

1 files changed, 0 insertions, 395 deletions

diff --git a/usr.sbin/httpd/htdocs/manual/mod/mod_alias.html b/usr.sbin/httpd/htdocs/manual/mod/mod_alias.html
deleted file mode 100644
index 3a39c6dc001..00000000000
--- a/usr.sbin/httpd/htdocs/manual/mod/mod_alias.html
+++ /dev/null

@@ -1,395 +0,0 @@

-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

-<html xmlns="http://www.w3.org/1999/xhtml">

- <head>

- <meta name="generator" content="HTML Tidy, see www.w3.org" />

- <title>Apache module mod_alias</title>

- </head>

-

- <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"

- vlink="#000080" alink="#FF0000">

- <div align="CENTER">

- <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" />

- <h3>Apache HTTP Server Version 1.3</h3>

- </div>

- <h1 align="CENTER">Module mod_alias</h1>

- This module provides for mapping different parts of the host

- filesystem in the document tree, and for URL redirection.

- <a href="module-dict.html#Status"

- rel="Help">Status:</a> Base

- <a href="module-dict.html#SourceFile"

- rel="Help">Source File:</a> mod_alias.c

- <a href="module-dict.html#ModuleIdentifier"

- rel="Help">Module Identifier:</a>

- alias_module

- <h2>Summary</h2>

- The directives contained in this module allow for

- manipulation and control of URLs as requests arrive at the

- server. The <code>Alias</code> and <code>ScriptAlias</code>

- directives are used to map between URLs and filesystem paths.

- This allows for content which is not directly under the <a

- href="core.html#documentroot"><code>DocumentRoot</code></a> to

- be served as part of the web document tree. The

- <code>ScriptAlias</code> directive has the additional effect of

- marking the target directory as containing only CGI

- scripts.

- The <code>Redirect</code> directives are used to instruct

- clients to make a new request with a different URL. They are

- often used when a resource has moved to a new location.

- A more powerful and flexible set of directives for

- manipulating URLs is contained in the <a

- href="mod_rewrite.html"><code>mod_rewrite</code></a>

- module.

- <h2>Directives</h2>

- <ul>

- <li><a href="#alias">Alias</a></li>

- <li><a href="#aliasmatch">AliasMatch</a></li>

- <li><a href="#redirect">Redirect</a></li>

- <li><a href="#redirectmatch">RedirectMatch</a></li>

- <li><a href="#redirecttemp">RedirectTemp</a></li>

- <li><a href="#redirectperm">RedirectPermanent</a></li>

- <li><a href="#scriptalias">ScriptAlias</a></li>

- <li><a href="#scriptaliasmatch">ScriptAliasMatch</a></li>

- </ul>

- <hr />

- <h2><a id="alias" name="alias">Alias directive</a></h2>

-

- <a href="directive-dict.html#Syntax"

- rel="Help">Syntax:</a> Alias URL-path

- file-path|directory-path

- <a href="directive-dict.html#Context"

- rel="Help">Context:</a> server config, virtual

- host

- <a href="directive-dict.html#Status"

- rel="Help">Status:</a> Base

- <a href="directive-dict.html#Module"

- rel="Help">Module:</a> mod_alias

- The Alias directive allows documents to be stored in the

- local filesystem other than under the <a

- href="core.html#documentroot">DocumentRoot</a>. URLs with a

- (%-decoded) path beginning with url-path will be

- mapped to local files beginning with

- directory-filename.

- Example:

- <blockquote>

- <code>Alias /image /ftp/pub/image</code>

- </blockquote>

- A request for http://myserver/image/foo.gif would cause the

- server to return the file /ftp/pub/image/foo.gif.

- Note that if you include a trailing / on the

- url-path then the server will require a trailing / in

- order to expand the alias. That is, if you use <code>Alias

- /icons/ /usr/local/apache/icons/</code> then the url

- <code>/icons</code> will not be aliased.

- Note that you may need to specify additional <a

- href="core.html#directory"><code><Directory></code></a>

- sections which cover the destination of aliases.

- Aliasing occurs before <code><Directory></code> sections

- are checked, so only the destination of aliases are affected.

- (Note however <a

- href="core.html#location"><code><Location></code></a>

- sections are run through once before aliases are performed, so

- they will apply.)

- See also <a href="#scriptalias">ScriptAlias</a>.

- <hr />

- <h2><a id="aliasmatch" name="aliasmatch">AliasMatch</a></h2>

- <a href="directive-dict.html#Syntax"

- rel="Help">Syntax:</a> AliasMatch regex

- file-path|directory-path

- <a href="directive-dict.html#Context"

- rel="Help">Context:</a> server config, virtual

- host

- <a href="directive-dict.html#Status"

- rel="Help">Status:</a> Base

- <a href="directive-dict.html#Module"

- rel="Help">Module:</a> mod_alias

- <a href="directive-dict.html#Compatibility"

- rel="Help">Compatibility:</a> Available in

- Apache 1.3 and later

- This directive is equivalent to <a href="#alias">Alias</a>,

- but makes use of standard regular expressions, instead of

- simple prefix matching. The supplied regular expression is

- matched against the URL-path, and if it matches, the server

- will substitute any parenthesized matches into the given string

- and use it as a filename. For example, to activate the

- <code>/icons</code> directory, one might use:

-<pre>

- AliasMatch ^/icons(.*) /usr/local/apache/icons$1

-</pre>

- <hr />

- <h2><a id="redirect" name="redirect">Redirect

- directive</a></h2>

-

- <a href="directive-dict.html#Syntax"

- rel="Help">Syntax:</a> Redirect

- [status] URL-path URL

- <a href="directive-dict.html#Context"

- rel="Help">Context:</a> server config, virtual

- host, directory, .htaccess

- <a href="directive-dict.html#Override"

- rel="Help">Override:</a> FileInfo

- <a href="directive-dict.html#Status"

- rel="Help">Status:</a> Base

- <a href="directive-dict.html#Module"

- rel="Help">Module:</a> mod_alias

- <a href="directive-dict.html#Compatibility"

- rel="Help">Compatibility:</a> The directory

- and .htaccess context's are only available in versions 1.1 and

- later. The status argument is only available in Apache

- 1.2 or later.

- The Redirect directive maps an old URL into a new one. The

- new URL is returned to the client which attempts to fetch it

- again with the new address. URL-path a (%-decoded)

- path; any requests for documents beginning with this path will

- be returned a redirect error to a new (%-encoded) URL beginning

- with URL.

- Example:

- <blockquote>

- <code>Redirect /service http://foo2.bar.com/service</code>

- </blockquote>

- If the client requests http://myserver/service/foo.txt, it

- will be told to access http://foo2.bar.com/service/foo.txt

- instead.

- Note: Redirect directives take precedence

- over Alias and ScriptAlias directives, irrespective of their

- ordering in the configuration file. Also, URL-path

- must be an absolute path, not a relative path, even when used

- with .htaccess files or inside of <Directory>

- sections.

- If no status argument is given, the redirect will

- be "temporary" (HTTP status 302). This indicates to the client

- that the resource has moved temporarily. The status

- argument can be used to return other HTTP status codes:

- <dl>

- <dt>permanent</dt>

- <dd>Returns a permanent redirect status (301) indicating that

- the resource has moved permanently.</dd>

- <dt>temp</dt>

- <dd>Returns a temporary redirect status (302). This is the

- default.</dd>

- <dt>seeother</dt>

- <dd>Returns a "See Other" status (303) indicating that the

- resource has been replaced.</dd>

- <dt>gone</dt>

- <dd>Returns a "Gone" status (410) indicating that the

- resource has been permanently removed. When this status is

- used the url argument should be omitted.</dd>

- </dl>

- Other status codes can be returned by giving the numeric

- status code as the value of status. If the status is

- between 300 and 399, the url argument must be present,

- otherwise it must be omitted. Note that the status must be

- known to the Apache code (see the function

- <code>send_error_response</code> in http_protocol.c).

- Example:

- <pre>

- Redirect permanent /one http://example.com/two

- Redirect 303 /two http://example.com/other

- </pre>

- <hr />

- <h2><a id="redirectmatch"

- name="redirectmatch">RedirectMatch</a></h2>

- <a href="directive-dict.html#Syntax"

- rel="Help">Syntax:</a> RedirectMatch

- [status] regex URL

- <a href="directive-dict.html#Context"

- rel="Help">Context:</a> server config, virtual

- host, directory, .htaccess

- <a href="directive-dict.html#Override"

- rel="Help">Override:</a> FileInfo

- <a href="directive-dict.html#Status"

- rel="Help">Status:</a> Base

- <a href="directive-dict.html#Module"

- rel="Help">Module:</a> mod_alias

- <a href="directive-dict.html#Compatibility"

- rel="Help">Compatibility:</a> Available in

- Apache 1.3 and later

- This directive is equivalent to <a

- href="#redirect">Redirect</a>, but makes use of standard

- regular expressions, instead of simple prefix matching. The

- supplied regular expression is matched against the URL-path,

- and if it matches, the server will substitute any parenthesized

- matches into the given string and use it as a filename. For

- example, to redirect all GIF files to like-named JPEG files on

- another server, one might use:

-<pre>

- RedirectMatch (.*)\.gif$ http://www.anotherserver.com$1.jpg

-</pre>

- <hr />

- <h2><a id="redirecttemp" name="redirecttemp">RedirectTemp

- directive</a></h2>

-

- <a href="directive-dict.html#Syntax"

- rel="Help">Syntax:</a> RedirectTemp

- URL-path URL

- <a href="directive-dict.html#Context"

- rel="Help">Context:</a> server config, virtual

- host, directory, .htaccess

- <a href="directive-dict.html#Override"

- rel="Help">Override:</a> FileInfo

- <a href="directive-dict.html#Status"

- rel="Help">Status:</a> Base

- <a href="directive-dict.html#Module"

- rel="Help">Module:</a> mod_alias

- <a href="directive-dict.html#Compatibility"

- rel="Help">Compatibility:</a> This directive

- is only available in Apache 1.2 and later

- This directive makes the client know that the Redirect is

- only temporary (status 302). Exactly equivalent to

- <code>Redirect temp</code>.

- <hr />

- <h2><a id="redirectperm" name="redirectperm">RedirectPermanent

- directive</a></h2>

-

- <a href="directive-dict.html#Syntax"

- rel="Help">Syntax:</a> RedirectPermanent

- URL-path URL

- <a href="directive-dict.html#Context"

- rel="Help">Context:</a> server config, virtual

- host, directory, .htaccess

- <a href="directive-dict.html#Override"

- rel="Help">Override:</a> FileInfo

- <a href="directive-dict.html#Status"

- rel="Help">Status:</a> Base

- <a href="directive-dict.html#Module"

- rel="Help">Module:</a> mod_alias

- <a href="directive-dict.html#Compatibility"

- rel="Help">Compatibility:</a> This directive

- is only available in Apache 1.2 and later

- This directive makes the client know that the Redirect is

- permanent (status 301). Exactly equivalent to <code>Redirect

- permanent</code>.

- <hr />

- <h2><a id="scriptalias" name="scriptalias">ScriptAlias

- directive</a></h2>

-

- <a href="directive-dict.html#Syntax"

- rel="Help">Syntax:</a> ScriptAlias

- URL-path file-path|directory-path

- <a href="directive-dict.html#Context"

- rel="Help">Context:</a> server config, virtual

- host

- <a href="directive-dict.html#Status"

- rel="Help">Status:</a> Base

- <a href="directive-dict.html#Module"

- rel="Help">Module:</a> mod_alias

- The ScriptAlias directive has the same behavior as the <a

- href="#alias">Alias</a> directive, except that in addition it

- marks the target directory as containing CGI scripts that will be

- processed by <a href="mod_cgi.html">mod_cgi</a>'s cgi-script

- handler. URLs with a (%-decoded) path beginning with

- URL-path will be mapped to scripts beginning with the

- second argument which is a full pathname in the local

- filesystem.

- Example:

- <blockquote>

- <code>ScriptAlias /cgi-bin/ /web/cgi-bin/</code>

- </blockquote>

- A request for http://myserver/cgi-bin/foo would cause the

- server to run the script /web/cgi-bin/foo.

- <hr />

- <h2><a id="scriptaliasmatch"

- name="scriptaliasmatch">ScriptAliasMatch</a></h2>

- <a href="directive-dict.html#Syntax"

- rel="Help">Syntax:</a> ScriptAliasMatch

- regex file-path|directory-path

- <a href="directive-dict.html#Context"

- rel="Help">Context:</a> server config, virtual

- host

- <a href="directive-dict.html#Status"

- rel="Help">Status:</a> Base

- <a href="directive-dict.html#Module"

- rel="Help">Module:</a> mod_alias

- <a href="directive-dict.html#Compatibility"

- rel="Help">Compatibility:</a> Available in

- Apache 1.3 and later

- This directive is equivalent to <a

- href="#scriptalias">ScriptAlias</a>, but makes use of standard

- regular expressions, instead of simple prefix matching. The

- supplied regular expression is matched against the URL-path,

- and if it matches, the server will substitute any parenthesized

- matches into the given string and use it as a filename. For

- example, to activate the standard <code>/cgi-bin</code>, one

- might use:

-<pre>

- ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1

-</pre>

- <hr />

- <h3 align="CENTER">Apache HTTP Server Version 1.3</h3>

- <a href="./"><img src="../images/index.gif" alt="Index" /></a>

- <a href="../"><img src="../images/home.gif" alt="Home" /></a>

- </body>

-</html>