<?xml version="1.0" encoding="iso-8859-2"?>
 <reference id="ref.mhash">
  <title>Mhash funkce</title>
  <titleabbrev>mhash</titleabbrev>

  <partintro>
   <para>
    Tyto funkce jsou ureny pro prci s <ulink url="&url.mhash;">mhash</ulink>.
   </para>
   <para>
    Toto je interface ke knihvn mhash. mhash podporuje irokou klu hash
    algoritm jako nap. MD5, SHA1, GOST a mnoho jinch.
   </para>
   <para>
    Pokud chcete tyto funkce pouvat, sthnte si mhash distribuci z <ulink
    url="&url.mhash;">its web site</ulink> a postupujte podle piloench
    instrukc k instalaci. K aktivaci tohoto modulu budete muset zkompilovat PHP
    s volbou <option role="configure">--with-mhash</option>
   </para>
   <para>
    Mhash se d pout k vytven kontrolnch sout, message digests, message
    authentication codes, and more.
   </para>
   <para>
    <example>
     <title>Compute the MD5 digest and hmac and print it out as hex</title>
     <programlisting role="php">
&lt;?php
$input = "what do ya want for nothing?";
$hash = mhash (MHASH_MD5, $input);
print "The hash is ".bin2hex ($hash)."\n&lt;br>";
$hash = mhash (MHASH_MD5, $input, "Jefe");
print "The hmac is ".bin2hex ($hash)."\n&lt;br>";
?&gt;
     </programlisting>
    </example>
    This will produce:
    <programlisting>
The hash is d03cb659cbf9192dcd066272249f8412
The hmac is 750c783e6ab0b503eaa86e310a5db738
    </programlisting>
    Kompletn seznam podporovanch hash viz dokumentaci mhash. Obecnm pravidlem
    je, e hash algoritmus je dostupn z PHP pomoc MHASH_NAZEVHASHE. Napklad
    TIGER se v PHP pouv pomoc konstanty MHASH_TIGER.
   </para>
   <para>
    Zde je seznam hash podporovanch mhashem v souasn dob. Pokud zde nen
    nkter hash jmenovn, ale v dokumentaci mhashe je uveden jako podporovan,
    mete bezpen pedpokldat, e je tato dokumentace zastaral.
    <itemizedlist>
     <listitem>
      <simpara>
       MHASH_MD5
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_SHA1
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_HAVAL256
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_HAVAL192
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_HAVAL160
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_HAVAL128
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_RIPEMD160
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_GOST
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_TIGER
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_CRC32
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_CRC32B
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
  </partintro>

  <refentry id="function.mhash-get-hash-name">
   <refnamediv>
    <refname>mhash_get_hash_name</refname>
    <refpurpose>Zskat nzev zadanho hashe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>string</type><methodname>mhash_get_hash_name</methodname>
      <methodparam><type>int</type><parameter>hash</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>mhash_get_hash_name</function> se pouv ke zjitn nzvu
     zadanho hashe.
    </para>
    <para>
     <function>mhash_get_hash_name</function> pijm id hashe jako argument a
     vrac nzev tohoto hashe nebo &false;, pokud tento hash
     neexistuje.
    </para>
    <para>
     <example>
      <title>Ukzka <function>mhash_get_hash_name</function></title>
      <programlisting>
&lt;?php
$hash = MHASH_MD5;

print mhash_get_hash_name ($hash);
?&gt;
      </programlisting>
     </example>
     Ve uveden ukzka vytiskne:
     <programlisting>
MD5
     </programlisting>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mhash-get-block-size">
   <refnamediv>
    <refname>mhash_get_block_size</refname>
    <refpurpose>Zskat velikost bloku urenho hashe</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>mhash_get_block_size</methodname>
      <methodparam><type>int</type><parameter>hash</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>mhash_get_block_size</function> se pouv ke zjitn velikosti
     bloku argumentu <parameter>hash</parameter>.
    </para>
    <para>
     <function>mhash_get_block_size</function> pijm jeden argument,
     <parameter>hash</parameter> a vrac velikost v bytech nebo
     &false;, pokud <parameter>hash</parameter> neexistuje.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mhash-count">
   <refnamediv>
    <refname>mhash_count</refname>
    <refpurpose>Zskat nejvy dostupn hash id</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</title>
     <methodsynopsis>
      <type>int</type><methodname>mhash_count</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>mhash_count</function> vrac nejvy dostupn hash id. Hashe jsou
     slovan od 0 po toto hash id.
    </para>
    <para>
     <example>
      <title>Traversing all hashes</title>
      <programlisting role="php">
&lt;?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));
}
?&gt;
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mhash">
   <refnamediv>
    <refname>mhash</refname>
    <refpurpose>Spotat hash</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</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><type>string</type><parameter>[ key ]</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>mhash</function> aplikuje hash funkci urenou argumentem
     <parameter>hash</parameter> na <parameter>data</parameter> a vrac vsledn
     hash (tak nazvan digest). Pokud je pedn <parameter> key</parameter>,
     vrac vsledn 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;.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mhash-keygen-s2k">
   <refnamediv>
    <refname>mhash_keygen_s2k</refname>
    <refpurpose>Vygenerovat kl</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Popis</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>
     <function>mhash_keygen_s2k</function> generuje kl, kter je
     <parameter>bytes</parameter> dlouh, z pedanho hesla. Toto je Salted S2K
     algoritmus specifikovan v OpenPGP dokumentu (RFC 2440). Tento algoritmus
     pouije k vytvoen kle <parameter>hash</parameter> algoritmus.
     <parameter>salt</parameter> mus bt pro kad generovan kl jin a
     dostaten nhodn, aby vytvoil rzn kle.
     Salt mus bt pi kontrole kl znm, tud je dobr npad ho pipojit
     ke kli. Salt ma pevnou dlku 8 byt a pokud dodte mn byt, bude
     doplnn nulami.
     Pamatujte, e uivatelsky uren hesla nejsou vhodn k pouit jako kle,
     protoe uivatel obvykle vol kle, kter mohou napsat na klvesnici.
     Tato hesla vyuvaj pouze 6 a 7 byt na znak (nebo mn). Je velmi vhodn
     na uivateli uren kle pout njakou transformaci (jako je tato funkce).
    </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:
-->