]> granicus.if.org Git - apache/blob - docs/manual/mod/core.xml.de
19b00d1f2ccb8b1a321e70ea23a0be4ad86a634f
[apache] / docs / manual / mod / core.xml.de
1 <?xml version="1.0"?>
2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
4 <!-- English Revision: 344972:1855705 (outdated) -->
5
6 <!--
7  Licensed to the Apache Software Foundation (ASF) under one or more
8  contributor license agreements.  See the NOTICE file distributed with
9  this work for additional information regarding copyright ownership.
10  The ASF licenses this file to You under the Apache License, Version 2.0
11  (the "License"); you may not use this file except in compliance with
12  the License.  You may obtain a copy of the License at
13
14      http://www.apache.org/licenses/LICENSE-2.0
15
16  Unless required by applicable law or agreed to in writing, software
17  distributed under the License is distributed on an "AS IS" BASIS,
18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19  See the License for the specific language governing permissions and
20  limitations under the License.
21 -->
22
23 <modulesynopsis metafile="core.xml.meta">
24
25 <name>core</name>
26 <description>St&auml;ndig verf&uuml;gbare Kernfunktionen des Apache HTTP
27 Servers</description>
28 <status>Core</status>
29
30 <directivesynopsis>
31 <name>AcceptFilter</name>
32 <description>Konfiguriert Optimierungen f&uuml;r lauschende Sockets bestimmter
33 Protokolle</description>
34 <syntax>AcceptFilter <var>Protokoll</var> <var>Filter</var></syntax>
35 <contextlist><context>server config</context></contextlist>
36 <compatibility>Verf&uuml;gbar ab Apache 2.1.5</compatibility>
37
38 <usage>
39     <p>Diese Direktive aktiviert betriebssystemspezifische Optimierungen
40     f&uuml;r lauschende Sockets anhand des Protokolltyps. Der grundlegende
41     Ansatz ist, dass der Kernel das Socket nicht an den Serverprozess
42     &uuml;bergibt, bis entweder Daten verf&uuml;gbar sind oder eine komplette
43     HTTP-Anfrage zwischengespeichert wurde. Derzeit werden
44     ausschlie&szlig;lich die <a
45     href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&amp;sektion=9"
46     >Accept-Filter von FreeBSD</a> und das primitivere
47     <code>TCP_DEFER_ACCEPT</code> von Linux unterst&uuml;tzt.</p>
48
49     <p>Die Standardeinstellungen f&uuml;r FreeBSD sind:</p>
50     <example>
51         AcceptFilter http httpready<br />
52         AcceptFilter https dataready
53     </example>
54
55     <p>Der <code>httpready</code>-Accept-Filter puffert komplette
56     HTTP-Anfragen auf Kernelebene. Sobald eine Anfrage vollst&auml;ndig
57     vorliegt, schickt der Kernel sie an den Server weiter. Bitte schlagen Sie
58     in der <a
59     href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&amp;sektion=9"
60     >accf_http(9)</a>-Manpage f&uuml;r weitere Details nach. HTTPS-Anfragen
61     sind verschl&uuml;sselt. Daher wird daf&uuml;r nur der <a
62     href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&amp;sektion=9"
63     >accf_data(9)</a>-Filter verwendet.</p>
64
65     <p>Die Standardeinstellungen f&uuml;r Linux sind:</p>
66     <example>
67         AcceptFilter http data<br />
68         AcceptFilter https data
69     </example>
70
71     <p><code>TCP_DEFER_ACCEPT</code> unter Linux unterst&uuml;tzt keine
72     Zwischenspeicherung von HTTP-Anfragen. Jeder andere Wert als
73     <code>none</code> aktiviert <code>TCP_DEFER_ACCEPT</code> auf dem
74     Lauschsocket. Mehr Details finden Sie in der <a
75     href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/tcp.7.html"
76     >tcp(7)</a>-Manpage von Linux.</p>
77
78     <p>Wenn Sie <code>none</code> als Argument verwenden, werden alle
79     Accept-Filter f&uuml;r das Protokoll abgeschaltet. Das ist sinnvoll
80     f&uuml;r Protokolle, bei denen der Server zuerst Daten senden muss,
81     wie zum Beispiel <code>nntp</code>:</p>
82     <example>AcceptFilter nttp none</example>
83
84 </usage>
85 </directivesynopsis>
86
87 <directivesynopsis>
88 <name>AcceptPathInfo</name>
89 <description>Ressourcen lassen angeh&auml;ngte Pfadangaben zu</description>
90 <syntax>AcceptPathInfo On|Off|Default</syntax>
91 <default>AcceptPathInfo Default</default>
92 <contextlist><context>server config</context>
93 <context>virtual host</context><context>directory</context>
94 <context>.htaccess</context></contextlist>
95 <override>FileInfo</override>
96 <compatibility>Verf&uuml;gbar ab Apache 2.0.30</compatibility>
97
98 <usage>
99     <p>Die Direktive steuert, ob Anfragen akzeptiert oder
100     abgewiesen werden, bei denen nach der tats&auml;chlichen
101     Datei (oder einer nicht existierenden Datei in einem existierenden
102     Verzeichnis) zus&auml;tzliche Pfadangaben folgen. Die angeh&auml;ngte
103     Pfadangabe kann Skripten in der Umgebungsvariable <code>PATH_INFO</code>
104     verf&uuml;gbar gemacht werden.</p>
105
106     <p>Nehmen wir beispielsweise an, dass <code>/test/</code> auf ein
107     Verzeichnis zeigt, welches lediglich eine Datei <code>here.html</code>
108     enth&auml;lt. Dann wird bei Anfragen nach
109     <code>/test/here.html/more</code> und
110     <code>/test/nothere.html/more</code> beides Mal <code>/more</code>
111     als <code>PATH_INFO</code> ermittelt.</p>
112
113     <p>Die drei m&ouml;glichen Argumente f&uuml;r die Direktive
114     <directive>AcceptPathInfo</directive> sind:</p>
115
116     <dl>
117     <dt><code>Off</code></dt><dd>Eine Anfrage wird nur dann akzeptiert,
118     wenn sie exakt auf ein existierendes Verzeichnis (oder eine Datei)
119     abgebildet werden kann. Daher w&uuml;rde eine Anfrage mit einer nach dem
120     tats&auml;chlichen Dateinamen angeh&auml;ngten Pfadangabe, wie
121     <code>/test/here.html/more</code> im obigen Beispiel, den Fehler
122     404 NOT FOUND <transnote>nicht gefunden</transnote>
123     zur&uuml;ckgeben.</dd>
124
125     <dt><code>On</code></dt>
126     <dd>Eine Anfrage wird akzeptiert, wenn eine vorangestellte Pfadangabe
127     auf ein existierendes Verzeichnis abgebildet werden kann. Das
128     obige Beispiel <code>/test/here.html/more</code> wird akzeptiert,
129     wenn <code>/test/here.html</code> auf eine g&uuml;ltige Datei
130     zeigt.</dd>
131
132     <dt><code>Default</code></dt>
133     <dd>Die Behandlung von Anfragen mit angeh&auml;ngten Pfadangaben
134     wird von dem f&uuml;r die Anfrage verantwortlichen <a
135     href="../handler.html">Handler</a> bestimmt. Der Core-Handler
136     f&uuml;r gew&ouml;hnliche Dateien weist <code>PATH_INFO</code>-Zugriffe
137     standardm&auml;&szlig;ig zur&uuml;ck. Handler, die Skripte bedienen,
138     wie z.B. <a href="mod_cgi.html">cgi-script</a> und
139     <a href="mod_isapi.html">isapi-handler</a>, sind im Allgemeinen darauf
140     voreingestellt, <code>PATH_INFO</code> zu akzeptieren.</dd>
141     </dl>
142
143     <p>Das eigentliche Ziel von <code>AcceptPathInfo</code> ist es, Ihnen
144     das &Uuml;berschreiben der Voreinstellung der Handler bez&uuml;glich
145     der Akzeptanz oder Ablehnung von <code>PATH_INFO</code> zu erlauben.
146     Eine solche &Auml;nderung ist zum Beispiel notwendig, wenn Sie einen
147     <a href="../filter.html">Filter</a> wie <a
148     href="mod_include.html">INCLUDES</a> verwenden, um Inhalte
149     abh&auml;ngig von <code>PATH_INFO</code> zu generieren. Der
150     Core-Handler w&uuml;rde die Anfrage normalerweise abweisen. Verwenden
151     Sie die folgende Konfiguration, um dennoch solch ein Skript zu
152     erm&ouml;glichen.</p>
153
154     <example>
155       &lt;Files "mypaths.shtml"&gt;<br />
156       <indent>
157         Options +Includes<br />
158         SetOutputFilter INCLUDES<br />
159         AcceptPathInfo On<br />
160       </indent>
161       &lt;/Files&gt;
162     </example>
163
164 </usage>
165 </directivesynopsis>
166
167 <directivesynopsis>
168 <name>AccessFileName</name>
169 <description>Name der dezentralen Konfigurationsdateien</description>
170 <syntax>AccessFileName <var>Dateiname</var> [<var>Dateiname</var>] ...</syntax>
171 <default>AccessFileName .htaccess</default>
172 <contextlist><context>server config</context><context>virtual host</context>
173 </contextlist>
174
175 <usage>
176     <p>Aus dieser Namensliste sucht der Server w&auml;hrend der
177     Bearbeitung einer Anfrage in jedem Verzeichnis nach der ersten
178     existierenden Datei, sofern im betreffenden Verzeichnis dezentrale
179     Konfigurationsdateien <a href="#allowoverride">erlaubt sind</a>.
180     Beispiel:</p>
181
182     <example>
183       AccessFileName .acl
184     </example>
185
186     <p>Vor der R&uuml;cksendung des Dokuments
187     <code>/usr/local/web/index.html</code> wird der Server
188     <code>/.acl</code>, <code>/usr/.acl</code>,
189     <code>/usr/local/.acl</code> und <code>/usr/local/web/.acl</code>
190     einlesen, solange diese nicht mit</p>
191
192     <example>
193       &lt;Directory /&gt;<br />
194       <indent>
195         AllowOverride None<br />
196       </indent>
197       &lt;/Directory&gt;
198     </example>
199
200     <p>deaktiviert wurden.</p>
201 </usage>
202 <seealso><directive module="core">AllowOverride</directive></seealso>
203 <seealso><a href="../configuring.html">Konfigurationsdateien</a></seealso>
204 <seealso><a href="../howto/htaccess.html">.htaccess-Dateien</a></seealso>
205 </directivesynopsis>
206
207 <directivesynopsis>
208 <name>AddDefaultCharset</name>
209 <description>Standard-Charset-Parameter, der bei Antworten vom Content-Type 
210   <code>text/plain</code> oder <code>text/html</code> hinzugef&uuml;gt wird
211 </description>
212 <syntax>AddDefaultCharset On|Off|<var>Zeichenkodierung</var></syntax>
213 <default>AddDefaultCharset Off</default>
214 <contextlist><context>server config</context>
215 <context>virtual host</context><context>directory</context>
216 <context>.htaccess</context></contextlist>
217 <override>FileInfo</override>
218
219 <usage>
220   <p>Die Direktive gibt einen Standardwert f&uuml;r den Charset-Paramter des
221     Medientyps (den Namen einer Zeichencodierung) an, der einer Antwort
222     genau dann hinzugef&uuml;gt wird, wenn der Content-Type der Antwort entweder
223     <code>text/plain</code> oder <code>text/html</code> ist. Dies sollte jedes
224     mittels <code>META</code>-Element im Datenteil der Antwort angegebene
225     Charset &uuml;berschreiben. Das genaue Verhalten h&auml;ngt jedoch oft von
226     der Client-Konfiguration des Benutzers ab. Die Einstellung
227     <code>AddDefaultCharset Off</code> deaktiviert diese Funktionalit&auml;t.
228     <code>AddDefaultCharset On</code> aktiviert die Standard-Zeichenkodierung
229     <code>iso-8859-1</code>. Jeder andere Wert wird als die zu verwendende
230     <var>Zeichenkodierung</var> aufgefa&szlig;t, die eines der bei <a
231       href="http://www.iana.org/assignments/character-sets">IANA registrierten
232       Charset-Werte</a> zur Verwendung in MIME-Medientypen sein sollte. Zum
233     Beispiel:</p>
234
235     <example>
236       AddDefaultCharset utf-8
237     </example>
238
239     <p><directive>AddDefaultCharset</directive> sollte nur verwendet werden,
240       wenn von allen Textressourcen, f&uuml;r die es gilt, bekannt ist, dass sie
241       in dieser Zeichkodierung vorliegen, oder wenn es zu unbequem ist, ihre
242       Zeichenkodierung indivuell zu benennen. Ein solches Beispiel ist das
243       Hinzuf&uuml;gen des Charset-Parameters zu Ressourcen, die generierte
244       Inhalte enthalten. Ein Beispiel sind CGI-Skript-Altlasten, die aufgrund von
245       in die Ausgabe integrierten Daten, die durch den Benutzer &uuml;bermittelt
246       wurden, gegen Cross-Site-Scripting-Angriffe verwundbar sind. Eine bessere
247       L&ouml;sung w&auml;re jedoch, diese Skripte zu korrigieren (oder zu
248       l&ouml;schen), da die Angabe einer Standard-Zeichencodierung keine
249       Anwender sch&uuml;tzt, die in ihrem Browser die Funktion zur
250       automatischen Erkennung der Zeichenkodierung aktiviert haben.</p>
251 </usage>
252 <seealso><directive module="mod_mime">AddCharset</directive></seealso> 
253 </directivesynopsis>
254
255 <directivesynopsis>
256 <name>AddOutputFilterByType</name>
257 <description>einen Ausgabefilter einem bestimmten MIME-Type
258 zuordnen</description>
259 <syntax>AddOutputFilterByType <var>Filter</var>[;<var>Filter</var>...]
260 <var>MIME-Type</var> [<var>MIME-Type</var>] ...</syntax>
261 <contextlist><context>server config</context>
262 <context>virtual host</context><context>directory</context>
263 <context>.htaccess</context></contextlist>
264 <override>FileInfo</override>
265 <compatibility>Verf&uuml;gbar ab Apache 2.0.33</compatibility>
266
267 <usage>
268     <p>Die Direktive aktiviert f&uuml;r eine Anfrage abh&auml;ngig vom
269     <glossary>MIME-Type</glossary> der Antwort einen bestimmten
270     Ausgabe-<a href="../filter.html">Filter</a>.</p>
271
272     <p>Das folgende Beispiel verwendet den Filter <code>DEFLATE</code>,
273     der von <module>mod_deflate</module> angeboten wird. Er komprimiert
274     jede Ausgabe, die  als <code>text/html</code> oder <code>text/plain</code>
275     gekennzeichnet ist, (gleichg&uuml;ltig, ob statisch oder dynamisch)
276     bevor sie an den Client gesendet wird.</p>
277
278     <example>
279       AddOutputFilterByType DEFLATE text/html text/plain
280     </example>
281
282     <p>Wenn Sie den Inhalt von mehr als einem Filter verarbeiten lassen
283     wollen, dann m&uuml;ssen deren Namen durch Semikolons voneinander
284     getrennt werden. Es ist ebenfalls m&ouml;glich, eine
285     <directive>AddOutputFilterByType</directive>-Direktive f&uuml;r
286     jeden von diesen Filtern zu verwenden.</p>
287
288     <p>Die folgende Konfiguration sorgt daf&uuml;r, dass alle
289     Skriptausgaben, die als <code>text/html</code> gekennzeichnet
290     sind, zuerst vom <code>INCLUDES</code>-Filter und dann vom
291     <code>DEFLATE</code>-Filter verarbeitet werden.</p>
292
293     <example>
294     &lt;Location /cgi-bin/&gt;<br />
295     <indent>
296       Options Includes<br />
297       AddOutputFilterByType INCLUDES;DEFLATE text/html<br />
298     </indent>
299     &lt;/Location&gt;
300     </example>
301
302     <note type="warning"><title>Hinweis:</title>
303       <p>Die Aktivierung von Filtern mittels
304       <directive>AddOutputFilterByType</directive> kann in einigen
305       F&auml;llen ganz oder teilweise fehlschlagen. Beispielsweise
306       werden keine Filter angewendet, wenn der <glossary>MIME-Type</glossary>
307       nicht bestimmt werden kann und auf die Einstellung der <directive
308       module="core">DefaultType</directive>-Anweisung zur&uuml;ckf&auml;llt,
309       selbst wenn die <directive
310       module="core">DefaultType</directive>-Einstellung die gleiche ist.</p>
311
312       <p>Wenn Sie jedoch sicherstellen wollen, dass der Filter
313       angewendet wird, sollten Sie den Content-Type z.B. mit
314       <directive module="mod_mime">AddType</directive> oder
315       <directive module="core">ForceType</directive> der Ressource
316       explizit zuordnen. Das Setzen des Content-Types innerhalb
317       eines (nicht-nph) CGI-Skriptes funktioniert ebenfalls
318       zuverl&auml;ssig.</p>
319
320       <p>Die Typ-gebundenen Ausgabefilter werden niemals auf
321       Proxy-Anfragen angewendet.</p>
322     </note>
323 </usage>
324
325 <seealso><directive module="mod_mime">AddOutputFilter</directive></seealso>
326 <seealso><directive module="core">SetOutputFilter</directive></seealso>
327 <seealso><a href="../filter.html">Filter</a></seealso>
328 </directivesynopsis>
329
330 <directivesynopsis>
331 <name>AllowEncodedSlashes</name>
332 <description>Legt fest, ob kodierte Pfadtrennzeichen in URLs durchgereicht
333 werden d&uuml;rfen</description>
334 <syntax>AllowEncodedSlashes On|Off</syntax>
335 <default>AllowEncodedSlashes Off</default>
336 <contextlist><context>server config</context><context>virtual host</context>
337 </contextlist>
338 <compatibility>Verf&uuml;gbar ab Apache 2.0.46</compatibility>
339
340 <usage>
341     <p>Die <directive>AllowEncodedSlashes</directive>-Direktive erlaubt die
342     Verwendung von URLs, welche kodierte Pfadtrennzeichen (<code>%2F</code>
343     f&uuml;r <code>/</code> und auf entsprechenden Systemen zus&auml;tzlich
344     <code>%5C</code> f&uuml;r <code>\</code>) enthalten. Normalerweise werden
345     derartige URLs mit einem 404-Fehler (Nicht gefunden) abgewiesen.</p>
346
347     <p><directive>AllowEncodedSlashes</directive> <code>On</code> ist
348     vor allem in Verbindung mit <code>PATH_INFO</code> hilfreich.</p>
349
350     <note><title>Anmerkung</title>
351       <p>Das Erlauben von Schr&auml;gstrichen impliziert <em>nicht</em> deren
352       <em>Dekodierung</em>. Vorkommen von <code>%2F</code> oder <code>%5C</code>
353       (<em>nur</em> auf entsprechenden Systemen) werden unver&auml;ndert in der
354       ansonsten dekodierten URL belassen.</p>
355     </note>
356 </usage>
357 <seealso><directive module="core">AcceptPathInfo</directive></seealso>
358 </directivesynopsis>
359
360 <directivesynopsis>
361 <name>AllowOverride</name>
362 <description>Direktiven-Typen, die in <code>.htaccess</code>-Dateien
363 erlaubt sind.</description>
364 <syntax>AllowOverride All|None|<var>Direktiven-Typ</var>
365 [<var>Direktiven-Typ</var>] ...</syntax>
366 <default>AllowOverride None (2.3.9 und später), AllowOverride All (2.3.8 und früher)</default>
367 <contextlist><context>directory</context></contextlist>
368
369 <usage>
370     <p>Wenn der Server eine <code>.htaccess</code>-Datei (wie durch
371     <directive module="core">AccessFileName</directive> definiert)
372     findet, muss er wissen, welche in der Datei angegebenen Direktiven
373     fr&uuml;here Konfigurationsanweisungen &uuml;berschreiben
374     d&uuml;rfen.</p>
375
376     <note><title>Nur in &lt;Directory&gt;-Abschnitten verf&uuml;gbar</title>
377     <directive>AllowOverride</directive> ist nur in <directive
378     type="section" module="core">Directory</directive>-Abschnitten
379     g&uuml;ltig, die ohne regul&auml;re Ausdr&uuml;cke definiert wurden, nicht
380     in <directive type="section" module="core">Location</directive>-, 
381     <directive module="core" type="section">DirectoryMatch</directive>- oder
382     <directive type="section" module="core">Files</directive>-Abschnitten.
383     </note>
384
385     <p>Wenn diese Anweisung auf <code>None</code> gesetzt wird, dann
386     werden <a href="#accessfilename">.htaccess</a>-Dateien komplett
387     ignoriert. In diesem Fall wird der Server nicht einmal versuchen,
388     die <code>.htaccess</code>-Dateien im Dateisystem zu lesen.</p>
389
390     <p>Wenn diese Anweisung auf <code>All</code> gesetzt wird, dann
391     ist jede Direktive in den <code>.htaccess</code>-Dateien erlaubt,
392     die den <a href="directive-dict.html#Context">Kontext</a>
393     .htaccess besitzt.</p>
394
395     <p>Der <var>Direktiven-Typ</var> kann eine der folgenden
396     Anweisungsgruppen sein.</p>
397
398     <dl>
399       <dt>AuthConfig</dt>
400
401       <dd>
402       Erlaubt die Verwendung von Autorisierungs-Anweisungen (<directive
403       module="mod_authz_dbm">AuthDBMGroupFile</directive>,
404       <directive module="mod_authn_dbm">AuthDBMUserFile</directive>,
405       <directive module="mod_authz_groupfile">AuthGroupFile</directive>,
406       <directive module="mod_authn_core">AuthName</directive>,
407       <directive module="mod_authn_core">AuthType</directive>, <directive
408       module="mod_authn_file">AuthUserFile</directive>, <directive
409       module="mod_authz_core">Require</directive> <em>usw.</em>).</dd>
410
411       <dt>FileInfo</dt>
412
413       <dd>
414       Erlaubt die Verwendung von Direktiven zur Steuerung der
415       Dokumenttypen (<directive
416       module="core">DefaultType</directive>, <directive
417       module="core">ErrorDocument</directive>, <directive
418       module="core">ForceType</directive>, <directive
419       module="mod_negotiation">LanguagePriority</directive>,
420       <directive module="core">SetHandler</directive>, <directive
421       module="core">SetInputFilter</directive>, <directive
422       module="core">SetOutputFilter</directive>, und
423       <module>mod_mime</module>-Direktiven Add* und Remove*
424       <em>usw.</em>), Metadaten (<directive
425       module="mod_headers">Header</directive>, <directive
426       module="mod_headers">RequestHeader</directive>, <directive
427       module="mod_setenvif">SetEnvIf</directive>, <directive
428       module="mod_setenvif">SetEnvIfNoCase</directive>, <directive
429       module="mod_setenvif">BrowserMatch</directive>, <directive
430       module="mod_usertrack">CookieExpires</directive>, <directive
431       module="mod_usertrack">CookieDomain</directive>, <directive
432       module="mod_usertrack">CookieStyle</directive>, <directive
433       module="mod_usertrack">CookieTracking</directive>, <directive
434       module="mod_usertrack">CookieName</directive>),
435       <module>mod_rewrite</module>-Direktiven <directive
436       module="mod_rewrite">RewriteEngine</directive>, <directive
437       module="mod_rewrite">RewriteOptions</directive>, <directive
438       module="mod_rewrite">RewriteBase</directive>, <directive
439       module="mod_rewrite">RewriteCond</directive>, <directive
440       module="mod_rewrite">RewriteRule</directive>) und
441       <directive module="mod_actions">Action</directive> aus
442       <module>mod_actions</module>.
443       </dd>
444
445       <dt>Indexes</dt>
446
447       <dd>
448       Erlaubt die Verwendung von Direktiven zur Steuerung von
449       Verzeichnisindizes (<directive
450       module="mod_autoindex">AddDescription</directive>,
451       <directive module="mod_autoindex">AddIcon</directive>, <directive
452       module="mod_autoindex">AddIconByEncoding</directive>,
453       <directive module="mod_autoindex">AddIconByType</directive>,
454       <directive module="mod_autoindex">DefaultIcon</directive>, <directive
455       module="mod_dir">DirectoryIndex</directive>, <a 
456           href="mod_autoindex.html#indexoptions.fancyindexing">
457           <code>FancyIndexing</code></a>, <directive
458       module="mod_autoindex">HeaderName</directive>, <directive
459       module="mod_autoindex">IndexIgnore</directive>, <directive
460       module="mod_autoindex">IndexOptions</directive>, <directive
461       module="mod_autoindex">ReadmeName</directive>
462       <em>usw.</em>).</dd>
463
464       <dt>Limit</dt>
465
466       <dd>
467       Erlaubt die Verwendung von Direktiven zur Steuerung des
468       Zugriffs von Hosts (<directive
469       module="mod_access_compat">Allow</directive>, <directive
470       module="mod_access_compat">Deny</directive> und <directive
471       module="mod_access_compat">Order</directive>).</dd>
472
473       <dt>Options[=<var>Option</var>,...]</dt>
474
475       <dd>
476       Erlaubt die Verwendung von Direktiven zur Steuerung spezieller
477       Verzeichniseigenschaften (<directive module="core">Options</directive>
478       und <directive module="mod_include">XBitHack</directive>). Sie
479       k&ouml;nnen mit einem Gleichheitszeichen gefolgt von einer
480       kommaseparierten Liste (ohne Leerzeichen) angeben, welche Optionen mit
481       der <directive module="core">Options</directive>-Direktive gesetzt
482       werden d&uuml;rfen.</dd>
483     </dl>
484
485     <p>Beispiel:</p>
486
487     <example>
488       AllowOverride AuthConfig Indexes
489     </example>
490     
491     <p>Im obigen Beispiel erzeugen alle Direktiven einen internal server
492       error <transnote>Server-interner Fehler</transnote>, die weder der
493       Gruppe <code>AuthConfig</code> noch der Gruppe <code>Indexes</code>
494       angeh&ouml;ren.</p>
495 </usage>
496
497 <seealso><directive module="core">AccessFileName</directive></seealso>
498 <seealso><a href="../configuring.html">Konfigurationsdateien</a></seealso>
499 <seealso><a href="../howto/htaccess.html">.htaccess-Dateien</a></seealso>
500 </directivesynopsis>
501
502 <directivesynopsis>
503 <name>AuthName</name>
504 <description>Autorisierungsbereich zur Verwendung in der
505 HTTP-Authentisierung</description>
506 <syntax>AuthName <var>auth-Bereich</var></syntax>
507 <contextlist><context>directory</context><context>.htaccess</context>
508 </contextlist>
509 <override>AuthConfig</override>
510
511 <usage>
512     <p>Die Direktive legt den Namen des Autorisierungsbereiches
513     <transnote>Der Autorisierungsbereich wird auch Realm genannt.</transnote>
514     f&uuml;r ein Verzeichnis fest. Dieser Realm wird dem Client mitgeteilt,
515     damit der Anwender wei&szlig;, welchen Benutzernamen und welches Passwort
516     er zu &uuml;bermitteln hat. <directive>AuthName</directive> akzeptiert ein
517     Argument. Falls der Name des Realm Leerzeichen enth&auml;lt, muss er in
518     Anf&uuml;hrungszeichen eingeschlossen werden. Um zu funktionieren, muss
519     die Anweisung von den Direktiven <directive
520     module="core">AuthType</directive> und <directive
521     module="core">Require</directive> sowie von
522     Direktiven wie <directive module="mod_authn_file">AuthUserFile</directive>
523     und <directive module="mod_authz_groupfile">AuthGroupFile</directive>
524     begleitet werden.</p>
525
526    <p>Beispiel:</p>
527
528    <example>
529      AuthName "Top Secret"
530    </example>
531
532     <p>Die <code>AuthName</code> &uuml;bergebene Zeichenkette ist das,
533     was in dem von den meisten Browsern angebotenen Passwort-Dialog
534     angezeigt wird.</p>
535 </usage>
536 <seealso><a
537     href="../howto/auth.html">Authentisierung, Autorisierung und
538     Zugriffskontrolle</a></seealso>
539 </directivesynopsis>
540
541 <directivesynopsis>
542 <name>AuthType</name>
543 <description>Art der Authentisierung</description>
544 <syntax>AuthType Basic|Digest</syntax>
545 <contextlist><context>directory</context><context>.htaccess</context>
546 </contextlist>
547 <override>AuthConfig</override>
548
549 <usage>
550     <p>Die Direktive w&auml;hlt die Art der Benutzer-Authentisierung
551     f&uuml;r ein Verzeichnis aus. Derzeit sind lediglich <code>Basic</code>
552     und <code>Digest</code> implementiert.
553     Um zu funktionieren, muss die Anweisung von den Direktiven <directive
554     module="core">AuthName</directive> und <directive
555     module="core">Require</directive> sowie von
556     Direktiven wie <directive module="mod_authn_file">AuthUserFile</directive>
557     und <directive module="mod_authz_groupfile">AuthGroupFile</directive>
558     begleitet werden.</p>
559 </usage>
560 <seealso><a href="../howto/auth.html">Authentisierung, Autorisierung und
561     Zugriffskontrolle</a></seealso>
562 </directivesynopsis>
563
564 <directivesynopsis>
565 <name>CGIMapExtension</name>
566 <description>Technik zur Bestimmung des Interpreters f&uuml;r
567 CGI-Skripte</description>
568 <syntax>CGIMapExtension <var>CGI-Pfad</var> <var>.Endung</var></syntax>
569 <contextlist><context>directory</context><context>.htaccess</context>
570 </contextlist>
571 <override>FileInfo</override>
572 <compatibility>ausschlie&szlig;lich NetWare</compatibility>
573
574 <usage>
575     <p>Die Direktive wird zur Steuerung verwendet, wie Apache
576     den Interpreter ermittelt, der zur Ausf&uuml;hrung von
577     CGI-Skripten verwendet wird. Beispielsweise bestimmt die Angabe
578     von <code>CGIMapExtension sys:\foo.nlm .foo</code>, dass
579     alle CGI-Scripte mit der Endung <code>.foo</code> an den
580     FOO-Interpreter &uuml;bergeben werden.</p>
581 </usage>
582 </directivesynopsis>
583
584 <directivesynopsis>
585 <name>ContentDigest</name>
586 <description>Aktiviert die Generierung von <code>Content-MD5</code>
587 HTTP-Response-Headern</description>
588 <syntax>ContentDigest On|Off</syntax>
589 <default>ContentDigest Off</default>
590 <contextlist><context>server config</context><context>virtual host</context>
591 <context>directory</context><context>.htaccess</context>
592 </contextlist>
593 <override>Options</override>
594 <status>Experimental</status>
595
596 <usage>
597     <p>Die Direktive aktiviert die Generierung von
598     <code>Content-MD5</code>-Headern, wie sie in RFC1864 bzw. RFC2616
599     definiert sind.</p>
600
601     <p>MD5 ist ein Algorithmus zur Berechnung eines "Datenextrakts"
602     (zuweilen "Fingerabdruck" genannt) <transnote>Der "Datenextrakt" wird im
603     Englischen als "message digest" oder "fingerprint" bezeichnet.</transnote>
604     aus beliebig langen Daten. Es gilt als zuverl&auml;ssig, dass
605     Ver&auml;nderungen an den Daten sich in Ver&auml;nderungen des
606     Extrakts wiederspiegeln.</p>
607
608     <p>Der <code>Content-MD5</code>-Header bietet eine
609     End-to-End-Integrit&auml;tspr&uuml;fung (MIC) <transnote>MIC steht f&uuml;r
610     "message integrity check".</transnote> des Daten-Inhalts. Ein Proxy oder
611     Client kann diesen Header pr&uuml;fen, um zuf&auml;llige Ver&auml;nderungen
612     des Entity-Inhalts bei der &Uuml;bertragung festzustellen.
613     Beispielheader:</p>
614
615     <example>
616       Content-MD5: AuLb7Dp1rqtRtxz2m9kRpA==
617     </example>
618
619     <p>Beachten Sie bitte, dass dies Performanceprobleme auf Ihrem
620     System verursachen kann, da der Extrakt bei jeder Anfrage
621     berechnet wird (der Wert wird nicht zwischengespeichert).</p>
622
623     <p><code>Content-MD5</code> wird nur f&uuml;r Dokumente gesendet,
624     die von <module>core</module> bedient werden, nicht jedoch bei
625     Modulen. SSI-Dokumente, CGI-Skript-Ausgaben und Byte-Range-Antworten
626     besitzen diesen Header beispielsweise nicht.</p>
627 </usage>
628 </directivesynopsis>
629
630 <directivesynopsis>
631 <name>DefaultType</name>
632 <description>MIME-Content-Type, der gesendet wird, wenn der Server den Typ
633 nicht auf andere Weise ermitteln kann.</description>
634 <syntax>DefaultType <var>MIME-Type</var></syntax>
635 <default>DefaultType text/plain</default>
636 <contextlist><context>server config</context><context>virtual host</context>
637 <context>directory</context><context>.htaccess</context>
638 </contextlist>
639 <override>FileInfo</override>
640
641 <usage>
642     <p>Es kann vorkommen, dass der Server ein Dokument ausliefern muss,
643     dessen Typ er nicht mit Hilfe seiner <glossary ref="mime-type"
644     >MIME-Type</glossary>-Zuordnungen bestimmen kann.</p>
645
646     <p>Der Server muss den Client &uuml;ber den Content-Type des
647     Dokumentes informieren. Daher verwendet er im Falle eines
648     unbekannten Typs die <code>DefaultType</code>-Einstellung.
649     Zum Beispiel:</p>
650
651     <example>
652       DefaultType image/gif
653     </example>
654
655     <p>w&auml;re angemessen f&uuml;r ein Verzeichnis, das viele GIF-Bilder
656     enth&auml;lt, deren Dateinamen nicht Endung <code>.gif</code>
657     besitzen.</p>
658
659     <p>Beachten Sie bitte, dass die Direktive anders als <directive
660     module="core">ForceType</directive> lediglich den Standard-MIME-Type
661     bestimmt. Alle anderen MIME-Type-Definitionen, einschlie&szlig;lich
662     Dateierweiterungen, die den Medien-Typ anzeigen k&ouml;nnen,
663     &uuml;berschreiben diese Voreinstellung.</p>
664 </usage>
665 </directivesynopsis>
666
667 <directivesynopsis>
668 <name>Define</name>
669 <description>Define the existence of a variable</description>
670 <syntax>Define <var>Parametername</var></syntax>
671 <contextlist><context>server config</context></contextlist>
672
673 <usage>
674     <p>Equivalent zum &uuml;bergeben von <var>Parametername</var> mittels des
675     <code>-D</code> Arguments an <program>httpd</program>.</p>
676     <p>Diese Directive kann verwendet werden, um die Nutzung von <directive module="core"
677     type="section">IfDefine</directive> Sectionen umzuschalten, ohne die
678     <code>-D</code> Argumentente in etwaigen Start-Skripten &auml;ndern
679     zu m&uuml;ssen.</p>
680 </usage>
681 </directivesynopsis>
682
683 <directivesynopsis type="section">
684 <name>Directory</name>
685 <description>Umschlie&szlig;t eine Gruppe von Direktiven, die nur auf
686 das genannte Verzeichnis des Dateisystems und Unterverzeichnisse angewendet
687 werden</description>
688 <syntax>&lt;Directory <var>Verzeichnispfad</var>&gt;
689 ... &lt;/Directory&gt;</syntax>
690 <contextlist><context>server config</context><context>virtual host</context>
691 </contextlist>
692
693 <usage>
694     <p><directive type="section">Directory</directive> und
695     <code>&lt;/Directory&gt;</code> werden dazu verwendet, eine Gruppe
696     von Direktiven zusammenzufassen, die nur f&uuml;r das genannte
697     Verzeichnis und dessen Unterverzeichnisse gelten. Jede Direktive,
698     die im Verzeichnis-Kontext erlaubt ist, kann verwendet werden.
699     <var>Verzeichnispfad</var> ist entweder der vollst&auml;ndige Pfad zu
700     einem Verzeichnis oder eine Zeichenkette mit Platzhaltern wie sie von der
701     Unix-Shell zum Abgleich verwendet werden. In einer Zeichenkette
702     mit Platzhaltern <transnote>sogenannte wild-cards</transnote> entspricht
703     <code>?</code> einem einzelnen Zeichen und <code>*</code> einer
704     Zeichenkette beliebiger L&auml;nge. Sie k&ouml;nnen auch auch
705     <code>[]</code>-Zeichenbereiche verwenden. Keiner der Platzhalter
706     entspricht dem Zeichen "/". Daher passt <code>&lt;Directory
707     /*/public_html&gt;</code> nicht auf <code>/home/user/public_html</code>,
708     <code>&lt;Directory /home/*/public_html&gt;</code> jedoch tut es.
709     Beispiel:</p>
710
711     <example>
712       &lt;Directory /usr/local/httpd/htdocs&gt;<br />
713       <indent>
714         Options Indexes FollowSymLinks<br />
715       </indent>
716       &lt;/Directory&gt;
717     </example>
718
719     <note>
720       <p>Seien Sie vorsichtig mit den <var>Verzeichnispfad</var>-Argumenten.
721       Sie m&uuml;ssen buchst&auml;blich mit dem Dateisystempfad
722       &uuml;bereinstimmen, den der Apache f&uuml;r den Zugriff auf die
723       Dateien verwendet. Direktiven, die f&uuml;r ein bestimmtes
724       Verzeichnis gelten, gelten nicht f&uuml;r Dateien in dem Verzeichnis,
725       auf die &uuml;ber einen anderen Pfad zugegriffen wird, wie z.B.
726       &uuml;ber verschiedene symbolische Links.</p>
727     </note>
728
729     <p>Erweiterte <glossary ref="regex"
730     >regul&auml;re Ausdr&uuml;cke</glossary> k&ouml;nnen ebenfalls
731     verwendet werden, indem das Zeichen <code>~</code> hinzugef&uuml;gt
732     wird. Beispielsweise w&uuml;rde</p>
733
734     <example>
735       &lt;Directory ~ "^/www/.*/[0-9]{3}"&gt;
736     </example>
737
738     <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
739     Zahlen bestehen.</p>
740
741     <p>Wenn mehrere <directive type="section">Directory</directive>-Abschnitte
742     (ohne regul&auml;re Ausdr&uuml;cke) auf ein Verzeichnis (oder
743     ein ihm &uuml;bergeordnetes Verzeichnis) passen, welches ein Dokument
744     enth&auml;lt, dann werden die Direktiven der Reihe nach, angefangen
745     beim k&uuml;rzesten passenden Muster, vermischt mit den Direktiven
746     aus den <a href="#accessfilename">.htaccess</a>-Dateien, angewendet.
747     Beispiel:</p>
748
749     <example>
750       &lt;Directory /&gt;<br />
751       <indent>
752         AllowOverride None<br />
753       </indent>
754       &lt;/Directory&gt;<br />
755       <br />
756       &lt;Directory /home/&gt;<br />
757       <indent>
758         AllowOverride FileInfo<br />
759       </indent>
760       &lt;/Directory&gt;
761     </example>
762
763     <p>Beim Zugriff auf das Dokument <code>/home/web/dir/doc.html</code>
764     sind die einzelnen Schritte:</p>
765
766     <ul>
767       <li>Wende die Direktive <code>AllowOverride None</code> an
768       (deaktiviere <code>.htaccess</code>-Dateien).</li>
769
770       <li>Wende die Direktive <code>AllowOverride FileInfo</code>
771       (auf das Verzeichnis <code>/home</code>) an.</li>
772
773       <li>Wende jede <code>FileInfo</code>-Direktive aus
774       <code>/home/.htaccess</code>, <code>/home/web/.htaccess</code> und
775       <code>/home/web/dir/.htaccess</code> der Reihe nach an.</li>
776     </ul>
777
778     <p>Regul&auml;re Ausdr&uuml;cke werden solange nicht ber&uuml;cksichtigt,
779     bis alle normalen Abschnitte angewendet wurden. Anschlie&szlig;end
780     werden alle regul&auml;ren Ausdr&uuml;cke in der Reihenfolge
781     gepr&uuml;ft, in der sie in der Konfigurationsdatei auftauchen.
782     Beispielsweise wird bei</p>
783
784     <example>
785       &lt;Directory ~ abc$&gt;<br />
786       <indent>
787         # ... hier die Direktiven ...<br />
788       </indent>
789       &lt;/Directory&gt;
790     </example>
791
792     <p>der Abschnitt mit dem regul&auml;ren Ausdruck nicht
793     ber&uuml;cksichtigt, bis alle normalen
794     <directive type="section">Directory</directive>-Abschnitte und
795     <code>.htaccess</code>-Dateien angewendet wurden. Dann erst wird
796     der regul&auml;re Ausdruck mit <code>/home/abc/public_html/abc</code>
797     abgeglichen und der entsprechende <directive
798     type="section">Directory</directive>-Abschnitt angewendet.</p>
799
800     <p><strong>Beachten Sie bitte, dass der vom Apache voreingestellte
801     Zugriff f&uuml;r <code>&lt;Directory /&gt;</code>
802     <code>Allow from All</code> ist. Das bedeutet, dass der Apache
803     jede Datei ausliefert, die durch eine URL abgebildet wird. Es wird
804     empfohlen, dass Sie dies durch einen Block wie</strong></p>
805
806     <example>
807       &lt;Directory /&gt;<br />
808       <indent>
809         Order Deny,Allow<br />
810         Deny from All<br />
811       </indent>
812       &lt;/Directory&gt;
813     </example>
814
815     <p><strong>&auml;ndern und anschlie&szlig;end f&uuml;r
816     Verzeichnisse &uuml;berschreiben, die Sie verf&uuml;gbar machen
817     <em>wollen</em>. F&uuml;r weitere Einzelheiten lesen Sie bitte
818     die Seite zu den <a
819     href="../misc/security_tips.html">Sicherheitshinweisen</a>.</strong></p>
820
821     <p>Die Verzeichnisabschnitte erscheinen in der Datei
822     <code>httpd.conf</code>. <directive
823     type="section">Directory</directive>-Direktiven d&uuml;rfen nicht
824     ineinander verschachtelt werden oder innerhalb von <directive module="core"
825     type="section">Limit</directive>- oder <directive module="core"
826     type="section">LimitExcept</directive>-Abschnitten auftauchen.</p>
827 </usage>
828 <seealso><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
829     &lt;Location&gt; und &lt;Files&gt; arbeiten</a> f&uuml;r eine
830     Erl&auml;uterung, wie diese verschiedenen Abschnitte miteinander
831     kombiniert werden, wenn eine Anfrage empfangen wird</seealso>
832 </directivesynopsis>
833
834 <directivesynopsis type="section">
835 <name>DirectoryMatch</name>
836 <description>Umschlie&szlig;t eine Gruppe von Direktiven, die auf
837   Verzeichnisse des Dateisystems und ihre Unterverzeichnisse abgebildet
838   werden, welche auf einen regul&auml;ren Ausdruck passen</description>
839 <syntax>&lt;DirectoryMatch <var>regex</var>&gt;
840 ... &lt;/DirectoryMatch&gt;</syntax>
841 <contextlist><context>server config</context><context>virtual host</context>
842 </contextlist>
843
844 <usage>
845     <p><directive type="section">DirectoryMatch</directive> und
846     <code>&lt;/DirectoryMatch&gt;</code> werden dazu verwendet, eine
847     Gruppe von Direktiven zusammenzufassen, die nur f&uuml;r das
848     genannte Verzeichnis und dessen Unterverzeichnisse gelten, genauso
849     wie bei <directive module="core" type="section">Directory</directive>.
850     Als Argument dient jedoch ein <glossary ref="regex">regul&auml;rer
851     Ausdruck</glossary>. Beispielsweise w&uuml;rde</p>
852
853     <example>
854       &lt;DirectoryMatch "^/www/.*/[0-9]{3}"&gt;
855     </example>
856
857     <p>auf Verzeichnisse in <code>/www/</code> passen, die aus drei
858     Zeichen bestehen.</p>
859 </usage>
860 <seealso><directive type="section" module="core">Directory</directive>
861     f&uuml;r eine Beschreibung, wie regul&auml;re Ausdr&uuml;cke mit
862     normalen <directive type="section">Directory</directive>-Anweisungen
863     vermischt werden.</seealso>
864 <seealso><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
865     &lt;Location&gt; und &lt;Files&gt; arbeiten</a> f&uuml;r eine
866     Erl&auml;uterung, wie diese verschiedenen Abschnitte miteinander
867     kombiniert werden, wenn eine Anfrage empfangen wird</seealso>
868 </directivesynopsis>
869
870 <directivesynopsis>
871 <name>DocumentRoot</name>
872 <description>Verzeichnis, welches den Haupt-Dokumentenbaum bildet, der im
873 Web sichtbar ist.</description>
874 <syntax>DocumentRoot <var>Verzeichnis</var></syntax>
875 <default>DocumentRoot /usr/local/apache/htdocs</default>
876 <contextlist><context>server config</context><context>virtual host</context>
877 </contextlist>
878
879 <usage>
880     <p>Die Direktive setzt das Verzeichnis, von dem aus
881     <program>httpd</program> Dateien ausliefert. Sofern nicht eine Direktive
882     wie <directive module="mod_alias">Alias</directive> greift, h&auml;ngt
883     der Server Pfade aus der angeforderten URL an das Wurzelverzeichnis
884     an, um den Pfad zum Dokument zu bilden. Beispiel:</p>
885
886     <example>
887       DocumentRoot /usr/web
888     </example>
889
890     <p>Damit bezieht sich ein Zugriff auf
891     <code>http://www.my.host.com/index.html</code> auf
892     <code>/usr/web/index.html</code>. Wenn das <var>Verzeichnis</var> nicht
893     absolut angegeben ist, wird es relativ zu <directive
894     module="core">ServerRoot</directive> betrachtet.</p>
895
896     <p><directive>DocumentRoot</directive> sollte ohne einen
897     Schr&auml;gstrich am Ende angegeben werden.</p>
898 </usage>
899 <seealso><a href="../urlmapping.html">URLs auf das Dateisystem
900 abbilden</a></seealso>
901 </directivesynopsis>
902
903 <directivesynopsis>
904 <name>EnableMMAP</name>
905 <description>Verwende Memory-Mapping, um Dateien w&auml;hrend der
906 Auslieferung zu lesen</description>
907 <syntax>EnableMMAP On|Off</syntax>
908 <default>EnableMMAP On</default>
909 <contextlist><context>server config</context><context>virtual host</context>
910 <context>directory</context><context>.htaccess</context>
911 </contextlist>
912 <override>FileInfo</override>
913
914 <usage>
915     <p>Die Direktive steuert, ob <program>httpd</program> Memory-Mapping
916     verwenden darf, wenn er w&auml;hrend der Auslieferung den Inhalt einer
917     Datei lesen muss. Wenn die Bearbeitung einer Anfrage es erfordert,
918     auf die Daten in einer Datei zuzugreifen -- zum Beispiel bei der
919     Auslieferung einer mittels <module>mod_include</module> serverseitig
920     analysierten Datei --, dann verwendet der Apache standardm&auml;&szlig;ig
921     Memory-Mapping f&uuml;r diese Datei, sofern das Betriebssystem es
922     unterst&uuml;tzt.</p>
923
924     <p>Memory-Mapping bedeutet zuweilen eine Performanceverbesserung.
925     In einigen Umgebungen ist es jedoch besser, Memory-Mapping zu
926     deaktivieren, um Problemen w&auml;hrend des Betriebs vorzubeugen:</p>
927
928     <ul>
929     <li>Bei einigen Multiprozessorsystemen kann Memory-Mapping die
930     Performance von <program>httpd</program> reduzieren.</li>
931     <li>Bei einem per NFS eingebundenen <directive
932     module="core">DocumentRoot</directive> kann <program>httpd</program> mit
933     einem Speicherzugriffsfehler <transnote>ein so genannter "segmentation
934     fault"</transnote> abst&uuml;rzen, wenn eine Datei gel&ouml;scht oder
935     gek&uuml;rzt wird, w&auml;hrend <program>httpd</program> sie im Speicher
936     abbildet.</li>
937     </ul>
938
939     <p>Bei Serverkonfigurationen, die f&uuml;r dieses Problem
940     anf&auml;llig sind, sollten Sie das Memory-Mapping f&uuml;r
941     auszuliefernde Dateien deaktivieren, indem Sie schreiben:</p>
942
943     <example>
944       EnableMMAP Off
945     </example>
946
947     <p>Bei per NFS eingebundenen Dateien kann diese Funktion
948     explizit f&uuml;r die st&ouml;renden Dateien deaktiviert werden,
949     indem Sie angeben:</p>
950
951     <example>
952       &lt;Directory "/pfad-zu-den-nfs-dateien"&gt;
953       <indent>
954         EnableMMAP Off
955       </indent>
956       &lt;/Directory&gt;
957     </example>
958 </usage>
959 </directivesynopsis>
960
961 <directivesynopsis>
962 <name>EnableSendfile</name>
963 <description>Verwende die sendfile-Unterst&uuml;tzung des Kernels, um
964 Dateien an den Client auszuliefern</description>
965 <syntax>EnableSendfile On|Off</syntax>
966 <default>EnableSendfile On</default>
967 <contextlist><context>server config</context><context>virtual host</context>
968 <context>directory</context><context>.htaccess</context>
969 </contextlist>
970 <override>FileInfo</override>
971 <compatibility>Verf&uuml;gbar ab Apache Version 2.0.44</compatibility>
972
973 <usage>
974     <p>Die Direktive steuert, ob <program>httpd</program> die
975     sendfile-Unterst&uuml;tzung des Kernels verwenden kann, um
976     Dateiinhalte an den Client zu &uuml;bermitteln. Wenn die Bearbeitung
977     einer Anfrage keinen Zugriff auf die Daten in der Datei erfordert --
978     zum Beispiel bei der Auslieferung einer statischen Datei -- und das
979     Betriebssystem es unterst&uuml;tzt, verwendet der Apache
980     standardm&auml;&szlig;ig sendfile, um den Dateiinhalt zu
981     &uuml;bertragen, ohne die Datei jemals zu lesen.</p>
982
983     <p>Der sendfile-Mechanismus vermeidet getrennte Lese- und
984     Sendeoperationen sowie Puffer-Zuweisungen. Bei einigen Plattformen bzw.
985     Dateisystemen deaktivieren Sie diese Funktion jedoch besser, um Probleme
986     w&auml;hrend des Betriebs zu vermeiden:</p>
987
988     <ul>
989     <li>Einige Plattformen besitzen u.U. eine fehlerhafte
990     sendfile-Unterst&uuml;tzung, die das Erstellungssystem nicht erkennt,
991     insbesondere wenn die Bin&auml;rdateien auf einem anderen Rechner erstellt
992     und auf eine solche Maschine mit fehlerhafter sendfile-Unterst&uuml;tzung
993     &uuml;bertragen wurden.</li>
994     <li>Bei einem &uuml;ber das Netzwerk eingebundenen <directive
995     module="core">DocumentRoot</directive> (z.B. NFS oder SMB) ist der
996     Kernel m&ouml;glicherweise nicht in der Lage, die Netzwerkdatei
997     &uuml;ber seinen eigenen Cache zu bedienen.</li>
998     <li>Unter Linux l&ouml;st die Verwendung von <code>sendfile</code>
999     in Verbindung mit bestimmten Netzwerkkarten und IPv6
1000     TCP-Checksummenfehler aus.</li>
1001     <li>Unter Linux auf Itanium-Systemen kommt sendfile unter Umst&auml;nden
1002     nicht mit Dateien gr&ouml;&szlig;er als 2GB klar.</li>
1003     </ul>
1004
1005     <p>Bei Serverkonfigurationen, die f&uuml;r dieses Problam
1006     anf&auml;llig sind, sollten die diese Funktion deaktivieren, indem
1007     Sie schreiben:</p>
1008
1009     <example>
1010       EnableSendfile Off
1011     </example>
1012
1013     <p>Bei per NFS oder SMB eingebundenen Dateien kann diese Funktion
1014     explizit f&uuml;r die st&ouml;renden Dateien deaktiviert werden, indem
1015     Sie angeben:</p>
1016
1017     <example>
1018       &lt;Directory "/pfad-zu-den-nfs-dateien"&gt;
1019       <indent>
1020         EnableSendfile Off
1021       </indent>
1022       &lt;/Directory&gt;
1023     </example>
1024     <p>Beachten Sie bitte, dass die verzeichnisbasierte und
1025        .htaccess-Konfiguration von <directive>EnableSendfile</directive>
1026        nicht vom <module>mod_cache_disk</module>-Modul unterst&uuml;tzt wird.
1027        Nur die globale Konfiguration von <directive>EnableSendfile</directive>
1028        wird vom Modul beachtet.
1029     </p>
1030 </usage>
1031 </directivesynopsis>
1032
1033 <directivesynopsis>
1034 <name>ErrorDocument</name>
1035 <description>Das, was der Server im Fehlerfall an den Client
1036 zur&uuml;ckgibt</description>
1037 <syntax>ErrorDocument <var>Fehlercode</var> <var>Dokument</var></syntax>
1038 <contextlist><context>server config</context><context>virtual host</context>
1039 <context>directory</context><context>.htaccess</context>
1040 </contextlist>
1041 <override>FileInfo</override>
1042 <compatibility>Die Syntax der Anf&uuml;hrungszeichen bei Textnachrichten hat
1043 sich im Apache 2.0 ge&auml;ndert</compatibility>
1044
1045 <usage>
1046     <p>Im Falle eines Problems oder Fehlers kann der Apache
1047     konfiguriert werden, eine der vier Aktionen auszuf&uuml;hren:</p>
1048
1049     <ol>
1050       <li>Ausgabe einer einfachen, hartkodierten Fehlermeldung</li>
1051
1052       <li>Ausgabe einer angepassten Meldung</li>
1053
1054       <li>Umleitung zu einem lokalen <var>URL-Pfad</var> der das
1055       Problem bzw. den Fehler behandelt</li>
1056
1057       <li>Umleitung zu einer externen <var>URL</var>, die das Problem
1058       bzw. den Fehler behandelt</li>
1059     </ol>
1060
1061     <p>Die erste Option ist Voreinstellung, w&auml;hrend die Optionen
1062     2 bis 4 &uuml;ber die Direktive <directive>ErrorDocument</directive>
1063     eingestellt werden, welcher der HTTP-Statuscode und eine
1064     URL oder Nachricht folgen. Abh&auml;ngig vom Problem bzw. Fehler bietet
1065     der Apache manchmal zus&auml;tzliche Informationen an.</p>
1066
1067     <p>URLs k&ouml;nnen bei lokalen Webpfaden mit einem Schr&auml;gstrich
1068     (/) beginnen (relativ zum <directive module="core"
1069     >DocumentRoot</directive>-Verzeichnis) oder eine vollst&auml;ndige URL
1070     bilden, die der Client aufl&ouml;sen kann. Alternativ kann eine
1071     Nachricht f&uuml;r die Anzeige im Browser angeboten werden. Beispiel:</p>
1072
1073     <example>
1074       ErrorDocument 500 http://foo.example.com/cgi-bin/tester<br />
1075       ErrorDocument 404 /cgi-bin/falsche_urls.pl<br />
1076       ErrorDocument 401 /info_zur_anmeldung.html<br />
1077       ErrorDocument 403 "Der Zugriff ist nicht erlaubt."
1078     </example>
1079
1080     <p>Au&szlig;erdem kann der spezielle Wert <code>default</code> angegeben
1081       werden, um die schlichte, hartkodierte Nachricht des Apache zu verwenden.
1082       Es wird normalerweise nicht ben&ouml;tigt, doch <code>default</code>
1083       stellt die einfach, im Apache hartkodierte Meldung in Konfigurationen
1084       wieder her, die ansonsten von einem existierenden <transnote>zuvor
1085         konfigurierten</transnote> <directive>ErrorDocument</directive> erben
1086       w&uuml;rden.</p>
1087
1088     <example>
1089       ErrorDocument 404 /cgi-bin/bad_urls.pl<br /><br />
1090       &lt;Directory /web/docs&gt;<br />
1091       <indent>
1092         ErrorDocument 404 default<br />
1093       </indent>
1094       &lt;/Directory&gt;
1095     </example>
1096
1097     <p>Wenn Sie eine <directive>ErrorDocument</directive>-Anweisung
1098     angeben, die auf eine entfernte URL weist (d.h. irgendetwas mit der
1099     Methode <code>http</code> davor), beachten Sie bitte, dass der Apache
1100     eine Umleitung zum Client sendet, um diesem mitzuteilen, wo das
1101     Dokument zu finden ist, auch wenn das Dokument letztlich wieder zum
1102     gleichen Server f&uuml;hrt. Das hat mehrere Auswirkungen. Die
1103     wichtigste ist, dass der Client nicht den Original-Statuscode
1104     erh&auml;lt sondern statt dessen einen Umleitungs-Statuscode. Dies
1105     wiederum kann Web-Robots und andere Clients verwirren, die den
1106     Statuscode dazu verwenden, herauszufinden ob eine URL g&uuml;ltig ist.
1107     Wenn Sie eine entfernte URL in einer Anweisung
1108     <code>ErrorDocument 401</code> verwenden, wird der Client
1109     dar&uuml;ber hinaus nicht wissen, dass er den Benutzer zur Eingabe
1110     eines Passwortes auffordern muss, da er den Statuscode 401 nicht
1111     erh&auml;lt. <strong>Deshalb m&uuml;ssen Sie sich auf ein lokales
1112     Dokument beziehen, wenn Sie eine Anweisung <code>ErrorDocument
1113     401</code> verwenden.</strong></p>
1114
1115     <p>Der Microsoft Internet Explorer (MSIE) ignoriert
1116     standardm&auml;&szlig;ig serverseitig generierte Fehlermeldungen, wenn
1117     sie "zu kurz" sind und ersetzt sie durch eigene "freundliche"
1118     Fehlermeldungen. Die Gr&ouml;&szlig;e variiert abh&auml;ngig von der
1119     Art des Fehlers, im Allgemeinen zeigt der MSIE jedoch den
1120     serverseitig generierten Fehler, anstatt ihn zu verstecken, wenn Ihr
1121     Fehlerdokument gr&ouml;&szlig;er als 512 Bytes ist. Weitere Informationen
1122     sind im Artikel  <a
1123     href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807"
1124     >Q294807</a> in der Microsoft Knowledgebase verf&uuml;gbar.</p>
1125
1126     <p>Obwohl die meisten Fehlermeldungen &uuml;berschrieben werden
1127     k&ouml;nnen, werden unter bestimmten Umst&auml;nden die internen
1128     Meldungen ungeachtet der Einstellung der <directive module="core"
1129     >ErrorDocument</directive>-Direktive verwendet. Insbesondere bei
1130     einer fehlerhaften Anfrage werden der normale Bearbeitungsprozess sofort
1131     beendet und die interne Meldung zur&uuml;ckgegeben. Das ist notwendig, um
1132     Sicherheitsprobleme zu vermeiden, die auf Grund fehlerhafter Anfragen
1133     entstehen.</p>
1134
1135     <p>In Versionen vor 2.0 wurden Meldungen durch ein einzelnes
1136     vorangestelltes Anf&uuml;hrungszeichen (") erkannt.</p>
1137 </usage>
1138
1139 <seealso><a href="../custom-error.html">Dokumentation zu individuellen
1140 Fehlermeldungen</a></seealso>
1141 </directivesynopsis>
1142
1143 <directivesynopsis>
1144 <name>ErrorLog</name>
1145 <description>Ablageort, an dem der Server Fehler protokolliert</description>
1146 <syntax> ErrorLog <var>Dateiname</var>|syslog[:<var>facility</var>]</syntax>
1147 <default>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and
1148   OS/2)</default>
1149 <contextlist><context>server config</context><context>virtual host</context>
1150 </contextlist>
1151
1152 <usage>
1153     <p>Die Direktive <directive>ErrorLog</directive> bestimmt den Namen
1154     der Datei, in welcher der Server alle auftretenden Fehler protokolliert.
1155     Wenn <var>Dateiname</var> nicht absolut ist, wird er relativ zu <directive
1156     module="core">ServerRoot</directive> betrachtet.</p>
1157
1158     <example><title>Beispiel</title>
1159     ErrorLog /var/log/httpd/error_log
1160     </example>
1161
1162     <p>Wenn der <var>Dateiname</var> mit einem senkrechten Strich (|,
1163     engl.: Pipe) beginnt, wird angenommen, dass es sich um einen Befehl
1164     handelt, der ausgef&uuml;hrt wird, um das Fehlerprotokolls zu
1165     verarbeiten.</p>
1166
1167     <example><title>Beispiel</title>
1168     ErrorLog "|/usr/local/bin/httpd_errors"
1169     </example>
1170
1171     <p>Die Verwendung von <code>syslog</code> anstelle eines Dateinamens
1172     aktiviert die Protokollierung mittels syslogd(8), sofern das System
1173     es unterst&uuml;tzt. Als Voreinstellung wird der syslog-Typ (syslog
1174     facility) <code>local7</code> verwendet, Sie k&ouml;nnen dies jedoch
1175     auch &uuml;berschreiben, indem Sie die Syntax
1176     <code>syslog:<var>facility</var></code> verwenden, wobei
1177     <var>facility</var> einer der Namen sein kann, die &uuml;blicherweise
1178     in syslog(1) dokumentiert sind.</p>
1179
1180     <example><title>Beispiel</title>
1181     ErrorLog syslog:user
1182     </example>
1183
1184     <p>SICHERHEITSHINWEIS: Lesen Sie das Dokument <a
1185     href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
1186     zu Einzelheiten dar&uuml;ber, warum Ihre Sicherheit gef&auml;hrdet
1187     sein kann, wenn das Verzeichnis, in dem die Log-Dateien gespeichert
1188     werden, f&uuml;r jemand anderen, als den Benutzer, der den Server
1189     gestartet hat, beschreibbar ist.</p>
1190
1191     <note type="warning"><title>Anmerkung</title>
1192       <p>Bei der Eingabe eines Dateipfads auf nicht-Unix-Plattformen sollte
1193       darauf geachtet werden, nur (Vorw&auml;rts-)Schr&auml;gstriche zu
1194       verwenden, auch wenn die Plattform r&uuml;ckw&auml;rts gerichtete
1195       Schr&auml;gstriche (Backslashes) erlaubt. Im Allgemeinen ist es eine gute
1196       Idee, innerhalb der Konfigurationsdateien immer
1197       Vorw&auml;rts-Schr&auml;gstriche zu verwenden.</p>
1198     </note>
1199 </usage>
1200 <seealso><directive module="core">LogLevel</directive></seealso>
1201 <seealso><a href="../logs.html">Apache-Log-Dateien</a></seealso>
1202 </directivesynopsis>
1203
1204 <directivesynopsis>
1205 <name>FileETag</name>
1206 <description>Dateiattribute, die zur Erstellung des HTTP-Response-Headers
1207 ETag verwendet werden</description>
1208 <syntax>FileETag <var>Komponente</var> ...</syntax>
1209 <default>FileETag INode MTime Size</default>
1210 <contextlist><context>server config</context><context>virtual host</context>
1211 <context>directory</context><context>.htaccess</context>
1212 </contextlist>
1213 <override>FileInfo</override>
1214
1215 <usage>
1216     <p>Wenn dem Dokument eine Datei zugrundeliegt, bestimmt die Direktive
1217     <directive>FileETag</directive> die Dateiattribute, die zur Erstellung
1218     des HTTP-Response-Headers <code>ETag</code> (Entity-Tag) verwendet
1219     werden. (Der Wert von <code>ETag</code> wird bei der Cache-Verwaltung
1220     zur Einsparung von Netzwerk-Bandbreite benutzt.) Im Apache 1.3.22 und
1221     fr&uuml;her wurde der <code>ETag</code>-Wert <em>stets</em> aus
1222     der I-Node, der Gr&ouml;&szlig;e und dem Datum der letzten
1223     &Auml;nderung (mtime) der Datei gebildet. Die Direktive
1224     <directive>FileETag</directive> erlaubt es Ihnen, zu bestimmen,
1225     welche dieser Eigenschaften -- falls &uuml;berhaupt -- verwendet
1226     werden sollen. Die g&uuml;ltigen Schl&uuml;sselworte lauten:</p>
1227
1228     <dl>
1229      <dt><strong>INode</strong></dt>
1230      <dd>Die I-Node-Nummer wird in die Berechnung mit einbezogen</dd>
1231      <dt><strong>MTime</strong></dt>
1232      <dd>Datum und Uhrzeit der letzten &Auml;nderung werden mit einbezogen</dd>
1233      <dt><strong>Size</strong></dt>
1234      <dd>Die Anzahl der Bytes in der Datei wird mit einbezogen</dd>
1235      <dt><strong>All</strong></dt>
1236      <dd>Alle verf&uuml;gbaren Angaben werden verwendet. Die ist
1237      gleichbedeutend mit:
1238          <example>FileETag INode MTime Size</example></dd>
1239      <dt><strong>None</strong></dt>
1240      <dd>Es wird keine <code>ETag</code>-Angabe in die Antwort eingef&uuml;gt,
1241      wenn dem Dokument eine Datei zugrundeliegt.</dd>
1242     </dl>
1243
1244     <p>Den Schl&uuml;sselw&ouml;rtern <code>INode</code>, <code>MTime</code>
1245     und <code>Size</code> kann entweder ein <code>+</code> oder ein
1246     <code>-</code> vorangestellt werden, was die &Auml;nderung einer
1247     Vorgabe erlaubt, die von einem gr&ouml;&szlig;eren Umfeld
1248     geerbt wurde. Jedes Schl&uuml;selwort ohne ein solches Prefix
1249     hebt die ererbte Einstellung sofort und vollst&auml;ndig auf.</p>
1250
1251     <p>Wenn die Konfiguration f&uuml;r ein Verzeichnis
1252     <code>FileETag&nbsp;INode&nbsp;MTime&nbsp;Size</code> enth&auml;lt
1253     und die eines Unterverzeichnisses <code>FileETag&nbsp;-INode</code>,
1254     dann ist die Einstellung f&uuml;r das Unterverzeichnis (die an
1255     jedes Unter-Unterverzeichnis weitervererbt wird, welches dies nicht
1256     &uuml;berschreibt) &auml;quivalent mit
1257     <code>FileETag&nbsp;MTime&nbsp;Size</code>.</p>
1258 </usage>
1259 </directivesynopsis>
1260
1261 <directivesynopsis type="section">
1262 <name>Files</name>
1263 <description>Enth&auml;lt Direktiven, die sich nur auf passende Dateinamen
1264 beziehen</description>
1265 <syntax>&lt;Files <var>Dateiname</var>&gt; ... &lt;/Files&gt;</syntax>
1266 <contextlist><context>server config</context><context>virtual host</context>
1267 <context>directory</context><context>.htaccess</context>
1268 </contextlist>
1269 <override>All</override>
1270
1271 <usage>
1272     <p>Die Direktive <directive type="section">Files</directive>
1273     begrenzt die Reichweite der enthaltenen Anweisungen auf Dateinamen.
1274     Sie ist vergleichbar mit den Direktiven <directive
1275     module="core" type="section">Directory</directive> und <directive
1276     module="core" type="section">Location</directive>. Sie muss eine
1277     passende <code>&lt;/Files&gt;</code>-Anweisung besitzen.
1278     Die innerhalb dieses Abschnittes angegebenen Direktiven werden auf
1279     jedes Objekt mit einem Basisnamen (letzte Komponente des Dateinamens)
1280     angewendet, der auf die angegebenen Dateinamen passt. <directive
1281     type="section">Files</directive>-Container werden, nachdem die
1282     <directive module="core" type="section">Directory</directive>-Container
1283     und <code>.htaccess</code>-Dateien gelesen sind, jedoch vor den
1284     <directive type="section" module="core">Location</directive>-Containern,
1285     in der Reihenfolge ihres Auftretens ausgef&uuml;hrt. Beachten Sie, dass
1286     <directive type="section">Files</directive>-Anweisungen innerhalb von
1287     <directive type="section" module="core">Directory</directive>-Containern
1288     auftreten k&ouml;nnen, um den Teil des Dateisystems einzuschr&auml;nken,
1289     den sie betreffen.</p>
1290
1291     <p>Das Argument <var>Dateiname</var> kann einen Dateinamen oder eine
1292     Zeichenkette mit Platzhaltern enthalten, wobei <code>?</code> auf ein
1293     einzelnes Zeichen passt und <code>*</code> auf eine beliebige Folge von
1294     Zeichen. Erweiterte <glossary ref="regex">regul&auml;re
1295     Ausdr&uuml;cke</glossary> k&ouml;nnen ebenfalls verwendet werden, indem
1296     das Zeichen <code>~</code> hinzugef&uuml;gt wird. Beispielsweise
1297     w&uuml;rde</p>
1298
1299     <example>
1300       &lt;Files ~ "\.(gif|jpe?g|png)$"&gt;
1301     </example>
1302
1303     <p>auf die gebr&auml;uchlichsten Grafikformate im Internet passen.
1304     <directive module="core" type="section">FilesMatch</directive> wird
1305     jedoch bevorzugt.</p>
1306
1307     <p>Beachten Sie bitte, dass die <directive
1308     type="section">Files</directive>-Container anders als <directive
1309     type="section" module="core">Directory</directive>- und <directive
1310     type="section" module="core">Location</directive>-Container innerhalb
1311     von <code>.htaccess</code>-Dateien verwendet werden k&ouml;nnen.
1312     Dies erlaubt den Anwendern auf Dateiebene die Kontrolle &uuml;ber ihre
1313     eigenen Dateien.</p>
1314 </usage>
1315 <seealso><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
1316     &lt;Location&gt; und &lt;Files&gt; arbeiten</a> f&uuml;r eine
1317     Erl&auml;uterung, wie diese verschiedenen Abschnitte miteinander
1318     kombiniert werden, wenn eine Anfrage empfangen wird</seealso>
1319 </directivesynopsis>
1320
1321 <directivesynopsis type="section">
1322 <name>FilesMatch</name>
1323 <description>Enth&auml;lt Direktiven, die f&uuml;r Dateinamen gelten, die
1324   auf einen regul&auml;ren Ausdruck passen</description>
1325 <syntax>&lt;FilesMatch <var>regex</var>&gt; ... &lt;/FilesMatch&gt;</syntax>
1326 <contextlist><context>server config</context><context>virtual host</context>
1327 <context>directory</context><context>.htaccess</context>
1328 </contextlist>
1329 <override>All</override>
1330
1331 <usage>
1332     <p>Die Direktive <directive type="section">FilesMatch</directive>
1333     begrenzt wie die Direktive <directive module="core"
1334     type="section">Files</directive> die enthaltenen Anweisungen auf
1335     Dateinamen. Sie akzeptiert jedoch <glossary ref="regex">regul&auml;re
1336     Ausdr&uuml;cke</glossary>. Beispielsweise w&uuml;rde</p>
1337
1338     <example>
1339       &lt;FilesMatch "\.(gif|jpe?g|png)$"&gt;
1340     </example>
1341
1342     <p>auf die gebr&auml;uchlichsten Grafikformate im Internet passen.</p>
1343 </usage>
1344
1345 <seealso><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
1346     &lt;Location&gt; und &lt;Files&gt; arbeiten</a> f&uuml;r eine
1347     Erl&auml;uterung, wie diese verschiedenen Abschnitte miteinander
1348     kombiniert werden, wenn eine Anfrage empfangen wird</seealso>
1349 </directivesynopsis>
1350
1351 <directivesynopsis>
1352 <name>ForceType</name>
1353 <description>Erzwingt die Auslieferung aller passendenden Dateien mit dem
1354 angegebenen MIME-Content-Type</description>
1355 <syntax>ForceType <var>MIME-Type</var>|None</syntax>
1356 <contextlist><context>directory</context><context>.htaccess</context>
1357 </contextlist>
1358 <override>FileInfo</override>
1359 <compatibility>Wurde im Apache 2.0 in den Core verschoben</compatibility>
1360
1361 <usage>
1362     <p>Wenn sie innerhalb einer <code>.htaccess</code>-Datei, eines
1363     <directive type="section" module="core">Directory</directive>-,
1364     <directive type="section" module="core">Location</directive>-
1365     <directive type="section" module="core">Files</directive>-Containers
1366     angegeben wird, erzwingt die Direktive die Auslieferung aller
1367     entsprechenden Dateien mit dem Content-Type, der durch
1368     <var>MIME-Type</var> definiert wurde. Wenn Sie zum Beispiel ein
1369     Verzeichnis voller GIF-Dateien haben, die Sie nicht alle durch
1370     <code>.gif</code> kennzeichnen wollen, k&ouml;nnen Sie angeben:</p>
1371
1372     <example>
1373       ForceType image/gif
1374     </example>
1375
1376     <p>Beachten Sie bitte, dass die Direktive anders als <directive
1377     module="core">DefaultType</directive> alle MIME-Type-Zuordnungen
1378     &uuml;berschreibt, einschlie&szlig;lich Dateiendungen, die einen
1379     Medientyp bezeichnen k&ouml;nnten.</p>
1380
1381     <p>Sie k&ouml;nnen jede <directive>ForceType</directive>-Angabe
1382     durch die Verwendung des Wertes <code>None</code> &uuml;berschreiben:</p>
1383
1384     <example>
1385       # erzwinge image/gif f&uuml;r alle Dateien:<br />
1386       &lt;Location /images&gt;<br />
1387         <indent>
1388           ForceType image/gif<br />
1389         </indent>
1390       &lt;/Location&gt;<br />
1391       <br />
1392       # hier jedoch normale MIME-Type-Zuordnungen:<br />
1393       &lt;Location /images/mixed&gt;<br />
1394       <indent>
1395         ForceType None<br />
1396       </indent>
1397       &lt;/Location&gt;
1398     </example>
1399 </usage>
1400 </directivesynopsis>
1401
1402 <directivesynopsis>
1403 <name>HostnameLookups</name>
1404 <description>Aktiviert DNS-Lookups auf Client-IP-Adressen</description>
1405 <syntax>HostnameLookups On|Off|Double</syntax>
1406 <default>HostnameLookups Off</default>
1407 <contextlist><context>server config</context><context>virtual host</context>
1408 <context>directory</context></contextlist>
1409
1410 <usage>
1411     <p>Diese Direktive aktiviert die DNS-Abfrage <transnote>ein sogenannter
1412     DNS-Lookup</transnote>, so dass Hostnamen protokolliert (und in
1413     <code>REMOTE_HOST</code> an CGIs/SSIs &uuml;bergeben) werden k&ouml;nnnen.
1414     Der Wert <code>Double</code> bezieht sich auf ein
1415     Double-Reverse-DNS-Lookup. D.h. nachdem ein Reverse-Lookup
1416     durchgef&uuml;hrt wurde, wird dann auf dem Ergebnis ein
1417     Forward-Lookup ausgef&uuml;hrt. Wenigstens eine der IP-Adressen
1418     aus dem Forward-Lookup muss der Originaladresse entsprechen.
1419     (In der "tcpwrappers"-Terminologie wird dies <code>PARANOID</code>
1420     genannt.)</p>
1421
1422     <p>Unabh&auml;ngig von der Einstellung wird ein Double-Reverse-Lookup
1423     durchgef&uuml;hrt, wenn <module>mod_authz_host</module> zur
1424     Zugriffskontrolle per Hostnamen eingesetzt wird. Dies ist aus
1425     Sicherheitsgr&uuml;nden notwendig. Beachten Sie, dass das Ergebnis dieses
1426     Double-Reverse-Lookups nicht generell verf&uuml;gbar ist, solange Sie
1427     nicht <code>HostnameLookups Double</code> setzen. Wenn beispielsweise
1428     nur <code>HostnameLookups On</code> angegeben ist und eine Anfrage
1429     f&uuml;r ein Objekt erfolgt, welches durch Hostnamen-Beschr&auml;nkungen
1430     gesch&uuml;tzt ist, dann wird CGIs nur das Ergebnis des
1431     Singel-Reverse-Lookups in <code>REMOTE_HOST</code> &uuml;bergeben,
1432     egal ob das Doble-Reverse-Lookup fehlschlug oder nicht.</p>
1433
1434     <p>Die Voreinstellung ist <code>Off</code>, um Netzwerktraffic bei den
1435     Angeboten einzusparen, die nicht tats&auml;chlich Reverse-Lookups
1436     ben&ouml;tigen. Es ist auch f&uuml;r die Endanwender besser, da sie nicht
1437     die zus&auml;tzliche Wartezeit ertragen m&uuml;ssen, die ein Lookup mit
1438     sich bringt. Hoch frequentierte Angebote sollten diese Direktive auf
1439     <code>Off</code>lassen. Das Hilfsprogramm <program>
1440     logresolve</program>, das standardm&auml;&szlig;ig in das
1441     Unterverzeichnis <code>bin</code> Ihres Installationsverzeichnisses
1442     kompiliert wird, kann dazu verwendet werden, um offline Hostnamen von
1443     protokollierten IP-Adressen nachzuschlagen.</p>
1444 </usage>
1445 </directivesynopsis>
1446
1447 <directivesynopsis type="section">
1448 <name>IfDefine</name>
1449 <description>Schlie&szlig;t Direktiven ein, die nur ausgef&uuml;hrt werden,
1450 wenn eine Testbedingung beim Start wahr ist</description>
1451 <syntax>&lt;IfDefine [!]<var>Parametername</var>&gt; ...
1452     &lt;/IfDefine&gt;</syntax>
1453 <contextlist><context>server config</context><context>virtual host</context>
1454 <context>directory</context><context>.htaccess</context>
1455 </contextlist>
1456 <override>All</override>
1457
1458 <usage>
1459     <p>Der Container <code>&lt;IfDefine <var>Test</var>&gt;...&lt;/IfDefine&gt;
1460     </code> wird dazu verwendet, Direktiven als bedingt zu kennzeichnen.
1461     Die Direktiven innerhalb eines <directive
1462     type="section">IfDefine</directive>-Abschnittes werden nur ausgef&uuml;hrt,
1463     wenn <var>Test</var> wahr ist. Ist <var>Test</var> falsch, wird alles
1464     zwischen der Start- und Endemarkierung ignoriert.</p>
1465
1466     <p>In der <directive type="section">IfDefine</directive>-Anweisung kann
1467     <var>Test</var> eine von zwei Formen annehmen:</p>
1468
1469     <ul>
1470       <li><var>Parametername</var></li>
1471
1472       <li><code>!</code><var>Parametername</var></li>
1473     </ul>
1474
1475     <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1476     Endemarkierung nur ausgef&uuml;hrt, wenn der Parameter namens
1477     <var>Parametername</var> definiert ist. Die zweite Form kehrt den
1478     Test um und f&uuml;hrt die Direktiven nur dann aus, wenn
1479     <var>Parametername</var> <strong>nicht</strong> definiert ist.</p>
1480
1481     <p>Das Argument <var>Parametername</var> ist ein sogenanntes
1482     "Define", das beim beim Start des Servers in der
1483     <program>httpd</program>-Befehlszeile durch
1484     <code>-D<var>Parameter</var></code> angegeben wird.</p>
1485
1486     <p><directive type="section">IfDefine</directive>-Container k&ouml;nnen
1487     ineinander verschachtelt werden, um einfache Multi-Parameter-Tests
1488     zu implementieren. Beispiel:</p>
1489
1490     <example>
1491       httpd -DReverseProxy ...<br />
1492       <br />
1493       # httpd.conf<br />
1494       &lt;IfDefine ReverseProxy&gt;<br />
1495       <indent>
1496         LoadModule rewrite_module modules/mod_rewrite.so<br />
1497         LoadModule proxy_module   modules/libproxy.so<br />
1498       </indent>
1499       &lt;/IfDefine&gt;
1500     </example>
1501 </usage>
1502 </directivesynopsis>
1503
1504 <directivesynopsis type="section">
1505 <name>IfModule</name>
1506 <description>Schlie&szlig;t Direktiven ein, die abh&auml;ngig vom
1507 Vorhandensein oder Fehlen eines speziellen Moduls ausgef&uuml;hrt
1508 werden</description>
1509 <syntax>&lt;IfModule [!]<var>Modulname</var>|<var>Modulbezeichner</var>&gt;
1510   ... &lt;/IfModule&gt;</syntax>
1511 <contextlist><context>server config</context><context>virtual host</context>
1512 <context>directory</context><context>.htaccess</context>
1513 </contextlist>
1514 <override>All</override>
1515 <compatibility>Modulbezeichner sind ab Version 2.1
1516   verf&uuml;gbar.</compatibility>
1517
1518
1519 <usage>
1520     <p>Der Container <code>&lt;IfModule
1521     <var>Test</var>&gt;...&lt;/IfModule&gt;</code> wird dazu verwendet,
1522     Direktiven als abh&auml;ngig von dem Vorhandensein eines speziellen
1523     Moduls zu kennzeichnen. Die Direktiven innerhalb eines <directive
1524     type="section">IfModule</directive>-Abschnitts werden nur
1525     ausgef&uuml;hrt, wenn <var>Test</var> wahr ist. Ist <var>Test</var>
1526     falsch, wird alles zwischen der Start- und Endemarkierung ignoriert.</p>
1527
1528     <p>In der <directive type="section">IfModule</directive>-Anweisung
1529     kann <var>Test</var> eine von zwei Formen annehmen:</p>
1530
1531     <ul>
1532       <li><var>Modul</var></li>
1533
1534       <li><code>!</code><var>Modul</var></li>
1535     </ul>
1536
1537     <p>Im ersten Fall werden die Direktiven zwischen der Start- und
1538     Endemarkierung nur ausgef&uuml;hrt, das Modul namens
1539     <var>Modul</var> im Apache enthalten ist -- entweder einkompiliert
1540     oder mittels <directive module="mod_so">LoadModule</directive>
1541     dynamisch geladen. Die zweite Form dreht den Test um und f&uuml;hrt die
1542     Direktiven nur aus, wenn <var>Modul</var> <strong>nicht</strong>
1543     enthalten ist.</p>
1544
1545     <p>Das Argument <var>Modul</var> kann entweder der Modulbezeichner oder
1546       der Dateiname des Moduls zum Zeitpunkt seiner Kompilierung sein. 
1547       <code>rewrite_module</code> beispielsweise ist der Bezeichner und
1548       <code>mod_rewrite.c</code> ist der Dateiname. Wenn ein Modul aus mehreren
1549       Quelltext-Dateien besteht, verwenden Sie den Namen der Datei, welche die
1550       Zeichenfolge <code>STANDARD20_MODULE_STUFF</code> enth&auml;lt.</p>
1551
1552     <p><directive type="section">IfModule</directive>-Container k&ouml;nnen
1553     inneinander verschachtelt werden, um einfache Multi-Modul-Tests
1554     durchzuf&uuml;hren.</p>
1555
1556     <p>Dieser Container sollte verwendet werden, wenn Sie eine
1557     Konfigurationsdatei ben&ouml;tigen, die unabh&auml;ngig davon funktioniert,
1558     ob ein bestimmtes Modul verf&uuml;gbar ist oder nicht. Normalerweise
1559     ist es nicht notwendig, Direktiven in <directive
1560     type="section">IfModule</directive>-Containern unterzubringen.</p>
1561 </usage>
1562 </directivesynopsis>
1563
1564 <directivesynopsis>
1565 <name>Include</name>
1566 <description>F&uuml;gt andere Konfigurationsdateien innerhalb der
1567 Server-Konfigurationsdatei ein</description>
1568 <syntax>Include <var>Dateiname</var>|<var>Verzeichnis</var></syntax>
1569 <contextlist><context>server config</context><context>virtual host</context>
1570 <context>directory</context>
1571 </contextlist>
1572 <compatibility>Die Platzhalter-Suche ist verf&uuml;gbar seit
1573 2.0.41</compatibility>
1574
1575 <usage>
1576     <p>Die Direktive erlaubt das Einf&uuml;gen anderer Konfigurationsdateien
1577     in die Konfigurationsdatei des Servers.</p>
1578
1579     <p>Shell-typische (<code>fnmatch()</code>) Platzhlaterzeichen k&ouml;nnen
1580     dazu verwendet werden, mehrere Dateien auf einmal in alphabetischer
1581     Reihenfolge einzuf&uuml;gen. Wenn <directive>Include</directive>
1582     dar&uuml;ber hinaus auf ein Verzeichnis anstatt auf eine Datei zeigt,
1583     liest der Apache alle Dateien in diesem Verzeichnis und allen
1584     Unterverzeichnissen ein. Das Einf&uuml;gen ganzer Verzeichnisse ist
1585     jedoch nicht empfehlenswert, da tempor&auml;re Dateien sehr leicht
1586     versehentlich in einem Verzeichnis zur&uuml;ckgelassen werden, was
1587     <program>httpd</program> scheitern lassen kann.</p>
1588
1589     <p>Der angegebene Dateiname kann ein absoluter Pfad sein oder relativ zum
1590     <directive module="core">ServerRoot</directive>-Verzeichnis angegeben
1591     werden.</p>
1592
1593     <p>Beispiele:</p>
1594
1595     <example>
1596       Include /usr/local/apache2/conf/ssl.conf<br />
1597       Include /usr/local/apache2/conf/vhosts/*.conf
1598     </example>
1599
1600     <p>Oder Sie geben Pfade relativ zu Ihrem <directive
1601     module="core">ServerRoot</directive>-Verzeichnis an:</p>
1602
1603     <example>
1604       Include conf/ssl.conf<br />
1605       Include conf/vhosts/*.conf
1606     </example>
1607
1608     <p>Der Aufruf von <code>apachectl configtest</code> liefert eine Liste
1609     der Dateien, die w&auml;hrend des Konfigurations-Tests verarbeitet
1610     werden:</p>
1611
1612     <example>
1613       root@host# apachectl configtest<br />
1614       Processing config file: /usr/local/apache2/conf/ssl.conf<br />
1615       Processing config file: /usr/local/apache2/conf/vhosts/vhost1.conf<br />
1616       Processing config file: /usr/local/apache2/conf/vhosts/vhost2.conf<br />
1617       Syntax OK
1618     </example>
1619 </usage>
1620
1621 <seealso><program>apachectl</program></seealso>
1622 </directivesynopsis>
1623
1624 <directivesynopsis>
1625 <name>KeepAlive</name>
1626 <description>Aktiviert persistente HTTP-Verbindungen</description>
1627 <syntax>KeepAlive On|Off</syntax>
1628 <default>KeepAlive On</default>
1629 <contextlist><context>server config</context><context>virtual host</context>
1630 </contextlist>
1631
1632 <usage>
1633     <p>Die Keep-Alive-Erweiterung von HTTP/1.0 und die
1634     HTTP/1.1-Funktionalit&auml;t persistenter Verbindungen unterst&uuml;tzt
1635     langlebige HTTP-Sitzungen, die es erlauben, mehrere Anfragen &uuml;ber
1636     die gleich TCP-Verbindung zu senden. In einigen F&auml;llen wurde eine
1637     Beschleunigung der Wartezeiten von beinahe 50% f&uuml;r HTML-Dokumente
1638     mit vielen Bildern festgestellt. Um Keep-Alive-Verbindungen zu aktivieren,
1639     setzen Sie <code>KeepAlive On</code>.</p>
1640
1641     <p>Bei HTTP/1.0-Clients werden Keep-Alive-Verbindungen nur dann verwendet,
1642     wenn sie vom Client eigens angefordert werden. Desweiteren k&ouml;nnen
1643     Keep-Alive-Verbindungen bei einem HTTP/1.0-Client nur dann verwendet
1644     werden, wenn die L&auml;nge des Inhalts im Voraus bekannt ist. Dies
1645     impliziert, dass dynamische Inhalte wie CGI-Ausgaben, SSI-Seiten und
1646     servergenerierte Verzeichnisauflistungen im Allgemeinen keine
1647     Keep-Alive-Verbindungen mit HTTP/1.0-Clients verwenden. Bei
1648     HTTP/1.1-Clients sind Keep-Alive-Verbindungen Voreinstellung, solange
1649     nichts anderes angegeben ist. Wenn der Client es anfordert, wird
1650     Chunked-Encoding verwendet, um Inhalte mit unbekannter L&auml;nge
1651     &uuml;ber persistente Verbindungen zu senden.</p>
1652 </usage>
1653
1654 <seealso><directive module="core">MaxKeepAliveRequests</directive></seealso>
1655 </directivesynopsis>
1656
1657 <directivesynopsis>
1658 <name>KeepAliveTimeout</name>
1659 <description>Zeitspanne, die der Server w&auml;hrend persistenter Verbindungen
1660 auf nachfolgende Anfragen wartet</description>
1661 <syntax>KeepAliveTimeout <var>Sekunden</var></syntax>
1662 <default>KeepAliveTimeout 5</default>
1663 <contextlist><context>server config</context><context>virtual host</context>
1664 </contextlist>
1665
1666 <usage>
1667     <p>Dies legt die Anzahl der Sekunden fest, die der Apache auf weitere
1668     Anfragen wartet, bevor er die Verbindung schlie&szlig;t. Nachdem einmal
1669     eine Anfrage entgegen genommen wurde, wird die durch die Direktive
1670     <directive module="core">Timeout</directive> festgelegte Auszeit
1671     angewendet.</p>
1672
1673     <p>Auf stark belasteten Servern kann ein hoher
1674     <directive>KeepAliveTimeout</directive>-Wert zu Durchsatzminderungen
1675     f&uuml;hren. Je h&ouml;her die Auszeit angegeben ist, desto l&auml;nger
1676     ist der Apache damit besch&auml;ftigt, auf unt&auml;tige Clients zu
1677     warten.</p>
1678 </usage>
1679 </directivesynopsis>
1680
1681 <directivesynopsis type="section">
1682 <name>Limit</name>
1683 <description>Beschr&auml;nkt die eingeschlossenen Zugriffskontrollen auf
1684 bestimmte HTTP-Methoden</description>
1685 <syntax>&lt;Limit <var>Methode</var> [<var>Methode</var>] ... &gt; ...
1686     &lt;/Limit&gt;</syntax>
1687 <contextlist><context>server config</context><context>virtual host</context>
1688 <context>directory</context><context>.htaccess</context>
1689 </contextlist>
1690 <override>All</override>
1691
1692 <usage>
1693     <p>Zugriffskontrollen gelten normalerweise f&uuml;r <strong>alle</strong>
1694     Zugriffsmethoden, was normalerweise auch das gew&uuml;nschte Verhalten ist.
1695     <strong>Im Allgemeinen sollten Zugriffskontrollen nicht in einen
1696     <directive type="section">Limit</directive>-Container gepackt
1697     werden.</strong></p>
1698
1699     <p>Der Sinn der Direktive <directive type="section">Limit</directive>
1700     ist es, den Effekt der Zugriffskontrollen auf die angegebenen
1701     HTTP-Methoden zu beschr&auml;nken. Bei allen anderen Methoden haben
1702     die in der <directive type="section">Limit</directive>-Gruppe
1703     enthaltenen Zugriffsbeschr&auml;nkungen <strong>keine Wirkung</strong>.
1704     Im folgenden Beispiel gilt die Zugriffskontrolle nur f&uuml;r die
1705     Methoden <code>POST</code>, <code>PUT</code> und <code>DELETE</code>.
1706     Alle anderen Methoden bleiben ungesch&uuml;tzt:</p>
1707
1708     <example>
1709       &lt;Limit POST PUT DELETE&gt;<br />
1710       <indent>
1711         Require valid-user<br />
1712       </indent>
1713       &lt;/Limit&gt;
1714     </example>
1715
1716     <p>Sie k&ouml;nnen eine oder mehrere der folgenden Methoden angeben:
1717     <code>GET</code>, <code>POST</code>, <code>PUT</code>, <code>DELETE</code>,
1718     <code>CONNECT</code>, <code>OPTIONS</code>,
1719     <code>PATCH</code>, <code>PROPFIND</code>, <code>PROPPATCH</code>,
1720     <code>MKCOL</code>, <code>COPY</code>, <code>MOVE</code>,
1721     <code>LOCK</code> und <code>UNLOCK</code>. <strong>Die Methodennamen
1722     unterscheiden zwischen Gro&szlig;- und Kleinschreibung.</strong> Wenn
1723     <code>GET</code> verwendet wird, sind <code>HEAD</code>-Anfragen
1724     ebenfalls eingeschr&auml;nkt. Die <code>TRACE</code>-Methode kann nicht
1725     limitiert werden.</p>
1726
1727     <note type="warning">
1728       Wenn es um Zugriffsbeschr&auml;nkungen geht, sollte
1729       ein <directive module="core" type="section"
1730       >LimitExcept</directive>-Container sollte immer einem <directive
1731       module="core" type="section">Limit</directive>-Container vorgezogen
1732       werden, da <directive module="core" type="section">LimitExcept</directive>
1733       einen Schutz gegen beliebige Methoden bietet.
1734     </note>
1735 </usage>
1736 </directivesynopsis>
1737
1738 <directivesynopsis type="section">
1739 <name>LimitExcept</name>
1740 <description>Beschr&auml;nkt Zugriffskontrollen auf alle HTTP-Methoden
1741 au&szlig;er den genannten</description>
1742 <syntax>&lt;LimitExcept <var>Methode</var> [<var>Methode</var>] ... &gt; ...
1743     &lt;/LimitExcept&gt;</syntax>
1744 <contextlist><context>server config</context><context>virtual host</context>
1745 <context>directory</context><context>.htaccess</context>
1746 </contextlist>
1747 <override>All</override>
1748
1749 <usage>
1750     <p><directive type="section">LimitExcept</directive> und
1751     <code>&lt;/LimitExcept&gt;</code> werden dazu verwendet, eine Gruppe
1752     von Anweisungen zur Zugriffskontrolle zusammenzufassen, die dann auf
1753     jede HTTP-Methode angewendet werden, die <strong>nicht</strong>
1754     als Argument angegeben ist. D.h. dies ist das Gegenteil des
1755     <directive type="section" module="core">Limit</directive>-Containers
1756     und kann zur Steuerung von Standard- und nicht-Standard-/unbekannten
1757     Methoden verwendet werden. F&uuml;r weitere Einzelheiten lesen Sie bitte
1758     die Beschreibung zu <directive module="core"
1759     type="section">Limit</directive>.</p>
1760
1761     <p>Beispiel:</p>
1762
1763     <example>
1764       &lt;LimitExcept POST GET&gt;<br />
1765       <indent>
1766         Require valid-user<br />
1767       </indent>
1768       &lt;/LimitExcept&gt;
1769     </example>
1770
1771 </usage>
1772 </directivesynopsis>
1773
1774 <directivesynopsis>
1775 <name>LimitInternalRecursion</name>
1776 <description>Bestimmt die maximale Anzahl interner Umleitungen und 
1777   verschachtelter Unteranfragen</description>
1778 <syntax>LimitInternalRecursion <var>Zahl</var> [<var>Zahl</var>]</syntax>
1779 <default>LimitInternalRecursion 10</default>
1780 <contextlist><context>server config</context><context>virtual host</context>
1781 </contextlist>
1782 <compatibility>Verf&uuml;gbar ab Apache 2.0.47</compatibility>
1783
1784 <usage>
1785     <p>Eine interne Umleitung erfolgt beispielsweise, wenn die Direktive
1786     <directive module="mod_actions">Action</directive> verwendet wird, welche
1787     die Originalanfrage intern zu einem CGI-Skript weiterleitet. Eine
1788     Unteranfrage <transnote>engl. Subrequest</transnote> ist ein Mechanismus des
1789     Apache, um herauszufinden, was bei einer URI geschehen w&uuml;rde, w&auml;re
1790     sie angefordert worden. <module>mod_dir</module> z.B. verwendet
1791     Unteranfragen, um nach den Dateien zu suchen, die in der <directive
1792     module="mod_dir">DirectoryIndex</directive>-Anweisung aufgef&uuml;hrt
1793     sind.</p>
1794     
1795     <p><directive>LimitInternalRecursion</directive> bewahrt den Server vor
1796       einem Absturz, wenn er in eine Endlosschleife aus internen Umleitungen
1797       oder Unteranfragen hineinl&auml;uft. Derartige Schleifen werden
1798       gew&ouml;hnlich durch Fehlkonfiguration verursacht.</p>
1799
1800     <p>Die Direktive setzt zwei verschiedene Begrenzungen, welche je Anfrage
1801       ausgewertet werden. Die erste <var>Zahl</var> bestimmt die maximale
1802       Anzahl der Umleitungen, die aufeinander folgen d&uuml;rfen. Die zweite
1803       <var>Zahl</var> legt fest, wie tief Unteranfragen ineinander
1804       verschachtelt werden d&uuml;rfen. Wenn Sie lediglich eine <var>Zahl</var>
1805       angeben, wird sie beiden Begrenzungen zugewiesen.</p>
1806
1807     <example><title>Beispiel</title>
1808       LimitInternalRecursion 5
1809     </example>
1810 </usage>
1811 </directivesynopsis>
1812
1813 <directivesynopsis>
1814 <name>LimitRequestBody</name>
1815 <description>Begrenzt die Gesamtgr&ouml;&szlig;e des vom Client gesendeten
1816 HTTP-Request-Body</description>
1817 <syntax>LimitRequestBody <var>Bytes</var></syntax>
1818 <default>LimitRequestBody 0</default>
1819 <contextlist><context>server config</context><context>virtual host</context>
1820 <context>directory</context><context>.htaccess</context>
1821 </contextlist>
1822 <override>All</override>
1823
1824 <usage>
1825     <p>Die Direktive gibt die Anzahl der <var>Bytes</var> zwischen 0
1826     (unbegrenzt) und 2147483647 (2GB) an, die im Request-Body (Datenteil der
1827     Anfrage) erlaubt sind.</p>
1828
1829     <p>Die Direktive <directive>LimitRequestBody</directive> erlaubt es dem
1830     Benutzer, die Gr&ouml;&szlig;e des HTTP-Request-Bodys in dem Kontext zu
1831     begrenzen, in dem die Anweisung angegeben ist (Server, pro Verzeichnis,
1832     pro Datei oder pro Adresse). Wenn die Anfrage des Clients dieses Limit
1833     &uuml;berschreitet, gibt der Server einen Fehler zur&uuml;ck anstatt die
1834     Anfrage zu bearbeiten. Die Gr&ouml;&szlig;e des Datenteils einer Anfrage
1835     kann sehr stark variieren, abh&auml;ngig von der Art der Ressource und
1836     den f&uuml;r diese Ressource erlaubten Methoden. CGI-Skripte verwenden
1837     den Datenteil &uuml;blicherweise zum Empfang von Formulardaten. Wird
1838     die <code>PUT</code>-Methode angewendet, dann muss der Wert mindestens
1839     so gro&szlig; sein wie irgendeine Darstellungsform, die der Server
1840     f&uuml;r diese Ressource akzeptieren soll.</p>
1841
1842     <p>Die Direktive gibt dem Serveradministrator eine gr&ouml;&szlig;ere
1843     Kontrolle gegen&uuml;ber abnormalem Verhalten von Clients, was bei der
1844     Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1845     sein kann.</p>
1846
1847     <p>Wenn Sie beispielsweise das Hochladen von Dateien zu einer bestimmten
1848     Adresse erlauben, aber die Gr&ouml;&szlig;e der hochgeladenen Dateien
1849     auf 100K beschr&auml;nken wollen, k&ouml;nnen Sie die folgende Anweisung
1850     verwenden:</p>
1851
1852     <example>
1853       LimitRequestBody 102400
1854     </example>
1855
1856 </usage>
1857 </directivesynopsis>
1858
1859 <directivesynopsis>
1860 <name>LimitRequestFields</name>
1861 <description>Begrenzt die Anzahl der HTTP-Request-Header, die vom Client
1862 entgegengenommen werden</description>
1863 <syntax>LimitRequestFields <var>Anzahl</var></syntax>
1864 <default>LimitRequestFields 100</default>
1865 <contextlist><context>server config</context></contextlist>
1866
1867 <usage>
1868     <p><var>Anzahl</var> ist ein Integer-Wert (eine positive Ganzzahl)
1869     zwischen 0 (unbegrenzt) und 32767. Die Voreinstellung wird durch die
1870     Konstante <code>DEFAULT_LIMIT_REQUEST_FIELDS</code> (<code>100</code>
1871     bei der Auslieferung) zur Kompilierungszeit gesetzt.</p>
1872
1873     <p>Die Direktive <directive>LimitRequestFields</directive> erlaubt es
1874     dem Serveradministrator, die maximale Anzahl der in einem HTTP-Request
1875     erlaubten HTTP-Request-Header zu ver&auml;ndern. F&uuml;r den Server
1876     muss dieser Wert gr&ouml;&szlig;er sein als die Anzahl der Headerzeilen,
1877     die ein normaler Client senden k&ouml;nnte. Die Anzahl der Request-Header,
1878     die ein gew&ouml;hnlicher Client verwendet, &uuml;berschreitet selten 20
1879     Zeilen. Allerdings kann dies zwischen den verschiedenen
1880     Client-Ausf&uuml;hrungen variieren, oft abh&auml;ngig vom Ausma&szlig;,
1881     mit dem der Anwender die genaue Content-Negotiation-Unterst&uuml;tzung
1882     seines Browsers konfiguriert hat. Optionale HTTP-Erweiterungen
1883     &auml;u&szlig;ern sich oft in Form von HTTP-Headern.</p>
1884
1885     <p>Die Direktive gibt dem Serveradministrator eine gr&ouml;&szlig;ere
1886     Kontrolle gegen&uuml;ber abnormalem Verhalten von Clients, was bei der
1887     Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1888     sein kann. Der Wert sollte erh&ouml;ht werden, wenn normale Clients
1889     eine Fehlermeldung vom Server erhalten, die besagt, dass mit der Anfrage
1890     zu viele Headerzeilen gesendet wurden.</p>
1891
1892     <p>Beispiel:</p>
1893
1894     <example>
1895       LimitRequestFields 50
1896     </example>
1897
1898 </usage>
1899 </directivesynopsis>
1900
1901 <directivesynopsis>
1902 <name>LimitRequestFieldSize</name>
1903 <description>Begrenzt die L&auml;nge des vom Client gesendeten
1904 HTTP-Request-Headers</description>
1905 <syntax>LimitRequestFieldsize <var>Bytes</var></syntax>
1906 <default>LimitRequestFieldsize 8190</default>
1907 <contextlist><context>server config</context></contextlist>
1908
1909 <usage>
1910   <p>Die Direktive gibt die Anzahl der <var>Bytes</var> an, die in einem
1911     HTTP-Header erlaubt sind.</p>
1912
1913     <p>Die Direktive <directive>LimitRequestFieldsize</directive> erlaubt es
1914     dem Serveradministrator, die maximale Gr&ouml;&szlig;e eines
1915     HTTP-Request-Headers zu verringern oder erh&ouml;hen. F&uuml;r den Server
1916     muss der Wert gro&szlig; genug sein, um eine beliebige Headerzeile einer
1917     normalen Client-Anfrage vorzuhalten. Die Gr&ouml;&szlig;e variiert stark
1918     zwischen den verschiedenen Client-Ausf&uuml;hrungen, oft abh&auml;ngig vom
1919     Ausma&szlig;, mit dem der Anwender die genaue
1920     Content-Negotiation-Unterst&uuml;tzung seines Browsers konfiguriert hat.
1921     SPNEGO-Authentisierungs-Header k&ouml;nnen bis zu 12392 Bytes lang
1922     sein.</p>
1923
1924     <p>Die Direktive gibt dem Serveradministrator eine gr&ouml;&szlig;ere
1925     Kontrolle gegen&uuml;ber abnormalem Verhalten von Clients, was bei der
1926     Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1927     sein kann.</p>
1928
1929     <p>Beispiel:</p>
1930
1931     <example>
1932       LimitRequestFieldSize 4094
1933     </example>
1934
1935     <note>Unter normalen Umst&auml;nden sollte die Voreinstellung nicht
1936     ver&auml;ndert werden.</note>
1937 </usage>
1938 </directivesynopsis>
1939
1940 <directivesynopsis>
1941 <name>LimitRequestLine</name>
1942 <description>Begrenzt die L&auml;nge der vom Client entgegengenommenen
1943 HTTP-Anfragezeile</description>
1944 <syntax>LimitRequestLine <var>Bytes</var></syntax>
1945 <default>LimitRequestLine 8190</default>
1946 <contextlist><context>server config</context></contextlist>
1947
1948 <usage>
1949   <p>Die Direktive legt die Anzahl der <var>Bytes</var> fest, die in der
1950     HTTP-Anfragezeile erlaubt sind.</p>
1951
1952     <p>Die Direktive <directive>LimitRequestLine</directive> erlaubt es dem
1953     Serveradministrator, die maximale Gr&ouml;&szlig;e der
1954     HTTP-Anfragezeile zu verringern oder erh&ouml;hen. Da
1955     die Anfragezeile aus der HTTP-Methode, der URI und der Protokollversion
1956     besteht, bedeutet die <directive>LimitRequestLine</directive>-Direktive
1957     eine Beschr&auml;nkung der L&auml;nge der f&uuml;r eine Anfrage an den
1958     Server erlaubten Anfrage-URI. F&uuml;r den Server muss der Wert gro&szlig;
1959     genug sein, um jeden seiner Ressourcennamen vorzuhalten,
1960     einschlie&szlig;lich aller Informationen, die im Query-String einer
1961     <code>GET</code>-Anfrage &uuml;bergeben werden k&ouml;nnen.</p>
1962
1963     <p>Die Direktive gibt dem Serveradministrator eine gr&ouml;&szlig;ere
1964     Kontrolle gegen&uuml;ber abnormalem Verhalten von Clients, was bei der
1965     Vermeidung einiger Formen von Denial-of-Service-Attacken hilfreich
1966     sein kann.</p>
1967
1968     <p>Beispiel:</p>
1969
1970     <example>
1971       LimitRequestLine 4094
1972     </example>
1973
1974     <note>Unter normalen Umst&auml;nden sollte die Voreinstellung nicht
1975     ver&auml;ndert werden.</note>
1976 </usage>
1977 </directivesynopsis>
1978
1979 <directivesynopsis>
1980 <name>LimitXMLRequestBody</name>
1981 <description>Begrenzt die Gr&ouml;&szlig;e eines XML-basierten
1982 Request-Bodys</description>
1983 <syntax>LimitXMLRequestBody <var>Bytes</var></syntax>
1984 <default>LimitXMLRequestBody 1000000</default>
1985 <contextlist><context>server config</context><context>virtual host</context>
1986 <context>directory</context><context>.htaccess</context></contextlist>
1987 <override>All</override>
1988
1989 <usage>
1990     <p>Dies gibt die Grenze f&uuml;r die maximale Gr&ouml;&szlig;e (in Bytes)
1991     des XML-basierten Request-Bodys an. Der Wert <code>0</code> deaktiviert
1992     diese Pr&uuml;fung.</p>
1993
1994     <p>Beispiel:</p>
1995
1996     <example>
1997       LimitXMLRequestBody 0
1998     </example>
1999
2000 </usage>
2001 </directivesynopsis>
2002
2003 <directivesynopsis type="section">
2004 <name>Location</name>
2005 <description>Wendet die enthaltenen Direktiven nur auf die entsprechenden
2006 URLs an</description>
2007 <syntax>&lt;Location
2008     <var>URL-Pfad</var>|<var>URL</var>&gt; ... &lt;/Location&gt;</syntax>
2009 <contextlist><context>server config</context><context>virtual host</context>
2010 </contextlist>
2011
2012 <usage>
2013     <p>Die Direktive <directive type="section">Location</directive>
2014     begrenzt die Reichweite der enthaltenen Anweisungen auf URLs.
2015     Sie ist der Direktive <directive type="section"
2016     module="core">Directory</directive> &auml;hnlich und startet einen
2017     Abschnitt, der mit der Anweisung <code>&lt;/Location&gt;</code>
2018     abgeschlossen wird. <directive
2019     type="section">Location</directive>-Container werden, nachdem die
2020     <directive type="section" module="core">Directory</directive>-Container
2021     und <code>.htaccess</code>-Dateien gelesen wurden, und nach den
2022     <directive type="section" module="core">Files</directive>-Containern, in
2023     der Reihenfolge ausgef&uuml;hrt, in der sie in der Konfigurationsdatei
2024     erscheinen.</p>
2025
2026     <p><directive type="section">Location</directive>-Abschnitte operieren
2027       vollst&auml;ndig au&szlig;erhalb des Dateisystems. Dies hat mehrere
2028       Konsequenzen. An Wichtigsten, <directive
2029       type="section">Location</directive>-Anweisungen sollten nicht daf&uuml;r
2030       verwendet werden, den Zugriff zu Teilen des Dateisystems zu steuern. Da
2031       mehrere unterschiedliche URLs auf die gleiche Stelle des Dateisystems
2032       zeigen k&ouml;nnen, k&ouml;nnte eine solche Zugriffskontrolle u.U.
2033       umgangen werden.</p>
2034       
2035     <note><title>Wann sollte<directive
2036       type="section">Location</directive> verwendet werden</title>
2037
2038       <p>Verwenden Sie <directive type="section">Location</directive>, um
2039         Anweisungen auf Inhalte anzuwenden, die au&szlig;erhalb des Dateisystems
2040         abgelegt sind. Benutzen Sie <directive
2041         type="section" module="core">Directory</directive> und <directive
2042         type="section" module="core">Files</directive> f&uuml;r Inhalte, die
2043         innerhalb des Dateisystems abgelegt sind. Eine Ausnahme bildet 
2044         <code>&lt;Location /&gt;</code>, welches ein einfacher Weg ist, um eine 
2045         Konfiguration auf den gesamten Server anzuwenden.</p>
2046     </note>
2047  
2048     <p>F&uuml;r alle nicht-Proxy-Anfragen ist die entsprechende URL
2049     ein URL-Pfad in der Form <code>/path/</code>. Es d&uuml;rfen weder ein
2050     Schema, noch ein Hostname, noch ein Port, noch ein Query-String einbezogen
2051     werden. F&uuml;r Proxy-Anfragen hat die Vergleichs-URL die Form
2052     <code>schema://servername/path</code>. Das Pr&auml;fix muss angegeben
2053     werden.</p>
2054
2055     <p>Die URL kann Platzhalter verwenden. In einer Zeichenfolge mit
2056     Platzhaltern entspricht <code>?</code> einem einzelnen Zeichen und
2057     <code>*</code>einer beliebigen Zeichenfolge.</p>
2058
2059     <p>Erweiterte <glossary ref="regex">regul&auml;re
2060     Ausdr&uuml;cke</glossary> k&ouml;nnen ebenfalls verwendet werden, indem
2061     das Zeichen <code>~</code> hinzugef&uuml;gt wird. Beispielsweise
2062     w&uuml;rde</p>
2063
2064     <example>
2065       &lt;Location ~ "/(extra|special)/data"&gt;
2066     </example>
2067
2068     <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
2069     oder <code>/special/data</code> enthalten. Die Direktive <directive
2070     type="section" module="core">LocationMatch</directive> verh&auml;lt sich
2071     genauso wie <directive type="section">Location</directive> mit
2072     regul&auml;ren Ausdr&uuml;cken.</p>
2073
2074     <p>Die Funktionalit&auml;t von <directive
2075     type="section">Location</directive> ist insbesondere dann n&uuml;tzlich,
2076     wenn sie mit der <directive module="core">SetHandler</directive>-Direktive
2077     kombiniert wird. Um zum Beispiel Statusabfragen zu aktivieren, sie aber
2078     nur von Browsern aus <code>foo.com</code> zuzulassen, k&ouml;nnten Sie
2079     schreiben:</p>
2080
2081     <example>
2082       &lt;Location /status&gt;<br />
2083       <indent>
2084         SetHandler server-status<br />
2085         Order Deny,Allow<br />
2086         Deny from all<br />
2087         Allow from .foo.com<br />
2088       </indent>
2089       &lt;/Location&gt;
2090     </example>
2091
2092     <note><title>Anmerkung zu / (Schr&auml;gstrich, Slash)</title>
2093       <p>Das Slash-Zeichen hat eine besondere Bedeutung, je nachdem, wo es
2094       in der URL erscheint. Manche werden sein Verhalten vom Dateisystem
2095       gewohnt sein, wo mehrere aufeinanderfolgende Schr&auml;gstriche
2096       h&auml;ufig zu einem Schr&auml;gstrich zusammengefa&szlig;t werden
2097       (<em>d.h.</em> <code>/home///foo</code> ist das gleiche wie
2098       <code>/home/foo</code>). Im URL-Raum ist dies nicht notwendigerweise
2099       genauso. Bei der Direktive  <directive type="section"
2100       module="core">LocationMatch</directive> und der <directive type="section"
2101       >Location</directive>-Version mit regul&auml;ren Ausdr&uuml;cken
2102       m&uuml;ssen Sie explizit mehrere Schr&auml;gstriche angeben, wenn Sie
2103       genau dies beabsichtigen.</p>
2104
2105       <p>Beispielsweise w&uuml;rde <code>&lt;LocationMatch ^/abc&gt;</code>
2106       auf die angeforderte URL <code>/abc</code> passen, nicht aber auf
2107       <code>//abc</code>. Die Direktive <directive type="section"
2108       >Location</directive> (ohne regul&auml;re Ausdr&uuml;cke) verh&auml;lt
2109       sich &auml;hnlich, wenn sie f&uuml;r Proxy-Anfragen verwendet wird.
2110       Wenn <directive type="section">Location</directive> (ohne
2111       regul&auml;re Ausdr&uuml;cke) jedoch f&uuml;r nicht-Proxy-Anfragen
2112       verwendet wird, werden stillscheigend mehrere Schr&auml;chstriche mit
2113       mit einem einzigen Schr&auml;gstrich gleichgesetzt. Geben Sie
2114       beispielsweise <code>&lt;Location /abc/def&gt;</code> an und die
2115       Anfrage lautet auf <code>/abc//def</code>, dann greift die Anweisung.</p>
2116     </note>
2117 </usage>
2118 <seealso><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
2119     &lt;Location&gt; und &lt;Files&gt; arbeiten</a> f&uuml;r eine
2120     Erl&auml;uterung, wie diese verschiedenen Abschnitte miteinander
2121     kombiniert werden, wenn eine Anfrage empfangen wird</seealso>
2122 </directivesynopsis>
2123
2124 <directivesynopsis type="section">
2125 <name>LocationMatch</name>
2126 <description>Wendet die enthaltenen Direktiven nur auf URLs an, die auf
2127 regul&auml;re Ausdr&uuml;cke passen</description>
2128 <syntax>&lt;LocationMatch
2129     <var>regex</var>&gt; ... &lt;/LocationMatch&gt;</syntax>
2130 <contextlist><context>server config</context><context>virtual host</context>
2131 </contextlist>
2132
2133 <usage>
2134     <p>Die Direktive <directive type="section">LocationMatch</directive>
2135     begrenzt die Reichweite der enthaltenen Anweisungen in der gleichen Weise
2136     wie <directive module="core" type="section">Location</directive> auf URLs.
2137     Sie verwendet jedoch <glossary ref="regex">regul&auml;re
2138     Ausdr&uuml;cke</glossary> als Argument anstelle einer einfachen
2139     Zeichenkette. Beispielsweise w&uuml;rde</p>
2140
2141     <example>
2142       &lt;LocationMatch "/(extra|special)/data"&gt;
2143     </example>
2144
2145     <p>auf URLs passen, welche die Zeichenfolge <code>/extra/data</code>
2146     oder <code>/special/data</code> enthalten.</p>
2147 </usage>
2148
2149 <seealso><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
2150     &lt;Location&gt; und &lt;Files&gt; arbeiten</a> f&uuml;r eine
2151     Erl&auml;uterung, wie diese verschiedenen Abschnitte miteinander
2152     kombiniert werden, wenn eine Anfrage empfangen wird</seealso>
2153 </directivesynopsis>
2154
2155 <directivesynopsis>
2156 <name>LogLevel</name>
2157 <description>Steuert die Ausf&uuml;hrlichkeit des Fehlerprotokolls</description>
2158 <syntax>LogLevel <var>Level</var></syntax>
2159 <default>LogLevel warn</default>
2160 <contextlist><context>server config</context><context>virtual host</context>
2161 </contextlist>
2162
2163 <usage>
2164     <p><directive>LogLevel</directive> stellt die Ausf&uuml;hrlichkeit
2165     der Nachrichten ein, die im Fehlerprotokoll aufgezeichnet werden (siehe
2166     Direktive <directive module="core">ErrorLog</directive>). Die folgenden,
2167     nach absteigender Aussagekraft sortierten <var>Level</var> sind
2168     verf&uuml;gbar:</p>
2169
2170     <table border="1">
2171     <columnspec><column width=".2"/><column width=".3"/><column width=".5"/>
2172     </columnspec>
2173       <tr>
2174         <th><strong>Level</strong> </th>
2175
2176         <th><strong>Beschreibung</strong> </th>
2177
2178         <th><strong>Beispiel</strong> </th>
2179       </tr>
2180
2181       <tr>
2182         <td><code>emerg</code> </td>
2183
2184         <td>Notfall - das System ist unbenutzbar.</td>
2185
2186         <td>"Child cannot open lock file. Exiting"
2187         <transnote>"Kindprozess kann die Lock-Datei nicht &ouml;ffnen.
2188         Beende Programm"</transnote></td>
2189       </tr>
2190
2191       <tr>
2192         <td><code>alert</code> </td>
2193
2194         <td>Ma&szlig;nahmen m&uuml;ssen unverz&uuml;glich ergriffen
2195         werden.</td>
2196
2197         <td>"getpwuid: couldn't determine user name from uid"
2198         <transnote>"getpwuid: kann keinen Benutzernamen aus der UID
2199         ermitteln"</transnote></td>
2200       </tr>
2201
2202       <tr>
2203         <td><code>crit</code> </td>
2204
2205         <td>Kritischer Zustand.</td>
2206
2207         <td>"socket: Failed to get a socket, exiting child"
2208         <transnote>"socket: Socket-Zuweisung fehlgeschlagen, beende
2209         Kindprozess"</transnote></td>
2210       </tr>
2211
2212       <tr>
2213         <td><code>error</code> </td>
2214
2215         <td>Fehlerbedingung.</td>
2216
2217         <td>"Premature end of script headers"
2218         <transnote>"Vorzeitiges Ende der Skript-Header"</transnote></td>
2219       </tr>
2220
2221       <tr>
2222         <td><code>warn</code> </td>
2223
2224         <td>Warnung.</td>
2225
2226         <td>"child process 1234 did not exit, sending another SIGHUP"
2227         <transnote>"Kindprozess 1234 nicht beendet, sende ein weiteres
2228         SIGHUP"</transnote></td>
2229       </tr>
2230
2231       <tr>
2232         <td><code>notice</code> </td>
2233
2234         <td>Normaler, aber signifikanter Zustand.</td>
2235
2236         <td>"httpd: caught SIGBUS, attempting to dump core in ..."
2237         <transnote>"httpd: SIGBUS empfangen, versuche Speicherabbild nach ...
2238         zu schreiben"</transnote></td>
2239       </tr>
2240
2241       <tr>
2242         <td><code>info</code> </td>
2243
2244         <td>Information.</td>
2245
2246         <td>"Server seems busy, (you may need to increase
2247         StartServers, or Min/MaxSpareServers)..."
2248         <transnote>"Server scheint besch&auml;ftigt zu sein,
2249         (m&ouml;glicherweise m&uuml;ssen Sie StartServers oder
2250         Min/MaxSpareServers erh&ouml;hen)"</transnote></td>
2251       </tr>
2252
2253       <tr>
2254         <td><code>debug</code> </td>
2255
2256         <td>Debug-Level-Nachrichten</td>
2257
2258         <td>"Opening config file ..."
2259         <transnote>"&Ouml;ffne Konfigurationsdatei ..."</transnote></td>
2260       </tr>
2261     </table>
2262
2263     <p>Geben Sie einen bestimmten Level an, denn werden Nachrichten von
2264     allen h&ouml;heren Leveln ebenso angezeigt. <em>Z.B.:</em> Wenn
2265     <code>LogLevel info</code> eingestellt ist, dann werden Nachrichten der
2266     Log-Level <code>notice</code> und <code>warn</code> ebenso eingetragen.</p>
2267
2268     <p>Es wird empfohlen, mindestens den Level <code>crit</code> zu
2269     verwenden.</p>
2270
2271     <p>Beispiel:</p>
2272
2273     <example>
2274       LogLevel notice
2275     </example>
2276
2277     <note><title>Hinweis</title>
2278       <p>Beim Protokollieren in eine regul&auml;re Datei k&ouml;nnen
2279       Nachrichten des Levels <code>notice</code> nicht unterdr&uuml;ckt
2280       werden und werden daher immer protokolliert. Dies trifft allerdings
2281       nicht zu, wenn mittels <code>syslog</code> protokolliert wird.</p>
2282     </note>
2283 </usage>
2284 </directivesynopsis>
2285
2286 <directivesynopsis>
2287 <name>MaxKeepAliveRequests</name>
2288 <description>Anzahl der Anfragen, die bei einer persistenten Verbindung
2289 zul&auml;ssig sind</description>
2290 <syntax>MaxKeepAliveRequests <var>Anzahl</var></syntax>
2291 <default>MaxKeepAliveRequests 100</default>
2292 <contextlist><context>server config</context><context>virtual host</context>
2293 </contextlist>
2294
2295 <usage>
2296     <p>Die Direktive <directive>MaxKeepAliveRequests</directive>
2297     begrenzt die Anzahl der Anfragen, die pro Verbindung zul&auml;ssig sind,
2298     wenn <directive module="core" >KeepAlive</directive> eingeschaltet ist.
2299     Bei der Einstellung <code>0</code> sind unbegrenzt viele Anfragen
2300     erlaubt. Wir empfehlen f&uuml;r diese Einstellung einen hohen Wert
2301     f&uuml;r eine maximale Serverleistung.</p>
2302
2303     <p>Beispiel:</p>
2304
2305     <example>
2306       MaxKeepAliveRequests 500
2307     </example>
2308 </usage>
2309 </directivesynopsis>
2310
2311 <directivesynopsis>
2312 <name>NameVirtualHost</name>
2313 <description>Bestimmt eine IP-Adresse f&uuml;r den Betrieb namensbasierter
2314 virtueller Hosts</description>
2315 <syntax>NameVirtualHost <var>Adresse</var>[:<var>Port</var>]</syntax>
2316 <contextlist><context>server config</context></contextlist>
2317
2318 <usage>
2319     <p>Die Direktive <directive>NameVirtualHost</directive> ist erforderlich,
2320     wenn Sie <a href="../vhosts/">namensbasierte virtuelle Hosts</a>
2321     konfigurieren m&ouml;chten.</p>
2322
2323     <p>Obwohl <var>Adresse</var> eine Hostname sein kann, wird empfohlen,
2324     dass Sie stets eine IP-Adresse verwenden, z.B.:</p>
2325
2326     <example>
2327       NameVirtualHost 111.22.33.44
2328     </example>
2329
2330     <p>Mit der <directive>NameVirtualHost</directive>-Anweisung geben Sie
2331     die IP-Adresse an, unter der der Server Anfragen f&uuml;r
2332     namensbasierte virtuelle Hosts entgegennimmt. Das ist &uuml;blicherweise
2333     die Adresse, zu der die Namen Ihrer namensbasierten virtuellen Hosts
2334     aufgel&ouml;st werden. Falls eine Firewall oder ein anderer Proxy die
2335     Anfrage in Empfang nimmt und Sie zu einer weiteren IP-Adresse des Servers
2336     weiterleitet, m&uuml;ssen Sie die IP-Adresse der physikalischen
2337     Schnittstelle der Maschine angeben, welche die Anfragen bedient.
2338     Wenn Sie mehrere namensbasierte Hosts an verschiedenen Adressen
2339     betreiben, wiederholen Sie einfach die Anweisung f&uuml;r jede
2340     Adresse.</p>
2341
2342     <note><title>Anmerkung</title>
2343       <p>Beachten Sie, dass der "Hauptserver" und jeder
2344       <code>_default_</code>-Server <strong>niemals</strong> bei einer
2345       Anfrage an einer <directive>NameVirtualHost</directive>-IP-Adresse
2346       bedient wird (es sei denn, Sie geben aus irgendwelchen Gr&uuml;nden
2347       <directive>NameVirtualHost</directive> an, definieren dann aber keine
2348       <directive>VirtualHost</directive>s f&uuml;r diese Adresse).</p>
2349     </note>
2350
2351     <p>Optional k&ouml;nnen Sie die Nummer eines Ports angeben, an dem
2352     namensbasierte virtuelle Hosts verwendet werden sollen. Beispiel:</p>
2353
2354     <example>
2355       NameVirtualHost 111.22.33.44:8080
2356     </example>
2357
2358     <p>IPv6-Adressen m&uuml;ssen, wie im folgenden Beispiel angegeben, in
2359     eckige Klammern eingeschlossen werden:</p>
2360
2361     <example>
2362       NameVirtualHost [2001:db8::a00:20ff:fea7:ccea]:8080
2363     </example>
2364
2365     <p>Um an allen Schnittstellen Anfragen zu empfangen, k&ouml;nnen Sie
2366     <code>*</code> als Argument verwenden.</p>
2367
2368     <example>
2369       NameVirtualHost *
2370     </example>
2371
2372     <note><title>Argument der Direktive <directive
2373     type="section">VirtualHost</directive></title>
2374       <p>Beachten Sie, dass das Argument der <directive
2375       type="section">VirtualHost</directive>-Anweisung exakt auf das Argument
2376       der <directive>NameVirtualHost</directive>-Anweisung passen muss.</p>
2377
2378       <example>
2379         NameVirtualHost 1.2.3.4<br />
2380         &lt;VirtualHost 1.2.3.4&gt;<br />
2381         # ...<br />
2382         &lt;/VirtualHost&gt;<br />
2383       </example>
2384     </note>
2385 </usage>
2386 <seealso><a href="../vhosts/">Dokumentation zu virtuellen Hosts</a></seealso>
2387 </directivesynopsis>
2388
2389 <directivesynopsis>
2390 <name>Options</name>
2391 <description>Definiert, welche Eigenschaften oder Funktionen in einem
2392 bestimmten Verzeichnis verf&uuml;gbar sind</description>
2393 <syntax>Options
2394     [+|-]<var>Option</var> [[+|-]<var>Option</var>] ...</syntax>
2395 <default>Options All</default>
2396 <contextlist><context>server config</context><context>virtual host</context>
2397 <context>directory</context><context>.htaccess</context>
2398 </contextlist>
2399 <override>Options</override>
2400
2401 <usage>
2402     <p>Die Direktive <directive>Options</directive> steuert, welche
2403     Eigenschaften bzw. Funktionen in einem bestimmten Verzeichnis
2404     verf&uuml;gbar sind.</p>
2405
2406     <p><var>Option</var> kann auf <code>None</code> gesetzt werden, wobei
2407     keine der besonderen Eigenschaften verf&uuml;gbar sind, oder auf eines
2408     oder mehrere der folgenden:</p>
2409
2410     <dl>
2411       <dt><code>All</code></dt>
2412
2413       <dd>Alle Optionen au&szlig;er <code>MultiViews</code>. Dies ist
2414       die Voreinstellung.</dd>
2415
2416       <dt><code>ExecCGI</code></dt>
2417
2418       <dd>Die Ausf&uuml;hrung von CGI-Skripten, welche <module>mod_cgi</module>
2419         verwenden, ist erlaubt.</dd>
2420
2421       <dt><code>FollowSymLinks</code></dt>
2422
2423       <dd>Der Server folgt symbolischen Links in diesem Verzeichnis.
2424       <note>
2425       <p>Auch wenn der Server symbolischen Links folgt, bedeutet dies
2426       <em>nicht</em>, dass der zum Abgleich gegen <directive type="section"
2427       module="core">Directory</directive>-Abschnitte verwendete Pfadname
2428       wechselt.</p>
2429       <p>Beachten Sie auch, dass diese Option innerhalb eines
2430       <directive type="section" module="core">Location</directive>-Abschnitts
2431       <strong>ignoriert wird</strong>.</p>
2432       </note></dd>
2433
2434       <dt><code>Includes</code></dt>
2435
2436       <dd>
2437       Server Side Includes, die von <module>mod_include</module> bereitgestellt
2438       werden, sind erlaubt.</dd>
2439
2440       <dt><code>IncludesNOEXEC</code></dt>
2441
2442       <dd>Server Side Includes sind erlaubt, <code>#exec cmd</code>
2443       und <code>#exec cgi</code> sind jedoch deaktiviert. Es ist aber noch
2444       m&ouml;glich, CGI-Skripte aus
2445       <directive module="mod_alias">ScriptAlias</directive>-Verzeichnissen mittels
2446       <code>#include virtual</code> einzubinden.</dd>
2447
2448       <dt><code>Indexes</code></dt>
2449
2450       <dd>Wenn eine URL, die auf ein Verzeichnis zeigt, in dem sich keine durch
2451         <directive module="mod_dir">DirectoryIndex</directive> definierte 
2452         Indexdatei (<em>z.B.</em> <code>index.html</code>) befindet, dann liefert 
2453         <module>mod_autoindex</module> eine formatierte Auflistung des 
2454         Verzeichnisses zur&uuml;ck.</dd>
2455
2456       <dt><code>MultiViews</code></dt>
2457
2458       <dd>"MultiViews" sind bei der Verwendung von 
2459         <module>mod_negotiation</module> erlaubt (siehe <a 
2460         href="../content-negotiation.html">Content-Negotiation</a>).</dd>
2461
2462       <dt><code>SymLinksIfOwnerMatch</code></dt>
2463
2464       <dd>Der Server folgt nur symbolischen Links, bei denen die Zieldatei
2465       bzw. das Zielverzeichnis der gleichen Benutzerkennung geh&ouml;rt, wie
2466       der Link.
2467       <note><title>Anmerkung</title> Diese Option wird innerhalb eines
2468       <directive module="core" type="section">Location</directive>-Abschnitts
2469       ignoriert.</note></dd>
2470     </dl>
2471
2472     <p>Wenn mehrere <directive>Options</directive> auf ein Verzeichnis
2473     angewandt werden k&ouml;nnen, dann wird normalerweise die
2474     spezifischste <transnote>Gemeint ist die zuletzt
2475     ausgef&uuml;hrte Option.</transnote> verwendet und alle anderen werden
2476     ignoriert; die Optionen werden nicht vermischt. (Siehe auch <a
2477     href="../sections.html#mergin">Wie Abschnitte zusammengef&uuml;hrt 
2478     werden.</a>.) Wenn jedoch <em>allen</em> Optionen der 
2479     <directive>Options</directive>-Anweisung eines der Zeichen
2480     <code>+</code> oder <code>-</code> vorangestellt wird, werden die Optionen
2481     zusammengemischt. Jede Option mit vorangestelltem <code>+</code> wird
2482     zu den momentan g&uuml;ltigen Optionen hinzugef&uuml;gt und jede Option
2483     mit vorangestelltem <code>-</code> wird aus den derzeit g&uuml;ltigen
2484     Optionen entfernt.</p>
2485
2486     <note type="warning"><title>Warnung</title>
2487     <p>Die Vermischung von Optionen mit <code>+</code> oder <code>-</code> mit
2488     Optionen ohne diese (Zeichen) ist keine g&uuml;ltige Syntax und f&uuml;hrt
2489     mit hoher Wahrscheinlichkeit zu unerwarteten Effekten.</p>
2490     </note>
2491
2492     <p>So wird zum Beispiel ohne die Zeichen <code>+</code> und
2493     <code>-</code></p>
2494
2495     <example>
2496       &lt;Directory /web/docs&gt;<br />
2497       <indent>
2498         Options Indexes FollowSymLinks<br />
2499       </indent>
2500       &lt;/Directory&gt;<br />
2501       <br />
2502       &lt;Directory /web/docs/spec&gt;<br />
2503       <indent>
2504         Options Includes<br />
2505       </indent>
2506       &lt;/Directory&gt;
2507     </example>
2508
2509     <p>f&uuml;r das Verzeichnis <code>/web/docs/spec</code> wird jetzt
2510     lediglich <code>Includes</code> gesetzt. Wenn die zweite
2511     <directive>Options</directive>-Anweisung jedoch <code>+</code>-
2512     und <code>-</code>-Zeichen verwenden w&uuml;rde,</p>
2513
2514     <example>
2515       &lt;Directory /web/docs&gt;<br />
2516       <indent>
2517         Options Indexes FollowSymLinks<br />
2518       </indent>
2519       &lt;/Directory&gt;<br />
2520       <br />
2521       &lt;Directory /web/docs/spec&gt;<br />
2522       <indent>
2523         Options +Includes -Indexes<br />
2524       </indent>
2525       &lt;/Directory&gt;
2526     </example>
2527
2528     <p>dann w&uuml;rden die Optionen <code>FollowSymLinks</code> und
2529     <code>Includes</code> f&uuml;r das Verzeichnis <code>/web/docs/spec</code>
2530     gesetzt.</p>
2531
2532     <note><title>Anmerkung</title>
2533       <p>Die Verwendung von <code>-IncludesNOEXEC</code> oder
2534       <code>-Includes</code> deaktiviert Server Side Includes unabh&auml;ngig
2535       von der vorigen Einstellung vollst&auml;ndig.</p>
2536     </note>
2537
2538     <p>Die Voreinstellung ist <code>All</code>, sofern keine anderen Angaben
2539     gemacht wurden.</p>
2540 </usage>
2541 </directivesynopsis>
2542
2543 <directivesynopsis>
2544 <name>Require</name>
2545 <description>W&auml;hlt die authentisierten Benutzer aus, die auf eine
2546 Ressource zugreifen k&ouml;nnen</description>
2547 <syntax>Require <var>Name</var> [<var>Name</var>] ...</syntax>
2548 <contextlist><context>directory</context><context>.htaccess</context>
2549 </contextlist>
2550 <override>AuthConfig</override>
2551
2552 <usage>
2553     <p>Die Direktive w&auml;hlt aus, welche authentisierten Benutzer auf eine
2554     Ressource zugreifen d&uuml;rfen. Folgende Syntax ist erlaubt:</p>
2555
2556     <dl>
2557       <dt><code>Require user <var>User-ID</var> [<var>User-ID</var>]
2558       ...</code></dt>
2559       <dd>Nur die genannten Benutzer d&uuml;rfen auf die Ressource
2560       zugreifen.</dd>
2561
2562       <dt><code>Require group <var>Gruppenname</var> [<var>Gruppenname</var>]
2563       ...</code></dt>
2564       <dd>Nur Benutzer der genannten Gruppen d&uuml;rfen auf die
2565       Ressource zugreifen.</dd>
2566
2567       <dt><code>Require valid-user</code></dt>
2568       <dd>Alle g&uuml;ltigen Benutzer d&uuml;rfen auf die Ressource
2569       zugreifen.</dd>
2570     </dl>
2571
2572     <p><directive>Require</directive> muss von den Direktiven
2573     <directive module="mod_authn_core">AuthName</directive> und <directive
2574     module="mod_authn_core">AuthType</directive> sowie Direktiven wie
2575     <directive module="mod_authn_file">AuthUserFile</directive>
2576     und <directive module="mod_authz_groupfile">AuthGroupFile</directive>
2577     (zur Definition von Benutzern und Gruppen) begleitet werden, um
2578     korrekt zu funktionieren. Beispiel:</p>
2579
2580     <example>
2581        AuthType Basic<br />
2582        AuthName "Gesch&uuml;tzte Ressource"<br />
2583        AuthUserFile /web/users<br />
2584        AuthGroupFile /web/groups<br />
2585        Require group admin
2586     </example>
2587
2588     <p>Zugriffskontrollen, die in dieser Form angewandt werden, gelten
2589     f&uuml;r <strong>alle</strong> Methoden. <strong>Dies ist normalerweise
2590     gew&uuml;nscht.</strong> Wenn Sie Zugriffskontrollen nur auf bestimmte
2591     Methoden anwenden m&ouml;chten, w&auml;hrend andere Methoden
2592     ungesch&uuml;tzt bleiben, dann m&uuml;ssen Sie die
2593     <directive>Require</directive>-Anweisung innerhalb eines
2594     <directive module="core" type="section">Limit</directive>-Abschnitts
2595     platzieren.</p>
2596 </usage>
2597 <seealso><directive module="mod_access_compat">Satisfy</directive></seealso>
2598 <seealso><module>mod_authz_host</module></seealso>
2599 </directivesynopsis>
2600
2601 <directivesynopsis>
2602 <name>RLimitCPU</name>
2603 <description>Begrenzt den CPU-Verbrauch von Prozessen, die von
2604 Apache-Kindprozessen gestartet wurden</description>
2605 <syntax>RLimitCPU <var>Sekunden</var>|max [<var>Sekunden</var>|max]</syntax>
2606 <default>unbestimmt; verwendet die Voreinstellung des Systems</default>
2607 <contextlist><context>server config</context><context>virtual host</context>
2608 <context>directory</context><context>.htaccess</context></contextlist>
2609 <override>All</override>
2610
2611 <usage>
2612     <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2613     weiche Ressourcenbegrenzung f&uuml;r alle Prozesse, der zweite Parameter
2614     setzt die Maximalgrenze f&uuml;r die Ressourcennutzung. Jeder der
2615     Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2616     zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2617     verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2618     erfordert, dass der Server als <code>root</code> l&auml;uft, zumindest in
2619     der anf&auml;nglichen Startphase.</p>
2620
2621     <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2622     Apache-Kindprozessen abgespalten werden, nicht auf die
2623     Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2624     SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2625     abgespalten werden, wie z.B. Protokollierung.</p>
2626
2627     <p>CPU-Ressourcenbegrenzung wird in Sekunden pro Prozess
2628     ausgedr&uuml;ckt.</p>
2629 </usage>
2630 <seealso><directive module="core">RLimitMEM</directive></seealso>
2631 <seealso><directive module="core">RLimitNPROC</directive></seealso>
2632 </directivesynopsis>
2633
2634 <directivesynopsis>
2635 <name>RLimitMEM</name>
2636 <description>Begrenzt den Speicherverbrauch von Prozessen, die von
2637 Apache-Kindprozessen gestartet wurden</description>
2638 <syntax>RLimitMEM <var>Bytes</var>|max [<var>Bytes</var>|max]</syntax>
2639 <default>unbestimmt; verwendet die Voreinstellung des Systems</default>
2640 <contextlist><context>server config</context><context>virtual host</context>
2641 <context>directory</context><context>.htaccess</context></contextlist>
2642 <override>All</override>
2643
2644 <usage>
2645     <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2646     weiche Ressourcenbegrenzung f&uuml;r alle Prozesse, der zweite Parameter
2647     setzt die Maximalgrenze f&uuml;r die Ressourcennutzung. Jeder der
2648     Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2649     zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2650     verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2651     erfordert, dass der Server als <code>root</code> l&auml;uft, zumindest in
2652     der anf&auml;nglichen Startphase.</p>
2653
2654     <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2655     Apache-Kindprozessen abgespalten werden, nicht auf die
2656     Apache-Kindprozesse selbst. Das beinhaltet CGI-Skripte und
2657     SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2658     abgespalten werden, wie z.B. Protokollierung.</p>
2659
2660     <p>Die Begrenzung des Speicherverbrauchs wird in Bytes pro Prozess
2661     ausgedr&uuml;ckt.</p>
2662 </usage>
2663 <seealso><directive module="core">RLimitCPU</directive></seealso>
2664 <seealso><directive module="core">RLimitNPROC</directive></seealso>
2665 </directivesynopsis>
2666
2667 <directivesynopsis>
2668 <name>RLimitNPROC</name>
2669 <description>Begrenzt die Anzahl der Prozesse, die von Prozessen gestartet
2670 werden k&ouml;nnen, der ihrerseits von Apache-Kinprozessen gestartet
2671 wurden</description>
2672 <syntax>RLimitNPROC <var>Zahl</var>|max [<var>Zahl</var>|max]</syntax>
2673 <default>unbestimmt; verwendet die Voreinstellung des Systems</default>
2674 <contextlist><context>server config</context><context>virtual host</context>
2675 <context>directory</context><context>.htaccess</context></contextlist>
2676 <override>All</override>
2677
2678 <usage>
2679     <p>Akzeptiert einen oder zwei Parameter. Der erste Paramater setzt eine
2680     weiche Ressourcenbegrenzung f&uuml;r alle Prozesse, der zweite Parameter
2681     setzt die Maximalgrenze f&uuml;r die Ressourcennutzung. Jeder der
2682     Parameter kann eine Zahl oder <code>max</code> sein. <code>max</code>
2683     zeigt dem Server an, dass das vom Betriebssystem erlaubte Maximum
2684     verwendet werden soll. Das Anheben der maximal erlaubten Ressourcennutzung
2685     erfordert, dass der Server als <code>root</code> l&auml;uft, zumindest in
2686     der anf&auml;nglichen Startphase.</p>
2687
2688     <p>Dies wird auf Prozesse angewendet, die von Anfragen bearbeitenden
2689     Apache-Kindprozessen abgespalten werden, nicht auf die
2690     Apache-Kindprozesse selbst. Dies beinhaltet CGI-Skripte und
2691     SSI-exec-Befehle, nicht jedoch Prozesse, die vom Apache-Elternprozess
2692     abgespalten werden, wie z.B. Protokollierung.</p>
2693
2694     <p>Prozessbegrenzungen steuern die Anzahl der Prozesse pro Benutzer.</p>
2695
2696     <note><title>Anmerkung</title>
2697       <p>Wenn CGI-Prozesse nicht unter anderen Benutzerkennungen als der
2698       User-ID des Webservers laufen, dann beschr&auml;nkt diese Direktive
2699       die Anzahl der Prozesse, die der Server selbst erstellen kann.
2700       Kennzeichen einer solchen Situation sind
2701       <strong><code>cannot fork</code></strong>-Meldungen
2702       <transnote><code>kann nicht abspalten</code></transnote> in der
2703       Datei <code>error_log</code>.</p>
2704     </note>
2705 </usage>
2706 <seealso><directive module="core">RLimitMEM</directive></seealso>
2707 <seealso><directive module="core">RLimitCPU</directive></seealso>
2708 </directivesynopsis>
2709
2710 <directivesynopsis>
2711 <name>Satisfy</name>
2712 <description>Zusammenspiel von rechnerbasierter Zugriffskontrolle und
2713 Benutzerauthentisierung</description>
2714 <syntax>Satisfy Any|All</syntax>
2715 <default>Satisfy All</default>
2716 <contextlist><context>directory</context><context>.htaccess</context>
2717 </contextlist>
2718 <override>AuthConfig</override>
2719 <compatibility>Wird seit Version 2.0.51 von <directive module="core"
2720     type="section">Limit</directive> und <directive module="core"
2721     type="section">LimitExcept</directive> beeinflusst</compatibility>
2722
2723 <usage>
2724     <p>Verfahrensweise f&uuml;r den Zugriff, falls sowohl <directive
2725     module="mod_access_compat">Allow</directive> als auch <directive
2726     module="mod_authz_core">Require</directive> verwendet werden. Der Parameter kann
2727     entweder <code>All</code> oder <code>Any</code> sein. Die Direktive ist
2728     nur dann n&uuml;tzlich, wenn der Zugriff zu einem bestimmten Bereich
2729     durch Benutzername/Passwort <em>und</em> Clientrechner-Adressen
2730     eingeschr&auml;nkt ist. In diesem Fall verlangt die Voreinstellung
2731     (<code>All</code>), dass der Client die Adressbeschr&auml;nkung passiert
2732     <em>und</em> eine g&uuml;ltige Benutzerkennung und ein g&uuml;ltiges
2733     Passwort &uuml;bermittelt. Mit der Auswahl <code>Any</code> wird dem
2734     Client der Zugriff erlaubt, wenn er entweder die Rechner-Besch&auml;nkung
2735     passiert oder einen g&uuml;ltigen Benutzernamen und ein g&uuml;ltiges
2736     Passwort &uuml;bermittelt. Dies kann verwendet werden, um einen Bereich
2737     mit einem Passwort zu sch&uuml;tzen, jedoch Clients von bestimmten
2738     Adressen ohne Abfrage des Passwortes zuzulassen.</p>
2739
2740     <p>Wenn Sie beispielsweise m&ouml;chten, dass Personen aus Ihrem
2741     privaten Netzwerk unbech&auml;nkten Zugriff zu Teilen Ihres
2742     Webangebots haben, jedoch verlangen, dass Personen au&szlig;erhalb
2743     Ihres privaten Netzwerks ein Passwort &uuml;bergeben m&uuml;ssen,
2744     k&ouml;nnen Sie eine Konfiguration &auml;hnlich der folgenden
2745     verwenden:</p>
2746
2747     <example>
2748       Require valid-user<br />
2749       Allow from 192.168.1<br />
2750       Satisfy Any
2751     </example>
2752
2753     <p>Seit Version 2.0.51 k&ouml;nnen
2754       <directive>Satisfy</directive>-Anweisungen durch <directive module="core"
2755         type="section">Limit</directive>- und <directive module="core"
2756         type="section">LimitExcept</directive>-Abschnitte auf bestimmte Methoden
2757       beschr&auml;nkt werden.</p>
2758 </usage>
2759    <seealso><directive module="mod_access_compat">Allow</directive></seealso>
2760    <seealso><directive module="mod_access_compat">Require</directive></seealso>
2761 </directivesynopsis>
2762
2763 <directivesynopsis>
2764 <name>ScriptInterpreterSource</name>
2765 <description>Methode zur Ermittlung des Interpreters von
2766 CGI-Skripten</description>
2767 <syntax>ScriptInterpreterSource Registry|Registry-Strict|Script</syntax>
2768 <default>ScriptInterpreterSource Script</default>
2769 <contextlist><context>server config</context><context>virtual host</context>
2770 <context>directory</context><context>.htaccess</context></contextlist>
2771 <override>FileInfo</override>
2772 <compatibility>ausschlie&szlig;lich Win32;
2773 Die Option <code>Registry-Strict</code> ist verf&uuml;gbar seit Apache
2774 2.0.</compatibility>
2775
2776 <usage>
2777     <p>Die Direktive steuert, wie der Apache den Interpreter zur Ausf&uuml;hrung
2778     von CGI-Skripten bestimmt. Die Voreinstellung ist <code>Script</code>. Dies
2779     veranla&szlig;t den Apache, den Interpreter zu verwenden, auf den die
2780     Shebang-Zeile (erste Zeile, beginnt mit <code>#!</code>) im Skript zeigt.
2781     Auf Win32-Systemen sieht diese Zeile &uuml;blicherweise so aus:</p>
2782
2783     <example>
2784       #!C:/Perl/bin/perl.exe
2785     </example>
2786
2787     <p>oder, wenn <code>perl</code> im Pfad (Umgebungsvariable <code>PATH</code>) liegt,
2788       einfach:</p>
2789
2790     <example>
2791       #!perl
2792     </example>
2793
2794     <p>Die Einstellung <code>ScriptInterpreterSource Registry</code>
2795     veranla&szlig;t eine Suche in <code>HKEY_CLASSES_ROOT</code> der
2796     Windows-Registrierungsdatenbank und verwendet die Endung der Skript-Datei
2797     (z.B. <code>.pl</code>) als Suchargument. Der durch den Unterschl&uuml;ssel
2798     <code>Shell\ExecCGI\Command</code> oder, falls dieser nicht existiert,
2799     <code>Shell\Open\Command</code> definierte Befehl wird zum &Ouml;ffnen der
2800     Skript-Datei verwendet. Wenn der Schl&uuml;ssel zur Dateiendung oder
2801     beide Unterschl&uuml;ssel fehlen, dann verwendet der Apache die Option
2802     <code>Script</code>.</p>
2803
2804     <note type="warning"><title>Sicherheit</title>
2805       <p>Seien Sie vorsichtig, <code>ScriptInterpreterSource Registry</code> bei
2806       Verzeichnissen zu verwenden, auf die eine <directive
2807         module="mod_alias">ScriptAlias</directive>-Anweisung zeigt, denn der
2808       Apache versucht <strong>jede</strong> Datei innerhalb des Verzeichnisses
2809       auszuf&uuml;hren. Die Einstellung <code>Registry</code> kann
2810       unerw&uuml;nschte Programmaufrufe bei Dateien verursachen, die
2811       &uuml;blicherweise nicht ausgef&uuml;hrt werden. Auf den meisten
2812       Windows-Systemen beispielsweise startet der voreingestellte
2813       &Ouml;ffnen-Befehl f&uuml;r <code>.htm</code>-Dateien den Microsoft
2814       Internet Explorer, so dass jede HTTP-Anfrage nach einer existierenden
2815       <code>.htm</code>-Datei im Skript-Verzeichnis den Browser im Hintergrund
2816       starten w&uuml;rde. Dies ist eine wirksame Methode, Ihr System binnen
2817       etwa einer Minute zum Absturz zu bringen.</p>
2818     </note>
2819           
2820     <p>Die seit Apache 2.0 neue Option <code>Registry-Strict</code>
2821     macht das gleiche wie <code>Registry</code>, verwendet jedoch nur den
2822     Unterschl&uuml;ssel <code>Shell\ExecCGI\Command</code>. Der Schl&uuml;ssel
2823     <code>ExecCGI</code> ist gew&ouml;hnlich nicht voreingestellt. Er muss
2824     manuell eingerichtet werden und sch&uuml;tzt Ihr System so for
2825     versehentlichen Programmaufrufen.</p>
2826 </usage>
2827 </directivesynopsis>
2828
2829 <directivesynopsis>
2830 <name>ServerAdmin</name>
2831 <description>E-Mail-Adresse, die der Server in Fehlermeldungen einf&uuml;gt,
2832 welche an den Client gesendet werden</description>
2833 <syntax>ServerAdmin <var>E-Mail-Adresse</var>|<var>URL</var></syntax>
2834 <contextlist><context>server config</context><context>virtual host</context>
2835 </contextlist>
2836
2837 <usage>
2838     <p><directive>ServerAdmin</directive> legt die Kontaktadresse fest,
2839     die der Server in jede Fehlermeldung einf&uuml;gt, die er an den
2840     Client zur&uuml;ckschickt. Wenn <code>httpd</code> das &uuml;bergebene
2841     Argument nicht als URL erkennt, nimmt er an, dess es sich um eine
2842     <var>E-Mail-Adresse</var> handelt und stellt in Hyperlinks
2843     <code>mailto:</code> voran. Es ist jedoch sogar sinnvoll, eine
2844     E-Mail-Adresse zu verwenden, da viele CGI-Skripte davon ausgehen. Wenn Sie
2845     eine URL verwenden m&ouml;chten, sollten Sie auf einem anderen unter Ihrer
2846     Kontrolle stehenden Server verweisen. Andernfalls k&ouml;nnen Besucher Sie
2847     im Fehlerfall m&ouml;glicherweise nicht kontaktieren.</p>
2848
2849     <p>Es kann sich lohnen, hierf&uuml;r eine reservierte Adresse
2850     anzugeben, z.B.</p>
2851
2852     <example>
2853       ServerAdmin www-admin@foo.example.com
2854     </example>
2855
2856     <p>da Anwender nicht unbedingt erw&auml;hnen, dass sie vom Server
2857     sprechen!</p>
2858 </usage>
2859 </directivesynopsis>
2860
2861 <directivesynopsis>
2862 <name>ServerAlias</name>
2863 <description>Alternativer Name f&uuml;r einen Host, der verwendet wird, wenn
2864 Anfragen einem namensbasierten virtuellen Host zugeordnet werden</description>
2865 <syntax>ServerAlias <var>Hostname</var> [<var>Hostname</var>] ...</syntax>
2866 <contextlist><context>virtual host</context></contextlist>
2867
2868 <usage>
2869     <p>Die Direktive <directive>ServerAlias</directive> bestimmt die
2870     alternativen Namen eines Hosts zur Verwendung mit <a
2871     href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>.</p>
2872
2873     <example>
2874       &lt;VirtualHost *&gt;<br />
2875       ServerName server.domain.com<br />
2876       ServerAlias server server2.domain.com server2<br />
2877       # ...<br />
2878       &lt;/VirtualHost&gt;
2879     </example>
2880 </usage>
2881 <seealso><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2882   Hosts</a></seealso>
2883 </directivesynopsis>
2884
2885 <directivesynopsis>
2886 <name>ServerName</name>
2887 <description>Rechnername und Port, die der Server dazu verwendet, sich
2888 selbst zu identifizieren</description>
2889 <syntax>ServerName
2890 <var>voll-qualifizierter-Domainname</var>[:<var>port</var>]</syntax>
2891 <contextlist><context>server config</context><context>virtual host</context>
2892 </contextlist>
2893 <compatibility>Diese Direktive l&ouml;st in Version 2.0 die
2894      Funktionalit&auml;t der Direktive <directive>Port</directive> aus
2895      Version 1.3 ab.</compatibility>
2896
2897 <usage>
2898     <p>Die Direktive <directive>ServerName</directive> bestimmt den
2899     Rechnernamen und Port, den der Server dazu verwendet, sich selbst
2900     zu identifizieren. Diese werden bei der Erstellung von Umleitungs-URLs
2901     ben&ouml;tigt. Wenn beispielsweise der Name der Maschine, die den Webserver
2902     beherbergt, <code>simple.example.com</code> lautet, die Maschine jedoch
2903     auch einen DNS-Alias <code>www.example.com</code> besitzt und Sie den
2904     Webserver so identifizieren m&ouml;chten, sollten Sie die folgende
2905     Anweisung verwenden:</p>
2906
2907     <example>
2908       ServerName www.example.com:80
2909     </example>
2910
2911     <p>Wenn kein <directive>ServerName</directive> angegeben wurde,
2912     dann versucht der Server den Rechnernamen mittels eines Reverse-Lookup
2913     herzuleiten. Wenn kein Port in der
2914     <directive>ServerName</directive>-Anweisung angegeben wurde, dann
2915     verwendet der Server den Port der eingegangenen Anfrage. F&uuml;r eine
2916     optimale Zuverl&auml;ssigkeit und Berechenbarkeit sollten Sie einen
2917     eindeutigen Rechnernamen und Port angeben, in dem Sie die Direktive
2918     <directive>ServerName</directive> verwenden.</p>
2919
2920     <p>Wenn Sie <a href="../vhosts/name-based.html">namensbasierte
2921     virtuelle Hosts</a> verwenden, gibt <directive>ServerName</directive>
2922     innerhalb eines <directive type="section"
2923     module="core">VirtualHost</directive>-Abschnitts an, welcher
2924     Hostname im <code>Host:</code>-Header der Anfrage auftauchen muss,
2925     damit sie diesem virtuellen Host zugeordnet wird.</p>
2926
2927     <p>Lesen Sie bitte die Beschreibung der Direktiven <directive
2928     module="core">UseCanonicalName</directive> und <directive module="core"
2929     >UseCanonicalPhysicalPort</directive> f&uuml;r Einstellungen, die
2930     bestimmen, ob selbstreferenzierende URLs (z.B. vom Modul
2931     <module>mod_dir</module>) auf den angegebenen Port zeigen oder auf die
2932     Portnummern die in der Anfrage des Clients angegeben ist.</p>
2933 </usage>
2934
2935 <seealso><a href="../dns-caveats.html">Probleme bez&uuml;glich DNS und
2936 Apache</a></seealso>
2937 <seealso><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2938   Hosts</a></seealso>
2939 <seealso><directive module="core">UseCanonicalName</directive></seealso>
2940 <seealso><directive module="core">UseCanonicalPhysicalPort</directive></seealso>
2941 <seealso><directive module="core">NameVirtualHost</directive></seealso>
2942 <seealso><directive module="core">ServerAlias</directive></seealso>
2943 </directivesynopsis>
2944
2945 <directivesynopsis>
2946 <name>ServerPath</name>
2947 <description>Veralteter URL-Pfad f&uuml;r einen namensbasierten
2948 virtuellen Host, auf den von einem inkompatiblen Browser zugegriffen
2949 wird</description>
2950 <syntax>ServerPath <var>URL-Pfad</var></syntax>
2951 <contextlist><context>virtual host</context></contextlist>
2952
2953 <usage>
2954     <p>Die Direktive <directive>ServerPath</directive> legt den
2955     veralteten <transnote>Gemeint ist eigentlich "Altlast" aufgrund
2956     antiquierter Clients.</transnote> URL-Pfad eines Hosts zur Verwendung mit
2957     <a href="../vhosts/">namensbasierten virtuellen Hosts</a> fest.</p>
2958 </usage>
2959 <seealso><a href="../vhosts/">Apache-Dokumentation zu virtuellen
2960   Hosts</a></seealso>
2961 </directivesynopsis>
2962
2963 <directivesynopsis>
2964 <name>ServerRoot</name>
2965 <description>Basisverzeichnis der Serverinstallation</description>
2966 <syntax>ServerRoot <var>Verzeichnis</var></syntax>
2967 <default>ServerRoot /usr/local/apache</default>
2968 <contextlist><context>server config</context></contextlist>
2969
2970 <usage>
2971     <p>Die Direktive <directive>ServerRoot</directive> bestimmt das
2972     Verzeichnis, in dem der Server installiert ist. &Uuml;blicherweise
2973     enth&auml;lt es die Unterverzeichnisse <code>conf/</code> und
2974     <code>logs/</code>. Relative Pfadangaben anderer Direktiven (wie z.B.
2975     <directive module="core">Include</directive> oder <directive
2976     module="mod_so">LoadModule</directive>) werden relativ zu diesem
2977     Verzeichnis betrachtet.</p>
2978
2979     <example><title>Beispiel</title>
2980       ServerRoot /home/httpd
2981     </example>
2982 </usage>
2983 <seealso><a href="../invoking.html">Die <code>httpd</code>-Option
2984     <code>-d</code></a></seealso>
2985 <seealso><a href="../misc/security_tips.html#serverroot">Sicherheitshinweise</a>
2986     f&uuml;r Informationen, wie die Rechte auf das <directive
2987     >ServerRoot</directive>-Verzeichnis richtig gesetzt werden</seealso>
2988 </directivesynopsis>
2989
2990 <directivesynopsis>
2991 <name>ServerSignature</name>
2992 <description>Konfiguriert die Fu&szlig;zeile von servergenerierten
2993 Dokumenten</description>
2994 <syntax>ServerSignature On|Off|EMail</syntax>
2995 <default>ServerSignature Off</default>
2996 <contextlist><context>server config</context><context>virtual host</context>
2997 <context>directory</context><context>.htaccess</context>
2998 </contextlist>
2999 <override>All</override>
3000
3001 <usage>
3002     <p>Die Direktive <directive>ServerSignature</directive> erm&ouml;glicht
3003     die Gestaltung einer unter servergenerierten Dokumenten (z.B.
3004     Fehlerdokumente, FTP-Verzeichnislisten von <module>mod_proxy</module>,
3005     <module>mod_info</module>-Ausgaben, ...) angef&uuml;gten
3006     Fu&szlig;zeile. Ein m&ouml;glicher Grund f&uuml;r die Aktivierung einer
3007     solchen Fu&szlig;zeile ist, dass der Anwender bei einer Kette von
3008     Proxy-Servern oft keine M&ouml;glichkeit hat, zu erkennen, welcher der
3009     verketteten Server gegenw&auml;rtig die zur&uuml;ckgegebene Fehlermeldung
3010     produziert hat.</p>
3011
3012     <p>Die (Vor-)Einstellung <code>Off</code> unterdr&uuml;ckt die
3013     Fu&szlig;zeile (und ist damit kompatibel zum Verhalten des Apache 1.2 und
3014     fr&uuml;her). Die Einstellung <code>On</code> f&uuml;gt schlicht eine
3015     Zeile mit der Versionsnummer des Servers und dem Servernamen (<directive
3016     module="core">ServerName</directive>) des bedienenden virtuellen Hosts an.
3017     Die Einstellung <code>EMail</code> erstellt zus&auml;tzlich einen
3018     "mailto:"-Verweis zum Serveradministrator (<directive
3019     module="core">ServerAdmin</directive>) des referenzierten Dokuments.</p>
3020
3021     <p>Ab Version 2.0.44 werden die Details der angegebenen Versionsnummer des
3022     Servers von der Direktive  <directive
3023     module="core">ServerTokens</directive> kontrolliert.</p>
3024 </usage>
3025 <seealso><directive module="core">ServerTokens</directive></seealso>
3026 </directivesynopsis>
3027
3028 <directivesynopsis>
3029 <name>ServerTokens</name>
3030 <description>Konfiguriert den HTTP-Response-Header
3031 <code>Server</code></description>
3032 <syntax>ServerTokens Major|Minor|Min[imal]|Prod[uctOnly]|OS|Full</syntax>
3033 <default>ServerTokens Full</default>
3034 <contextlist><context>server config</context></contextlist>
3035
3036 <usage>
3037     <p>die Direktive steuert, ob der Response-Header <code>Server</code>,
3038     der an den Client zur&uuml;ckgesendet wird, eine Beschreibung des
3039     allgemeinen Betriesbsystemtyps des Servers wie auch Informationen
3040     &uuml;ber einkompilierte Module enth&auml;lt.</p>
3041
3042     <dl>
3043       <dt><code>ServerTokens Prod[uctOnly]</code></dt>
3044
3045       <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
3046       Apache</code></dd>
3047
3048       <dt><code>ServerTokens Major</code></dt>
3049
3050       <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
3051       Apache/2</code></dd>
3052
3053       <dt><code>ServerTokens Minor</code></dt>
3054
3055       <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
3056       Apache/2.0</code></dd>
3057
3058       <dt><code>ServerTokens Min[imal]</code></dt>
3059
3060       <dd>Der Server sendet (<em>z.B.</em>): <code>Server:
3061       Apache/2.0.41</code></dd>
3062
3063       <dt><code>ServerTokens OS</code></dt>
3064
3065       <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
3066       (Unix)</code></dd>
3067
3068       <dt><code>ServerTokens Full</code> (oder nicht angegeben)</dt>
3069
3070       <dd>Der Server sendet (<em>z.B.</em>): <code>Server: Apache/2.0.41
3071       (Unix) PHP/4.2.2 MyMod/1.2</code></dd>
3072     </dl>
3073
3074     <p>Diese Einstellung gilt f&uuml;r den gesamten Server und kann nicht
3075     auf Virtual-Host-Basis aktiviert oder deaktiviert werden.</p>
3076
3077     <p>Ab Version 2.0.44 steuert diese Direktive auch die Informationen, die
3078     durch die Direktive <directive module="core">ServerSignature</directive>
3079     angeboten werden.</p>
3080 </usage>
3081 <seealso><directive module="core">ServerSignature</directive></seealso>
3082 </directivesynopsis>
3083
3084 <directivesynopsis>
3085 <name>SetHandler</name>
3086 <description>Erzwingt die Verarbeitung aller passenden Dateien durch
3087 einen Handler</description>
3088 <syntax>SetHandler <var>Handlername</var>|None</syntax>
3089 <contextlist><context>server config</context><context>virtual host</context>
3090 <context>directory</context><context>.htaccess</context>
3091 </contextlist>
3092 <override>FileInfo</override>
3093 <compatibility>Seit Apache 2.0 im Core</compatibility>
3094
3095 <usage>
3096     <p>Wenn die Direktive innerhalb einer <code>.htaccess</code>-Datei
3097     oder in einem <directive type="section"
3098     module="core">Directory</directive>- oder
3099     <directive type="section" module="core">Location</directive>-Abschnitt
3100     angegeben wird, erzwingt sie, dass alle entsprechenden Dateien von dem
3101     durch <var>Handlername</var> angegebenen <a
3102     href="../handler.html">Handler</a> analysiert werden. Wenn Sie
3103     beispielsweise ein Verzeichnis haben, dessen Dateien unabh&auml;ngig von
3104     der Endung g&auml;nzlich als Image-Maps interpretiert werden sollen,
3105     k&ouml;nnen Sie folgendes in eine <code>.htaccess</code>-Datei in
3106     dem Verzeichnis schreiben:</p>
3107
3108     <example>
3109       SetHandler imap-file
3110     </example>
3111
3112     <p>Noch ein Beispiel: wenn Sie den Server immer, wenn die URL
3113     <code>http://servername/status</code> aufgerufen wird, einen
3114     Statusbericht anzeigen lassen m&ouml;chten, dann k&ouml;nnen
3115     Sie folgendes in die <code>httpd.conf</code> schreiben:</p>
3116
3117     <example>
3118       &lt;Location /status&gt;<br />
3119       <indent>
3120         SetHandler server-status<br />
3121       </indent>
3122       &lt;/Location&gt;
3123     </example>
3124     <p>Sie k&ouml;nnen eine zuvor definierte
3125     <directive>SetHandler</directive>-Anweisung aufheben, indem Sie den Wert
3126     <code>None</code> verwenden.</p>
3127     <p><strong>Hinweis:</strong> SetHandler setzt die Standard-Handler
3128     au&szlig;er Kraft und unterdr&uuml;ckt gewohnte Verhaltensweisen, wie
3129     beispielsweise die Behandlung von URLs, die auf einen Schr&auml;gstrich
3130     (/) enden als Verzeichnisse oder (die Auslieferung von) Index-Dateien.</p>
3131 </usage>
3132 <seealso><directive module="mod_mime">AddHandler</directive></seealso>
3133 </directivesynopsis>
3134
3135 <directivesynopsis>
3136 <name>SetInputFilter</name>
3137 <description>Bestimmt die Filter, die Client-Anfragen und POST-Eingaben
3138 verarbeiten</description>
3139 <syntax>SetInputFilter <var>Filter</var>[;<var>Filter</var>...]</syntax>
3140 <contextlist><context>server config</context><context>virtual host</context>
3141 <context>directory</context><context>.htaccess</context>
3142 </contextlist>
3143 <override>FileInfo</override>
3144
3145 <usage>
3146     <p>Die Direktive <directive>SetInputFilter</directive> bestimmt den oder
3147     die Filter, die Client-Anfragen und POST-Eingaben verarbeiten, wenn
3148     sie vom Server empfangen werden. Diese gelten zus&auml;tzlich zu
3149     anderweitig definierten Filtern, einschlie&szlig;lich denen der Direktive
3150     <directive module="mod_mime">AddInputFilter</directive>.</p>
3151
3152     <p>Wenn mehr als ein Filter angegeben wird, dann m&uuml;ssen diese
3153     durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3154     in der sie die Daten verarbeiten sollen.</p>
3155 </usage>
3156 <seealso><a href="../filter.html">Filter</a>-Dokumentation</seealso>
3157 </directivesynopsis>
3158
3159 <directivesynopsis>
3160 <name>SetOutputFilter</name>
3161 <description>Bestimmt die Filter, die Antworten des Servers verarbeiten</description>
3162 <syntax>SetOutputFilter <var>Filter</var>[;<var>Filter</var>...]</syntax>
3163 <contextlist><context>server config</context><context>virtual host</context>
3164 <context>directory</context><context>.htaccess</context>
3165 </contextlist>
3166 <override>FileInfo</override>
3167
3168 <usage>
3169     <p>Die Direktive <directive>SetOutputFilter</directive> bestimmt
3170     die Filter, die Antworten des Servers verarbeiten, bevor sie an den
3171     Client gesendet werden. Diese gelten zus&auml;tzlich zu anderweitig
3172     definierten Filtern, einschlie&szlig;lich denen der Direktive
3173     <directive module="mod_mime">AddOutputFilter</directive>.</p>
3174
3175     <p>Die folgende Konfiguration verarbeitet zum Beispiel alle Dateien
3176     im Verzeichnis <code>/www/data</code> als Server Side Includes.</p>
3177
3178     <example>
3179       &lt;Directory /www/data/&gt;<br />
3180       <indent>
3181         SetOutputFilter INCLUDES<br />
3182       </indent>
3183       &lt;/Directory&gt;
3184     </example>
3185
3186     <p>Wenn mehr als ein Filter angegeben wird, dann m&uuml;ssen diese
3187     durch Semikolon voneinander getrennt in der Reihenfolge angegeben werden,
3188     in der sie die Daten verarbeiten sollen.</p>
3189 </usage>
3190 <seealso><a href="../filter.html">Filter</a>-Dokumentation</seealso>
3191 </directivesynopsis>
3192
3193 <directivesynopsis>
3194 <name>TimeOut</name>
3195 <description>Zeitspanne, die der Server auf verschiedene Ereignisse wartet,
3196 bevor er die Anfrage abbricht</description>
3197 <syntax>TimeOut <var>Sekunden</var></syntax>
3198 <default>TimeOut 60</default>
3199 <contextlist><context>server config</context></contextlist>
3200
3201 <usage>
3202                 <p>Die Direktive <directive>TimeOut</directive> definiert derzeit die
3203     Zeitspanne, die der Apache auf drei Dinge wartet:</p>
3204
3205     <ol>
3206       <li>Die gesamte Zeispanne, die ben&ouml;tigt wird, um eine GET-Anfrage
3207       zu empfangen.</li>
3208
3209       <li>Die Zeitspanne zwischen dem Empfang von TCP-Paketen einer
3210       POST- oder PUT-Anfrage.</li>
3211
3212       <li>Die Zeitspanne zwischen ACKs bei der &Uuml;bermittlung der
3213       TCP-Pakete der Antwort.</li>
3214     </ol>
3215
3216     <p>Wir haben vor, diese Zeitspannen in Zukunft separat konfigurierbar zu
3217     machen. Vor Version 1.2 war der Zeitgeber auf 1200 voreingestellt, wurde
3218     dann aber auf 300 herabgesetzt, was immer noch weit mehr ist, als in den
3219     meisten Situationen ben&ouml;tigt wird. Die Voreinstellung wurde nicht
3220     weiter herabgesetzt, da gelegentlich noch Stellen im Code existieren
3221     k&ouml;nnen, wo der Zeitgeber nicht zur&uuml;ckgesetzt wird, wenn ein
3222     Paket verschickt wird. Seit Apache 2.4 ist die Voreinstellung 60.</p>
3223 </usage>
3224 </directivesynopsis>
3225
3226 <directivesynopsis>
3227 <name>TraceEnable</name>
3228 <description>Legt das Verhalten von <code>TRACE</code>-Anfragen fest</description>
3229 <syntax>TraceEnable <var>[on|off|extended]</var></syntax>
3230 <default>TraceEnable on</default>
3231 <contextlist><context>server config</context></contextlist>
3232 <compatibility>Verf&uuml;gbar ab Apache 1.3.34 und 2.0.55</compatibility>
3233
3234 <usage>
3235     <p>Diese Direktive beeinflusst das Verhalten von <code>TRACE</code> sowohl
3236     f&uuml;r den Server selbst als auch <module>mod_proxy</module>. Die
3237     Voreinstellung <code>TraceEnable on</code> erlaubt
3238     <code>TRACE</code>-Anfragen gem&auml;&szlig; RFC 2616. Dort werden
3239     nur Anfragen ohne Datenteil zugelassen. <code>TraceEnable off</code>
3240     sorgt daf&uuml;r, dass der Serverkern und <module>mod_proxy</module> den
3241     Fehler <code>405</code> (Zugriffsmethode nicht erlaubt) an den Client
3242     senden.</p>
3243
3244     <p>Zu Test- und Diagnosezwecken k&ouml;nnen Sie auch
3245     nicht-standardkonforme Anfragen mit Datenteil erlauben, indem Sie die
3246     Direktive <code>TraceEnable extended</code> verwenden. Der Server (als
3247     Ursprungsserver) beschr&auml;nkt den Anfrageinhalt auf 64k. (Wenn
3248     <code>Transfer-Encoding: chunked</code> benutzt wird, k&ouml;nnen
3249     weitere 8k f&uuml;r die Chunk-Kopfzeilen verwendet werden.) Der
3250     Server selbst reflektiert dann die vollst&auml;ndigen HTTP- und
3251     Chunk-Kopfzeilen in seiner Antwort. Die Einschr&auml;nkung auf 64k gilt
3252     nicht, wenn der Server als Proxy arbeitet.</p>
3253 </usage>
3254 </directivesynopsis>
3255
3256 <directivesynopsis>
3257 <name>UseCanonicalName</name>
3258 <description>Bestimmt, wie der Server seinen eigenen Namen und Port
3259 ermittelt</description>
3260 <syntax>UseCanonicalName On|Off|DNS</syntax>
3261 <default>UseCanonicalName Off</default>
3262 <contextlist><context>server config</context><context>virtual host</context>
3263 <context>directory</context></contextlist>
3264
3265 <usage>
3266     <p>In vielen Situationen muss der Apache eine
3267     <em>selbstreferenzierende</em> URL -- d.h. eine URL, die auf den selben
3268     Server zur&uuml;ck verweist -- zusammenbauen. Bei <code>UseCanonicalName
3269     On</code> verwendet der Apache den Hostnamen und Port, der in der
3270     <directive module="core">ServerName</directive>-Anweisung angegeben ist,
3271     um den kanonischen Namen des Servers zu erstellen. Dieser Name wird in
3272     allen selbstreferenzierenden URLs sowie in CGI-Skripten f&uuml;r die
3273     Werte von <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3274     verwendet.</p>
3275
3276     <p>Bei <code>UseCanonicalName Off</code> bildet der Apache
3277     selbstreferenzierende URLs, indem er den vom Client &uuml;bermittelten
3278     Hostnamen und Port verwendet, sofern diese vorhanden sind (andernfalls
3279     wird der kanonische Name, wie oben beschrieben, benutzt). Die Werte
3280     sind die gleichen, die zur Anwendung von <a
3281     href="../vhosts/name-based.html">namensbasierten virtuellen Hosts</a>
3282     verwendet werden, und sie sind mit den gleichen Clients verf&uuml;gbar
3283     <transnote>, die auch in der Lage sind, auf namensbasierte virtuelle Hosts
3284     zuzugreifen, d.h. einen <code>Host</code>-Header mitschicken</transnote>.
3285     Die CGI-Variablen <code>SERVER_NAME</code> und <code>SERVER_PORT</code>
3286     werden ebenfalls aus den vom Client angeboten Werten erstellt.</p>
3287
3288     <p>Ein Intranet-Server, auf den Anwender mit kurzen Namen wie
3289     <code>www</code> zugreifen, ist ein Beispiel, wo dies sinnvoll sein kann.
3290     Sie werden bemerken, dass der Apache den Benutzer auf
3291     <code>http://www.domain.com/splat/</code> umleitet, wenn dieser einen
3292     Kurznamen und eine URL, die einem Verzeichnis entspricht, ohne
3293     abschlie&szlig;enden Schr&auml;gstrich eingibt, wie z.B.
3294     <code>http://www/splat</code>. Wenn Sie Authentisierung aktiviert haben,
3295     bewirkt dies, dass der Benutzer sich zweimal identifizieren muss
3296     (einmal f&uuml;r <code>www</code> und noch einmal f&uuml;r
3297     <code>www.domain.com</code> -- lesen Sie f&uuml;r weitere Informationen <a
3298     href="http://httpd.apache.org/docs/misc/FAQ.html#prompted-twice">die
3299     FAQ zu diesem Thema</a>). Wenn <directive>UseCanonicalName</directive>
3300     jedoch auf <code>Off</code> gesetzt ist, denn wird der Apache zu
3301     <code>http://www/splat/</code> umleiten.</p>
3302
3303     <p>Es existiert noch eine dritte Option, <code>UseCanonicalName DNS</code>,
3304     die f&uuml;r den Betrieb von IP-basierten Massen-Virtual-Hosts gedacht ist,
3305     um antiquierte Clients zu unterst&uuml;tzen, die keinen
3306     <code>Host:</code>-Header bereit stellen. Um selbstreferenzierende
3307     URLs zu ermitteln, f&uuml;hrt der Apache bei dieser Option ein
3308     Reverse-DNS-Lookup auf die IP-Adresse des Servers aus, zu der der Client
3309     Verbindung aufgenommen hat.</p>
3310
3311     <note type="warning"><title>Warnung</title>
3312       <p>Wenn CGI-Skripte Vermutungen aufgrund des Wertes von
3313       <code>SERVER_NAME</code> anstellen, k&ouml;nnen sie durch diese
3314       Option fehlschlagen. Clients steht es im Wesentlichen frei, einen Wert
3315       f&uuml;r den Hostnamen anzugeben, wie er will. Wenn das
3316       CGI-Skript <code>SERVER_NAME</code> jedoch lediglich dazu verwendet,
3317       selbstreferenzierende URLs zu erstellen, sollte das gerade noch
3318       in Ordnung sein.</p>
3319     </note>
3320 </usage>
3321 <seealso><directive module="core">ServerName</directive></seealso>
3322 <seealso><directive module="mpm_common">Listen</directive></seealso>
3323 </directivesynopsis>
3324
3325 <directivesynopsis>
3326 <name>UseCanonicalPhysicalPort</name>
3327 <description>Bestimmt, wie der Server seinen eigenen Namen und Port
3328 ermittelt</description>
3329 <syntax>UseCanonicalPhysicalPort On|Off</syntax>
3330 <default>UseCanonicalPhysicalPort Off</default>
3331 <contextlist><context>server config</context><context>virtual host</context>
3332 <context>directory</context></contextlist>
3333
3334 <usage>
3335     <p>In vielen Situationen muss der Apache eine
3336     <em>selbstreferenzierende</em> URL zusammenbauen, d.h. eine URL, die auf
3337     den selben Server zur&uuml;ck verweist. Wenn der Apache f&uuml;r die
3338     <directive module="core">UseCanonicalName</directive>-Direktive den Port
3339     bestimmt, wird mit <code>UseCanonicalPhysicalPort On</code> die
3340     tats&auml;chlich f&uuml;r die Anfrage verwendete physische Portnummer
3341     in Betracht gezogen. Mit <code>UseCanonicalPhysicalPort Off</code>
3342     verl&auml;&szlig;t sich der Apache nur auf die Konfiguration, um eine
3343     g&uuml;ltige Portnummer zu bestimmen und l&auml;&szlig;t die
3344     physische Portnummer au&szlig;er acht.</p>
3345
3346     <note><title>Hinweis</title>
3347     <p>Wenn der physische Port verwendet wird, ist die Reihenfolge wie
3348     folgt:<br /><br />
3349      <code>UseCanonicalName On</code></p>
3350      <ul>
3351       <li>Der in <code>Servername</code> angegebene Port</li>
3352       <li>Der physische Port</li>
3353       <li>Der Standardport</li>
3354      </ul>
3355      <code>UseCanonicalName Off | DNS</code>
3356      <ul>
3357       <li>Der Port, der aus dem <code>Host:</code>-Header gewonnen wurde</li>
3358       <li>Der physische Port</li>
3359       <li>Der in <code>Servername</code> angegebene Port</li>
3360       <li>Der Standardport</li>
3361      </ul>
3362
3363     <p>Bei <code>UseCanonicalPhysicalPort Off</code> werden die physischen
3364     Ports aus der Suchreihe entfernt.</p>
3365     </note>
3366
3367 </usage>
3368 <seealso><directive module="core">UseCanonicalName</directive></seealso>
3369 <seealso><directive module="core">ServerName</directive></seealso>
3370 <seealso><directive module="mpm_common">Listen</directive></seealso>
3371 </directivesynopsis>
3372
3373 <directivesynopsis type="section">
3374 <name>VirtualHost</name>
3375 <description>Enth&auml;lt Direktiven, die nur auf bestimmte Hostnamen oder
3376 IP-Adressen angewendet werden</description>
3377 <syntax>&lt;VirtualHost
3378     <var>Adresse</var>[:<var>Port</var>] [<var>Adresse</var>[:<var>Port</var>]]
3379     ...&gt; ... &lt;/VirtualHost&gt;</syntax>
3380 <contextlist><context>server config</context></contextlist>
3381
3382 <usage>
3383     <p><directive type="section">VirtualHost</directive> und
3384     <code>&lt;/VirtualHost&gt;</code> werden dazu verwendet, eine Gruppe
3385     von Direktiven zusammenzufassen, die nur auf einen bestimmten virtuellen
3386     Host angewendet werden. Jede Direktive, die im Virtual-Host-Kontext
3387     zul&auml;ssig ist, kann verwendet werden. Wenn der Server eine Anfrage
3388     f&uuml;r ein bestimmtes Dokument eines bestimmten virtuellen Hosts
3389     empf&auml;ngt, dann benutzt er die im
3390     <directive type="section">VirtualHost</directive>-Container enthaltenen
3391     Konfigurationsanweisungen. <var>Adresse</var> kann sein:</p>
3392
3393     <ul>
3394       <li>Die IP-Adresse des virtuellen Hosts.</li>
3395
3396       <li>Ein voll qualifizierter Domainname f&uuml;r die IP-Adresse des
3397       virtuellen Hosts.</li>
3398
3399       <li>Das Zeichen <code>*</code>, welches nur in Kombination mit
3400       <code>NameVirtualHost *</code> verwendet wird, um allen IP-Adressen
3401       zu entsprechen.</li>
3402
3403       <li>Die Zeichenkette <code>_default_</code>, die nur mit IP-basierten
3404       virtuellen Hosts verwendet wird, um nicht zugewiesene IP-Adressen
3405       aufzufangen.</li>
3406     </ul>
3407
3408     <example><title>Beispiel</title>
3409       &lt;VirtualHost 10.1.2.3&gt;<br />
3410       <indent>
3411         ServerAdmin webmaster@host.foo.com<br />
3412         DocumentRoot /www/docs/host.foo.com<br />
3413         ServerName host.foo.com<br />
3414         ErrorLog logs/host.foo.com-error_log<br />
3415         TransferLog logs/host.foo.com-access_log<br />
3416       </indent>
3417       &lt;/VirtualHost&gt;
3418     </example>
3419
3420     <p>IPv6-Adressen m&uuml;ssen in eckigen Klammern angegeben werden, da die
3421     optionale Portnummer sonst nicht erkannt werden kann. Hier ein
3422     IPv6-Beispiel:</p>
3423
3424     <example>
3425       &lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]&gt;<br />
3426       <indent>
3427         ServerAdmin webmaster@host.example.com<br />
3428         DocumentRoot /www/docs/host.example.com<br />
3429         ServerName host.example.com<br />
3430         ErrorLog logs/host.example.com-error_log<br />
3431         TransferLog logs/host.example.com-access_log<br />
3432       </indent>
3433       &lt;/VirtualHost&gt;
3434     </example>
3435
3436     <p>Jeder virtuelle Host muss einer anderen IP-Adresse, einem anderen Port
3437     oder einem anderen Hostnamen f&uuml;r den Server entsprechen. Im ersten
3438     Fall muss die Servermaschine so eingerichtet sein, dass sie IP-Pakete
3439     f&uuml;r mehrere Adressen akzeptiert. (Wenn der Rechner nicht mehrere
3440     Netzwerkkarten besitzt, kann dies mit dem Befehl <code>ifconfig
3441     alias</code> durchgef&uuml;hrt werden -- sofern Ihr Betriebssystem das
3442     unterst&uuml;tzt).</p>
3443
3444     <note><title>Anmerkung</title>
3445       <p>Die Verwendung von <directive type="section">VirtualHost</directive>
3446       beeinflusst <strong>nicht</strong>, an welchen Adressen der Apache
3447       lauscht. Sie m&uuml;ssen mit <directive
3448       module="mpm_common">Listen</directive> sicherstellen, dass der Apache
3449       an der richtigen Adresse lauscht.</p>
3450     </note>
3451
3452     <p>Bei der Verwendung IP-basierter virtuellen Hosts kann der spezielle
3453     Name <code>_default_</code> benutzt werden. In diesem Fall weist
3454     der Apache jede IP-Adresse diesem virtuellen Host zu, die nicht explizit in
3455     einem anderen virtuellen Host angegeben ist. Falls kein virtueller Host
3456     <code>_default_</code> angegeben ist, wird die "Hauptserver"-Konfiguration,
3457     die aus allen Definitionen au&szlig;erhalb der Virtual-Host-Abschnitte
3458     besteht, f&uuml;r nicht passende IPs verwendet. (Beachten Sie jedoch,
3459     dass eine IP-Adressen die zu einer <directive
3460     module="core">NameVirtualHost</directive>-Anweisung passt, weder den
3461     "Hauptserver" noch den virtuellen Host <code>_default_</code> verwendet.
3462     Lesen Sie f&uuml;r weitere Details die Dokumentation zu <a
3463     href="../vhosts/name-based.html">namensbasierten virtuell Hosts</a>.)</p>
3464
3465     <p>Sie k&ouml;nnen einen speziellen <code>:Port</code> angeben,
3466     um den entsprechenden Port zu wechseln. Falls nicht angegeben, wird
3467     er auf den gleichen Port voreingestellt, wie die letzte
3468     <directive module="mpm_common">Listen</directive>-Anweisung des
3469     Hauptservers. Sie k&ouml;nnen auch <code>:*</code> angeben, um alle
3470     Ports dieser Adresse zu akzeptieren. (Dies wird zusammen mit
3471     <code>_default_</code> empfohlen.)</p>
3472
3473     <note type="warning"><title>Sicherheit</title>
3474       <p>Lesen Sie das Dokument <a
3475       href="../misc/security_tips.html">Sicherheitshinweise</a> f&uuml;r
3476       Details, warum Ihre Sicherheit gef&auml;hrdet sein kann, wenn das
3477       Verzeichnis, in dem Protokolldateien gespeichert werden, f&uuml;r
3478       jemanden anderes als den Benutzer beschreibbar ist, der den Server
3479       gestartet hat.</p>
3480     </note>
3481 </usage>
3482 <seealso><a href="../vhosts/">Apache-Dokumentation zu virtuellen
3483   Hosts</a></seealso>
3484 <seealso><a href="../dns-caveats.html">Probleme bez&uuml;glich DNS und
3485     Apache</a></seealso>
3486 <seealso><a href="../bind.html">Bestimmen, welche Adressen und Ports
3487     der Apache verwendet</a></seealso>
3488 <seealso><a href="../sections.html">Wie die Abschnitte &lt;Directory&gt;,
3489     &lt;Location&gt; und &lt;Files&gt; arbeiten</a> f&uuml;r eine
3490     Erl&auml;uterung, wie diese verschiedenen Abschnitte miteinander
3491     kombiniert werden, wenn eine Anfrage empfangen wird</seealso>
3492 </directivesynopsis>
3493
3494 </modulesynopsis>