zookeeper-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From h...@apache.org
Subject zookeeper git commit: ZOOKEEPER-2635: regenerate document for master / 3.6 branch.
Date Tue, 21 Mar 2017 19:09:58 GMT
Repository: zookeeper
Updated Branches:
  refs/heads/master 63577ba52 -> 9a6aff269


ZOOKEEPER-2635: regenerate document for master / 3.6 branch.

Author: Michael Han <hanm@apache.org>

Reviewers: Michael Han <hanm@apache.org>

Closes #203 from hanm/ZOOKEEPER-2635-master


Project: http://git-wip-us.apache.org/repos/asf/zookeeper/repo
Commit: http://git-wip-us.apache.org/repos/asf/zookeeper/commit/9a6aff26
Tree: http://git-wip-us.apache.org/repos/asf/zookeeper/tree/9a6aff26
Diff: http://git-wip-us.apache.org/repos/asf/zookeeper/diff/9a6aff26

Branch: refs/heads/master
Commit: 9a6aff269e5c1ac25e1aca1877b06f725799bfee
Parents: 63577ba
Author: Michael Han <hanm@apache.org>
Authored: Tue Mar 21 12:09:55 2017 -0700
Committer: Michael Han <hanm@apache.org>
Committed: Tue Mar 21 12:09:55 2017 -0700

----------------------------------------------------------------------
 docs/index.html                        |   2 +-
 docs/index.pdf                         | Bin 12643 -> 12657 bytes
 docs/javaExample.html                  |   2 +-
 docs/javaExample.pdf                   | Bin 33876 -> 33818 bytes
 docs/linkmap.html                      |   2 +-
 docs/linkmap.pdf                       | Bin 10808 -> 10826 bytes
 docs/recipes.html                      |   2 +-
 docs/recipes.pdf                       | Bin 33882 -> 33856 bytes
 docs/zookeeperAdmin.html               | 140 ++++++++++++++++++++++------
 docs/zookeeperAdmin.pdf                | Bin 93578 -> 97099 bytes
 docs/zookeeperHierarchicalQuorums.html |   2 +-
 docs/zookeeperHierarchicalQuorums.pdf  | Bin 6635 -> 6654 bytes
 docs/zookeeperInternals.html           |   2 +-
 docs/zookeeperInternals.pdf            | Bin 48848 -> 48811 bytes
 docs/zookeeperJMX.html                 |   2 +-
 docs/zookeeperJMX.pdf                  | Bin 16473 -> 16475 bytes
 docs/zookeeperObservers.html           |   2 +-
 docs/zookeeperObservers.pdf            | Bin 12860 -> 12868 bytes
 docs/zookeeperOver.html                |   2 +-
 docs/zookeeperOver.pdf                 | Bin 302506 -> 302467 bytes
 docs/zookeeperProgrammers.html         |  30 ++++--
 docs/zookeeperProgrammers.pdf          | Bin 143721 -> 144412 bytes
 docs/zookeeperQuotas.html              |   2 +-
 docs/zookeeperQuotas.pdf               | Bin 11170 -> 11184 bytes
 docs/zookeeperReconfig.html            |   2 +-
 docs/zookeeperReconfig.pdf             | Bin 62104 -> 62032 bytes
 docs/zookeeperStarted.html             |   2 +-
 docs/zookeeperStarted.pdf              | Bin 28099 -> 28078 bytes
 docs/zookeeperTutorial.html            |   2 +-
 docs/zookeeperTutorial.pdf             | Bin 30533 -> 30478 bytes
 30 files changed, 147 insertions(+), 49 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/index.html
----------------------------------------------------------------------
diff --git a/docs/index.html b/docs/index.html
index a203986..5fac4e9 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -341,7 +341,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <div id="logos"></div>
 <!--+

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/index.pdf
----------------------------------------------------------------------
diff --git a/docs/index.pdf b/docs/index.pdf
index 4349c24..cd2ab49 100644
Binary files a/docs/index.pdf and b/docs/index.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/javaExample.html
----------------------------------------------------------------------
diff --git a/docs/javaExample.html b/docs/javaExample.html
index e9284c2..d78ee2c 100644
--- a/docs/javaExample.html
+++ b/docs/javaExample.html
@@ -890,7 +890,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/javaExample.pdf
----------------------------------------------------------------------
diff --git a/docs/javaExample.pdf b/docs/javaExample.pdf
index bbc64ec..b025ac4 100644
Binary files a/docs/javaExample.pdf and b/docs/javaExample.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/linkmap.html
----------------------------------------------------------------------
diff --git a/docs/linkmap.html b/docs/linkmap.html
index d62b4be..6208fc7 100644
--- a/docs/linkmap.html
+++ b/docs/linkmap.html
@@ -384,7 +384,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/linkmap.pdf
----------------------------------------------------------------------
diff --git a/docs/linkmap.pdf b/docs/linkmap.pdf
index 38a70e4..cf94bfe 100644
Binary files a/docs/linkmap.pdf and b/docs/linkmap.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/recipes.html
----------------------------------------------------------------------
diff --git a/docs/recipes.html b/docs/recipes.html
index f270806..df494e7 100644
--- a/docs/recipes.html
+++ b/docs/recipes.html
@@ -1014,7 +1014,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/recipes.pdf
----------------------------------------------------------------------
diff --git a/docs/recipes.pdf b/docs/recipes.pdf
index 1d19f58..d11586b 100644
Binary files a/docs/recipes.pdf and b/docs/recipes.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperAdmin.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperAdmin.html b/docs/zookeeperAdmin.html
index 4034c1d..9647b03 100644
--- a/docs/zookeeperAdmin.html
+++ b/docs/zookeeperAdmin.html
@@ -288,6 +288,9 @@ document.write("Last Published: " + document.lastModified);
 <a href="#Disabling+data+directory+autocreation">Disabling data directory autocreation</a>
 </li>
 <li>
+<a href="#sc_db_existence_validation">Enabling db existence validation</a>
+</li>
+<li>
 <a href="#sc_performance_options">Performance Tuning Options</a>
 </li>
 <li>
@@ -302,7 +305,7 @@ document.write("Last Published: " + document.lastModified);
 <a href="#sc_zkCommands">ZooKeeper Commands</a>
 <ul class="minitoc">
 <li>
-<a href="#The+Four+Letter+Words">The Four Letter Words</a>
+<a href="#sc_4lw">The Four Letter Words</a>
 </li>
 <li>
 <a href="#sc_adminserver">The AdminServer</a>
@@ -639,6 +642,19 @@ server.3=zoo3:2888:3888</pre>
         
 <li>
           
+<p>Create an initialization marker file <span class="codefrag filename">initialize</span>
+            in the same directory as <span class="codefrag filename">myid</span>.
This file indicates
+            that an empty data directory is expected. When present, an empty data base
+            is created and the marker file deleted. When not present, an empty data
+            directory will mean this peer will not have voting rights and it will not
+            populate the data directory until it communicates with an active leader.
+            Intended use is to only create this file when bringing up a new
+            ensemble. </p>
+        
+</li>
+        
+<li>
+          
 <p>If your configuration file is set up, you can start a
           ZooKeeper server:</p>
 
@@ -940,14 +956,10 @@ server.3=zoo3:2888:3888</pre>
           of the znodes stored by a particular serving ensemble. These
           are the snapshot and transactional log files. As changes are
           made to the znodes these changes are appended to a
-          transaction log. Occasionally, when a log grows large, a
+          transaction log, occasionally, when a log grows large, a
           snapshot of the current state of all znodes will be written
-          to the filesystem and a new transaction log file is created
-          for future transactions. During snapshotting, ZooKeeper may
-          continue appending incoming transactions to the old log file.
-          Therefore, some transactions which are newer than a snapshot
-          may be found in the last transaction log preceding the
-          snapshot.
+          to the filesystem. This snapshot supercedes all previous
+          logs.
         </p>
 <p>A ZooKeeper server <strong>will not remove
         old snapshots and log files</strong> when using the default
@@ -1205,10 +1217,8 @@ server.3=zoo3:2888:3888</pre>
 <p>(Java system property: <strong>zookeeper.snapCount</strong>)</p>
 <p>ZooKeeper logs transactions to a transaction
               log. After snapCount transactions are written to a log
-              file a snapshot is started. It also influences rollover
-              of the current transaction log to a new file. However,
-              the creation of a new snapshot and rollover of transaction
-              log proceed independently. The default snapCount is
+              file a snapshot is started and a new transaction log
+              file is created. The default snapCount is
               100,000.</p>
 </dd>
 
@@ -1531,6 +1541,36 @@ server.3=zoo3:2888:3888</pre>
               </p>
 </dd>
 
+          
+<dt>
+<term>4lw.commands.whitelist</term>
+</dt>
+<dd>
+<p>(Java system property: <strong>zookeeper.4lw.commands.whitelist</strong>)</p>
+<p>
+<strong>New in 3.5.3:</strong>
+                A list of comma separated <a href="#sc_4lw">Four Letter Words</a>
+                commands that user wants to use. A valid Four Letter Words
+                command must be put in this list else ZooKeeper server will
+                not enable the command.
+                By default the whitelist only contains "srvr" command
+                which zkServer.sh uses. The rest of four letter word commands are disabled
+                by default.
+              </p>
+<p>Here's an example of the configuration that enables stat, ruok, conf, and isro
+              command while disabling the rest of Four Letter Words command:</p>
+<pre class="code">
+                4lw.commands.whitelist=stat, ruok, conf, isro
+              </pre>
+<p>If you really need enable all four letter word commands by default, you can use
+                the asterisk option so you don't have to include every command one by one
in the list.
+                As an example, this will enable all four letter word commands:
+              </p>
+<pre class="code">
+                4lw.commands.whitelist=*
+              </pre>
+</dd>
+
         
 </dl>
 <p></p>
@@ -1760,6 +1800,32 @@ server.3=zoo3:2888:3888</pre>
         it does not create a config file, but rather requires a config
         file to be available in order to execute.
         </p>
+<a name="sc_db_existence_validation"></a>
+<h4>Enabling db existence validation</h4>
+<p>
+<strong>New in 3.6.0:</strong> The default
+          behavior of a ZooKeeper server on startup when no data tree
+          is found is to set zxid to zero and join the quorum as a
+          voting member. This can be dangerous if some event (e.g. a
+          rogue 'rm -rf') has removed the data directory while the
+          server was down since this server may help elect a leader
+          that is missing transactions. Enabling db existence validation
+          will change the behavior on startup when no data tree is
+          found: the server joins the ensemble as a non-voting participant
+          until it is able to sync with the leader and acquire an up-to-date
+          version of the ensemble data. To indicate an empty data tree is
+          expected (ensemble creation), the user should place a file
+          'initialize' in the same directory as 'myid'. This file will
+          be detected and deleted by the server on startup.
+        </p>
+<p> Initialization validation can be enabled when running
+          ZooKeeper servers directly from class files by setting
+          <strong>zookeeper.db.autocreate=false</strong>
+          on the java command line, i.e.
+          <strong>-Dzookeeper.db.autocreate=false</strong>.
+          Running <strong>zkServer-initialize.sh</strong>
+          will create the required initialization file.
+        </p>
 <a name="sc_performance_options"></a>
 <h4>Performance Tuning Options</h4>
 <p>
@@ -1933,7 +1999,7 @@ server.3=zoo3:2888:3888</pre>
 </dl>
 <a name="sc_zkCommands"></a>
 <h3 class="h4">ZooKeeper Commands</h3>
-<a name="The+Four+Letter+Words"></a>
+<a name="sc_4lw"></a>
 <h4>The Four Letter Words</h4>
 <p>ZooKeeper responds to a small set of commands. Each command is
         composed of four letters. You issue the commands to ZooKeeper via telnet
@@ -1942,6 +2008,15 @@ server.3=zoo3:2888:3888</pre>
         general information about the server and connected clients,
         while "srvr" and "cons" give extended details on server and
         connections respectively.</p>
+<p>
+<strong>New in 3.5.3:</strong>
+          Four Letter Words need to be explicitly white listed before using.
+          Please refer <strong>4lw.commands.whitelist</strong>
+           described in <a href="#sc_clusterOptions">
+            cluster configuration section</a> for details.
+          Moving forward, Four Letter Words will be deprecated, please use
+          <a href="#sc_adminserver">AdminServer</a> instead.
+        </p>
 <dl>
           
 <dt>
@@ -2301,7 +2376,7 @@ server.3=zoo3:2888:3888</pre>
       on a dedicated log devices.</p>
 <a name="The+Data+Directory"></a>
 <h4>The Data Directory</h4>
-<p>This directory has two files in it:</p>
+<p>This directory has two or three files in it:</p>
 <ul>
           
 <li>
@@ -2316,6 +2391,15 @@ server.3=zoo3:2888:3888</pre>
 <li>
             
 <p>
+<span class="codefrag filename">initialize</span> - presence indicates lack of
+              data tree is expected. Cleaned up once data tree is created.</p>
+          
+</li>
+
+          
+<li>
+            
+<p>
 <span class="codefrag filename">snapshot.&lt;zxid&gt;</span> - holds
the fuzzy
             snapshot of a data tree.</p>
           
@@ -2350,11 +2434,8 @@ server.3=zoo3:2888:3888</pre>
 <p>The Log Directory contains the ZooKeeper transaction logs.
         Before any update takes place, ZooKeeper ensures that the transaction
         that represents the update is written to non-volatile storage. A new
-        log file is started when the number of transactions written to the
-		current log file reaches a (variable) threshold. The threshold is
-		computed using the same parameter which influences the frequency of
-		snapshotting (see snapCount above). The log file's suffix is the first
-		zxid written to that log.</p>
+        log file is started each time a snapshot is begun. The log file's
+        suffix is the first zxid written to that log.</p>
 <a name="sc_filemanagement"></a>
 <h4>File Management</h4>
 <p>The format of snapshot and log files does not change between
@@ -2369,12 +2450,8 @@ server.3=zoo3:2888:3888</pre>
 <p>The ZooKeeper server creates snapshot and log files, but
         never deletes them. The retention policy of the data and log
         files is implemented outside of the ZooKeeper server. The
-        server itself only needs the latest complete fuzzy snapshot, all log
-		files following it, and the last log file preceding it.  The latter
-		requirement is necessary to include updates which happened after this
-		snapshot was started but went into the existing log file at that time.
-		This is possible because snapshotting and rolling over of logs
-		proceed somewhat independently in Zookeeper. See the
+        server itself only needs the latest complete fuzzy snapshot
+        and the log files from the start of that snapshot. See the
         <a href="#sc_maintenance">maintenance</a> section in
         this document for more details on setting a retention policy
         and maintenance of ZooKeeper storage.
@@ -2443,6 +2520,17 @@ server.3=zoo3:2888:3888</pre>
             is to run load tests, and then make sure you are well below the
             usage limit that would cause the system to swap.</p>
 </dd>
+
+        
+<dt>
+<term>Publicly accessible deployment</term>
+</dt>
+<dd>
+<p>
+              A ZooKeeper ensemble is expected to operate in a trusted computing environment.
+              It is thus recommended to deploy ZooKeeper behind a firewall.
+            </p>
+</dd>
       
 </dl>
 <a name="sc_bestPractices"></a>
@@ -2475,7 +2563,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperAdmin.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperAdmin.pdf b/docs/zookeeperAdmin.pdf
index 3f8f2d9..7de61f4 100644
Binary files a/docs/zookeeperAdmin.pdf and b/docs/zookeeperAdmin.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperHierarchicalQuorums.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperHierarchicalQuorums.html b/docs/zookeeperHierarchicalQuorums.html
index 72f6c06..0b5dd70 100644
--- a/docs/zookeeperHierarchicalQuorums.html
+++ b/docs/zookeeperHierarchicalQuorums.html
@@ -254,7 +254,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperHierarchicalQuorums.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperHierarchicalQuorums.pdf b/docs/zookeeperHierarchicalQuorums.pdf
index d27aa22..44d35de 100644
Binary files a/docs/zookeeperHierarchicalQuorums.pdf and b/docs/zookeeperHierarchicalQuorums.pdf
differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperInternals.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperInternals.html b/docs/zookeeperInternals.html
index de5c821..9920800 100644
--- a/docs/zookeeperInternals.html
+++ b/docs/zookeeperInternals.html
@@ -783,7 +783,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperInternals.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperInternals.pdf b/docs/zookeeperInternals.pdf
index 445d8ef..1276ae4 100644
Binary files a/docs/zookeeperInternals.pdf and b/docs/zookeeperInternals.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperJMX.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperJMX.html b/docs/zookeeperJMX.html
index 4a627f1..258010d 100644
--- a/docs/zookeeperJMX.html
+++ b/docs/zookeeperJMX.html
@@ -457,7 +457,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperJMX.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperJMX.pdf b/docs/zookeeperJMX.pdf
index 5cfe345..31fea2b 100644
Binary files a/docs/zookeeperJMX.pdf and b/docs/zookeeperJMX.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperObservers.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperObservers.html b/docs/zookeeperObservers.html
index 4f83ebb..1dd77fc 100644
--- a/docs/zookeeperObservers.html
+++ b/docs/zookeeperObservers.html
@@ -344,7 +344,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperObservers.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperObservers.pdf b/docs/zookeeperObservers.pdf
index f1f83dc..19abf32 100644
Binary files a/docs/zookeeperObservers.pdf and b/docs/zookeeperObservers.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperOver.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperOver.html b/docs/zookeeperOver.html
index 7a68713..043858b 100644
--- a/docs/zookeeperOver.html
+++ b/docs/zookeeperOver.html
@@ -682,7 +682,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperOver.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperOver.pdf b/docs/zookeeperOver.pdf
index 7075e79..0f4c696 100644
Binary files a/docs/zookeeperOver.pdf and b/docs/zookeeperOver.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperProgrammers.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperProgrammers.html b/docs/zookeeperProgrammers.html
index a0ddd1c..cb8e7f7 100644
--- a/docs/zookeeperProgrammers.html
+++ b/docs/zookeeperProgrammers.html
@@ -1307,11 +1307,14 @@ document.write("Last Published: " + document.lastModified);
     be able to read <em>/app/status</em>; ACLs are not
     recursive.</p>
 <p>ZooKeeper supports pluggable authentication schemes. Ids are
-    specified using the form <em>scheme:id</em>,
-    where <em>scheme</em> is a the authentication scheme
-    that the id corresponds to. For
-    example, <em>ip:172.16.16.1</em> is an id for a
-    host with the address <em>172.16.16.1</em>.</p>
+    specified using the form <em>scheme:expression</em>,
+    where <em>scheme</em> is the authentication scheme
+    that the id corresponds to. The set of valid expressions are defined
+    by the scheme. For example, <em>ip:172.16.16.1</em> is
+    an id for a host with the address <em>172.16.16.1</em>
+    using the <em>ip</em> scheme, whereas <em>digest:bob:password</em>
+    is an id for the user with the name of <em>bob</em> using
+    the <em>digest</em> scheme.</p>
 <p>When a client connects to ZooKeeper and authenticates
     itself, ZooKeeper associates all the ids that correspond to a
     client with the clients connection. These ids are checked against
@@ -1393,9 +1396,16 @@ document.write("Last Published: " + document.lastModified);
         
 <li>
 <p>
-<strong>auth</strong> doesn't
-        use any id, represents any authenticated
-        user.</p>
+<strong>auth</strong> is a special
+        scheme which ignores any provided expression and instead uses the current user,
+        credentials, and scheme. Any expression (whether <em>user</em> like with
SASL
+        authentication or <em>user:password</em> like with DIGEST authentication)
provided is ignored
+        by the ZooKeeper server when persisting the ACL. However, the expression must still
be
+        provided in the ACL because the ACL must match the form <em>scheme:expression:perms</em>.
+        This scheme is provided as a convenience as it is a common use-case for
+        a user to create a znode and then restrict access to that znode to only that user.
+        If there is no authenticated user, setting an ACL with the auth scheme will fail.
+        </p>
 </li>
 
         
@@ -2386,7 +2396,7 @@ public abstract class ServerAuthenticationProvider implements AuthenticationProv
 <p>If you are using watches, you must look for the connected watch
         event. When a ZooKeeper client disconnects from a server, you will
         not receive notification of changes until reconnected. If you are
-        watching for a znode to come into existance, you will miss the event
+        watching for a znode to come into existence, you will miss the event
         if the znode is created and deleted while you are disconnected.</p>
       
 </li>
@@ -2569,7 +2579,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperProgrammers.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperProgrammers.pdf b/docs/zookeeperProgrammers.pdf
index 0899f86..a5d72c0 100644
Binary files a/docs/zookeeperProgrammers.pdf and b/docs/zookeeperProgrammers.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperQuotas.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperQuotas.html b/docs/zookeeperQuotas.html
index ca5c02d..72e4652 100644
--- a/docs/zookeeperQuotas.html
+++ b/docs/zookeeperQuotas.html
@@ -268,7 +268,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperQuotas.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperQuotas.pdf b/docs/zookeeperQuotas.pdf
index a1d48f6..6db6351 100644
Binary files a/docs/zookeeperQuotas.pdf and b/docs/zookeeperQuotas.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperReconfig.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperReconfig.html b/docs/zookeeperReconfig.html
index 32fd0cb..e03f2fa 100644
--- a/docs/zookeeperReconfig.html
+++ b/docs/zookeeperReconfig.html
@@ -1232,7 +1232,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperReconfig.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperReconfig.pdf b/docs/zookeeperReconfig.pdf
index 50a50e2..12cd2f3 100644
Binary files a/docs/zookeeperReconfig.pdf and b/docs/zookeeperReconfig.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperStarted.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperStarted.html b/docs/zookeeperStarted.html
index 63c2b1a..89d9129 100644
--- a/docs/zookeeperStarted.html
+++ b/docs/zookeeperStarted.html
@@ -608,7 +608,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperStarted.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperStarted.pdf b/docs/zookeeperStarted.pdf
index 0e2f63f..4675060 100644
Binary files a/docs/zookeeperStarted.pdf and b/docs/zookeeperStarted.pdf differ

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperTutorial.html
----------------------------------------------------------------------
diff --git a/docs/zookeeperTutorial.html b/docs/zookeeperTutorial.html
index 5c19de3..3f3def1 100644
--- a/docs/zookeeperTutorial.html
+++ b/docs/zookeeperTutorial.html
@@ -872,7 +872,7 @@ document.write("Last Published: " + document.lastModified);
 </div>
 <div class="copyright">
         Copyright &copy;
-         2008-2013 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+          <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
 </div>
 <!--+
     |end bottomstrip

http://git-wip-us.apache.org/repos/asf/zookeeper/blob/9a6aff26/docs/zookeeperTutorial.pdf
----------------------------------------------------------------------
diff --git a/docs/zookeeperTutorial.pdf b/docs/zookeeperTutorial.pdf
index 3cdd8b1..97ad79b 100644
Binary files a/docs/zookeeperTutorial.pdf and b/docs/zookeeperTutorial.pdf differ


Mime
View raw message