CVS update: php3/doc/functions

Date: Tuesday May 4, 1999 @ 10:47 Author: sas Update of /repository/php3/doc/functions In directory php:/tmp/cvs-serv2017/functions Modified Files: mcrypt.sgml Log Message: some docu changes Index: php3/doc/functions/mcrypt.sgml diff -u php3/doc/functions/mcrypt.sgml:1.3 php3/doc/functions/mcrypt.sgml:1.4 --- php3/doc/functions/mcrypt.sgml:1.3 Sun May 2 11:25:07 1999 +++ php3/doc/functions/mcrypt.sgml Tue May 4 10:47:41 1999 @@ -10,7 +10,7 @@ <para> This is an interface to the mcrypt library. mcrypt supports a wide area of block algorithms such as DES, TripleDES, Blowfish - (default), 3-WAY, SAFER-SK64,SAFER-SK128, TWOFISH, TEA, RC2 and + (default), 3-WAY, SAFER-SK64, SAFER-SK128, TWOFISH, TEA, RC2 and GOST in CBC, OFB, CFB and ECB cipher modes. Additionally, it supports RC6 and IDEA which are considered "non-free". @@ -48,7 +48,7 @@ <para> mcrypt can operate in four cipher modes (CBC, OFB, CFB, and ECB). We will outline the normal use for each of these modes. For a more complete - reference and discussion see Applied Cryptography by Bruce Schneier. + reference and discussion see &book.applied.cryptography;. <itemizedlist> <listitem><simpara> @@ -125,20 +125,21 @@ </itemizedlist> <para> - In CFB and OFB cipher mode (optional in CBC), you need an initialization - vector (IV). The IV must be unique and must be the same when - decrypting/encrypting. With data which is stored encrypted, you can take - the output of a function of the index under which the data is stored (e.g. - the MD5 key of the filename). Alternatively, you can transmit the IV - together with the encrypted data (see chapter 9.3 of Applied Cryptography - for more information). + You must (in CFB and OFB mode) or can (in CBC mode) supply an + initialization vector (IV) to the respective cipher function. The IV must + be unique and must be the same when decrypting/encrypting. With data which + is stored encrypted, you can take the output of a function of the index + under which the data is stored (e.g. the MD5 key of the filename). + Alternatively, you can transmit the IV together with the encrypted data + (see chapter 9.3 of &book.applied.cryptography; for a discussion of this + topic). </partintro> <refentry id="function.mcrypt-get-cipher-name"> <refnamediv> <refname>mcrypt_get_cipher_name</refname> - <refpurpose>Get the name of the respective cipher</refpurpose> + <refpurpose>Get the name of the specified cipher</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -148,8 +149,8 @@ </funcsynopsis> <para> - <function>mcrypt_get_cipher_name</function> is used to get the name of a - specific cipher. + <function>mcrypt_get_cipher_name</function> is used to get the name of the + specified cipher. <para> <function>mcrypt_get_cipher_name</function> takes the cipher number as an @@ -179,7 +180,7 @@ <refentry id="function.mcrypt-get-block-size"> <refnamediv> <refname>mcrypt_get_block_size</refname> - <refpurpose>Gets the block size of a specific cipher</refpurpose> + <refpurpose>Get the block size of the specified cipher</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -190,7 +191,7 @@ <para> <function>mcrypt_get_block_size</function> is used to get the size of a - block of a <parameter>cipher</parameter>. + block of the specified <parameter>cipher</parameter>. <para> <function>mcrypt_get_block_size</function> takes one argument, the @@ -202,7 +203,7 @@ <refentry id="function.mcrypt-get-key-size"> <refnamediv> <refname>mcrypt_get_key_size</refname> - <refpurpose>Gets the key size of a specific cipher</refpurpose> + <refpurpose>Get the key size of the specified cipher</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -213,7 +214,7 @@ <para> <function>mcrypt_get_key_size</function> is used to get the size of a key - of a <parameter>cipher</parameter>. + of the specified <parameter>cipher</parameter>. <para> <function>mcrypt_get_key_size</function> takes one argument, the -- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe@lists.php.net For help: php-dev-help@lists.php.net