The ZOO_OPEN_ACL_UNSAFE is completely open free for all ACL: any application can execute any operation on the node and can create, list and delete its children. The ZOO_READ_ACL_UNSAFE is read-only access for any application. CREATE_ALL_ACL grants all permissions to the creator of the node. The creator must have been authenticated by the server (for example, using “digest” scheme) before it can create nodes with this ACL.

The ZOO_OPEN_ACL_UNSAFE is completely open free for all + ACL: any application can execute any operation on the node and + can create, list and delete its children. The + ZOO_READ_ACL_UNSAFE is read-only access for any + application. CREATE_ALL_ACL grants all permissions to the + creator of the node. The creator must have been authenticated by + the server (for example, using “digest” + scheme) before it can create nodes with this ACL.

The application uses the zoo_add_auth function to authenticate itself to the server. The function can be called multiple times if the application wants to authenticate using different schemes and/or identities.

The application uses the zoo_add_auth function to + authenticate itself to the server. The function can be called + multiple times if the application wants to authenticate using + different schemes and/or identities.

zoo_create(...) operation creates a new node. The acl parameter is a list of ACLs associated with the node. The parent node must have the CREATE permission bit set.

zoo_create(...) operation creates a new node. The acl + parameter is a list of ACLs associated with the node. The parent + node must have the CREATE permission bit set.

This function replaces node’s ACL list with a new one. The node must have the ADMIN permission set.

Here is a sample code that makes use of the above APIs to authenticate itself using the “foo” scheme and create an ephemeral node “/xyz” with create-only permissions.

This function replaces node’s ACL list with a new one. The + node must have the ADMIN permission set.

Here is a sample code that makes use of the above APIs to + authenticate itself using the “foo” scheme + and create an ephemeral node “/xyz” with create-only + permissions.

Note

@@ -1283,7 +1294,7 @@

- +

Consistency Guarantees

ZooKeeper is a high performance, scalable service. Both reads and @@ -1409,12 +1420,12 @@

- +

Bindings

The ZooKeeper client libraries come in two languages: Java and C. The following sections describe these.

- +

Java Binding

There are two packages that make up the ZooKeeper Java binding: org.apache.zookeeper and org.apache.zookeeper.data. The rest of the @@ -1481,7 +1492,7 @@ (SESSION_EXPIRED and AUTH_FAILED), the ZooKeeper object becomes invalid, the two threads shut down, and any further ZooKeeper calls throw errors.

- +

C Binding

The C binding has a single-threaded and multi-threaded library. The multi-threaded library is easiest to use and is most similar to the @@ -1498,7 +1509,7 @@ (i.e. FreeBSD 4.x). In all other cases, application developers should link with zookeeper_mt, as it includes support for both Sync and Async API.

- +

Installation

If you're building the client from a check-out from the Apache repository, follow the steps outlined below. If you're building from a @@ -1629,7 +1640,7 @@ - +

Using the C Client

You can test your client by running a ZooKeeper server (see instructions on the project wiki page on how to run it) and connecting @@ -1687,7 +1698,7 @@

- +

Building Blocks: A Guide to ZooKeeper Operations

This section surveys all the operations a developer can perform @@ -1705,25 +1716,25 @@ - +

Connecting to ZooKeeper

- +

Read Operations

- +

Write Operations

- +

Handling Watches

- +

Miscelleaneous ZooKeeper Operations

- +

Program Structure, with Simple Example

@@ -1732,7 +1743,7 @@

- +

Gotchas: Common Problems and Troubleshooting

So now you know ZooKeeper. It's fast, simple, your application Modified: hadoop/zookeeper/trunk/docs/zookeeperProgrammers.pdf URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperProgrammers.pdf?rev=724941&r1=724940&r2=724941&view=diff ============================================================================== Binary files - no diff available. Modified: hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml?rev=724941&r1=724940&r2=724941&view=diff ============================================================================== --- hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml (original) +++ hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml Tue Dec 9 16:42:07 2008 @@ -673,40 +673,71 @@ struct ACL_vector ZOO_CREATOR_ALL_ACL; //(ZOO_PERM_ALL,ZOO_AUTH_IDS) - The ZOO_OPEN_ACL_UNSAFE is completely open free for all ACL: any application can execute any operation on the node and can create, list and delete its children. The ZOO_READ_ACL_UNSAFE is read-only access for any application. CREATE_ALL_ACL grants all permissions to the creator of the node. The creator must have been authenticated by the server (for example, using âdigestâ scheme) before it can create nodes with this ACL. + The ZOO_OPEN_ACL_UNSAFE is completely open free for all + ACL: any application can execute any operation on the node and + can create, list and delete its children. The + ZOO_READ_ACL_UNSAFE is read-only access for any + application. CREATE_ALL_ACL grants all permissions to the + creator of the node. The creator must have been authenticated by + the server (for example, using âdigestâ + scheme) before it can create nodes with this ACL. The following ZooKeeper operations deal with ACLs: - - int zoo_add_auth(zhandle_t *zh,const char* scheme,const char* cert, - int certLen, void_completion_t completion, const void *data); - - - The application uses the zoo_add_auth function to authenticate itself to the server. The function can be called multiple times if the application wants to authenticate using different schemes and/or identities. - - - int zoo_create(zhandle_t *zh, const char *path, const char *value, - int valuelen, const struct ACL_vector *acl, int flags, - char *realpath, int max_realpath_len); - - - zoo_create(...) operation creates a new node. The acl parameter is a list of ACLs associated with the node. The parent node must have the CREATE permission bit set. - - - int zoo_get_acl(zhandle_t *zh, const char *path, - struct ACL_vector *acl, struct Stat *stat); - + + int zoo_add_auth + (zhandle_t *zh,const char* + scheme,const char* + cert, int certLen, void_completion_t + completion, const void + *data); + + + The application uses the zoo_add_auth function to + authenticate itself to the server. The function can be called + multiple times if the application wants to authenticate using + different schemes and/or identities. + + + int zoo_create + (zhandle_t *zh, const char + *path, const char + *value,int + valuelen, const struct + ACL_vector *acl, int + flags,char + *realpath, int + max_realpath_len); + + + zoo_create(...) operation creates a new node. The acl + parameter is a list of ACLs associated with the node. The parent + node must have the CREATE permission bit set. + + + int zoo_get_acl + (zhandle_t *zh, const char + *path,struct ACL_vector + *acl, struct Stat *stat); + This operation returns a nodeâs ACL info. - - int zoo_set_acl(zhandle_t *zh, const char *path, int version, - const struct ACL_vector *acl); - - - This function replaces nodeâs ACL list with a new one. The node must have the ADMIN permission set. - - Here is a sample code that makes use of the above APIs to authenticate itself using the âfooâ scheme and create an ephemeral node â/xyzâ with create-only permissions. + + int zoo_set_acl + (zhandle_t *zh, const char + *path, int + version,const struct + ACL_vector *acl); + + + This function replaces nodeâs ACL list with a new one. The + node must have the ADMIN permission set. + + Here is a sample code that makes use of the above APIs to + authenticate itself using the âfooâ scheme + and create an ephemeral node â/xyzâ with create-only + permissions. This is a very simple example which is intended to show how to interact with ZooKeeper ACLs