drivers/xen/xenbus/xenbus.h

   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