<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
-<!-- English revision: 1.32 -->
+<!-- English Revision: 151408:1792675 (outdated) -->
<!--
- Copyright 2003-2004 The Apache Software Foundation
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
<syntax>AcceptMutex Default|<var>Methode</var></syntax>
<default>AcceptMutex Default</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>perchild</module>
+<modulelist>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
<syntax>CoreDumpDirectory <var>Verzeichnis</var></syntax>
<default>Für die Voreinstellung siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
-<module>mpm_winnt</module><module>perchild</module><module>prefork</module>
+<modulelist><module>beos</module>
+<module>mpm_winnt</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>
<usage>
<syntax>EnableExceptionHook On|Off</syntax>
<default>EnableExceptionHook Off</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>perchild</module>
+<modulelist>
<module>prefork</module><module>threadpool</module>
<module>worker</module></modulelist>
<compatibility>Verfügbar seit Version 2.0.49</compatibility>
<syntax>Group <var>Unix-Gruppe</var></syntax>
<default>Group #-1</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
-<module>mpmt_os2</module><module>perchild</module><module>prefork</module>
+<modulelist><module>beos</module>
+<module>mpmt_os2</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>
<compatibility>Seit Apache 2.0 nur in der globalen Server-Konfiguration
gültig</compatibility>
<directive module="core" type="section">VirtualHost</directive>
wird nicht länger unterstützt. Benutzen Sie <directive
module="mod_suexec">SuexecUserGroup</directive> um Ihren Server
- für <a href="mod_suexec.html">suexec</a> einzurichten.</p>
+ für <program>suexec</program> einzurichten.</p>
<note><title>Anmerkung</title>
<p>Obwohl die Direktive <directive>Group</directive> in den MPMs
<syntax>PidFile <var>Dateiname</var></syntax>
<default>PidFile logs/httpd.pid</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_winnt</module><module>mpmt_os2</module>
-<module>perchild</module><module>prefork</module>
+<module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>
<usage>
und <a href="../misc/security_tips.html#serverroot">Sicherheit</a>.</p>
<note><title>Anmerkung</title>
- <p>Ab Apache 2 wird empfohlen, nur das Skript <a
- href="../programs/apachectl.html">apachectl</a> zum (Neu-)Starten
- und Stoppen des Servers zu verwenden.</p>
+ <p>Ab Apache 2 wird empfohlen, nur das Skript <program>
+ apachectl</program> zum (Neu-)Starten und Stoppen des Servers zu
+ verwenden.</p>
</note>
</usage>
</directivesynopsis>
<description>IP-Adressen und Ports, an denen der Server lauscht</description>
<syntax>Listen [<var>IP-Addresse</var>:]<var>Port</var></syntax>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpm_winnt</module>
-<module>mpmt_os2</module><module>perchild</module>
+<module>mpmt_os2</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
<compatibility>Seit Apache 2.0 vorgeschrieben</compatibility>
Klammern eingeschlossen werden:</p>
<example>
- Listen [fe80::a00:20ff:fea7:ccea]:80
+ Listen [2001:db8::a00:20ff:fea7:ccea]:80
</example>
+
+ <note><title>Fehlermöglichkeit</title>
+ Mehrere <directive>Listen</directive>-Direktiven für gleiche
+ IP-Adresse und Port führen zur Fehlermeldung
+ <code>Address already in use</code> <transnote>Adresse schon in
+ Benutzung</transnote>.
+ </note>
</usage>
<seealso><a href="../dns-caveats.html">DNS-Probleme</a></seealso>
<seealso><a href="../bind.html">Bestimmen, welche Adressen und Ports der
-Apache verwendet</a></seealso>
+ Apache verwendet</a></seealso>
</directivesynopsis>
<directivesynopsis>
<syntax>ListenBacklog <var>backlog</var></syntax>
<default>ListenBacklog 511</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpm_winnt</module>
-<module>mpmt_os2</module><module>perchild</module><module>prefork</module>
+<module>mpmt_os2</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>
<usage>
<syntax>LockFile <var>Dateiname</var></syntax>
<default>LockFile logs/accept.lock</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>perchild</module>
+<modulelist>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
<syntax>MaxClients <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
<syntax>MaxMemFree <var>KBytes</var></syntax>
<default>MaxMemFree 0</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_netware</module><module>prefork</module>
<module>threadpool</module><module>worker</module><module>mpm_winnt</module></modulelist>
<syntax>MaxRequestsPerChild <var>number</var></syntax>
<default>MaxRequestsPerChild 10000</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>mpm_netware</module>
+<modulelist><module>mpm_netware</module>
<module>mpm_winnt</module><module>mpmt_os2</module>
-<module>perchild</module><module>prefork</module>
+<module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>
<usage>
<syntax>MaxSpareThreads <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpmt_os2</module>
-<module>perchild</module><module>threadpool</module><module>worker</module>
+<module>threadpool</module><module>worker</module>
</modulelist>
<usage>
<p>Maximale Anzahl unbeschäftigter Threads. Die verschiedenen MPMs
behandeln diese Anweisung unterschiedlich.</p>
- <p>Die Voreinstellung für <module>perchild</module> ist
- <code>MaxSpareThreads 10</code>. Das MPM überwacht die Anzahl der
- unbeschäftigten Threads auf der Basis einzelner Kindprozesse. Wenn
- zu viele unbeschäftigte Threads in einem Kindprozess existieren,
- beendet der Server Threads innerhalb dieses Kindprozesses.</p>
-
- <p>Die Voreinstellung für <module>worker</module>,
- <module>leader</module> und <module>threadpool</module> ist
- <code>MaxSpareThreads 250</code>. Diese MPMs behandeln Threads
- auf einer serverweiten Basis. Wenn zu viele unbeschäftigte Threads
- im Server existieren, dann werden solange Kindprozesse beendet, bis
- die Anzahl der unbeschäftigten Threads kleiner als der
- angegebene Wert ist.</p>
-
<p>Die Voreinstellung für <module>mpm_netware</module> ist
<code>MaxSpareThreads 100</code>. Da dieses MPM nur einen einzigen
Prozess ausführt, ist die Zählung überschüssiger
ist eingeschränkt. Apache korrigiert den angegebenen Wert
automatisch gemäß den folgenden Regeln:</p>
<ul>
- <li><module>perchild</module> verlangt, dass <directive
- >MaxSpareThreads</directive> kleiner oder gleich <directive
- module="mpm_common">ThreadLimit</directive> ist.</li>
-
<li><module>mpm_netware</module> verlangt einen Wert größer
als <directive module="mpm_common">MinSpareThreads</directive>.</li>
- <li>Bei <module>leader</module>, <module>threadpool</module> und
+ <li>Bei
<module>worker</module> muss der Wert größer oder gleich
der Summe aus <directive
module="mpm_common">MinSpareThreads</directive> und
<syntax>MinSpareThreads <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpmt_os2</module>
-<module>perchild</module><module>threadpool</module><module>worker</module>
+<module>threadpool</module><module>worker</module>
</modulelist>
<usage>
zu bedienen. Die verschiedenen MPMs behandeln die Anweisung
unterschiedlich.</p>
- <p><module>perchild</module> verwendet die Voreinstellung
- <code>MinSpareThreads 5</code> und überwacht die Anzahl der
- unbeschäftigten Threads auf der Basis einzelner Kindprozesse. Wenn
- in einem Kindprozess nicht genügend unbeschäftigte
- Threads vorhanden sind, erstellt der Server neue Threads innerhalb
- dieses Kindprozesses. Wenn Sie also <directive module="perchild"
- >NumServers</directive> auf <code>10</code> und <directive
- >MinSpareThreads</directive> auf einen Wert von <code>5</code> setzen,
- haben Sie mindestens 50 unbeschäftigte Threads auf Ihrem
- System.</p>
-
- <p><module>worker</module>, <module>leader</module> und
- <module>threadpool</module> verwenden eine Voreinstellung von
+ <p><module>worker</module>
+ verwenden eine Voreinstellung von
<code>MinSpareThreads 75</code> und behandeln unbeschäftigte
Threads auf serverweiter Basis. Wenn nicht genügend
unbeschäftigte Threads im Server vorhanden sind, dann
<syntax>ScoreBoardFile <var>Dateipfad</var></syntax>
<default>ScoreBoardFile logs/apache_status</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
-<module>mpm_winnt</module><module>perchild</module><module>prefork</module>
+<modulelist><module>beos</module>
+<module>mpm_winnt</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>
<usage>
<syntax>SendBufferSize <var>Bytes</var></syntax>
<default>SendBufferSize 0</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>beos</module><module>leader</module>
+<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpm_winnt</module>
-<module>mpmt_os2</module><module>perchild</module><module>prefork</module>
+<module>mpmt_os2</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>
<usage>
<syntax>ServerLimit <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>perchild</module>
+<modulelist>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
module="mpm_common">MaxClients</directive> angeben möchten.</p>
<p>Verwenden Sie die Direktive bei <module>worker</module>,
- <module>leader</module> und <module>threadpool</module> nur, wenn Ihre
+ nur, wenn Ihre
<directive module="mpm_common">MaxClients</directive>- und
<directive module="mpm_common">ThreadsPerChild</directive>-Einstellungen
mehr als 16 Serverprozesse (Voreinstellung) erfordern. Setzen Sie den
<directive module="mpm_common">ThreadsPerChild</directive> angeben
möchten.</p>
- <p>Verwenden Sie die Direktive beim MPM <module>perchild</module> nur,
- wenn Sie <directive module="perchild">NumServers</directive> auf einen
- Wert größer als 8 (Voreinstellung) setzen müssen.</p>
-
<note><title>Anmerkung</title>
<p>Eine feste Begrenzung von <code>ServerLimit 20000</code> ist in den
Server einkompiliert (bei dem MPM <module>prefork</module> 200000).
<syntax>StartServers <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>mpmt_os2</module>
+<modulelist><module>mpmt_os2</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
Grund für eine Änderung dieses Parameters.</p>
<p>Die Voreinstellung unterscheidet sich von MPM zu MPM. Bei
- <module>leader</module>, <module>threadpool</module> und
<module>worker</module> ist die Voreinstellung
<code>StartServers 3</code>. Die Voreinstellung bei
<module>prefork</module> ist <code>5</code> und bei
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>mpm_netware</module>
-<module>perchild</module></modulelist>
+</modulelist>
<usage>
<p>Anzahl der Threads, die beim Start erstellt werden. Da die Anzahl
besteht normalerweise wenig Grund für eine Änderung
dieses Parameters.</p>
- <p>Die Voreinstellung für <module>perchild</module> ist
- <code>StartThreads 5</code>. Die Direktive setzt während des
- Starts die Anzahl der Threads pro Prozess.</p>
-
<p>Die Voreinstellung bei <module>mpm_netware</module> ist
<code>StartThreads 50</code>. Da hier lediglich ein einzelner Prozess
existiert, ist dies die Gesamtzahl der Threads, die beim Start
<syntax>ThreadLimit <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>mpm_winnt</module>
-<module>perchild</module><module>threadpool</module><module>worker</module>
+<modulelist><module>mpm_winnt</module>
+<module>threadpool</module><module>worker</module>
</modulelist>
<compatibility>Verfügbar für <module>mpm_winnt</module> ab
Apache 2.0.41</compatibility>
<syntax>ThreadsPerChild <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>mpm_winnt</module>
+<modulelist><module>mpm_winnt</module>
<module>threadpool</module><module>worker</module></modulelist>
<usage>
</usage>
</directivesynopsis>
+<directivesynopsis>
+<name>ThreadStackSize</name>
+<description>Die Größe des Stacks in Bytes, der von Threads
+verwendet wird, die Client-Verbindungen bearbeiten.</description>
+<syntax>ThreadStackSize <var>size</var></syntax>
+<default>65536 unter NetWare; variiert bei anderen Betriebssystemen.</default>
+<contextlist><context>server config</context></contextlist>
+<modulelist><module>mpm_netware</module>
+<module>mpm_winnt</module>
+<module>threadpool</module><module>worker</module>
+</modulelist>
+<compatibility>Verfügbar seit Version 2.1</compatibility>
+
+<usage>
+ <p>Die Direktive <directive>ThreadStackSize</directive> legt die
+ Größe des Stacks (für Autodaten) der Threads fest, die
+ Client-Verbindungen bearbeiten und Module aufrufen, welche bei der
+ Verarbeitung dieser Verbindungen helfen. In den meisten Fällen ist die
+ Voreinstellung des Betriebssystems angemessen, doch unter bestimmten
+ Umständen kann es sinnvoll sein, den Wert anzupassen:</p>
+
+ <ul>
+ <li>Auf Plattformen mit einer relativ kleinen Voreingestellung für
+ die Größe des Thread-Stacks (z.B. HP-UX) kann der Apache bei
+ der Verwendung einiger Drittanbietermodule, die einen relativ hohen Bedarf
+ an Speicherplatz haben, abstürzen. Ebendiese Module arbeiten
+ möglicherweise problemlos auf anderen Plattformen, wo der
+ voreingestellte Thread-Stack größer ist. Derartige
+ Abstürze können Sie vermeiden, indem Sie
+ <directive>ThreadStackSize</directive> auf einen höheren Wert als die
+ Betriebssystemvoreinstellung setzen. Eine solche Anpassung ist nur
+ notwendig, wenn es vom Anbieter des Moduls so spezifiziert wurde oder die
+ Diagnose eines Apache-Absturzes ergeben hat, das die
+ Thread-Stackgröße zu klein war.</li>
+
+ <li>Auf Plattformen, wo die voreingestellte Thread-Stackgröße
+ für die Webserverkonfiguration deutlich größer als
+ notwendig ist, kann eine größere Anzahl von Threads pro
+ Kindprozess erreicht werden, wenn <directive>ThreadStackSize</directive>
+ auf einen Wert kleiner als die Betriebssystemvoreinstellung gesetzt wird.
+ Da es einzelne Anfragen geben kann, die mehr Stack zur Verarbeitung
+ benötigen, sollte eine derartige Korrektur ausschließlich in
+ Testumgebungen zum Einsatz kommen, auf denen die gesamte
+ Webserververarbeitung ausprobiert werden kann. Eine Änderung der
+ Webserverkonfiguration kann den aktuellen Wert der
+ <directive>ThreadStackSize</directive> ungültig machen.</li>
+ </ul>
+</usage>
+</directivesynopsis>
+
<directivesynopsis>
<name>User</name>
<description>Die Benutzerkennung, unter welcher der Server Anfragen
<syntax>User <var>Unix-User-ID</var></syntax>
<default>User #-1</default>
<contextlist><context>server config</context></contextlist>
-<modulelist><module>leader</module><module>perchild</module>
+<modulelist>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
<compatibility>Seit Apache 2.0 nur in der globalen Server-Konfiguration
sind.</p>
</note>
- <p>Beim MPM <module>perchild</module>, das dafür gedacht ist,
- virtuelle Hosts unter verschiedenen Benutzerkennungen auszuführen,
- bestimmt die Direktive <directive>User</directive> die
- Benutzerkennung für den Hauptserver und bildet den Rückfallwert
- für <directive type="section"
- module="core">VirtualHost</directive>-Abschnitte ohne eine
- <directive module="perchild">AssignUserID</directive>-Anweisung.</p>
-
<p>Wichtiger Hinweis: Die Verwendung dieser Direktive innerhalb von
<directive module="core" type="section">VirtualHost</directive> wird
nicht mehr unterstützt. Benutzen Sie <directive
module="mod_suexec">SuexecUserGroup</directive>, um Ihren Server
- für <a href="../suexec.html">suexec</a> einzurichten.</p>
+ für <program>suexec</program> einzurichten.</p>
<note><title>Anmerkung</title>
<p>Obwohl die Direktive <directive>User</directive> in den MPMs
projects / apache / blobdiff