mpm_common.xml.es

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

<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.es.xsl"?>
<!-- English Revision: 151405 -->

<!--
 Copyright 2005 The Apache Software Foundation or it licensors,
                as applicable.

 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

     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>Es una colecci&#243;n de directivas que est&#225;n implementadas
en m&#225;s de un m&#243;dulo de multiprocesamiento (MPM)</description>
<status>MPM</status>

<directivesynopsis>
<name>AcceptMutex</name>
<description>M&#233;todo que usa Apache para serializar m&#250;ltiples procesos
hijo que aceptan peticiones en las conexiones de red</description>
<syntax>AcceptMutex Default|<var>method</var></syntax>
<default>AcceptMutex Default</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>Las directivas <directive>AcceptMutex</directive> determinan el
    m&#233;todo que usa Apache para serializar m&#250;ltiples procesos
    hijo que aceptan peticiones en las conexiones de red. En las
    versiones de Apache anteriores a la 2.0, el m&#233;todo era
    seleccionable solo cuando se compilaba el servidor. El mejor
    m&#233;todo a usar depende mucho de la arquitectura y de la
    plataforma que use. Si desea m&#225;s informaci&#243;n, consulte
    la documentanci&#243;n sobre <a
    href="../misc/perf-tuning.html">ajustes para conseguir un mejor
    rendimiento</a>.</p>

    <p>Si el valor especificado en esta directiva es
    <code>Default</code>, entonces se usar&#225; el m&#233;todo
    seleccionado cuando se compil&#243; el servidor. M&#225;s abajo
    puede encontrar una lista con otros m&#233;todos. Tenga en cuenta
    que no todos los m&#233;todos est&#225;n disponibles en todas las
    plataformas. Si el m&#233;todo especificado no est&#225;
    disponible, se escribir&#225; un mensaje en el log de errores con
    una lista de los m&#233;todos que puede usar.</p>

    <dl>
      <dt><code>flock</code></dt> <dd>usa la llamada al sistema
      <code>flock(2)</code> para bloquear el fichero especificado en
      la directiva <directive module="mpm_common"
      >LockFile</directive>.</dd>

      <dt><code>fcntl</code></dt> <dd>usa la llamada al sistema
      <code>fcntl(2)</code> para bloquear el fichero especificado en
      la directiva <directive module="mpm_common"
      >LockFile</directive>.</dd>

      <dt><code>posixsem</code></dt> <dd>usa sem&#225;foros
      compatibles con POSIX para implementar el mutex.</dd>

      <dt><code>pthread</code></dt>
      <dd>Usa mutexes POSIX implementados seg&#250;n la
      especificaci&#243;n de hebras POSIX (PThreads).</dd>

      <dt><code>sysvsem</code></dt>
      <dd>usa sem&#225;foros de tipo SySV para implementar el mutex.</dd>
    </dl>

    <p>Si quiere ver cu&#225;l es el m&#233;todo por defecto que se
    seleccion&#243; para usar en su sistema al compilar, especifique
    el valor <code>debug</code> en la directiva <directive
    module="core">LogLevel</directive>. El valor por defecto de la
    directiva <directive >AcceptMutex</directive> aparecer&#225;
    escrito en el <directive module="core">ErrorLog</directive>.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>BS2000Account</name>
<description>Define la cuenta sin privilegios en m&#225;quinas
BS2000</description>
<syntax>BS2000Account <var>account</var></syntax>
<contextlist><context>server config</context></contextlist>
<modulelist><module>perchild</module><module>prefork</module></modulelist>
<compatibility>Solo disponible en m&#225;quinas BS2000</compatibility>

<usage>
    <p>La directiva <directive>BS2000Account</directive> est&#225;
    disponible solo en hosts BS2000. Debe usarse para definir el
    n&#250;mero de cuenta del usuario sin privilegios del servidor
    Apache (que se configur&#243; usando la directiva <directive
    module="mpm_common">User</directive>). Esto es un requerimiento
    del subsistema POSIX BS2000 (@@@@@ para reemplazar el entorno de
    tareas BS2000 subyaciente haciendo un sub-LOGON) para prevenir que
    scripts CGI accedan a recursos de la cuenta con privilegios con la
    que se suele iniciar el servidor, normalmente
    <code>SYSROOT</code>.</p>

    <note><title>Nota</title> 
      <p>La directiva
      <code>BS2000Account</code> solamente puede usarse una vez.</p>
    </note>
</usage>
<seealso><a href="../platform/ebcdic.html">Apache EBCDIC port</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>CoreDumpDirectory</name>
<description>Directorio al que Apache intenta cambiarse antes de
realizar un volcado de memoria</description>
<syntax>CoreDumpDirectory <var>directory</var></syntax>
<default>Consulte la secci&#243;n de uso para ver el valor por defecto</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>leader</module>
<module>mpm_winnt</module><module>perchild</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>Esta directiva controla el directorio al cual intenta cambiarse
    Apache antes de realizar un volcado de memoria. Por defecto, el
    volcado de memoria se hace en el directorio especificado en la
    directiva <directive module="core">ServerRoot</directive>, sin
    embargo, como el usuario con el que se est&#225; ejecutando Apache
    podr&#237;a no tener permisos para escribir en ese directorio, los
    volcados de memoria muchas veces no se hacen en ning&#250;n
    sitio. Si quiere que el volcado se memoria se guarde para analizar
    los fallos posteriormente, puede usar esta directiva para
    especificar un directorio diferente.</p>

    <note><title>Volcados de memoria en Linux</title> <p>Si Apache se
      inicia como usuario root y despu&#233;s se cambia el usuario con
      el se est&#225; ejecutando, el kernel de Linux
      <em>desactiva</em> los volcados de memoria, incluso si se ha
      especificado un directorio en el que se puede escribir para
      realizar este proceso. Apache (en las versiones 2.0.46 y
      posteriores) reactiva los volcados de memoria en los sistemas
      con versiones Linux 2.4 y posteriores, pero solamente si se ha
      configurado expl&#237;citamente la directiva
      <directive>CoreDumpDirectory</directive>.</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>EnableExceptionHook</name>
<description>Activa un hook que inicia handlers de excepci&#243;n
despu&#233;s de un error irrecuperable</description>
<syntax>EnableExceptionHook On|Off</syntax>
<default>EnableExceptionHook Off</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>Disponible en las versiones de Apache 2.0.49 y posteriores</compatibility>

<usage>
    <p>Por razones de seguridad esta directiva est&#225; disponible
    solamente si el servidor ha sido configurado con la opci&#243;n
    <code>--enable-exception-hook</code>. Esto activa un hook que
    permite que se conecten m&#243;dulos externos y que realicen
    alguna acci&#243;n despu&#233;s de que un proceso hijo sufra un
    error irrecuperable.</p>
    
    <p>Hay otros dos m&#243;dulos, <code>mod_whatkilledus</code> y
    <code>mod_backtrace</code> que usan este hook. Por favor, consulte
    el siguiente enlace, <a
    href="http://www.apache.org/~trawick/exception_hook.html"
    >EnableExceptionHook</a> perteneciente al sitio web de Jeff
    Trawick para obtener m&#225;s informaci&#243;n sobre el tema.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>Group</name>
<description>Grupo con el que el servidor atender&#225; las
peticiones</description>
<syntax>Group <var>unix-group</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>
<module>threadpool</module><module>worker</module></modulelist>
<compatibility>Solamente puede usarse en global server config a partir de la versi&#243;n de Apache 2.0</compatibility>

<usage>
    <p>La directiva <directive>Group</directive> determina el grupo
    con el que el servidor atender&#225; las peticiones. Para usar
    esta directiva, el servidor debe haber sido iniciado con el
    usuario <code>root</code>. Si inicia el servidor con un usuario
    que no sea root, el servidor no podr&#225; cambiarse al grupo
    especificado, en lugar de esto continuar&#225; ejecut&#225;ndose
    con el grupo del usuario que lo inici&#243;. <var>Unix-group</var>
    debe tomar un de los siguiente valores:</p>

    <dl>
      <dt>El nombre de un grupo</dt>
      <dd>Se refiere al grupo que lleva el nombre que se especifica.</dd>

      <dt><code>#</code> seguido del n&#250;mero de un grupo.</dt>
      <dd>Se refiere al grupo asociado a ese n&#250;mero.</dd>
    </dl>

    <example><title>Por ejemplo</title>
      Group www-group
    </example>

    <p>Se recomienda que cree un nuevo grupo espec&#237;ficamente para
    ejecutar el servidor. Algunos administradores usan el ususario
    <code>nobody</code>, pero esto no es siempre posible ni
    aconsejable.</p>

    <note type="warning"><title>Seguridad</title> <p>No ponga el valor
      <code>root</code> en la directiva <directive>Group</directive>
      (o en la directiva <directive
      module="mpm_common">User</directive>) a menos que sepa
      exactamente lo que est&#225; haciendo y los peligros que
      conlleva.</p>
    </note>

    <p>Importante: El uso de esta directiva en <directive
    module="core" type="section">VirtualHost</directive> no est&#225;
    permitido ya. Para configurar su servidor para
    <program>suexec</program> use la directiva <directive
    module="mod_suexec">SuexecUserGroup</directive>.</p>

    <note><title>Nota</title> <p>Aunque la directiva
      <directive>Group</directive> est&#225; presente en los
      m&#243;dulos MPM <module>beos</module> y
      <module>mpmt_os2</module>, no est&#225;n operativas y solamente
      est&#225;n presentes por razones de compatibilidad.</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>PidFile</name> 
<description>Fichero en el que el servidor guarda