2 * Xen event channels (FIFO-based ABI)
4 * Copyright (C) 2013 Citrix Systems R&D ltd.
6 * This source code is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License as
8 * published by the Free Software Foundation; either version 2 of the
9 * License, or (at your option) any later version.
11 * Or, when distributed separately from the Linux kernel or
12 * incorporated into other software packages, subject to the following
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) "xen:" KBUILD_MODNAME ": " fmt
36 #include <linux/linkage.h>
37 #include <linux/interrupt.h>
38 #include <linux/irq.h>
39 #include <linux/smp.h>
40 #include <linux/percpu.h>
41 #include <linux/cpu.h>
43 #include <asm/barrier.h>
44 #include <asm/sync_bitops.h>
45 #include <asm/xen/hypercall.h>
46 #include <asm/xen/hypervisor.h>
49 #include <xen/xen-ops.h>
50 #include <xen/events.h>
51 #include <xen/interface/xen.h>
52 #include <xen/interface/event_channel.h>
55 #include "events_internal.h"
57 #define EVENT_WORDS_PER_PAGE (XEN_PAGE_SIZE / sizeof(event_word_t))
58 #define MAX_EVENT_ARRAY_PAGES (EVTCHN_FIFO_NR_CHANNELS / EVENT_WORDS_PER_PAGE)
60 struct evtchn_fifo_queue
{
61 uint32_t head
[EVTCHN_FIFO_MAX_QUEUES
];
64 static DEFINE_PER_CPU(struct evtchn_fifo_control_block
*, cpu_control_block
);
65 static DEFINE_PER_CPU(struct evtchn_fifo_queue
, cpu_queue
);
66 static event_word_t
*event_array
[MAX_EVENT_ARRAY_PAGES
] __read_mostly
;
67 static unsigned event_array_pages __read_mostly
;
70 * sync_set_bit() and friends must be unsigned long aligned.
72 #if BITS_PER_LONG > 32
74 #define BM(w) (unsigned long *)((unsigned long)w & ~0x7UL)
75 #define EVTCHN_FIFO_BIT(b, w) \
76 (((unsigned long)w & 0x4UL) ? (EVTCHN_FIFO_ ##b + 32) : EVTCHN_FIFO_ ##b)
80 #define BM(w) ((unsigned long *)(w))
81 #define EVTCHN_FIFO_BIT(b, w) EVTCHN_FIFO_ ##b
85 static inline event_word_t
*event_word_from_port(evtchn_port_t port
)
87 unsigned i
= port
/ EVENT_WORDS_PER_PAGE
;
89 return event_array
[i
] + port
% EVENT_WORDS_PER_PAGE
;
92 static unsigned evtchn_fifo_max_channels(void)
94 return EVTCHN_FIFO_NR_CHANNELS
;
97 static unsigned evtchn_fifo_nr_channels(void)
99 return event_array_pages
* EVENT_WORDS_PER_PAGE
;
102 static int init_control_block(int cpu
,
103 struct evtchn_fifo_control_block
*control_block
)
105 struct evtchn_fifo_queue
*q
= &per_cpu(cpu_queue
, cpu
);
106 struct evtchn_init_control init_control
;
109 /* Reset the control block and the local HEADs. */
110 clear_page(control_block
);
111 for (i
= 0; i
< EVTCHN_FIFO_MAX_QUEUES
; i
++)
114 init_control
.control_gfn
= virt_to_gfn(control_block
);
115 init_control
.offset
= 0;
116 init_control
.vcpu
= xen_vcpu_nr(cpu
);
118 return HYPERVISOR_event_channel_op(EVTCHNOP_init_control
, &init_control
);
121 static void free_unused_array_pages(void)
125 for (i
= event_array_pages
; i
< MAX_EVENT_ARRAY_PAGES
; i
++) {
128 free_page((unsigned long)event_array
[i
]);
129 event_array
[i
] = NULL
;
133 static void init_array_page(event_word_t
*array_page
)
137 for (i
= 0; i
< EVENT_WORDS_PER_PAGE
; i
++)
138 array_page
[i
] = 1 << EVTCHN_FIFO_MASKED
;
141 static int evtchn_fifo_setup(evtchn_port_t port
)
143 unsigned new_array_pages
;
146 new_array_pages
= port
/ EVENT_WORDS_PER_PAGE
+ 1;
148 if (new_array_pages
> MAX_EVENT_ARRAY_PAGES
)
151 while (event_array_pages
< new_array_pages
) {
153 struct evtchn_expand_array expand_array
;
155 /* Might already have a page if we've resumed. */
156 array_page
= event_array
[event_array_pages
];
158 array_page
= (void *)__get_free_page(GFP_KERNEL
);
159 if (array_page
== NULL
) {
163 event_array
[event_array_pages
] = array_page
;
166 /* Mask all events in this page before adding it. */
167 init_array_page(array_page
);
169 expand_array
.array_gfn
= virt_to_gfn(array_page
);
171 ret
= HYPERVISOR_event_channel_op(EVTCHNOP_expand_array
, &expand_array
);
180 if (event_array_pages
== 0)
181 panic("xen: unable to expand event array with initial page (%d)\n", ret
);
183 pr_err("unable to expand event array (%d)\n", ret
);
184 free_unused_array_pages();
188 static void evtchn_fifo_bind_to_cpu(evtchn_port_t evtchn
, unsigned int cpu
,
189 unsigned int old_cpu
)
194 static void evtchn_fifo_clear_pending(evtchn_port_t port
)
196 event_word_t
*word
= event_word_from_port(port
);
197 sync_clear_bit(EVTCHN_FIFO_BIT(PENDING
, word
), BM(word
));
200 static void evtchn_fifo_set_pending(evtchn_port_t port
)
202 event_word_t
*word
= event_word_from_port(port
);
203 sync_set_bit(EVTCHN_FIFO_BIT(PENDING
, word
), BM(word
));
206 static bool evtchn_fifo_is_pending(evtchn_port_t port
)
208 event_word_t
*word
= event_word_from_port(port
);
209 return sync_test_bit(EVTCHN_FIFO_BIT(PENDING
, word
), BM(word
));
212 static bool evtchn_fifo_test_and_set_mask(evtchn_port_t port
)
214 event_word_t
*word
= event_word_from_port(port
);
215 return sync_test_and_set_bit(EVTCHN_FIFO_BIT(MASKED
, word
), BM(word
));
218 static void evtchn_fifo_mask(evtchn_port_t port
)
220 event_word_t
*word
= event_word_from_port(port
);
221 sync_set_bit(EVTCHN_FIFO_BIT(MASKED
, word
), BM(word
));
224 static bool evtchn_fifo_is_masked(evtchn_port_t port
)
226 event_word_t
*word
= event_word_from_port(port
);
227 return sync_test_bit(EVTCHN_FIFO_BIT(MASKED
, word
), BM(word
));
230 * Clear MASKED if not PENDING, spinning if BUSY is set.
231 * Return true if mask was cleared.
233 static bool clear_masked_cond(volatile event_word_t
*word
)
235 event_word_t
new, old
, w
;
240 if (!(w
& (1 << EVTCHN_FIFO_MASKED
)))
243 if (w
& (1 << EVTCHN_FIFO_PENDING
))
246 old
= w
& ~(1 << EVTCHN_FIFO_BUSY
);
247 new = old
& ~(1 << EVTCHN_FIFO_MASKED
);
248 w
= sync_cmpxchg(word
, old
, new);
254 static void evtchn_fifo_unmask(evtchn_port_t port
)
256 event_word_t
*word
= event_word_from_port(port
);
258 BUG_ON(!irqs_disabled());
260 if (!clear_masked_cond(word
)) {
261 struct evtchn_unmask unmask
= { .port
= port
};
262 (void)HYPERVISOR_event_channel_op(EVTCHNOP_unmask
, &unmask
);
266 static uint32_t clear_linked(volatile event_word_t
*word
)
268 event_word_t
new, old
, w
;
274 new = (w
& ~((1 << EVTCHN_FIFO_LINKED
)
275 | EVTCHN_FIFO_LINK_MASK
));
276 } while ((w
= sync_cmpxchg(word
, old
, new)) != old
);
278 return w
& EVTCHN_FIFO_LINK_MASK
;
281 static void consume_one_event(unsigned cpu
, struct evtchn_loop_ctrl
*ctrl
,
282 struct evtchn_fifo_control_block
*control_block
,
283 unsigned priority
, unsigned long *ready
)
285 struct evtchn_fifo_queue
*q
= &per_cpu(cpu_queue
, cpu
);
290 head
= q
->head
[priority
];
293 * Reached the tail last time? Read the new HEAD from the
297 virt_rmb(); /* Ensure word is up-to-date before reading head. */
298 head
= control_block
->head
[priority
];
302 word
= event_word_from_port(port
);
303 head
= clear_linked(word
);
306 * If the link is non-zero, there are more events in the
307 * queue, otherwise the queue is empty.
309 * If the queue is empty, clear this priority from our local
310 * copy of the ready word.
313 clear_bit(priority
, ready
);
315 if (evtchn_fifo_is_pending(port
) && !evtchn_fifo_is_masked(port
)) {
317 pr_warn("Dropping pending event for port %u\n", port
);
319 handle_irq_for_port(port
, ctrl
);
322 q
->head
[priority
] = head
;
325 static void __evtchn_fifo_handle_events(unsigned cpu
,
326 struct evtchn_loop_ctrl
*ctrl
)
328 struct evtchn_fifo_control_block
*control_block
;
332 control_block
= per_cpu(cpu_control_block
, cpu
);
334 ready
= xchg(&control_block
->ready
, 0);
337 q
= find_first_bit(&ready
, EVTCHN_FIFO_MAX_QUEUES
);
338 consume_one_event(cpu
, ctrl
, control_block
, q
, &ready
);
339 ready
|= xchg(&control_block
->ready
, 0);
343 static void evtchn_fifo_handle_events(unsigned cpu
,
344 struct evtchn_loop_ctrl
*ctrl
)
346 __evtchn_fifo_handle_events(cpu
, ctrl
);
349 static void evtchn_fifo_resume(void)
353 for_each_possible_cpu(cpu
) {
354 void *control_block
= per_cpu(cpu_control_block
, cpu
);
361 * If this CPU is offline, take the opportunity to
362 * free the control block while it is not being
365 if (!cpu_online(cpu
)) {
366 free_page((unsigned long)control_block
);
367 per_cpu(cpu_control_block
, cpu
) = NULL
;
371 ret
= init_control_block(cpu
, control_block
);
376 * The event array starts out as empty again and is extended
377 * as normal when events are bound. The existing pages will
380 event_array_pages
= 0;
383 static int evtchn_fifo_alloc_control_block(unsigned cpu
)
385 void *control_block
= NULL
;
388 control_block
= (void *)__get_free_page(GFP_KERNEL
);
389 if (control_block
== NULL
)
392 ret
= init_control_block(cpu
, control_block
);
396 per_cpu(cpu_control_block
, cpu
) = control_block
;
401 free_page((unsigned long)control_block
);
405 static int evtchn_fifo_percpu_init(unsigned int cpu
)
407 if (!per_cpu(cpu_control_block
, cpu
))
408 return evtchn_fifo_alloc_control_block(cpu
);
412 static int evtchn_fifo_percpu_deinit(unsigned int cpu
)
414 __evtchn_fifo_handle_events(cpu
, NULL
);
418 static const struct evtchn_ops evtchn_ops_fifo
= {
419 .max_channels
= evtchn_fifo_max_channels
,
420 .nr_channels
= evtchn_fifo_nr_channels
,
421 .setup
= evtchn_fifo_setup
,
422 .bind_to_cpu
= evtchn_fifo_bind_to_cpu
,
423 .clear_pending
= evtchn_fifo_clear_pending
,
424 .set_pending
= evtchn_fifo_set_pending
,
425 .is_pending
= evtchn_fifo_is_pending
,
426 .test_and_set_mask
= evtchn_fifo_test_and_set_mask
,
427 .mask
= evtchn_fifo_mask
,
428 .unmask
= evtchn_fifo_unmask
,
429 .handle_events
= evtchn_fifo_handle_events
,
430 .resume
= evtchn_fifo_resume
,
431 .percpu_init
= evtchn_fifo_percpu_init
,
432 .percpu_deinit
= evtchn_fifo_percpu_deinit
,
435 int __init
xen_evtchn_fifo_init(void)
437 int cpu
= smp_processor_id();
440 ret
= evtchn_fifo_alloc_control_block(cpu
);
444 pr_info("Using FIFO-based ABI\n");
446 evtchn_ops
= &evtchn_ops_fifo
;