You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by el...@apache.org on 2019/04/29 20:32:07 UTC
svn commit: r1858400 - in /directory/site/trunk:
content/api/developer-guide.mdtext
content/api/user-guide/2.6-modifying.mdtext
templates/api/download-archive-1.html templates/api/download-sources-1.html
Author: elecharny
Date: Mon Apr 29 20:32:07 2019
New Revision: 1858400
URL: http://svn.apache.org/viewvc?rev=1858400&view=rev
Log:
Removed any SHA1 reference. Updated the MODIFY doco for 2.0
Modified:
directory/site/trunk/content/api/developer-guide.mdtext
directory/site/trunk/content/api/user-guide/2.6-modifying.mdtext
directory/site/trunk/templates/api/download-archive-1.html
directory/site/trunk/templates/api/download-sources-1.html
Modified: directory/site/trunk/content/api/developer-guide.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/developer-guide.mdtext?rev=1858400&r1=1858399&r2=1858400&view=diff
==============================================================================
--- directory/site/trunk/content/api/developer-guide.mdtext (original)
+++ directory/site/trunk/content/api/developer-guide.mdtext Mon Apr 29 20:32:07 2019
@@ -231,11 +231,9 @@ The produced packages already have .asc
<Your password>
-n Signing: ./apache-ldap-api-1.0.0-M25-bin.tar.gz ...
- Generated './apache-ldap-api-1.0.0-M25-bin.tar.gz.md5'
- - Generated './apache-ldap-api-1.0.0-M25-bin.tar.gz.sha1'
- Generated './apache-ldap-api-1.0.0-M25-bin.tar.gz.asc'
-n Signing: ./apache-ldap-api-1.0.0-M25-bin.zip ...
- Generated './apache-ldap-api-1.0.0-M25-bin.zip.md5'
- - Generated './apache-ldap-api-1.0.0-M25-bin.zip.sha1'
- Generated './apache-ldap-api-1.0.0-M25-bin.zip.asc'
...
@@ -254,7 +252,7 @@ For the record, here is the script shell
stty echo
echo ""
- for FILE in $(find . -maxdepth 1 -not '(' -name "sign.sh" -or -name ".*" -or -name "*.md5" -or -name "*.sha1" -or -name "*.asc" ')' -and -type f) ; do
+ for FILE in $(find . -maxdepth 1 -not '(' -name "sign.sh" -or -name ".*" -or -name "*.asc" ')' -and -type f) ; do
if [ -f "$FILE.asc" ]; then
echo "Skipping: $FILE"
continue
@@ -262,15 +260,6 @@ For the record, here is the script shell
echo -n "Signing: $FILE ... "
- # SHA1
- if [ ! -f "$FILE.sha1" ];
- then
- gpg -v --default-key "$DEFAULT_KEY" --print-md SHA1 "$FILE" > "$FILE".sha1
- echo " - Generated '$FILE.sha1'"
- else
- echo " - Skipped '$FILE.sha1' (file already existing)"
- fi
-
# SHA-256
if [ ! -f "$FILE.sha256" ];
then
Modified: directory/site/trunk/content/api/user-guide/2.6-modifying.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/api/user-guide/2.6-modifying.mdtext?rev=1858400&r1=1858399&r2=1858400&view=diff
==============================================================================
--- directory/site/trunk/content/api/user-guide/2.6-modifying.mdtext (original)
+++ directory/site/trunk/content/api/user-guide/2.6-modifying.mdtext Mon Apr 29 20:32:07 2019
@@ -37,11 +37,12 @@ Each modification to be applied on an en
Here the modification instance represents addition of values "John" and "Peter" to the _giveName_ attribute (the _givenName_ attribute can have more than one value).
-There are three different kind of modifications:
+There are four different kind of modifications:
* ModificationOperation.ADD_ATTRIBUTE: add an attribute and values to an entry
* ModificationOperation.REMOVE_ATTRIBUTE: remove an attribute and values from an entry
* ModificationOperation.REPLACE_ATTRIBUTE: replace some existing values from an entry
+* ModificationOperation.INCREMENT_ATTRIBUTE: increment an Integer value of an attribute
## Adding or removing full attributes
@@ -346,7 +347,7 @@ Here, what we want to do is to replaces
An example where such an operation is mandatory is when replacing the values of a mandatory attribute with something different: with two successive operations, that would fail. A replace will work.
-What is important here is that the operation simply replace *all the existing values* with new ones, removing the previous ones.
+What is important here is that the operation simply replace *all* the existing values* with new ones, removing the previous ones.
Let's see how it works with a simple example, with an entry containing:
@@ -381,3 +382,21 @@ You will get the same errors seen in the
* never delete all the values of a mandatory attribute
* always have the right to modify the entry
* never try to update a non-existent entry
+
+### Increment attribute
+
+This feature will only work with servers supporting the feature. It can be checked by reading the _rootDSE_ _supportedFeatures_ attribute, which should contain the **1.3.6.1.1.14** value.
+
+The idea is to make it possible to increment an integer attribute in one single operation, instead of reading the entry first, and modify the value in a second operation. That makes the increment operation atomic, and faster as only one operation will be necessary.
+
+Four methods are available in the _ModifyRequest_ operation:
+
+* ModifyRequest increment( String attribute ): Increment by 1 the attribute value
+* ModifyRequest increment( Striung attribute, int ): Increment by N the attribute value
+* ModifyRequest increment( Attribute attribute ): Increment by 1 the attribute value
+* ModifyRequest increment( Attribute attribute, int ): Increment by N the attribute value
+
+As you can see, it's possible to increment the value by more than 1 (which is the default).
+
+Note that if the increment attribute is muklti-valued, then all the values will be incremented.
+
Modified: directory/site/trunk/templates/api/download-archive-1.html
URL: http://svn.apache.org/viewvc/directory/site/trunk/templates/api/download-archive-1.html?rev=1858400&r1=1858399&r2=1858400&view=diff
==============================================================================
--- directory/site/trunk/templates/api/download-archive-1.html (original)
+++ directory/site/trunk/templates/api/download-archive-1.html Mon Apr 29 20:32:07 2019
@@ -31,7 +31,7 @@
</a>
</td>
<td align="right">
- [<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.zip.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.zip.sha1">SHA1</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.zip.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.zip.sha512">SHA512</a>]
+ [<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.zip.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.zip.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.zip.sha512">SHA512</a>]
</td>
</tr>
</table>
@@ -58,7 +58,7 @@
</a>
</td>
<td align="right">
- [<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.tar.gz.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.tar.gz.sha1">SHA1</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.tar.gz.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.tar.gz.sha512">SHA512</a>]
+ [<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.tar.gz.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.tar.gz.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-bin.tar.gz.sha512">SHA512</a>]
</td>
</tr>
</table>
Modified: directory/site/trunk/templates/api/download-sources-1.html
URL: http://svn.apache.org/viewvc/directory/site/trunk/templates/api/download-sources-1.html?rev=1858400&r1=1858399&r2=1858400&view=diff
==============================================================================
--- directory/site/trunk/templates/api/download-sources-1.html (original)
+++ directory/site/trunk/templates/api/download-sources-1.html Mon Apr 29 20:32:07 2019
@@ -31,7 +31,7 @@
</a>
</td>
<td align="right">
- [<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.zip.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.zip.sha1">SHA1</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.zip.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.zip.sha512">SHA512</a>]
+ [<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.zip.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.zip.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.zip.sha512">SHA512</a>]
</td>
</tr>
</table>
@@ -58,7 +58,7 @@
</a>
</td>
<td align="right">
- [<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.tar.gz.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.tar.gz.sha1">SHA1</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.tar.gz.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.tar.gz.sha512">SHA512</a>]
+ [<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.tar.gz.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.tar.gz.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/{{version_api}}/apache-ldap-api-{{version_api}}-src.tar.gz.sha512">SHA512</a>]
</td>
</tr>
</table>