2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2011 NetApp, Inc.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * THIS SOFTWARE IS PROVIDED BY NETAPP, INC ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL NETAPP, INC OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 #include <sys/cdefs.h>
32 __FBSDID("$FreeBSD$");
34 #include <sys/param.h>
36 #include <sys/kernel.h>
37 #include <sys/malloc.h>
38 #include <sys/mutex.h>
39 #include <sys/systm.h>
42 #include <x86/specialreg.h>
43 #include <x86/apicreg.h>
45 #include <machine/clock.h>
46 #include <machine/smp.h>
48 #include <machine/vmm.h>
50 #include "vmm_lapic.h"
55 #include "vlapic_priv.h"
58 #define PRIO(x) ((x) >> 4)
60 #define VLAPIC_VERSION (16)
62 #define x2apic(vlapic) (((vlapic)->msr_apicbase & APICBASE_X2APIC) ? 1 : 0)
65 * The 'vlapic->timer_mtx' is used to provide mutual exclusion between the
66 * vlapic_callout_handler() and vcpu accesses to:
67 * - timer_freq_bt, timer_period_bt, timer_fire_bt
68 * - timer LVT register
70 #define VLAPIC_TIMER_LOCK(vlapic) mtx_lock_spin(&((vlapic)->timer_mtx))
71 #define VLAPIC_TIMER_UNLOCK(vlapic) mtx_unlock_spin(&((vlapic)->timer_mtx))
72 #define VLAPIC_TIMER_LOCKED(vlapic) mtx_owned(&((vlapic)->timer_mtx))
75 * APIC timer frequency:
76 * - arbitrary but chosen to be in the ballpark of contemporary hardware.
77 * - power-of-two to avoid loss of precision when converted to a bintime.
79 #define VLAPIC_BUS_FREQ (128 * 1024 * 1024)
81 static __inline uint32_t
82 vlapic_get_id(struct vlapic *vlapic)
86 return (vlapic->vcpuid);
88 return (vlapic->vcpuid << 24);
92 x2apic_ldr(struct vlapic *vlapic)
97 apicid = vlapic_get_id(vlapic);
98 ldr = 1 << (apicid & 0xf);
99 ldr |= (apicid & 0xffff0) << 12;
104 vlapic_dfr_write_handler(struct vlapic *vlapic)
108 lapic = vlapic->apic_page;
109 if (x2apic(vlapic)) {
110 VM_CTR1(vlapic->vm, "ignoring write to DFR in x2apic mode: %#x",
116 lapic->dfr &= APIC_DFR_MODEL_MASK;
117 lapic->dfr |= APIC_DFR_RESERVED;
119 if ((lapic->dfr & APIC_DFR_MODEL_MASK) == APIC_DFR_MODEL_FLAT)
120 VLAPIC_CTR0(vlapic, "vlapic DFR in Flat Model");
121 else if ((lapic->dfr & APIC_DFR_MODEL_MASK) == APIC_DFR_MODEL_CLUSTER)
122 VLAPIC_CTR0(vlapic, "vlapic DFR in Cluster Model");
124 VLAPIC_CTR1(vlapic, "DFR in Unknown Model %#x", lapic->dfr);
128 vlapic_ldr_write_handler(struct vlapic *vlapic)
132 lapic = vlapic->apic_page;
134 /* LDR is read-only in x2apic mode */
135 if (x2apic(vlapic)) {
136 VLAPIC_CTR1(vlapic, "ignoring write to LDR in x2apic mode: %#x",
138 lapic->ldr = x2apic_ldr(vlapic);
140 lapic->ldr &= ~APIC_LDR_RESERVED;
141 VLAPIC_CTR1(vlapic, "vlapic LDR set to %#x", lapic->ldr);
146 vlapic_id_write_handler(struct vlapic *vlapic)
151 * We don't allow the ID register to be modified so reset it back to
154 lapic = vlapic->apic_page;
155 lapic->id = vlapic_get_id(vlapic);
159 vlapic_timer_divisor(uint32_t dcr)
179 panic("vlapic_timer_divisor: invalid dcr 0x%08x", dcr);
185 vlapic_dump_lvt(uint32_t offset, uint32_t *lvt)
187 printf("Offset %x: lvt %08x (V:%02x DS:%x M:%x)\n", offset,
188 *lvt, *lvt & APIC_LVTT_VECTOR, *lvt & APIC_LVTT_DS,
194 vlapic_get_ccr(struct vlapic *vlapic)
196 struct bintime bt_now, bt_rem;
201 lapic = vlapic->apic_page;
203 VLAPIC_TIMER_LOCK(vlapic);
204 if (callout_active(&vlapic->callout)) {
206 * If the timer is scheduled to expire in the future then
207 * compute the value of 'ccr' based on the remaining time.
210 if (bintime_cmp(&vlapic->timer_fire_bt, &bt_now, >)) {
211 bt_rem = vlapic->timer_fire_bt;
212 bintime_sub(&bt_rem, &bt_now);
213 ccr += bt_rem.sec * BT2FREQ(&vlapic->timer_freq_bt);
214 ccr += bt_rem.frac / vlapic->timer_freq_bt.frac;
217 KASSERT(ccr <= lapic->icr_timer, ("vlapic_get_ccr: invalid ccr %#x, "
218 "icr_timer is %#x", ccr, lapic->icr_timer));
219 VLAPIC_CTR2(vlapic, "vlapic ccr_timer = %#x, icr_timer = %#x",
220 ccr, lapic->icr_timer);
221 VLAPIC_TIMER_UNLOCK(vlapic);
226 vlapic_dcr_write_handler(struct vlapic *vlapic)
231 lapic = vlapic->apic_page;
232 VLAPIC_TIMER_LOCK(vlapic);
234 divisor = vlapic_timer_divisor(lapic->dcr_timer);
235 VLAPIC_CTR2(vlapic, "vlapic dcr_timer=%#x, divisor=%d",
236 lapic->dcr_timer, divisor);
239 * Update the timer frequency and the timer period.
241 * XXX changes to the frequency divider will not take effect until
242 * the timer is reloaded.
244 FREQ2BT(VLAPIC_BUS_FREQ / divisor, &vlapic->timer_freq_bt);
245 vlapic->timer_period_bt = vlapic->timer_freq_bt;
246 bintime_mul(&vlapic->timer_period_bt, lapic->icr_timer);
248 VLAPIC_TIMER_UNLOCK(vlapic);
252 vlapic_esr_write_handler(struct vlapic *vlapic)
256 lapic = vlapic->apic_page;
257 lapic->esr = vlapic->esr_pending;
258 vlapic->esr_pending = 0;
262 vlapic_set_intr_ready(struct vlapic *vlapic, int vector, bool level)
265 uint32_t *irrptr, *tmrptr, mask;
268 KASSERT(vector >= 0 && vector < 256, ("invalid vector %d", vector));
270 lapic = vlapic->apic_page;
271 if (!(lapic->svr & APIC_SVR_ENABLE)) {
272 VLAPIC_CTR1(vlapic, "vlapic is software disabled, ignoring "
273 "interrupt %d", vector);
278 vlapic_set_error(vlapic, APIC_ESR_RECEIVE_ILLEGAL_VECTOR);
279 VLAPIC_CTR1(vlapic, "vlapic ignoring interrupt to vector %d",
284 if (vlapic->ops.set_intr_ready)
285 return ((*vlapic->ops.set_intr_ready)(vlapic, vector, level));
287 idx = (vector / 32) * 4;
288 mask = 1 << (vector % 32);
290 irrptr = &lapic->irr0;
291 atomic_set_int(&irrptr[idx], mask);
294 * Verify that the trigger-mode of the interrupt matches with
295 * the vlapic TMR registers.
297 tmrptr = &lapic->tmr0;
298 if ((tmrptr[idx] & mask) != (level ? mask : 0)) {
299 VLAPIC_CTR3(vlapic, "vlapic TMR[%d] is 0x%08x but "
300 "interrupt is %s-triggered", idx / 4, tmrptr[idx],
301 level ? "level" : "edge");
304 VLAPIC_CTR_IRR(vlapic, "vlapic_set_intr_ready");
308 static __inline uint32_t *
309 vlapic_get_lvtptr(struct vlapic *vlapic, uint32_t offset)
311 struct LAPIC *lapic = vlapic->apic_page;
315 case APIC_OFFSET_CMCI_LVT:
316 return (&lapic->lvt_cmci);
317 case APIC_OFFSET_TIMER_LVT ... APIC_OFFSET_ERROR_LVT:
318 i = (offset - APIC_OFFSET_TIMER_LVT) >> 2;
319 return ((&lapic->lvt_timer) + i);
321 panic("vlapic_get_lvt: invalid LVT\n");
326 lvt_off_to_idx(uint32_t offset)
331 case APIC_OFFSET_CMCI_LVT:
332 index = APIC_LVT_CMCI;
334 case APIC_OFFSET_TIMER_LVT:
335 index = APIC_LVT_TIMER;
337 case APIC_OFFSET_THERM_LVT:
338 index = APIC_LVT_THERMAL;
340 case APIC_OFFSET_PERF_LVT:
341 index = APIC_LVT_PMC;
343 case APIC_OFFSET_LINT0_LVT:
344 index = APIC_LVT_LINT0;
346 case APIC_OFFSET_LINT1_LVT:
347 index = APIC_LVT_LINT1;
349 case APIC_OFFSET_ERROR_LVT:
350 index = APIC_LVT_ERROR;
356 KASSERT(index >= 0 && index <= VLAPIC_MAXLVT_INDEX, ("lvt_off_to_idx: "
357 "invalid lvt index %d for offset %#x", index, offset));
362 static __inline uint32_t
363 vlapic_get_lvt(struct vlapic *vlapic, uint32_t offset)
368 idx = lvt_off_to_idx(offset);
369 val = atomic_load_acq_32(&vlapic->lvt_last[idx]);
374 vlapic_lvt_write_handler(struct vlapic *vlapic, uint32_t offset)
376 uint32_t *lvtptr, mask, val;
380 lapic = vlapic->apic_page;
381 lvtptr = vlapic_get_lvtptr(vlapic, offset);
383 idx = lvt_off_to_idx(offset);
385 if (!(lapic->svr & APIC_SVR_ENABLE))
387 mask = APIC_LVT_M | APIC_LVT_DS | APIC_LVT_VECTOR;
389 case APIC_OFFSET_TIMER_LVT:
390 mask |= APIC_LVTT_TM;
392 case APIC_OFFSET_ERROR_LVT:
394 case APIC_OFFSET_LINT0_LVT:
395 case APIC_OFFSET_LINT1_LVT:
396 mask |= APIC_LVT_TM | APIC_LVT_RIRR | APIC_LVT_IIPP;
404 atomic_store_rel_32(&vlapic->lvt_last[idx], val);
408 vlapic_mask_lvts(struct vlapic *vlapic)
410 struct LAPIC *lapic = vlapic->apic_page;
412 lapic->lvt_cmci |= APIC_LVT_M;
413 vlapic_lvt_write_handler(vlapic, APIC_OFFSET_CMCI_LVT);
415 lapic->lvt_timer |= APIC_LVT_M;
416 vlapic_lvt_write_handler(vlapic, APIC_OFFSET_TIMER_LVT);
418 lapic->lvt_thermal |= APIC_LVT_M;
419 vlapic_lvt_write_handler(vlapic, APIC_OFFSET_THERM_LVT);
421 lapic->lvt_pcint |= APIC_LVT_M;
422 vlapic_lvt_write_handler(vlapic, APIC_OFFSET_PERF_LVT);
424 lapic->lvt_lint0 |= APIC_LVT_M;
425 vlapic_lvt_write_handler(vlapic, APIC_OFFSET_LINT0_LVT);
427 lapic->lvt_lint1 |= APIC_LVT_M;
428 vlapic_lvt_write_handler(vlapic, APIC_OFFSET_LINT1_LVT);
430 lapic->lvt_error |= APIC_LVT_M;
431 vlapic_lvt_write_handler(vlapic, APIC_OFFSET_ERROR_LVT);
435 vlapic_fire_lvt(struct vlapic *vlapic, uint32_t lvt)
439 if (lvt & APIC_LVT_M)
442 vec = lvt & APIC_LVT_VECTOR;
443 mode = lvt & APIC_LVT_DM;
446 case APIC_LVT_DM_FIXED:
448 vlapic_set_error(vlapic, APIC_ESR_SEND_ILLEGAL_VECTOR);
451 if (vlapic_set_intr_ready(vlapic, vec, false))
452 vcpu_notify_event(vlapic->vm, vlapic->vcpuid, true);
454 case APIC_LVT_DM_NMI:
455 vm_inject_nmi(vlapic->vm, vlapic->vcpuid);
457 case APIC_LVT_DM_EXTINT:
458 vm_inject_extint(vlapic->vm, vlapic->vcpuid);
461 // Other modes ignored
469 dump_isrvec_stk(struct vlapic *vlapic)
474 isrptr = &vlapic->apic_page->isr0;
475 for (i = 0; i < 8; i++)
476 printf("ISR%d 0x%08x\n", i, isrptr[i * 4]);
478 for (i = 0; i <= vlapic->isrvec_stk_top; i++)
479 printf("isrvec_stk[%d] = %d\n", i, vlapic->isrvec_stk[i]);
484 * Algorithm adopted from section "Interrupt, Task and Processor Priority"
485 * in Intel Architecture Manual Vol 3a.
488 vlapic_update_ppr(struct vlapic *vlapic)
490 int isrvec, tpr, ppr;
493 * Note that the value on the stack at index 0 is always 0.
495 * This is a placeholder for the value of ISRV when none of the
496 * bits is set in the ISRx registers.
498 isrvec = vlapic->isrvec_stk[vlapic->isrvec_stk_top];
499 tpr = vlapic->apic_page->tpr;
503 int i, lastprio, curprio, vector, idx;
506 if (vlapic->isrvec_stk_top == 0 && isrvec != 0)
507 panic("isrvec_stk is corrupted: %d", isrvec);
510 * Make sure that the priority of the nested interrupts is
514 for (i = 1; i <= vlapic->isrvec_stk_top; i++) {
515 curprio = PRIO(vlapic->isrvec_stk[i]);
516 if (curprio <= lastprio) {
517 dump_isrvec_stk(vlapic);
518 panic("isrvec_stk does not satisfy invariant");
524 * Make sure that each bit set in the ISRx registers has a
525 * corresponding entry on the isrvec stack.
528 isrptr = &vlapic->apic_page->isr0;
529 for (vector = 0; vector < 256; vector++) {
530 idx = (vector / 32) * 4;
531 if (isrptr[idx] & (1 << (vector % 32))) {
532 if (i > vlapic->isrvec_stk_top ||
533 vlapic->isrvec_stk[i] != vector) {
534 dump_isrvec_stk(vlapic);
535 panic("ISR and isrvec_stk out of sync");
543 if (PRIO(tpr) >= PRIO(isrvec))
548 vlapic->apic_page->ppr = ppr;
549 VLAPIC_CTR1(vlapic, "vlapic_update_ppr 0x%02x", ppr);
553 vlapic_sync_tpr(struct vlapic *vlapic)
555 vlapic_update_ppr(vlapic);
558 static VMM_STAT(VLAPIC_GRATUITOUS_EOI, "EOI without any in-service interrupt");
561 vlapic_process_eoi(struct vlapic *vlapic)
563 struct LAPIC *lapic = vlapic->apic_page;
564 uint32_t *isrptr, *tmrptr;
565 int i, idx, bitpos, vector;
567 isrptr = &lapic->isr0;
568 tmrptr = &lapic->tmr0;
570 for (i = 7; i >= 0; i--) {
572 bitpos = fls(isrptr[idx]);
574 if (vlapic->isrvec_stk_top <= 0) {
575 panic("invalid vlapic isrvec_stk_top %d",
576 vlapic->isrvec_stk_top);
578 isrptr[idx] &= ~(1 << bitpos);
579 vector = i * 32 + bitpos;
580 VCPU_CTR1(vlapic->vm, vlapic->vcpuid, "EOI vector %d",
582 VLAPIC_CTR_ISR(vlapic, "vlapic_process_eoi");
583 vlapic->isrvec_stk_top--;
584 vlapic_update_ppr(vlapic);
585 if ((tmrptr[idx] & (1 << bitpos)) != 0) {
586 vioapic_process_eoi(vlapic->vm, vlapic->vcpuid,
592 VCPU_CTR0(vlapic->vm, vlapic->vcpuid, "Gratuitous EOI");
593 vmm_stat_incr(vlapic->vm, vlapic->vcpuid, VLAPIC_GRATUITOUS_EOI, 1);
597 vlapic_get_lvt_field(uint32_t lvt, uint32_t mask)
604 vlapic_periodic_timer(struct vlapic *vlapic)
608 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_TIMER_LVT);
610 return (vlapic_get_lvt_field(lvt, APIC_LVTT_TM_PERIODIC));
613 static VMM_STAT(VLAPIC_INTR_ERROR, "error interrupts generated by vlapic");
616 vlapic_set_error(struct vlapic *vlapic, uint32_t mask)
620 vlapic->esr_pending |= mask;
621 if (vlapic->esr_firing)
623 vlapic->esr_firing = 1;
625 // The error LVT always uses the fixed delivery mode.
626 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_ERROR_LVT);
627 if (vlapic_fire_lvt(vlapic, lvt | APIC_LVT_DM_FIXED)) {
628 vmm_stat_incr(vlapic->vm, vlapic->vcpuid, VLAPIC_INTR_ERROR, 1);
630 vlapic->esr_firing = 0;
633 static VMM_STAT(VLAPIC_INTR_TIMER, "timer interrupts generated by vlapic");
636 vlapic_fire_timer(struct vlapic *vlapic)
640 KASSERT(VLAPIC_TIMER_LOCKED(vlapic), ("vlapic_fire_timer not locked"));
642 // The timer LVT always uses the fixed delivery mode.
643 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_TIMER_LVT);
644 if (vlapic_fire_lvt(vlapic, lvt | APIC_LVT_DM_FIXED)) {
645 VLAPIC_CTR0(vlapic, "vlapic timer fired");
646 vmm_stat_incr(vlapic->vm, vlapic->vcpuid, VLAPIC_INTR_TIMER, 1);
650 static VMM_STAT(VLAPIC_INTR_CMC,
651 "corrected machine check interrupts generated by vlapic");
654 vlapic_fire_cmci(struct vlapic *vlapic)
658 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_CMCI_LVT);
659 if (vlapic_fire_lvt(vlapic, lvt)) {
660 vmm_stat_incr(vlapic->vm, vlapic->vcpuid, VLAPIC_INTR_CMC, 1);
664 static VMM_STAT_ARRAY(LVTS_TRIGGERRED, VLAPIC_MAXLVT_INDEX + 1,
668 vlapic_trigger_lvt(struct vlapic *vlapic, int vector)
672 if (vlapic_enabled(vlapic) == false) {
674 * When the local APIC is global/hardware disabled,
675 * LINT[1:0] pins are configured as INTR and NMI pins,
680 vm_inject_extint(vlapic->vm, vlapic->vcpuid);
683 vm_inject_nmi(vlapic->vm, vlapic->vcpuid);
693 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_LINT0_LVT);
696 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_LINT1_LVT);
699 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_TIMER_LVT);
700 lvt |= APIC_LVT_DM_FIXED;
703 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_ERROR_LVT);
704 lvt |= APIC_LVT_DM_FIXED;
707 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_PERF_LVT);
709 case APIC_LVT_THERMAL:
710 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_THERM_LVT);
713 lvt = vlapic_get_lvt(vlapic, APIC_OFFSET_CMCI_LVT);
718 if (vlapic_fire_lvt(vlapic, lvt)) {
719 vmm_stat_array_incr(vlapic->vm, vlapic->vcpuid,
720 LVTS_TRIGGERRED, vector, 1);
726 vlapic_callout_handler(void *arg)
728 struct vlapic *vlapic;
729 struct bintime bt, btnow;
734 VLAPIC_TIMER_LOCK(vlapic);
735 if (callout_pending(&vlapic->callout)) /* callout was reset */
738 if (!callout_active(&vlapic->callout)) /* callout was stopped */
741 callout_deactivate(&vlapic->callout);
743 vlapic_fire_timer(vlapic);
745 if (vlapic_periodic_timer(vlapic)) {
747 KASSERT(bintime_cmp(&btnow, &vlapic->timer_fire_bt, >=),
748 ("vlapic callout at %#lx.%#lx, expected at %#lx.#%lx",
749 btnow.sec, btnow.frac, vlapic->timer_fire_bt.sec,
750 vlapic->timer_fire_bt.frac));
753 * Compute the delta between when the timer was supposed to
754 * fire and the present time.
757 bintime_sub(&bt, &vlapic->timer_fire_bt);
759 rem_sbt = bttosbt(vlapic->timer_period_bt);
760 if (bintime_cmp(&bt, &vlapic->timer_period_bt, <)) {
762 * Adjust the time until the next countdown downward
763 * to account for the lost time.
765 rem_sbt -= bttosbt(bt);
768 * If the delta is greater than the timer period then
769 * just reset our time base instead of trying to catch
772 vlapic->timer_fire_bt = btnow;
773 VLAPIC_CTR2(vlapic, "vlapic timer lagging by %lu "
774 "usecs, period is %lu usecs - resetting time base",
775 bttosbt(bt) / SBT_1US,
776 bttosbt(vlapic->timer_period_bt) / SBT_1US);
779 bintime_add(&vlapic->timer_fire_bt, &vlapic->timer_period_bt);
780 callout_reset_sbt(&vlapic->callout, rem_sbt, 0,
781 vlapic_callout_handler, vlapic, 0);
784 VLAPIC_TIMER_UNLOCK(vlapic);
788 vlapic_icrtmr_write_handler(struct vlapic *vlapic)
794 VLAPIC_TIMER_LOCK(vlapic);
796 lapic = vlapic->apic_page;
797 icr_timer = lapic->icr_timer;
799 vlapic->timer_period_bt = vlapic->timer_freq_bt;
800 bintime_mul(&vlapic->timer_period_bt, icr_timer);
802 if (icr_timer != 0) {
803 binuptime(&vlapic->timer_fire_bt);
804 bintime_add(&vlapic->timer_fire_bt, &vlapic->timer_period_bt);
806 sbt = bttosbt(vlapic->timer_period_bt);
807 callout_reset_sbt(&vlapic->callout, sbt, 0,
808 vlapic_callout_handler, vlapic, 0);
810 callout_stop(&vlapic->callout);
812 VLAPIC_TIMER_UNLOCK(vlapic);
816 * This function populates 'dmask' with the set of vcpus that match the
817 * addressing specified by the (dest, phys, lowprio) tuple.
819 * 'x2apic_dest' specifies whether 'dest' is interpreted as x2APIC (32-bit)
820 * or xAPIC (8-bit) destination field.
823 vlapic_calcdest(struct vm *vm, cpuset_t *dmask, uint32_t dest, bool phys,
824 bool lowprio, bool x2apic_dest)
826 struct vlapic *vlapic;
827 uint32_t dfr, ldr, ldest, cluster;
828 uint32_t mda_flat_ldest, mda_cluster_ldest, mda_ldest, mda_cluster_id;
832 if ((x2apic_dest && dest == 0xffffffff) ||
833 (!x2apic_dest && dest == 0xff)) {
835 * Broadcast in both logical and physical modes.
837 *dmask = vm_active_cpus(vm);
843 * Physical mode: destination is APIC ID.
846 vcpuid = vm_apicid2vcpuid(vm, dest);
847 amask = vm_active_cpus(vm);
848 if (vcpuid < vm_get_maxcpus(vm) && CPU_ISSET(vcpuid, &amask))
849 CPU_SET(vcpuid, dmask);
852 * In the "Flat Model" the MDA is interpreted as an 8-bit wide
853 * bitmask. This model is only available in the xAPIC mode.
855 mda_flat_ldest = dest & 0xff;
858 * In the "Cluster Model" the MDA is used to identify a
859 * specific cluster and a set of APICs in that cluster.
862 mda_cluster_id = dest >> 16;
863 mda_cluster_ldest = dest & 0xffff;
865 mda_cluster_id = (dest >> 4) & 0xf;
866 mda_cluster_ldest = dest & 0xf;
870 * Logical mode: match each APIC that has a bit set
871 * in its LDR that matches a bit in the ldest.
874 amask = vm_active_cpus(vm);
875 while ((vcpuid = CPU_FFS(&amask)) != 0) {
877 CPU_CLR(vcpuid, &amask);
879 vlapic = vm_lapic(vm, vcpuid);
880 dfr = vlapic->apic_page->dfr;
881 ldr = vlapic->apic_page->ldr;
883 if ((dfr & APIC_DFR_MODEL_MASK) ==
884 APIC_DFR_MODEL_FLAT) {
886 mda_ldest = mda_flat_ldest;
887 } else if ((dfr & APIC_DFR_MODEL_MASK) ==
888 APIC_DFR_MODEL_CLUSTER) {
889 if (x2apic(vlapic)) {
891 ldest = ldr & 0xffff;
894 ldest = (ldr >> 24) & 0xf;
896 if (cluster != mda_cluster_id)
898 mda_ldest = mda_cluster_ldest;
901 * Guest has configured a bad logical
902 * model for this vcpu - skip it.
904 VLAPIC_CTR1(vlapic, "vlapic has bad logical "
905 "model %x - cannot deliver interrupt", dfr);
909 if ((mda_ldest & ldest) != 0) {
910 CPU_SET(vcpuid, dmask);
918 static VMM_STAT_ARRAY(IPIS_SENT, VM_MAXCPU, "ipis sent to vcpu");
921 vlapic_set_tpr(struct vlapic *vlapic, uint8_t val)
923 struct LAPIC *lapic = vlapic->apic_page;
925 if (lapic->tpr != val) {
926 VCPU_CTR2(vlapic->vm, vlapic->vcpuid, "vlapic TPR changed "
927 "from %#x to %#x", lapic->tpr, val);
929 vlapic_update_ppr(vlapic);
934 vlapic_get_tpr(struct vlapic *vlapic)
936 struct LAPIC *lapic = vlapic->apic_page;
942 vlapic_set_cr8(struct vlapic *vlapic, uint64_t val)
947 vm_inject_gp(vlapic->vm, vlapic->vcpuid);
952 vlapic_set_tpr(vlapic, tpr);
956 vlapic_get_cr8(struct vlapic *vlapic)
960 tpr = vlapic_get_tpr(vlapic);
965 vlapic_icrlo_write_handler(struct vlapic *vlapic, bool *retu)
971 uint32_t dest, vec, mode;
972 struct vlapic *vlapic2;
973 struct vm_exit *vmexit;
977 lapic = vlapic->apic_page;
978 lapic->icr_lo &= ~APIC_DELSTAT_PEND;
979 icrval = ((uint64_t)lapic->icr_hi << 32) | lapic->icr_lo;
984 dest = icrval >> (32 + 24);
985 vec = icrval & APIC_VECTOR_MASK;
986 mode = icrval & APIC_DELMODE_MASK;
988 if (mode == APIC_DELMODE_FIXED && vec < 16) {
989 vlapic_set_error(vlapic, APIC_ESR_SEND_ILLEGAL_VECTOR);
990 VLAPIC_CTR1(vlapic, "Ignoring invalid IPI %d", vec);
994 VLAPIC_CTR2(vlapic, "icrlo 0x%016lx triggered ipi %d", icrval, vec);
996 if (mode == APIC_DELMODE_FIXED || mode == APIC_DELMODE_NMI) {
997 switch (icrval & APIC_DEST_MASK) {
998 case APIC_DEST_DESTFLD:
999 phys = ((icrval & APIC_DESTMODE_LOG) == 0);
1000 vlapic_calcdest(vlapic->vm, &dmask, dest, phys, false,
1003 case APIC_DEST_SELF:
1004 CPU_SETOF(vlapic->vcpuid, &dmask);
1006 case APIC_DEST_ALLISELF:
1007 dmask = vm_active_cpus(vlapic->vm);
1009 case APIC_DEST_ALLESELF:
1010 dmask = vm_active_cpus(vlapic->vm);
1011 CPU_CLR(vlapic->vcpuid, &dmask);
1014 CPU_ZERO(&dmask); /* satisfy gcc */
1018 while ((i = CPU_FFS(&dmask)) != 0) {
1021 if (mode == APIC_DELMODE_FIXED) {
1022 lapic_intr_edge(vlapic->vm, i, vec);
1023 vmm_stat_array_incr(vlapic->vm, vlapic->vcpuid,
1025 VLAPIC_CTR2(vlapic, "vlapic sending ipi %d "
1026 "to vcpuid %d", vec, i);
1028 vm_inject_nmi(vlapic->vm, i);
1029 VLAPIC_CTR1(vlapic, "vlapic sending ipi nmi "
1034 return (0); /* handled completely in the kernel */
1037 maxcpus = vm_get_maxcpus(vlapic->vm);
1038 if (mode == APIC_DELMODE_INIT) {
1039 if ((icrval & APIC_LEVEL_MASK) == APIC_LEVEL_DEASSERT)
1042 if (vlapic->vcpuid == 0 && dest != 0 && dest < maxcpus) {
1043 vlapic2 = vm_lapic(vlapic->vm, dest);
1045 /* move from INIT to waiting-for-SIPI state */
1046 if (vlapic2->boot_state == BS_INIT) {
1047 vlapic2->boot_state = BS_SIPI;
1054 if (mode == APIC_DELMODE_STARTUP) {
1055 if (vlapic->vcpuid == 0 && dest != 0 && dest < maxcpus) {
1056 vlapic2 = vm_lapic(vlapic->vm, dest);
1059 * Ignore SIPIs in any state other than wait-for-SIPI
1061 if (vlapic2->boot_state != BS_SIPI)
1064 vlapic2->boot_state = BS_RUNNING;
1067 vmexit = vm_exitinfo(vlapic->vm, vlapic->vcpuid);
1068 vmexit->exitcode = VM_EXITCODE_SPINUP_AP;
1069 vmexit->u.spinup_ap.vcpu = dest;
1070 vmexit->u.spinup_ap.rip = vec << PAGE_SHIFT;
1077 * This will cause a return to userland.
1083 vlapic_self_ipi_handler(struct vlapic *vlapic, uint64_t val)
1087 KASSERT(x2apic(vlapic), ("SELF_IPI does not exist in xAPIC mode"));
1090 lapic_intr_edge(vlapic->vm, vlapic->vcpuid, vec);
1091 vmm_stat_array_incr(vlapic->vm, vlapic->vcpuid, IPIS_SENT,
1093 VLAPIC_CTR1(vlapic, "vlapic self-ipi %d", vec);
1097 vlapic_pending_intr(struct vlapic *vlapic, int *vecptr)
1099 struct LAPIC *lapic = vlapic->apic_page;
1100 int idx, i, bitpos, vector;
1101 uint32_t *irrptr, val;
1103 vlapic_update_ppr(vlapic);
1105 if (vlapic->ops.pending_intr)
1106 return ((*vlapic->ops.pending_intr)(vlapic, vecptr));
1108 irrptr = &lapic->irr0;
1110 for (i = 7; i >= 0; i--) {
1112 val = atomic_load_acq_int(&irrptr[idx]);
1115 vector = i * 32 + (bitpos - 1);
1116 if (PRIO(vector) > PRIO(lapic->ppr)) {
1117 VLAPIC_CTR1(vlapic, "pending intr %d", vector);
1129 vlapic_intr_accepted(struct vlapic *vlapic, int vector)
1131 struct LAPIC *lapic = vlapic->apic_page;
1132 uint32_t *irrptr, *isrptr;
1135 if (vlapic->ops.intr_accepted)
1136 return ((*vlapic->ops.intr_accepted)(vlapic, vector));
1139 * clear the ready bit for vector being accepted in irr
1140 * and set the vector as in service in isr.
1142 idx = (vector / 32) * 4;
1144 irrptr = &lapic->irr0;
1145 atomic_clear_int(&irrptr[idx], 1 << (vector % 32));
1146 VLAPIC_CTR_IRR(vlapic, "vlapic_intr_accepted");
1148 isrptr = &lapic->isr0;
1149 isrptr[idx] |= 1 << (vector % 32);
1150 VLAPIC_CTR_ISR(vlapic, "vlapic_intr_accepted");
1155 vlapic->isrvec_stk_top++;
1157 stk_top = vlapic->isrvec_stk_top;
1158 if (stk_top >= ISRVEC_STK_SIZE)
1159 panic("isrvec_stk_top overflow %d", stk_top);
1161 vlapic->isrvec_stk[stk_top] = vector;
1165 vlapic_svr_write_handler(struct vlapic *vlapic)
1167 struct LAPIC *lapic;
1168 uint32_t old, new, changed;
1170 lapic = vlapic->apic_page;
1173 old = vlapic->svr_last;
1174 vlapic->svr_last = new;
1176 changed = old ^ new;
1177 if ((changed & APIC_SVR_ENABLE) != 0) {
1178 if ((new & APIC_SVR_ENABLE) == 0) {
1180 * The apic is now disabled so stop the apic timer
1181 * and mask all the LVT entries.
1183 VLAPIC_CTR0(vlapic, "vlapic is software-disabled");
1184 VLAPIC_TIMER_LOCK(vlapic);
1185 callout_stop(&vlapic->callout);
1186 VLAPIC_TIMER_UNLOCK(vlapic);
1187 vlapic_mask_lvts(vlapic);
1190 * The apic is now enabled so restart the apic timer
1191 * if it is configured in periodic mode.
1193 VLAPIC_CTR0(vlapic, "vlapic is software-enabled");
1194 if (vlapic_periodic_timer(vlapic))
1195 vlapic_icrtmr_write_handler(vlapic);
1201 vlapic_read(struct vlapic *vlapic, int mmio_access, uint64_t offset,
1202 uint64_t *data, bool *retu)
1204 struct LAPIC *lapic = vlapic->apic_page;
1208 /* Ignore MMIO accesses in x2APIC mode */
1209 if (x2apic(vlapic) && mmio_access) {
1210 VLAPIC_CTR1(vlapic, "MMIO read from offset %#lx in x2APIC mode",
1216 if (!x2apic(vlapic) && !mmio_access) {
1218 * XXX Generate GP fault for MSR accesses in xAPIC mode
1220 VLAPIC_CTR1(vlapic, "x2APIC MSR read from offset %#lx in "
1221 "xAPIC mode", offset);
1226 if (offset > sizeof(*lapic)) {
1234 case APIC_OFFSET_ID:
1237 case APIC_OFFSET_VER:
1238 *data = lapic->version;
1240 case APIC_OFFSET_TPR:
1241 *data = vlapic_get_tpr(vlapic);
1243 case APIC_OFFSET_APR:
1246 case APIC_OFFSET_PPR:
1249 case APIC_OFFSET_EOI:
1252 case APIC_OFFSET_LDR:
1255 case APIC_OFFSET_DFR:
1258 case APIC_OFFSET_SVR:
1261 case APIC_OFFSET_ISR0 ... APIC_OFFSET_ISR7:
1262 i = (offset - APIC_OFFSET_ISR0) >> 2;
1266 case APIC_OFFSET_TMR0 ... APIC_OFFSET_TMR7:
1267 i = (offset - APIC_OFFSET_TMR0) >> 2;
1271 case APIC_OFFSET_IRR0 ... APIC_OFFSET_IRR7:
1272 i = (offset - APIC_OFFSET_IRR0) >> 2;
1274 *data = atomic_load_acq_int(reg + i);
1276 case APIC_OFFSET_ESR:
1279 case APIC_OFFSET_ICR_LOW:
1280 *data = lapic->icr_lo;
1282 *data |= (uint64_t)lapic->icr_hi << 32;
1284 case APIC_OFFSET_ICR_HI:
1285 *data = lapic->icr_hi;
1287 case APIC_OFFSET_CMCI_LVT:
1288 case APIC_OFFSET_TIMER_LVT ... APIC_OFFSET_ERROR_LVT:
1289 *data = vlapic_get_lvt(vlapic, offset);
1291 reg = vlapic_get_lvtptr(vlapic, offset);
1292 KASSERT(*data == *reg, ("inconsistent lvt value at "
1293 "offset %#lx: %#lx/%#x", offset, *data, *reg));
1296 case APIC_OFFSET_TIMER_ICR:
1297 *data = lapic->icr_timer;
1299 case APIC_OFFSET_TIMER_CCR:
1300 *data = vlapic_get_ccr(vlapic);
1302 case APIC_OFFSET_TIMER_DCR:
1303 *data = lapic->dcr_timer;
1305 case APIC_OFFSET_SELF_IPI:
1307 * XXX generate a GP fault if vlapic is in x2apic mode
1311 case APIC_OFFSET_RRR:
1317 VLAPIC_CTR2(vlapic, "vlapic read offset %#x, data %#lx", offset, *data);
1322 vlapic_write(struct vlapic *vlapic, int mmio_access, uint64_t offset,
1323 uint64_t data, bool *retu)
1325 struct LAPIC *lapic = vlapic->apic_page;
1329 KASSERT((offset & 0xf) == 0 && offset < PAGE_SIZE,
1330 ("vlapic_write: invalid offset %#lx", offset));
1332 VLAPIC_CTR2(vlapic, "vlapic write offset %#lx, data %#lx",
1335 if (offset > sizeof(*lapic))
1338 /* Ignore MMIO accesses in x2APIC mode */
1339 if (x2apic(vlapic) && mmio_access) {
1340 VLAPIC_CTR2(vlapic, "MMIO write of %#lx to offset %#lx "
1341 "in x2APIC mode", data, offset);
1346 * XXX Generate GP fault for MSR accesses in xAPIC mode
1348 if (!x2apic(vlapic) && !mmio_access) {
1349 VLAPIC_CTR2(vlapic, "x2APIC MSR write of %#lx to offset %#lx "
1350 "in xAPIC mode", data, offset);
1357 case APIC_OFFSET_ID:
1359 vlapic_id_write_handler(vlapic);
1361 case APIC_OFFSET_TPR:
1362 vlapic_set_tpr(vlapic, data & 0xff);
1364 case APIC_OFFSET_EOI:
1365 vlapic_process_eoi(vlapic);
1367 case APIC_OFFSET_LDR:
1369 vlapic_ldr_write_handler(vlapic);
1371 case APIC_OFFSET_DFR:
1373 vlapic_dfr_write_handler(vlapic);
1375 case APIC_OFFSET_SVR:
1377 vlapic_svr_write_handler(vlapic);
1379 case APIC_OFFSET_ICR_LOW:
1380 lapic->icr_lo = data;
1382 lapic->icr_hi = data >> 32;
1383 retval = vlapic_icrlo_write_handler(vlapic, retu);
1385 case APIC_OFFSET_ICR_HI:
1386 lapic->icr_hi = data;
1388 case APIC_OFFSET_CMCI_LVT:
1389 case APIC_OFFSET_TIMER_LVT ... APIC_OFFSET_ERROR_LVT:
1390 regptr = vlapic_get_lvtptr(vlapic, offset);
1392 vlapic_lvt_write_handler(vlapic, offset);
1394 case APIC_OFFSET_TIMER_ICR:
1395 lapic->icr_timer = data;
1396 vlapic_icrtmr_write_handler(vlapic);
1399 case APIC_OFFSET_TIMER_DCR:
1400 lapic->dcr_timer = data;
1401 vlapic_dcr_write_handler(vlapic);
1404 case APIC_OFFSET_ESR:
1405 vlapic_esr_write_handler(vlapic);
1408 case APIC_OFFSET_SELF_IPI:
1410 vlapic_self_ipi_handler(vlapic, data);
1413 case APIC_OFFSET_VER:
1414 case APIC_OFFSET_APR:
1415 case APIC_OFFSET_PPR:
1416 case APIC_OFFSET_RRR:
1417 case APIC_OFFSET_ISR0 ... APIC_OFFSET_ISR7:
1418 case APIC_OFFSET_TMR0 ... APIC_OFFSET_TMR7:
1419 case APIC_OFFSET_IRR0 ... APIC_OFFSET_IRR7:
1420 case APIC_OFFSET_TIMER_CCR:
1430 vlapic_reset(struct vlapic *vlapic)
1432 struct LAPIC *lapic;
1434 lapic = vlapic->apic_page;
1435 bzero(lapic, sizeof(struct LAPIC));
1437 lapic->id = vlapic_get_id(vlapic);
1438 lapic->version = VLAPIC_VERSION;
1439 lapic->version |= (VLAPIC_MAXLVT_INDEX << MAXLVTSHIFT);
1440 lapic->dfr = 0xffffffff;
1441 lapic->svr = APIC_SVR_VECTOR;
1442 vlapic_mask_lvts(vlapic);
1443 vlapic_reset_tmr(vlapic);
1445 lapic->dcr_timer = 0;
1446 vlapic_dcr_write_handler(vlapic);
1448 if (vlapic->vcpuid == 0)
1449 vlapic->boot_state = BS_RUNNING; /* BSP */
1451 vlapic->boot_state = BS_INIT; /* AP */
1453 vlapic->svr_last = lapic->svr;
1457 vlapic_init(struct vlapic *vlapic)
1459 KASSERT(vlapic->vm != NULL, ("vlapic_init: vm is not initialized"));
1460 KASSERT(vlapic->vcpuid >= 0 &&
1461 vlapic->vcpuid < vm_get_maxcpus(vlapic->vm),
1462 ("vlapic_init: vcpuid is not initialized"));
1463 KASSERT(vlapic->apic_page != NULL, ("vlapic_init: apic_page is not "
1467 * If the vlapic is configured in x2apic mode then it will be
1468 * accessed in the critical section via the MSR emulation code.
1470 * Therefore the timer mutex must be a spinlock because blockable
1471 * mutexes cannot be acquired in a critical section.
1473 mtx_init(&vlapic->timer_mtx, "vlapic timer mtx", NULL, MTX_SPIN);
1474 callout_init(&vlapic->callout, 1);
1476 vlapic->msr_apicbase = DEFAULT_APIC_BASE | APICBASE_ENABLED;
1478 if (vlapic->vcpuid == 0)
1479 vlapic->msr_apicbase |= APICBASE_BSP;
1481 vlapic_reset(vlapic);
1485 vlapic_cleanup(struct vlapic *vlapic)
1488 callout_drain(&vlapic->callout);
1492 vlapic_get_apicbase(struct vlapic *vlapic)
1495 return (vlapic->msr_apicbase);
1499 vlapic_set_apicbase(struct vlapic *vlapic, uint64_t new)
1502 if (vlapic->msr_apicbase != new) {
1503 VLAPIC_CTR2(vlapic, "Changing APIC_BASE MSR from %#lx to %#lx "
1504 "not supported", vlapic->msr_apicbase, new);
1512 vlapic_set_x2apic_state(struct vm *vm, int vcpuid, enum x2apic_state state)
1514 struct vlapic *vlapic;
1515 struct LAPIC *lapic;
1517 vlapic = vm_lapic(vm, vcpuid);
1519 if (state == X2APIC_DISABLED)
1520 vlapic->msr_apicbase &= ~APICBASE_X2APIC;
1522 vlapic->msr_apicbase |= APICBASE_X2APIC;
1525 * Reset the local APIC registers whose values are mode-dependent.
1527 * XXX this works because the APIC mode can be changed only at vcpu
1528 * initialization time.
1530 lapic = vlapic->apic_page;
1531 lapic->id = vlapic_get_id(vlapic);
1532 if (x2apic(vlapic)) {
1533 lapic->ldr = x2apic_ldr(vlapic);
1537 lapic->dfr = 0xffffffff;
1540 if (state == X2APIC_ENABLED) {
1541 if (vlapic->ops.enable_x2apic_mode)
1542 (*vlapic->ops.enable_x2apic_mode)(vlapic);
1547 vlapic_deliver_intr(struct vm *vm, bool level, uint32_t dest, bool phys,
1548 int delmode, int vec)
1554 if (delmode != IOART_DELFIXED &&
1555 delmode != IOART_DELLOPRI &&
1556 delmode != IOART_DELEXINT) {
1557 VM_CTR1(vm, "vlapic intr invalid delmode %#x", delmode);
1560 lowprio = (delmode == IOART_DELLOPRI);
1563 * We don't provide any virtual interrupt redirection hardware so
1564 * all interrupts originating from the ioapic or MSI specify the
1565 * 'dest' in the legacy xAPIC format.
1567 vlapic_calcdest(vm, &dmask, dest, phys, lowprio, false);
1569 while ((vcpuid = CPU_FFS(&dmask)) != 0) {
1571 CPU_CLR(vcpuid, &dmask);
1572 if (delmode == IOART_DELEXINT) {
1573 vm_inject_extint(vm, vcpuid);
1575 lapic_set_intr(vm, vcpuid, vec, level);
1581 vlapic_post_intr(struct vlapic *vlapic, int hostcpu, int ipinum)
1584 * Post an interrupt to the vcpu currently running on 'hostcpu'.
1586 * This is done by leveraging features like Posted Interrupts (Intel)
1587 * Doorbell MSR (AMD AVIC) that avoid a VM exit.
1589 * If neither of these features are available then fallback to
1590 * sending an IPI to 'hostcpu'.
1592 if (vlapic->ops.post_intr)
1593 (*vlapic->ops.post_intr)(vlapic, hostcpu);
1595 ipi_cpu(hostcpu, ipinum);
1599 vlapic_enabled(struct vlapic *vlapic)
1601 struct LAPIC *lapic = vlapic->apic_page;
1603 if ((vlapic->msr_apicbase & APICBASE_ENABLED) != 0 &&
1604 (lapic->svr & APIC_SVR_ENABLE) != 0)
1611 vlapic_set_tmr(struct vlapic *vlapic, int vector, bool level)
1613 struct LAPIC *lapic;
1614 uint32_t *tmrptr, mask;
1617 lapic = vlapic->apic_page;
1618 tmrptr = &lapic->tmr0;
1619 idx = (vector / 32) * 4;
1620 mask = 1 << (vector % 32);
1622 tmrptr[idx] |= mask;
1624 tmrptr[idx] &= ~mask;
1626 if (vlapic->ops.set_tmr != NULL)
1627 (*vlapic->ops.set_tmr)(vlapic, vector, level);
1631 vlapic_reset_tmr(struct vlapic *vlapic)
1635 VLAPIC_CTR0(vlapic, "vlapic resetting all vectors to edge-triggered");
1637 for (vector = 0; vector <= 255; vector++)
1638 vlapic_set_tmr(vlapic, vector, false);
1642 vlapic_set_tmr_level(struct vlapic *vlapic, uint32_t dest, bool phys,
1643 int delmode, int vector)
1648 KASSERT(vector >= 0 && vector <= 255, ("invalid vector %d", vector));
1651 * A level trigger is valid only for fixed and lowprio delivery modes.
1653 if (delmode != APIC_DELMODE_FIXED && delmode != APIC_DELMODE_LOWPRIO) {
1654 VLAPIC_CTR1(vlapic, "Ignoring level trigger-mode for "
1655 "delivery-mode %d", delmode);
1659 lowprio = (delmode == APIC_DELMODE_LOWPRIO);
1660 vlapic_calcdest(vlapic->vm, &dmask, dest, phys, lowprio, false);
1662 if (!CPU_ISSET(vlapic->vcpuid, &dmask))
1665 VLAPIC_CTR1(vlapic, "vector %d set to level-triggered", vector);
1666 vlapic_set_tmr(vlapic, vector, true);