<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.23 Maintainer: goba Status: ready -->
 <reference id="ref.mhash">
  <title>Mhash fggvnyek</title>
  <titleabbrev>mhash</titleabbrev>
  
  <partintro>
   <para>
    Ezek a fggvnyek az <ulink url="&url.mhash;">mhash</ulink> 
    eljrsknyvtrral mkdnek egytt.
   </para>
   <para>
    Ezek egy felletet biztostanak az mhash knyvtrhoz. Az mhash
    szles skljt tmogatja a hash algoritmusoknak, mint pldul
    az MD5, SHA1, GOST s mg szmos ms. Az mhash pldul 
    ellenrzsszegek, kivonatok, azonostsi kdok ellltsra 
    is hasznlhat.
   </para>
   <para>
    A hasznlatukhoz le kell tlteni az mhash csomagot az 
    <ulink url="&url.mhash;">mhash webhelyrl</ulink> s a csomagban
    tallhat a teleptsi utastsok szerint installlni kell. A PHP-t a 
    <option role="configure">--with-mhash</option> paramterrel kell fordtani,
    amivel engedlyezzk ezt a kiterjesztst.
   </para>
   <para>
    <example>
     <title>Az MD5 kivonat s a hmac ellltsa s kirsa hexa formban</title>
     <programlisting role="php">
<![CDATA[
<?php
$input = "mit krsz a semmirt?";
$hash = mhash (MHASH_MD5, $input);
print "A 'hash' rtke: ".bin2hex ($hash)."\n<br />";
$hash = mhash (MHASH_MD5, $input, "Jefe");
print "A 'hmac' rtke: ".bin2hex ($hash)."\n<br />";
?>
]]>
     </programlisting>
    </example>
    Ez a kvetkez kimenetet eredmnyezi:
    <programlisting>
<![CDATA[
A 'hash' rtke: 08dd459b941ee225cc6b33717f87d9a4  
A 'hash' rtke: d6044d59c420fecb5e5e2910d2134129
]]>
    </programlisting>
    A tmogatott hash algoritmusok teljes listja az mhash dokumentciban
    tallhat. Az ltalnos szably, hogy a hash algoritmust az 
    MHASH_HASHNEVE formban lehet elrni PHP-bl, pldul a TIGER elrshez
    az MHASH_TIGER PHP konstans hasznlhat.
   </para>
   <para>
    Itt kvetkeznek az mhash ltal jelenleg tmogatott hash-ek.
    Az mhash dokumentciban szerepl, de itt fel nem soroltak is nyugodtan 
    hasznlhatk, ebben az esetben ez a dokumentci mr nem tekinthet 
    aktulisnak.
    <itemizedlist>
     <listitem>
      <simpara>
       <constant>MHASH_MD5</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_SHA1</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_HAVAL256</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_HAVAL192</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_HAVAL160</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_HAVAL128</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_RIPEMD160</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_GOST</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_TIGER</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_CRC32</constant>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>MHASH_CRC32B</constant>
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
  </partintro>
  
  <refentry id="function.mhash-get-hash-name">
   <refnamediv>
    <refname>mhash_get_hash_name</refname>
    <refpurpose>A megadott hash nevt adja vissza</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>string</type><methodname>mhash_get_hash_name</methodname>
      <methodparam><type>int</type><parameter>hash</parameter></methodparam>
     </methodsynopsis>
    <para>
     Az <function>mhash_get_hash_name</function> a megadott hash nevvel
     tr vissza.
    </para>
    <para>
     Ha az <function>mhash_get_hash_name</function> fggvnynek tadott
     hash azonost egy nemltez hash-re hivatkozik, &false; rtkkel tr vissza.
    </para>
    <para>
     <example>
      <title><function>mhash_get_hash_name</function> plda</title>
      <programlisting>
<![CDATA[
<?php
$hash = MHASH_MD5;

print mhash_get_hash_name ($hash);
?>
]]>
      </programlisting>
     </example>
     Ez a kvetkez kimenetet eredmnyezi:
     <screen> 
<![CDATA[ 
MD5 
]]> 
     </screen> 
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.mhash-get-block-size">
   <refnamediv>
    <refname>mhash_get_block_size</refname>
    <refpurpose>A megadott hash blokkmretvel tr vissza</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>int</type><methodname>mhash_get_block_size</methodname>
      <methodparam><type>int</type><parameter>hash</parameter></methodparam>
     </methodsynopsis>
    <para>
     Az <function>mhash_get_block_size</function> a megadott
     <parameter>hash</parameter> blokkmrett adja vissza
     byte-okban mrve.
    </para>
    <para>
     Ha az <function>mhash_get_block_size</function> 
     fggvnynek rvnytelen <parameter>hash</parameter>
     paramtert adsz, &false; rtkkel tr vissza.
    </para>
   </refsect1>
  </refentry>
  
  <refentry id="function.mhash-count">
   <refnamediv>
    <refname>mhash_count</refname>
    <refpurpose>Visszaadja a legnagyobb elrhet hash azonostt</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>int</type><methodname>mhash_count</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Az <function>mhash_count</function> visszaadja a legnagyobb elrhet
     hash azonostt. A hasznlhat hash-ek azonost szmai nulltl eddig a
     szmig terjednek.
    </para>
    <para>
     <example>
      <title>Az sszes hash hasznlata</title>
      <programlisting role="php">
<![CDATA[
<?php

$nr = mhash_count();

for ($i = 0; $i &lt;= $nr; $i++) {
    echo sprintf ("The blocksize of %s is %d\n", 
        mhash_get_hash_name ($i),
        mhash_get_block_size ($i));
}
?>
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>
    
  <refentry id="function.mhash">
   <refnamediv>
    <refname>mhash</refname>
    <refpurpose>Hash szmts</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>string</type><methodname>mhash</methodname>
      <methodparam><type>int</type><parameter>hash</parameter></methodparam>
      <methodparam><type>string</type><parameter>data</parameter></methodparam>
      <methodparam  choice="opt"><type>string</type><parameter>key</parameter></methodparam>
     </methodsynopsis>
    <para>
     Az <function>mhash</function> alkalmazza a <parameter>hash</parameter>
     ltal megadott algoritmust a <parameter>data</parameter> paramterre, s
     visszatr az eredmny hash-el (amit kivonatnak [digest-nek] is hvnak).
     A <parameter>key</parameter> paramter megadsval visszaadja az keletkez 
     HMAC-ot. A HMAC egy kulcsos hash-els zenet azonostsra,
     vagy csak egyszeren egy zenet kivonat, amely a megadott kulcstl
     fgg. Nem minden mhash algoritmus hasznlhat HMAC mdban.
     Hiba esetn a fggvny &false; rtket ad.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mhash-keygen-s2k">
   <refnamediv>
    <refname>mhash_keygen_s2k</refname>
    <refpurpose>Kulcsot generl</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Lers</title>
     <methodsynopsis>
      <type>string</type><methodname>mhash_keygen_s2k</methodname>
      <methodparam><type>int</type><parameter>hash</parameter></methodparam>
      <methodparam><type>string</type><parameter>password</parameter></methodparam>
      <methodparam><type>string</type><parameter>salt</parameter></methodparam>
      <methodparam><type>int</type><parameter>bytes</parameter></methodparam>
     </methodsynopsis>
    <para>
     Az <function>mhash_keygen_s2k</function> <parameter>bytes</parameter> 
     mret kulcsot generl a megadott <parameter>password</parameter> alapjn.
     Az S2K algoritmust hasznlja, amely az OpenPGP lersban (RFC 2440) van 
     definilva. A megadott <parameter>hash</parameter> algoritmust hasznlja
     a kulcs ellltsra.
     A <parameter>salt</parameter> minden generlt kulcsra ms-ms
     kell legyen, kellkppen vletlenszer rtkekkel, hogy klnbz
     kulcsok lljanak el. A <parameter>salt</parameter>-nak ismertnek kell 
     lennie a kulcsok ellenrzsekor, ezrt j tlet a kulcsokat hozzfzni
     ehhez. A <parameter>salt</parameter> mindig nyolc bjt hossz legyen,
     ha ennl kevesebb, automatikusan nullkkal tltdik fel.
    </para>
    <para>
     Figyelembe veend mindenek eltt, hogy a felhasznlk ltal beadott 
     jelszavak nem tlsgosan alkalmasak arra, hogy titkostsi rendszerek 
     kulcsai legyenek, mivel a felhasznlk ltalban jl begpelhet kulcsot
     vlasztanak. Ezek a jelszavak csak 6-7 bitet (vagy mg kevesebbet)
     hasznlnak ki karakterenknt. Nagyon ajnlott a beadott jelszra 
     olyan talakts hasznlata, mint ez a fggvny.
    </para>
   </refsect1>
  </refentry>

 </reference> 

<!-- 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:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->