CVS update: php3/doc/functions

Date: Sunday May 2, 1999 @ 11:25 Author: sas Update of /repository/php3/doc/functions In directory php:/tmp/cvs-serv27544/functions Modified Files: mcrypt.sgml Log Message: some documentation changes Index: php3/doc/functions/mcrypt.sgml diff -u php3/doc/functions/mcrypt.sgml:1.2 php3/doc/functions/mcrypt.sgml:1.3 --- php3/doc/functions/mcrypt.sgml:1.2 Sun May 2 06:36:30 1999 +++ php3/doc/functions/mcrypt.sgml Sun May 2 11:25:07 1999 @@ -6,7 +6,7 @@ <para> These functions are intended for work with <ulink url="&url.mcrypt;">mcrypt</ulink>. - + <para> This is an interface to the mcrypt library. mcrypt supports a wide area of block algorithms such as DES, TripleDES, Blowfish @@ -15,12 +15,11 @@ supports RC6 and IDEA which are considered "non-free". <para> - To use it, get mcrypt-x.x.x.tar.gz from <ulink - url="ftp://argeas.cs-net.gr/pub/unix/mcrypt/">here</ulink> and - follow the included installation instructions. After compilation, - copy lib/mcrypt.h to /usr/local/include and lib/libmcrypt.a to - /usr/local/lib. You need to compile PHP with the --with-mcrypt - parameter to enable this extension. + To use it, download mcrypt-x.x.x.tar.gz from <ulink + url="&url.mcrypt;">here</ulink> and follow the included installation + instructions. After compilation, copy lib/mcrypt.h to /usr/local/include + and lib/libmcrypt.a to /usr/local/lib. You need to compile PHP with the + --with-mcrypt parameter to enable this extension. <para> mcrypt can be used to encrypt and decrypt using the above @@ -59,7 +58,7 @@ <listitem><simpara> CBC (cipher block chaining) is especially suitable for encrypting files - where the security is increased significantly. + where the security is increased over ECB significantly. <listitem><simpara> CFB (cipher feedback) is the best mode for encrypting byte streams where @@ -71,14 +70,60 @@ </itemizedlist> <para> - PHP does not support handling byte streams currently. Only complete strings - are supported as of now. + PHP does not support encrypting/decrypting bit streams currently. As of + now, PHP only supports handling of strings. <para> For a complete list of supported ciphers, see the defines at the end of mcrypt.h. The general rule is that you can access the cipher from PHP with MCRYPT_ciphername. + <para> + Here is a short list of ciphers which are currently supported by + PHP3/mcrypt. If a cipher is not listed here, but is listed by mcrypt as + supported, you can safely assume that this documentation is outdated. + + <itemizedlist> + + <listitem><simpara> + MCRYPT_BLOWFISH + <listitem><simpara> + MCRYPT_DES + <listitem><simpara> + MCRYPT_TripleDES + <listitem><simpara> + MCRYPT_ThreeWAY + <listitem><simpara> + MCRYPT_GOST + <listitem><simpara> + MCRYPT_CRYPT + <listitem><simpara> + MCRYPT_DES_COMPAT + <listitem><simpara> + MCRYPT_SAFER64 + <listitem><simpara> + MCRYPT_SAFER128 + <listitem><simpara> + MCRYPT_CAST128 + <listitem><simpara> + MCRYPT_TEAN + <listitem><simpara> + MCRYPT_RC2 + <listitem><simpara> + MCRYPT_TWOFISH (for older mcrypt 2.x versions) + <listitem><simpara> + MCRYPT_TWOFISH128 + <listitem><simpara> + MCRYPT_TWOFISH192 + <listitem><simpara> + MCRYPT_TWOFISH256 + <listitem><simpara> + MCRYPT_RC6 (if you compiled mcrypt with --enable-non-free) + <listitem><simpara> + MCRYPT_IDEA (if you compiled mcrypt with --enable-non-free) + + </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 -- 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