Update Spanish Translation (0a502c15) · Commits · CYBER - Cyber Security / TS 103 523 MSP / TLMSP / TLMSP Apache Httpd

docs/manual/dso.xml.es

0 → 100644

+365 −0

Original line number	Diff line number	Diff line
		<?xml version="1.0" encoding="UTF-8" ?>
		<!DOCTYPE manualpage SYSTEM "./style/manualpage.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.
		-->

		<manualpage metafile="dso.xml.meta">

		<title>Soporte de Objetos Dinamicos Compartidos (DSO)</title>

		<summary>
		<p>El servidor HTTP Apache es un programa modular en el que el
		administrador puede elegir qué funcionalidades se incluyen
		mediante la selección de un conjunto de módulos. En
		primer lugar, los módulos pueden compilarse de manera
		estática en el binario <program>httpd</program>. De forma
		alternativa, los módulos también pueden compilarse como
		Objetos Dinamicos Compartidos (DSOs) que existen de forma
		independiente del archivo binario <program>httpd</program>. Los
		módulos que se deseen usar como objetos dinámicos
		compartidos pueden compilarse al mismo tiempo que el servidor, o
		pueden compilarse en otro momento y ser añadidos después
		usando la Herramienta de Extensión de Apache
		(<program>apxs</program>).</p>

		<p>Este documento describe cómo usar los módulos en
		forma de objeto dinámico compartido (DSO) así como los
		fundamentos teóricos que hay detrás para explicar su
		funcionamiento.</p>
		</summary>


		<section id="implementation"><title>Implementación</title>

		<related>
		<modulelist>
		<module>mod_so</module>
		</modulelist>
		<directivelist>
		<directive module="mod_so">LoadModule</directive>
		</directivelist>
		</related>

		<p>Cargar módulos de Apache individualmente como objetos
		dinámicos compartidos (DSO) es posible gracias a un
		módulo llamado <module>mod_so</module> que debe compilarse
		estáticamente en el núcleo (kernel) de Apache. Es el
		único módulo junto con el módulo
		<module>core</module> que no se puede usar como objeto
		dinámico compartido. Prácticamente todos los demás
		módulos distribuidos con Apache se pueden usar como objetos
		dinámicos compartidos individualmente siempre y cuando se
		haya activado la posibilidad de usarlos con la opción de
		<program>configure</program>
		<code>--enable-<em>module</em>=shared</code> tal y como se
		explicó en la <a href="install.html">documentación de
		instalación</a>. Una vez que haya compilado un módulo
		como objeto dinámico compartido y le haya puesto un nombre
		del tipo <code>mod_foo.so</code>, puede cargarlo al iniciar o
		reiniciar el servidor usando el comando <directive
		module="mod_so">LoadModule</directive> de <module>mod_so</module>
		en el fichero <code>httpd.conf</code>.</p>

		<p>Para simplificar la creación de objetos dinámicos
		compartidos para Apache (especialmente módulos de terceras
		partes) está disponible un nuevo programa de soporte llamado
		<program>apxs</program> (<em>APache eXtenSion</em>). Puede usar
		este programa para crear módulos como objetos dinámicos
		compartidos <em>sin tener que</em> crearlos al mismo tiempo que
		compila su servidor Apache. La idea es simple: cuando se instala
		Apache el procedimiento <code>make install</code> de
		<program>configure</program> @@@ installs the Apache C header
		files and puts the platform-dependent compiler and linker flags
		for building DSO files into the apxs program / instala los
		ficheros de cabecera de C de Apache y especifica las opciones de
		compilación y enlace dependientes de la plataforma para
		generar objetos dinámicos compartidos con
		<program>apxs</program>. De esta manera el usuario puede usar
		<program>apxs</program> para compilar el código fuente de
		módulos de Apache de manera independiente y sin tener que
		preocuparse por las opciones de compilación y enlace
		dependientes de la plataforma que soportan objetos dinámicos
		compartidos.</p>

		</section>

		<section id="usage"><title>Resumen de uso</title>

		<p>Para que se haga una idea de lo que permite el soporte de
		objetos dinámicos compartidos en Apache 2.0, aquí tiene
		un resumen breve pero conciso:</p>

		<ol>
		<li>
		Construir e instalar un módulo <em>incluido en la
		distribución</em> de Apache, digamos
		<code>mod_foo.c</code>, como un objeto dinámico
		compartido de nombre <code>mod_foo.so</code>:

		<example>
		$ ./configure --prefix=/path/to/install --enable-foo=shared<br />
		$ make install
		</example>
		</li>

		<li>
		Construir e instalar un módulo de Apache de una
		<em>tercera parte</em>, digamos <code>mod_foo.c</code>, como
		un objeto dinámico compartido de nombre
		<code>mod_foo.so</code>:

		<example>
		$ ./configure --add-module=module_type:/path/to/3rdparty/mod_foo.c --enable-foo=shared<br />
		$ make install
		</example>
		</li>

		<li>
		Configurar Apache para poder <em>instalar después</em>
		objetos dinámicos compartidos:

		<example>
		$ ./configure --enable-so<br />
		$ make install
		</example>
		</li>

		<li>
		Construir e instalar un módulo de Apache de una
		<em>tercera parte</em>, digamos <code>mod_foo.c</code>, como
		un objeto dinámico compartido de nombre
		<code>mod_foo.so</code> <em>fuera</em> de la estructura de
		directorios de Apache usando <program>apxs</program>:

		<example>
		$ cd /path/to/3rdparty<br />
		$ apxs -c mod_foo.c<br />
		$ apxs -i -a -n foo mod_foo.la
		</example>
		</li>
		</ol>

		<p>En todos los casos, una vez que se compila el objeto
		dinámico compartido, debe usar una directiva <directive
		module="mod_so">LoadModule</directive> en
		<code>httpd.conf</code> para activar dicho módulo.</p>
		</section>

		<section id="background"><title>Fundamentos teoróricos
		detrás de los objetos dinámicos compartidos</title>

		<p>En las versiones modernas de Unix, existe un mecanismo
		especialmente útil normalmente llamado enlazado/carga de
		<em>Objetos Dinámicos Compartidos</em> (DSO). Este mecanismo
		ofrece una forma de construir trozos de código de programa en
		un formato especial para cargarlo en tiempo de ejecución en
		el espacio de direcciones de memoria de un programa
		ejecutable.</p>

		<p>Esta carga puede hacerse de dos maneras: automáticamente
		con un programa de sistema llamado <code>ld.so</code> al inicio de
		un programa ejecutable o manualmente desde dentro del programa en
		ejecución con una interfaz programática del sistema al
		cargador de Unix mediante llamadas al sistema
		<code>dlopen()/dlsym()</code>.</p>

		<p>Si se usa el primer método, los objetos dinámicos
		compartidos se llaman normalmente <em>librerías
		compartidas</em> ó <em>librerías DSO</em> y se
		nombran como <code>libfoo.so</code> o
		<code>libfoo.so.1.2</code>. Residen en un directorio de
		sistema (normalmente <code>/usr/lib</code>) y el enlace con el
		programa ejecutable se establece al construir la librería
		especificando la opción<code>-lfoo</code> al comando de
		enlace. Esto incluye las referencias literales a las
		librerías en el programa ejecutable de manera que cuando
		se inicie, el cargador de Unix será capaz de localizar
		<code>libfoo.so</code> en <code>/usr/lib</code>, en rutas
		referenciadas literalmente mediante opciones del linker como
		<code>-R</code> o en rutas configuradas mediante la variable
		de entorno <code>LD_LIBRARY_PATH</code>. Entonces se resuelven
		los símbolos (todavía no resueltos) en el programa
		ejecutable que están presentes en el objeto dinámico
		compartido.</p>

		<p>Los símbolos en el programa ejecutable no están
		referenciados normalmente en el objeto dinámico compartido
		(porque son librerías reusables de propósito general) y
		por tanto, no se producen más resoluciones. El programa
		ejecutable no tiene que hacer nada por sí mismo para usar los
		símbolos del objeto dinámico compartido porque todo el
		trabajo de resolución lo hace @@@ Unix loader / el cargador
		de Unix @@@. (De hecho, el código para invocar
		<code>ld.so</code> es parte del código que se ejecuta al
		iniciar, y que hay en cualquier programa ejecutable que haya sido
		construido de forma no estática). La ventaja de cargar
		dinámicamente el código de las librerías comunes es
		obvia: el código de las librerías necesita ser almacenado
		solamente una vez, en una librería de sistema como
		<code>libc.so</code>, ahorrando así espacio en disco.</p>

		<p>Por otro lado, los objetos dinámicos compartidos
		también suelen llamarse <em>objetos compatidos</em> o
		<em>ficheros DSO</em> y se les puede nombrar con cualquier
		extensión (aunque su nombre canónico es
		<code>foo.so</code>). Estos archivos normalmente permanecen
		dentro de un directorio específico del programa y no se
		establecen enlaces automáticamente con los programas
		ejecutables con los que se usan. En lugar de esto, el
		programa ejecutable carga manualmente el objeto dinámico
		compartido en tiempo de ejecución en su espacio de
		direcciones de memoria con <code>dlopen()</code>. En ese
		momento no se resuelven los símbolos del objeto
		dinámico compartido para el programa ejecutable. En lugar
		de esto, el cargador de Unix resuelve automáticamente los
		símbolos (aún no resueltos en el objeto
		dinámico compartido del conjunto de símbolos
		exportados por el programa ejecutable y de las librerías
		DSO que tenga ya cargadas (especialmente todos los
		símbolos de la omnipresente <code>libc.so</code>). De
		esta manera el objeto dinámico compartido puede conocer
		el conjunto de símbolos del programa ejecutable como si
		hubiera sido enlazado estáticamente en un primer
		momento.</p>

		<p>Finalmente, para beneficiarse de la API de las DSOs, el
		programa ejecutable tiene que resolver los símbolos
		particulares de la DSO con <code>dlsym()</code> para ser usado
		más tarde dentro de tablas de direccionamiento (dispatch
		tables) <em>etc.</em> En otras palabras: El programa ejecutable
		tiene que resolver manualmente cada uno de los símbolos que
		necesita para poder usarlo después. La ventaja de ese
		mecanismo es que las partes opcionales del programa no necesitan
		ser cargadas (y por tanto no consumen memoria) hasta que se
		necesitan por el programa en cuestión. Cuando es necesario,
		estas partes del programa pueden cargarse dinámicamente para
		expandir las funcionalidades básicas del programa.</p>

		<p>Aunque este mecanismo DSO parece muy claro, hay al menos un
		paso de cierta dificultad: la resolución de los símbolos
		que usa el programa ejecutable por la DSO cuando se usa una DSO
		para extender la funcionalidad de una programa (segundo caso). Por
		qué? Porque la resolución inversa de símbolos de
		DSOs del conjunto de símbolos del programa ejecutable se hace
		en contra del diseño de la librería (donde la
		librería no tiene conocimiento sobre los programas que la
		usan) y tampoco está disponible en todas las plataformas no
		estandarizadas. En la práctica los símbolos globales del
		programa ejecutable están disponibles para su uso en una
		DSO. El mayor problema que hay que resolver cuando se usan DSOs
		para extender un programa en tiempo de ejecución es encontrar
		un modo de forzar al enlazador a exportar todos los símbolos
		globales.</p>

		<p>El enfoque de las librerías compartidas es bastante
		típico, porque es para lo que se diseño el mecanismo
		DSO, por tanto se usa para casi todos los tipos de librerías
		que incluye el sistema operativo. Por otro lado, no muchos
		programas usan objetos compartidos para expandir sus
		funcionalidades.</p>

		<p>En 1998, había solamente unos pocos programas disponibles
		que usaban el mecanismo DSO para extender su funcionalidad en
		tiempo de ejecucion: Perl 5 (por medio de su mecanismo XS y el
		módulo DynaLoader), Netscape Server, <em>etc.</em> A partir
		de la version 1.3, Apache se unió a este grupo, Apache usa
		desde entonces una concepción modular para extender su
		funcionalidad e internamente usa un enfoque de tablas de
		direccionamiento (dispatch-list-based) para enlazar módulos
		externos con las funcionalidades propias del servidor. De esta
		manera, Apache puede usar el mecanismo DSO para cargar sus
		módulos en tiempo de ejecución.</p>
		</section>

		<section id="advantages"><title>Ventajas e Inconvenientes</title>

		<p>Las características de las librerías dinámicas
		compartidas arriba explicadas tienen las siguientes ventajas:</p>

		<ul>
		<li>El servidor es mucho más flexible en tiempo de
		ejecución porque pueden añadirse módulos mediante
		comandos de configuración <directive
		module="mod_so">LoadModule</directive> en
		<code>httpd.conf</code> en lugar de tener que hacerlo con las
		opciones de <program>configure</program> al compilar. Por
		ejemplo, de esta manera uno puede ejecutar diferentes instancias
		del servidor (estándar & SSL, mínima & super
		potente [mod_perl, PHP3], <em>etc.</em>) con una única
		instalación de Apache.</li>

		<li>El servidor puede ser extendido fácilmente con
		módulos de terceras partes después de la
		instalación. Esto es un gran beneficio al menos para los
		mantenedores de paquetes de distribuciones, que pueden crear un
		paquete básico de Apache y paquetes adicionales que
		contengan extensiones tales como PHP3, mod_perl, mod_fastcgi,
		<em>etc.</em></li>

		<li>Facilita la labor de hacer prototipos de módulos de
		Apache porque con el dúo DSO/<program>apxs</program> se
		puede trabajar fuera de la estructura de directorios de Apache y
		únicamente es necesario el comando <code>apxs -i</code>
		seguido del comando <code>apachectl restart</code> para probar
		la nueva versión del módulo que se está
		desarrollando.</li>
		</ul>

		<p>DSO presenta los siguientes inconvenientes:</p>

		<ul>
		<li>El mecanismo DSO no puede ser usado en todas las plataformas
		porque no todos los sistemas operativos soportan la carga
		dinámica de código en el espacio de direcciones de
		memoria de un programa.</li>

		<li>El servidor es aproximadamente un 20% más lento
		iniciándose por la sobrecarga que implica la
		resolución de símbolos por parte del cargador de Unix.</li>

		<li>El servidor es aproximadamente un 5% más lento
		ejecutándose en algunas plataformas porque el código
		posicionado independientemente (PIC) necesita algunas veces
		procesos bastante complicados para calcular direcciones
		relativas que no son en principio tan rápidos como los que
		se usan para calcular direcciones absolutas.</li>

		<li>Como los módulos DSO no pueden enlazarse a otras
		librerías basadas en DSO (<code>ld -lfoo</code>) en todas
		las plataformas (por ejemplo en las plataformas basadas en a.out
		normalmente no puede ser usada esta funcionalidad, mientras que
		sí puede ser usada en las plataformas basadas en ELF) no se
		puede usar el mecanismo DSO para todos los tipos de
		módulos. En otras palabras, los módulos compilados
		como ficheros DSO solamente pueden usar símbolos del
		núcleo (kernel) de Apache, los de las librerías de C
		(<code>libc</code>) y de todas las demas librerías
		dinámicas o estáticas usadas por el núcleo de
		Apache, o de archivos de librerías estáticas
		(<code>libfoo.a</code>) que contengan código independiente
		de su posición. Las únicas posibilidades para usar
		otro código es asegurarse de que el núcleo de Apache
		contiene una referencia a él o cargar el código por
		medio de <code>dlopen()</code>.</li>
		</ul>

		</section>

		</manualpage>

docs/manual/index.xml.es

+4 −3

Original line number	Diff line number	Diff line
		@@ -4,7 +4,8 @@
		<!-- English Revision: 151405 -->

		<!--
		Copyright 2004 The Apache Software Foundation
		Copyright 2004-2005 The Apache Software Foundation or its 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.
		@@ -22,12 +23,12 @@
		<indexpage metafile="index.xml.meta">
		<parentdocument href="http://httpd.apache.org/docs-project/" />

		<title>Versión 2.0 de la documentación del Servidor de HTTP Apache</title>
		<title>Documentación del Servidor HTTP Apache 2.0</title>

		<category id="release"><title>Notas de la Versión</title>
		<page href="new_features_2_0.html">Nuevas funcionalidades en
		Apache 2.0</page>
		<page href="upgrading.html">Actualizarse a la versión 2.0 desde la 1.3</page>
		<page href="upgrading.html">Pasar a usar Apache 2.0 si ahora usa Apache 1.3</page>
		<page href="license.html">Licencia Apache</page>
		</category>

docs/manual/mod/leader.xml.es

+12 −10

Original line number	Diff line number	Diff line
		<?xml version="1.0"?>
		<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
		<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
		<!-- English Revision: 106090:151405 (outdated) -->
		<!-- English Revision: 151405 -->

		<!--
		Copyright 2004 The Apache Software Foundation
		Copyright 2004-2005 The Apache Software Foundation or its 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.
		@@ -28,9 +29,9 @@
		<identifier>mpm_leader_module</identifier>

		<summary>
		<note type="warning"><title>Warning</title>
		<note type="warning"><title>Advertencia</title>
		<p>Este módulo es todavía experimental, lo que
		significa que podría no funcionar como es debido.</p>
		significa que podría no funcionar como se espera.</p>
		</note>

		<p>Este módulo es una variante experimental del módulo
		@@ -40,21 +41,22 @@
		<a href="http://deuce.doc.wustl.edu/doc/pspdfs/lf.pdf"
		>http://deuce.doc.wustl.edu/doc/pspdfs/lf.pdf</a>.</p>

		<p>Para usar el MPM <module>leader</module>, añada
		<p>Para usar el módulo de multiprocesamiento
		<module>leader</module>, añada
		<code>--with-mpm=leader</code> como argumento al script
		<code>configure</code> en el momento de compilar
		<code>httpd</code>.</p>
		<program>configure</program> en el momento de compilar
		<program>httpd</program>.</p>

		<p>Este módulo de multiprocesamiento depende de operaciones
		atómicas compare-and-swap del APR para sicronizar las
		atómicas compare-and-swap del APR para sincronizar las
		hebras. Si está compilando el servidor para una máquina
		x86 y no necesita soportar la arquitectura 386, o está
		compilando para una máquina SPARC y no necesita ejecutar el
		servidor en chips pre-UltraSPARC, añada
		<code>--enable-nonportable-atomics=yes</code> como argumento al
		script <code>configure</code>. Esto hará que APR implemente
		script <program>configure</program>. Esto hará que APR implemente
		las operaciones atómicas usando opciones más eficientes
		que no están presentes en CPUs antiguas.</p>
		que no están presentes para CPUs antiguas.</p>
		</summary>

		<directivesynopsis location="mpm_common"><name>AcceptMutex</name>

docs/manual/vhosts/index.xml.es

+1 −1

Original line number	Diff line number	Diff line
		@@ -71,7 +71,7 @@ host virtual</a></seealso>
		(Una dirección IP para cada sitio web)</li>
		<li><a href="examples.html">Ejemplos típicos de
		configuración para usar hosting virtual</a></li>
		<li><a href="fd-limits.html">L#237;mites a los descriptores de
		<li><a href="fd-limits.html">Límites a los descriptores de
		ficheros</a> (o, <em>demasiados ficheros de registro</em>)</li>
		<li><a href="mass.html">Configuración dinámica de
		Hosting virtual masivo</a></li>

Admin message