From 4500c66f57bf7c527180c9a21550b3ef047c342e Mon Sep 17 00:00:00 2001 From: Gabor Hojtsy Date: Sat, 23 Dec 2000 16:19:35 +0000 Subject: [PATCH] Correcting a fault of myself... git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@38213 c90b9560-bf6c-de11-be94-00142212c4b1 --- functions/mhash.xml | 168 ++++++++++++++++++++------------------------ 1 file changed, 77 insertions(+), 91 deletions(-) diff --git a/functions/mhash.xml b/functions/mhash.xml index 65d8da77b1..289495bdbd 100644 --- a/functions/mhash.xml +++ b/functions/mhash.xml @@ -1,61 +1,54 @@ - Mhash függvények + Mhash Functions mhash - Ezek a függvények az mhash-el - működnek együtt. + These functions are intended to work with mhash. + + This is an interface to the mhash library. mhash supports a wide + variety of hash algorithms such as MD5, SHA1, GOST, and many + others. - Ezek egy felületet biztosítanak az mhash könyvtárhoz. Az mhash - széles skáláját támogatja a hash algoritmusoknak, mint például - az MD5, SHA1, GOST és számos más. + To use it, download the mhash distribution from its web site and follow the included + installation instructions. You need to compile PHP with the + parameter to enable + this extension. - Ahhoz, hogy használhasd ezeket, le kell töltened az mhash - csomagot az mhash webhelyről - és követned kell a telepítési utasításokat, amiket a csomagban - találsz. A PHP-t a - paraméterrel kell fordítanod, hogy engedélyezd ezt a kiterjesztést. - - - Az mhash például ellenőrzőösszegek, kivonatok, azonosítási kódok - előállítására is használható. + Mhash can be used to create checksums, message digests, message + authentication codes, and more. - Az MD5 kivonat és a hmac előállítása és kiírása hexa formában + Compute the MD5 digest and hmac and print it out as hex -"; $hash = mhash (MHASH_MD5, $input, "Jefe"); print "The hmac is ".bin2hex ($hash)."\n<br>"; -?> -]]> +?> - Ez a következő kimenetet eredményezi: + This will produce: - - A támogatott hash-ek teljes listájához nézd meg az - mhash dokumentációt. Az általános szabály, hogy a hash - algoritmust az MHASH_HASHNEVE formában tudod elérni - PHP-ből. Például a TIGER eléréséhez az MHASH_TIGER - PHP konstans használható. + For a complete list of supported hashes, refer to the + documentation of mhash. The general rule is that you can access + the hash algorithm from PHP with MHASH_HASHNAME. For example, to + access TIGER you use the PHP constant MHASH_TIGER. - Itt következnek az mhash által jelenleg támogatott hash-ek. - Ha találsz az mhash dokumentációban itt nem listázott elemet, - nyugodtan feltételezheted, hogy az használható, és ez a dokumentáció - nem aktuális. + Here is a list of hashes which are currently supported by mhash. If a + hash is not listed here, but is listed by mhash as supported, you can + safely assume that this documentation is outdated. @@ -119,10 +112,10 @@ The hmac is 750c783e6ab0b503eaa86e310a5db738 mhash_get_hash_name - A megadott hash nevét adja vissza + Get the name of the specified hash - Leírás + Description string mhash_get_hash_name @@ -130,27 +123,26 @@ The hmac is 750c783e6ab0b503eaa86e310a5db738 - Az mhash_get_hash_name a megadott hash nevével - tér vissza. + Mhash_get_hash_name is used to get the name + of the specified hash. - Ha az mhash_get_hash_name függvénynek átadott - hash azonosító egy nemlétező hash-re hivatkozik, FALSE értékkel tér vissza. + mhash_get_hash_name takes the hash id as an + argument and returns the name of the hash or false, if the hash + does not exist. - <function>mhash_get_hash_name</function> példa + <function>Mhash_get_hash_name</function> Example - -]]> +?> - Ez a következő kimenetet eredményezi: + The above example will print out: MD5 @@ -161,10 +153,10 @@ MD5 mhash_get_block_size - A megadott hash blokkméretével tér vissza + Get the block size of the specified hash - Leírás + Description int mhash_get_block_size @@ -172,14 +164,13 @@ MD5 - Az mhash_get_block_size a megadott - hash blokkméretét adja vissza - byte-okban mérve. + Mhash_get_block_size is used to get the size + of a block of the specified hash. - Ha az mhash_get_block_size - függvénynek érvénytelen hash - paramétert adsz, FALSE értékkel tér vissza. + Mhash_get_block_size takes one argument, the + hash and returns the size in bytes or + false, if the hash does not exist. @@ -187,10 +178,10 @@ MD5 mhash_count - Visszaadja a legnagyobb elérhető hash azonosítót + Get the highest available hash id - Leírás + Description int mhash_count @@ -198,16 +189,14 @@ MD5 - Az mhash_count visszaadja a legnagyobb elérhető - hash azonosítót. A hash-ek nullától eddig a számig kapnak - azonosító számokat. + Mhash_count returns the highest available hash + id. Hashes are numbered from 0 to this hash id. - Az összes hash használata + Traversing all hashes - +?> @@ -226,10 +215,10 @@ for ($i = 0; $i <= $nr; $i++) { mhash - Hash számítás + Compute hash - Leírás + Description string mhash @@ -239,14 +228,13 @@ for ($i = 0; $i <= $nr; $i++) { - Az mhash alkalmazza a hash - által megadott algoritmust a data paraméterre, és - visszatér az eredmény hash-el (amit kivonatkank [digest-nek] is hívnak). - Ha a key paramétert is megadod, visszaadja - az keletkező HMAC-ot. A HMAC egy kulcsos hash-elés üzenet azonosításra, - vagy csak egyszerűen egy üzenet kivonat ami egy megadott kulcstól - függ. Nem minden mhash algoritmus használható HMAC módban. - Hiba esetén a függvény FALSE értéket ad. + Mhash applies a hash function specified by + hash to the data and + returns the resulting hash (also called digest). If the key + is specified it will return the resulting HMAC. HMAC is keyed hashing + for message authentication, or simply a message digest that depends on + the specified key. Not all algorithms supported in mhash can be used in + HMAC mode. In case of an error returns false. @@ -254,10 +242,10 @@ for ($i = 0; $i <= $nr; $i++) { mhash_keygen_s2k - Kulcsot generál + Generates a key - Leírás + Description string mhash_keygen_s2k @@ -268,24 +256,22 @@ for ($i = 0; $i <= $nr; $i++) { - Az mhash_keygen_s2k egy olyan kulcsot generál, - ami bytes hosszú, és a megadott jelszót - figyelembe véve készül. Az S2K algoritmust használja, ami az OpenPGP - dokumentumban (RFC 2440) definiált. A megadott - hash algortmust használja a kulcs előállítására. - A salt minden generált kulcsra más-más - kell legyen, kellőkképpen véletlenszerű értékekkel, hogy különböző - kulcsok álljanak elő. A salt-nak ismertnek kell lennie, - amikor ellenőrzöd a kulcsokat, tehát jó ötlet ehhez fűzni - a kulcsokat. A salt-nak mindig nyolc karakter hosszúnak kell - lennie, ha rövidebbet adsz meg, nulákkal töltődik fel. - Tartsd szem előtt, hogy a felhasználók által beadott jelszavak - nem túlságosan alkalmasak titkosítási rendszerek kulcsaiként, - mivel a felhasználók általában jól begépelhető kulcsot - választanak. Ezek a jelszavak csak 6-7 bitet (vagy még - kevesebbet) használnak ki karakterenként. Nagyon ajánlott - a beadott jelszóra egy olyan átalakítás használata, mint - ez a függvény. + Mhash_keygen_s2k generates a key that is + bytes long, from a user given password. + This is the Salted S2K algorithm as specified in the OpenPGP + document (RFC 2440). That algorithm will use the specified + hash algorithm to create the key. + The salt must be different and random + enough for every key you generate in order to create different keys. + That salt must be known when you check the keys, thus it is + a good idea to append the key to it. Salt has a fixed length + of 8 bytes and will be padded with zeros if you supply less bytes. + Keep in mind that user supplied passwords are not really suitable + to be used as keys in cryptographic algorithms, since users normally + choose keys they can write on keyboard. These passwords use + only 6 to 7 bits per character (or less). It is highly recommended + to use some kind of tranformation (like this function) to the user + supplied key.