Files
doc-fr/reference/mcrypt/functions/mcrypt-generic-init.xml
Yannick Torres 45907f7c5c clef => clé
#bien plus joli non ? ;)


git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@175202 c90b9560-bf6c-de11-be94-00142212c4b1
2004-12-20 21:10:58 +00:00

71 lines
2.5 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<!-- EN-Revision: 1.6 Maintainer: didou Status: ready -->
<!-- Reviewed: yes -->
<refentry id="function.mcrypt-generic-init">
<refnamediv>
<refname>mcrypt_generic_init</refname>
<refpurpose>
Initialise tous les buffers nécessaires
</refpurpose>
</refnamediv>
<refsect1>
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>mcrypt_generic_init</methodname>
<methodparam><type>resource</type><parameter>td</parameter></methodparam>
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam><type>string</type><parameter>iv</parameter></methodparam>
</methodsynopsis>
<para>
La taille maximale de la clé doit être celle retournée par
<function>mcrypt_enc_get_key_size</function> et toutes les valeurs
inférieures seront aussi valides. Le vecteur d'initialisation (VI)
doit avoir la taille d'un bloc, mais vous devez lire sa taille
en appelant <function>mcrypt_enc_get_iv_size</function>.
IV est ignoré en mode ECB. IV DOIT exister en modes CFB, CBC, STREAM, nOFB
et OFB. Il doit être aléatoire et unique (mais pas secret).
Le même VI doit être utilisé pour le chiffrement et le
déchiffrement.
Si vous ne voulez pas l'utiliser, remplissez-le de zéros, mais
ce n'est pas recommandé.
</para>
<para>
La fonction retourne une valeur négative en cas d'erreur : -3 si la taille
de la clé est incorrecte, -4 quand il y a eu un problème d'allocation de
mémoire et toute autre valeur en cas d'erreur inconnue. Si une erreur
survient, un warning est affiché. &false; est retourné si des paramètres incorrects
sont passés à la fonction.
</para>
<para>
Vous devez appeler <function>mcrypt_generic_init</function>
avant chaque appel à <function>mcrypt_generic</function> ou
<function>mdecrypt_generic</function>.
</para>
<para>
Pour un exemple, voir <function>mcrypt_module_open</function>.
</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:"../../../../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
-->