server-wide.xml revision dfc515decf0e3a5a980ec4e06af4eb76d4a95440
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<!-- $LastChangedRevision$ -->
5a58787efeb02a1c3f06569d019ad81fd2efa06end Licensed to the Apache Software Foundation (ASF) under one or more
5a58787efeb02a1c3f06569d019ad81fd2efa06end contributor license agreements. See the NOTICE file distributed with
5a58787efeb02a1c3f06569d019ad81fd2efa06end this work for additional information regarding copyright ownership.
5a58787efeb02a1c3f06569d019ad81fd2efa06end The ASF licenses this file to You under the Apache License, Version 2.0
5a58787efeb02a1c3f06569d019ad81fd2efa06end (the "License"); you may not use this file except in compliance with
5a58787efeb02a1c3f06569d019ad81fd2efa06end the License. You may obtain a copy of the License at
5a58787efeb02a1c3f06569d019ad81fd2efa06end Unless required by applicable law or agreed to in writing, software
5a58787efeb02a1c3f06569d019ad81fd2efa06end distributed under the License is distributed on an "AS IS" BASIS,
5a58787efeb02a1c3f06569d019ad81fd2efa06end WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
5a58787efeb02a1c3f06569d019ad81fd2efa06end See the License for the specific language governing permissions and
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd limitations under the License.
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<p>This document explains some of the directives provided by
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kessthe <module>core</module> server which are used to configure
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kessthe basic operations of the server.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <directivelist>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <directive module="core">UseCanonicalPhysicalPort</directive>
5a58787efeb02a1c3f06569d019ad81fd2efa06end </directivelist>
5a58787efeb02a1c3f06569d019ad81fd2efa06end </related>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <p>The <directive module="core">ServerAdmin</directive> and
5a58787efeb02a1c3f06569d019ad81fd2efa06end <directive module="core">ServerTokens</directive> directives
5a58787efeb02a1c3f06569d019ad81fd2efa06end control what information about the server will be presented
5a58787efeb02a1c3f06569d019ad81fd2efa06end in server-generated documents such as error messages. The
5a58787efeb02a1c3f06569d019ad81fd2efa06end <directive module="core">ServerTokens</directive> directive
5a58787efeb02a1c3f06569d019ad81fd2efa06end sets the value of the Server HTTP response header field.</p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end <directive module="core">UseCanonicalName</directive> and
5a58787efeb02a1c3f06569d019ad81fd2efa06end <directive module="core">UseCanonicalPhysicalPort</directive>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess directives are used by the server to determine how to construct
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess self-referential URLs. For example, when a client requests a
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess directory, but does not include the trailing slash in the
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess directory name, httpd must redirect the client to the full
261c62b53a9c707c64c7824eed68b5463bd23e62nd name including the trailing slash so that the client will
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess correctly resolve relative references in the document.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </section>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <directivelist>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <directive module="mpm_common">CoreDumpDirectory</directive>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <directive module="mpm_common">ScoreBoardFile</directive>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </directivelist>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </related>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>These directives control the locations of the various files
dcf73e82ff6eda04fc24e50753631fd83bf61f3drbowen that httpd needs for proper operation. When the pathname used
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess does not begin with a slash (/), the files are located relative
dcf73e82ff6eda04fc24e50753631fd83bf61f3drbowen to the <directive module="core">ServerRoot</directive>. Be careful
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess about locating files in paths which are writable by non-root users.
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess See the <a href="misc/security_tips.html#serverroot">security tips</a>
261c62b53a9c707c64c7824eed68b5463bd23e62nd documentation for more details.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </section>
dcf73e82ff6eda04fc24e50753631fd83bf61f3drbowen <directivelist>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <directive module="core">LimitRequestFields</directive>
261c62b53a9c707c64c7824eed68b5463bd23e62nd <directive module="core">LimitRequestFieldsize</directive>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <directive module="mpm_common">ThreadStackSize</directive>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </directivelist>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </related>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess directives are used to place limits on the amount of resources
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess httpd will use in reading requests from clients. By limiting
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess these values, some kinds of denial of service attacks can be
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess mitigated.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess are used to limit the amount of resources which can be used by
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess processes forked off from the httpd children. In particular,
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess this will control resources used by CGI scripts and SSI exec
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess commands.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The <directive module="mpm_common">ThreadStackSize</directive>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess directive is used with some platforms to control the stack size.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </section>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <directivelist>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </directivelist>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </related>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The <directive>Mutex</directive> directive can be used to change
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess the underlying implementation used for mutexes, in order to relieve
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess functional or performance problems with <glossary>APR</glossary>'s
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess default choice.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess </section>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess</manualpage>