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

  <partintro>
   <sect1 id="ldap.intro">
   <title>Einfhrung zu LDAP</title>
    <para>
     LDAP steht fr Lightweight Directory Access Protocol und ist
     ein Protokoll um auf "Directory Servers" - "Verzeichnis-
     Server" - zuzugreifen.
     Das Verzeichnis ist dabei eine spezielle Art einer Datenbank,
     das Informationen in einer Baumstruktur bereithlt.
    </para>
    <para>
     Das Konzept ist dabei hnlich der Verzeichnisstruktur Ihrer
     Festplatte, mit der Ausnahme, da in diesem Zusammenhang
     das Wurzelverzeichnis "Die Welt" ist und die
     Unterverzeichnisse der ersten Ebene "Lnder" abbilden.
     Die weiteren Verzeichnisse unterhalb der Lnderebene enthalten
     Eintrge fr Firmen, Organisationen oder Stdte. Noch tiefer
     geschachtelt stehen Verzeichniseintrge fr Menschen und
     vielleicht fr Ausstattung oder Dokumente.
    </para>
    <para>
     Um auf eine Datei in einem Unterverzeichnis auf Ihrer
     Festplatte zu verweisen, knnten Sie eine Schreibweise wie
     folgt verwenden
     </para>
    <literallayout>
    /usr/local/meine_daten/doku
    </literallayout>
    <para>
     Die Schrgstriche markieren jeden Teil in diesem Verweis und
     die Sequenz wird von links nach rechts gelesen.
    </para>
    <para>
     Das entsprechende Gegenstck zu einer voll qualifizierten
     Dateireferenz ist in LDAP der "Eindeutige Name"
     ("distinguished name"), der Einfachheit halber als "dn"
     bezeichnet.
     Ein Beispiel fr einen solchen dn knnte sein
    </para>
    <literallayout>
    cn=Hans Mustermann,ou=Buchhaltung,o=Meine Firma,c=DE
    </literallayout>
    <para>
     Das Komma markiert jeden Teil in diesem Verweis und die
     Sequenz wird von rechts nach links gelesen.
     Diesen dn wrden Sie wie folgt lesen ...
    </para>
    <literallayout>
    Land = DE
    Organisation (organisation) = Meine Firma
    Organisationseinheit (organisational unit) = Buchhaltung
    Einfacher Name (commonName) = Hans Mustermann
    </literallayout>
    <para>
     In der gleichen Weise, in der es keine allgemeinverbindlichen
     Regeln gibt, wie Sie die Verzeichnisstruktur Ihrer Festplatte
     organsieren, kann der Verwalter eines Verzeichnis-Servers jede
     beliebige Struktur implementieren, die fr den Einsatzzweck
     sinnvoll ist.
     Trotzdem gibt es einige Konventionen die benutzt werden.
     Die Botschaft ist folgende: Sie knnen keinen Code schreiben
     um auf einen Verzeichnis-Server zuzugreifen, ohne etwas ber
     dessen Struktur zu wissen. Genauso wenig knnen Sie eine
     Datenbank nutzen ohne Kenntnis darber, was in derselben
     vorhanden ist.
    </para>
   </sect1>

<sect1 id="ldap-example">
<title>Komplettes Code Beispiel</title>
    <para>
     Informationen von einem Verzeichnis-Server beziehen fr alle
     Eintrge bei denen der Nachname mit "S" beginnt. Darstellung
     eines Auszugs mit Name und Email-Adresse.
    </para>

    <example>
    <title>LDAP Such-Beispiel</title>
    <programlisting role="php">
<![CDATA[
<?php
    // Grundlegende Abfolge bei LDAP ist verbinden, binden, suchen,
    // interpretieren des Sucheergebnisses, Verbindung schlieen

    echo "<h3>LDAP query Test</h3>";
    echo "Verbindung ...";
    $ds=ldap_connect("localhost");  // muss ein gltiger LDAP Server
                                    // sein!

    echo "Ergebnis der Verbindung: ".$ds."<p>";

    if ($ds) {
    echo "Bindung ...";
    $r=ldap_bind($ds);     // das ist ein "anonymer" bind,
                           // typischerweise nur Lese Zugriff
    echo "Ergebnis der Bindung ".$r."<p>";

    echo "Suche nach (sn=S*) ...";
    // Suchen des Nachnamen-Eintrags
    $sr=ldap_search($ds,"o=Meine Firma, c=DE", "sn=S*");
    echo "Ergebnis der Suche ".$sr."<p>";

    echo "Anzahl gefundenen Eintrge ".ldap_count_entries($ds,$sr)."<p>";

    echo "Eintrge holen ...<p>";
    $info = ldap_get_entries($ds, $sr);
    echo "Daten fr ".$info["count"]." Items gefunden:<p>";

    for ($i=0; $i<$info["count"]; $i++) {
        echo "dn ist: ". $info[$i]["dn"] ."<br>";
        echo "erster cn Eintrag: ". $info[$i]["cn"][0] ."<br>";
        echo "erster email Eintrag: ". $info[$i]["mail"][0] ."<p>";
    }

    echo "Verbindung schlieen";
    ldap_close($ds);

} else {
    echo "<h4>Verbindung zu LDAP Server nicht mglich</h4>";
}
?>
]]>
    </programlisting>
    </example>

   <sect2 id="ldap.using">
    <title>Verwenden der PHP LDAP Aufrufe</title>
     <para>
      Sie mssen sich die LDAP Client Bibliotheken herunterladen und
      bersetzen. Sie knnen entweder das ldap-3.3 Packet von der
      University of Michigan oder das Netscape Directory SDK 3.0
      verwenden. Ebenso mssen Sie Ihr PHP mit LDAP Untersttzung
      aktiviert neu bersetzen bevor die PHP LDAP-Aufrufe
      funktionieren.
     </para>
     <para>
      Bevor Sie die LDAP Aufrufe benutzen knnen, mssen Sie folgendes
      wissen...
     <itemizedlist>
      <listitem>
       <para>
        Den Namen oder die Adresse des Verzeichnis-Servers den Sie
        benutzen wollen
      </para>
      </listitem>
      <listitem>
       <para>
        Den "Basis dn" des Servers (den Teil des Weltverzeichnisses,
        das auf diesem Server eingerichtet ist, das knnte "o=Meine
        Firma,c=DE" sein.
       </para>
      </listitem>
      <listitem>
       <para>
        Brauchen Sie ein Passwort um auf den Server zuzugreifen?
        (Viele Server bieten Lesezugriff fr einen "anonymen bind",
        verlangen aber ein Passwort fr alles weitere)
       </para>
      </listitem>
     </itemizedlist>
    </para>
    <para>
     Die typische Abfolge von LDAP Aufrufen in einer Anwendung folgen
     diesem Muster
<literallayout>
  ldap_connect()    // Aufbau einer Verbindung zum Server

  connection to server
     |
  ldap_bind()       // anonymes oder authentifiziertes "login"
     |
  mache irgendwas, z.B. Verzeichnis durchsuchen oder aktualisieren
  und stelle das Ergebnis dar
     |
  ldap_close()      // "logout"
</literallayout>
</para>
   </sect2>

   <sect2 id="ldap.moreinfo">
   <title>Mehr Informationen</title>
    <para>
     Viele Informationen finden Sie unter
    </para>

    <itemizedlist>
     <listitem>
      <para>
       <ulink url="&url.ldap.netscape;">Netscape</ulink>
      </para>
     </listitem>
     <listitem>
      <para>
       <ulink url="&url.ldap.michigan;">University of Michigan</ulink>
      </para>
     </listitem>
     <listitem>
      <para>
       <ulink url="&url.ldap.openldap;">OpenLDAP Project</ulink>
      </para>
     </listitem>
     <listitem>
      <para>
       <ulink url="&url.ldap.ldapworld;">LDAP World</ulink>
      </para>
     </listitem>
    </itemizedlist>

    <para>
     Das Netscape SDK enthlt einen hilfreichen Programmers Guide im
     .html Format.
    </para>
   </sect2>
  </sect1>

  </partintro>


  <refentry id="function.ldap-add">
   <refnamediv>
    <refname>ldap_add</refname>
    <refpurpose>
     Eintrge einem LDAP Verzeichnis hinzufgen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_add</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
      <methodparam><type>array</type><parameter>eintrag</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: &return.success;
    </para>
    <para>
     Die <function>ldap_add</function> Funktion wird benutzt um
     Eintrge einem Verzeichnis hinzuzufgen. Die DN des Eintrags, der
     hinzugefgt werden soll wird durch <parameter>dn</parameter> bestimmt.
     Das Array <parameter>eintrag</parameter> bestimmt die Informationen
     des Eintrags. Die Werte in den Eintrgen werden durch individuelle
     Merkmale indiziert. Im Fall von mehreren Werten fr ein Merkmal werden
     diese durch die Verwendung von Zahlen indiziert, die bei 0 beginnen.
    </para>
    <informalexample>
<literallayout>
    eintrag["merkmal1"] = wert
    eintrag["merkmal2"][0] = wert1
    eintrag["merkmal2"][1] = wert2
</literallayout>
     </informalexample>
     <example>
      <title>Komplettes Beispiel mit authentifiziertem bind</title>
      <programlisting role="php">
<![CDATA[
<?php
$ds=ldap_connect("localhost");  // Annahme: der LDAP Server befindet
                                // sich auf diesem Host

if ($ds) {
    // bind mit passendem dn fr aktulisierenden Zugriff
    $r=ldap_bind($ds,"cn=root, o=Meine Firma, c=DE", "geheim");

    // Daten vorbereiten
    $info["cn"]="Hans Mustermann";
    $info["sn"]="Mustermann";
    $info["mail"]="MustermannH@firma.de";
    $info["objectclass"]="person";

    // hinzufgen der Daten zum Verzeichnis
    $r=ldap_add($ds, "cn=Hans Mustermann, o=Meine Firma, c=DE", $info);

    ldap_close($ds);
} else {
    echo "Verbindung zum LDAP Server nicht mglich!";
}
?>
]]>
      </programlisting>
     </example>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-bind">
   <refnamediv>
    <refname>ldap_bind</refname>
    <refpurpose>Bindung zu einem LDAP Verzeichnis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_bind</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>bind_rdn
      </parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>bind_kennwort
      </parameter></methodparam>
     </methodsynopsis>
    <para>
     Bindung fr ein LDAP Verzeichnis mit angegebenem RDN und
     Kennwort. &return.success;
    </para>
    <para>
     Die <function>ldap_bind</function> Funktion fhrt eine bind
     Operation auf einem Verzeichnis aus. Die Parameter
     <parameter>bind_rdn</parameter> und
     <parameter>bind_kennwort</parameter> sind optional, wenn diese
     fehlen wird ein anonymes bind versucht.
     </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-close">
   <refnamediv>
    <refname>ldap_close</refname>
    <refpurpose>Verbindung zum LDAP Server schliessen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_close</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     &return.success;
    </para>
    <para>
     Die <function>ldap_close</function> Funktion schliet die
     Verbindung zum LDAP Server die zur
     <parameter>Verbindungs-Kennung</parameter> gehrt.
    </para>
    <para>
     Der Aufruf dieser Funktion ist intern identisch zu
     <function>ldap_unbind</function>. Die LDAP API benutzt den Aufruf
     <function>ldap_unbind</function>, so dass Sie vielleicht diese
     Funktion benutzen sollten, anstatt<function>
     ldap_close</function> zu verwenden.</para>
     <note>
      <para>
       Diese Funktion ist ein Alias fr <function>ldap_unbind</function>.
      </para>
     </note>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-compare">
   <refnamediv>
    <refname>ldap_compare</refname>
    <refpurpose>
     Vergleicht gefundenen Wert eines Merkmal in einem Eintrag, der
     durch Angabe von dn bestimmt wird.
   </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_compare</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
      <methodparam><type>string</type><parameter>merkmal</parameter></methodparam>
      <methodparam><type>string</type><parameter>wert</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Rckgabewert: wahr, wenn der <parameter>wert</parameter> gefunden
     wird, ansonsten &false;. Tritt ein Fehler auf, wird -1 zurckgegeben.
    </simpara>
    <para>
     <function>ldap_compare</function> vergleicht den<parameter>
     wert</parameter> eines <parameter>merkmal</parameter> mit dem
     Wert des gleichen Merkmals in dem LDAP Verzeichniseintrag der
     durch <parameter>dn</parameter> bestimmt wurde.
    </para>
    <simpara>
     Das folgende Beispiel zeigt, wie berprft wird, ob ein gegebenes
     Kennwort mit dem Kennwort bereinstimmt oder nicht, das in dem
     durch DN bestimmten Entrag gespeichert ist.
    </simpara>
    <example>
    <title>Komplettes Beispiel einer Kennwort-berprfung</title>
    <programlisting role="php">
<![CDATA[
<?php

$ds=ldap_connect("localhost");  // Annahme: der LDAP Server befindet
                                // sich auf diesem Host

if ($ds) {

    // binden
    if(ldap_bind($ds)) {

        // Daten vobereiten
        $dn = "cn=Helga Olsen, ou=Meine Einheit, o=Meine Firma, c=FI";
        $value = "Geheimes Kennwort";
        $attr = "kennwort";

        // vergleiche die Werte
        $r=ldap_compare($ds, $dn, $attr, $value);

        if ($r === -1) {
            echo "Fehler: ".ldap_error($ds);
        } elseif ($r === TRUE) {
            echo "Kennwort korrekt.";
        } elseif ($r === FALSE) {
            echo "Falsch geraten! Kennwort nicht korrekt.";
        }

    } else {
        echo "Keine Bindung zum LDAP Server mglich.";
    }

    ldap_close($ds);

} else {
    echo "Keine Verbindung zum LDAP Server mglich.";
}
?>

]]>
     </programlisting>
    </example>
    <warning>
     <para>
      <function>ldap_compare</function> kann NICHT fr Vergleiche von
      BINREN Werten benutzt werden!
     </para>
    </warning>
    <note>
     <para>
      Diese Funktion wurde in 4.0.2 hinzugefgt.
     </para>
    </note>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-connect">
   <refnamediv>
    <refname>ldap_connect</refname>
    <refpurpose>Verbindung zu einem LDAP Server</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_connect</methodname>
      <methodparam choice="opt"><type>string</type><parameter>hostname
      </parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>port</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: Eine positive Verbindungs-Kennung im Erfolgsfall,
     &false; im Fehlerfall.
    </para>
    <para>
     Die <function>ldap_connect</function> Funktion stellt eine
     Verbindung zu einem LDAP Server auf einem bestimmten<parameter>
     hostname</parameter> und <parameter>port</parameter> her. Beide
     Argumente sind optional. Werden keine Argumente angegeben ,
     wird die Verbindungs-Kennung einer schon geffneten
     Verbindung zurckgeliefert. Wird nur der
     <parameter>hostname</parameter> angegeben, wird fr den Port der
     Standarport 389 benutzt.
    </para>
    <para>
     Bei Verwendung von OpenLDAP 2.x.x knnen Sie eine URL statt des
     Hostnamens angeben. Um LDAP mit SSL-Untersttzzung zu verwenden,
     bersetzen Sie OpenLDAP mit SSL-Untersttzung, PHP mit SSL und verwenden
     ldaps://Hostname/ als Host Argument. Das Port Argument wird bei
     der Verwendung von URLs nicht benutzt.
     </para>
     <note>
      <simpara>
       URL und SSL Untersttzung wurden in 4.0.4 hinzugefgt
      </simpara>
     </note>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-count-entries">
   <refnamediv>
    <refname>ldap_count_entries</refname>
    <refpurpose>Zhlt die Anzahl der Eintrge bei einer Suche</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_count_entries</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: Anzahl der Eintrge im Ergebnis, &false; im
     Fehlerfall.</para>
    <para>
     Die <function>ldap_count_entries</function> Funktion liefert die
     Anzahl der Eintrge im gespeicherten Ergebnis einer vorher
     durchgefhrten Suchoperation. Die
     <parameter>Ergebnis-Kennung</parameter> bezeichnet das interne
     LDAP Ergebnis.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-delete">
   <refnamediv>
    <refname>ldap_delete</refname>
    <refpurpose>Lscht einen Eintrag aus einem Verzeichnis
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_delete</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
     </methodsynopsis>
    <para>
     &return.success;
    </para>
    <para>
     Die <function>ldap_delete</function> Funktion lscht einen
     einzelnen Eintrag aus einem LDAP Verzeichnis, das im
     <parameter>dn</parameter> angegeben wurde.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-dn2ufn">
   <refnamediv>
    <refname>ldap_dn2ufn</refname>
    <refpurpose>
    Konvertiert DN in ein benutzerfreundliches Namensformat
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>ldap_dn2ufn</methodname>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die <function>ldap_dn2ufn</function> Funktion wird verwendet um
     einen DN, angegeben mit <parameter>dn</parameter>, in einer
     benutzerfreundlicheren Form darzustellen, wobei die Typen-Namen
     wegfallen.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-err2str">
   <refnamediv>
    <refname>ldap_err2str</refname>
    <refpurpose>
     Konvertiert eine LDAP Fehlernummer in einen Fehlertext
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>ldap_err2str</methodname>
      <methodparam><type>int</type><parameter>fehlernummer</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: Fehlertext.</para>
    <para>
     Diese Funktion liefert den Fehlertext der die 
     <parameter>fehlernummer</parameter> erklrt.
     Whrend LDAP Fehlernummern standardisiert sind, liefern
     unterschiedliche Bibliotheken unterschiedliche oder sogar
     lokalspezifische Fehlermeldungen. Deshalb sollten Sie nie auf
     eine spezielle Fehlermeldung prfen, sondern immer eine
     Fehlernummer verwenden.
    </para>
    <para>
     Siehe auch <function>ldap_errno</function> und
     <function>ldap_error</function>.

    <example>
     <title>Aufzhlung aller LDAP Fehlermeldungen</title>
      <programlisting role="php">
<![CDATA[
<?php
  for($i=0; $i<100; $i++) {
    printf("Fehler $i: %s<br>\n", ldap_err2str($i));
  }
?>
]]>
     </programlisting>
    </example>
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-errno">
   <refnamediv>
    <refname>ldap_errno</refname>
    <refpurpose>
     Liefert die LDAP Fehlernummer des letzten LDAP Kommandos
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_errno</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: LDAP Fehlernummer des letzten LDAP Kommandos fr
     diese Verbindung.
    </para>
    <para>
     Diese Funktion liefert die standardisierte Fehlernummer des
     zuletzt ausgefhrten LDAP Kommandos fr die angegebene
     Vebindungs-Kennung. Diese Nummer kann mit der Funktion 
     <function>ldap_err2str</function> in einen Fehlertext konvertiert
     werden.
    </para>
    <para>
     Solange Sie die Stufe der Fehlerwarnungen in Ihrer php.ini nicht
     herabsetzen oder vor Ihre LDAP Komanndos ein @ (at) setzen
     um die Ausgabe von Fehlermeldungen zu unterdrcken, werden die
     aufgetretenen Fehler auch in Ihrer HTML Ausgabe zu sehen sein.
    <example>
    <title>Erzeugen und Abfangen eines Fehlers</title>
    <programlisting role="php">
<![CDATA[
<?php
// Dieses Beispiel enhlt einen Fehler, der abgefangen wird.
$ld = ldap_connect("localhost");
$bind = ldap_bind($ld);

// Syntax Fehler im Filterausdruck (errno 87),
// msste "objectclass=*" heien, um zu funktionieren.

$res =  @ldap_search($ld, "o=Meine Firma, c=DE", "objectclass");
if (!$res) {
    printf("LDAP-Fehlernummer: %s<br>\n", ldap_errno($ld));
    printf("LDAP-Fehler: %s<br>\n", ldap_error($ld));
    die("Argh!<br>\n");
}
$info = ldap_get_entries($ld, $res);
printf("%d bereinstimmende Eintrge.<br>\n", $info["count"]);
?>
]]>
     </programlisting>
    </example>
   </para>
   <para>
     Siehe auch <function>ldap_err2str</function> und
     <function>ldap_error</function>.</para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-error">
   <refnamediv>
    <refname>ldap_error</refname>
    <refpurpose>
     Liefert die LDAP Fehlermeldung des letzten LDAP Kommandos
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>ldap_error</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabe: Fehlertext</para>
    <para>
     Diese Funktion liefert den erklrenden Fehlertext fr einen
     Fehler, der vom zuletzt ausgefhrten LDAP Kommando mit der
     angegebenen <parameter>Verbindungs-Kennung</parameter>
     erzeugt wurde. Whrend LDAP Fehlernummern standardisiert sind,
     liefern unterschiedliche Bibliotheken unterschiedliche oder sogar
     lokalspezifische Fehlermeldungen. Deshalb sollten Sie nie auf
     eine spezielle Fehlermeldung prfen, sondern immer eine
     Fehlernummer verwenden.
    </para>
    <para>
     Solange Sie die Stufe der Fehlerwarnungen in Ihrer 
     <filename>php.ini</filename> nicht herabsetzen oder vor Ihre 
     LDAP Komanndos ein <literal>@</literal> (at) setzen,
     um die Ausgabe von Fehlermeldungen zu unterdrcken, werden die
     aufgetretenen Fehler auch in Ihrer HTML Ausgabe zu sehen sein.
    </para>
    <para>
     Siehe auch <function>ldap_err2str</function> und
     <function>ldap_errno</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-explode-dn">
   <refnamediv>
    <refname>ldap_explode_dn</refname>
    <refpurpose>
     Aufteilung eines DN in seine Bestandteile
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>ldap_explode_dn</methodname>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
      <methodparam><type>int</type><parameter>mit_merkmal</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die <function>ldap_explode_dn</function> Funktion wird benutzt um
     einen von <function>ldap_get_dn</function> gelieferten DN
     aufzuteilen und in dessen Bestandteile zu zerlegen. Jeder Teil
     wird als Relative Distinguished Name, RDN, bezeichnet.
     <function>ldap_explode_dn</function> liefert einen Array mit
     allen diesen Bestandteilen.
     Der Parameter <parameter>mit_merkmal</parameter> wird benutzt, um
     zu bestimmen, ob die RDNs nur mit Werten oder zustlich mit ihren
     Merkmalen angefragt werden. Um RDNs mit Merkmalen (z.B. Merkmal =
     Wert Format) zu erhalten, setzen Sie <parameter>
     mit_merkmal</parameter> auf 0, um nur Werte zu erhalten auf 1.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-first-attribute">
   <refnamediv>
    <refname>ldap_first_attribute</refname>
    <refpurpose>Liefert das erste Merkmal</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>ldap_first_attribute</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Eintrag-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>ber-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: im Erfolgsfall das erste Merkmal des Eintrags, im
     Fehlerfall &false;.
    </para>
    <para>
     hnlich wie Eintrge lesen, werden Merkmale eines bestimmten Eintrags
     eines nach dem anderen gelesen.
     Die <function>ldap_first_attribute</function> Funktion liefert
     das erste Merkmal eines Eintrags der durch die
     <parameter>Ergebnis-Eintrag-Kennung</parameter> angegeben wurde.
     Durch erfolgreichen Aufruf von <function>ldap_next_attribute</function>
     erhalten Sie die restlichen Merkmale.
     Der Parameter <parameter>ber-Kennung</parameter> ist die Kennung
     eines internen Speicherort-Zeiger. Die bergabe erfolgt per
     Referenz. Die gleiche <parameter>ber-Kennung</parameter> wird an
     die Funktion <function>ldap_next_attribute</function>
     weitergegeben, die diesen Zeiger dann verndert.
    </para>
    <para>
     Siehe auch <function>ldap_get_attributes</function></para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-first-entry">
   <refnamediv>
    <refname>ldap_first_entry</refname>
    <refpurpose>
     Liefert die Kennung des ersten Ergebnisses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_first_entry</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: im Erfolgsfall die Ergebnis-Eintrag-Kennung
     fr den ersten Eintrag, &false; im Fehlerfall.
    </para>
    <para>
     Eintrge eines LDAP Ergebnisses werden unter Verwendung der
     Funktionen <function>ldap_first_entry</function> und
     <function>ldap_next_entry</function> sequentiell gelesen.
     Die <function>ldap_first_entry</function> Funktion gibt die
     Eintrag-Kennung fr den ersten Eintrag im Ergebnis zurck.
     Diese Eintrag-Kennung wird dann an die Funktion
     <function>ldap_next_entry</function> weitergegeben, um sukzessiv
     die Eintrge des Ergebnisses zu erhalten.
    </para>
    <para>
     Siehe auch <function>ldap_get_entries</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-free-result">
   <refnamediv>
    <refname>ldap_free_result</refname>
    <refpurpose>
     Gibt den belegten Speicher wieder frei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_free_result</methodname>
      <methodparam><type>int</type><parameter>Ergebnis-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     &return.success;
    </para>
    <para>
     Um die Ergebnisse zu speichern, wird intern Speicher belegt.
     Diesen Speicher knnen Sie mit der Funktion
     <function>ldap_free_result</function> mir Angabe der entsprechenden
     <parameter>Ergebnis-Kennung</parameter> wieder freigeben.
     Typischerweise wird nach Beendigung des Skripts wird der gesamte
     Ergebnis-Speicher automatisch freigegeben.
    </para>
    <para>
     Falls Ihr Skript sukzessive Suchoperationen durchfhrt, die
     groe Ergebnismengen liefern, knnen Sie <function>
     ldap_free_result</function> aufrufen, um den Speicherverbrauch
     zur Laufzeit niedrig zu halten.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-get-attributes">
   <refnamediv>
    <refname>ldap_get_attributes</refname>
    <refpurpose>
     Liefert Merkmale eines Suchergebnis-Eintrags
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>ldap_get_attributes</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Eintrag-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: im Erfolgsfall wird die gesamte Information eines
     Eintrags in einem multidimensionalen Array zurckgegeben; im
     Fehlerfall &false;.
    </para>
    <para>
     Die <function>ldap_get_attributes</function> Funktion
     wird verwendet um das Lesen der Merkmale und Werte eines Eintrags
     im Suchergebnis zu vereinfachen. Der Rckgabewert ist ein
     multidimensionales Array aus Merkmalen und Werten.
    </para>
    <para>
     Nachdem Sie einen bestimmten Eintrag in dem Verzeichnis
     lokalisiert haben, knnen Sie mit dieser Funktion herausfinden,
     welche Informationen fr diesen Eintrag verfgbar sind. Diese
     Funktion wrden Sie in einer Anwendung verwenden, die
     Verzeichniseintrge "durchstbert" und/oder wo Sie die Struktur
     der Verzeichniseintrge nicht kennen. In vielen Anwendungen
     suchen Sie nach einem bestimmten Merkmal wie einer email-Adresse
     oder einem Nachnamen und interessieren sich nicht dafr,
     welche anderen Daten verfgbar sind.
    </para>
    <para>
     <informalexample><literallayout>
return_value["count"] = Anzahl der Merkmale des Eintrags
return_value[0] = das erste Merkmal
return_value[n] = das n-te Merkmal

return_value["merkmal"]["count"] = Anzahl der Werte des Merkmals
return_value["merkmal"][0] = der erste Wert des Merkmals
return_value["merkmal"][i] = der i-te Wert des Merkmals
</literallayout></informalexample>

    <example>
     <title>
      Anzeigen der Liste der Merkmale fr einen ausgewhlten
      Verzeichnis-Eintrag
     </title>
     <programlisting role="php">
<![CDATA[
// $ds die Verbindungs-Kennung fr das Verzeichnis

// $sr ein gltiges Suchergebnis eines frheren Aufrufs einer der ldap
// Verzeichnis Suchfunktionen


$entry = ldap_first_entry($ds, $sr);

$attrs = ldap_get_attributes($ds, $entry);

echo $attrs["count"]." Merkmale fr diesen Eintrag:<p>";

for ($i=0; $i<$attrs["count"]; $i++)
    echo $attrs[$i]."<br>";
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch <function>ldap_first_attribute</function> und
     <function>ldap_next_attribute</function>
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-get-dn">
   <refnamediv>
    <refname>ldap_get_dn</refname>
    <refpurpose>Liefert den DN eines Ergebnis-Eintrags </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>ldap_get_dn</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Eintrag-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: im Erfolgsfall der DN des Ergebnis-Eintrags, im
     Fehlerfall &false;.
    </para>
    <para>
     Die <function>ldap_get_dn</function> Funktion wird verwendet, um
     den DN eines Eintrags im Ergebnis herauszufinden.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-get-entries">
   <refnamediv>
    <refname>ldap_get_entries</refname>
    <refpurpose>Liefert alle Ergebnis-Eintrge</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>ldap_get_entries</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: im Erfolgsfall wird die gesamte Information des
     Ergebnisses in einem multidimensionalen Array zurckgegeben; im
     Fehlerfall &false;.
    </para>
    <para>
     Die <function>ldap_get_entries</function> Funktion wird verwendet
     um das Lesen mehrfacher Eintrge des Ergebnisses, angegeben mit
     <parameter>Ergebnis-Kennung</parameter> zu vereinfachen
     und danach werden die Merkmale und mehfachen Werte gelesen.
     Durch einen Funktionsaufruf wird die gesamte Information in einem
     multidimensionalen Array zurckgegeben. Die Struktur dieses Array
     sieht wie folgt aus.
    </para>
    <para>
     Der Merkmal-Index wird in Kleinbuchstaben umgewandelt.
     (Verzeichnis-Server unterscheiden nicht zwischen
     Gro-/Kleinschreibung hinsichtlich der Merkmake, aber der
     Unterschied ist wichtig, wenn diese Merkmale als Array-Indizes
     benutzt werden.)

    <informalexample>
<literallayout>
return_value["count"] = Anzahl der Eintrge im Ergebnis
return_value[0] : bezieht sich auf Einzelheiten des ersten Eintrags

return_value[i]["dn"] =  DN des i-ten Eintrags im Ergebnis

return_value[i]["count"] = Anzahl der Merkmale im i-ten Eintrag
return_value[i][j]       = das j-te Merkmal des i-ten Eintrags im Ergebnis

return_value[i]["merkmal"]["count"] = Anzahl der Werte fr das
                                      Merkmal im i-ten Eintrag
return_value[i]["merkmal"][j]       = der j-te Wert des Merkmals im i-ten
                                      Eintrag
</literallayout>
    </informalexample>
   </para>
   <para>
    Siehe auch <function>ldap_first_entry</function> und
    <function>ldap_next_entry</function>
   </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-get-option">
   <refnamediv>
    <refname>ldap_get_option</refname>
    <refpurpose>
     Liefert den aktuellen Wert fr eine gegebene Option
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>ldap_get_option</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>option</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>retval</parameter></methodparam>
     </methodsynopsis>
    <para>
     Setzt <parameter>retval</parameter> auf den Wert der gewhlten
     Option. &return.success;
    </para>
    <para>
     Der Parameter <parameter>option</parameter> kann einer der
     folgenden sein:
     LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT, LDAP_OPT_TIMELIMIT,
     LDAP_OPT_PROTOCOL_VERSION, LDAP_OPT_ERROR_NUMBER,
     LDAP_OPT_REFERRALS, LDAP_OPT_RESTART, LDAP_OPT_HOST_NAME,
     LDAP_OPT_ERROR_STRING, LDAP_OPT_MATCHED_DN. Beschrieben sind diese unter
     <ulink url="&url.ldap.openldap-c-api;">draft-ietf-ldapext-ldap-c-
     api-xx.txt</ulink>
     </para>
     <note>
      <para>
       Diese Funktion steht nur zur Verfgung, wenn Sie OpenLDAP 2.x.x
       ODER Netscape Directory SDK x.x benutzen.
       Wurde in PHP 4.0.4 hinzugefgt.
      </para>
     </note>
     <para>
     <example>
      <title>Prfen der Protokollversion</title>
      <programlisting role="php">
<![CDATA[
// $ds eine gltige Verbindungs-Kennung fr einen Verzeichnis-Server

if (ldap_get_option($ds, LDAP_OPT_PROTOCOL_VERSION, $version))
    echo "Sie benutzen die Protokollversion $version";
else
    echo "Protokollversion konnte nicht bestimmt werden";
]]>
      </programlisting>
     </example>
    </para>

     <para>
      Siehe auch <function>ldap_set_option</function>.
     </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-get-values">
   <refnamediv>
    <refname>ldap_get_values</refname>
    <refpurpose>
     Liefert alle Werte eines Ergebnis-Eintrags
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>ldap_get_values</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Eintrag-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>merkmal</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: im Erfolgsfall ein Array der Werte des Merkmals,
     &false; im Fehlerfall.
    </para>
    <para>
     Die <function>ldap_get_values</function> Funktion wird benutzt um
     alle Werte des Merkmals eines Eintrags im Ergebnis zu lesen. Der
     Eintrag wird durch
     <parameter>Ergebnis-Eintrag-Kennung</parameter> bestimmt. Die
     Anzahl der Werte kann ber die Indexierung von "count" des
     resultierenden Arrays bestimmt werden. Der Zugriff auf einzelne Werte
     erfolgt durch einen ganzzahligen Index im Array. Der erste Indexwert
     ist 0.
    </para>
    <para>
     Da diese Funktion eine
     <parameter>Ergebnis-Eintrag-Kennung</parameter> bentigt, muss
     ein Aufruf einer der LDAP Suchfunktionen und einer der
     Funktionen, die einen einzelnen Eintrag liefern, vorausgehen.
    </para>
    <para>
     Ihre Anwendung wird entweder hart codiert sein, um bestimmte
     Merkmale (wie z.B.: "Nachname" oder "Mail") zu suchen, oder Sie
     mssen die Funktion <function>ldap_get_attributes</function>
     benutzen, um herauszufinden, welche Merkmale fr einen gegebenen
     Eintrag vorhanden sind.
    </para>
    <para>
     LDAP erlaubt mehr als einen Eintrag fr ein Merkmal, so da es
     z.B. sein kann, dass der Verzeichnis-Eintrag einer Person mehrere
     Email-Adressen enthlt, die alle mit dem Merkmal "mail"
     bezeichnet sind.

    <informalexample>
<literallayout>
return_value["count"] = Anzahl der Werte eines Merkmals
return_value[0]       = der erste Wert des Merkmals
return_value[i]       = der i-te Wert des Merkmals
</literallayout>
    </informalexample>

     <example>
      <title>
       Liste aller Werte des Merkmals "mail" fr einen Verzeichnis-
       Eintrag
      </title>
      <programlisting role="php">
<![CDATA[
// $ds gltige Verbindungs-Kennung fr einen Verzeichnis-Server

// $sr gltiges Suchergebnis eines frheren Aufrufs einer der ldap
//     Verzeichnis Suchfunktionen

// $entry gltige Eintrag-Kennung eines frheren Aufrufs einer
//        der Funktionen, die einen Verzeichnis-Eintrag zurckgeben

$values = ldap_get_values($ds, $entry,"mail");

echo $values["count"]." Email-Adressen fr diesen Eintrag.<p>";

for ($i=0; $i < $values["count"]; $i++)
    echo $values[$i]."<br>";
]]>
      </programlisting>
     </example>
    </para>

   </refsect1>
  </refentry>


  <refentry id="function.ldap-get-values-len">
   <refnamediv>
    <refname>ldap_get_values_len</refname>
    <refpurpose>
     Liefert alle binren Werte eines Ergebnis-Eintrags
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>ldap_get_values_len</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Eintrag-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>merkmal</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: im Erfolgsfall ein Array der Werte des Merkmals,
     &false; im Fehlerfall.
    </para>
    <para>
     Die <function>ldap_get_values_len</function> Funktion wird
     benutzt um alle Werte des Merkmals eines Eintrags im Ergebnis zu
     lesen. Der Eintrag wird durch
     <parameter>Ergebnis-Eintrag-Kennung</parameter> bestimmt. Die
     Anzahl der Werte kann ber die Indexierung von "count" des
     resultierenden Arrays bestimmt werden. Der Zugriff auf einzelne
     Werte erfolgt durch einen ganzzahligen Index im Array. Der erste
     Indexwert ist 0.
    </para>
    <para>
     Diese Funktion wird exakt gleich benutzt wie die
     Funktion <function>ldap_get_values</function> mit der Aussnahme,
     dass hier binre Daten statt Textdaten behandelt werden.
    </para>
    <note>
     <para>
      Diese Funktion wurde in 4.0 hinzugefgt.
     </para>
    </note>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-list">
   <refnamediv>
    <refname>ldap_list</refname>
    <refpurpose>Einstufige Suche</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_list</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>basis_dn</parameter></methodparam>
      <methodparam><type>string</type><parameter>filter</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>merkmale</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>nur_merkmmale</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>grenbegrenzung</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>zeitbegrenzung</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>deref</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: im Erfolgsfall eine Such-Ergebnis-Kennung,im
     Fehlerfall &false;.
    </para>
    <para>
     Die <function>ldap_list</function> Funktion fhrt die Suche fr
     einen gegebenen <parameter>filter</parameter> im Verzeichnis mit
     der Reichweite von LDAP_SCOPE_ONELEVEL durch.
    </para>
    <para>
     LDAP_SCOPE_ONELEVEL bedeutet, dass die Suche nur Informationen
     liefert, die direkt unterhalb der Stufe liegen, die durch die
     Angabe des <parameter>basis_dn</parameter> im Auruf bestimmt wird.
     (Das entspricht der Eingabe von "ls", die eine Liste von Dateien und
     Verzeichnissen des aktuellen Arbeitsverzeichnisses anzeigt.)
    </para>
    <para>
     Der Aufruf dieser Funktion nimmt 5 optionale Parameter entgegen.
     Siehe die Anmerkungen zu <function>ldap_search</function>.
    <note>
     <para>
       Diese wahlfreien Parameter wurden in 4.0.2 hinzugefgt:
      <parameter>attrsonly</parameter>,
      <parameter>grenbegrenzung</parameter>,
      <parameter>zeitbegrenzung</parameter>,
      <parameter>deref</parameter>.
     </para>
    </note>

    <example>
      <title>
       Erzeugung einer Liste aller Organisationseinheiten einer
       Organisation
      </title>
      <programlisting role="php">
<![CDATA[
// $ds gltige Verbindungs-Kennung fr einen Verzeichnis-Server

$basis_dn = "o=Meine Firma, c=DE";
$nur_dieses = array("ou");

$sr=ldap_list($ds, $basis_dn, "ou=*", $nur_dieses);

$info = ldap_get_entries($ds, $sr);

for ($i=0; $i<$info["count"]; $i++)
    echo $info[$i]["ou"][0] ;
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      Seit der Version 4.0.5 ist es auerdem mglich parallele Suchen
      durchzufhren. Fr Details siehe <function>ldap_search</function>.
     </para>
    </note>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-modify">
   <refnamediv>
    <refname>ldap_modify</refname>
    <refpurpose>Verndern eines LDAP-Eintrags</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_modify</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
      <methodparam><type>array</type><parameter>eintrag</parameter></methodparam>
     </methodsynopsis>
    <para>&return.success;</para>
    <para>
     Die <function>ldap_modify</function> Funktion wird verwendet, um
     bestehende Eintrge in einem LDAP-Verzeichnis zu ndern.
     Die Struktur des Eintrags ist die gleiche wie bei
     <function>ldap_add</function>.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-mod-add">
   <refnamediv>
    <refname>ldap_mod_add</refname>
    <refpurpose>
     Hinzufgen von Merkmalswerten zu aktuellen Merkmalen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_mod_add</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
      <methodparam><type>array</type><parameter>eintrag</parameter></methodparam>
     </methodsynopsis>
    <para>&return.success;</para>
    <para>
     Diese Funktion fgt Merkmal(e) zum angegebenen <parameter>dn</parameter>
     hinzu. Die nderung wird auf der Merkmalsebene durchgefhrt im
     Gegensatz zur Objektebene. Das Hinzufgen auf der Objektebene
     wird durch die Funktion <function>ldap_add</function> geleistet.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ldap-mod-del">
   <refnamediv>
    <refname>ldap_mod_del</refname>
    <refpurpose>
     Lschen von Merkmalswerten aktueller Merkmale
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_mod_del</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
      <methodparam><type>array</type><parameter>eintrag</parameter></methodparam>
     </methodsynopsis>
    <para>&return.success;</para>
    <para>
     Diese Funktion lscht ein oder mehrere Merkmale vom angegebenen
     <parameter>dn</parameter>. Die nderung wird auf der Merkmalsebene
     durchgefhrt im Gegensatz zur Objektebene. Das Lschen auf Objektebene
     wird durch die Funktion <function>ldap_delete</function> geleistet.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ldap-mod-replace">
   <refnamediv>
    <refname>ldap_mod_replace</refname>
    <refpurpose>
     Ersetzen von Merkmalswerten mit neuen Merkmalswerten
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_mod_replace</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
      <methodparam><type>array</type><parameter>eintrag</parameter></methodparam>
     </methodsynopsis>
    <para>&return.success;
    </para>
    <para>
     Diese Funktion ersetzt ein oder mehrere Merkmale vom angegebenen
     <parameter>dn</parameter>. Die nderung wird auf der Merkmalsebene
     durchgefhrt im Gegensatz zur Objektebene. nderungen auf der Objektebene
     werden mit der Funktion <function>ldap_modify</function> ausgefhrt.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ldap-next-attribute">
   <refnamediv>
    <refname>ldap_next_attribute</refname>
    <refpurpose>
     Liefert das nchste Merkmal im Ergebnis
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>ldap_next_attribute</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Eintrag-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>ber_Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: im Erfolgsfall das nchste Merkmal eines Eintrags,
     im Fehlerfall &false;.
    </para>
    <para>
     Die <function>ldap_next_attribute</function> Funktion wird
     aufgerufen, um die Merkmale eines Eintrags zu erhalten. Der
     interne Status des Zeigers wird durch die
     <parameter>ber_Kennung</parameter> bestimmt. Diese wird mittels
     Referenz an die Funktion weitergegeben. Der erste Aufruf von 
     <function>ldap_next_attribute</function>
     erfolgt mit der <parameter>Ergebnis-Eintrag-Kennung</parameter>,
     die von <function>ldap_first_attribute</function> zurckgegeben wurde.
    </para>
    <para>
     Siehe auch <function>ldap_get_attributes</function>
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-next-entry">
   <refnamediv>
    <refname>ldap_next_entry</refname>
    <refpurpose>
     Liefert den nchsten Eintrag des Ergebnisses
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_next_entry</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>Ergebnis-Eintrag-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: Im Erfolgsfall wird die Eintrags-Kennung fr den
     nchsten Eintrag des Ergebnisses zurckgegeben. Das Lesen der
     Eintrge wird mit <function>ldap_first_entry</function>
     gestartet.
     Wenn keine weiteren Eintrge im Ergebnis vorhanden sind wird
     &false; zurckgegeben.
    </para>
    <para>
     Die <function>ldap_next_entry</function> Funktion wird verwendet,
     um die Eintrge zu erhalten, die im Ergebnis gespeichert sind.
     Wiederholtes aufrufen von <function>ldap_next_entry</function>
     liefert einen Eintrag nach dem anderen, solange bis kein Eintrag
     mehr vorliegt. Der erste Aufruf von <function>ldap_next_entry</function>
     erfolgt nach dem Aufruf von <function>ldap_first_entry</function>
     mit der <parameter>Ergebnis-Eintrag-Kennung</parameter>, die von
     <function>ldap_first_entry</function> zurckgegeben wurde.
    </para>
    <para>
     Siehe auch <function>ldap_get_entries</function>
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-read">
   <refnamediv>
    <refname>ldap_read</refname>
    <refpurpose>Lesen eines Eintrags</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_read</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>basis_dn</parameter></methodparam>
      <methodparam><type>string</type><parameter>filter</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>merkmale</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>nur_werte</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>grenbegrenzung</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>zeitbegrenzung</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>deref</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: Im Erfolgsfall eine Such-Ergebnis-Kennung, &false;
     im Fehlerfall.
    </para>
    <para>
     Die <function>ldap_read</function> Funktion fhrt die Suche fr
     einen gegebenen <parameter>filter</parameter> im Verzeichnis mit der
     Reichweite von LDAP_SCOPE_BASE durch. Das entpricht dem Lesen eines
     Eintrags in einem Verzeichnis.
    </para>
    <para>
     Ein leerer Filter ist nicht erlaubt. Wenn Sie wirklich alle
     Informationen fr einen Eintrag erhalten mchten, mssen Sie
     einen Filter der Art "objectClass=*" verwenden. Kennen Sie die
     Typen der Eintrge die auf dem Verzeichnis-Server benutzt werden,
     knnen Sie einen passenden Filter wie z.B."objectClass=inetOrgPerson"
     verwenden.
    </para>
    <para>
     Der Aufruf dieser Funktion nimmt 5 optionale Argumente
     entgegen. Siehe Anmerkungen zu <function>ldap_search</function>.
    </para>
    <note>
     <para>
      Diese wahlfreien Argumente wurden in 4.0.2 hinzugefgt:
      <parameter>nur_werte</parameter>,
      <parameter>grenbegrenzung</parameter>,
      <parameter>zeitbegrenzung</parameter>,
      <parameter>deref</parameter>.
     </para>
     <para>
      Seit der Version 4.0.5 ist es auerdem mglich parallele Suchen
      durchzufhren. Fr Details siehe
      <function>ldap_search</function>.
     </para>
    </note>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-rename">
   <refnamediv>
    <refname>ldap_rename</refname>
    <refpurpose>
     Verndert den Namen eines Eintrags
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>ldap_rename</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>dn</parameter></methodparam>
      <methodparam><type>string</type><parameter>neuerrdn</parameter></methodparam>
      <methodparam><type>string</type><parameter>neueeltern</parameter></methodparam>
      <methodparam><type>bool</type><parameter>lschealtenrdn</parameter></methodparam>
     </methodsynopsis>
    <para>
     Der Eintrag, der durch <parameter>dn</parameter> gegeben ist,
     wird umbenannt/gelscht. Der neue RDN wird durch
     <parameter>neuerrdn</parameter> bestimmt, der neue Eltern-/bergeordnete
     Eintrag wird durch <parameter>neueeltern</parameter> bestimmt.
     Wenn das Argument <parameter>lschealtenrdn</parameter> &true; ist,
     wird der alte Wert/die alten Werte von RDN enfernt, andernfalls
     wird der alte Wert/die alten Werte als nicht-eindeutige(r) (non-
     distinguished) Werte des Eintrags beibehalten. &return.success;
    </para>
    <note>
     <para>Diese Funktion arbeitet zum gegenwrtigen Zeitpunkt nur mit
      LDAPv3. Sie mssen <function>ldap_set_option</function>
      vorher benutzen um fr eine Bindung LDAPv3 nutzen zu knnen.
      Diese Funktion steht nur zur Verfgung, wenn Sie OpenLDAP 2.x.x
      ODER Netscape Directory SDK x.x benutzen. Wurde in PHP 4.0.5
      hinzugefgt.
     </para>
    </note>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-search">
   <refnamediv>
    <refname>ldap_search</refname>
    <refpurpose>Suche im LDAP Baum</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_search</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>string</type><parameter>base_dn</parameter></methodparam>
      <methodparam><type>string</type><parameter>filter</parameter></methodparam>
      <methodparam choice="opt"><type>array</type><parameter>merkmale</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>nur_werte</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>grenbegrenzung</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>zeitbegrenzung</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>deref</parameter></methodparam>
     </methodsynopsis>
    <para>
     Rckgabewert: eine Such-Ergebnis-Kennung im Erfolgsfall, &false;
     im Fehlerfall.
    </para>
    <para>
     Die <function>ldap_search</function> Funktion fhrt die Suche fr
     einen gegebenen Filter im Verzeichnis mit der Reichweite von
     LDAP_SCOPE_SUBTREE durch. Das ist quivalent zu einer Suche im
     ganzen Verzeichnis.<parameter>base_dn</parameter> legt den Basis
     DN fr das Verzeichnis fest.
    </para>
    <para>
     Der optionale vierte Parameter kann benutzt werden, um die
     Rckgabewerte des Servers so einzuschrnken, dass nur die
     tatschlich bentigten Merkmale und ihre zugehrigen Werte in der
     Ergebnismenge enthalten sind. Dieses Vorgehen ist um einiges
     effizienter als die standardmige Vorgehensweise (diese liefert
     alle Merkmale und alle zugehrigen Werte). Aus diesem Grund ist
     die Angabe des vierten Parameters als gute Praxis zu empfehlen.
    </para>
    <para>
     Der vierte Parameter ist ein Standard PHP Array aus Strings der
     bentigten Merkmale, z.B. array("mail","sn","cn"). Beachten Sie,
     dass der "dn" immer zurckgeliefert wird, ohne Rcksicht darauf,
     welche Merkmalstypen angefragt wurden.
    </para>
    <para>
     Beachten Sie weiterhin, dass manche Verzeichnis-Server so
     konfiguriert sind, dass sie nicht mehr als eine vorbestimmte
     Anzahl an Eintrgen zurckliefern. Sollte dies der Fall sein,
     zeigt Ihnen der Server an, dass nur eine Teilmenge des
     Ergebnisses zurckgeliefert wurde. Diesen Hinweis erhalten Sie
     auch, wenn Sie den sechsten Parameter
     <parameter>grenbegrenzung</parameter> mit angegeben hatten, um
     die Anzahl der angefragten Eintrge einzuschrnken.
    </para>
    <para>
     Der fnfte Parameter <parameter>nur_werte</parameter> sollte auf
     1 gesetzt werden, wenn Sie nur Merkmalstypen erhalten mchten.
     Wenn der Wert auf 0 steht, erhalten Sie sowohl Merkmalstypen als
     auch Merkmalswerte. Das ist das Standard Verhalten.
    </para>
    <para>
     Mit dem sechsten Parameter
     <parameter>grenbegrenzung</parameter> ist es mglich, die
     Anzahl der Eintrge, die Sie erhalten, zu begrenzen.
     Wenn Sie diesen Wert auf 0 setzen, bedeutet dies keine
     Beschrnkung der Ergegnismenge.
     ANMERKUNG: Dieser Parameter kann eine serverseitig gesetzte
     Beschrnkung NICHT berschreiben. Sie haben nur die Mglichkeit
     die Beschrnkung noch weiter herabzusetzen.
    </para>
    <para>
     Der siebte Parameter <parameter>zeitbegrenzung</parameter> legt
     die Zahl in Sekunden fest, die auf die Suche verwendet wird.
     Wenn Sie diesen Wert auf 0 setzen, bedeutet dies keine
     Beschrnkung der Zeit.
     ANMERKUNG: Dieser Parameter kann eine serverseitig gesetzte
     Zeitbegrenzung NICHT berschreiben. Sie haben nur die
     Mglichkeit die Beschrnkung noch weiter herabzusetzen.
    </para>
    <para>
     Der achte Parameter <parameter>deref</parameter> gibt an, wie
     Aliase whrend einer Suche behandelt werden.
     Wert kann einer der folgenden sein:
     <itemizedlist>
     <listitem>
      <simpara>
       LDAP_DEREF_NEVER - (Standard) Aliase werden nie aufgelst.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       LDAP_DEREF_SEARCHING - Aliase sollen whrend der Suche
       aufgelst werden, aber nicht dann, wenn das Basisobjekt der
       Suche ermittelt wird.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       LDAP_DEREF_FINDING - Aliase sollen aufgelst werden, wenn das
       Basisobjekt ermiitelt wird, aber nicht whrend der Suche.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       LDAP_DEREF_ALWAYS - Aliase sollen immer aufgelst werden.
      </simpara>
     </listitem>
     </itemizedlist>
    </para>
    <note>
     <para>
      Diese optionalen Parameter wurden in 4.0.2 hinzugefgt:
      <parameter>nur_werte</parameter>,
      <parameter>grenbegrenzung</parameter>,
      <parameter>zeitbegrenzung</parameter>,
      <parameter>deref</parameter>.
     </para>
    </note>
    <para>
     Der Suchfilter kann einfach oder kompliziert sein, wenn sie
     boolsche Operatoren in dem Format verwenden, wie in der LDAP
     Dokumentation beschrieben (siehe <ulink url="&url.ldap.filters;">
     Netscape Directory SDK</ulink> fr die vollstndige Information
     ber Filter).
    </para>
    <para>
     Das untenstehende Beispiel liefert die Organisationseinheit, den
     Familiennamen, den Vornamen und die Email-Addresse aller Personen
     in "Meine Firma" deren Familien- oder Vorname die Zeichenkette
     $person enhlt. In diesem Beispiel wird ein boolscher Filter
     verwendet, um den Server zu veranlassen, nach Informationen in
     mehr als einem Merkmal zu suchen.

     <example>
      <title>LDAP Suche</title>
      <programlisting role="php">
<![CDATA[
// $ds gltige Verbindungs-Kennung fr einen Verzeichnis-Server

// $person ein Teil oder der vollstndige Name einer Person, z.B. "Jo"

$dn = "o=Meine Firma, c=DE";
$filter="(|(sn=$person*)(vorname=$person*))";
$justthese = array( "ou", "sn", "vorname", "mail");

$sr=ldap_search($ds, $dn, $filter, $justthese);

$info = ldap_get_entries($ds, $sr);

print $info["count"]." gefundene Eintrge<p>";
]]>
</programlisting>
      </example>
    </para>
    <para>
     Seit der Version 4.0.5 ist es auerdem mglich parallele Suchen
     durchzufhren. Um dies zu verwirklichen benutzen Sie als erstes
     Argument einen Array von Verbindungs-Kennungen, statt einer
     einzelnen Verbindungs-Kennung. Falls Sie nicht den gleichen Basis
     DN und den gleichen Filter fr alle Suchen verwenden mchten,
     knnen Sie ebenso einen Array von Basis DNs und/oder einen Array
     von Filtern benutzen. Diese Arrays mssen die gleiche Gre wie
     das Array der Verbindungs-Kennungen haben, da die ersten Eintrge
     der Arrays fr eine Suche verwendet werden, die zweiten Eintrge
     fr eine andere Suche und so weiter. Wenn Sie parallel suchen
     erhalten Sie ein Array von Such-Ergebnis-Kennungen, auer im Fall
     eines Fehlers, dann liefert der  Eintrag zur entsprechenden Suche
     &false; zurck. Das entspricht ganz genau dem Wert der
     normalerweise zurckgeliefert wird, auer dass Sie immer eine
     Ergebnis-Kennung erhalten, wenn Sie eine Suche durchgefhrt
     haben. Es treten einige seltene Flle auf, wo eine normale Suche
     &false; zurckgibt, whrend die parallele Suche eine Kennung
     zurckliefert.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-set-option">
   <refnamediv>
    <refname>ldap_set_option</refname>
    <refpurpose>Setzt den Wert der gegebenen Option</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>ldap_set_option</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
      <methodparam><type>int</type><parameter>option</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>neuerwert</parameter></methodparam>
     </methodsynopsis>
    <para>
     Setzt den Wert der bestimmten Option auf 
     <parameter>neuerwert</parameter>.&return.success;
    </para>
    <para>
     Der Parameter <parameter>option</parameter> kann einer der
     folgenden sein:
     LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT, LDAP_OPT_TIMELIMIT,
     LDAP_OPT_PROTOCOL_VERSION, LDAP_OPT_ERROR_NUMBER,
     LDAP_OPT_REFERRALS,
     LDAP_OPT_RESTART, LDAP_OPT_HOST_NAME, LDAP_OPT_ERROR_STRING,
     LDAP_OPT_MATCHED_DN, LDAP_OPT_SERVER_CONTROLS,
     LDAP_OPT_CLIENT_CONTROLS.
     Hier eine kurze Beschreibung, schauen Sie unter
     <ulink url="&url.ldap.openldap-c-api;">draft-ietf-ldapext-ldap-c-
     api-xx.txt</ulink> nach Details.
    </para>
    <para>
     Die Optionen LDAP_OPT_DEREF, LDAP_OPT_SIZELIMIT,
     LDAP_OPT_TIMELIMIT, LDAP_OPT_PROTOCOL_VERSION und
     LDAP_OPT_ERROR_NUMBER haben einen ganzzahligen Wert,
     LDAP_OPT_REFERRALS und LDAP_OPT_RESTART haben einen boolschen
     Wert und die Optionen LDAP_OPT_HOST_NAME, LDAP_OPT_ERROR_STRING
     und LDAP_OPT_MATCHED_DN bestehen aus einer Zeichenkette.
     Das erste Beispiel veranschaulicht deren Gebrauch. Die Optionen
     LDAP_OPT_SERVER_CONTROLS and LDAP_OPT_CLIENT_CONTROLS bentigen
     eine Kontrolliste, d.h. der Wert muss ein Array aus Kontrollen
     sein. Eine Kontrolle besteht aus einer <emphasis>oid</emphasis>
     die die Kontrolle identifiziert, einem wahlweisen <emphasis>
     wert</emphasis>, und einem wahlweisen Kennzeichen fr <emphasis>
     criticality</emphasis>. Bei PHP wird eine Kontrolle durch ein
     Array angegeben. Dieses Array enthlt ein Element mit dem
     Schlssel <emphasis>oid</emphasis> und einer Zeichenkette als
     Wert und zwei optionalen Elementen. Die optionalen Elemente sind
     Schlssel <emphasis>wert</emphasis> mit einer Zeichenkette als
     Wert und dem Schlssel <emphasis>iscritical</emphasis> mit einem
     boolschen Wert. Der vorgegebene Wert von <emphasis>
     iscritical</emphasis> ist <emphasis>&false;</emphasis> falls Sie
     nichts angeben.
     Schauen Sie sich das zweite Beispiel weiter unten an.
    </para>
    <note>
     <para>
      Diese Funktion steht nur zur Verfgung, wenn Sie OpenLDAP 2.x.x
      ODER Netscape Directory SDK x.x verwenden und wurde in PHP 4.0.4
      hinzugefgt.
      </para>
     </note>
     <para>
     <example>
      <title>Setzen der Protokollversion</title>
      <programlisting role="php">
<![CDATA[
// $ds ist eine gltige Verbindungs-Kennung fr einen Verzeichnis-
// Server
if (ldap_set_option($ds, LDAP_OPT_PROTOCOL_VERSION, 3))
    echo "Verwenden von LDAPv3";
else
    echo "Kann das Protokoll nicht auf Version 3 setzen";
]]>
</programlisting>
     </example>
     <example>
      <title>Setzen der Server Kontrollen</title>
<programlisting role="php">
<![CDATA[
// $ds ist eine gltige Verbingund-Kennung fr einen Verzeichnis-
// Server
// Kontrolle ohne Wert
$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => TRUE);
// iscritical hat den vorgegebenen Wert FALSE
$ctrl2 = array("oid" => "1.2.752.58.1.10", "value" => "magic");
// Versuch, beide Kontrollen zu setzen
if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1,
$ctrl2)))
    echo "Kann die Server Kontrollen nicht setzen";
]]>
</programlisting>
     </example>
     </para>
     <para>
      Siehe auch <function>ldap_get_option</function>.
     </para>
   </refsect1>
  </refentry>


  <refentry id="function.ldap-unbind">
   <refnamediv>
    <refname>ldap_unbind</refname>
    <refpurpose>Unbind von einem LDAP Verzeichnis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_unbind</methodname>
      <methodparam><type>int</type><parameter>Verbindungs-Kennung</parameter></methodparam>
     </methodsynopsis>
    <para>
     &return.success;
    </para>
    <para>
     Die <function>ldap_unbind</function> Funktion fhrt ein unbind
     auf ein LDAP Verzeichnis aus.
    </para>
   </refsect1>
  </refentry>

  <refentry id='function.ldap-8859-to-t61'>
   <refnamediv>
    <refname>ldap_8859_to_t61</refname>
    <refpurpose>
     bersetzt 8859 Zeichen nach t61 Zeichen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>ldap_8859_to_t61</methodname>
      <methodparam><type>string</type><parameter>value</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>



  <refentry id='function.ldap-first-reference'>
   <refnamediv>
    <refname>ldap_first_reference</refname>
    <refpurpose>
     Liefert die erste Referenz
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_first_reference</methodname>
      <methodparam><type>int</type><parameter>link</parameter></methodparam>
      <methodparam><type>int</type><parameter>result</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>



  <refentry id='function.ldap-next-reference'>
   <refnamediv>
    <refname>ldap_next_reference</refname>
    <refpurpose>
     Holt die nchste Referenz
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_next_reference</methodname>
      <methodparam><type>int</type><parameter>link</parameter></methodparam>
      <methodparam><type>int</type><parameter>entry</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>



  <refentry id='function.ldap-parse-reference'>
   <refnamediv>
    <refname>ldap_parse_reference</refname>
    <refpurpose>
     Gewinnt Informationen aus einem Referenz-Eintrag
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>boolean</type><methodname>ldap_parse_reference</methodname>
      <methodparam><type>int</type><parameter>link</parameter></methodparam>
      <methodparam><type>int</type><parameter>entry</parameter></methodparam>
      <methodparam><type>array</type><parameter>referrals</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>



  <refentry id='function.ldap-parse-result'>
   <refnamediv>
    <refname>ldap_parse_result</refname>
    <refpurpose>
     Gewinnt Informationen aus einem Ergebnis
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>boolean</type><methodname>ldap_parse_result</methodname>
      <methodparam><type>int</type><parameter>link</parameter></methodparam>
      <methodparam><type>int</type><parameter>result</parameter></methodparam>
      <methodparam><type>int</type><parameter>errcode</parameter></methodparam>
      <methodparam><type>string</type><parameter>matcheddn</parameter></methodparam>
      <methodparam><type>string</type><parameter>errmsg</parameter></methodparam>
      <methodparam><type>array</type><parameter>referrals</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>



  <refentry id='function.ldap-set-rebind-proc'>
   <refnamediv>
    <refname>ldap_set_rebind_proc</refname>
    <refpurpose>
     Set a callback function to do re-binds on referral chasing.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_set_rebind_proc</methodname>
      <methodparam><type>int</type><parameter>link</parameter></methodparam>
      <methodparam><type>string</type><parameter>callback</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>



  <refentry id='function.ldap-sort'>
   <refnamediv>
    <refname>ldap_sort</refname>
    <refpurpose>
     Sortiert LDAP Ergebniseintrge
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_sort</methodname>
      <methodparam><type>int</type><parameter>link</parameter></methodparam>
      <methodparam><type>int</type><parameter>result</parameter></methodparam>
      <methodparam><type>string</type><parameter>sortfilter</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>



  <refentry id='function.ldap-start-tls'>
   <refnamediv>
    <refname>ldap_start_tls</refname>
    <refpurpose>
     Startet TLS
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ldap_start_tls</methodname>
      <methodparam><type>int</type><parameter>link</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </para>
   </refsect1>
  </refentry>



  <refentry id='function.ldap-t61-to-8859'>
   <refnamediv>
    <refname>ldap_t61_to_8859</refname>
    <refpurpose>
     bersetzt t61 Zeichen nach 8859 Zeichen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>ldap_t61_to_8859</methodname>
      <methodparam><type>string</type><parameter>value</parameter></methodparam>
     </methodsynopsis>
    <para>
     &warn.undocumented.func;
    </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
-->