Updated readme with instructions for legacy OpenLDAP clients

README.md

@@ -18,7 +18,7 @@ For Linux you must also ensure that the appropriate [symlinks for `libldap.so.2`
 
 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 +39,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
 

linux.md

@@ -8,7 +8,7 @@ They're usually created by default when installing the OpenLDAP client libraries
 root@linux ~ % ls -l /usr/lib/libldap.so.2
 lrwxrwxrwx 1 root root 10 Jul 18  2021 /usr/lib/libldap.so.2 -> libldap.so
 root@linux ~ % ls -l /usr/lib/libldap.so
-lrwxrwxrwx 1 root root 21 Jul 18  2021 /usr/lib/libldap.so -> libldap-2.4.so.2.11.7
+lrwxrwxrwx 1 root root 21 Jul 18  2021 /usr/lib/libldap.so -> libldap_r-2.4.so.2.11.7
 root@linux ~ % ls -l /usr/lib/liblber.so.2
 lrwxrwxrwx 1 root root 10 Jul 18  2021 /usr/lib/liblber.so.2 -> liblber.so
 root@linux ~ % ls -l /usr/lib/liblber.so
@@ -21,3 +21,6 @@ If these symlinks do not exist, you can create direct links to the corresponding
 root@linux ~ % ln -s /usr/lib/libldap-2.X.so.2.Y.Z /usr/lib/libldap.so.2
 root@linux ~ % ln -s /usr/lib/liblber-2.X.so.2.Y.Z /usr/lib/liblber.so.2
 ```
+
+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.