package mirage-xen

A multiplexing xenstore client.

make () initialises and returns a xenstore client.

suspend () suspends the client, waiting for outstanding RPCs to be completed, cancelling all watches and causing new requests to be queued.

resume () resumes the client. The connection must be up and running again before using this function.

A handle represents a single thread's xenstore access.

Access xenstore with individual operations.

Access xenstore with a single transaction. On conflict the operation will be repeated.

Wait for some condition to become true and return a value. The function argument should throw Eagain if the condition is not met, and the condition will be re-evaluated when paths change.

directory h path returns the directory listing of path.

read h path returns the value at path or raises Enoent.

write h k v writes v at k.

rm h k removes the node k.

mkdir h k creates the node k with an empty value.

setperms h k acl sets the permissions of k to acl.

debug cmd_args invokes a debug command.

restrict h domid restricts the current connection to have only the priviledges associated with domain domid.

getdomainpath domid returns the local directory of domain domid.

watch h path token registers a manual watch at path with token.

unwatch h path token unregisters a manual watch at path with token.

introduce h domid store_mfn store_port called by a toolstack to signal the construction of a new domain.

set_target h stubdom_domid domid called by a toolstack to grant stubdom_domid the permissions owned by domid.