You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by bu...@apache.org on 2019/04/29 20:32:41 UTC
svn commit: r1044326 - in /websites/staging/directory/trunk/content: ./
api/developer-guide.html api/download/download-archive-1.html
api/download/download-sources-1.html api/user-guide/2.6-modifying.html
Author: buildbot
Date: Mon Apr 29 20:32:41 2019
New Revision: 1044326
Log:
Staging update by buildbot for directory
Modified:
websites/staging/directory/trunk/content/ (props changed)
websites/staging/directory/trunk/content/api/developer-guide.html
websites/staging/directory/trunk/content/api/download/download-archive-1.html
websites/staging/directory/trunk/content/api/download/download-sources-1.html
websites/staging/directory/trunk/content/api/user-guide/2.6-modifying.html
Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Mon Apr 29 20:32:41 2019
@@ -1 +1 @@
-1857850
+1858400
Modified: websites/staging/directory/trunk/content/api/developer-guide.html
==============================================================================
--- websites/staging/directory/trunk/content/api/developer-guide.html (original)
+++ websites/staging/directory/trunk/content/api/developer-guide.html Mon Apr 29 20:32:41 2019
@@ -357,11 +357,9 @@ PGP Key Password:
<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'
...
</pre></div>
@@ -414,16 +412,7 @@ PGP Key Password:
43
44
45
-46
-47
-48
-49
-50
-51
-52
-53
-54
-55</pre></div></td><td class="code"><div class="codehilite"><pre><span class="c">#!/bin/sh</span>
+46</pre></div></td><td class="code"><div class="codehilite"><pre><span class="c">#!/bin/sh</span>
<span class="nb">echo</span> <span class="s2">"PGP Key ID: "</span>
<span class="nb">read </span>DEFAULT_KEY
@@ -434,7 +423,7 @@ stty -echo
stty <span class="nb">echo</span>
<span class="nb">echo</span> <span class="s2">""</span>
-<span class="k">for </span>FILE in <span class="k">$(</span>find . -maxdepth 1 -not <span class="s1">'('</span> -name <span class="s2">"sign.sh"</span> -or -name <span class="s2">".*"</span> -or -name <span class="s2">"*.md5"</span> -or -name <span class="s2">"*.sha1"</span> -or -name <span class="s2">"*.asc"</span> <span class="s1">')'</span> -and -type f<span class="k">)</span> ; <span class="k">do</span>
+<span class="k">for </span>FILE in <span class="k">$(</span>find . -maxdepth 1 -not <span class="s1">'('</span> -name <span class="s2">"sign.sh"</span> -or -name <span class="s2">".*"</span> -or -name <span class="s2">"*.asc"</span> <span class="s1">')'</span> -and -type f<span class="k">)</span> ; <span class="k">do</span>
<span class="k"> if</span> <span class="o">[</span> -f <span class="s2">"$FILE.asc"</span> <span class="o">]</span>; <span class="k">then</span>
<span class="k"> </span><span class="nb">echo</span> <span class="s2">"Skipping: $FILE"</span>
<span class="k">continue</span>
@@ -442,15 +431,6 @@ stty <span class="nb">echo</span>
<span class="k"> </span><span class="nb">echo</span> -n <span class="s2">"Signing: $FILE ... "</span>
- <span class="c"># SHA1</span>
- <span class="k">if</span> <span class="o">[</span> ! -f <span class="s2">"$FILE.sha1"</span> <span class="o">]</span>;
- <span class="k">then</span>
-<span class="k"> </span>gpg -v --default-key <span class="s2">"$DEFAULT_KEY"</span> --print-md SHA1 <span class="s2">"$FILE"</span> > <span class="s2">"$FILE"</span>.sha1
- <span class="nb">echo</span> <span class="s2">" - Generated '$FILE.sha1'"</span>
- <span class="k">else</span>
-<span class="k"> </span><span class="nb">echo</span> <span class="s2">" - Skipped '$FILE.sha1' (file already existing)"</span>
- <span class="k">fi</span>
-
<span class="c"># SHA-256</span>
<span class="k">if</span> <span class="o">[</span> ! -f <span class="s2">"$FILE.sha256"</span> <span class="o">]</span>;
<span class="k">then</span>
Modified: websites/staging/directory/trunk/content/api/download/download-archive-1.html
==============================================================================
--- websites/staging/directory/trunk/content/api/download/download-archive-1.html (original)
+++ websites/staging/directory/trunk/content/api/download/download-archive-1.html Mon Apr 29 20:32:41 2019
@@ -191,7 +191,7 @@
</a>
</td>
<td align="right">
- [<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.zip.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.zip.sha1">SHA1</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.zip.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.zip.sha512">SHA512</a>]
+ [<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.zip.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.zip.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.zip.sha512">SHA512</a>]
</td>
</tr>
</table>
@@ -218,7 +218,7 @@
</a>
</td>
<td align="right">
- [<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.tar.gz.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.tar.gz.sha1">SHA1</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.tar.gz.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.tar.gz.sha512">SHA512</a>]
+ [<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.tar.gz.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.tar.gz.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-bin.tar.gz.sha512">SHA512</a>]
</td>
</tr>
</table>
Modified: websites/staging/directory/trunk/content/api/download/download-sources-1.html
==============================================================================
--- websites/staging/directory/trunk/content/api/download/download-sources-1.html (original)
+++ websites/staging/directory/trunk/content/api/download/download-sources-1.html Mon Apr 29 20:32:41 2019
@@ -191,7 +191,7 @@
</a>
</td>
<td align="right">
- [<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.zip.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.zip.sha1">SHA1</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.zip.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.zip.sha512">SHA512</a>]
+ [<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.zip.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.zip.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.zip.sha512">SHA512</a>]
</td>
</tr>
</table>
@@ -218,7 +218,7 @@
</a>
</td>
<td align="right">
- [<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.tar.gz.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.tar.gz.sha1">SHA1</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.tar.gz.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.tar.gz.sha512">SHA512</a>]
+ [<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.tar.gz.asc">ASC</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.tar.gz.sha256">SHA256</a>-<a href="https://www.apache.org/dist/directory/api/dist/1.0.3/apache-ldap-api-1.0.3-src.tar.gz.sha512">SHA512</a>]
</td>
</tr>
</table>
Modified: websites/staging/directory/trunk/content/api/user-guide/2.6-modifying.html
==============================================================================
--- websites/staging/directory/trunk/content/api/user-guide/2.6-modifying.html (original)
+++ websites/staging/directory/trunk/content/api/user-guide/2.6-modifying.html Mon Apr 29 20:32:41 2019
@@ -199,11 +199,12 @@ h2:hover > .headerlink, h3:hover > .head
<p>Here the modification instance represents addition of values "John" and "Peter" to the <em>giveName</em> attribute (the <em>givenName</em> attribute can have more than one value).</p>
-<p>There are three different kind of modifications:</p>
+<p>There are four different kind of modifications:</p>
<ul>
<li>ModificationOperation.ADD_ATTRIBUTE: add an attribute and values to an entry</li>
<li>ModificationOperation.REMOVE_ATTRIBUTE: remove an attribute and values from an entry</li>
<li>ModificationOperation.REPLACE_ATTRIBUTE: replace some existing values from an entry</li>
+<li>ModificationOperation.INCREMENT_ATTRIBUTE: increment an Integer value of an attribute</li>
</ul>
<h2 id="adding-or-removing-full-attributes">Adding or removing full attributes<a class="headerlink" href="#adding-or-removing-full-attributes" title="Permanent link">¶</a></h2>
<p>The following two operations completely add or remove attributes.</p>
@@ -477,7 +478,7 @@ h2:hover > .headerlink, h3:hover > .head
<h3 id="replace-values">Replace values<a class="headerlink" href="#replace-values" title="Permanent link">¶</a></h3>
<p>Here, what we want to do is to replaces all the values from an attribute with some new values. All in all, this is equivalent to first remove the values, then inject the new values, using modifications, except that in some cases, doing so will not work.</p>
<p>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.</p>
-<p>What is important here is that the operation simply replace <em>all the existing values</em> with new ones, removing the previous ones.</p>
+<p>What is important here is that the operation simply replace <em>all</em> the existing values* with new ones, removing the previous ones.</p>
<p>Let's see how it works with a simple example, with an entry containing:</p>
<div class="codehilite"><pre><span class="n">dn</span><span class="o">:</span> <span class="n">uid</span><span class="o">=</span><span class="n">jDoe</span><span class="o">,</span><span class="n">dc</span><span class="o">=</span><span class="n">acme</span><span class="o">,</span><span class="n">dc</span><span class="o">=</span><span class="n">com</span>
<span class="n">objectClass</span><span class="o">:</span> <span class="n">person</span>
@@ -511,6 +512,18 @@ h2:hover > .headerlink, h3:hover > .head
<li>always have the right to modify the entry</li>
<li>never try to update a non-existent entry</li>
</ul>
+<h3 id="increment-attribute">Increment attribute<a class="headerlink" href="#increment-attribute" title="Permanent link">¶</a></h3>
+<p>This feature will only work with servers supporting the feature. It can be checked by reading the <em>rootDSE</em> <em>supportedFeatures</em> attribute, which should contain the <strong>1.3.6.1.1.14</strong> value.</p>
+<p>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.</p>
+<p>Four methods are available in the <em>ModifyRequest</em> operation:</p>
+<ul>
+<li>ModifyRequest increment( String attribute ): Increment by 1 the attribute value</li>
+<li>ModifyRequest increment( Striung attribute, int ): Increment by N the attribute value</li>
+<li>ModifyRequest increment( Attribute attribute ): Increment by 1 the attribute value</li>
+<li>ModifyRequest increment( Attribute attribute, int ): Increment by N the attribute value</li>
+</ul>
+<p>As you can see, it's possible to increment the value by more than 1 (which is the default).</p>
+<p>Note that if the increment attribute is muklti-valued, then all the values will be incremented.</p>
<div class="nav">