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 void (*cb)(struct xb_req_data *); 87 void *par; 88 }; 89 90 extern enum xenstore_init xen_store_domain_type; 91 extern const struct attribute_group *xenbus_dev_groups[]; 92 extern struct mutex xs_response_mutex; 93 extern struct list_head xs_reply_list; 94 extern struct list_head xb_write_list; 95 extern wait_queue_head_t xb_waitq; 96 extern struct mutex xb_write_mutex; 97 98 int xs_init(void); 99 int xb_init_comms(void); 100 void xb_deinit_comms(void); 101 int xs_watch_msg(struct xs_watch_event *event); 102 void xs_request_exit(struct xb_req_data *req); 103 104 int xenbus_match(struct device *_dev, struct device_driver *_drv); 105 int xenbus_dev_probe(struct device *_dev); 106 int xenbus_dev_remove(struct device *_dev); 107 int xenbus_register_driver_common(struct xenbus_driver *drv, 108 struct xen_bus_type *bus, 109 struct module *owner, 110 const char *mod_name); 111 int xenbus_probe_node(struct xen_bus_type *bus, 112 const char *type, 113 const char *nodename); 114 int xenbus_probe_devices(struct xen_bus_type *bus); 115 116 void xenbus_dev_changed(const char *node, struct xen_bus_type *bus); 117 118 void xenbus_dev_shutdown(struct device *_dev); 119 120 int xenbus_dev_suspend(struct device *dev); 121 int xenbus_dev_resume(struct device *dev); 122 int xenbus_dev_cancel(struct device *dev); 123 124 void xenbus_otherend_changed(struct xenbus_watch *watch, 125 const char *path, const char *token, 126 int ignore_on_shutdown); 127 128 int xenbus_read_otherend_details(struct xenbus_device *xendev, 129 char *id_node, char *path_node); 130 131 void xenbus_ring_ops_init(void); 132 133 int xenbus_dev_request_and_reply(struct xsd_sockmsg *msg, void *par); 134 void xenbus_dev_queue_reply(struct xb_req_data *req); 135 136 #endif 137