xref: /qemu/include/hw/xen/xen-bus-helper.h (revision 70ce076fa6dff60585c229a4b641b13e64bf03cf)
1 /*
2  * Copyright (c) 2018  Citrix Systems Inc.
3  *
4  * This work is licensed under the terms of the GNU GPL, version 2 or later.
5  * See the COPYING file in the top-level directory.
6  */
7 
8 #ifndef HW_XEN_BUS_HELPER_H
9 #define HW_XEN_BUS_HELPER_H
10 
11 #include "hw/xen/xen_backend_ops.h"
12 
13 const char *xs_strstate(enum xenbus_state state);
14 
15 void xs_node_create(struct qemu_xs_handle *h,  xs_transaction_t tid,
16                     const char *node, unsigned int owner, unsigned int domid,
17                     unsigned int perms, Error **errp);
18 void xs_node_destroy(struct qemu_xs_handle *h,  xs_transaction_t tid,
19                      const char *node, Error **errp);
20 
21 /* Write to node/key unless node is empty, in which case write to key */
22 void xs_node_vprintf(struct qemu_xs_handle *h,  xs_transaction_t tid,
23                      const char *node, const char *key, Error **errp,
24                      const char *fmt, va_list ap)
25     G_GNUC_PRINTF(6, 0);
26 void xs_node_printf(struct qemu_xs_handle *h,  xs_transaction_t tid,
27                     const char *node, const char *key, Error **errp,
28                     const char *fmt, ...)
29     G_GNUC_PRINTF(6, 7);
30 
31 /* Read from node/key unless node is empty, in which case read from key */
32 int xs_node_vscanf(struct qemu_xs_handle *h,  xs_transaction_t tid,
33                    const char *node, const char *key, Error **errp,
34                    const char *fmt, va_list ap)
35     G_GNUC_SCANF(6, 0);
36 int xs_node_scanf(struct qemu_xs_handle *h,  xs_transaction_t tid,
37                   const char *node, const char *key, Error **errp,
38                   const char *fmt, ...)
39     G_GNUC_SCANF(6, 7);
40 
41 /*
42  * Unlike other functions here, the printf-formatted path_fmt is for
43  * the XenStore path, not the contents of the node.
44  */
45 char *xs_node_read(struct qemu_xs_handle *h, xs_transaction_t tid,
46                    unsigned int *len, Error **errp,
47                    const char *path_fmt, ...)
48     G_GNUC_PRINTF(5, 6);
49 
50 /* Watch node/key unless node is empty, in which case watch key */
51 struct qemu_xs_watch *xs_node_watch(struct qemu_xs_handle *h, const char *node,
52                                     const char *key, xs_watch_fn fn,
53                                     void *opaque, Error **errp);
54 void xs_node_unwatch(struct qemu_xs_handle *h, struct qemu_xs_watch *w);
55 
56 #endif /* HW_XEN_BUS_HELPER_H */
57