1 /******************************************************************************
4 * This is the kernel equivalent of the "xs" library. We don't need everything
5 * and we use xenbus_comms for communication.
7 * Copyright (C) 2005 Rusty Russell, IBM Corporation
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License version 2
11 * as published by the Free Software Foundation; or, when distributed
12 * separately from the Linux kernel or incorporated into other
13 * software packages, subject to the following license:
15 * Permission is hereby granted, free of charge, to any person obtaining a copy
16 * of this source file (the "Software"), to deal in the Software without
17 * restriction, including without limitation the rights to use, copy, modify,
18 * merge, publish, distribute, sublicense, and/or sell copies of the Software,
19 * and to permit persons to whom the Software is furnished to do so, subject to
20 * the following conditions:
22 * The above copyright notice and this permission notice shall be included in
23 * all copies or substantial portions of the Software.
25 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
26 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
27 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
28 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
29 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
30 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
34 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
36 #include <linux/unistd.h>
37 #include <linux/errno.h>
38 #include <linux/types.h>
39 #include <linux/uio.h>
40 #include <linux/kernel.h>
41 #include <linux/string.h>
42 #include <linux/err.h>
43 #include <linux/slab.h>
44 #include <linux/fcntl.h>
45 #include <linux/kthread.h>
46 #include <linux/reboot.h>
47 #include <linux/rwsem.h>
48 #include <linux/mutex.h>
49 #include <asm/xen/hypervisor.h>
50 #include <xen/xenbus.h>
55 * Framework to protect suspend/resume handling against normal Xenstore
57 * During suspend/resume there must be no open transaction and no pending
59 * New watch events happening in this time can be ignored by firing all watches
63 /* Lock protecting enter/exit critical region. */
64 static DEFINE_SPINLOCK(xs_state_lock
);
65 /* Number of users in critical region (protected by xs_state_lock). */
66 static unsigned int xs_state_users
;
67 /* Suspend handler waiting or already active (protected by xs_state_lock)? */
68 static int xs_suspend_active
;
69 /* Unique Xenstore request id (protected by xs_state_lock). */
70 static uint32_t xs_request_id
;
72 /* Wait queue for all callers waiting for critical region to become usable. */
73 static DECLARE_WAIT_QUEUE_HEAD(xs_state_enter_wq
);
74 /* Wait queue for suspend handling waiting for critical region being empty. */
75 static DECLARE_WAIT_QUEUE_HEAD(xs_state_exit_wq
);
77 /* List of registered watches, and a lock to protect it. */
78 static LIST_HEAD(watches
);
79 static DEFINE_SPINLOCK(watches_lock
);
81 /* List of pending watch callback events, and a lock to protect it. */
82 static LIST_HEAD(watch_events
);
83 static DEFINE_SPINLOCK(watch_events_lock
);
85 /* Protect watch (de)register against save/restore. */
86 static DECLARE_RWSEM(xs_watch_rwsem
);
89 * Details of the xenwatch callback kernel thread. The thread waits on the
90 * watch_events_waitq for work to do (queued on watch_events list). When it
91 * wakes up it acquires the xenwatch_mutex before reading the list and
94 static pid_t xenwatch_pid
;
95 static DEFINE_MUTEX(xenwatch_mutex
);
96 static DECLARE_WAIT_QUEUE_HEAD(watch_events_waitq
);
98 static void xs_suspend_enter(void)
100 spin_lock(&xs_state_lock
);
102 spin_unlock(&xs_state_lock
);
103 wait_event(xs_state_exit_wq
, xs_state_users
== 0);
106 static void xs_suspend_exit(void)
108 spin_lock(&xs_state_lock
);
110 spin_unlock(&xs_state_lock
);
111 wake_up_all(&xs_state_enter_wq
);
114 static uint32_t xs_request_enter(struct xb_req_data
*req
)
118 req
->type
= req
->msg
.type
;
120 spin_lock(&xs_state_lock
);
122 while (!xs_state_users
&& xs_suspend_active
) {
123 spin_unlock(&xs_state_lock
);
124 wait_event(xs_state_enter_wq
, xs_suspend_active
== 0);
125 spin_lock(&xs_state_lock
);
128 if (req
->type
== XS_TRANSACTION_START
)
131 rq_id
= xs_request_id
++;
133 spin_unlock(&xs_state_lock
);
138 void xs_request_exit(struct xb_req_data
*req
)
140 spin_lock(&xs_state_lock
);
142 if ((req
->type
== XS_TRANSACTION_START
&& req
->msg
.type
== XS_ERROR
) ||
143 req
->type
== XS_TRANSACTION_END
)
145 spin_unlock(&xs_state_lock
);
147 if (xs_suspend_active
&& !xs_state_users
)
148 wake_up(&xs_state_exit_wq
);
151 static int get_error(const char *errorstring
)
155 for (i
= 0; strcmp(errorstring
, xsd_errors
[i
].errstring
) != 0; i
++) {
156 if (i
== ARRAY_SIZE(xsd_errors
) - 1) {
157 pr_warn("xen store gave: unknown error %s\n",
162 return xsd_errors
[i
].errnum
;
165 static bool xenbus_ok(void)
167 switch (xen_store_domain_type
) {
169 switch (system_state
) {
170 case SYSTEM_POWER_OFF
:
180 /* FIXME: Could check that the remote domain is alive,
181 * but it is normally initial domain. */
189 static bool test_reply(struct xb_req_data
*req
)
191 if (req
->state
== xb_req_state_got_reply
|| !xenbus_ok())
194 /* Make sure to reread req->state each time. */
200 static void *read_reply(struct xb_req_data
*req
)
202 while (req
->state
!= xb_req_state_got_reply
) {
203 wait_event(req
->wq
, test_reply(req
));
207 * If we are in the process of being shut-down there is
208 * no point of trying to contact XenBus - it is either
209 * killed (xenstored application) or the other domain
210 * has been killed or is unreachable.
212 return ERR_PTR(-EIO
);
214 return ERR_PTR(req
->err
);
221 static void xs_send(struct xb_req_data
*req
, struct xsd_sockmsg
*msg
)
227 req
->state
= xb_req_state_queued
;
228 init_waitqueue_head(&req
->wq
);
230 /* Save the caller req_id and restore it later in the reply */
231 req
->caller_req_id
= req
->msg
.req_id
;
232 req
->msg
.req_id
= xs_request_enter(req
);
234 mutex_lock(&xb_write_mutex
);
235 list_add_tail(&req
->list
, &xb_write_list
);
236 notify
= list_is_singular(&xb_write_list
);
237 mutex_unlock(&xb_write_mutex
);
243 static void *xs_wait_for_reply(struct xb_req_data
*req
, struct xsd_sockmsg
*msg
)
247 ret
= read_reply(req
);
249 xs_request_exit(req
);
251 msg
->type
= req
->msg
.type
;
252 msg
->len
= req
->msg
.len
;
254 mutex_lock(&xb_write_mutex
);
255 if (req
->state
== xb_req_state_queued
||
256 req
->state
== xb_req_state_wait_reply
)
257 req
->state
= xb_req_state_aborted
;
260 mutex_unlock(&xb_write_mutex
);
265 static void xs_wake_up(struct xb_req_data
*req
)
270 int xenbus_dev_request_and_reply(struct xsd_sockmsg
*msg
, void *par
)
272 struct xb_req_data
*req
;
275 req
= kmalloc(sizeof(*req
) + sizeof(*vec
), GFP_KERNEL
);
279 vec
= (struct kvec
*)(req
+ 1);
280 vec
->iov_len
= msg
->len
;
281 vec
->iov_base
= msg
+ 1;
285 req
->cb
= xenbus_dev_queue_reply
;
292 EXPORT_SYMBOL(xenbus_dev_request_and_reply
);
294 /* Send message to xs, get kmalloc'ed reply. ERR_PTR() on error. */
295 static void *xs_talkv(struct xenbus_transaction t
,
296 enum xsd_sockmsg_type type
,
297 const struct kvec
*iovec
,
298 unsigned int num_vecs
,
301 struct xb_req_data
*req
;
302 struct xsd_sockmsg msg
;
307 req
= kmalloc(sizeof(*req
), GFP_NOIO
| __GFP_HIGH
);
309 return ERR_PTR(-ENOMEM
);
312 req
->num_vecs
= num_vecs
;
313 req
->cb
= xs_wake_up
;
319 for (i
= 0; i
< num_vecs
; i
++)
320 msg
.len
+= iovec
[i
].iov_len
;
324 ret
= xs_wait_for_reply(req
, &msg
);
331 if (msg
.type
== XS_ERROR
) {
332 err
= get_error(ret
);
334 return ERR_PTR(-err
);
337 if (msg
.type
!= type
) {
338 pr_warn_ratelimited("unexpected type [%d], expected [%d]\n",
341 return ERR_PTR(-EINVAL
);
346 /* Simplified version of xs_talkv: single message. */
347 static void *xs_single(struct xenbus_transaction t
,
348 enum xsd_sockmsg_type type
,
354 iovec
.iov_base
= (void *)string
;
355 iovec
.iov_len
= strlen(string
) + 1;
356 return xs_talkv(t
, type
, &iovec
, 1, len
);
359 /* Many commands only need an ack, don't care what it says. */
360 static int xs_error(char *reply
)
363 return PTR_ERR(reply
);
368 static unsigned int count_strings(const char *strings
, unsigned int len
)
373 for (p
= strings
, num
= 0; p
< strings
+ len
; p
+= strlen(p
) + 1)
379 /* Return the path to dir with /name appended. Buffer must be kfree()'ed. */
380 static char *join(const char *dir
, const char *name
)
384 if (strlen(name
) == 0)
385 buffer
= kasprintf(GFP_NOIO
| __GFP_HIGH
, "%s", dir
);
387 buffer
= kasprintf(GFP_NOIO
| __GFP_HIGH
, "%s/%s", dir
, name
);
388 return (!buffer
) ? ERR_PTR(-ENOMEM
) : buffer
;
391 static char **split(char *strings
, unsigned int len
, unsigned int *num
)
395 /* Count the strings. */
396 *num
= count_strings(strings
, len
);
398 /* Transfer to one big alloc for easy freeing. */
399 ret
= kmalloc(*num
* sizeof(char *) + len
, GFP_NOIO
| __GFP_HIGH
);
402 return ERR_PTR(-ENOMEM
);
404 memcpy(&ret
[*num
], strings
, len
);
407 strings
= (char *)&ret
[*num
];
408 for (p
= strings
, *num
= 0; p
< strings
+ len
; p
+= strlen(p
) + 1)
414 char **xenbus_directory(struct xenbus_transaction t
,
415 const char *dir
, const char *node
, unsigned int *num
)
417 char *strings
, *path
;
420 path
= join(dir
, node
);
422 return (char **)path
;
424 strings
= xs_single(t
, XS_DIRECTORY
, path
, &len
);
427 return (char **)strings
;
429 return split(strings
, len
, num
);
431 EXPORT_SYMBOL_GPL(xenbus_directory
);
433 /* Check if a path exists. Return 1 if it does. */
434 int xenbus_exists(struct xenbus_transaction t
,
435 const char *dir
, const char *node
)
440 d
= xenbus_directory(t
, dir
, node
, &dir_n
);
446 EXPORT_SYMBOL_GPL(xenbus_exists
);
448 /* Get the value of a single file.
449 * Returns a kmalloced value: call free() on it after use.
450 * len indicates length in bytes.
452 void *xenbus_read(struct xenbus_transaction t
,
453 const char *dir
, const char *node
, unsigned int *len
)
458 path
= join(dir
, node
);
462 ret
= xs_single(t
, XS_READ
, path
, len
);
466 EXPORT_SYMBOL_GPL(xenbus_read
);
468 /* Write the value of a single file.
469 * Returns -err on failure.
471 int xenbus_write(struct xenbus_transaction t
,
472 const char *dir
, const char *node
, const char *string
)
475 struct kvec iovec
[2];
478 path
= join(dir
, node
);
480 return PTR_ERR(path
);
482 iovec
[0].iov_base
= (void *)path
;
483 iovec
[0].iov_len
= strlen(path
) + 1;
484 iovec
[1].iov_base
= (void *)string
;
485 iovec
[1].iov_len
= strlen(string
);
487 ret
= xs_error(xs_talkv(t
, XS_WRITE
, iovec
, ARRAY_SIZE(iovec
), NULL
));
491 EXPORT_SYMBOL_GPL(xenbus_write
);
493 /* Create a new directory. */
494 int xenbus_mkdir(struct xenbus_transaction t
,
495 const char *dir
, const char *node
)
500 path
= join(dir
, node
);
502 return PTR_ERR(path
);
504 ret
= xs_error(xs_single(t
, XS_MKDIR
, path
, NULL
));
508 EXPORT_SYMBOL_GPL(xenbus_mkdir
);
510 /* Destroy a file or directory (directories must be empty). */
511 int xenbus_rm(struct xenbus_transaction t
, const char *dir
, const char *node
)
516 path
= join(dir
, node
);
518 return PTR_ERR(path
);
520 ret
= xs_error(xs_single(t
, XS_RM
, path
, NULL
));
524 EXPORT_SYMBOL_GPL(xenbus_rm
);
526 /* Start a transaction: changes by others will not be seen during this
527 * transaction, and changes will not be visible to others until end.
529 int xenbus_transaction_start(struct xenbus_transaction
*t
)
533 id_str
= xs_single(XBT_NIL
, XS_TRANSACTION_START
, "", NULL
);
535 return PTR_ERR(id_str
);
537 t
->id
= simple_strtoul(id_str
, NULL
, 0);
541 EXPORT_SYMBOL_GPL(xenbus_transaction_start
);
543 /* End a transaction.
544 * If abandon is true, transaction is discarded instead of committed.
546 int xenbus_transaction_end(struct xenbus_transaction t
, int abort
)
551 strcpy(abortstr
, "F");
553 strcpy(abortstr
, "T");
555 return xs_error(xs_single(t
, XS_TRANSACTION_END
, abortstr
, NULL
));
557 EXPORT_SYMBOL_GPL(xenbus_transaction_end
);
559 /* Single read and scanf: returns -errno or num scanned. */
560 int xenbus_scanf(struct xenbus_transaction t
,
561 const char *dir
, const char *node
, const char *fmt
, ...)
567 val
= xenbus_read(t
, dir
, node
, NULL
);
572 ret
= vsscanf(val
, fmt
, ap
);
575 /* Distinctive errno. */
580 EXPORT_SYMBOL_GPL(xenbus_scanf
);
582 /* Read an (optional) unsigned value. */
583 unsigned int xenbus_read_unsigned(const char *dir
, const char *node
,
584 unsigned int default_val
)
589 ret
= xenbus_scanf(XBT_NIL
, dir
, node
, "%u", &val
);
595 EXPORT_SYMBOL_GPL(xenbus_read_unsigned
);
597 /* Single printf and write: returns -errno or 0. */
598 int xenbus_printf(struct xenbus_transaction t
,
599 const char *dir
, const char *node
, const char *fmt
, ...)
606 buf
= kvasprintf(GFP_NOIO
| __GFP_HIGH
, fmt
, ap
);
612 ret
= xenbus_write(t
, dir
, node
, buf
);
618 EXPORT_SYMBOL_GPL(xenbus_printf
);
620 /* Takes tuples of names, scanf-style args, and void **, NULL terminated. */
621 int xenbus_gather(struct xenbus_transaction t
, const char *dir
, ...)
628 while (ret
== 0 && (name
= va_arg(ap
, char *)) != NULL
) {
629 const char *fmt
= va_arg(ap
, char *);
630 void *result
= va_arg(ap
, void *);
633 p
= xenbus_read(t
, dir
, name
, NULL
);
639 if (sscanf(p
, fmt
, result
) == 0)
643 *(char **)result
= p
;
648 EXPORT_SYMBOL_GPL(xenbus_gather
);
650 static int xs_watch(const char *path
, const char *token
)
654 iov
[0].iov_base
= (void *)path
;
655 iov
[0].iov_len
= strlen(path
) + 1;
656 iov
[1].iov_base
= (void *)token
;
657 iov
[1].iov_len
= strlen(token
) + 1;
659 return xs_error(xs_talkv(XBT_NIL
, XS_WATCH
, iov
,
660 ARRAY_SIZE(iov
), NULL
));
663 static int xs_unwatch(const char *path
, const char *token
)
667 iov
[0].iov_base
= (char *)path
;
668 iov
[0].iov_len
= strlen(path
) + 1;
669 iov
[1].iov_base
= (char *)token
;
670 iov
[1].iov_len
= strlen(token
) + 1;
672 return xs_error(xs_talkv(XBT_NIL
, XS_UNWATCH
, iov
,
673 ARRAY_SIZE(iov
), NULL
));
676 static struct xenbus_watch
*find_watch(const char *token
)
678 struct xenbus_watch
*i
, *cmp
;
680 cmp
= (void *)simple_strtoul(token
, NULL
, 16);
682 list_for_each_entry(i
, &watches
, list
)
689 int xs_watch_msg(struct xs_watch_event
*event
)
691 if (count_strings(event
->body
, event
->len
) != 2) {
695 event
->path
= (const char *)event
->body
;
696 event
->token
= (const char *)strchr(event
->body
, '\0') + 1;
698 spin_lock(&watches_lock
);
699 event
->handle
= find_watch(event
->token
);
700 if (event
->handle
!= NULL
) {
701 spin_lock(&watch_events_lock
);
702 list_add_tail(&event
->list
, &watch_events
);
703 wake_up(&watch_events_waitq
);
704 spin_unlock(&watch_events_lock
);
707 spin_unlock(&watches_lock
);
713 * Certain older XenBus toolstack cannot handle reading values that are
714 * not populated. Some Xen 3.4 installation are incapable of doing this
715 * so if we are running on anything older than 4 do not attempt to read
716 * control/platform-feature-xs_reset_watches.
718 static bool xen_strict_xenbus_quirk(void)
721 uint32_t eax
, ebx
, ecx
, edx
, base
;
723 base
= xen_cpuid_base();
724 cpuid(base
+ 1, &eax
, &ebx
, &ecx
, &edx
);
732 static void xs_reset_watches(void)
736 if (!xen_hvm_domain() || xen_initial_domain())
739 if (xen_strict_xenbus_quirk())
742 if (!xenbus_read_unsigned("control",
743 "platform-feature-xs_reset_watches", 0))
746 err
= xs_error(xs_single(XBT_NIL
, XS_RESET_WATCHES
, "", NULL
));
747 if (err
&& err
!= -EEXIST
)
748 pr_warn("xs_reset_watches failed: %d\n", err
);
751 /* Register callback to watch this node. */
752 int register_xenbus_watch(struct xenbus_watch
*watch
)
754 /* Pointer in ascii is the token. */
755 char token
[sizeof(watch
) * 2 + 1];
758 sprintf(token
, "%lX", (long)watch
);
760 down_read(&xs_watch_rwsem
);
762 spin_lock(&watches_lock
);
763 BUG_ON(find_watch(token
));
764 list_add(&watch
->list
, &watches
);
765 spin_unlock(&watches_lock
);
767 err
= xs_watch(watch
->node
, token
);
770 spin_lock(&watches_lock
);
771 list_del(&watch
->list
);
772 spin_unlock(&watches_lock
);
775 up_read(&xs_watch_rwsem
);
779 EXPORT_SYMBOL_GPL(register_xenbus_watch
);
781 void unregister_xenbus_watch(struct xenbus_watch
*watch
)
783 struct xs_watch_event
*event
, *tmp
;
784 char token
[sizeof(watch
) * 2 + 1];
787 sprintf(token
, "%lX", (long)watch
);
789 down_read(&xs_watch_rwsem
);
791 spin_lock(&watches_lock
);
792 BUG_ON(!find_watch(token
));
793 list_del(&watch
->list
);
794 spin_unlock(&watches_lock
);
796 err
= xs_unwatch(watch
->node
, token
);
798 pr_warn("Failed to release watch %s: %i\n", watch
->node
, err
);
800 up_read(&xs_watch_rwsem
);
802 /* Make sure there are no callbacks running currently (unless
804 if (current
->pid
!= xenwatch_pid
)
805 mutex_lock(&xenwatch_mutex
);
807 /* Cancel pending watch events. */
808 spin_lock(&watch_events_lock
);
809 list_for_each_entry_safe(event
, tmp
, &watch_events
, list
) {
810 if (event
->handle
!= watch
)
812 list_del(&event
->list
);
815 spin_unlock(&watch_events_lock
);
817 if (current
->pid
!= xenwatch_pid
)
818 mutex_unlock(&xenwatch_mutex
);
820 EXPORT_SYMBOL_GPL(unregister_xenbus_watch
);
822 void xs_suspend(void)
826 down_write(&xs_watch_rwsem
);
827 mutex_lock(&xs_response_mutex
);
832 struct xenbus_watch
*watch
;
833 char token
[sizeof(watch
) * 2 + 1];
837 mutex_unlock(&xs_response_mutex
);
841 /* No need for watches_lock: the xs_watch_rwsem is sufficient. */
842 list_for_each_entry(watch
, &watches
, list
) {
843 sprintf(token
, "%lX", (long)watch
);
844 xs_watch(watch
->node
, token
);
847 up_write(&xs_watch_rwsem
);
850 void xs_suspend_cancel(void)
852 mutex_unlock(&xs_response_mutex
);
853 up_write(&xs_watch_rwsem
);
858 static int xenwatch_thread(void *unused
)
860 struct list_head
*ent
;
861 struct xs_watch_event
*event
;
863 xenwatch_pid
= current
->pid
;
866 wait_event_interruptible(watch_events_waitq
,
867 !list_empty(&watch_events
));
869 if (kthread_should_stop())
872 mutex_lock(&xenwatch_mutex
);
874 spin_lock(&watch_events_lock
);
875 ent
= watch_events
.next
;
876 if (ent
!= &watch_events
)
878 spin_unlock(&watch_events_lock
);
880 if (ent
!= &watch_events
) {
881 event
= list_entry(ent
, struct xs_watch_event
, list
);
882 event
->handle
->callback(event
->handle
, event
->path
,
887 mutex_unlock(&xenwatch_mutex
);
894 * Wake up all threads waiting for a xenstore reply. In case of shutdown all
895 * pending replies will be marked as "aborted" in order to let the waiters
896 * return in spite of xenstore possibly no longer being able to reply. This
897 * will avoid blocking shutdown by a thread waiting for xenstore but being
898 * necessary for shutdown processing to proceed.
900 static int xs_reboot_notify(struct notifier_block
*nb
,
901 unsigned long code
, void *unused
)
903 struct xb_req_data
*req
;
905 mutex_lock(&xb_write_mutex
);
906 list_for_each_entry(req
, &xs_reply_list
, list
)
908 list_for_each_entry(req
, &xb_write_list
, list
)
910 mutex_unlock(&xb_write_mutex
);
914 static struct notifier_block xs_reboot_nb
= {
915 .notifier_call
= xs_reboot_notify
,
921 struct task_struct
*task
;
923 register_reboot_notifier(&xs_reboot_nb
);
925 /* Initialize the shared memory rings to talk to xenstored */
926 err
= xb_init_comms();
930 task
= kthread_run(xenwatch_thread
, NULL
, "xenwatch");
932 return PTR_ERR(task
);
934 /* shutdown watches for kexec boot */