Files
2024-03-10 19:54:07 -03:00

162 lines
4.8 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f80105b4fc1196bd8d5fecb98d686b580b1ff65d Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
<appendix xml:id="mcrypt.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<para>
Mcrypt pode operar em quatro modos de cifra de bloco (<literal>CBC</literal>,
<literal>OFB</literal>, <literal>CFB</literal> e
<literal>ECB</literal>). Se vinculado à libmcrypt-2.4.x ou superior, as
funções também podem operar no modo de cifra de bloco <literal>nOFB</literal>
e no modo <literal>STREAM</literal>. Abaixo você encontra uma lista com todos
modos de criptografia suportados juntamente com as constantes que são
definidas para o modo de criptografia. Para uma referência mais completa e
discussão, consulte &book.applied.cryptography;.
<itemizedlist>
<listitem>
<simpara>
<constant>MCRYPT_MODE_ECB</constant> (<literal>electronic
codebook</literal>) é um modo de cifra de bloco geralmente
inadequado para a maioria dos propósitos. O uso deste modo não é recomendado.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>MCRYPT_MODE_CBC</constant> (<literal>cipher block
chaining</literal>) é um modo de cifra de bloco significativamente
mais seguro do que o modo <literal>ECB</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>MCRYPT_MODE_CFB</constant> (<literal>cipher
feedback, em modo de 8 bits</literal>) é um modo de cifra de fluxo.
É recomendado usar o modo <literal>NCFB</literal> em vez de
modo <literal>CFB</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>MCRYPT_MODE_OFB</constant> (<literal>output feedback, em
modo de 8 bits</literal>) é um modo de cifra de fluxo comparável a <literal>CFB</literal>, mas
pode ser usado em aplicações onde a propagação de erros não pode
ser tolerada.
Recomenda-se usar o modo <literal>NOFB</literal> em vez de
modo <literal>OFB</literal>.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>MCRYPT_MODE_NOFB</constant> (<literal>output feedback,
em modo n-bit</literal>) é comparável ao modo <literal>OFB</literal>,
mas opera no tamanho completo do bloco do algoritmo.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>MCRYPT_MODE_STREAM</constant> é um modo extra para incluir
alguns algoritmos de fluxo como <literal>"WAKE"</literal> ou <literal>"RC4"</literal>.
</simpara>
</listitem>
</itemizedlist>
</para>
<para>
Mcrypt suporta alguns outros modos de operação para os quais não existem constantes predefinidas.
Eles podem ser utilizados passando uma string no lugar das constantes ausentes.
<itemizedlist>
<listitem>
<simpara>
<literal>"ctr"</literal> (<literal>counter mode</literal>) é um modo de cifra de fluxo.
</simpara>
</listitem>
<listitem>
<simpara>
<literal>"ncfb"</literal> (<literal>cipher feedback,
em modo n-bit</literal>) é comparável ao modo <literal>CFB</literal>,
mas opera no tamanho completo do bloco do algoritmo.
</simpara>
</listitem>
</itemizedlist>
</para>
<para>
Algumas outras constantes de modo e dispositivo aleatório:
<variablelist>
<varlistentry xml:id="constant.mcrypt-encrypt">
<term>
<constant>MCRYPT_ENCRYPT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.mcrypt-decrypt">
<term>
<constant>MCRYPT_DECRYPT</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.mcrypt-dev-random">
<term>
<constant>MCRYPT_DEV_RANDOM</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.mcrypt-dev-urandom">
<term>
<constant>MCRYPT_DEV_URANDOM</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.mcrypt-rand">
<term>
<constant>MCRYPT_RAND</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</appendix>
<!-- 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:
-->