mpm_common.xml.de

Apache HTTP Server 是一个功能强大的灵活的与HTTP/1.1相兼容的web服务器.这里给出的是Apache HTTP服务器的源码。

    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&uuml;r Applikationen von
    Drittanbietern hilfreich, die direkten Zugriff auf das Scoreboard
    ben&ouml;tigen.</p>

    <p>Wenn Sie eine <directive>ScoreBoardFile</directive>-Anweisung
    verwenden, erreichen Sie eventuell eine h&ouml;here Geschwindigkeit, wenn
    Sie die Datei auf einer RAM-Disk ablegen. Achten Sie darauf, die
    gleichen Warnungen wie &uuml;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&ouml;&szlig;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>leader</module>
<module>mpm_netware</module><module>mpm_winnt</module>
<module>mpmt_os2</module><module>perchild</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Der Server setzt die Gr&ouml;&szlig;e des TCP-Puffers auf die
    angegebene Anzahl Bytes. Dies ist sehr hilfreich, um Voreinstellungen
    alter Standardbetriebssysteme f&uuml;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&uuml;r die konfigurierbare Anzahl von
  Prozessen</description>
<syntax>ServerLimit <var>Anzahl</var></syntax>
<default>F&uuml;r Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>leader</module><module>perchild</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>

<usage>
    <p>Bei dem MPM <module>prefork</module> bestimmt die Direktive
    den w&auml;hrend der Lebensdauer des Apache-Prozesses maximal
    einstellbaren Wert f&uuml;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&uuml;r <directive module="mpm_common">MaxClients</directive>
    f&uuml;r die Lebensdauer des Apache-Prozesses. Jeder Versuch, diese
    Anweisung w&auml;hrend eines Neustarts zu &auml;ndern, wird ignoriert.
    <directive module="mpm_common">MaxClients</directive> kann jedoch
    w&auml;hrend eines Neustarts ge&auml;ndert werden.</p>

    <p>Lassen Sie besondere Vorsicht bei der Verwendung dieser Direktive
    walten. Wenn <directive>ServerLimit</directive> auf einen Wert deutlich
    h&ouml;her als notwendig gesetzt wird, wird zus&auml;tzliches,
    unbenutztes Shared-Memory belegt. Wenn sowohl
    <directive>ServerLimit</directive> als auch <directive
    module="mpm_common">MaxClients</directive> auf Werte gesetzt werden, die
    gr&ouml;&szlig;er sind, als das System sie handhaben kann, dann kann
    der Apache m&ouml;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&uuml;ssen. Setzen Sie den
    Wert nicht h&ouml;her als den Wert, den Sie f&uuml;r <directive
    module="mpm_common">MaxClients</directive> angeben m&ouml;chten.</p>

    <p>Verwenden Sie die Direktive bei <module>worker</module>,
    <module>leader</module> und <module>threadpool</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&ouml;her, als die Anzahl der Serverprozesse,
    die daf&uuml;r erforderlich ist, was Sie bei <directive
    module="mpm_common">MaxClients</directive> und
    <directive module="mpm_common">ThreadsPerChild</directive> angeben
    m&ouml;chten.</p>

    <p>Verwenden Sie die Direktive beim MPM <module>perchild</module> nur,
    wenn Sie <directive module="perchild">NumServers</directive> auf einen
    Wert gr&ouml;&szlig;er als 8 (Voreinstellung) setzen m&uuml;ssen.</p>

    <note><title>Anmerkung</title>
      <p>Eine feste Begrenzung von <code>ServerLimit 20000</code> ist in den
      Server einkompiliert. 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&uuml;r Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>leader</module><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&auml;ngig von der Last
    dynamisch kontrolliert wird, besteht normalerweise wenig
    Grund f&uuml;r eine &Auml;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
    <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&uuml;r Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>mpm_netware</module>
<module>perchild</module></modulelist>

<usage>
    <p>Anzahl der Threads, die beim Start erstellt werden. Da die Anzahl
    der Threads abh&auml;ngig von der Last dynamisch kontrolliert wird,
    besteht normalerweise wenig Grund f&uuml;r eine &Auml;nderung
    dieses Parameters.</p>

    <p>Die Voreinstellung f&uuml;r <module>perchild</module> ist
    <code>StartThreads 5</code>. Die Direktive setzt w&auml;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
    erstellt wird, um Anfragen zu bedienen.</p>

    <p>Die Voreinstellung f&uuml;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&uuml;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>
<compatibility>Verf&uuml;gbar f&uuml;r <module>mpm_winnt</module> ab
  Apache 2.0.41</compatibility>

<usage>
    <p>Die Direktive bestimmt den w&auml;hrend der Lebensdauer des
    Apache-Prozesses maximal einstellbaren Wert f&uuml;r
    <directive module="mpm_common">ThreadsPerChild</directive>. Jeder
    Versuch, diese Direktive w&auml;hrend eines Neustarts zu &auml;ndern,
    wird ignoriert. <directive module="mpm_common">ThreadsPerChild</directive>
    kann jedoch w&auml;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&ouml;her als <directive
    module="mpm_common">ThreadsPerChild</directive> gesetzt wird, wird
    zus&auml;tzliches, ungenutztes Shared-Memory belegt. Wenn sowohl
    <directive>ThreadLimit</directive> als auch <directive
    module="mpm_common">ThreadsPerChild</directive> auf Werte gesetzt werden,
    die gr&ouml;&szlig;er sind, als das System sie handhaben kann, dann kann
    der Apache m&ouml;glicherweise nicht starten oder das System kann
    instabil werden. Setzen Sie den Wert dieser Direktive nicht h&ouml;her
    als Ihre gr&ouml;&szlig;te erwartete Einstellung f&uuml;r
    <directive module="mpm_common">ThreadsPerChild</directive>
    w&auml;hrend der aktuellen Ausf&uuml;hrung des Apache.</p>

    <p>Die Voreinstellung f&uuml;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&uuml;r Details siehe Beschreibung</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>leader</module><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&auml;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&auml;ltigen. Wenn Sie ein MPM
    wie <module>worker</module> verwenden, wo mehrere Kindprozesse
    existieren, dann sollte die <em>Gesamt</em>zahl der Thread gro&szlig;
    genug sein, die &uuml;bliche Last auf dem Server zu bew&auml;ltigen.</p>

    <p>Die Voreinstellung f&uuml;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>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>leader</module><module>perchild</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>
<compatibility>Seit Apache 2.0 nur in der globalen Server-Konfiguration
g&uuml;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&uuml;nglichen Benutzerkennung laufen.
    Wenn Sie den Server als <code>root</code> starten, dann ist es normal,
    dass der Elternprozess als root weiterl&auml;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&uuml;hren,
    dass er in der Lage ist, auf Dateien zuzugreifen, die nicht daf&uuml;r
    bestimmt sind, f&uuml;r die Au&szlig;enwelt sichtbar zu sein.
    Gleicherma&szlig;en sollte der Benutzer nicht in der Lage sein,
    Code auszuf&uuml;hren, der nicht f&uuml;r HTTP-Anfragen bestimmt ist.
    Es wird empfohlen, einen neuen Benutzer und eine neue Gruppe speziell
    zur Ausf&uuml;hrung des Servers zu erstellen. Einige Administratoren
    verwenden den Benutzer <code>nobody</code>. Dies ist jedoch nicht
    immer w&uuml;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>Beim MPM <module>perchild</module>, das daf&uuml;r gedacht ist,
    virtuelle Hosts unter verschiedenen Benutzerkennungen auszuf&uuml;hren,
    bestimmt die Direktive <directive>User</directive> die
    Benutzerkennung f&uuml;r den Hauptserver und bildet den R&uuml;ckfallwert
    f&uuml;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&uuml;tzt. Benutzen Sie <directive
    module="mod_suexec">SuexecUserGroup</directive>, um Ihren Server
    f&uuml;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&auml;chlich eine Leeranweisung und exisitert nur
      aus Kompatibilit&auml;tsgr&uuml;nden.</p>
    </note>
</usage>
</directivesynopsis>

</modulesynopsis>