diff options
author | Keir Fraser <keir.fraser@citrix.com> | 2007-12-14 10:12:15 +0000 |
---|---|---|
committer | Keir Fraser <keir.fraser@citrix.com> | 2007-12-14 10:12:15 +0000 |
commit | 298950dbe88deb0697fdd4f273f1583dc51d20cc (patch) | |
tree | 0663f78a4168d14ab4c3d2657e79dc2b1eee5a55 | |
parent | 1710e13c26896b960ef038e3988f4a05aa3ad7f1 (diff) | |
download | xen-298950dbe88deb0697fdd4f273f1583dc51d20cc.tar.gz xen-298950dbe88deb0697fdd4f273f1583dc51d20cc.tar.bz2 xen-298950dbe88deb0697fdd4f273f1583dc51d20cc.zip |
docs/misc/xenstore.txt minor fixes
Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com>
-rw-r--r-- | docs/misc/xenstore.txt | 20 |
1 files changed, 13 insertions, 7 deletions
diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 3916403317..e0ad8f9b52 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -174,6 +174,17 @@ WATCH <wpath>|<token>|? away, with <path> equal to <wpath>. Watches may be triggered spuriously. The tx_id in a WATCH request is ignored. + Watches are supposed to be restricted by the permissions + system but in practice the implementation is imperfect. + Applications should not rely on being sent a notification for + paths that they cannot read; however, an application may rely + on being sent a watch when a path which it _is_ able to read + is deleted even if that leaves only a nonexistent unreadable + parent. A notification may omitted if a node's permissions + are changed so as to make it unreadable, in which case future + notifications may be suppressed (and if the node is later made + readable, some notifications may have been lost). + WATCH_EVENT <epath>|<token>| Unsolicited `reply' generated for matching modfication events as described above. req_id and tx_id are both 0. @@ -182,7 +193,7 @@ WATCH_EVENT <epath>|<token>| modifed; however if the event was the recursive removal of an parent of <wpath>, <epath> is just <wpath> (rather than the actual path which was removed). So - <epath> is a child of <epath>, regardless. + <epath> is a child of <wpath>, regardless. Iff <wpath> for the watch was specified as a relative pathname, the <epath> path will also be relative (with the same base, @@ -192,7 +203,7 @@ UNWATCH <wpath>|<token>|? ---------- Transactions ---------- -TRANSACTION_START ?? <transid>| +TRANSACTION_START | <transid>| <transid> is an opaque uint32_t allocated by xenstored represented as unsigned decimal. After this, transaction may be referenced by using <transid> (as 32-bit binary) in the @@ -202,11 +213,6 @@ TRANSACTION_START ?? <transid>| Currently xenstored has the bug that after 2^32 transactions it will allocate the transid 0 for an actual transaction. - Clients using the provided xs.c bindings will send a single - nul byte for the argument payload. We recommend that future - clients continue to do the same; any future extension will not - use that syntax. - TRANSACTION_END T| TRANSACTION_END F| tx_id must refer to existing transaction. After this |