Updated readme with instructions for legacy OpenLDAP clients

README.md

@@ -15,10 +15,12 @@ Help support the project:
 For Linux\OSX you must ensure you have the latest OpenLDAP client libraries installed from http://www.openldap.org
 
 For Linux you must also ensure that the appropriate [symlinks for `libldap.so.2` and `liblber.so.2`](linux.md) exist.
+If you're using `2.4` or older version of `libldap`, the symlink must point to `libldap_r`, the threaded version of the library,
+otherwise async methods might cause unpredictable errors. Starting with `2.5` `libldap` is multi-threaded by default.
 
 It works with any LDAP protocol compatible directory server (including Microsoft Active Directory).
 
-Supported paswordless authentication (Kerberos) on all platforms (on Linux\OSX supported SASL GSSAPI (Kerberos) authentication!).
+Supported passwordless authentication (Kerberos) on all platforms (on Linux\OSX supported SASL GSSAPI (Kerberos) authentication!).
 
 
 
@@ -39,55 +41,57 @@ using (var cn = new LdapConnection())
 
 ## Overview
 
-* [Supported platforms](#supported-platforms)
-* [Installation](#installation)
-* [API](#api)
-	* [Connect](#connect)
-	* [Connect TLS](#connect-tls)
-	* [Connect SSL (with self signed certificate)](#connect-ssl-with-self-signed-certificate)
-	* [Connect Timeout](#connect-timeout)
-	* [Bind](#bind)
-	* [BindAsync](#bindAsync)
-	* [Bind Anonymous](#bind-anonymous)
-	* [Bind DIGEST-MD5](#bind-digest-md5)
-	* [Bind SASL EXTERNAL (Client certificate)](#bind-sasl-external-client-certificate)
-	* [Bind SASL EXTERNAL (Client certificate & Active Directory)](#bind-sasl-external-client-certificate--active-directory)
-	* [Bind SASL EXTERNAL (Unix Socket)](#bind-sasl-external-unix-socket)
-	* [Bind SASL proxy](#bind-sasl-proxy)
-	* [Search](#search)
-	* [Search (attributes with binary values)](#search-attributes-with-binary-values)
-	* [Search (retrieve concrete list of attributes)](#search-retrieve-concrete-list-of-attributes)
-	* [SearchAsync](#searchAsync)
-	* [SearchByCn](#searchbycn)
-	* [SearchBySid](#searchbysid)
-	* [GetOption](#getoption)
-	* [SetOption](#setoption)
-	* [Add](#add)
-	* [Add Binary Values](#add-binary-values)
-	* [AddAsync](#addAsync)
-	* [Modify](#modify)
-	* [Modify Binary Values](#modify-binary-values)
-	* [Reset password](#reset-password)
-	* [Change password](#change-password)
-	* [ModifyAsync](#modifyAsync)
-	* [Delete](#delete)
-	* [DeleteAsync](#deleteAsync)
-	* [Rename](#rename)
-	* [RenameAsync](#renameAsync)
-	* [SendRequest](#sendRequest)
-	* [SendRequestAsync](#sendRequestAsync)
-	* [Ldap V3 Controls](#ldap-v3-controls)
-		* [PageResultRequestControl\PageResultResponseControl](#pageresultrequestcontrolpageresultresponsecontrol-1284011355614319)
-		* [DirSyncRequestControl\DirSyncRequestControl](#dirsyncrequestcontroldirsyncresponsecontrol-1284011355614841)
-		* [SortRequestControl\SortResponseControl](#sortrequestcontrolsortresponsecontrol-12840113556144731284011355614474)
-		* [AsqRequestControl\AsqResponseControl](#asqrequestcontrolasqresponsecontrol-12840113556141504)
-		* [DirectoryNotificationControl](#directorynotificationcontrol-1284011355614528)
-		* [VlvRequestControl\VlvResponseControl](#vlvrequestcontrolvlvresponsecontrol-216840111373034921684011137303410)
-	* [GetRootDse](#getRootDse)
-	* [WhoAmI](#whoami)
-	* [GetNativeLdapPtr (deprecated)](#getnativeldapptr)
-	* [License](#license)
-	* [Authors](#authors)
+- [ldap4net](#ldap4net)
+	- [Overview](#overview)
+	- [Supported platforms](#supported-platforms)
+	- [Features:](#features)
+	- [Installation](#installation)
+	- [Api](#api)
+		- [Connect](#connect)
+		- [Connect TLS](#connect-tls)
+		- [Connect SSL (with self signed certificate)](#connect-ssl-with-self-signed-certificate)
+		- [Connect Timeout](#connect-timeout)
+		- [Bind](#bind)
+		- [BindAsync](#bindasync)
+		- [Bind Anonymous](#bind-anonymous)
+		- [Bind DIGEST-MD5](#bind-digest-md5)
+		- [Bind SASL EXTERNAL (Client certificate)](#bind-sasl-external-client-certificate)
+		- [Bind SASL EXTERNAL (Client certificate \& Active Directory)](#bind-sasl-external-client-certificate--active-directory)
+		- [Bind SASL EXTERNAL (Unix Socket)](#bind-sasl-external-unix-socket)
+		- [Bind SASL proxy](#bind-sasl-proxy)
+		- [Search](#search)
+		- [Search (attributes with binary values)](#search-attributes-with-binary-values)
+		- [Search (retrieve concrete list of attributes)](#search-retrieve-concrete-list-of-attributes)
+		- [SearchAsync](#searchasync)
+		- [SearchByCn](#searchbycn)
+		- [SearchBySid](#searchbysid)
+		- [GetOption](#getoption)
+		- [SetOption](#setoption)
+		- [Add](#add)
+		- [Add Binary Values](#add-binary-values)
+		- [AddAsync](#addasync)
+		- [Modify](#modify)
+		- [Modify Binary Values](#modify-binary-values)
+		- [Reset password](#reset-password)
+		- [Change password](#change-password)
+		- [ModifyAsync](#modifyasync)
+		- [Delete](#delete)
+		- [DeleteAsync](#deleteasync)
+		- [Rename](#rename)
+		- [RenameAsync](#renameasync)
+		- [SendRequest](#sendrequest)
+		- [SendRequestAsync](#sendrequestasync)
+		- [Ldap V3 Controls](#ldap-v3-controls)
+			- [PageResultRequestControl\\PageResultResponseControl (1.2.840.113556.1.4.319)](#pageresultrequestcontrolpageresultresponsecontrol-1284011355614319)
+			- [DirSyncRequestControl\\DirSyncResponseControl (1.2.840.113556.1.4.841)](#dirsyncrequestcontroldirsyncresponsecontrol-1284011355614841)
+			- [SortRequestControl\\SortResponseControl (1.2.840.113556.1.4.473\\1.2.840.113556.1.4.474)](#sortrequestcontrolsortresponsecontrol-12840113556144731284011355614474)
+			- [AsqRequestControl\\AsqResponseControl (1.2.840.113556.1.4.1504)](#asqrequestcontrolasqresponsecontrol-12840113556141504)
+			- [DirectoryNotificationControl (1.2.840.113556.1.4.528)](#directorynotificationcontrol-1284011355614528)
+			- [VlvRequestControl\\VlvResponseControl (2.16.840.1.113730.3.4.9\\2.16.840.1.113730.3.4.10)](#vlvrequestcontrolvlvresponsecontrol-216840111373034921684011137303410)
+		- [GetRootDse](#getrootdse)
+		- [WhoAmI](#whoami)
+		- [License](#license)
+		- [Authors](#authors)
 
 ## Supported platforms