You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2016/06/08 11:37:09 UTC
svn commit: r1747381 [3/3] - in /httpd/httpd/trunk/docs/manual/mod:
core.html.es core.xml.es
Propchange: httpd/httpd/trunk/docs/manual/mod/core.html.es
('svn:eol-style' removed)
Modified: httpd/httpd/trunk/docs/manual/mod/core.xml.es
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/core.xml.es?rev=1747381&r1=1747380&r2=1747381&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/core.xml.es (original)
+++ httpd/httpd/trunk/docs/manual/mod/core.xml.es Wed Jun 8 11:37:09 2016
@@ -1,8 +1,9 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
-<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
-<!-- English Revision: 1040494:1746754 (outdated) -->
-
+<?xml-stylesheet type="text/xsl" href="../style/manual.es.xsl"?>
+<!-- English Revision: 1741251:1746754 (outdated) -->
+<!-- Translated by Luis Gil de Bernabé Pfeiffer lgilbernabe[AT]apache.org -->
+<!-- Reviewed by Sergio Ramos-->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
@@ -23,7 +24,7 @@
<modulesynopsis metafile="core.xml.meta">
<name>core</name>
-<description>Funcionalides básicas del Servidor HTTP Apache que siempre están presentes.</description>
+<description>Funcionalides básicas del Servidor HTTP Apache que siempre están presentes.</description>
<status>Core</status>
<directivesynopsis>
@@ -31,103 +32,104 @@
<description>Configura mejoras para un Protocolo de Escucha de Sockets</description>
<syntax>AcceptFilter <var>protocol</var> <var>accept_filter</var></syntax>
<contextlist><context>server config</context></contextlist>
-<compatibility>Disponible en Apache httpd 2.1.5 y posteriores.
-En Windows desde Apache httpd 2.3.3 y posteriores.</compatibility>
+
<usage>
- <p>Esta directiva hace posible mejoras específicas a nivel de sistema operativo
- y a través del tipo de Protocolo para un socket que escucha.
- La premisa básica es que el kernel no envíe un socket al servidor
+ <p>Esta directiva hace posible mejoras específicas a nivel de sistema operativo
+ y a través del tipo de Protocolo para un socket que escucha.
+ La premisa básica es que el kernel no envíe un socket al servidor
hasta que o bien los datos se hayan recibido o bien se haya almacenado
en el buffer una Respuesta HTTP completa.
- Actualmente sólo están soportados
+ Actualmente sólo están soportados
<a href="http://www.freebsd.org/cgi/man.cgi?query=accept_filter&sektion=9">
Accept Filters</a> sobre FreeBSD, <code>TCP_DEFER_ACCEPT</code> sobre Linux,
y AcceptEx() sobre Windows.</p>
<p>El uso de <code>none</code> para un argumento desactiva cualquier filtro
- aceptado para ese protocolo. Esto es útil para protocolos que requieren que un
- servidor envíe datos primeros, tales como <code>ftp:</code> o <code>nntp</code>:</p>
- <example>AcceptFilter nntp none</example>
+ aceptado para ese protocolo. Esto es útil para protocolos que requieren que un
+ servidor envíe datos primeros, tales como <code>ftp:</code> o <code>nntp</code>:</p>
+ <highlight language="config">
+AcceptFilter nntp none
+ </highlight>
<p>Los nombres de protocolo por defecto son <code>https</code> para el puerto 443
- y <code>http</code> para todos los demás puertos. Para especificar que se está
- utilizando otro protocolo con un puerto escuchando, añade el argumento <var>protocol</var>
+ y <code>http</code> para todos los demás puertos. Para especificar que se está
+ utilizando otro protocolo con un puerto a la escucha, añade el argumento <var>protocol</var>
a la directiva <directive module="mpm_common">Listen</directive>.</p>
- <p>Sobre FreeBDS los valores por defecto:</p>
- <example>
- AcceptFilter http httpready <br/>
- AcceptFilter https dataready
- </example>
+ <p>Los valores por defecto de FreeBDS son:</p>
+ <highlight language="config">
+AcceptFilter http httpready
+AcceptFilter https dataready
+ </highlight>
<p>El filtro <code>httpready</code> almacena en el buffer peticiones HTTP completas
- a nivel de kernel. Una vez que la petición es recibida, el kernel la envía al servidor.
- Consulta la página man de
+ a nivel de kernel. Una vez que la petición es recibida, el kernel la envía al servidor.
+ Consulta la página man de
<a href="http://www.freebsd.org/cgi/man.cgi?query=accf_http&sektion=9">
- accf_http(9)</a> para más detalles. Puesto que las peticiones HTTPS
- están encriptadas, sólo se utiliza el filtro
+ accf_http(9)</a> para más detalles. Puesto que las peticiones HTTPS
+ están encriptadas, sólo se utiliza el filtro
<a href="http://www.freebsd.org/cgi/man.cgi?query=accf_data&sektion=9">accf_data(9)</a>.</p>
- <p>Sobre Linux los valores por defecto son:</p>
- <example>
- AcceptFilter http data <br/>
- AcceptFilter https data
- </example>
+ <p>Los valores por defecto en Linux son:</p>
+ <highlight language="config">
+AcceptFilter http data
+AcceptFilter https data
+ </highlight>
<p>En Linux, <code>TCP_DEFER_ACCEPT</code> no soporta el buffering en peticiones http.
- Cualquier valor además de <code>none</code> habilitará
- <code>TCP_DEFER_ACCEPT</code> en ese socket. Para más detalles
- ver la página man de Linux
- <a href="http://homepages.cwi.nl/~aeb/linux/man2html/man7/tcp.7.html">
+ Cualquier valor además de <code>none</code> habilitará
+ <code>TCP_DEFER_ACCEPT</code> en ese socket. Para más detalles
+ ver la página man de Linux
+ <a href="http://linux.die.net/man/7/tcp">
tcp(7)</a>.</p>
- <p>Sobre Windows los valores por defecto son:</p>
- <example>
- AcceptFilter http data <br/>
- AcceptFilter https data
- </example>
+ <p>Los valores por defecto en Windows son:</p>
+ <highlight language="config">
+AcceptFilter http data
+AcceptFilter https data
+ </highlight>
<p>Sobre Windows mpm_winnt interpreta el argumento AcceptFilter para conmutar la API
AcceptEx(), y no soporta el buffering sobre el protocolo http. Hay dos valores
que utilizan la API Windows AcceptEx() y que recuperan sockets de red
- entre conexciones. <code>data</code> espera hasta que los datos han sido
+ entre conexiones. <code>data</code> espera hasta que los datos han sido
transmitidos como se comentaba anteriormente, y el buffer inicial de datos y las
- direcciones de red son recuperadas a partir de una única llamada AcceptEx().
- <code>connect</code> utiliza la API AcceptEx() API, y recupera también
+ direcciones de red son recuperadas a partir de una única llamada AcceptEx().
+ <code>connect</code> utiliza la API AcceptEx() API, y recupera también
las direcciones de red, pero a diferencia de <code>none</code>
- la opción <code>connect</code> no espera a la transmisión inicial de los datos.</p>
+ la opción <code>connect</code> no espera a la transmisión inicial de los datos.</p>
- <p>Sobre Windows, <code>none</code> prefiere accept() antes que AcceptEx()
- y no recuperará sockets entre las conexiones. Lo que es útil para los adaptadores de
- red con un soporte precario de drivers, así como para algunos proveedores de red
+ <p>Sobre Windows, <code>none</code> usa accept() antes que AcceptEx()
+ y no recuperará sockets entre las conexiones. Lo que es útil para los adaptadores de
+ red con un soporte precario de drivers, así como para algunos proveedores de red
tales como drivers vpn, o filtros de spam, de virus o de spyware.</p>
</usage>
-<seealso><directive>Protocol</directive></seealso>
+<seealso><directive module="core">Protocol</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<name>AcceptPathInfo</name>
-<description>Los recursos aceptan información sobre su ruta</description>
+<description>Los recursos aceptan información sobre su ruta</description>
<syntax>AcceptPathInfo On|Off|Default</syntax>
<default>AcceptPathInfo Default</default>
<contextlist><context>server config</context>
<context>virtual host</context><context>directory</context>
<context>.htaccess</context></contextlist>
<override>FileInfo</override>
-<compatibility>Disponible en Apache httpd 2.0.30 y posteriores</compatibility>
+
<usage>
- <p>Esta directiva controla si las peticiones que contienen información sobre la ruta
+ <p>Esta directiva controla si las peticiones que contienen información sobre la ruta
que sigue un fichero que existe (o un fichero que no existe pero en un directorio que
- sí existe) serán aceptadas o denegadas. La información de ruta puede estar disponible
+ sí existe) serán aceptadas o denegadas. La información de ruta puede estar disponible
para los scripts en la variable de entorno <code>PATH_INFO</code>.</p>
- <p>Por ejemplo, asumamos que la ubicación <code>/test/</code> apunta a
- un directorio que contiene únicamente el fichero
- <code>here.html</code>. Entonces, las peticiones tanto para
+ <p>Por ejemplo, asumamos que la ubicación <code>/test/</code> apunta a
+ un directorio que contiene únicamente el fichero
+ <code>here.html</code>. Entonces, las peticiones tanto para
<code>/test/here.html/more</code> como para
<code>/test/nothere.html/more</code> recogen
<code>/more</code> como <code>PATH_INFO</code>.</p>
@@ -135,20 +137,20 @@ En Windows desde Apache httpd 2.3.3 y po
<p>Los tres posibles argumentos para la directiva
<directive>AcceptPathInfo</directive> son los siguientes:</p>
<dl>
- <dt><code>Off</code></dt><dd>Una petición sólo será aceptada si
- se corresponde con una ruta literal que existe. Por lo tanto, una petición
- con una información de ruta después del nombre de fichero tal como
- <code>/test/here.html/more</code> en el ejemplo anterior devolverá
+ <dt><code>Off</code></dt><dd>Una petición sólo será aceptada si
+ se corresponde con una ruta literal que existe. Por lo tanto, una petición
+ con una información de ruta después del nombre de fichero tal como
+ <code>/test/here.html/more</code> en el ejemplo anterior devolverá
un error 404 NOT FOUND.</dd>
- <dt><code>On</code></dt><dd>Una petición será aceptada si una
+ <dt><code>On</code></dt><dd>Una petición será aceptada si una
ruta principal de acceso se corresponde con un fichero que existe. El ejemplo
- anterior <code>/test/here.html/more</code> será aceptado si
- <code>/test/here.html</code> corresponde a un fichero válido.</dd>
+ anterior <code>/test/here.html/more</code> será aceptado si
+ <code>/test/here.html</code> corresponde a un fichero válido.</dd>
- <dt><code>Default</code></dt><dd>La gestión de las peticiones
- con información de ruta está determinada por el <a
- href="../handler.html">controlador</a> responsable de la petición.
+ <dt><code>Default</code></dt><dd>La gestión de las peticiones
+ con información de ruta está determinada por el <a
+ href="../handler.html">controlador</a> responsable de la petición.
El controlador principal para para ficheros normales rechaza por defecto
peticiones <code>PATH_INFO</code>. Los controladores que sirven scripts, tales como <a
href="mod_cgi.html">cgi-script</a> e <a
@@ -157,69 +159,67 @@ En Windows desde Apache httpd 2.3.3 y po
</dl>
<p>El objetivo principal de la directiva <code>AcceptPathInfo</code>
- es permitirte sobreescribir la opción del controlador
- de aceptar or rechazar <code>PATH_INFO</code>. Este tipo de sobreescritura se necesita,
+ es permitirnos sobrescribir la opción del controlador
+ de aceptar o rechazar <code>PATH_INFO</code>. Este tipo de reescritura se necesita,
por ejemplo, cuando utilizas un <a href="../filter.html">filtro</a>, tal como
<a href="mod_include.html">INCLUDES</a>, para generar contenido
- basado en <code>PATH_INFO</code>. El controlador principal normalmente rechazaría
- la petición, de modo que puedes utilizar la siguiente configuración para habilitarla
+ basado en <code>PATH_INFO</code>. El controlador principal normalmente rechazaría
+ la petición, de modo que puedes utilizar la siguiente configuración para habilitarla
como script:</p>
- <example>
- <Files "mypaths.shtml"><br />
- <indent>
- Options +Includes<br />
- SetOutputFilter INCLUDES<br />
- AcceptPathInfo On<br />
- </indent>
- </Files>
- </example>
+ <highlight language="config">
+<Files "mypaths.shtml">
+ Options +Includes
+ SetOutputFilter INCLUDES
+ AcceptPathInfo On
+</Files>
+ </highlight>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>AccessFileName</name>
-<description>Nombre del fichero distribuido de configuración</description>
+<description>Nombre del fichero distribuido de configuración</description>
<syntax>AccessFileName <var>filename</var> [<var>filename</var>] ...</syntax>
<default>AccessFileName .htaccess</default>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
<usage>
- <p>Mientras que procesa una petición el servidor busca
- el primer fichero de configuración existente dentro de un listado de nombres en
+ <p>Mientras que procesa una petición el servidor busca
+ el primer fichero de configuración existente dentro de un listado de nombres en
cada directorio de la ruta del documento, si los ficheros distribuidos
- de configuración están <a href="#allowoverride">habilitados para ese
+ de configuración están <a href="#allowoverride">habilitados para ese
directorio</a>. Por ejemplo:</p>
- <example>
- AccessFileName .acl
- </example>
+ <highlight language="config">
+AccessFileName .acl
+ </highlight>
- <p>antes de servir el documento
- <code>/usr/local/web/index.html</code>, el servidor leerá
+ <p>Antes de servir el documento
+ <code>/usr/local/web/index.html</code>, el servidor leerá
<code>/.acl</code>, <code>/usr/.acl</code>,
- <code>/usr/local/.acl</code> and <code>/usr/local/web/.acl</code>
- para las directivas, salvo que estén deshabilitadas with</p>
+ <code>/usr/local/.acl</code> y <code>/usr/local/web/.acl</code>
+ para las directivas, salvo que estén deshabilitadas con:</p>
+
+ <highlight language="config">
+<Directory "/">
+ AllowOverride None
+</Directory>
+ </highlight>
- <example>
- <Directory /><br />
- <indent>
- AllowOverride None<br />
- </indent>
- </Directory>
- </example>
+
</usage>
<seealso><directive module="core">AllowOverride</directive></seealso>
-<seealso><a href="../configuring.html">Configuration Files</a></seealso>
-<seealso><a href="../howto/htaccess.html">.htaccess Files</a></seealso>
+<seealso><a href="../configuring.html">Ficheros de configuración</a></seealso>
+<seealso><a href="../howto/htaccess.html">Fichero .htaccess</a></seealso>
</directivesynopsis>
<directivesynopsis>
<name>AddDefaultCharset</name>
-<description>Default charset parameter to be added when a response
-content-type is <code>text/plain</code> or <code>text/html</code></description>
+<description>Juego de casrácteres que se le añade por defecto a una respuesta del tipo
+ contenido "content-type" es <code>text/plain</code> o <code>text/html</code></description>
<syntax>AddDefaultCharset On|Off|<var>charset</var></syntax>
<default>AddDefaultCharset Off</default>
<contextlist><context>server config</context>
@@ -228,41 +228,44 @@ content-type is <code>text/plain</code>
<override>FileInfo</override>
<usage>
- <p>This directive specifies a default value for the media type
- charset parameter (the name of a character encoding) to be added
- to a response if and only if the response's content-type is either
- <code>text/plain</code> or <code>text/html</code>. This should override
- any charset specified in the body of the response via a <code>META</code>
- element, though the exact behavior is often dependent on the user's client
- configuration. A setting of <code>AddDefaultCharset Off</code>
- disables this functionality. <code>AddDefaultCharset On</code> enables
- a default charset of <code>iso-8859-1</code>. Any other value is assumed
- to be the <var>charset</var> to be used, which should be one of the
- <a href="http://www.iana.org/assignments/character-sets">IANA registered
- charset values</a> for use in Internet media types (MIME types).
- For example:</p>
-
- <example>
- AddDefaultCharset utf-8
- </example>
-
- <p><directive>AddDefaultCharset</directive> should only be used when all
- of the text resources to which it applies are known to be in that
- character encoding and it is too inconvenient to label their charset
- individually. One such example is to add the charset parameter
- to resources containing generated content, such as legacy CGI
- scripts, that might be vulnerable to cross-site scripting attacks
- due to user-provided data being included in the output. Note, however,
- that a better solution is to just fix (or delete) those scripts, since
- setting a default charset does not protect users that have enabled
- the "auto-detect character encoding" feature on their browser.</p>
+ <p>Esta directiva especifica un valor por defecto para el tipo de soporte que
+ se usa como parámetro del juego de carácteres (el nombre de una
+ codificación de carácteres) para ser añadido a una respuesta si y solo si
+ el contenido de "content-type" es o <code>text/plain</code> o
+ <code>text/html</code>. Esto debería sobreescribir cualquier juego de
+ caracteres que se le especifique en el cuerpo de la respuesta mediante un
+ elemento <code>META</code>, aunque el comportamiento exacto depende a menudo
+ de la confuguracion del usuario cliente. Una configuración de
+ <code>AddDefaultCharset Off</code> deshabilita esta funcionalidad.
+ <code>AddDefaultCharset On</code> habilita un conjunto de caracteres por defecto
+ de <code>iso-8859-1</code>. Cualquier otro valor se asume que sea el <var>charset</var>
+ que va a ser usado, que debe ser uno de los juegos de carácteres
+ <a href="http://www.iana.org/assignments/character-sets">registradas por el IANA
+ </a> para su uso en los tipos de medios de Internet (MIME types).
+ Por ejemplo:</p>
+
+ <highlight language="config">
+AddDefaultCharset utf-8
+ </highlight>
+
+ <p><directive>AddDefaultCharset</directive> debería ser utilizada sólo cuando
+ se sepa que todo el texto del recurso al que se le aplica se sabe que va a
+ estar en ese juego de caracteres y es inconveniente etiquetar los
+ documentos individualmente. Un ejemplo de ello es añadir el juego de caracteres
+ a recursos con contenido autogenerado, tales como scripts legados de CGI,
+ que pueden ser vulnerables a ataques de tipo XSS (Cross-Site Scripting),
+ debido a datos que incluye el usuario en la salida. Notese, sin embargo
+ una mejor solución es arreglar (o eliminar) dichos scripts, ya que
+ dejar por defecto un juego de carácteres no protege a los usuarios
+ que han habilitado la funcionalidad "auto-detect character encoding" en sus
+ navegadores.
+ </p>
</usage>
<seealso><directive module="mod_mime">AddCharset</directive></seealso>
-</directivesynopsis>
-
+</directivesynopsis>
<directivesynopsis>
<name>AllowEncodedSlashes</name>
-<description>Determines whether encoded path separators in URLs are allowed to
+<description>Determina si Determines whether encoded path separators in URLs are allowed to
be passed through</description>
<syntax>AllowEncodedSlashes On|Off</syntax>
<default>AllowEncodedSlashes Off</default>