<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.mhash">
  <title>Hash Funktionen</title>
  <titleabbrev>mhash</titleabbrev>

  <partintro>
   <para>
    Diese Funktionen arbeiten zusammen mit <ulink
    url="&url.mhash;">mhash</ulink>.
   </para>
   <para>
    Dies ist eine Schnittstelle zu der Mhash Bibliothek. Mhash
    untersttzt eine breite Auswahl an Hash Algorithmen, wie MD5,
    SHA1, GOST, und viele andere.
   </para>
   <para>
    Um sie zu verwenden, muss man die Mhash Distribution von <ulink
    url="&url.mhash;">der Website</ulink> downloaden und der
    beigefgten Instalationsanleitung folgen. PHP muss mit der Option
    <option role="configure">--with-mhash</option> kompiliert werden
    um diese Erweiterung zu aktivieren.
   </para>
   <para>
    Mhash wird verwendet um z.B. Checksummen und Mehr zu erstellen.
   </para>
   <para>
    <example>
     <title>Berechne den MD5 Extrakt und gib es als Hex aus</title>
     <programlisting role="php">
<![CDATA[
<?php
$input = "what do ya want for nothing?";
$hash = mhash (MHASH_MD5, $input);
print "Der Hash ist ".bin2hex ($hash)."\n&lt;br>";
$hash = mhash (MHASH_MD5, $input, "Jefe");
print "Der hmac ist ".bin2hex ($hash)."\n&lt;br>";
?>
]]>
     </programlisting>
      <para>
    Die Ausgabe ist: 
	    <screen>
<![CDATA[
Der Hash ist d03cb659cbf9192dcd066272249f8412 
Der hmac ist 750c783e6ab0b503eaa86e310a5db738 
]]>
        </screen>
	  </para>
    </example>  
  	  
	
    Eine komplette Liste aller untersttzen Hashes ist in der
    Dokumentation von Mhash enthalten. Die allgemeine Verwendung ist,
    dass man einen Hash Algorithmus von PHP mit MHASH_HASHNAME
    erreicht. Z.B., um HAVAL zu erreichen benutzt man die PHP
    Konstante MHASH_HAVAL.
   </para>
   <para>
    Hier ist eine Liste von Hashs, die momentan von Mhash untersttzt
    werden.  Wenn ein Hash ist hier nicht aufgefhrt ist, aber von
    Mhash, laut Dokumentation, untersttzt wird, ist diese
    Dokumentation als veraltet anzusehen.
    <itemizedlist>
     <listitem>
      <simpara>
       MHASH_MD5
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_SHA1
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_HAVAL
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_RIPEMD160
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_RIPEMD128
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_SNEFRU
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_TIGER
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       MHASH_GOST
      </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>Gibt den Namen eines Hashs zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</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> wird verwendet um den
     Namen eines Hashes zu erfahren.
    </para>
    <para>
     <function>mhash_get_hash_name</function> nimmt die Hash Id als
     Argument und gibt den Namen des Hashs zurck oder &false;, wenn der
     Hash nicht existiert.
    </para>
    <para>
     <example>
      <title>Mhash_get_hash_name Beispiel</title>
      <programlisting role="php">
<![CDATA[
<?php
$hash = MHASH_MD5;

print mhash_get_hash_name ($hash);
?>
]]>
      </programlisting>
      <para>
     Das Beispiel oben gibt aus:
	   <screen>
<![CDATA[
MD5
]]>
       </screen>
      </para>
	 </example>
	</para>
   </refsect1>
  </refentry>

  <refentry id="function.mhash-get-block-size">
   <refnamediv>
    <refname>mhash_get_block_size</refname>
    <refpurpose>
     Gibt die Blockgroesse von dem bergebenem Hash zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</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> gibt die Groesse des
     bergebenen <parameter>Hashs</parameter>.
    </para>
    <para>
     <function>mhash_get_block_size</function> nimmt ein Argument, den
     <parameter>Hash</parameter> und gibt die Grsse in Byte oder
     &false;, wenn <parameter>Hash</parameter> nicht existiert.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.mhash-count">
   <refnamediv>
    <refname>mhash_count</refname>
    <refpurpose>Gibt den hchstmglichen Hash zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>mhash_count</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>mhash_count</function> gibt die hchsten verfgbaren
     Hash Id zurck. Hashes sind von 0 bis zu der Hash Id nummeriert.
    </para>
    <para>
     <example>
      <title>Alle Hashes durchlaufen</title>
      <programlisting role="php">
<![CDATA[
<?php

$nr = mhash_count();

for ($i = 0; $i <= $nr; $i++) {
    echo sprintf ("Die Blockgrsse von %s ist %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 berechnen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>mhash</methodname>
      <methodparam><type>int</type><parameter>hash</parameter></methodparam>
      <methodparam><type>string</type><parameter>data</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>mhash</function> verwendet eine Hash Funktion abhngig
     von <parameter>hash</parameter> auf <parameter>data</parameter>
     und gibt den resultierenden Hash zurck (wird auch Digest
     genannt).
    </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:
-->