mpm_common.xml.es

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

el ID del proceso demonio de escucha (daemon)</description>
<syntax>PidFile <var>filename</var></syntax> 
<default>PidFile logs/httpd.pid</default> 
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>leader</module>
<module>mpm_winnt</module><module>mpmt_os2</module>
<module>perchild</module><module>prefork</module>
<module>threadpool</module><module>worker</module></modulelist>

<usage>
    <p>La directiva <directive>PidFile</directive> especifica el
    fichero en el que el servidor guarda el ID del proceso demonio de
    escucha (daemon). Si el nombre del fichero especificado no es una
    ruta absoluta, entonces se asume que es relativa al directorio
    especificado en <directive
    module="core">ServerRoot</directive>.</p>

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

    <p>Con frecuencia es &#250;til tener la posibilidad de enviar al
    servidor una se&#241;al, de manera que cierre y vuelva a abrir el
    <directive module="core">ErrorLog</directive> y el <directive
    module="mod_log_config">TransferLog</directive>, y vuelva a leer
    los ficheros de configuraci&#243;n. Esto es lo que ocurre cuando
    se env&#237;a la se&#241;al SIGHUP (kill -1) al ID del proceso que
    aparece en <directive>PidFile</directive>.</p>

    <p>El <directive>PidFile</directive> est&#225; sujeto a las mismas
    advertencias que se hicieron para los ficheros log sobre su
    ubicaci&#243;n y sobre su <a
    href="../misc/security_tips.html#serverroot">seguridad</a>.</p>

    <note><title>Nota</title> <p>Se recomienda que para Apache 2 se
      use solamente el script <program>apachectl</program> para
      (re-)iniciar o parar el servidor.</p>
    </note>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>Listen</name>
<description>Direcciones IP y puertos en los que escucha el servidor</description>
<syntax>Listen [<var>IP-address</var>:]<var>portnumber</var></syntax>
<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>
<compatibility>Directiva de uso obligatorio en Apache 2.0</compatibility>

<usage>
    <p>La directiva <directive>Listen</directive> indica las
    direcciones IP y los puertos en los que debe escuchar Apache; por
    defecto, el servidor responde a las peticiones que se reciban en
    cualquier direcci&#243;n IP de las interfaces de red. El uso de
    <directive>Listen</directive> es ahora obligatorio. Si no
    est&#225; en el fichero de configuraci&#243;n, el servidor no
    podr&#225; iniciarse. Esto supone un cambio respecto a las
    versiones anteriores de Apache.</p>

    <p>La directiva <directive>Listen</directive> le especifica al
    servidor los puertos o las combinaciones de direcciones y puertos
    cuyas peticiones debe aceptar. Si solamente se especifica un
    n&#250;mero de puerto, el servidor escuchar&#225; en ese puerto,
    en todas las interfaces de red. Si se especifica una
    direcci&#243;n IP y un puerto, el servidor escuchar&#225;
    solamente en esa direcci&#243;n IP y en ese puerto.</p>

    <p>Se pueden usar varias directivas <directive>Listen</directive>
    para especificar varias direcciones y puertos de escucha. El
    servidor responder&#225; a peticiones de cualquiera de esas
    direcciones y puertos.</p>

    <p>Por ejemplo, para hacer que el servidor acepte conexiones en
    los puertos 80 y 8000, use:</p>

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

    <p>Para hacer que el servidor acepte conexiones en dos direcciones
    y puertos difrentes, use </p>

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

    <p>Las direcciones IPv6 deben escribirse entre corchetes, como en
    el siguiente ejemplo:</p>

    <example>
      Listen [fe80::a00:20ff:fea7:ccea]:80
    </example>

    <note><title>Condici&#243;n de error</title> Varias directivas
      <directive>Listen</directive> para la misma direcci&#243;n IP y
      el mismo puerto tendr&#225;n como resultado un mensaje de error
      del tipo <code>Direcci&#243;n actualmente en uso</code>.
    </note>
</usage>
<seealso><a href="../dns-caveats.html">Problemas con DNS</a></seealso>
<seealso><a href="../bind.html">Especificaci&#243;n de las direcciones y puertos que usa Apache</a></seealso>
</directivesynopsis>

<directivesynopsis>
<name>ListenBackLog</name>
<description>Longitud m&#225;xima de la cola de conexiones en espera</description>
<syntax>ListenBacklog <var>backlog</var></syntax>
<default>ListenBacklog 511</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>Longitud m&#225;xima de la cola de conexiones en espera. En
    general, no es necesario ni deseable hacer ninguna
    modificaci&#243;n, pero en algunos sistemas es beneficioso
    incrementar esta longitud cuando se est&#225; sufriendo un ataque
    TCP SYN flood. Consulte la informaci&#243;n sobre el
    par&#225;metro backlog de la llamada al sistema
    <code>listen(2)</code>.</p>

    <p>Este n&#250;mero estar&#225; la mayor parte de las veces
    limitado a un valor a&#250;n menor por el sistema operativo. Esto
    var&#237;a de un sistema operativo a otro. Tenga en cuenta
    tambi&#233;n que muchos sistemas operativos no usan exactamente lo
    que se especifica en el backlog, sino que usan un n&#250;mero
    basado en el valor especificado (aunque normalmente mayor).</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>LockFile</name>
<description>Ubicaci&#243;n del fichero de lock de serializaci&#243;n de aceptacio&#243;n de peticiones</description>
<syntax>LockFile <var>filename</var></syntax>
<default>LockFile logs/accept.lock</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>La directiva <directive>LockFile</directive> especifica la ruta
    al archivo de lock (lockfile) que se utiliza cuando la directiva
    <directive module="mpm_common">AcceptMutex</directive> tiene valor
    <code>fcntl</code> o <code>flock</code>. En principio no se debe
    modificar el valor por defecto de esta directiva. La raz&#243;n
    principal para moficiarlo es que el directorio de
    <code>logs</code> est&#233; montado en NFS, porque <strong>el
    archivo de lock debe almacenarse en un disco local</strong>. El
    PID del proceso principal del servidor se a&#241;ade
    autom&#225;ticamente al nombre del fichero.</p>

    <note type="warning"><title>Seguridad</title> <p>Es aconsejable
      <em>no</em> poner este fichero en un directorio en el que tenga
      permisos de escritura todos los usuarios como
      <code>/var/tmp</code> porque alguien podr&#237;a provocar un
      ataque de denegaci&#243;n de servicio y evitar que el servidor
      se inicie creando un archivo de lock con el mismo nombre que el
      que el servidor intentar&#225; crear.</p>
    </note>
</usage>
<seealso><directive module="mpm_common">AcceptMutex</directive></seealso>
</directivesynopsis>

<directivesynopsis>
<name>MaxClients</name>
<description>N&#250;mero m&#225;ximo de procesos hijo que ser&#225;n creados para
atender peticiones</description>
<syntax>MaxClients <var>number</var></syntax>
<default>Consulte la secci&#243;n de uso para obtener m&#225;s informaci&#243;n</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>leader</module>
<module>prefork</module><module>threadpool</module><module>worker</module>
</modulelist>

<usage>
    <p>La directiva <directive>MaxClients</directive> especifica el
    l&#237;mite de peticiones simult&#225;neas que ser&#225;n
    atendidas. Cualquier intento de conexi&#243;n por encima del
    l&#237;mite <directive>MaxClients</directive> se pondr&#225; en
    cola, hasta llegar a un l&#237;mite basado en el valor de la
    directiva <directive
    module="mpm_common">ListenBacklog</directive>. Una vez que un
    proceso hijo termina de atender una petici&#243;n y queda libre, se
    atender&#225; una conexi&#243;n en cola.</p>

    <p>En servidores que no usan hebras (por ejemplo,
    <module>prefork</module>), el valor especificado en
    <directive>MaxClients</directive> se traduce en el n&#250;mero
    m&#225;ximo de procesos hijo que se crear&#225;n para atender
    peticiones. El valor por defecto es <code>256</code>; para
    incrementarlo, debe incrementar tambi&#233;n el valor especificado
    en la directiva <directive
    module="mpm_common">ServerLimit</directive>.</p>

    <p>En servidores que usan hebras y en servidores h&#237;bridos
    (por ejemplo, <module>beos</module> o <module>worker</module>)
    <directive>MaxClients</directive> limita el n&#250;mero total de
    hebras que van a estar disponibles para servir clientes. El valor
    por defecto para <module>beos</module> es <code>50</code>. Para
    MPMs h&#237;bridos el valor por defecto es <code>16</code>
    (<directive module="mpm_common">ServerLimit</directive>)
    multiplicado por <code>25</code> (<directive module="mpm_common"
    >ThreadsPerChild</directive>). Por lo tanto, si va a usar en
    <directive >MaxClients</directive> un valor que requiera m&#225;s
    de 16 procesos deber&#225; tambi&#233;n incrementar el valor de la
    directiva <directive
    module="mpm_common">ServerLimit</directive>.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>MaxMemFree</name>
<description>Cantidad m&#225;xima de memoria que el asignador principal puede tomar sin hacer una llamada a <code>free()</code></description>
<syntax>MaxMemFree <var>KBytes</var></syntax>
<default>MaxMemFree 0</default>
<contextlist><context>server config</context></contextlist>
<modulelist><module>beos</module><module>leader</module>
<module>mpm_netware</module><module>prefork</module>
<module>threadpool</module><module>worker</module><module>mpm_winnt</module></modulelist>

<usage>
    <p>La directiva <directive>MaxMemFree</directive> especifica el
    n&#250;mero m&#225;ximo de kbytes libres que el asignador de memoria
    principal puede tomar sin hacer una llamada al sistema
    <code>free()</code>. Cuando no se especifica ning&#250;n valor en esta
    directiva, o cuando se especifica el valor cero, no existir&#225; tal
    l&#237;mite.</p>
</usage>
</directivesynopsis>

<directivesynopsis>
<name>MaxRequestsPerChild</name>
<description>L&#237;mite en el n&#250;mero de peticiones que un proceso hijo puede
atender durante su vida</description>
<syntax>MaxRequestsPerChild <var>number</var></syntax>
<default>MaxRequestsPerChild 10000</default>
<contextlist><context>server config</context></contextlist>
<modulelist><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>