<?xml version="1.0" encoding="utf-8"?>

<appendix xml:id="mcrypt.constants" xmlns="http://docbook.org/ns/docbook">

&reftitle.constants;

&extension.constants;

<para>

mcryptは 4 つのブロック暗号モード(<literal>CBC</literal>, <literal>OFB</literal>,

<literal>CFB</literal>, <literal>ECB</literal>)で実行可能です。

libmcrypt-2.4.x 以降にリンクした場合、ブロック暗号モード <literal>nOFG</literal> と

<literal>STREAM</literal> モードでも実行可能です。MCRYPT_MODE_mode 形式を関数で使用する

際には、いくつかの制約があります。ここで、これらの各モードの通常の

使用法の概要を示します。詳細なリファレンスおよび議論に関しては、

&book.applied.cryptography; を参照ください。

<itemizedlist>

<listitem>

<simpara>

<constant>MCRYPT_MODE_ECB</constant> (<literal>electronic codebook</literal>) は、

一般的にはほとんどの用途に合わないブロック暗号モードです。

このモードを使うことは推奨しません。

</simpara>

</listitem>

<listitem>

<simpara>

<constant>MCRYPT_MODE_CBC</constant> (<literal>cipher block chaining</literal>)は、<literal>ECB</literal> よりも著しく

セキュアなブロック暗号モードです。

</simpara>

</listitem>

<listitem>

<simpara>

<constant>MCRYPT_MODE_CFB</constant> (<literal>cipher feedback、8 ビット形式</literal>) は、

ストリーム暗号モードです。

<literal>CFB</literal> ではなく、<literal>NCFB</literal> の使用を推奨します。

</simpara>

</listitem>

<listitem>

<simpara>

<constant>MCRYPT_MODE_OFB</constant> (<literal>output feedback、8 ビット形式</literal>) は

<literal>CFB</literal>と互換性が

あるストリーム暗号モードですが、エラーの伝播が許容されないアプリケーションに使用する

ことが可能です。

<literal>OFB</literal> ではなく、

<literal>NOFB</literal> の使用を推奨します。

</simpara>

</listitem>

<listitem>

<simpara>

<constant>MCRYPT_MODE_NOFB</constant> (<literal>output feedback, nビット形式</literal>)

は <literal>OFB</literal> と互換性がありますが、

アルゴリズムのブロックサイズを変更可能です。

</simpara>

</listitem>

<listitem>

<simpara>

<constant>MCRYPT_MODE_STREAM</constant> は、

<literal>"WAKE"</literal> や <literal>"RC4"</literal> のようないくつかのストリーム

アルゴリズムを読み込む追加のモードです。

</simpara>

</listitem>

</itemizedlist>

</para>

<para>

Mcrypt は、あらかじめ定義された定数が存在しない他の操作モードもサポートしています。

これらは不明な定数の代わりに、文字列を渡すことで利用できます。

<itemizedlist>

<listitem>

<simpara>

<constant>"ctr"</constant> (<literal>counter mode</literal>) はストリーム暗号モードです。

</simpara>

</listitem>

<listitem>

<simpara>

<constant>"ncfb"</constant> (<literal>cipher feedback,

n-bit 形式</literal>) は <literal>CFB</literal> と互換性がありますが、

アルゴリズムのブロックサイズを変更可能です。

</simpara>

</listitem>

</itemizedlist>

</para>

<para>

他のモードおよびランダムデバイス定数:

<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>