1 /*
2  * Private include for xenbus communications.
3  *
4  * Copyright (C) 2005 Rusty Russell, IBM Corporation
5  * Copyright (C) 2005 XenSource Ltd.
6  *
7  * This program is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU General Public License version 2
9  * as published by the Free Software Foundation; or, when distributed
10  * separately from the Linux kernel or incorporated into other
11  * software packages, subject to the following license:
12  *
13  * Permission is hereby granted, free of charge, to any person obtaining a copy
14  * of this source file (the "Software"), to deal in the Software without
15  * restriction, including without limitation the rights to use, copy, modify,
16  * merge, publish, distribute, sublicense, and/or sell copies of the Software,
17  * and to permit persons to whom the Software is furnished to do so, subject to
18  * the following conditions:
19  *
20  * The above copyright notice and this permission notice shall be included in
21  * all copies or substantial portions of the Software.
22  *
23  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
24  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
26  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
28  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
29  * IN THE SOFTWARE.
30  */
31 
32 #ifndef _XENBUS_XENBUS_H
33 #define _XENBUS_XENBUS_H
34 
35 #include <linux/mutex.h>
36 #include <linux/uio.h>
37 #include <xen/xenbus.h>
38 
39 #define XEN_BUS_ID_SIZE			20
40 
41 struct xen_bus_type {
42 	char *root;
43 	unsigned int levels;
44 	int (*get_bus_id)(char bus_id[XEN_BUS_ID_SIZE], const char *nodename);
45 	int (*probe)(struct xen_bus_type *bus, const char *type,
46 		     const char *dir);
47 	void (*otherend_changed)(struct xenbus_watch *watch, const char *path,
48 				 const char *token);
49 	struct bus_type bus;
50 };
51 
52 enum xenstore_init {
53 	XS_UNKNOWN,
54 	XS_PV,
55 	XS_HVM,
56 	XS_LOCAL,
57 };
58 
59 struct xs_watch_event {
60 	struct list_head list;
61 	unsigned int len;
62 	struct xenbus_watch *handle;
63 	const char *path;
64 	const char *token;
65 	char body[];
66 };
67 
68 enum xb_req_state {
69 	xb_req_state_queued,
70 	xb_req_state_wait_reply,
71 	xb_req_state_got_reply,
72 	xb_req_state_aborted
73 };
74 
75 struct xb_req_data {
76 	struct list_head list;
77 	wait_queue_head_t wq;
78 	struct xsd_sockmsg msg;
79 	uint32_t caller_req_id;
80 	enum xsd_sockmsg_type type;
81 	char *body;
82 	const struct kvec *vec;
83 	int num_vecs;
84 	int err;
85 	enum xb_req_state state;
86 	bool user_req;
87 	void (*cb)(struct xb_req_data *);
88 	void *par;
89 };
90 
91 extern enum xenstore_init xen_store_domain_type;
92 extern const struct attribute_group *xenbus_dev_groups[];
93 extern struct mutex xs_response_mutex;
94 extern struct list_head xs_reply_list;
95 extern struct list_head xb_write_list;
96 extern wait_queue_head_t xb_waitq;
97 extern struct mutex xb_write_mutex;
98 
99 int xs_init(void);
100 int xb_init_comms(void);
101 void xb_deinit_comms(void);
102 int xs_watch_msg(struct xs_watch_event *event);
103 void xs_request_exit(struct xb_req_data *req);
104 
105 int xenbus_match(struct device *_dev, struct device_driver *_drv);
106 int xenbus_dev_probe(struct device *_dev);
107 int xenbus_dev_remove(struct device *_dev);
108 int xenbus_register_driver_common(struct xenbus_driver *drv,
109 				  struct xen_bus_type *bus,
110 				  struct module *owner,
111 				  const char *mod_name);
112 int xenbus_probe_node(struct xen_bus_type *bus,
113 		      const char *type,
114 		      const char *nodename);
115 int xenbus_probe_devices(struct xen_bus_type *bus);
116 
117 void xenbus_dev_changed(const char *node, struct xen_bus_type *bus);
118 
119 int xenbus_dev_suspend(struct device *dev);
120 int xenbus_dev_resume(struct device *dev);
121 int xenbus_dev_cancel(struct device *dev);
122 
123 void xenbus_otherend_changed(struct xenbus_watch *watch,
124 			     const char *path, const char *token,
125 			     int ignore_on_shutdown);
126 
127 int xenbus_read_otherend_details(struct xenbus_device *xendev,
128 				 char *id_node, char *path_node);
129 
130 void xenbus_ring_ops_init(void);
131 
132 int xenbus_dev_request_and_reply(struct xsd_sockmsg *msg, void *par);
133 void xenbus_dev_queue_reply(struct xb_req_data *req);
134 
135 extern unsigned int xb_dev_generation_id;
136 
137 #endif
138