1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-23 23:12:09 +01:00

mcrypt : fix XML by converting para to simpara tags via script

This commit is contained in:
Gina Peter Banyard
2026-01-19 03:24:17 +00:00
parent 1370e6675c
commit 99d10e27ad
37 changed files with 328 additions and 336 deletions

View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 67ae2b943e98fcbf3f3f93e8bce6eca97c2c859d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<book xml:id="book.mcrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.mcrypt">
<?phpdoc extension-membership="pecl" ?>
<title>Mcrypt</title>
@@ -24,11 +23,11 @@
</warning>
<note>
<para>
<simpara>
&pecl.moved-ver;7.2.0.
</para>
</simpara>
</note>
<para>
<simpara>
Estas funciones permiten acceder a la biblioteca
mcrypt, que dispone de una gran variedad de algoritmos
de cifrado, como DES, TripleDES, Blowfish (por omisión), 3-WAY,
@@ -36,7 +35,7 @@
OFB, CFB y ECB. Asimismo, aceptan también RC6 e IDEA que son
considerados como "no libres".
CFB/OFB es de 8 bits por omisión.
</para>
</simpara>
</preface>
<!-- }}} -->
@@ -46,7 +45,6 @@
&reference.mcrypt.reference;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<appendix xml:id="mcrypt.ciphers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="mcrypt.ciphers">
<title>Modos de cifrado Mcrypt</title>
<para>
A continuación se presenta una lista no exhaustiva de los modos de cifrado de la extensión
@@ -16,50 +15,50 @@
al llamar a <function>mcrypt_module_open</function>.
<itemizedlist>
<listitem><simpara>MCRYPT_3DES</simpara></listitem>
<listitem><simpara>MCRYPT_ARCFOUR_IV (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_ARCFOUR (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_ARCFOUR_IV (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_ARCFOUR (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_BLOWFISH</simpara></listitem>
<listitem><simpara>MCRYPT_CAST_128</simpara></listitem>
<listitem><simpara>MCRYPT_CAST_256</simpara></listitem>
<listitem><simpara>MCRYPT_CRYPT</simpara></listitem>
<listitem><simpara>MCRYPT_DES</simpara></listitem>
<listitem><simpara>MCRYPT_DES_COMPAT (libmcrypt 2.2.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_ENIGMA (libmcrypt > 2.4.x únicamente, alias de MCRYPT_CRYPT)</simpara></listitem>
<listitem><simpara>MCRYPT_ENIGMA (libmcrypt &gt; 2.4.x únicamente, alias de MCRYPT_CRYPT)</simpara></listitem>
<listitem><simpara>MCRYPT_GOST</simpara></listitem>
<listitem><simpara>MCRYPT_IDEA (no libre)</simpara></listitem>
<listitem><simpara>MCRYPT_LOKI97 (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_MARS (libmcrypt > 2.4.x únicamente, no libre)</simpara></listitem>
<listitem><simpara>MCRYPT_PANAMA (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RIJNDAEL_128 (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RIJNDAEL_192 (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RIJNDAEL_256 (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_LOKI97 (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_MARS (libmcrypt &gt; 2.4.x únicamente, no libre)</simpara></listitem>
<listitem><simpara>MCRYPT_PANAMA (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RIJNDAEL_128 (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RIJNDAEL_192 (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RIJNDAEL_256 (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RC2</simpara></listitem>
<listitem><simpara>MCRYPT_RC4 (libmcrypt 2.2.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RC6 (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RC6 (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RC6_128 (libmcrypt 2.2.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RC6_192 (libmcrypt 2.2.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_RC6_256 (libmcrypt 2.2.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_SAFER64</simpara></listitem>
<listitem><simpara>MCRYPT_SAFER128</simpara></listitem>
<listitem><simpara>MCRYPT_SAFERPLUS (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_SERPENT(libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_SAFERPLUS (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_SERPENT(libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_SERPENT_128 (libmcrypt 2.2.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_SERPENT_192 (libmcrypt 2.2.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_SERPENT_256 (libmcrypt 2.2.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_SKIPJACK (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_SKIPJACK (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_TEAN (libmcrypt 2.2.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_THREEWAY</simpara></listitem>
<listitem><simpara>MCRYPT_TRIPLEDES (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_TWOFISH (para las versiones antiguas de mcrypt 2.x o mcrypt > 2.4.x )</simpara></listitem>
<listitem><simpara>MCRYPT_TRIPLEDES (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_TWOFISH (para las versiones antiguas de mcrypt 2.x o mcrypt &gt; 2.4.x )</simpara></listitem>
<listitem><simpara>MCRYPT_TWOFISH128 (TWOFISHxxx está disponible en las nuevas versiones 2.x,
pero no en las versiones 2.4.x)</simpara></listitem>
<listitem><simpara>MCRYPT_TWOFISH192</simpara></listitem>
<listitem><simpara>MCRYPT_TWOFISH256</simpara></listitem>
<listitem><simpara>MCRYPT_WAKE (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_XTEA (libmcrypt > 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_WAKE (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
<listitem><simpara>MCRYPT_XTEA (libmcrypt &gt; 2.4.x únicamente)</simpara></listitem>
</itemizedlist>
</para>
<para>
<simpara>
Se debe (modo <constant>CFB</constant> y <constant>OFB</constant>)
o puede (modo <constant>CBC</constant>) proporcionar un vector de inicialización
(IV) para estos modos de cifrado. IV debe ser único, y tener el mismo
@@ -69,9 +68,8 @@
se puede enviar IV con los datos cifrados, (consulte el capítulo
9.3 de &book.applied.cryptography; de Schneier (ISBN 0-471-11709-9)
para más detalles sobre el tema).
</para>
</simpara>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@@ -1,19 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4df3145f2badb48519b4eeee7dab307b2c11d74e Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<section xml:id="mcrypt.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="mcrypt.installation">
&reftitle.install;
<para>
<simpara>
&pecl.moved-ver;7.2.0
</para>
<para>
</simpara>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;mcrypt">&url.pecl.package;mcrypt</link>.
</para>
</simpara>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mcrypt-create-iv">
<refnamediv>
@@ -24,16 +24,16 @@
<methodparam><type>int</type><parameter>size</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>source</parameter><initializer>MCRYPT_DEV_URANDOM</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mcrypt_create_iv</function> crea un IV
(vector de inicialización) a partir de una fuente aleatoria.
</para>
<para>
</simpara>
<simpara>
El vector de inicialización es el único medio de proporcionar una inicialización
de reemplazo a los métodos de inicialización. Este vector no necesita
ser particularmente secreto, aunque es mejor que lo sea. Puede enviarse
con los documentos cifrados sin perder seguridad.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,15 +42,15 @@
<varlistentry>
<term><parameter>size</parameter></term>
<listitem>
<para>
<simpara>
El tamaño del vector.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>source</parameter></term>
<listitem>
<para>
<simpara>
La fuente de un IV. La fuente puede ser <constant>MCRYPT_RAND</constant> (el generador
de números aleatorios del sistema), <constant>MCRYPT_DEV_RANDOM</constant>
(lee los datos desde <filename>/dev/random</filename>) y
@@ -58,11 +58,11 @@
<filename>/dev/urandom</filename>). Antes de la versión 5.3.0,
<constant>MCRYPT_RAND</constant> era la única constante
soportada por Windows.
</para>
<para>
</simpara>
<simpara>
Tenga en cuenta que el valor por defecto de este parámetro era
<constant>MCRYPT_DEV_RANDOM</constant> antes de PHP 5.6.0.
</para>
</simpara>
<note>
<simpara>
Tenga en cuenta que la constante <constant>MCRYPT_DEV_RANDOM</constant>
@@ -76,9 +76,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el vector de inicialización, o bien &false; en caso de error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-decrypt">
<refnamediv>
@@ -20,9 +20,9 @@
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>iv</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Descifra los datos <parameter>data</parameter> y devuelve los datos descifrados.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -36,22 +36,22 @@
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
La clave utilizada durante el cifrado de los datos. Si el tamaño de la clave
proporcionada no es soportado por el cipher, la función emitirá un
warning y devolverá &false;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
Los datos que serán descifrados utilizando los parámetros
<parameter>cipher</parameter> y <parameter>mode</parameter>.
Si el tamaño de los datos no corresponde a n * el tamaño del bloque,
los datos serán completados con '<literal>\0</literal>'.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -71,10 +71,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve los datos descifrados en forma de &string;
&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-algorithms-name">
<refnamediv>
@@ -18,10 +18,10 @@
<type>string</type><methodname>mcrypt_enc_get_algorithms_name</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mcrypt_enc_get_algorithms_name</function> devuelve el nombre de
el algoritmo utilizado por <parameter>td</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -30,9 +30,9 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -40,9 +40,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el nombre del algoritmo actual, en forma de &string;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-block-size">
<refnamediv>
@@ -16,9 +16,9 @@
<type>int</type><methodname>mcrypt_enc_get_block_size</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Obtiene el tamaño de bloque de un algoritmo.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -26,18 +26,18 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El gestor de ficheros.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el tamaño de bloque del algoritmo, en bytes.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no Maintainer: Marqitos -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-iv-size">
<refnamediv>
@@ -16,13 +16,13 @@
<type>int</type><methodname>mcrypt_enc_get_iv_size</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Esta función devuelve el tamaño del VI del algoritmo designado
por <parameter>td</parameter>, en bytes. Si el valor devuelto
es 0, es que el algoritmo no requiere de VI. Un VI es
requerido en modo <literal>"cbc"</literal>, <literal>"cfb"</literal> y
<literal>"ofb"</literal>, y a veces en modo <literal>"stream"</literal>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -30,18 +30,18 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El gestor de ficheros.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el tamaño del IV, o <literal>0</literal> si el IV es ignorado por el algoritmo.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-key-size">
<refnamediv>
@@ -16,9 +16,9 @@
<type>int</type><methodname>mcrypt_enc_get_key_size</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve el tamaño máximo de la clave para un modo dado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -26,18 +26,18 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El gestor de fichero.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el tamaño máximo de la clave para el modo dado.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-modes-name">
<refnamediv>
@@ -16,9 +16,9 @@
<type>string</type><methodname>mcrypt_enc_get_modes_name</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve el nombre del modo.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -26,18 +26,18 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el nombre, en forma de &string;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-get-supported-key-sizes">
<refnamediv>
@@ -18,11 +18,11 @@
<type>array</type><methodname>mcrypt_enc_get_supported_key_sizes</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mcrypt_enc_get_supported_key_sizes</function> lee
los tamaños de clave soportados por el algoritmo actual del
recurso de cifrado <parameter>td</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,9 +31,9 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -41,13 +41,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un array que contiene los tamaños de clave soportados por el algoritmo
designado por <parameter>td</parameter>. Si devuelve un array
vacío, es que todas las claves entre 1 y
<function>mcrypt_enc_get_key_size</function> son admitidas por
el algoritmo.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-is-block-algorithm-mode">
<refnamediv>
@@ -16,10 +16,10 @@
<type>bool</type><methodname>mcrypt_enc_is_block_algorithm_mode</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Comprueba si el modo de cifrado es por bloques (por ejemplo,
&false; para un flujo, y &true; para <literal>"cbc"</literal>, <literal>"cfb"</literal>, <literal>"ofb"</literal>).
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,18 +27,18 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si este modo utiliza algoritmos por bloques, y &false; en caso contrario.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-is-block-algorithm">
<refnamediv>
@@ -16,9 +16,9 @@
<type>bool</type><methodname>mcrypt_enc_is_block_algorithm</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Comprueba si el cifrado es por bloques en un algoritmo.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -26,19 +26,19 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si el algoritmo utilizado es un algoritmo por bloques, y &false;
si es un algoritmo por flujo.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-is-block-mode">
<refnamediv>
@@ -16,10 +16,10 @@
<type>bool</type><methodname>mcrypt_enc_is_block_mode</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Comprueba si el modo devuelve los datos por bloques (por ejemplo, &true; para <literal>"cbc"</literal>
y <literal>"ecb"</literal>, y &false; para <literal>"cfb"</literal> y un flujo).
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,19 +27,19 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si el modo devuelve bloques de bytes,
o bien &false; si solo devuelve bytes.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-enc-self-test">
<refnamediv>
@@ -16,9 +16,9 @@
<type>int</type><methodname>mcrypt_enc_self_test</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Realiza una prueba del módulo abierto y designado por <parameter>td</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -26,19 +26,19 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve <literal>0</literal> en caso de éxito o un &integer; negativo en
caso de fallo.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-encrypt">
<refnamediv>
@@ -22,10 +22,10 @@
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>iv</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mcrypt_encrypt</function> cifra los datos y devuelve
los datos cifrados.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -40,27 +40,27 @@
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
La clave con la que se cifrarán los datos. Si el tamaño de la clave
proporcionada no es compatible con el cipher, la función emitirá un
warning y devolverá &false;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
Los datos que se cifrarán, con el <parameter>cipher</parameter> y el
<parameter>mode</parameter> indicado.
Si el tamaño de los datos no es un múltiplo del tamaño de bloque,
los datos se rellenarán con caracteres '<literal>\0</literal>',
según sea necesario.
</para>
<para>
</simpara>
<simpara>
El texto cifrado devuelto puede ser más largo que el tamaño de los datos
pasados como argumento a través de <parameter>data</parameter>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -80,9 +80,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve los datos cifrados, como &string; &return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-generic-deinit">
<refnamediv>
@@ -17,12 +17,12 @@
<type>bool</type><methodname>mcrypt_generic_deinit</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Prepara el módulo de cifrado <parameter>td</parameter> para la descarga.
Todos los búferes se vacían, pero el módulo no se descarga.
Se debe llamar a <function>mcrypt_module_close</function> manualmente
(aunque PHP lo hará por usted al final del script).
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,9 +31,9 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -41,9 +41,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-generic-init">
<refnamediv>
@@ -18,11 +18,11 @@
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><type>string</type><parameter>iv</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Se debe llamar a <function>mcrypt_generic_init</function>
antes de cada llamada a <function>mcrypt_generic</function> o
<function>mdecrypt_generic</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -30,25 +30,25 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
El tamaño máximo de la clave debe ser el devuelto por
<function>mcrypt_enc_get_key_size</function> y todos los valores
inferiores también serán válidos.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>iv</parameter></term>
<listitem>
<para>
<simpara>
El vector de inicialización (VI) debe tener el tamaño de un bloque,
pero se debe leer su tamaño llamando a
<function>mcrypt_enc_get_iv_size</function>. VI es ignorado en modo
@@ -58,20 +58,20 @@
El mismo VI debe ser utilizado para el cifrado y el descifrado.
Si no se desea utilizar, se puede rellenar con ceros, pero
no se recomienda.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un valor negativo en caso de error: -3 si el tamaño
de la clave es incorrecto, -4 cuando hay un problema de asignación de
memoria y cualquier otro valor en caso de error desconocido. Si ocurre un
error, se muestra una alerta. &false; es devuelto si se pasan parámetros
incorrectos a la función.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-generic">
<refnamediv>
@@ -18,15 +18,15 @@
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mcrypt_generic</function> cifra los datos
<parameter>data</parameter>. Los datos se completan
con "<literal>\0</literal>" para obtener un tamaño múltiplo del tamaño
de un bloque. Devuelve los datos cifrados. Tenga en cuenta que la longitud
del string devuelto puede ser más larga que la
pasada como argumento, debido al relleno.
</para>
<para>
</simpara>
<simpara>
Si se desea almacenar los datos cifrados en una base de datos
asegúrese de almacenar el string completo devuelto por esta función,
de lo contrario el string no se descifrará correctamente. Si el string original
@@ -36,15 +36,15 @@
Tenga en cuenta que el string devuelto por <function>mdecrypt_generic</function> tendrá
16 caracteres de longitud... utilice <literal>rtrim($str, "\0")</literal>
para eliminar el relleno.
</para>
<para>
</simpara>
<simpara>
Por ejemplo, si se almacenan los datos en una base de datos MySQL,
recuerde que los campos de tipo VARCHAR eliminan automáticamente los
espacios adicionales durante la inserción. Como los datos cifrados pueden
terminar con un espacio (ASCII 32), los datos se dañarán por esta
eliminación. Almacene los datos en un campo de tipo TINYBLOB/TINYTEXT
(o más grande) para que todo funcione normalmente.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -53,25 +53,25 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
<para>
</simpara>
<simpara>
El manejador de cifrado <parameter>td</parameter> debe ser
inicializado con la función <function>mcrypt_generic_init</function>,
con una clave y un VI, antes de llamar a esta función. Cuando el cifrado
se realiza, se deben liberar los buffers llamando a la función
<function>mcrypt_generic_deinit</function>.
Consulte <function>mcrypt_module_open</function> para un ejemplo.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
Los datos a cifrar.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -79,9 +79,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve los datos cifrados.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-get-block-size">
<refnamediv>
@@ -22,22 +22,22 @@
<methodparam><type>string</type><parameter>cipher</parameter></methodparam>
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
El primer prototipo se utiliza cuando PHP está compilado con la biblioteca
libmcrypt 2.2.x, el segundo cuando está compilado con
libmcrypt 2.4.x o 2.5.x.
</para>
<para>
</simpara>
<simpara>
<function>mcrypt_get_block_size</function> sirve para leer el tamaño
de bloques del cifrado <parameter>cipher</parameter> (en
combinación con un modo de cifrado).
</para>
<para>
</simpara>
<simpara>
Se recomienda utilizar la función
<function>mcrypt_enc_get_block_size</function>,
ya que utiliza el recurso devuelto por
<function>mcrypt_module_open</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -60,19 +60,19 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Lee el tamaño de bloque, en forma de un &integer;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Ejemplo con <function>mcrypt_get_block_size</function></title>
<para>
<simpara>
Este ejemplo muestra cómo utilizar esta función cuando PHP
está compilado con libmcrypt 2.4.x y 2.5.x.
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-get-cipher-name">
<refnamediv>
@@ -21,16 +21,16 @@
<type>string</type><methodname>mcrypt_get_cipher_name</methodname>
<methodparam><type>string</type><parameter>cipher</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mcrypt_get_cipher_name</function> devuelve el nombre del cifrado
utilizado.
</para>
<para>
</simpara>
<simpara>
<function>mcrypt_get_cipher_name</function> toma el número de
cifrado (con libmcrypt 2.2.x) o toma el nombre del cifrado
(con libmcrypt 2.4.x) como argumento, y devuelve el nombre del
cifrado, o &false;, si no existe.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -47,9 +47,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Esta función devuelve el nombre del cipher o &false; si el cipher no existe.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-get-iv-size">
<refnamediv>
@@ -18,15 +18,15 @@
<methodparam><type>string</type><parameter>cipher</parameter></methodparam>
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mcrypt_get_iv_size</function> retorna el tamaño del
vector de inicialización (VI). Si el algoritmo no utiliza
un vector de inicialización, se retorna cero.
</para>
<para>
</simpara>
<simpara>
Es más útil utilizar la función <function>mcrypt_enc_get_iv_size</function>,
ya que utiliza el recurso retornado por <function>mcrypt_module_open</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,11 +42,11 @@
<term><parameter>mode</parameter></term>
<listitem>
&mcrypt.parameter.mode;
<para>
<simpara>
El VI es ignorado en modo ECB, ya que este modo no lo requiere.
Debe tener el mismo VI (punto de partida) durante el cifrado
y el descifrado, de lo contrario, el cifrado fallará.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -54,11 +54,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Retorna el tamaño del vector de inicialización (VI), en bytes.
En caso de error, la función retorna &false;. Si el vector de inicialización
no es necesario, se retorna 0.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-get-key-size">
<refnamediv>
@@ -22,19 +22,19 @@
<methodparam><type>string</type><parameter>cipher</parameter></methodparam>
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
La primera sintaxis utiliza libmcrypt 2.2.x, y la segunda
libmcrypt 2.4.x o posterior.
</para>
<para>
</simpara>
<simpara>
<function>mcrypt_get_key_size</function> se utiliza para obtener el tamaño de
la clave del cifrado <parameter>cipher</parameter>.
</para>
<para>
</simpara>
<simpara>
Es más interesante utilizar la función
<function>mcrypt_enc_get_key_size</function> ya que utiliza el recurso
devuelto por la función <function>mcrypt_module_open</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -57,10 +57,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el tamaño máximo soportado para una clave del algoritmo, en bytes
&return.falseforfailure;.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -74,11 +74,11 @@ echo mcrypt_get_key_size('tripledes', 'ecb');
?>
]]>
</programlisting>
<para>
<simpara>
El ejemplo anterior muestra el uso de la función
cuando ha sido compilada con la biblioteca
2.4.x o 2.5.x.
</para>
</simpara>
&example.outputs;
<screen>
<![CDATA[

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-list-algorithms">
<refnamediv>
@@ -17,9 +17,9 @@
<type>array</type><methodname>mcrypt_list_algorithms</methodname>
<methodparam choice="opt"><type>string</type><parameter>lib_dir</parameter><initializer>ini_get("mcrypt.algorithms_dir")</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Lista todos los algoritmos de cifrado de <parameter>lib_dir</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,11 +28,11 @@
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
<simpara>
Especifica el directorio donde se encuentran los algoritmos. Si se omite,
se utiliza el valor de la directiva <literal>mcrypt.algorithms_dir</literal> del fichero
&php.ini;.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -40,9 +40,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un array con los algoritmos soportados.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-list-modes">
<refnamediv>
@@ -17,9 +17,9 @@
<type>array</type><methodname>mcrypt_list_modes</methodname>
<methodparam choice="opt"><type>string</type><parameter>lib_dir</parameter><initializer>ini_get("mcrypt.modes_dir")</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Lista todos los modos de cifrado de <parameter>lib_dir</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,11 +28,11 @@
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
<simpara>
Especifica el directorio donde se encuentran todos los modos.
Si se omite, se utiliza el valor de la directiva <literal>mcrypt.modes_dir</literal>
en el &php.ini;.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -40,9 +40,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un array con todos los modos soportados.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -60,13 +60,13 @@ foreach ($modes as $mode) {
?>
]]>
</programlisting>
<para>
<simpara>
El ejemplo anterior mostrará todos los modos soportados
en el directorio por omisión. Si el modo no está definido
por la directiva <literal>mcrypt.modes_dir</literal> del &php.ini;,
se utilizará el directorio por omisión de mcrypt (el directorio
<filename>/usr/local/lib/libmcrypt</filename>).
</para>
</simpara>
</example>
</refsect1>
</refentry>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-close">
<refnamediv>
@@ -16,9 +16,9 @@
<type>bool</type><methodname>mcrypt_module_close</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Libera el módulo <parameter>td</parameter>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -26,18 +26,18 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
El recurso de cifrado.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-get-algo-block-size">
<refnamediv>
@@ -17,9 +17,9 @@
<methodparam><type>string</type><parameter>algorithm</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>lib_dir</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve el tamaño de bloques de un algoritmo.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,27 +27,27 @@
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
<simpara>
El nombre del algoritmo.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
<simpara>
El parámetro opcional <parameter>lib_dir</parameter> contiene la
ruta de acceso hasta el módulo del algoritmo en el sistema.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el tamaño de bloques de un algoritmo, en bytes.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-get-algo-key-size">
<refnamediv>
@@ -17,9 +17,9 @@
<methodparam><type>string</type><parameter>algorithm</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>lib_dir</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve el tamaño máximo de clave.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -27,28 +27,28 @@
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
<simpara>
El nombre del algoritmo.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
<simpara>
El parámetro opcional <parameter>lib_dir</parameter> contiene la ruta
hasta el módulo del algoritmo en el sistema.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el tamaño máximo de la clave soportada por el algoritmo
<parameter>algorithm</parameter>.
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-get-supported-key-sizes">
<refnamediv>
@@ -18,13 +18,13 @@
<methodparam><type>string</type><parameter>algorithm</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>lib_dir</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Devuelve un array que contiene los tamaños de claves soportados por
el algoritmo de cifrado <parameter>algorithm</parameter>.
Si devuelve un array vacío, entonces todas las claves entre
1 y <function>mcrypt_module_get_algo_key_size</function> son
soportadas por el algoritmo.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -32,19 +32,19 @@
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
<simpara>
El algoritmo a utilizar.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
<simpara>
El parámetro opcional
<parameter>lib_dir</parameter> puede contener la ruta de acceso
del directorio de instalación del módulo, en el sistema.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -52,13 +52,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un array que contiene los tamaños de claves soportados por
el algoritmo de cifrado <parameter>algorithm</parameter>.
Si devuelve un array vacío, entonces todas las claves entre
1 y <function>mcrypt_module_get_algo_key_size</function> son
soportadas por el algoritmo.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-is-block-algorithm-mode">
<refnamediv>
@@ -18,11 +18,11 @@
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>lib_dir</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Esta función devuelve &true; si el modo debe ser utilizado
con un algoritmo por bloques, de lo contrario, devuelve &false;
(i.e. &false; para un flujo, y &true; para cbc, cfb, ofb).
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -30,19 +30,19 @@
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
<simpara>
El modo a verificar.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
<simpara>
El argumento opcional <parameter>lib_dir</parameter>
puede contener el directorio donde los módulos de algoritmo
se encuentran en el sistema.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -50,11 +50,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Esta función devuelve &true; si el modo debe ser utilizado
con un algoritmo por bloques, de lo contrario, devuelve &false;
(i.e. &false; para un flujo, y &true; para cbc, cfb, ofb).
</para>
</simpara>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-is-block-algorithm">
<refnamediv>
@@ -18,11 +18,11 @@
<methodparam><type>string</type><parameter>algorithm</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>lib_dir</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mcrypt_module_is_block_algorithm</function> devuelve &true;
si <parameter>algorithm</parameter> es un algoritmo por bloques,
o &false; si es un algoritmo por flujo.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,19 +31,19 @@
<varlistentry>
<term><parameter>algorithm</parameter></term>
<listitem>
<para>
<simpara>
El algoritmo a verificar.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
<simpara>
El parámetro opcional <parameter>lib_dir</parameter>
puede contener la ruta donde se encuentran los módulos de los algoritmos
en el disco del sistema.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -51,10 +51,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si el algoritmo especificado es un algoritmo por bloques
o &false; si es un algoritmo por flujo.
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-is-block-mode">
<refnamediv>
@@ -18,12 +18,12 @@
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>lib_dir</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Esta función devuelve &true; si este modo proporciona bloques de bytes o
&false; si solo produce bytes.
(i.e. &true; para <literal>"cbc"</literal> y <literal>"ecb"</literal>,
y &false; para <literal>"cfb"</literal> y <literal>"stream"</literal>).
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,10 +38,10 @@
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
<simpara>
El parámetro opcional <parameter>lib_dir</parameter> contiene
la ruta de acceso hasta el módulo del algoritmo en el sistema.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -49,12 +49,12 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Esta función devuelve &true; si este modo proporciona bloques de bytes o
&false; si solo produce bytes.
(i.e. &true; para <literal>"cbc"</literal> y <literal>"ecb"</literal>,
y &false; para <literal>"cfb"</literal> y <literal>"stream"</literal>).
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-open">
<refnamediv>
@@ -20,13 +20,13 @@
<methodparam><type>string</type><parameter>mode</parameter></methodparam>
<methodparam><type>string</type><parameter>mode_directory</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mcrypt_module_open</function> abre el módulo del algoritmo
y del modo a utilizar. El nombre del algoritmo se especifica mediante el parámetro
<parameter>algorithm</parameter> (por ejemplo: <literal>"twofish"</literal>),
o bien una de las constantes <constant>MCRYPT_ciphername</constant>. La biblioteca se cierra
al llamar a <function>mcrypt_module_close</function>.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,7 +41,7 @@
<varlistentry>
<term><parameter>algorithm_directory</parameter></term>
<listitem>
<para>
<simpara>
El parámetro <parameter>algorithm_directory</parameter> se utiliza
para localizar el módulo de cifrado. Cuando se especifica un
nombre de directorio, se utilizará. Si se especifica una cadena vacía
@@ -49,7 +49,7 @@
<literal>mcrypt.algorithms_dir</literal> del fichero &php.ini;. Cuando no está definida, el directorio por omisión utilizado
será aquel en el que se encuentre la biblioteca libmcrypt
(habitualmente, <filename>/usr/local/lib/libmcrypt</filename>).
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
@@ -61,7 +61,7 @@
<varlistentry>
<term><parameter>mode_directory</parameter></term>
<listitem>
<para>
<simpara>
El parámetro <parameter>mode_directory</parameter> se utiliza para localizar
el módulo de cifrado. Si se especifica un nombre de directorio, se utilizará.
Cuando se especifica una cadena vacía (<literal>""</literal>), se utilizará el valor
@@ -69,7 +69,7 @@
Si no está definida, el directorio por omisión utilizado
será aquel en el que se encuentre la biblioteca libmcrypt
(habitualmente <filename>/usr/local/lib/libmcrypt</filename>).
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -77,10 +77,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Normalmente, esta función devuelve un descriptor de cifrado, o
&false; si ocurre un error.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -98,13 +98,13 @@ $td = mcrypt_module_open('rijndael-256', '', 'ofb', '');
]]>
</programlisting>
</example>
<para>
<simpara>
La primera línea del ejemplo anterior intentará abrir el cifrado
<literal>DES</literal>, en el directorio por omisión, y el modo <literal>ECB</literal> en el directorio
<filename>/usr/lib/mcrypt-modes</filename>. El segundo ejemplo utiliza
las cadenas como nombre para el cifrado y el modo. Esto solo funciona
si la extensión está compilada con libmcrypt 2.4.x o 2.5.x.
</para>
</simpara>
<example>
<title>Utilización de <function>mcrypt_module_open</function> para cifrar</title>
<programlisting role="php">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mcrypt-module-self-test">
<refnamediv>
@@ -18,9 +18,9 @@
<methodparam><type>string</type><parameter>algorithm</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>lib_dir</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Realiza una prueba sobre el algoritmo especificado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -35,10 +35,10 @@
<varlistentry>
<term><parameter>lib_dir</parameter></term>
<listitem>
<para>
<simpara>
El argumento opcional <parameter>lib_dir</parameter> contiene
la ruta de acceso hasta el módulo del algoritmo en el sistema.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -46,9 +46,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si la prueba funciona, y &false; en caso contrario.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mdecrypt-generic">
<refnamediv>
@@ -18,11 +18,11 @@
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Desencripta los datos <parameter>data</parameter>. Tenga en cuenta que la longitud
del string desencriptado puede ser más larga que el string original, ya que
puede haber sido completado con caracteres.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -31,18 +31,18 @@
<varlistentry>
<term><parameter>td</parameter></term>
<listitem>
<para>
<simpara>
Un descriptor de cifrado, devuelto por la función
<function>mcrypt_module_open</function>
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
<simpara>
Los datos cifrados.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -50,9 +50,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el string desencriptado.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -97,21 +97,21 @@ if (strncmp($p_t, $plain_text, strlen($plain_text)) == 0) {
]]>
</programlisting>
</example>
<para>
<simpara>
El ejemplo anterior muestra cómo verificar que los datos antes
del cifrado son los mismos que después del
cifrado/descifrado. Es muy importante reiniciar
el buffer de cifrado con <function>mcrypt_generic_init</function>
antes de descifrar los datos.
</para>
<para>
</simpara>
<simpara>
El gestor de descifrado debe ser siempre inicializado
por la función <function>mcrypt_generic_init</function> con una clave
y un VI antes de llamar a esta función. Cuando el cifrado está hecho,
es necesario liberar los datos cifrados llamando
a <function>mcrypt_generic_deinit</function>.
Consulte <function>mcrypt_module_open</function> para un ejemplo.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6126b024cb929b12ea29d9676671e4dde342f03d Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="mcrypt.configuration">
&reftitle.runtime;
@@ -44,12 +44,12 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
El directorio que contiene los algoritmos. Por omisión es el directorio indicado durante la
compilación de libmcrypt, típicamente se trata de
<emphasis>/usr/local/lib/libmcrypt</emphasis>. Consulte
<function>mcrypt_list_algorithms</function> para más detalles.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mcrypt.modes-dir">
@@ -58,12 +58,12 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
El directorio que contiene los modos. Por omisión es el directorio indicado durante la
compilación de libmcrypt, típicamente se trata de
<emphasis>/usr/local/lib/libmcrypt</emphasis>. Consulte
<function>mcrypt_list_modes</function> para más detalles.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>

View File

@@ -1,36 +1,35 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bd9add30afc7ba7013cc222ca397cba114a554eb Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: e849a6c4225bd992474793ec6983df7898cae0be Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<chapter xml:id="mcrypt.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="mcrypt.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="mcrypt.requirements">
&reftitle.required;
<para>
<simpara>
Estas funciones utilizan <link xlink:href="&url.mcrypt;">mcrypt</link>.
Para utilizar esta biblioteca, descargue
el fichero <filename>libmcrypt-x.x.tar.gz</filename> desde
<link xlink:href="&url.mcrypt;">&url.mcrypt;</link>
y siga las instrucciones de instalación proporcionadas.
</para>
</simpara>
<simpara>
Se requiere la versión 2.5.6 o posterior de la biblioteca libmcrypt.
</simpara>
<para>
<simpara>
Los usuarios de Windows encontrarán la biblioteca en la versión Windows
de PHP 5.3. La versión binaria de Windows de PHP 5.3 utiliza la versión estática
de la biblioteca MCrypt, no se necesita ninguna DLL.
</para>
<para>
</simpara>
<simpara>
Si se compila PHP con la biblioteca <literal>libmcrypt 2.4.x</literal>,
se admiten los siguientes algoritmos: <literal>"CAST"</literal>, <literal>"LOKI97"</literal>, <literal>"RIJNDAEL"</literal>, <literal>"SAFERPLUS"</literal>,
<literal>"SERPENT"</literal> así como los siguientes cifrados: <literal>"ENIGMA"</literal> (cifrado), <literal>"PANAMA"</literal>,
<literal>"RC4"</literal> y <literal>"WAKE"</literal>. Con <literal>libmcrypt 2.4.x</literal> otro modo de cifrado
está disponible: <literal>"nOFB"</literal>.
</para>
</simpara>
</section>
<!-- }}} -->
@@ -45,14 +44,13 @@
<!-- {{{ Resources -->
<section xml:id="mcrypt.resources">
&reftitle.resources;
<para>
<simpara>
<function>mcrypt_module_open</function> devuelve un puntero de cifrado.
</para>
</simpara>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml