archived-doc-es/reference/mcrypt/functions/mcrypt-create-iv.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a9cc0450f74f8418b240c83b9c47624d08968943 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mcrypt-create-iv" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>mcrypt_create_iv</refname>
  <refpurpose>Crea un vector de inicialización (IV) desde una fuente aleatoria</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>mcrypt_create_iv</methodname>
   <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>
   Crea un vector de inicialización (IV) desde una fuente aleatoria.
  </para>
  <para>
   El IV está destinado sólo a proveer una semilla alternativa a las
   rutinas de cifrado. Este IV no necesita ser secreto en absoluto, aunque
   ello puede ser deseable. Aún asi se lo puede enviar junto con su texto
   cifrado sin perder seguridad.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>size</parameter></term>
     <listitem>
      <para>
       El tamaño del IV.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>source</parameter></term>
     <listitem>
      <para>
       La fuente del IV. El parámetro source puede ser
       <constant>MCRYPT_RAND</constant> (generador de números aleatorios del sistema),
       <constant>MCRYPT_DEV_RANDOM</constant> (lee datos de
       <filename>/dev/random</filename>) y
       <constant>MCRYPT_DEV_URANDOM</constant> (lee datos de
       <filename>/dev/urandom</filename>). Antes de 5.3.0,
       <constant>MCRYPT_RAND</constant> era la única soportada en Windows.
      </para>
      <para>
       Obsérvese que el valor predeterminado de este parámetro era
       <constant>MCRYPT_DEV_RANDOM</constant> antes de PHP 5.6.0.
      </para>
      <note>
       <simpara>
        Observe que <constant>MCRYPT_DEV_RANDOM</constant> podría hacer que la función quede en espera hasta que
        haya más entropía disponible.
       </simpara>
      </note>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve el vector de inicialización, o &false; en caso de error.
  </para>
 </refsect1>
 
 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>5.6.0</entry>
       <entry>
        <constant>MCRYPT_DEV_URANDOM</constant> ahora es el valor predetermniado de
        <parameter>source</parameter>.
       </entry>
      </row>
      <row>
       <entry>5.3.0</entry>
       <entry>
        <constant>MCRYPT_DEV_RANDOM</constant> y
        <constant>MCRYPT_DEV_URANDOM</constant> se volvieron disponibles en plataformas
        Windows.
       </entry>
      </row>
      <row>
       <entry>5.3.0</entry>
       <entry>
        Ya no se requiere invocar primero a <function>srand</function>. Esto ahora
        se realiza de forma automática.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>mcrypt_create_iv</function></title>
    <programlisting role="php">
<![CDATA[
<?php
    $size = mcrypt_get_iv_size(MCRYPT_CAST_256, MCRYPT_MODE_CFB);
    $iv = mcrypt_create_iv($size, MCRYPT_DEV_RANDOM);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><link xlink:href="&url.mcrypt.iv;">&url.mcrypt.iv;</link></member>
    <member><link xlink:href="&url.mcrypt.bcm;">&url.mcrypt.bcm;</link></member>
    <member>Capítulo 9.3 de &book.applied.cryptography;</member>
    <member><function>random_bytes</function></member>
   </simplelist>
  </para>
 </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->