hv_snapshot.c 9.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369
  1. /*
  2. * An implementation of host initiated guest snapshot.
  3. *
  4. *
  5. * Copyright (C) 2013, Microsoft, Inc.
  6. * Author : K. Y. Srinivasan <kys@microsoft.com>
  7. *
  8. * This program is free software; you can redistribute it and/or modify it
  9. * under the terms of the GNU General Public License version 2 as published
  10. * by the Free Software Foundation.
  11. *
  12. * This program is distributed in the hope that it will be useful, but
  13. * WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
  15. * NON INFRINGEMENT. See the GNU General Public License for more
  16. * details.
  17. *
  18. */
  19. #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  20. #include <linux/net.h>
  21. #include <linux/nls.h>
  22. #include <linux/connector.h>
  23. #include <linux/workqueue.h>
  24. #include <linux/hyperv.h>
  25. #include "hyperv_vmbus.h"
  26. #include "hv_utils_transport.h"
  27. #define VSS_MAJOR 5
  28. #define VSS_MINOR 0
  29. #define VSS_VERSION (VSS_MAJOR << 16 | VSS_MINOR)
  30. #define VSS_USERSPACE_TIMEOUT (msecs_to_jiffies(10 * 1000))
  31. /*
  32. * Global state maintained for transaction that is being processed. For a class
  33. * of integration services, including the "VSS service", the specified protocol
  34. * is a "request/response" protocol which means that there can only be single
  35. * outstanding transaction from the host at any given point in time. We use
  36. * this to simplify memory management in this driver - we cache and process
  37. * only one message at a time.
  38. *
  39. * While the request/response protocol is guaranteed by the host, we further
  40. * ensure this by serializing packet processing in this driver - we do not
  41. * read additional packets from the VMBUs until the current packet is fully
  42. * handled.
  43. */
  44. static struct {
  45. int state; /* hvutil_device_state */
  46. int recv_len; /* number of bytes received. */
  47. struct vmbus_channel *recv_channel; /* chn we got the request */
  48. u64 recv_req_id; /* request ID. */
  49. struct hv_vss_msg *msg; /* current message */
  50. } vss_transaction;
  51. static void vss_respond_to_host(int error);
  52. /*
  53. * This state maintains the version number registered by the daemon.
  54. */
  55. static int dm_reg_value;
  56. static const char vss_devname[] = "vmbus/hv_vss";
  57. static __u8 *recv_buffer;
  58. static struct hvutil_transport *hvt;
  59. static void vss_timeout_func(struct work_struct *dummy);
  60. static void vss_handle_request(struct work_struct *dummy);
  61. static DECLARE_DELAYED_WORK(vss_timeout_work, vss_timeout_func);
  62. static DECLARE_WORK(vss_handle_request_work, vss_handle_request);
  63. static void vss_poll_wrapper(void *channel)
  64. {
  65. /* Transaction is finished, reset the state here to avoid races. */
  66. vss_transaction.state = HVUTIL_READY;
  67. hv_vss_onchannelcallback(channel);
  68. }
  69. /*
  70. * Callback when data is received from user mode.
  71. */
  72. static void vss_timeout_func(struct work_struct *dummy)
  73. {
  74. /*
  75. * Timeout waiting for userspace component to reply happened.
  76. */
  77. pr_warn("VSS: timeout waiting for daemon to reply\n");
  78. vss_respond_to_host(HV_E_FAIL);
  79. hv_poll_channel(vss_transaction.recv_channel, vss_poll_wrapper);
  80. }
  81. static void vss_register_done(void)
  82. {
  83. hv_poll_channel(vss_transaction.recv_channel, vss_poll_wrapper);
  84. pr_debug("VSS: userspace daemon registered\n");
  85. }
  86. static int vss_handle_handshake(struct hv_vss_msg *vss_msg)
  87. {
  88. u32 our_ver = VSS_OP_REGISTER1;
  89. switch (vss_msg->vss_hdr.operation) {
  90. case VSS_OP_REGISTER:
  91. /* Daemon doesn't expect us to reply */
  92. dm_reg_value = VSS_OP_REGISTER;
  93. break;
  94. case VSS_OP_REGISTER1:
  95. /* Daemon expects us to reply with our own version */
  96. if (hvutil_transport_send(hvt, &our_ver, sizeof(our_ver),
  97. vss_register_done))
  98. return -EFAULT;
  99. dm_reg_value = VSS_OP_REGISTER1;
  100. break;
  101. default:
  102. return -EINVAL;
  103. }
  104. pr_debug("VSS: userspace daemon ver. %d connected\n", dm_reg_value);
  105. return 0;
  106. }
  107. static int vss_on_msg(void *msg, int len)
  108. {
  109. struct hv_vss_msg *vss_msg = (struct hv_vss_msg *)msg;
  110. if (len != sizeof(*vss_msg))
  111. return -EINVAL;
  112. if (vss_msg->vss_hdr.operation == VSS_OP_REGISTER ||
  113. vss_msg->vss_hdr.operation == VSS_OP_REGISTER1) {
  114. /*
  115. * Don't process registration messages if we're in the middle
  116. * of a transaction processing.
  117. */
  118. if (vss_transaction.state > HVUTIL_READY)
  119. return -EINVAL;
  120. return vss_handle_handshake(vss_msg);
  121. } else if (vss_transaction.state == HVUTIL_USERSPACE_REQ) {
  122. vss_transaction.state = HVUTIL_USERSPACE_RECV;
  123. if (vss_msg->vss_hdr.operation == VSS_OP_HOT_BACKUP)
  124. vss_transaction.msg->vss_cf.flags =
  125. VSS_HBU_NO_AUTO_RECOVERY;
  126. if (cancel_delayed_work_sync(&vss_timeout_work)) {
  127. vss_respond_to_host(vss_msg->error);
  128. /* Transaction is finished, reset the state. */
  129. hv_poll_channel(vss_transaction.recv_channel,
  130. vss_poll_wrapper);
  131. }
  132. } else {
  133. /* This is a spurious call! */
  134. pr_warn("VSS: Transaction not active\n");
  135. return -EINVAL;
  136. }
  137. return 0;
  138. }
  139. static void vss_send_op(void)
  140. {
  141. int op = vss_transaction.msg->vss_hdr.operation;
  142. int rc;
  143. struct hv_vss_msg *vss_msg;
  144. /* The transaction state is wrong. */
  145. if (vss_transaction.state != HVUTIL_HOSTMSG_RECEIVED)
  146. return;
  147. vss_msg = kzalloc(sizeof(*vss_msg), GFP_KERNEL);
  148. if (!vss_msg)
  149. return;
  150. vss_msg->vss_hdr.operation = op;
  151. vss_transaction.state = HVUTIL_USERSPACE_REQ;
  152. schedule_delayed_work(&vss_timeout_work, VSS_USERSPACE_TIMEOUT);
  153. rc = hvutil_transport_send(hvt, vss_msg, sizeof(*vss_msg), NULL);
  154. if (rc) {
  155. pr_warn("VSS: failed to communicate to the daemon: %d\n", rc);
  156. if (cancel_delayed_work_sync(&vss_timeout_work)) {
  157. vss_respond_to_host(HV_E_FAIL);
  158. vss_transaction.state = HVUTIL_READY;
  159. }
  160. }
  161. kfree(vss_msg);
  162. return;
  163. }
  164. static void vss_handle_request(struct work_struct *dummy)
  165. {
  166. switch (vss_transaction.msg->vss_hdr.operation) {
  167. /*
  168. * Initiate a "freeze/thaw" operation in the guest.
  169. * We respond to the host once the operation is complete.
  170. *
  171. * We send the message to the user space daemon and the operation is
  172. * performed in the daemon.
  173. */
  174. case VSS_OP_THAW:
  175. case VSS_OP_FREEZE:
  176. case VSS_OP_HOT_BACKUP:
  177. if (vss_transaction.state < HVUTIL_READY) {
  178. /* Userspace is not registered yet */
  179. vss_respond_to_host(HV_E_FAIL);
  180. return;
  181. }
  182. vss_transaction.state = HVUTIL_HOSTMSG_RECEIVED;
  183. vss_send_op();
  184. return;
  185. case VSS_OP_GET_DM_INFO:
  186. vss_transaction.msg->dm_info.flags = 0;
  187. break;
  188. default:
  189. break;
  190. }
  191. vss_respond_to_host(0);
  192. hv_poll_channel(vss_transaction.recv_channel, vss_poll_wrapper);
  193. }
  194. /*
  195. * Send a response back to the host.
  196. */
  197. static void
  198. vss_respond_to_host(int error)
  199. {
  200. struct icmsg_hdr *icmsghdrp;
  201. u32 buf_len;
  202. struct vmbus_channel *channel;
  203. u64 req_id;
  204. /*
  205. * Copy the global state for completing the transaction. Note that
  206. * only one transaction can be active at a time.
  207. */
  208. buf_len = vss_transaction.recv_len;
  209. channel = vss_transaction.recv_channel;
  210. req_id = vss_transaction.recv_req_id;
  211. icmsghdrp = (struct icmsg_hdr *)
  212. &recv_buffer[sizeof(struct vmbuspipe_hdr)];
  213. if (channel->onchannel_callback == NULL)
  214. /*
  215. * We have raced with util driver being unloaded;
  216. * silently return.
  217. */
  218. return;
  219. icmsghdrp->status = error;
  220. icmsghdrp->icflags = ICMSGHDRFLAG_TRANSACTION | ICMSGHDRFLAG_RESPONSE;
  221. vmbus_sendpacket(channel, recv_buffer, buf_len, req_id,
  222. VM_PKT_DATA_INBAND, 0);
  223. }
  224. /*
  225. * This callback is invoked when we get a VSS message from the host.
  226. * The host ensures that only one VSS transaction can be active at a time.
  227. */
  228. void hv_vss_onchannelcallback(void *context)
  229. {
  230. struct vmbus_channel *channel = context;
  231. u32 recvlen;
  232. u64 requestid;
  233. struct hv_vss_msg *vss_msg;
  234. struct icmsg_hdr *icmsghdrp;
  235. struct icmsg_negotiate *negop = NULL;
  236. if (vss_transaction.state > HVUTIL_READY)
  237. return;
  238. vmbus_recvpacket(channel, recv_buffer, PAGE_SIZE * 2, &recvlen,
  239. &requestid);
  240. if (recvlen > 0) {
  241. icmsghdrp = (struct icmsg_hdr *)&recv_buffer[
  242. sizeof(struct vmbuspipe_hdr)];
  243. if (icmsghdrp->icmsgtype == ICMSGTYPE_NEGOTIATE) {
  244. vmbus_prep_negotiate_resp(icmsghdrp, negop,
  245. recv_buffer, UTIL_FW_VERSION,
  246. VSS_VERSION);
  247. } else {
  248. vss_msg = (struct hv_vss_msg *)&recv_buffer[
  249. sizeof(struct vmbuspipe_hdr) +
  250. sizeof(struct icmsg_hdr)];
  251. /*
  252. * Stash away this global state for completing the
  253. * transaction; note transactions are serialized.
  254. */
  255. vss_transaction.recv_len = recvlen;
  256. vss_transaction.recv_req_id = requestid;
  257. vss_transaction.msg = (struct hv_vss_msg *)vss_msg;
  258. schedule_work(&vss_handle_request_work);
  259. return;
  260. }
  261. icmsghdrp->icflags = ICMSGHDRFLAG_TRANSACTION
  262. | ICMSGHDRFLAG_RESPONSE;
  263. vmbus_sendpacket(channel, recv_buffer,
  264. recvlen, requestid,
  265. VM_PKT_DATA_INBAND, 0);
  266. }
  267. }
  268. static void vss_on_reset(void)
  269. {
  270. if (cancel_delayed_work_sync(&vss_timeout_work))
  271. vss_respond_to_host(HV_E_FAIL);
  272. vss_transaction.state = HVUTIL_DEVICE_INIT;
  273. }
  274. int
  275. hv_vss_init(struct hv_util_service *srv)
  276. {
  277. if (vmbus_proto_version < VERSION_WIN8_1) {
  278. pr_warn("Integration service 'Backup (volume snapshot)'"
  279. " not supported on this host version.\n");
  280. return -ENOTSUPP;
  281. }
  282. recv_buffer = srv->recv_buffer;
  283. vss_transaction.recv_channel = srv->channel;
  284. /*
  285. * When this driver loads, the user level daemon that
  286. * processes the host requests may not yet be running.
  287. * Defer processing channel callbacks until the daemon
  288. * has registered.
  289. */
  290. vss_transaction.state = HVUTIL_DEVICE_INIT;
  291. hvt = hvutil_transport_init(vss_devname, CN_VSS_IDX, CN_VSS_VAL,
  292. vss_on_msg, vss_on_reset);
  293. if (!hvt)
  294. return -EFAULT;
  295. return 0;
  296. }
  297. void hv_vss_deinit(void)
  298. {
  299. vss_transaction.state = HVUTIL_DEVICE_DYING;
  300. cancel_delayed_work_sync(&vss_timeout_work);
  301. cancel_work_sync(&vss_handle_request_work);
  302. hvutil_transport_destroy(hvt);
  303. }