From d9697d607fb553a18ea6baa08eadb9dc1d8247fa Mon Sep 17 00:00:00 2001
From: Stig Venaas <venaas@php.net>
Date: Sun, 3 Jun 2001 15:00:29 +0000
Subject: [PATCH] Added documentation on parallel search feature to the search
 functions docs

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@49131 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/ldap.xml | 25 ++++++++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/functions/ldap.xml b/functions/ldap.xml
index 29d532df8f..97fad17a66 100644
--- a/functions/ldap.xml
+++ b/functions/ldap.xml
@@ -1138,6 +1138,10 @@ for ($i=0; $i&lt;$info["count"]; $i++)
     echo $info[$i]["ou"][0] ;
 </programlisting>
 </example></para>
+    <para>
+     From 4.0.5 on it's also possible to do parallel searches. See
+     <function>ldap_search</function> for details.
+    </para>
   </refsect1>
   </refentry>
 
@@ -1362,6 +1366,10 @@ for ($i=0; $i&lt;$info["count"]; $i++)
       <parameter>deref</parameter>.
      </para>
     </note>
+    <para>
+     From 4.0.5 on it's also possible to do parallel searches. See
+     <function>ldap_search</function> for details.
+    </para>
    </refsect1>
   </refentry>
 
@@ -1541,7 +1549,22 @@ $info = ldap_get_entries($ds, $sr);
 print $info["count"]." entries returned&lt;p>";
 </programlisting>
       </example></para>
-
+    <para>
+     From 4.0.5 on it's also possible to do parallel searches. To do this
+     you use an array of link identifiers, rather than a single identifier,
+     as the first argument. If you don't want the same base DN and the
+     same filter for all the searches, you can also use an array of base DNs
+     and/or an array of filters. Those arrays must be of the same size as
+     the link identifier array since the first entries of the arrays are
+     used for one search, the second entries are used for another, and so
+     on. When doing parallel searches an array of search result
+     identifiers is returned, except in case of error, then the entry
+     corresponding to the search will be false. This is very much like
+     the value normally returned, except that a result identifier is always
+     returned when a search was made. There are some rare cases where the
+     normal search returns false while the parallel search returns an
+     identifier.
+    </para>
    </refsect1>
   </refentry>