docs/manual/mod/mpm_common.xml.de

<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>
<!-- English Revision: 151408:1939435 (outdated) -->

<!--
 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

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<modulesynopsis metafile="mpm_common.xml.meta">

<name>mpm_common</name>
<description>Eine Sammlung von Direktiven, die in mehr als einem
  Multi-Processing-Modul (MPM) implementiert sind.</description>
<status>MPM</status>

<directivesynopsis>
<name>AcceptMutex</name>
<description>Vom Apache verwendete Methode zur Serialisierung mehrerer
  Kindprozesse, die Anfragen an Netzwerk-Sockets entgegennehmen.</description>
<syntax>AcceptMutex Default|<var>Methode</var></syntax>
<default>AcceptMutex Default</default>
<contextlist><context>server config</context></contextlist>
<modulelist>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>

<usage>
    <p>Die Direktive <directive>AcceptMutex</directive> bestimmt die
    Methode, die der Apache zur Serialisierung mehrerer Kindprozesse
    verwendet, welche Anfragen an Netzwerk-Sockets entgegennehmen. Vor
    Apache 2.0 war diese Methode nur zur Kompilierungszeit einstellbar.
    Die optimale Methode ist sehr stark von der Architektur und
    Plattform abhängig. Lesen Sie bitte <a
    href="../misc/perf-tuning.html">Perfomance-Hinweise</a> für
    weitere Details.</p>

    <p>Wenn die Direktive auf <code>Default</code> eingestellt ist, dann
    wird die zur Kompilierungszeit gewählte Voreinstellung verwendet.
    Weitere mögliche Methoden sind unten angegeben. Beachten Sie, dass
    nicht alle Methoden auf allen Plattformen verfügbar sind. Wird
    eine Methode angegeben, die nicht verfügbar ist, dann wird
    eine Nachricht in das Fehlerprotokoll geschrieben, welche die
    verfügbaren Methoden auflistet.</p>

    <dl>
      <dt><code>flock</code></dt>
      <dd>verwendet die Systemfunktion <code>flock(2)</code>, um die
      durch die <directive module="mpm_common"
      >LockFile</directive>-Direktive definierte Datei zu sperren.</dd>

      <dt><code>fcntl</code></dt>
      <dd>verwendet die Systemfunktion <code>fcntl(2)</code>, um die
      durch die <directive module="mpm_common"
      >LockFile</directive>-Direktive definierte Datei zu sperren.</dd>

      <dt><code>posixsem</code></dt>
      <dd>verwendet POSIX-kompatible Semaphore, um den Mutex zu
      implementieren.</dd>

      <dt><code>pthread</code></dt>
      <dd>verwendet gemäß der POSIX-Thread-Spezifikation
      implementierte POSIX-Mutexe.</dd>

      <dt><code>sysvsem</code></dt>
      <dd>verwendet Semaphoren des SysV-Typs, um den Mutex zu
      implementieren.</dd>
    </dl>

    <p>Um die bei der Kompilierung gewählte Voreinstellung für
    Ihr System herauszufinden, können Sie Ihr <directive module="core"
    >LogLevel</directive> auf <code>debug</code> setzen. Dann wird der
    voreingestellte <directive>AcceptMutex</directive> ins <directive
    module="core">ErrorLog</directive> geschrieben.</p>

    <note type="warning"><title>Warnung</title>
      <p>Auf den meisten Systemen stoppt der Server mit der Beantwortung von
        Anfragen, wenn die Option <code>pthread</code> ausgewählt wurde und
        ein Kindprozess unkontrolliert endet während er den
        <code>AcceptCntl</code>-Mutex hält. In diesem Fall muss der Server
        manuell neu gestartet werden, um wieder weiter zu arbeiten.</p>
      <p>Eine Ausnahme stellt Solaris dar, da es einen Mechanismus anbietet, den
        der Apache verwendet und der üblicherweise die Freigabe des Mutex
        erlaubt, nachdem ein Kindprozess, der gerade einen Mutex hält,
        abgestürzt ist.</p>
      <p>Wenn Ihr System die Funktion
        <code>pthread_mutexattr_setrobust_np()</code> bereitstellt, können
        Sie wahrscheinlich die Option <code>pthread</code> problemlos
        verwenden.</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>CoreDumpDirectory</name>
<description>Verzeichnis, in das der Apache zu wechseln versucht, bevor er
  einen Hauptspeicherauszug erstellt</description>
<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>mpm_winnt</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Dies beeinflusst das Verzeichnis, in welches der Apache zu wechseln
    versucht, bevor er einen Hauptspeicherauszug <transnote>einen
    so genannten Core-Dump</transnote> erstellt. Die Voreinstellung ist das
    <directive module="core">ServerRoot</directive>-Verzeichnis. Da dieses
    jedoch nicht für den Benutzer beschreibbar sein soll, unter dem
    der Server läuft, werden normalerweise keine
    Hauptspeicherauszüge geschrieben. Wenn Sie zum Debuggen
    einen Hauptspeicherauszug haben möchten, können Sie
    ihn mit dieser Direktive an einem anderen Ort ablegen lassen.</p>

    <note><title>Hauptspeicherauszüge unter Linux</title>
      <p>Wenn Apache als <code>root</code> startet und zu einem anderen Benutzer 
      wechselt, <em>deaktiviert</em> der Linux-Kernel Hauptspeicherauszüge
      auch dann, wenn der Prozess in dem Verzeichnis schreiben darf. Ab Linux
      2.4 reaktiviert Apache (ab 2.0.46) Hauptspeicherauszüge wieder,
      jedoch nur dann, wenn Sie explizit
      <directive>CoreDumpDirectory</directive> konfigurieren.</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>EnableExceptionHook</name>
<description>Aktiviert einen Hook, der nach einem Absturz noch
Ausnahmefehler behandeln lassen kann</description>
<syntax>EnableExceptionHook On|Off</syntax>
<default>EnableExceptionHook Off</default>
<contextlist><context>server config</context></contextlist>
<modulelist>
<module>prefork</module><module>threadpool</module>
<module>worker</module></modulelist>
<compatibility>Verfügbar seit Version 2.0.49</compatibility>

<usage>
    <p>Diese Direktive ist aus Sicherheitsgründen nur verfügbar,
    wenn der Server mit der Option <code>--enable-exception-hook</code>
    konfiguriert wurde. Sie aktiviert einen Hook, der es externen Modulen
    erlaubt, sich dort einzuhängen und nach dem Absturz eines
    Kindprozesses noch Aktionen durchzuführen.</p>

    <p>Es existieren bereits zwei Module, <code>mod_whatkilledus</code> und
    <code>mod_backtrace</code>, welche diesen Hook verwenden. Weitere
    Informationen hierzu finden Sie auf Jeff Trawicks <a
    href="http://www.apache.org/~trawick/exception_hook.html"
    >EnableExceptionHook-Seite</a>.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>Group</name>
<description>Benutzergruppe, unter welcher der Server Anfragen
  beantwortet</description>
<syntax>Group <var>Unix-Gruppe</var></syntax>
<default>Group #-1</default>
<contextlist><context>server config</context></contextlist>
<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>

<usage>
    <p>Die Direktive <directive>Group</directive> bestimmt die
    Benutzergruppe, unter welcher der Server Anfragen beantwortet.
    Um diese Direktive zu verwenden, muss der Server als <code>root</code> gestartet
    werden. Wenn Sie den Server unter einem nicht-root-Benutzer starten,
    wird er nicht zur angegebenen Gruppe wechseln können und statt
    dessen weiter mit der Gruppe des ursprünglichen Benutzers
    laufen. <var>Unix-Gruppe</var> kann sein:</p>

    <dl>
      <dt>Ein Gruppenname</dt>
      <dd>Verweist auf die durch den Namen angegebene Gruppe.</dd>

      <dt><code>#</code> gefolgt von einer Gruppennummer.</dt>
      <dd>Verweist auf die durch ihre Nummer angegebene Gruppe.</dd>
    </dl>

    <example><title>Beispiel</title>
      Group www-group
    </example>

    <p>Es wird empfohlen, dass Sie eine neue Gruppe speziell zum Betrieb
    des Servers erstellen. Einige Administratoren verwenden den Benutzer
    <code>nobody</code>. Dies ist jedoch nicht immer möglich
    oder gewünscht.</p>

    <note type="warning"><title>Sicherheit</title>
      <p>Setzen Sie <directive>Group</directive> (oder <directive
      module="mpm_common">User</directive>) nicht auf <code>root</code>,
      solange Sie nicht ganz genau wissen, was Sie tun und welche Gefahren
      Sie eingehen.</p>
    </note>

    <p>Wichtiger Hinweis: Die Verwendung der Direktive innerhalb von
    <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 <program>suexec</program> einzurichten.</p>

    <note><title>Anmerkung</title>
      <p>Obwohl die Direktive <directive>Group</directive> in den MPMs
      <module>beos</module> und <module>mpmt_os2</module> existiert, ist
      sie dort tatsächlich eine Leeranweisung und exisitert nur
      aus Kompatibilitätsgründen.</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>PidFile</name>
<description>Datei, in welcher der Server die Prozess-ID des Daemons
ablegt</description>
<syntax>PidFile <var>Dateiname</var></syntax>
<default>PidFile logs/httpd.pid</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module>
<module>mpm_winnt</module><module>mpmt_os2</module>
<module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Die Direktive <directive>PidFile</directive> bestimmt die Datei,
    in welcher der Server die Prozess-ID des Daemons ablegt. Wenn der
    Dateiname nicht absolut angegeben wird, wird er relativ zu
    <directive module="core">ServerRoot</directive> interpretiert.</p>

    <example><title>Beispiel</title>
      PidFile /var/run/apache.pid
    </example>

    <p>Es ist oft hilfreich, dem Server ein Signal senden zu können,
    damit er seine <directive module="core">ErrorLog</directive>s und
    <directive module="mod_log_config">TransferLog</directive>s
    schließt und dann neu öffnet und seine
    Konfigurationsdateien neu einliest. Dies kann durch Senden eines
    SIGHUP-Signals (kill -1) an die Prozess-ID geschehen, die im
    <directive>PidFile</directive> eingetragen ist.</p>

    <p>Die <directive>PidFile</directive>-Datei unterliegt den
    gleichen Warnungen über die Ablage von Protokolldateien
    und <a href="../misc/security_tips.html#serverroot">Sicherheit</a>.</p>

    <note><title>Anmerkung</title>
      <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>

<directivesynopsis>
<name>Listen</name>
<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>mpm_netware</module><module>mpm_winnt</module>
<module>mpmt_os2</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
<compatibility>Seit Apache 2.0 vorgeschrieben</compatibility>

<usage>
    <p>Die Direktive <directive>Listen</directive> weist den Apache an,
    nur an den angegebenen IP-Adressen oder Ports zu lauschen.
    Standardmäßig antwortet er auf alle Anfragen an allen
    IP-Interfaces. <directive>Listen</directive> ist nun eine notwendige
    Anweisung. Wenn sie nicht in der Konfigurationsdatei enthalten ist,
    wird der Server-Start fehlschlagen. Dies ist eine Änderung
    gegenüber früheren Versionen des Apache.</p>

    <p>Die Direktive <directive>Listen</directive> weist den Server an,
    ankommende Anfragen am angegebenen Port oder der
    Kombination aus Adresse und Port entgegenzunehmen. Wenn nur eine Portnummer
    angegeben ist, dann lauscht der Server am angegebenen Port an allen
    Interfaces. Wenn sowohl eine IP-Adresse als auch ein Port angegeben
    sind, dann lauscht der Server am angegeben Port und Interface.</p>

    <p>Es können mehrere <directive>Listen</directive>-Anweisungen
    verwendet werden, um eine Reihe von Adressen und Port anzugeben, an
    denen gelauscht werden soll. Der Server antwortet auf Anfragen von
    jedem der aufgeführten Adressen und Ports.</p>

    <p>Um beispielsweise den Server Verbindungen an den beiden Ports 80 und
    8000 annehmen zu lassen, verwenden Sie:</p>

    <example>
      Listen 80<br />
      Listen 8000
    </example>

    <p>Um den Server Verbindungen an zwei angegebenen Interfaces und Ports
    annehmen zu lassen, verwenden Sie:</p>

    <example>
      Listen 192.170.2.1:80<br />
      Listen 192.170.2.5:8000
    </example>

    <p>IPv6-Adressen müssen wie in dem folgenden Beispiel in eckige
    Klammern eingeschlossen werden:</p>

    <example>
      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>
</directivesynopsis>

<directivesynopsis>
<name>ListenBackLog</name>
<description>Maximale Länge der Warteschlange schwebender
  Verbindungen</description>
<syntax>ListenBacklog <var>backlog</var></syntax>
<default>ListenBacklog 511</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpm_winnt</module>
<module>mpmt_os2</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Die maximale Länge der Warteschlange schwebender Verbindungen.
    Üblicherweise ist keine Feineinstellung notwendig oder sinnvoll,
    auf einigen System kann es jedoch gewünscht sein, diesen Wert bei
    TCP-SYN-Angriffen zu erhöhen. Beachten Sie auch die Beschreibung des
    backlog-Parameters der Systemfunktion <code>listen(2)</code>.</p>

    <p>Der Wert wird vom Betriebssystem oft auf eine niedrigere
    Einstellung begrenzt. Dies variiert von Betriebssystem zu Betriebssystem.
    Beachten Sie auch, dass viele Betriebssyteme nicht genau beachten,
    was für backlog angegeben ist, jedoch einen Wert basierend auf der
    Angabe (normalerweiseweise jedoch größer als diese) verwenden.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>LockFile</name>
<description>Ablageort der Lock-Datei für die Serialisierung von
entgegengenommenen Anfragen</description>
<syntax>LockFile <var>Dateiname</var></syntax>
<default>LockFile logs/accept.lock</default>
<contextlist><context>server config</context></contextlist>
<modulelist>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>

<usage>
    <p>Die Direktive <directive>LockFile</directive> legt den Pfad zur
    Lock-Datei fest, die verwendet wird, wenn der Apache mit einer der
    <directive module="mpm_common">AcceptMutex</directive>-Einstellungen
    <code>fcntl</code> oder <code>flock</code> verwendet wird. Die Anweisung
    sollte normalerweise bei der Voreinstellung belassen werden.
    Der Hauptgrund, sie zu ändern, ist, wenn das
    <code>logs</code>-Verzeichnis auf einem per NFS-eingebundenen Laufwerk
    liegt, da <strong>die Lock-Datei auf einer lokalen Platte abgelegt sein
    muss</strong>. Die PID <transnote>Prozess-ID</transnote> des
    Hauptserverprozesses wird automatisch an den Dateinamen angehängt.</p>

    <note type="warning"><title>Sicherheit</title>
      <p>Es ist am besten, die Ablage in einem allgemein <transnote>für
      jedermann</transnote> beschreibbaren
      Verzeichnis wie <code>/var/tmp</code> <em>zu vermeiden</em>, da
      ein Denial-of-Servide-Angriff gestartet werden könnte und der
      Server am Start gehindert werden könnte, indem eine Lock-Datei
      mit dem gleichen Namen erstellt wird, wie der Server sie zu erstellen
      versuchen würde.</p>
    </note>
</usage>
<seealso><directive module="mpm_common">AcceptMutex</directive></seealso>
</directivesynopsis>

<directivesynopsis>
<name>MaxClients</name>
<description>Maximale Anzahl der Kindprozesse, die zur Bedienung von Anfragen
  gestartet wird</description>
<syntax>MaxClients <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>

<usage>
    <p>Die Direktive <directive>MaxClients</directive> setzt die Grenze
    für die Anzahl gleichzeitig bedienter Anfragen. Jeder
    Verbindungsversuch oberhalb der <directive
    >MaxClients</directive>-Begrenzung wird üblicherweise in eine
    Warteschlange gestellt, bis zu einer Anzahl basierend auf der
    <directive module="mpm_common">ListenBacklog</directive>-Anweisung.
    Sobald ein Kindprozess am Ende einer anderen Anfrage freigegeben wird,
    wird die Verbindung bedient.</p>

    <p>Für Server ohne Thread-Unterstützung (<em>z.B.</em>
    <module>prefork</module>) wird <directive>MaxClients</directive> als
    maximale Anzahl der Kindprozesse verstanden, die zur Bedienung von
    Anfragen gestartet werden. Die Voreinstellung ist <code>256</code>. Um
    diesen Wert zu erhöhen, muss auch <directive
    module="mpm_common">ServerLimit</directive> angehoben werden.</p>

    <p>Bei Servern mit Thread-Unterstützung und bei Hybrid-Servern
    (<em>z.B.</em> <module>beos</module> oder <module>worker</module>)
    begrenzt <directive>MaxClients</directive> die Gesamtzahl der Threads,
    die für die Bedienung von Anfragen verfügbar sind.
    Die Voreinstellung für <module>beos</module> ist <code>50</code>.
    Bei Hybrid-MPMs ist die Voreinstellung <code>16</code> (<directive
    module="mpm_common">ServerLimit</directive>) multipliziert mit
    dem Wert <code>25</code> (<directive module="mpm_common"
    >ThreadsPerChild</directive>). Um <directive>MaxClients</directive>
    auf einen Wert zu erhöhen, der mehr als 16 Prozesse erfordert,
    müssen Sie daher auch <directive module="mpm_common"
    >ServerLimit</directive> anheben.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>MaxMemFree</name>
<description>Maximale Menge des Arbeitsspeichers, den die
  Haupt-Zuteilungsroutine verwalten darf, ohne <code>free()</code>
  aufzurufen</description>
<syntax>MaxMemFree <var>KBytes</var></syntax>
<default>MaxMemFree 0</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module>
<module>mpm_netware</module><module>prefork</module>
<module>threadpool</module><module>worker</module><module>mpm_winnt</module></modulelist>

<usage>
    <p>Die Direktive <directive>MaxMemFree</directive> gibt die maximale
    Menge freier Kilobytes an, welche die Haupt-Zuteilungsroutine verwalten
    darf, ohne <code>free()</code> aufzurufen. Wenn keine Angabe gemacht wird,
    oder Null angegeben ist, wird dieser Wert nicht eingeschränkt.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>MaxRequestsPerChild</name>
<description>Obergrenze für die Anzahl von Anfragen, die ein einzelner
  Kindprozess während seines Lebens bearbeitet</description>
<syntax>MaxRequestsPerChild <var>number</var></syntax>
<default>MaxRequestsPerChild 10000</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>mpm_netware</module>
<module>mpm_winnt</module><module>mpmt_os2</module>
<module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Die Direktive <directive>MaxRequestsPerChild</directive> legt die
    Grenze für die Anzahl von Anfragen fest, die ein einzelner
    Kinprozess während seines Lebens bearbeitet. Nach
    <directive>MaxRequestsPerChild</directive> Anfragen stirbt der
    Kindprozess. Wenn <directive>MaxRequestsPerChild</directive>
    <code>0</code> ist, endet der Prozess niemals.</p>

    <note><title>Abweichende Voreinstellungen</title>
      <p>Die Voreinstellung für <module>mpm_netware</module> und
      <module>mpm_winnt</module> ist <code>0</code>.</p>
    </note>

    <p>Die Begrenzung von <directive>MaxRequestsPerChild</directive> auf einen
    Wert ungleich Null hat zwei vorteilhafte Auswirkungen:</p>

    <ul>
      <li>sie begrenzt die Menge an Arbeitsspeicher, die ein Prozess
      durch (versehentliche) Speicherlecks verbrauchen kann.</li>

      <li>das Festlegen einer endlichen Lebensdauer von Prozessen hilft, die
      Anzahl von Prozessen zu reduzieren, wenn die Serverlast
      zurückgeht.</li>
    </ul>

    <note><title>Anmerkung</title>
      <p>Bei <directive module="core">KeepAlive</directive>-Anfragen
      wird nur die erste Anfrage für diese begrenzung gezählt.
      Eigentlich wird nur die Begrenzung für die Anzahl der
      <em>Verbindungen</em> pro Kindprozess geändert.</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>MaxSpareThreads</name>
<description>Maximale Anzahl unbeschäftigter Threads</description>
<syntax>MaxSpareThreads <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpmt_os2</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>mpm_netware</module> ist
    <code>MaxSpareThreads 100</code>. Da dieses MPM nur einen einzigen
    Prozess ausführt, ist die Zählung überschüssiger
    Threads ebenfalls serverweit.</p>

    <p><module>beos</module> and <module>mpmt_os2</module> arbeiten
    ähnlich wie <module>mpm_netware</module>. Die Voreinstellung
    für <module>beos</module> ist <code>MaxSpareThreads 50</code>.
    Die Voreinstellung für <module>mpmt_os2</module> ist
    <code>10</code>.</p>

    <note><title>Restriktionen</title>
      <p>Der Wertebereich von <directive>MaxSpareThreads</directive>
      ist eingeschränkt. Apache korrigiert den angegebenen Wert
      automatisch gemäß den folgenden Regeln:</p>
      <ul>
        <li><module>mpm_netware</module> verlangt einen Wert größer
        als <directive module="mpm_common">MinSpareThreads</directive>.</li>

        <li>Bei
        <module>worker</module> muss der Wert größer oder gleich
        der Summe aus <directive
        module="mpm_common">MinSpareThreads</directive> und
        <directive module="mpm_common">ThreadsPerChild</directive> sein.</li>
      </ul>
    </note>
</usage>
<seealso><directive module="mpm_common">MinSpareThreads</directive></seealso>
<seealso><directive module="mpm_common">StartServers</directive></seealso>
</directivesynopsis>

<directivesynopsis>
<name>MinSpareThreads</name>
<description>Minimale Anzahl unbeschäftigter Threads, die zur
  Bedienung von Anfragespitzen zur Verfügung stehen</description>
<syntax>MinSpareThreads <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpmt_os2</module>
<module>threadpool</module><module>worker</module>
</modulelist>

<usage>
    <p>Minimale Anzahl unbeschäftigter Threads, um Anfragespitzen
    zu bedienen. Die verschiedenen MPMs behandeln die Anweisung
    unterschiedlich.</p>

    <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
    werden solange Kindprozesse erzeugt, bis die Anzahl unbeschäftigter
    Threads größer als der angegebene Wert ist.</p>

    <p><module>mpm_netware</module> verwendet die Voreinstellung
    <code>MinSpareThreads 10</code> und verfolgt dies serverweit, da
    es ein Einzelprozess-MPM ist.</p>

    <p><module>beos</module> und <module>mpmt_os2</module> arbeiten
    ähnlich wie <module>mpm_netware</module>. Die Voreinstellung
    für <module>beos</module> ist <code>MinSpareThreads 1</code>.
    Die Voreinstellung für <module>mpmt_os2</module> ist
    <code>5</code>.</p>

</usage>
<seealso><directive module="mpm_common">MaxSpareThreads</directive></seealso>
<seealso><directive module="mpm_common">StartServers</directive></seealso>
</directivesynopsis>

<directivesynopsis>
<name>ScoreBoardFile</name>
<description>Ablageort der Datei, die zur Speicherung von Daten zur
  Koordinierung der Kindprozesse verwendet wird</description>
<syntax>ScoreBoardFile <var>Dateipfad</var></syntax>
<default>ScoreBoardFile logs/apache_status</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module>
<module>mpm_winnt</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Apache verwendet ein Scoreboard zur Kommunikation zwischen
    seinen Eltern- und Kindprozessen. Einige Architekturen erfordern
    eine Datei zur Unterstützung der Kommunikation. Wenn die Datei
    undefiniert bleibt, versucht der Apache zuerst, das Scoreboard im
    Arbeitsspeicher  zu erstellen (Verwendung von anonymem Shared-Memory),
    und versucht bei einem Fehlschlag anschließend die Datei auf
    der Festplatte zu erstellen (Verwendung von Datei-basiertem
    Shared-Memory). Die Angabe dieser Direktive veranlaßt den
    Apache stets, die Datei auf der Festplatte zu erstellen.</p>

    <example><title>Beispiel</title>
      ScoreBoardFile /var/run/apache_status
    </example>

    <p>Datei-basiertes Shared-Memory ist für Applikationen von
    Drittanbietern hilfreich, die direkten Zugriff auf das Scoreboard
    benötigen.</p>

    <p>Wenn Sie eine <directive>ScoreBoardFile</directive>-Anweisung
    verwenden, erreichen Sie eventuell eine höhere Geschwindigkeit, wenn
    Sie die Datei auf einer RAM-Disk ablegen. Achten Sie darauf, die
    gleichen Warnungen wie über die Ablage von Protokolldateien und
    <a href="../misc/security_tips.html">Sicherheit</a> zu beherzigen.</p>
</usage>
<seealso><a href="../stopping.html">Apache beenden und neu
  starten</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>SendBufferSize</name>
<description>Größe des TCP-Puffers</description>
<syntax>SendBufferSize <var>Bytes</var></syntax>
<default>SendBufferSize 0</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module>
<module>mpm_netware</module><module>mpm_winnt</module>
<module>mpmt_os2</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Der Server setzt die Größe des TCP-Puffers auf die
    angegebene Anzahl Bytes. Dies ist sehr hilfreich, um Voreinstellungen
    alter Standardbetriebssysteme für Hochgeschwindigkeitsverbindungen
    mit hoher Latenzzeit anzuheben (<em>d.h.</em> 100ms oder so, wie bei
    Interkontinentalverbindungen).</p>

    <p>Wird der Wert auf <code>0</code> gesetzt, dann verwendet der Server
    die Voreinstellung des Betriebssystems.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ServerLimit</name>
<description>Obergrenze für die konfigurierbare Anzahl von
  Prozessen</description>
<syntax>ServerLimit <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>

<usage>
    <p>Bei dem MPM <module>prefork</module> bestimmt die Direktive
    den während der Lebensdauer des Apache-Prozesses maximal
    einstellbaren Wert für <directive
    module="mpm_common">MaxClients</directive>. Beim MPM
    <module>worker</module> bestimmt die Direktive in Verbindung mit
    <directive module="mpm_common">ThreadLimit</directive> den Maximalwert
    für <directive module="mpm_common">MaxClients</directive>
    für die Lebensdauer des Apache-Prozesses. Jeder Versuch, diese
    Anweisung während eines Neustarts zu ändern, wird ignoriert.
    <directive module="mpm_common">MaxClients</directive> kann jedoch
    während eines Neustarts geändert werden.</p>

    <p>Lassen Sie besondere Vorsicht bei der Verwendung dieser Direktive
    walten. Wenn <directive>ServerLimit</directive> auf einen Wert deutlich
    höher als notwendig gesetzt wird, wird zusätzliches,
    unbenutztes Shared-Memory belegt. Wenn sowohl
    <directive>ServerLimit</directive> als auch <directive
    module="mpm_common">MaxClients</directive> auf Werte gesetzt werden, die
    größer sind, als das System sie handhaben kann, dann kann
    der Apache möglicherweise nicht starten, oder das System kann
    instabil werden.</p>

    <p>Verwenden Sie die Direktive bei dem MPM <module>prefork</module>
    nur, wenn Sie <directive module="mpm_common">MaxClients</directive>
    auf mehr als 256 (Voreinstellung) setzen müssen. Setzen Sie den
    Wert nicht höher als den Wert, den Sie für <directive
    module="mpm_common">MaxClients</directive> angeben möchten.</p>

    <p>Verwenden Sie die Direktive bei <module>worker</module>,
    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
    Wert dieser Direktive nicht höher, als die Anzahl der Serverprozesse,
    die dafür erforderlich ist, was Sie bei <directive
    module="mpm_common">MaxClients</directive> und
    <directive module="mpm_common">ThreadsPerChild</directive> angeben
    möchten.</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).
      Dies soll unangenehme Effekte durch Tippfehler verhindern.</p>
    </note>
</usage>
<seealso><a href="../stopping.html">Apache beenden und neu
  starten</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>StartServers</name>
<description>Anzahl der Kindprozesse des Servers, die beim Start erstellt
  werden</description>
<syntax>StartServers <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>mpmt_os2</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>

<usage>
    <p>Die Direktive <directive>StartServers</directive> bestimmt
    die Anzahl der Kindprozesse des Servers, die beim Start erstellt
    werden. Da die Anzahl der Prozesse abhängig von der Last
    dynamisch kontrolliert wird, besteht normalerweise wenig
    Grund für eine Änderung dieses Parameters.</p>

    <p>Die Voreinstellung unterscheidet sich von MPM zu MPM. Bei
    <module>worker</module> ist die Voreinstellung
    <code>StartServers 3</code>. Die Voreinstellung bei
    <module>prefork</module> ist <code>5</code> und bei
    <module>mpmt_os2</module> <code>2</code>.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>StartThreads</name>
<description>Anzahl der Threads, die beim Start erstellt werden</description>
<syntax>StartThreads <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>mpm_netware</module>
</modulelist>

<usage>
    <p>Anzahl der Threads, die beim Start erstellt werden. Da die Anzahl
    der Threads abhängig von der Last dynamisch kontrolliert wird,
    besteht normalerweise wenig Grund für eine Änderung
    dieses Parameters.</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
    erstellt wird, um Anfragen zu bedienen.</p>

    <p>Die Voreinstellung für <module>beos</module> ist <code>StartThreads
    10</code>. Die Einstellung reflektiert ebenfalls die Gesamtzahl der Threads, die
    beim Start erstellt werden, um Anfragen zu bedienen.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ThreadLimit</name>
<description>Bestimmt die Obergrenze der konfigurierbaren Anzahl von Threads
  pro Kindprozess</description>
<syntax>ThreadLimit <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<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>

<usage>
    <p>Die Direktive bestimmt den während der Lebensdauer des
    Apache-Prozesses maximal einstellbaren Wert für
    <directive module="mpm_common">ThreadsPerChild</directive>. Jeder
    Versuch, diese Direktive während eines Neustarts zu ändern,
    wird ignoriert. <directive module="mpm_common">ThreadsPerChild</directive>
    kann jedoch während eines Neustarts modifiziert werden bis zu dem
    Wert dieser Anweisung.</p>

    <p>Lassen Sie besondere Vorsicht bei der Verwendung dieser Direktive
    walten. Wenn <directive>ThreadLimit</directive> auf einen Wert
    deutlich höher als <directive
    module="mpm_common">ThreadsPerChild</directive> gesetzt wird, wird
    zusätzliches, ungenutztes Shared-Memory belegt. Wenn sowohl
    <directive>ThreadLimit</directive> als auch <directive
    module="mpm_common">ThreadsPerChild</directive> auf Werte gesetzt werden,
    die größer sind, als das System sie handhaben kann, dann kann
    der Apache möglicherweise nicht starten oder das System kann
    instabil werden. Setzen Sie den Wert dieser Direktive nicht höher
    als Ihre größte erwartete Einstellung für
    <directive module="mpm_common">ThreadsPerChild</directive>
    während der aktuellen Ausführung des Apache.</p>

    <p>Die Voreinstellung für <directive>ThreadLimit</directive> ist
    <code>1920</code> wenn sie zusammen mit <module>mpm_winnt</module>
    verwendet wird, und <code>64</code> bei der Verwendung mit anderen
    MPMs.</p>

    <note><title>Anmerkung</title>
      <p>Eine feste Begrenzung von <code>ThreadLimit 20000</code>
      (oder <code>ThreadLimit 15000</code> bei <module>mpm_winnt</module>)
      ist in den Server einkompiliert. Dies soll unangenehme Effekte durch
      Tippfehler verhindern.</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>ThreadsPerChild</name>
<description>Anzahl der Threads, die mit jedem Kindprozess gestartet
  werden</description>
<syntax>ThreadsPerChild <var>Anzahl</var></syntax>
<default>Für Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>mpm_winnt</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Die Direktive legt die Anzahl der Threads fest, die mit jedem
    Kindprozess gestartet werden. Der Kindprozess erstellt diese Threads
    beim Start und erstellt später keine weiteren mehr. Wenn Sie ein
    MPM wie <module>mpm_winnt</module> verwenden, wo nur ein
    Kindprozess existiert, dann sollte diese Angabe hoch genug sein,
    die gesamte Last des Servers zu bewältigen. Wenn Sie ein MPM
    wie <module>worker</module> verwenden, wo mehrere Kindprozesse
    existieren, dann sollte die <em>Gesamt</em>zahl der Thread groß
    genug sein, die übliche Last auf dem Server zu bewältigen.</p>

    <p>Die Voreinstellung für <directive>ThreadsPerChild</directive> ist
    <code>64</code>, wenn <module>mpm_winnt</module> verwendet wird, und
    <code>25</code> bei der Verwendung der anderen MPMs.</p>
</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
  beantwortet</description>
<syntax>User <var>Unix-User-ID</var></syntax>
<default>User #-1</default>
<contextlist><context>server config</context></contextlist>
<modulelist>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
<compatibility>Seit Apache 2.0 nur in der globalen Server-Konfiguration
gültig</compatibility>

<usage>
    <p>Die Direktive <directive>User</directive> legt die Benutzerkennung
    fest, mit der der Server Anfragen beantwortet. Um diese Anweisung
    zu verwenden, muss der Server als <code>root</code> gestartet werden.
    Wenn Sie den Server unter einem nicht-root-Benutzer starten, kann
    er nicht zu dem minder privilegierten Benutzer wechseln und wird statt
    dessen weiter mit der ursprünglichen Benutzerkennung laufen.
    Wenn Sie den Server als <code>root</code> starten, dann ist es normal,
    dass der Elternprozess als root weiterläuft.
    <var>Unix-User-ID</var> kann sein:</p>

    <dl>
      <dt>Ein Benutzername</dt>
      <dd>Verweist auf den durch Namen angegebenen Benutzer.</dd>

      <dt># gefolgt von einer Benutzernummer.</dt>
      <dd>Verweist auf einen durch eine Nummer angegebenen Benutzer.</dd>
    </dl>

    <p>Der Benutzer sollte keine Rechte besitzen, die dazu führen,
    dass er in der Lage ist, auf Dateien zuzugreifen, die nicht dafür
    bestimmt sind, für die Außenwelt sichtbar zu sein.
    Gleichermaßen sollte der Benutzer nicht in der Lage sein,
    Code auszuführen, der nicht für HTTP-Anfragen bestimmt ist.
    Es wird empfohlen, einen neuen Benutzer und eine neue Gruppe speziell
    zur Ausführung des Servers zu erstellen. Einige Administratoren
    verwenden den Benutzer <code>nobody</code>. Dies ist jedoch nicht
    immer wünschenswert, da der Benuter <code>nobody</code> andere
    Rechte auf dem System besitzen kann.</p>

    <note type="warning"><title>Sicherheit</title>
      <p>Setzen Sie <directive>User</directive> (oder <directive
      module="mpm_common">Group</directive>) nicht auf <code>root</code>,
      solange Sie nicht genau wissen, was Sie tun, und welches die Gefahren
      sind.</p>
    </note>

    <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 <program>suexec</program> einzurichten.</p>

    <note><title>Anmerkung</title>
      <p>Obwohl die Direktive <directive>User</directive> in den MPMs
      <module>beos</module> und <module>mpmt_os2</module> existiert, ist
      sie dort tatsächlich eine Leeranweisung und exisitert nur
      aus Kompatibilitätsgründen.</p>
    </note>
</usage>
</directivesynopsis>

</modulesynopsis>