cvs: phpdoc /en/functions mhash.xml readline.xml wddx.xml
| From: | Hojtsy Gabor | Date: | Sat, 23 Dec 2000 16:15:16 +0000 |
| Subject: | cvs: phpdoc /en/functions mhash.xml readline.xml wddx.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333364@lists.php.net to get a copy of this message | ||
goba Sat Dec 23 08:15:16 2000 EDT
Modified files:
/phpdoc/en/functions mhash.xml readline.xml wddx.xml
Log:
Fixing some typos...
Index: phpdoc/en/functions/mhash.xml diff -u phpdoc/en/functions/mhash.xml:1.9 phpdoc/en/functions/mhash.xml:1.10 --- phpdoc/en/functions/mhash.xml:1.9 Fri Dec 15 06:05:20 2000 +++ phpdoc/en/functions/mhash.xml Sat Dec 23 08:15:15 2000 @@ -1,54 +1,61 @@ <reference id="ref.mhash"> - <title>Mhash Functions</title> + <title>Mhash függvények</title> <titleabbrev>mhash</titleabbrev> <partintro> <para> - These functions are intended to work with <ulink - url="&url.mhash;">mhash</ulink>.</para> + Ezek a függvények az <ulink url="&url.mhash;">mhash</ulink>-el + mûködnek együtt. + </para> <para> - 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. </para> <para> - To use it, download the mhash distribution from <ulink - url="&url.mhash;">its web site</ulink> and follow the included - installation instructions. You need to compile PHP with the - <option role="configure">--with-mhash</option> parameter to enable - this extension. + Ahhoz, hogy használhasd ezeket, le kell töltened az mhash + csomagot az <ulink url="&url.mhash;">mhash webhelyrõl</ulink> + és követned kell a telepítési utasításokat, amiket a csomagban + találsz. A PHP-t a <option role="configure">--with-mhash</option> + paraméterrel kell fordítanod, hogy engedélyezd ezt a kiterjesztést. </para> <para> - Mhash can be used to create checksums, message digests, message - authentication codes, and more. + Az mhash például ellenõrzõösszegek, kivonatok, azonosítási kódok + elõállítására is használható. </para> <para> <example> - <title>Compute the MD5 digest and hmac and print it out as hex</title> + <title>Az MD5 kivonat és a hmac elõállítása és kiírása hexa formában</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $input = "what do ya want for nothing?"; $hash = mhash (MHASH_MD5, $input); print "The hash is ".bin2hex ($hash)."\n<br>"; $hash = mhash (MHASH_MD5, $input, "Jefe"); print "The hmac is ".bin2hex ($hash)."\n<br>"; -?> +?> +]]> </programlisting> </example> - This will produce: + Ez a következõ kimenetet eredményezi: <programlisting> +<![CDATA[ The hash is d03cb659cbf9192dcd066272249f8412 The hmac is 750c783e6ab0b503eaa86e310a5db738 +]]> </programlisting> - 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. + 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ó. </para> <para> - 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. + 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. <itemizedlist> <listitem> <simpara> @@ -112,10 +119,10 @@ <refentry id="function.mhash-get-hash-name"> <refnamediv> <refname>mhash_get_hash_name</refname> - <refpurpose>Get the name of the specified hash</refpurpose> + <refpurpose>A megadott hash nevét adja vissza</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mhash_get_hash_name</function></funcdef> @@ -123,26 +130,27 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash_get_hash_name</function> is used to get the name - of the specified hash. + Az <function>mhash_get_hash_name</function> a megadott hash nevével + tér vissza. </para> <para> - <function>mhash_get_hash_name</function> takes the hash id as an - argument and returns the name of the hash or false, if the hash - does not exist. + Ha az <function>mhash_get_hash_name</function> függvénynek átadott + hash azonosító egy nemlétezõ hash-re hivatkozik, FALSE értékkel tér vissza. </para> <para> <example> - <title><function>Mhash_get_hash_name</function> Example</title> + <title><function>mhash_get_hash_name</function> példa</title> <programlisting> -<?php +<![CDATA[ +<?php $hash = MHASH_MD5; print mhash_get_hash_name ($hash); -?> +?> +]]> </programlisting> </example> - The above example will print out: + Ez a következõ kimenetet eredményezi: <programlisting> MD5 </programlisting> @@ -153,10 +161,10 @@ <refentry id="function.mhash-get-block-size"> <refnamediv> <refname>mhash_get_block_size</refname> - <refpurpose>Get the block size of the specified hash</refpurpose> + <refpurpose>A megadott hash blokkméretével tér vissza</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mhash_get_block_size</function></funcdef> @@ -164,13 +172,14 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash_get_block_size</function> is used to get the size - of a block of the specified <parameter>hash</parameter>. + Az <function>mhash_get_block_size</function> a megadott + <parameter>hash</parameter> blokkméretét adja vissza + byte-okban mérve. </para> <para> - <function>Mhash_get_block_size</function> takes one argument, the - <parameter>hash</parameter> and returns the size in bytes or - false, if the <parameter>hash</parameter> does not exist. + Ha az <function>mhash_get_block_size</function> + függvénynek érvénytelen <parameter>hash</parameter> + paramétert adsz, FALSE értékkel tér vissza. </para> </refsect1> </refentry> @@ -178,10 +187,10 @@ <refentry id="function.mhash-count"> <refnamediv> <refname>mhash_count</refname> - <refpurpose>Get the highest available hash id</refpurpose> + <refpurpose>Visszaadja a legnagyobb elérhetõ hash azonosítót</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mhash_count</function></funcdef> @@ -189,14 +198,16 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash_count</function> returns the highest available hash - id. Hashes are numbered from 0 to this hash id. + Az <function>mhash_count</function> visszaadja a legnagyobb elérhetõ + hash azonosítót. A hash-ek nullától eddig a számig kapnak + azonosító számokat. </para> <para> <example> - <title>Traversing all hashes</title> + <title>Az összes hash használata</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $nr = mhash_count(); @@ -205,7 +216,7 @@ mhash_get_hash_name ($i), mhash_get_block_size ($i)); } -?> +?> </programlisting> </example> </para> @@ -215,10 +226,10 @@ <refentry id="function.mhash"> <refnamediv> <refname>mhash</refname> - <refpurpose>Compute hash</refpurpose> + <refpurpose>Hash számítás</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mhash</function></funcdef> @@ -228,13 +239,14 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash</function> applies a hash function specified by - <parameter>hash</parameter> to the <parameter>data</parameter> and - returns the resulting hash (also called digest). If the <parameter> key</parameter> - 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. + Az <function>mhash</function> alkalmazza a <parameter>hash</parameter> + által megadott algoritmust a <parameter>data</parameter> paraméterre, és + visszatér az eredmény hash-el (amit kivonatkank [digest-nek] is hívnak). + Ha a <parameter>key</parameter> 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. </para> </refsect1> </refentry> @@ -242,10 +254,10 @@ <refentry id="function.mhash-keygen-s2k"> <refnamediv> <refname>mhash_keygen_s2k</refname> - <refpurpose>Generates a key</refpurpose> + <refpurpose>Kulcsot generál</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mhash_keygen_s2k</function></funcdef> @@ -256,22 +268,24 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash_keygen_s2k</function> generates a key that is - <parameter>bytes</parameter> 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 - <parameter>hash</parameter> algorithm to create the key. - The <parameter>salt</parameter> 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. + Az <function>mhash_keygen_s2k</function> egy olyan kulcsot generál, + ami <parameter>bytes</parameter> 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 + <parameter>hash</parameter> algortmust használja a kulcs elõállítására. + A <parameter>salt</parameter> 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. </para> </refsect1> </refentry> Index: phpdoc/en/functions/readline.xml diff -u phpdoc/en/functions/readline.xml:1.4 phpdoc/en/functions/readline.xml:1.5 --- phpdoc/en/functions/readline.xml:1.4 Sun Aug 20 09:29:45 2000 +++ phpdoc/en/functions/readline.xml Sat Dec 23 08:15:15 2000 @@ -144,7 +144,7 @@ </funcsynopsis> <para> If called with no parameters, this function returns an array of - values for all the setting readline uses. The elements will will + values for all the setting readline uses. The elements will be indexed by the following values: done, end, erase_empty_line, library_version, line_buffer, mark, pending_input, point, prompt, readline_name, and terminal_name. Index: phpdoc/en/functions/wddx.xml diff -u phpdoc/en/functions/wddx.xml:1.5 phpdoc/en/functions/wddx.xml:1.6 --- phpdoc/en/functions/wddx.xml:1.5 Tue Aug 22 14:40:33 2000 +++ phpdoc/en/functions/wddx.xml Sat Dec 23 08:15:16 2000 @@ -5,7 +5,7 @@ <partintro> <para> These functions are intended for work with <ulink url="&url.wddx;">WDDX</ulink>.</para> - + <para> Note that all the functions that serialize variables use the first element of an array to determine whether the array is to be @@ -21,7 +21,7 @@ ?> </programlisting> </example></para> - + <para> This example will produce: <informalexample> @@ -48,7 +48,7 @@ ?> </programlisting> </example></para> - + <para> This example will produce: @@ -79,14 +79,14 @@ <parameter><optional>comment</optional></parameter></paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_serialize_value</function> is used to create a WDDX packet from a single given value. It takes the value contained in <parameter>var</parameter>, and an optional <parameter>comment</parameter> string that appears in the packet header, and returns the WDDX packet.</para> - + </refsect1> </refentry> @@ -106,18 +106,18 @@ </paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_serialize_vars</function> is used to create a WDDX packet with a structure that contains the serialized representation of the passed variables.</para> - + <para> <function>wddx_serialize_vars</function> takes a variable number of arguments, each of which can be either a string naming a variable or an array containing strings naming the variables or another array, etc.</para> - + <para> <example> <title>wddx_serialize_vars example</title> @@ -133,7 +133,7 @@ ?> </programlisting> </example></para> - + <para> The above example will produce: <programlisting> @@ -142,7 +142,7 @@ <string>blue</string><string>orange</string><string>violet</string></array></var> <var name='d'><string>colors</string></var></struct></data></wddxPacket> </programlisting></para> - + </refsect1> </refentry> @@ -160,14 +160,14 @@ <parameter><optional>comment</optional></parameter></paramdef> </funcprototype> </funcsynopsis> - + <para> Use <function>wddx_packet_start</function> to start a new WDDX packet for incremental addition of variables. It takes an optional <parameter>comment</parameter> string and returns a packet ID for use in later functions. It automatically creates a structure definition inside the packet to contain the variables.</para> - + </refsect1> </refentry> @@ -184,19 +184,19 @@ <paramdef>int <parameter>packet_id</parameter></paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_packet_end</function> ends the WDDX packet specified by the <parameter>packet_id</parameter> and returns the string with the packet.</para> - + </refsect1> </refentry> <refentry id="function.wddx-add-vars"> <refnamediv> <refname>wddx_add_vars</refname> - <refpurpose>Ends a WDDX packet with the specified ID</refpurpose> + <refpurpose>Add variables to a WDDX packet with the specified ID</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -210,7 +210,7 @@ </paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_add_vars</function> is used to serialize passed variables and add the result to the packet specified by the @@ -234,7 +234,7 @@ <paramdef>string <parameter>packet</parameter></paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_deserialized</function> takes a <parameter>packet</parameter> string and deserializes it. It
Index: phpdoc/en/functions/mhash.xml diff -u phpdoc/en/functions/mhash.xml:1.9 phpdoc/en/functions/mhash.xml:1.10 --- phpdoc/en/functions/mhash.xml:1.9 Fri Dec 15 06:05:20 2000 +++ phpdoc/en/functions/mhash.xml Sat Dec 23 08:15:15 2000 @@ -1,54 +1,61 @@ <reference id="ref.mhash"> - <title>Mhash Functions</title> + <title>Mhash függvények</title> <titleabbrev>mhash</titleabbrev> <partintro> <para> - These functions are intended to work with <ulink - url="&url.mhash;">mhash</ulink>.</para> + Ezek a függvények az <ulink url="&url.mhash;">mhash</ulink>-el + mûködnek együtt. + </para> <para> - 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. </para> <para> - To use it, download the mhash distribution from <ulink - url="&url.mhash;">its web site</ulink> and follow the included - installation instructions. You need to compile PHP with the - <option role="configure">--with-mhash</option> parameter to enable - this extension. + Ahhoz, hogy használhasd ezeket, le kell töltened az mhash + csomagot az <ulink url="&url.mhash;">mhash webhelyrõl</ulink> + és követned kell a telepítési utasításokat, amiket a csomagban + találsz. A PHP-t a <option role="configure">--with-mhash</option> + paraméterrel kell fordítanod, hogy engedélyezd ezt a kiterjesztést. </para> <para> - Mhash can be used to create checksums, message digests, message - authentication codes, and more. + Az mhash például ellenõrzõösszegek, kivonatok, azonosítási kódok + elõállítására is használható. </para> <para> <example> - <title>Compute the MD5 digest and hmac and print it out as hex</title> + <title>Az MD5 kivonat és a hmac elõállítása és kiírása hexa formában</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $input = "what do ya want for nothing?"; $hash = mhash (MHASH_MD5, $input); print "The hash is ".bin2hex ($hash)."\n<br>"; $hash = mhash (MHASH_MD5, $input, "Jefe"); print "The hmac is ".bin2hex ($hash)."\n<br>"; -?> +?> +]]> </programlisting> </example> - This will produce: + Ez a következõ kimenetet eredményezi: <programlisting> +<![CDATA[ The hash is d03cb659cbf9192dcd066272249f8412 The hmac is 750c783e6ab0b503eaa86e310a5db738 +]]> </programlisting> - 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. + 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ó. </para> <para> - 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. + 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. <itemizedlist> <listitem> <simpara> @@ -112,10 +119,10 @@ <refentry id="function.mhash-get-hash-name"> <refnamediv> <refname>mhash_get_hash_name</refname> - <refpurpose>Get the name of the specified hash</refpurpose> + <refpurpose>A megadott hash nevét adja vissza</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mhash_get_hash_name</function></funcdef> @@ -123,26 +130,27 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash_get_hash_name</function> is used to get the name - of the specified hash. + Az <function>mhash_get_hash_name</function> a megadott hash nevével + tér vissza. </para> <para> - <function>mhash_get_hash_name</function> takes the hash id as an - argument and returns the name of the hash or false, if the hash - does not exist. + Ha az <function>mhash_get_hash_name</function> függvénynek átadott + hash azonosító egy nemlétezõ hash-re hivatkozik, FALSE értékkel tér vissza. </para> <para> <example> - <title><function>Mhash_get_hash_name</function> Example</title> + <title><function>mhash_get_hash_name</function> példa</title> <programlisting> -<?php +<![CDATA[ +<?php $hash = MHASH_MD5; print mhash_get_hash_name ($hash); -?> +?> +]]> </programlisting> </example> - The above example will print out: + Ez a következõ kimenetet eredményezi: <programlisting> MD5 </programlisting> @@ -153,10 +161,10 @@ <refentry id="function.mhash-get-block-size"> <refnamediv> <refname>mhash_get_block_size</refname> - <refpurpose>Get the block size of the specified hash</refpurpose> + <refpurpose>A megadott hash blokkméretével tér vissza</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mhash_get_block_size</function></funcdef> @@ -164,13 +172,14 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash_get_block_size</function> is used to get the size - of a block of the specified <parameter>hash</parameter>. + Az <function>mhash_get_block_size</function> a megadott + <parameter>hash</parameter> blokkméretét adja vissza + byte-okban mérve. </para> <para> - <function>Mhash_get_block_size</function> takes one argument, the - <parameter>hash</parameter> and returns the size in bytes or - false, if the <parameter>hash</parameter> does not exist. + Ha az <function>mhash_get_block_size</function> + függvénynek érvénytelen <parameter>hash</parameter> + paramétert adsz, FALSE értékkel tér vissza. </para> </refsect1> </refentry> @@ -178,10 +187,10 @@ <refentry id="function.mhash-count"> <refnamediv> <refname>mhash_count</refname> - <refpurpose>Get the highest available hash id</refpurpose> + <refpurpose>Visszaadja a legnagyobb elérhetõ hash azonosítót</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mhash_count</function></funcdef> @@ -189,14 +198,16 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash_count</function> returns the highest available hash - id. Hashes are numbered from 0 to this hash id. + Az <function>mhash_count</function> visszaadja a legnagyobb elérhetõ + hash azonosítót. A hash-ek nullától eddig a számig kapnak + azonosító számokat. </para> <para> <example> - <title>Traversing all hashes</title> + <title>Az összes hash használata</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $nr = mhash_count(); @@ -205,7 +216,7 @@ mhash_get_hash_name ($i), mhash_get_block_size ($i)); } -?> +?> </programlisting> </example> </para> @@ -215,10 +226,10 @@ <refentry id="function.mhash"> <refnamediv> <refname>mhash</refname> - <refpurpose>Compute hash</refpurpose> + <refpurpose>Hash számítás</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mhash</function></funcdef> @@ -228,13 +239,14 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash</function> applies a hash function specified by - <parameter>hash</parameter> to the <parameter>data</parameter> and - returns the resulting hash (also called digest). If the <parameter> key</parameter> - 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. + Az <function>mhash</function> alkalmazza a <parameter>hash</parameter> + által megadott algoritmust a <parameter>data</parameter> paraméterre, és + visszatér az eredmény hash-el (amit kivonatkank [digest-nek] is hívnak). + Ha a <parameter>key</parameter> 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. </para> </refsect1> </refentry> @@ -242,10 +254,10 @@ <refentry id="function.mhash-keygen-s2k"> <refnamediv> <refname>mhash_keygen_s2k</refname> - <refpurpose>Generates a key</refpurpose> + <refpurpose>Kulcsot generál</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mhash_keygen_s2k</function></funcdef> @@ -256,22 +268,24 @@ </funcprototype> </funcsynopsis> <para> - <function>Mhash_keygen_s2k</function> generates a key that is - <parameter>bytes</parameter> 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 - <parameter>hash</parameter> algorithm to create the key. - The <parameter>salt</parameter> 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. + Az <function>mhash_keygen_s2k</function> egy olyan kulcsot generál, + ami <parameter>bytes</parameter> 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 + <parameter>hash</parameter> algortmust használja a kulcs elõállítására. + A <parameter>salt</parameter> 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. </para> </refsect1> </refentry> Index: phpdoc/en/functions/readline.xml diff -u phpdoc/en/functions/readline.xml:1.4 phpdoc/en/functions/readline.xml:1.5 --- phpdoc/en/functions/readline.xml:1.4 Sun Aug 20 09:29:45 2000 +++ phpdoc/en/functions/readline.xml Sat Dec 23 08:15:15 2000 @@ -144,7 +144,7 @@ </funcsynopsis> <para> If called with no parameters, this function returns an array of - values for all the setting readline uses. The elements will will + values for all the setting readline uses. The elements will be indexed by the following values: done, end, erase_empty_line, library_version, line_buffer, mark, pending_input, point, prompt, readline_name, and terminal_name. Index: phpdoc/en/functions/wddx.xml diff -u phpdoc/en/functions/wddx.xml:1.5 phpdoc/en/functions/wddx.xml:1.6 --- phpdoc/en/functions/wddx.xml:1.5 Tue Aug 22 14:40:33 2000 +++ phpdoc/en/functions/wddx.xml Sat Dec 23 08:15:16 2000 @@ -5,7 +5,7 @@ <partintro> <para> These functions are intended for work with <ulink url="&url.wddx;">WDDX</ulink>.</para> - + <para> Note that all the functions that serialize variables use the first element of an array to determine whether the array is to be @@ -21,7 +21,7 @@ ?> </programlisting> </example></para> - + <para> This example will produce: <informalexample> @@ -48,7 +48,7 @@ ?> </programlisting> </example></para> - + <para> This example will produce: @@ -79,14 +79,14 @@ <parameter><optional>comment</optional></parameter></paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_serialize_value</function> is used to create a WDDX packet from a single given value. It takes the value contained in <parameter>var</parameter>, and an optional <parameter>comment</parameter> string that appears in the packet header, and returns the WDDX packet.</para> - + </refsect1> </refentry> @@ -106,18 +106,18 @@ </paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_serialize_vars</function> is used to create a WDDX packet with a structure that contains the serialized representation of the passed variables.</para> - + <para> <function>wddx_serialize_vars</function> takes a variable number of arguments, each of which can be either a string naming a variable or an array containing strings naming the variables or another array, etc.</para> - + <para> <example> <title>wddx_serialize_vars example</title> @@ -133,7 +133,7 @@ ?> </programlisting> </example></para> - + <para> The above example will produce: <programlisting> @@ -142,7 +142,7 @@ <string>blue</string><string>orange</string><string>violet</string></array></var> <var name='d'><string>colors</string></var></struct></data></wddxPacket> </programlisting></para> - + </refsect1> </refentry> @@ -160,14 +160,14 @@ <parameter><optional>comment</optional></parameter></paramdef> </funcprototype> </funcsynopsis> - + <para> Use <function>wddx_packet_start</function> to start a new WDDX packet for incremental addition of variables. It takes an optional <parameter>comment</parameter> string and returns a packet ID for use in later functions. It automatically creates a structure definition inside the packet to contain the variables.</para> - + </refsect1> </refentry> @@ -184,19 +184,19 @@ <paramdef>int <parameter>packet_id</parameter></paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_packet_end</function> ends the WDDX packet specified by the <parameter>packet_id</parameter> and returns the string with the packet.</para> - + </refsect1> </refentry> <refentry id="function.wddx-add-vars"> <refnamediv> <refname>wddx_add_vars</refname> - <refpurpose>Ends a WDDX packet with the specified ID</refpurpose> + <refpurpose>Add variables to a WDDX packet with the specified ID</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -210,7 +210,7 @@ </paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_add_vars</function> is used to serialize passed variables and add the result to the packet specified by the @@ -234,7 +234,7 @@ <paramdef>string <parameter>packet</parameter></paramdef> </funcprototype> </funcsynopsis> - + <para> <function>wddx_deserialized</function> takes a <parameter>packet</parameter> string and deserializes it. It