svn commit: r1819572 - in /directory/site/trunk/content/api: user-guide.mdtext user-guide/3-advanced-ldap-api-usage.mdtext user-guide/3.1-controls.mdtext

[el...@apache.org]

Author: elecharny
Date: Sat Dec 30 06:42:50 2017
New Revision: 1819572

URL: http://svn.apache.org/viewvc?rev=1819572&view=rev
Log:
Updated the controls page

Modified:
    directory/site/trunk/content/api/user-guide.mdtext
    directory/site/trunk/content/api/user-guide/3-advanced-ldap-api-usage.mdtext
    directory/site/trunk/content/api/user-guide/3.1-controls.mdtext

Modified: directory/site/trunk/content/api/user-guide.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide.mdtext?rev=1819572&r1=1819571&r2=1819572&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide.mdtext (original)
+++ directory/site/trunk/content/api/user-guide.mdtext Sat Dec 30 06:42:50 2017
@@ -63,7 +63,7 @@ We are interested in improving the conte
 
 * [3 - Advanced LDAP API usage (...)](user-guide/3-advanced-ldap-api-usage.html)
 
-    *  [3.1 - Controls (...)](user-guide/3.1-controls.html)
+    *  [3.1 - Controls](user-guide/3.1-controls.html)
     *  [3.2 - Extended operations (e)](user-guide/3.2-extended-operations.html)
     *  [3.3 - Referrals (e)](user-guide/3.3-referrals.html)
     *  [3.4 - Aliases (e)](user-guide/3.4-aliases.html)

Modified: directory/site/trunk/content/api/user-guide/3-advanced-ldap-api-usage.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/3-advanced-ldap-api-usage.mdtext?rev=1819572&r1=1819571&r2=1819572&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide/3-advanced-ldap-api-usage.mdtext (original)
+++ directory/site/trunk/content/api/user-guide/3-advanced-ldap-api-usage.mdtext Sat Dec 30 06:42:50 2017
@@ -26,7 +26,7 @@ Notice: Licensed to the Apache Software
 
 ## Contents
 
-* [Controls (...)](3.1-controls.html)
+* [Controls](3.1-controls.html)
 * [Extended operations (e)](3.2-extended-operations.html)
 * [Referrals (e)](3.3-referrals.html)
 * [Aliases (e)](3.4-aliases.html)

Modified: directory/site/trunk/content/api/user-guide/3.1-controls.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/3.1-controls.mdtext?rev=1819572&r1=1819571&r2=1819572&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide/3.1-controls.mdtext (original)
+++ directory/site/trunk/content/api/user-guide/3.1-controls.mdtext Sat Dec 30 06:42:50 2017
@@ -24,3 +24,16 @@ Notice: Licensed to the Apache Software
 
 # 3.1 - Controls
 
+A LDAP Control is an extension to an operation. It tells the server to do something aside the standard operation, or it let the server send back some information to the client. A Control contains three different parts :
+
+* An identifier, the control OID
+* A flag telling the server what to do if it does not know about the control or if it results in an error (either return an error or ignore the control)
+* A value which is generally BER encoded
+
+There are many controls available, some being standardized, other being server specific.
+
+One or more control can be added to any operation.
+
+Note that either the client or the server might not know about the controls being used, and if the criticality flag is set to FALSE, the server will ignore the control in this case.
+
+Please check [this page](6.7-control.html) for a detailed description on controls usage.
\ No newline at end of file