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 void evtchn_fifo_mask(evtchn_port_t port
)
214 event_word_t
*word
= event_word_from_port(port
);
215 sync_set_bit(EVTCHN_FIFO_BIT(MASKED
, word
), BM(word
));
218 static bool evtchn_fifo_is_masked(evtchn_port_t port
)
220 event_word_t
*word
= event_word_from_port(port
);
221 return sync_test_bit(EVTCHN_FIFO_BIT(MASKED
, word
), BM(word
));
224 * Clear MASKED if not PENDING, spinning if BUSY is set.
225 * Return true if mask was cleared.
227 static bool clear_masked_cond(volatile event_word_t
*word
)
229 event_word_t
new, old
;
234 if (!(old
& (1 << EVTCHN_FIFO_MASKED
)))
237 if (old
& (1 << EVTCHN_FIFO_PENDING
))
240 old
= old
& ~(1 << EVTCHN_FIFO_BUSY
);
241 new = old
& ~(1 << EVTCHN_FIFO_MASKED
);
242 } while (!sync_try_cmpxchg(word
, &old
, new));
247 static void evtchn_fifo_unmask(evtchn_port_t port
)
249 event_word_t
*word
= event_word_from_port(port
);
251 BUG_ON(!irqs_disabled());
253 if (!clear_masked_cond(word
)) {
254 struct evtchn_unmask unmask
= { .port
= port
};
255 (void)HYPERVISOR_event_channel_op(EVTCHNOP_unmask
, &unmask
);
259 static uint32_t clear_linked(volatile event_word_t
*word
)
261 event_word_t
new, old
;
266 new = (old
& ~((1 << EVTCHN_FIFO_LINKED
)
267 | EVTCHN_FIFO_LINK_MASK
));
268 } while (!sync_try_cmpxchg(word
, &old
, new));
270 return old
& EVTCHN_FIFO_LINK_MASK
;
273 static void consume_one_event(unsigned cpu
, struct evtchn_loop_ctrl
*ctrl
,
274 struct evtchn_fifo_control_block
*control_block
,
275 unsigned priority
, unsigned long *ready
)
277 struct evtchn_fifo_queue
*q
= &per_cpu(cpu_queue
, cpu
);
282 head
= q
->head
[priority
];
285 * Reached the tail last time? Read the new HEAD from the
289 virt_rmb(); /* Ensure word is up-to-date before reading head. */
290 head
= control_block
->head
[priority
];
294 word
= event_word_from_port(port
);
295 head
= clear_linked(word
);
298 * If the link is non-zero, there are more events in the
299 * queue, otherwise the queue is empty.
301 * If the queue is empty, clear this priority from our local
302 * copy of the ready word.
305 clear_bit(priority
, ready
);
307 if (evtchn_fifo_is_pending(port
) && !evtchn_fifo_is_masked(port
)) {
309 pr_warn("Dropping pending event for port %u\n", port
);
311 handle_irq_for_port(port
, ctrl
);
314 q
->head
[priority
] = head
;
317 static void __evtchn_fifo_handle_events(unsigned cpu
,
318 struct evtchn_loop_ctrl
*ctrl
)
320 struct evtchn_fifo_control_block
*control_block
;
324 control_block
= per_cpu(cpu_control_block
, cpu
);
326 ready
= xchg(&control_block
->ready
, 0);
329 q
= find_first_bit(&ready
, EVTCHN_FIFO_MAX_QUEUES
);
330 consume_one_event(cpu
, ctrl
, control_block
, q
, &ready
);
331 ready
|= xchg(&control_block
->ready
, 0);
335 static void evtchn_fifo_handle_events(unsigned cpu
,
336 struct evtchn_loop_ctrl
*ctrl
)
338 __evtchn_fifo_handle_events(cpu
, ctrl
);
341 static void evtchn_fifo_resume(void)
345 for_each_possible_cpu(cpu
) {
346 void *control_block
= per_cpu(cpu_control_block
, cpu
);
353 * If this CPU is offline, take the opportunity to
354 * free the control block while it is not being
357 if (!cpu_online(cpu
)) {
358 free_page((unsigned long)control_block
);
359 per_cpu(cpu_control_block
, cpu
) = NULL
;
363 ret
= init_control_block(cpu
, control_block
);
368 * The event array starts out as empty again and is extended
369 * as normal when events are bound. The existing pages will
372 event_array_pages
= 0;
375 static int evtchn_fifo_alloc_control_block(unsigned cpu
)
377 void *control_block
= NULL
;
380 control_block
= (void *)__get_free_page(GFP_KERNEL
);
381 if (control_block
== NULL
)
384 ret
= init_control_block(cpu
, control_block
);
388 per_cpu(cpu_control_block
, cpu
) = control_block
;
393 free_page((unsigned long)control_block
);
397 static int evtchn_fifo_percpu_init(unsigned int cpu
)
399 if (!per_cpu(cpu_control_block
, cpu
))
400 return evtchn_fifo_alloc_control_block(cpu
);
404 static int evtchn_fifo_percpu_deinit(unsigned int cpu
)
406 __evtchn_fifo_handle_events(cpu
, NULL
);
410 static const struct evtchn_ops evtchn_ops_fifo
= {
411 .max_channels
= evtchn_fifo_max_channels
,
412 .nr_channels
= evtchn_fifo_nr_channels
,
413 .setup
= evtchn_fifo_setup
,
414 .bind_to_cpu
= evtchn_fifo_bind_to_cpu
,
415 .clear_pending
= evtchn_fifo_clear_pending
,
416 .set_pending
= evtchn_fifo_set_pending
,
417 .is_pending
= evtchn_fifo_is_pending
,
418 .mask
= evtchn_fifo_mask
,
419 .unmask
= evtchn_fifo_unmask
,
420 .handle_events
= evtchn_fifo_handle_events
,
421 .resume
= evtchn_fifo_resume
,
422 .percpu_init
= evtchn_fifo_percpu_init
,
423 .percpu_deinit
= evtchn_fifo_percpu_deinit
,
426 int __init
xen_evtchn_fifo_init(void)
428 int cpu
= smp_processor_id();
431 ret
= evtchn_fifo_alloc_control_block(cpu
);
435 pr_info("Using FIFO-based ABI\n");
437 evtchn_ops
= &evtchn_ops_fifo
;