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 #include <linux/unistd.h>
35 #include <linux/errno.h>
36 #include <linux/types.h>
37 #include <linux/uio.h>
38 #include <linux/kernel.h>
39 #include <linux/string.h>
40 #include <linux/err.h>
41 #include <linux/slab.h>
42 #include <linux/fcntl.h>
43 #include <linux/kthread.h>
44 #include <linux/rwsem.h>
45 #include <linux/module.h>
46 #include <linux/mutex.h>
47 #include <xen/xenbus.h>
49 #include "xenbus_comms.h"
50 #include <asm/xen/hypervisor.h>
52 struct xs_stored_msg
{
53 struct list_head list
;
55 struct xsd_sockmsg hdr
;
63 /* Queued watch events. */
65 struct xenbus_watch
*handle
;
67 unsigned int vec_size
;
73 /* A list of replies. Currently only one will ever be outstanding. */
74 struct list_head reply_list
;
75 spinlock_t reply_lock
;
76 wait_queue_head_t reply_waitq
;
79 * Mutex ordering: transaction_mutex -> watch_mutex -> request_mutex.
80 * response_mutex is never taken simultaneously with the other three.
82 * transaction_mutex must be held before incrementing
83 * transaction_count. The mutex is held when a suspend is in
84 * progress to prevent new transactions starting.
86 * When decrementing transaction_count to zero the wait queue
87 * should be woken up, the suspend code waits for count to
91 /* One request at a time. */
92 struct mutex request_mutex
;
94 /* Protect xenbus reader thread against save/restore. */
95 struct mutex response_mutex
;
97 /* Protect transactions against save/restore. */
98 struct mutex transaction_mutex
;
99 atomic_t transaction_count
;
100 wait_queue_head_t transaction_wq
;
102 /* Protect watch (de)register against save/restore. */
103 struct rw_semaphore watch_mutex
;
106 static struct xs_handle xs_state
;
108 /* List of registered watches, and a lock to protect it. */
109 static LIST_HEAD(watches
);
110 static DEFINE_SPINLOCK(watches_lock
);
112 /* List of pending watch callback events, and a lock to protect it. */
113 static LIST_HEAD(watch_events
);
114 static DEFINE_SPINLOCK(watch_events_lock
);
117 * Details of the xenwatch callback kernel thread. The thread waits on the
118 * watch_events_waitq for work to do (queued on watch_events list). When it
119 * wakes up it acquires the xenwatch_mutex before reading the list and
122 static pid_t xenwatch_pid
;
123 static DEFINE_MUTEX(xenwatch_mutex
);
124 static DECLARE_WAIT_QUEUE_HEAD(watch_events_waitq
);
126 static int get_error(const char *errorstring
)
130 for (i
= 0; strcmp(errorstring
, xsd_errors
[i
].errstring
) != 0; i
++) {
131 if (i
== ARRAY_SIZE(xsd_errors
) - 1) {
133 "XENBUS xen store gave: unknown error %s",
138 return xsd_errors
[i
].errnum
;
141 static void *read_reply(enum xsd_sockmsg_type
*type
, unsigned int *len
)
143 struct xs_stored_msg
*msg
;
146 spin_lock(&xs_state
.reply_lock
);
148 while (list_empty(&xs_state
.reply_list
)) {
149 spin_unlock(&xs_state
.reply_lock
);
150 /* XXX FIXME: Avoid synchronous wait for response here. */
151 wait_event(xs_state
.reply_waitq
,
152 !list_empty(&xs_state
.reply_list
));
153 spin_lock(&xs_state
.reply_lock
);
156 msg
= list_entry(xs_state
.reply_list
.next
,
157 struct xs_stored_msg
, list
);
158 list_del(&msg
->list
);
160 spin_unlock(&xs_state
.reply_lock
);
162 *type
= msg
->hdr
.type
;
165 body
= msg
->u
.reply
.body
;
172 static void transaction_start(void)
174 mutex_lock(&xs_state
.transaction_mutex
);
175 atomic_inc(&xs_state
.transaction_count
);
176 mutex_unlock(&xs_state
.transaction_mutex
);
179 static void transaction_end(void)
181 if (atomic_dec_and_test(&xs_state
.transaction_count
))
182 wake_up(&xs_state
.transaction_wq
);
185 static void transaction_suspend(void)
187 mutex_lock(&xs_state
.transaction_mutex
);
188 wait_event(xs_state
.transaction_wq
,
189 atomic_read(&xs_state
.transaction_count
) == 0);
192 static void transaction_resume(void)
194 mutex_unlock(&xs_state
.transaction_mutex
);
197 void *xenbus_dev_request_and_reply(struct xsd_sockmsg
*msg
)
200 struct xsd_sockmsg req_msg
= *msg
;
203 if (req_msg
.type
== XS_TRANSACTION_START
)
206 mutex_lock(&xs_state
.request_mutex
);
208 err
= xb_write(msg
, sizeof(*msg
) + msg
->len
);
210 msg
->type
= XS_ERROR
;
213 ret
= read_reply(&msg
->type
, &msg
->len
);
215 mutex_unlock(&xs_state
.request_mutex
);
217 if ((msg
->type
== XS_TRANSACTION_END
) ||
218 ((req_msg
.type
== XS_TRANSACTION_START
) &&
219 (msg
->type
== XS_ERROR
)))
224 EXPORT_SYMBOL(xenbus_dev_request_and_reply
);
226 /* Send message to xs, get kmalloc'ed reply. ERR_PTR() on error. */
227 static void *xs_talkv(struct xenbus_transaction t
,
228 enum xsd_sockmsg_type type
,
229 const struct kvec
*iovec
,
230 unsigned int num_vecs
,
233 struct xsd_sockmsg msg
;
242 for (i
= 0; i
< num_vecs
; i
++)
243 msg
.len
+= iovec
[i
].iov_len
;
245 mutex_lock(&xs_state
.request_mutex
);
247 err
= xb_write(&msg
, sizeof(msg
));
249 mutex_unlock(&xs_state
.request_mutex
);
253 for (i
= 0; i
< num_vecs
; i
++) {
254 err
= xb_write(iovec
[i
].iov_base
, iovec
[i
].iov_len
);
256 mutex_unlock(&xs_state
.request_mutex
);
261 ret
= read_reply(&msg
.type
, len
);
263 mutex_unlock(&xs_state
.request_mutex
);
268 if (msg
.type
== XS_ERROR
) {
269 err
= get_error(ret
);
271 return ERR_PTR(-err
);
274 if (msg
.type
!= type
) {
275 if (printk_ratelimit())
277 "XENBUS unexpected type [%d], expected [%d]\n",
280 return ERR_PTR(-EINVAL
);
285 /* Simplified version of xs_talkv: single message. */
286 static void *xs_single(struct xenbus_transaction t
,
287 enum xsd_sockmsg_type type
,
293 iovec
.iov_base
= (void *)string
;
294 iovec
.iov_len
= strlen(string
) + 1;
295 return xs_talkv(t
, type
, &iovec
, 1, len
);
298 /* Many commands only need an ack, don't care what it says. */
299 static int xs_error(char *reply
)
302 return PTR_ERR(reply
);
307 static unsigned int count_strings(const char *strings
, unsigned int len
)
312 for (p
= strings
, num
= 0; p
< strings
+ len
; p
+= strlen(p
) + 1)
318 /* Return the path to dir with /name appended. Buffer must be kfree()'ed. */
319 static char *join(const char *dir
, const char *name
)
323 if (strlen(name
) == 0)
324 buffer
= kasprintf(GFP_NOIO
| __GFP_HIGH
, "%s", dir
);
326 buffer
= kasprintf(GFP_NOIO
| __GFP_HIGH
, "%s/%s", dir
, name
);
327 return (!buffer
) ? ERR_PTR(-ENOMEM
) : buffer
;
330 static char **split(char *strings
, unsigned int len
, unsigned int *num
)
334 /* Count the strings. */
335 *num
= count_strings(strings
, len
);
337 /* Transfer to one big alloc for easy freeing. */
338 ret
= kmalloc(*num
* sizeof(char *) + len
, GFP_NOIO
| __GFP_HIGH
);
341 return ERR_PTR(-ENOMEM
);
343 memcpy(&ret
[*num
], strings
, len
);
346 strings
= (char *)&ret
[*num
];
347 for (p
= strings
, *num
= 0; p
< strings
+ len
; p
+= strlen(p
) + 1)
353 char **xenbus_directory(struct xenbus_transaction t
,
354 const char *dir
, const char *node
, unsigned int *num
)
356 char *strings
, *path
;
359 path
= join(dir
, node
);
361 return (char **)path
;
363 strings
= xs_single(t
, XS_DIRECTORY
, path
, &len
);
366 return (char **)strings
;
368 return split(strings
, len
, num
);
370 EXPORT_SYMBOL_GPL(xenbus_directory
);
372 /* Check if a path exists. Return 1 if it does. */
373 int xenbus_exists(struct xenbus_transaction t
,
374 const char *dir
, const char *node
)
379 d
= xenbus_directory(t
, dir
, node
, &dir_n
);
385 EXPORT_SYMBOL_GPL(xenbus_exists
);
387 /* Get the value of a single file.
388 * Returns a kmalloced value: call free() on it after use.
389 * len indicates length in bytes.
391 void *xenbus_read(struct xenbus_transaction t
,
392 const char *dir
, const char *node
, unsigned int *len
)
397 path
= join(dir
, node
);
401 ret
= xs_single(t
, XS_READ
, path
, len
);
405 EXPORT_SYMBOL_GPL(xenbus_read
);
407 /* Write the value of a single file.
408 * Returns -err on failure.
410 int xenbus_write(struct xenbus_transaction t
,
411 const char *dir
, const char *node
, const char *string
)
414 struct kvec iovec
[2];
417 path
= join(dir
, node
);
419 return PTR_ERR(path
);
421 iovec
[0].iov_base
= (void *)path
;
422 iovec
[0].iov_len
= strlen(path
) + 1;
423 iovec
[1].iov_base
= (void *)string
;
424 iovec
[1].iov_len
= strlen(string
);
426 ret
= xs_error(xs_talkv(t
, XS_WRITE
, iovec
, ARRAY_SIZE(iovec
), NULL
));
430 EXPORT_SYMBOL_GPL(xenbus_write
);
432 /* Create a new directory. */
433 int xenbus_mkdir(struct xenbus_transaction t
,
434 const char *dir
, const char *node
)
439 path
= join(dir
, node
);
441 return PTR_ERR(path
);
443 ret
= xs_error(xs_single(t
, XS_MKDIR
, path
, NULL
));
447 EXPORT_SYMBOL_GPL(xenbus_mkdir
);
449 /* Destroy a file or directory (directories must be empty). */
450 int xenbus_rm(struct xenbus_transaction t
, const char *dir
, const char *node
)
455 path
= join(dir
, node
);
457 return PTR_ERR(path
);
459 ret
= xs_error(xs_single(t
, XS_RM
, path
, NULL
));
463 EXPORT_SYMBOL_GPL(xenbus_rm
);
465 /* Start a transaction: changes by others will not be seen during this
466 * transaction, and changes will not be visible to others until end.
468 int xenbus_transaction_start(struct xenbus_transaction
*t
)
474 id_str
= xs_single(XBT_NIL
, XS_TRANSACTION_START
, "", NULL
);
475 if (IS_ERR(id_str
)) {
477 return PTR_ERR(id_str
);
480 t
->id
= simple_strtoul(id_str
, NULL
, 0);
484 EXPORT_SYMBOL_GPL(xenbus_transaction_start
);
486 /* End a transaction.
487 * If abandon is true, transaction is discarded instead of committed.
489 int xenbus_transaction_end(struct xenbus_transaction t
, int abort
)
495 strcpy(abortstr
, "F");
497 strcpy(abortstr
, "T");
499 err
= xs_error(xs_single(t
, XS_TRANSACTION_END
, abortstr
, NULL
));
505 EXPORT_SYMBOL_GPL(xenbus_transaction_end
);
507 /* Single read and scanf: returns -errno or num scanned. */
508 int xenbus_scanf(struct xenbus_transaction t
,
509 const char *dir
, const char *node
, const char *fmt
, ...)
515 val
= xenbus_read(t
, dir
, node
, NULL
);
520 ret
= vsscanf(val
, fmt
, ap
);
523 /* Distinctive errno. */
528 EXPORT_SYMBOL_GPL(xenbus_scanf
);
530 /* Single printf and write: returns -errno or 0. */
531 int xenbus_printf(struct xenbus_transaction t
,
532 const char *dir
, const char *node
, const char *fmt
, ...)
539 buf
= kvasprintf(GFP_NOIO
| __GFP_HIGH
, fmt
, ap
);
545 ret
= xenbus_write(t
, dir
, node
, buf
);
551 EXPORT_SYMBOL_GPL(xenbus_printf
);
553 /* Takes tuples of names, scanf-style args, and void **, NULL terminated. */
554 int xenbus_gather(struct xenbus_transaction t
, const char *dir
, ...)
561 while (ret
== 0 && (name
= va_arg(ap
, char *)) != NULL
) {
562 const char *fmt
= va_arg(ap
, char *);
563 void *result
= va_arg(ap
, void *);
566 p
= xenbus_read(t
, dir
, name
, NULL
);
572 if (sscanf(p
, fmt
, result
) == 0)
576 *(char **)result
= p
;
581 EXPORT_SYMBOL_GPL(xenbus_gather
);
583 static int xs_watch(const char *path
, const char *token
)
587 iov
[0].iov_base
= (void *)path
;
588 iov
[0].iov_len
= strlen(path
) + 1;
589 iov
[1].iov_base
= (void *)token
;
590 iov
[1].iov_len
= strlen(token
) + 1;
592 return xs_error(xs_talkv(XBT_NIL
, XS_WATCH
, iov
,
593 ARRAY_SIZE(iov
), NULL
));
596 static int xs_unwatch(const char *path
, const char *token
)
600 iov
[0].iov_base
= (char *)path
;
601 iov
[0].iov_len
= strlen(path
) + 1;
602 iov
[1].iov_base
= (char *)token
;
603 iov
[1].iov_len
= strlen(token
) + 1;
605 return xs_error(xs_talkv(XBT_NIL
, XS_UNWATCH
, iov
,
606 ARRAY_SIZE(iov
), NULL
));
609 static struct xenbus_watch
*find_watch(const char *token
)
611 struct xenbus_watch
*i
, *cmp
;
613 cmp
= (void *)simple_strtoul(token
, NULL
, 16);
615 list_for_each_entry(i
, &watches
, list
)
622 * Certain older XenBus toolstack cannot handle reading values that are
623 * not populated. Some Xen 3.4 installation are incapable of doing this
624 * so if we are running on anything older than 4 do not attempt to read
625 * control/platform-feature-xs_reset_watches.
627 static bool xen_strict_xenbus_quirk()
629 uint32_t eax
, ebx
, ecx
, edx
, base
;
631 base
= xen_cpuid_base();
632 cpuid(base
+ 1, &eax
, &ebx
, &ecx
, &edx
);
639 static void xs_reset_watches(void)
641 int err
, supported
= 0;
643 if (!xen_hvm_domain())
646 if (xen_strict_xenbus_quirk())
649 err
= xenbus_scanf(XBT_NIL
, "control",
650 "platform-feature-xs_reset_watches", "%d", &supported
);
651 if (err
!= 1 || !supported
)
654 err
= xs_error(xs_single(XBT_NIL
, XS_RESET_WATCHES
, "", NULL
));
655 if (err
&& err
!= -EEXIST
)
656 printk(KERN_WARNING
"xs_reset_watches failed: %d\n", err
);
659 /* Register callback to watch this node. */
660 int register_xenbus_watch(struct xenbus_watch
*watch
)
662 /* Pointer in ascii is the token. */
663 char token
[sizeof(watch
) * 2 + 1];
666 sprintf(token
, "%lX", (long)watch
);
668 down_read(&xs_state
.watch_mutex
);
670 spin_lock(&watches_lock
);
671 BUG_ON(find_watch(token
));
672 list_add(&watch
->list
, &watches
);
673 spin_unlock(&watches_lock
);
675 err
= xs_watch(watch
->node
, token
);
678 spin_lock(&watches_lock
);
679 list_del(&watch
->list
);
680 spin_unlock(&watches_lock
);
683 up_read(&xs_state
.watch_mutex
);
687 EXPORT_SYMBOL_GPL(register_xenbus_watch
);
689 void unregister_xenbus_watch(struct xenbus_watch
*watch
)
691 struct xs_stored_msg
*msg
, *tmp
;
692 char token
[sizeof(watch
) * 2 + 1];
695 sprintf(token
, "%lX", (long)watch
);
697 down_read(&xs_state
.watch_mutex
);
699 spin_lock(&watches_lock
);
700 BUG_ON(!find_watch(token
));
701 list_del(&watch
->list
);
702 spin_unlock(&watches_lock
);
704 err
= xs_unwatch(watch
->node
, token
);
707 "XENBUS Failed to release watch %s: %i\n",
710 up_read(&xs_state
.watch_mutex
);
712 /* Make sure there are no callbacks running currently (unless
714 if (current
->pid
!= xenwatch_pid
)
715 mutex_lock(&xenwatch_mutex
);
717 /* Cancel pending watch events. */
718 spin_lock(&watch_events_lock
);
719 list_for_each_entry_safe(msg
, tmp
, &watch_events
, list
) {
720 if (msg
->u
.watch
.handle
!= watch
)
722 list_del(&msg
->list
);
723 kfree(msg
->u
.watch
.vec
);
726 spin_unlock(&watch_events_lock
);
728 if (current
->pid
!= xenwatch_pid
)
729 mutex_unlock(&xenwatch_mutex
);
731 EXPORT_SYMBOL_GPL(unregister_xenbus_watch
);
733 void xs_suspend(void)
735 transaction_suspend();
736 down_write(&xs_state
.watch_mutex
);
737 mutex_lock(&xs_state
.request_mutex
);
738 mutex_lock(&xs_state
.response_mutex
);
743 struct xenbus_watch
*watch
;
744 char token
[sizeof(watch
) * 2 + 1];
748 mutex_unlock(&xs_state
.response_mutex
);
749 mutex_unlock(&xs_state
.request_mutex
);
750 transaction_resume();
752 /* No need for watches_lock: the watch_mutex is sufficient. */
753 list_for_each_entry(watch
, &watches
, list
) {
754 sprintf(token
, "%lX", (long)watch
);
755 xs_watch(watch
->node
, token
);
758 up_write(&xs_state
.watch_mutex
);
761 void xs_suspend_cancel(void)
763 mutex_unlock(&xs_state
.response_mutex
);
764 mutex_unlock(&xs_state
.request_mutex
);
765 up_write(&xs_state
.watch_mutex
);
766 mutex_unlock(&xs_state
.transaction_mutex
);
769 static int xenwatch_thread(void *unused
)
771 struct list_head
*ent
;
772 struct xs_stored_msg
*msg
;
775 wait_event_interruptible(watch_events_waitq
,
776 !list_empty(&watch_events
));
778 if (kthread_should_stop())
781 mutex_lock(&xenwatch_mutex
);
783 spin_lock(&watch_events_lock
);
784 ent
= watch_events
.next
;
785 if (ent
!= &watch_events
)
787 spin_unlock(&watch_events_lock
);
789 if (ent
!= &watch_events
) {
790 msg
= list_entry(ent
, struct xs_stored_msg
, list
);
791 msg
->u
.watch
.handle
->callback(
793 (const char **)msg
->u
.watch
.vec
,
794 msg
->u
.watch
.vec_size
);
795 kfree(msg
->u
.watch
.vec
);
799 mutex_unlock(&xenwatch_mutex
);
805 static int process_msg(void)
807 struct xs_stored_msg
*msg
;
812 * We must disallow save/restore while reading a xenstore message.
813 * A partial read across s/r leaves us out of sync with xenstored.
816 err
= xb_wait_for_data_to_read();
819 mutex_lock(&xs_state
.response_mutex
);
820 if (xb_data_to_read())
822 /* We raced with save/restore: pending data 'disappeared'. */
823 mutex_unlock(&xs_state
.response_mutex
);
827 msg
= kmalloc(sizeof(*msg
), GFP_NOIO
| __GFP_HIGH
);
833 err
= xb_read(&msg
->hdr
, sizeof(msg
->hdr
));
839 if (msg
->hdr
.len
> XENSTORE_PAYLOAD_MAX
) {
845 body
= kmalloc(msg
->hdr
.len
+ 1, GFP_NOIO
| __GFP_HIGH
);
852 err
= xb_read(body
, msg
->hdr
.len
);
858 body
[msg
->hdr
.len
] = '\0';
860 if (msg
->hdr
.type
== XS_WATCH_EVENT
) {
861 msg
->u
.watch
.vec
= split(body
, msg
->hdr
.len
,
862 &msg
->u
.watch
.vec_size
);
863 if (IS_ERR(msg
->u
.watch
.vec
)) {
864 err
= PTR_ERR(msg
->u
.watch
.vec
);
869 spin_lock(&watches_lock
);
870 msg
->u
.watch
.handle
= find_watch(
871 msg
->u
.watch
.vec
[XS_WATCH_TOKEN
]);
872 if (msg
->u
.watch
.handle
!= NULL
) {
873 spin_lock(&watch_events_lock
);
874 list_add_tail(&msg
->list
, &watch_events
);
875 wake_up(&watch_events_waitq
);
876 spin_unlock(&watch_events_lock
);
878 kfree(msg
->u
.watch
.vec
);
881 spin_unlock(&watches_lock
);
883 msg
->u
.reply
.body
= body
;
884 spin_lock(&xs_state
.reply_lock
);
885 list_add_tail(&msg
->list
, &xs_state
.reply_list
);
886 spin_unlock(&xs_state
.reply_lock
);
887 wake_up(&xs_state
.reply_waitq
);
891 mutex_unlock(&xs_state
.response_mutex
);
895 static int xenbus_thread(void *unused
)
902 printk(KERN_WARNING
"XENBUS error %d while reading "
904 if (kthread_should_stop())
914 struct task_struct
*task
;
916 INIT_LIST_HEAD(&xs_state
.reply_list
);
917 spin_lock_init(&xs_state
.reply_lock
);
918 init_waitqueue_head(&xs_state
.reply_waitq
);
920 mutex_init(&xs_state
.request_mutex
);
921 mutex_init(&xs_state
.response_mutex
);
922 mutex_init(&xs_state
.transaction_mutex
);
923 init_rwsem(&xs_state
.watch_mutex
);
924 atomic_set(&xs_state
.transaction_count
, 0);
925 init_waitqueue_head(&xs_state
.transaction_wq
);
927 /* Initialize the shared memory rings to talk to xenstored */
928 err
= xb_init_comms();
932 task
= kthread_run(xenwatch_thread
, NULL
, "xenwatch");
934 return PTR_ERR(task
);
935 xenwatch_pid
= task
->pid
;
937 task
= kthread_run(xenbus_thread
, NULL
, "xenbus");
939 return PTR_ERR(task
);
941 /* shutdown watches for kexec boot */