constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 86e6094e86b84a51d00ab217ac50ce8dde33d82a Maintainer: hirokawa Status: ready -->
<!-- Credits: mumumu -->
<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>

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