xref: /openbmc/qemu/hw/ppc/spapr_irq.c (revision 14789694cd1ba57b1d548451b8b7630e888d679f)
1 /*
2  * QEMU PowerPC sPAPR IRQ interface
3  *
4  * Copyright (c) 2018, IBM Corporation.
5  *
6  * This code is licensed under the GPL version 2 or later. See the
7  * COPYING file in the top-level directory.
8  */
9 
10 #include "qemu/osdep.h"
11 #include "qemu/log.h"
12 #include "qemu/error-report.h"
13 #include "qapi/error.h"
14 #include "hw/irq.h"
15 #include "hw/ppc/spapr.h"
16 #include "hw/ppc/spapr_cpu_core.h"
17 #include "hw/ppc/spapr_xive.h"
18 #include "hw/ppc/xics.h"
19 #include "hw/ppc/xics_spapr.h"
20 #include "hw/qdev-properties.h"
21 #include "cpu-models.h"
22 #include "sysemu/kvm.h"
23 
24 #include "trace.h"
25 
26 void spapr_irq_msi_init(SpaprMachineState *spapr, uint32_t nr_msis)
27 {
28     spapr->irq_map_nr = nr_msis;
29     spapr->irq_map = bitmap_new(spapr->irq_map_nr);
30 }
31 
32 int spapr_irq_msi_alloc(SpaprMachineState *spapr, uint32_t num, bool align,
33                         Error **errp)
34 {
35     int irq;
36 
37     /*
38      * The 'align_mask' parameter of bitmap_find_next_zero_area()
39      * should be one less than a power of 2; 0 means no
40      * alignment. Adapt the 'align' value of the former allocator
41      * to fit the requirements of bitmap_find_next_zero_area()
42      */
43     align -= 1;
44 
45     irq = bitmap_find_next_zero_area(spapr->irq_map, spapr->irq_map_nr, 0, num,
46                                      align);
47     if (irq == spapr->irq_map_nr) {
48         error_setg(errp, "can't find a free %d-IRQ block", num);
49         return -1;
50     }
51 
52     bitmap_set(spapr->irq_map, irq, num);
53 
54     return irq + SPAPR_IRQ_MSI;
55 }
56 
57 void spapr_irq_msi_free(SpaprMachineState *spapr, int irq, uint32_t num)
58 {
59     bitmap_clear(spapr->irq_map, irq - SPAPR_IRQ_MSI, num);
60 }
61 
62 static void spapr_irq_init_kvm(SpaprMachineState *spapr,
63                                   SpaprIrq *irq, Error **errp)
64 {
65     MachineState *machine = MACHINE(spapr);
66     Error *local_err = NULL;
67 
68     if (kvm_enabled() && machine_kernel_irqchip_allowed(machine)) {
69         irq->init_kvm(spapr, &local_err);
70         if (local_err && machine_kernel_irqchip_required(machine)) {
71             error_prepend(&local_err,
72                           "kernel_irqchip requested but unavailable: ");
73             error_propagate(errp, local_err);
74             return;
75         }
76 
77         if (!local_err) {
78             return;
79         }
80 
81         /*
82          * We failed to initialize the KVM device, fallback to
83          * emulated mode
84          */
85         error_prepend(&local_err, "kernel_irqchip allowed but unavailable: ");
86         error_append_hint(&local_err, "Falling back to kernel-irqchip=off\n");
87         warn_report_err(local_err);
88     }
89 }
90 
91 /*
92  * XICS IRQ backend.
93  */
94 
95 static void spapr_irq_init_xics(SpaprMachineState *spapr, Error **errp)
96 {
97     Object *obj;
98     Error *local_err = NULL;
99 
100     obj = object_new(TYPE_ICS_SPAPR);
101     object_property_add_child(OBJECT(spapr), "ics", obj, &error_abort);
102     object_property_add_const_link(obj, ICS_PROP_XICS, OBJECT(spapr),
103                                    &error_fatal);
104     object_property_set_int(obj, spapr->irq->nr_xirqs,
105                             "nr-irqs",  &error_fatal);
106     object_property_set_bool(obj, true, "realized", &local_err);
107     if (local_err) {
108         error_propagate(errp, local_err);
109         return;
110     }
111 
112     spapr->ics = ICS_SPAPR(obj);
113 }
114 
115 static int spapr_irq_claim_xics(SpaprMachineState *spapr, int irq, bool lsi,
116                                 Error **errp)
117 {
118     ICSState *ics = spapr->ics;
119 
120     assert(ics);
121 
122     if (!ics_valid_irq(ics, irq)) {
123         error_setg(errp, "IRQ %d is invalid", irq);
124         return -1;
125     }
126 
127     if (!ics_irq_free(ics, irq - ics->offset)) {
128         error_setg(errp, "IRQ %d is not free", irq);
129         return -1;
130     }
131 
132     ics_set_irq_type(ics, irq - ics->offset, lsi);
133     return 0;
134 }
135 
136 static void spapr_irq_free_xics(SpaprMachineState *spapr, int irq, int num)
137 {
138     ICSState *ics = spapr->ics;
139     uint32_t srcno = irq - ics->offset;
140     int i;
141 
142     if (ics_valid_irq(ics, irq)) {
143         trace_spapr_irq_free(0, irq, num);
144         for (i = srcno; i < srcno + num; ++i) {
145             if (ics_irq_free(ics, i)) {
146                 trace_spapr_irq_free_warn(0, i);
147             }
148             memset(&ics->irqs[i], 0, sizeof(ICSIRQState));
149         }
150     }
151 }
152 
153 static void spapr_irq_print_info_xics(SpaprMachineState *spapr, Monitor *mon)
154 {
155     CPUState *cs;
156 
157     CPU_FOREACH(cs) {
158         PowerPCCPU *cpu = POWERPC_CPU(cs);
159 
160         icp_pic_print_info(spapr_cpu_state(cpu)->icp, mon);
161     }
162 
163     ics_pic_print_info(spapr->ics, mon);
164 }
165 
166 static void spapr_irq_cpu_intc_create_xics(SpaprMachineState *spapr,
167                                            PowerPCCPU *cpu, Error **errp)
168 {
169     Error *local_err = NULL;
170     Object *obj;
171     SpaprCpuState *spapr_cpu = spapr_cpu_state(cpu);
172 
173     obj = icp_create(OBJECT(cpu), TYPE_ICP, XICS_FABRIC(spapr),
174                      &local_err);
175     if (local_err) {
176         error_propagate(errp, local_err);
177         return;
178     }
179 
180     spapr_cpu->icp = ICP(obj);
181 }
182 
183 static int spapr_irq_post_load_xics(SpaprMachineState *spapr, int version_id)
184 {
185     if (!kvm_irqchip_in_kernel()) {
186         CPUState *cs;
187         CPU_FOREACH(cs) {
188             PowerPCCPU *cpu = POWERPC_CPU(cs);
189             icp_resend(spapr_cpu_state(cpu)->icp);
190         }
191     }
192     return 0;
193 }
194 
195 static void spapr_irq_set_irq_xics(void *opaque, int irq, int val)
196 {
197     SpaprMachineState *spapr = opaque;
198     uint32_t srcno = irq - spapr->ics->offset;
199 
200     ics_set_irq(spapr->ics, srcno, val);
201 }
202 
203 static void spapr_irq_reset_xics(SpaprMachineState *spapr, Error **errp)
204 {
205     Error *local_err = NULL;
206 
207     spapr_irq_init_kvm(spapr, &spapr_irq_xics, &local_err);
208     if (local_err) {
209         error_propagate(errp, local_err);
210         return;
211     }
212 }
213 
214 static void spapr_irq_init_kvm_xics(SpaprMachineState *spapr, Error **errp)
215 {
216     if (kvm_enabled()) {
217         xics_kvm_connect(spapr, errp);
218     }
219 }
220 
221 SpaprIrq spapr_irq_xics = {
222     .nr_xirqs    = SPAPR_NR_XIRQS,
223     .nr_msis     = SPAPR_NR_MSIS,
224     .ov5         = SPAPR_OV5_XIVE_LEGACY,
225 
226     .init        = spapr_irq_init_xics,
227     .claim       = spapr_irq_claim_xics,
228     .free        = spapr_irq_free_xics,
229     .print_info  = spapr_irq_print_info_xics,
230     .dt_populate = spapr_dt_xics,
231     .cpu_intc_create = spapr_irq_cpu_intc_create_xics,
232     .post_load   = spapr_irq_post_load_xics,
233     .reset       = spapr_irq_reset_xics,
234     .set_irq     = spapr_irq_set_irq_xics,
235     .init_kvm    = spapr_irq_init_kvm_xics,
236 };
237 
238 /*
239  * XIVE IRQ backend.
240  */
241 static void spapr_irq_init_xive(SpaprMachineState *spapr, Error **errp)
242 {
243     uint32_t nr_servers = spapr_max_server_number(spapr);
244     DeviceState *dev;
245     int i;
246 
247     dev = qdev_create(NULL, TYPE_SPAPR_XIVE);
248     qdev_prop_set_uint32(dev, "nr-irqs",
249                          spapr->irq->nr_xirqs + SPAPR_XIRQ_BASE);
250     /*
251      * 8 XIVE END structures per CPU. One for each available priority
252      */
253     qdev_prop_set_uint32(dev, "nr-ends", nr_servers << 3);
254     qdev_init_nofail(dev);
255 
256     spapr->xive = SPAPR_XIVE(dev);
257 
258     /* Enable the CPU IPIs */
259     for (i = 0; i < nr_servers; ++i) {
260         spapr_xive_irq_claim(spapr->xive, SPAPR_IRQ_IPI + i, false);
261     }
262 
263     spapr_xive_hcall_init(spapr);
264 }
265 
266 static int spapr_irq_claim_xive(SpaprMachineState *spapr, int irq, bool lsi,
267                                 Error **errp)
268 {
269     if (!spapr_xive_irq_claim(spapr->xive, irq, lsi)) {
270         error_setg(errp, "IRQ %d is invalid", irq);
271         return -1;
272     }
273     return 0;
274 }
275 
276 static void spapr_irq_free_xive(SpaprMachineState *spapr, int irq, int num)
277 {
278     int i;
279 
280     for (i = irq; i < irq + num; ++i) {
281         spapr_xive_irq_free(spapr->xive, i);
282     }
283 }
284 
285 static void spapr_irq_print_info_xive(SpaprMachineState *spapr,
286                                       Monitor *mon)
287 {
288     CPUState *cs;
289 
290     CPU_FOREACH(cs) {
291         PowerPCCPU *cpu = POWERPC_CPU(cs);
292 
293         xive_tctx_pic_print_info(spapr_cpu_state(cpu)->tctx, mon);
294     }
295 
296     spapr_xive_pic_print_info(spapr->xive, mon);
297 }
298 
299 static void spapr_irq_cpu_intc_create_xive(SpaprMachineState *spapr,
300                                            PowerPCCPU *cpu, Error **errp)
301 {
302     Error *local_err = NULL;
303     Object *obj;
304     SpaprCpuState *spapr_cpu = spapr_cpu_state(cpu);
305 
306     obj = xive_tctx_create(OBJECT(cpu), XIVE_ROUTER(spapr->xive), &local_err);
307     if (local_err) {
308         error_propagate(errp, local_err);
309         return;
310     }
311 
312     spapr_cpu->tctx = XIVE_TCTX(obj);
313 
314     /*
315      * (TCG) Early setting the OS CAM line for hotplugged CPUs as they
316      * don't beneficiate from the reset of the XIVE IRQ backend
317      */
318     spapr_xive_set_tctx_os_cam(spapr_cpu->tctx);
319 }
320 
321 static int spapr_irq_post_load_xive(SpaprMachineState *spapr, int version_id)
322 {
323     return spapr_xive_post_load(spapr->xive, version_id);
324 }
325 
326 static void spapr_irq_reset_xive(SpaprMachineState *spapr, Error **errp)
327 {
328     CPUState *cs;
329     Error *local_err = NULL;
330 
331     CPU_FOREACH(cs) {
332         PowerPCCPU *cpu = POWERPC_CPU(cs);
333 
334         /* (TCG) Set the OS CAM line of the thread interrupt context. */
335         spapr_xive_set_tctx_os_cam(spapr_cpu_state(cpu)->tctx);
336     }
337 
338     spapr_irq_init_kvm(spapr, &spapr_irq_xive, &local_err);
339     if (local_err) {
340         error_propagate(errp, local_err);
341         return;
342     }
343 
344     /* Activate the XIVE MMIOs */
345     spapr_xive_mmio_set_enabled(spapr->xive, true);
346 }
347 
348 static void spapr_irq_set_irq_xive(void *opaque, int irq, int val)
349 {
350     SpaprMachineState *spapr = opaque;
351 
352     if (kvm_irqchip_in_kernel()) {
353         kvmppc_xive_source_set_irq(&spapr->xive->source, irq, val);
354     } else {
355         xive_source_set_irq(&spapr->xive->source, irq, val);
356     }
357 }
358 
359 static void spapr_irq_init_kvm_xive(SpaprMachineState *spapr, Error **errp)
360 {
361     if (kvm_enabled()) {
362         kvmppc_xive_connect(spapr->xive, errp);
363     }
364 }
365 
366 SpaprIrq spapr_irq_xive = {
367     .nr_xirqs    = SPAPR_NR_XIRQS,
368     .nr_msis     = SPAPR_NR_MSIS,
369     .ov5         = SPAPR_OV5_XIVE_EXPLOIT,
370 
371     .init        = spapr_irq_init_xive,
372     .claim       = spapr_irq_claim_xive,
373     .free        = spapr_irq_free_xive,
374     .print_info  = spapr_irq_print_info_xive,
375     .dt_populate = spapr_dt_xive,
376     .cpu_intc_create = spapr_irq_cpu_intc_create_xive,
377     .post_load   = spapr_irq_post_load_xive,
378     .reset       = spapr_irq_reset_xive,
379     .set_irq     = spapr_irq_set_irq_xive,
380     .init_kvm    = spapr_irq_init_kvm_xive,
381 };
382 
383 /*
384  * Dual XIVE and XICS IRQ backend.
385  *
386  * Both interrupt mode, XIVE and XICS, objects are created but the
387  * machine starts in legacy interrupt mode (XICS). It can be changed
388  * by the CAS negotiation process and, in that case, the new mode is
389  * activated after an extra machine reset.
390  */
391 
392 /*
393  * Returns the sPAPR IRQ backend negotiated by CAS. XICS is the
394  * default.
395  */
396 static SpaprIrq *spapr_irq_current(SpaprMachineState *spapr)
397 {
398     return spapr_ovec_test(spapr->ov5_cas, OV5_XIVE_EXPLOIT) ?
399         &spapr_irq_xive : &spapr_irq_xics;
400 }
401 
402 static void spapr_irq_init_dual(SpaprMachineState *spapr, Error **errp)
403 {
404     Error *local_err = NULL;
405 
406     spapr_irq_xics.init(spapr, &local_err);
407     if (local_err) {
408         error_propagate(errp, local_err);
409         return;
410     }
411 
412     spapr_irq_xive.init(spapr, &local_err);
413     if (local_err) {
414         error_propagate(errp, local_err);
415         return;
416     }
417 }
418 
419 static int spapr_irq_claim_dual(SpaprMachineState *spapr, int irq, bool lsi,
420                                 Error **errp)
421 {
422     Error *local_err = NULL;
423     int ret;
424 
425     ret = spapr_irq_xics.claim(spapr, irq, lsi, &local_err);
426     if (local_err) {
427         error_propagate(errp, local_err);
428         return ret;
429     }
430 
431     ret = spapr_irq_xive.claim(spapr, irq, lsi, &local_err);
432     if (local_err) {
433         error_propagate(errp, local_err);
434         return ret;
435     }
436 
437     return ret;
438 }
439 
440 static void spapr_irq_free_dual(SpaprMachineState *spapr, int irq, int num)
441 {
442     spapr_irq_xics.free(spapr, irq, num);
443     spapr_irq_xive.free(spapr, irq, num);
444 }
445 
446 static void spapr_irq_print_info_dual(SpaprMachineState *spapr, Monitor *mon)
447 {
448     spapr_irq_current(spapr)->print_info(spapr, mon);
449 }
450 
451 static void spapr_irq_dt_populate_dual(SpaprMachineState *spapr,
452                                        uint32_t nr_servers, void *fdt,
453                                        uint32_t phandle)
454 {
455     spapr_irq_current(spapr)->dt_populate(spapr, nr_servers, fdt, phandle);
456 }
457 
458 static void spapr_irq_cpu_intc_create_dual(SpaprMachineState *spapr,
459                                            PowerPCCPU *cpu, Error **errp)
460 {
461     Error *local_err = NULL;
462 
463     spapr_irq_xive.cpu_intc_create(spapr, cpu, &local_err);
464     if (local_err) {
465         error_propagate(errp, local_err);
466         return;
467     }
468 
469     spapr_irq_xics.cpu_intc_create(spapr, cpu, errp);
470 }
471 
472 static int spapr_irq_post_load_dual(SpaprMachineState *spapr, int version_id)
473 {
474     /*
475      * Force a reset of the XIVE backend after migration. The machine
476      * defaults to XICS at startup.
477      */
478     if (spapr_ovec_test(spapr->ov5_cas, OV5_XIVE_EXPLOIT)) {
479         if (kvm_irqchip_in_kernel()) {
480             xics_kvm_disconnect(spapr, &error_fatal);
481         }
482         spapr_irq_xive.reset(spapr, &error_fatal);
483     }
484 
485     return spapr_irq_current(spapr)->post_load(spapr, version_id);
486 }
487 
488 static void spapr_irq_reset_dual(SpaprMachineState *spapr, Error **errp)
489 {
490     Error *local_err = NULL;
491 
492     /*
493      * Deactivate the XIVE MMIOs. The XIVE backend will reenable them
494      * if selected.
495      */
496     spapr_xive_mmio_set_enabled(spapr->xive, false);
497 
498     /* Destroy all KVM devices */
499     if (kvm_irqchip_in_kernel()) {
500         xics_kvm_disconnect(spapr, &local_err);
501         if (local_err) {
502             error_propagate(errp, local_err);
503             error_prepend(errp, "KVM XICS disconnect failed: ");
504             return;
505         }
506         kvmppc_xive_disconnect(spapr->xive, &local_err);
507         if (local_err) {
508             error_propagate(errp, local_err);
509             error_prepend(errp, "KVM XIVE disconnect failed: ");
510             return;
511         }
512     }
513 
514     spapr_irq_current(spapr)->reset(spapr, errp);
515 }
516 
517 static void spapr_irq_set_irq_dual(void *opaque, int irq, int val)
518 {
519     SpaprMachineState *spapr = opaque;
520 
521     spapr_irq_current(spapr)->set_irq(spapr, irq, val);
522 }
523 
524 /*
525  * Define values in sync with the XIVE and XICS backend
526  */
527 SpaprIrq spapr_irq_dual = {
528     .nr_xirqs    = SPAPR_NR_XIRQS,
529     .nr_msis     = SPAPR_NR_MSIS,
530     .ov5         = SPAPR_OV5_XIVE_BOTH,
531 
532     .init        = spapr_irq_init_dual,
533     .claim       = spapr_irq_claim_dual,
534     .free        = spapr_irq_free_dual,
535     .print_info  = spapr_irq_print_info_dual,
536     .dt_populate = spapr_irq_dt_populate_dual,
537     .cpu_intc_create = spapr_irq_cpu_intc_create_dual,
538     .post_load   = spapr_irq_post_load_dual,
539     .reset       = spapr_irq_reset_dual,
540     .set_irq     = spapr_irq_set_irq_dual,
541     .init_kvm    = NULL, /* should not be used */
542 };
543 
544 
545 static void spapr_irq_check(SpaprMachineState *spapr, Error **errp)
546 {
547     MachineState *machine = MACHINE(spapr);
548 
549     /*
550      * Sanity checks on non-P9 machines. On these, XIVE is not
551      * advertised, see spapr_dt_ov5_platform_support()
552      */
553     if (!ppc_type_check_compat(machine->cpu_type, CPU_POWERPC_LOGICAL_3_00,
554                                0, spapr->max_compat_pvr)) {
555         /*
556          * If the 'dual' interrupt mode is selected, force XICS as CAS
557          * negotiation is useless.
558          */
559         if (spapr->irq == &spapr_irq_dual) {
560             spapr->irq = &spapr_irq_xics;
561             return;
562         }
563 
564         /*
565          * Non-P9 machines using only XIVE is a bogus setup. We have two
566          * scenarios to take into account because of the compat mode:
567          *
568          * 1. POWER7/8 machines should fail to init later on when creating
569          *    the XIVE interrupt presenters because a POWER9 exception
570          *    model is required.
571 
572          * 2. POWER9 machines using the POWER8 compat mode won't fail and
573          *    will let the OS boot with a partial XIVE setup : DT
574          *    properties but no hcalls.
575          *
576          * To cover both and not confuse the OS, add an early failure in
577          * QEMU.
578          */
579         if (spapr->irq == &spapr_irq_xive) {
580             error_setg(errp, "XIVE-only machines require a POWER9 CPU");
581             return;
582         }
583     }
584 
585     /*
586      * On a POWER9 host, some older KVM XICS devices cannot be destroyed and
587      * re-created. Detect that early to avoid QEMU to exit later when the
588      * guest reboots.
589      */
590     if (kvm_enabled() &&
591         spapr->irq == &spapr_irq_dual &&
592         machine_kernel_irqchip_required(machine) &&
593         xics_kvm_has_broken_disconnect(spapr)) {
594         error_setg(errp, "KVM is too old to support ic-mode=dual,kernel-irqchip=on");
595         return;
596     }
597 }
598 
599 /*
600  * sPAPR IRQ frontend routines for devices
601  */
602 void spapr_irq_init(SpaprMachineState *spapr, Error **errp)
603 {
604     MachineState *machine = MACHINE(spapr);
605     Error *local_err = NULL;
606 
607     if (machine_kernel_irqchip_split(machine)) {
608         error_setg(errp, "kernel_irqchip split mode not supported on pseries");
609         return;
610     }
611 
612     if (!kvm_enabled() && machine_kernel_irqchip_required(machine)) {
613         error_setg(errp,
614                    "kernel_irqchip requested but only available with KVM");
615         return;
616     }
617 
618     spapr_irq_check(spapr, &local_err);
619     if (local_err) {
620         error_propagate(errp, local_err);
621         return;
622     }
623 
624     /* Initialize the MSI IRQ allocator. */
625     if (!SPAPR_MACHINE_GET_CLASS(spapr)->legacy_irq_allocation) {
626         spapr_irq_msi_init(spapr, spapr->irq->nr_msis);
627     }
628 
629     spapr->irq->init(spapr, errp);
630 
631     spapr->qirqs = qemu_allocate_irqs(spapr->irq->set_irq, spapr,
632                                       spapr->irq->nr_xirqs + SPAPR_XIRQ_BASE);
633 }
634 
635 int spapr_irq_claim(SpaprMachineState *spapr, int irq, bool lsi, Error **errp)
636 {
637     return spapr->irq->claim(spapr, irq, lsi, errp);
638 }
639 
640 void spapr_irq_free(SpaprMachineState *spapr, int irq, int num)
641 {
642     spapr->irq->free(spapr, irq, num);
643 }
644 
645 qemu_irq spapr_qirq(SpaprMachineState *spapr, int irq)
646 {
647     /*
648      * This interface is basically for VIO and PHB devices to find the
649      * right qemu_irq to manipulate, so we only allow access to the
650      * external irqs for now.  Currently anything which needs to
651      * access the IPIs most naturally gets there via the guest side
652      * interfaces, we can change this if we need to in future.
653      */
654     assert(irq >= SPAPR_XIRQ_BASE);
655     assert(irq < (spapr->irq->nr_xirqs + SPAPR_XIRQ_BASE));
656 
657     if (spapr->ics) {
658         assert(ics_valid_irq(spapr->ics, irq));
659     }
660     if (spapr->xive) {
661         assert(irq < spapr->xive->nr_irqs);
662         assert(xive_eas_is_valid(&spapr->xive->eat[irq]));
663     }
664 
665     return spapr->qirqs[irq];
666 }
667 
668 int spapr_irq_post_load(SpaprMachineState *spapr, int version_id)
669 {
670     return spapr->irq->post_load(spapr, version_id);
671 }
672 
673 void spapr_irq_reset(SpaprMachineState *spapr, Error **errp)
674 {
675     assert(!spapr->irq_map || bitmap_empty(spapr->irq_map, spapr->irq_map_nr));
676 
677     if (spapr->irq->reset) {
678         spapr->irq->reset(spapr, errp);
679     }
680 }
681 
682 int spapr_irq_get_phandle(SpaprMachineState *spapr, void *fdt, Error **errp)
683 {
684     const char *nodename = "interrupt-controller";
685     int offset, phandle;
686 
687     offset = fdt_subnode_offset(fdt, 0, nodename);
688     if (offset < 0) {
689         error_setg(errp, "Can't find node \"%s\": %s",
690                    nodename, fdt_strerror(offset));
691         return -1;
692     }
693 
694     phandle = fdt_get_phandle(fdt, offset);
695     if (!phandle) {
696         error_setg(errp, "Can't get phandle of node \"%s\"", nodename);
697         return -1;
698     }
699 
700     return phandle;
701 }
702 
703 /*
704  * XICS legacy routines - to deprecate one day
705  */
706 
707 static int ics_find_free_block(ICSState *ics, int num, int alignnum)
708 {
709     int first, i;
710 
711     for (first = 0; first < ics->nr_irqs; first += alignnum) {
712         if (num > (ics->nr_irqs - first)) {
713             return -1;
714         }
715         for (i = first; i < first + num; ++i) {
716             if (!ics_irq_free(ics, i)) {
717                 break;
718             }
719         }
720         if (i == (first + num)) {
721             return first;
722         }
723     }
724 
725     return -1;
726 }
727 
728 int spapr_irq_find(SpaprMachineState *spapr, int num, bool align, Error **errp)
729 {
730     ICSState *ics = spapr->ics;
731     int first = -1;
732 
733     assert(ics);
734 
735     /*
736      * MSIMesage::data is used for storing VIRQ so
737      * it has to be aligned to num to support multiple
738      * MSI vectors. MSI-X is not affected by this.
739      * The hint is used for the first IRQ, the rest should
740      * be allocated continuously.
741      */
742     if (align) {
743         assert((num == 1) || (num == 2) || (num == 4) ||
744                (num == 8) || (num == 16) || (num == 32));
745         first = ics_find_free_block(ics, num, num);
746     } else {
747         first = ics_find_free_block(ics, num, 1);
748     }
749 
750     if (first < 0) {
751         error_setg(errp, "can't find a free %d-IRQ block", num);
752         return -1;
753     }
754 
755     return first + ics->offset;
756 }
757 
758 #define SPAPR_IRQ_XICS_LEGACY_NR_XIRQS     0x400
759 
760 SpaprIrq spapr_irq_xics_legacy = {
761     .nr_xirqs    = SPAPR_IRQ_XICS_LEGACY_NR_XIRQS,
762     .nr_msis     = SPAPR_IRQ_XICS_LEGACY_NR_XIRQS,
763     .ov5         = SPAPR_OV5_XIVE_LEGACY,
764 
765     .init        = spapr_irq_init_xics,
766     .claim       = spapr_irq_claim_xics,
767     .free        = spapr_irq_free_xics,
768     .print_info  = spapr_irq_print_info_xics,
769     .dt_populate = spapr_dt_xics,
770     .cpu_intc_create = spapr_irq_cpu_intc_create_xics,
771     .post_load   = spapr_irq_post_load_xics,
772     .reset       = spapr_irq_reset_xics,
773     .set_irq     = spapr_irq_set_irq_xics,
774     .init_kvm    = spapr_irq_init_kvm_xics,
775 };
776