root/sys/x86/x86/local_apic.c
/*-
 * SPDX-License-Identifier: BSD-3-Clause
 *
 * Copyright (c) 1996, by Steve Passe
 * All rights reserved.
 * Copyright (c) 2003 John Baldwin <jhb@FreeBSD.org>
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. The name of the developer may NOT be used to endorse or promote products
 *    derived from this software without specific prior written permission.
 * 3. Neither the name of the author nor the names of any co-contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

/*
 * Local APIC support on Pentium and later processors.
 */

#include <sys/cdefs.h>
#include "opt_atpic.h"

#include "opt_ddb.h"

#include <sys/param.h>
#include <sys/systm.h>
#include <sys/asan.h>
#include <sys/bus.h>
#include <sys/kernel.h>
#include <sys/lock.h>
#include <sys/malloc.h>
#include <sys/msan.h>
#include <sys/mutex.h>
#include <sys/pcpu.h>
#include <sys/proc.h>
#include <sys/refcount.h>
#include <sys/sched.h>
#include <sys/smp.h>
#include <sys/sysctl.h>
#include <sys/timeet.h>
#include <sys/timetc.h>

#include <vm/vm.h>
#include <vm/pmap.h>

#include <x86/apicreg.h>
#include <machine/atomic.h>
#include <machine/clock.h>
#include <machine/cpufunc.h>
#include <machine/cputypes.h>
#include <machine/fpu.h>
#include <machine/frame.h>
#include <machine/intr_machdep.h>
#include <x86/apicvar.h>
#include <x86/mca.h>
#include <machine/md_var.h>
#include <machine/smp.h>
#include <machine/specialreg.h>
#include <x86/init.h>
#include <x86/kvm.h>
#include <contrib/xen/arch-x86/cpuid.h>
#include <x86/bhyve.h>
#include <dev/hyperv/vmbus/x86/hyperv_reg.h>

#ifdef DDB
#include <sys/interrupt.h>
#include <ddb/ddb.h>
#endif

#ifdef __amd64__
#define SDT_APIC        SDT_SYSIGT
#define GSEL_APIC       0
#else
#define SDT_APIC        SDT_SYS386IGT
#define GSEL_APIC       GSEL(GCODE_SEL, SEL_KPL)
#endif

static MALLOC_DEFINE(M_LAPIC, "local_apic", "Local APIC items");

/* Sanity checks on IDT vectors. */
CTASSERT(APIC_IO_INTS + APIC_NUM_IOINTS == APIC_TIMER_INT);
CTASSERT(APIC_TIMER_INT < APIC_LOCAL_INTS);
CTASSERT(APIC_LOCAL_INTS == 240);
CTASSERT(IPI_STOP < APIC_SPURIOUS_INT);

/*
 * I/O interrupts use non-negative IRQ values.  These values are used
 * to mark unused IDT entries or IDT entries reserved for a non-I/O
 * interrupt.
 */
#define IRQ_FREE        -1
#define IRQ_TIMER       -2
#define IRQ_SYSCALL     -3
#define IRQ_DTRACE_RET  -4
#define IRQ_EVTCHN      -5

enum lat_timer_mode {
        LAT_MODE_UNDEF =        0,
        LAT_MODE_PERIODIC =     1,
        LAT_MODE_ONESHOT =      2,
        LAT_MODE_DEADLINE =     3,
};

/*
 * Support for local APICs.  Local APICs manage interrupts on each
 * individual processor as opposed to I/O APICs which receive interrupts
 * from I/O devices and then forward them on to the local APICs.
 *
 * Local APICs can also send interrupts to each other thus providing the
 * mechanism for IPIs.
 */

struct lvt {
        u_int lvt_edgetrigger:1;
        u_int lvt_activehi:1;
        u_int lvt_masked:1;
        u_int lvt_active:1;
        u_int lvt_mode:16;
        u_int lvt_vector:8;
        u_int lvt_reg;
        const char *lvt_desc;
};

struct lapic {
        struct lvt la_lvts[APIC_LVT_MAX + 1];
        struct lvt la_elvts[APIC_ELVT_MAX + 1];
        u_int la_id:8;
        u_int la_cluster:4;
        u_int la_cluster_id:2;
        u_int la_present:1;
        u_long *la_timer_count;
        uint64_t la_timer_period;
        enum lat_timer_mode la_timer_mode;
        uint32_t lvt_timer_base;
        uint32_t lvt_timer_last;
        /* Include IDT_SYSCALL to make indexing easier. */
        int la_ioint_irqs[APIC_NUM_IOINTS + 1];
} static *lapics;

/* Global defaults for local APIC LVT entries. */
static struct lvt lvts[] = {
        /* LINT0: masked ExtINT */
        [APIC_LVT_LINT0] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 1,
                .lvt_active = 1,
                .lvt_mode = APIC_LVT_DM_EXTINT,
                .lvt_vector = 0,
                .lvt_reg = LAPIC_LVT_LINT0,
                .lvt_desc = "LINT0",
        },
        /* LINT1: NMI */
        [APIC_LVT_LINT1] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 0,
                .lvt_active = 1,
                .lvt_mode = APIC_LVT_DM_NMI,
                .lvt_vector = 0,
                .lvt_reg = LAPIC_LVT_LINT1,
                .lvt_desc = "LINT1",
        },
        [APIC_LVT_TIMER] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 1,
                .lvt_active = 1,
                .lvt_mode = APIC_LVT_DM_FIXED,
                .lvt_vector = APIC_TIMER_INT,
                .lvt_reg = LAPIC_LVT_TIMER,
                .lvt_desc = "TIMER",
        },
        [APIC_LVT_ERROR] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 0,
                .lvt_active = 1,
                .lvt_mode = APIC_LVT_DM_FIXED,
                .lvt_vector = APIC_ERROR_INT,
                .lvt_reg = LAPIC_LVT_ERROR,
                .lvt_desc = "ERROR",
        },
        [APIC_LVT_PMC] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 1,
                .lvt_active = 1,
                .lvt_mode = APIC_LVT_DM_NMI,
                .lvt_vector = 0,
                .lvt_reg = LAPIC_LVT_PCINT,
                .lvt_desc = "PMC",
        },
        [APIC_LVT_THERMAL] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 1,
                .lvt_active = 1,
                .lvt_mode = APIC_LVT_DM_FIXED,
                .lvt_vector = APIC_THERMAL_INT,
                .lvt_reg = LAPIC_LVT_THERMAL,
                .lvt_desc = "THERM",
        },
        [APIC_LVT_CMCI] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 1,
                .lvt_active = 1,
                .lvt_mode = APIC_LVT_DM_FIXED,
                .lvt_vector = APIC_CMC_INT,
                .lvt_reg = LAPIC_LVT_CMCI,
                .lvt_desc = "CMCI",
        },
};

/* Global defaults for AMD local APIC ELVT entries. */
static struct lvt elvts[] = {
        [APIC_ELVT_IBS] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 1,
                .lvt_active = 1,
                .lvt_mode = APIC_LVT_DM_NMI,
                .lvt_vector = 0,
                .lvt_reg = LAPIC_EXT_LVT0,
                .lvt_desc = "IBS",
        },
        [APIC_ELVT_MCA] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 1,
                .lvt_active = 0,
                .lvt_mode = APIC_LVT_DM_FIXED,
                .lvt_vector = APIC_CMC_INT,
                .lvt_reg = LAPIC_EXT_LVT1,
                .lvt_desc = "MCA",
        },
        [APIC_ELVT_DEI] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 1,
                .lvt_active = 0,
                .lvt_mode = APIC_LVT_DM_FIXED,
                .lvt_vector = 0,
                .lvt_reg = LAPIC_EXT_LVT2,
                .lvt_desc = "ELVT2",
        },
        [APIC_ELVT_SBI] = {
                .lvt_edgetrigger = 1,
                .lvt_activehi = 1,
                .lvt_masked = 1,
                .lvt_active = 0,
                .lvt_mode = APIC_LVT_DM_FIXED,
                .lvt_vector = 0,
                .lvt_reg = LAPIC_EXT_LVT3,
                .lvt_desc = "ELVT3",
        },
};

static inthand_t *ioint_handlers[] = {
        NULL,                   /* 0 - 31 */
        IDTVEC(apic_isr1),      /* 32 - 63 */
        IDTVEC(apic_isr2),      /* 64 - 95 */
        IDTVEC(apic_isr3),      /* 96 - 127 */
        IDTVEC(apic_isr4),      /* 128 - 159 */
        IDTVEC(apic_isr5),      /* 160 - 191 */
        IDTVEC(apic_isr6),      /* 192 - 223 */
        IDTVEC(apic_isr7),      /* 224 - 255 */
};

static inthand_t *ioint_pti_handlers[] = {
        NULL,                   /* 0 - 31 */
        IDTVEC(apic_isr1_pti),  /* 32 - 63 */
        IDTVEC(apic_isr2_pti),  /* 64 - 95 */
        IDTVEC(apic_isr3_pti),  /* 96 - 127 */
        IDTVEC(apic_isr4_pti),  /* 128 - 159 */
        IDTVEC(apic_isr5_pti),  /* 160 - 191 */
        IDTVEC(apic_isr6_pti),  /* 192 - 223 */
        IDTVEC(apic_isr7_pti),  /* 224 - 255 */
};

static u_int32_t lapic_timer_divisors[] = {
        APIC_TDCR_1, APIC_TDCR_2, APIC_TDCR_4, APIC_TDCR_8, APIC_TDCR_16,
        APIC_TDCR_32, APIC_TDCR_64, APIC_TDCR_128
};

extern inthand_t IDTVEC(rsvd_pti), IDTVEC(rsvd);

volatile char *lapic_map;
vm_paddr_t lapic_paddr = DEFAULT_APIC_BASE;
int x2apic_mode;
int lapic_eoi_suppression;
static int lapic_timer_tsc_deadline;
static u_long lapic_timer_divisor, count_freq;
static struct eventtimer lapic_et;
#ifdef SMP
static uint64_t lapic_ipi_wait_mult;
static int __read_mostly lapic_ds_idle_timeout = 1000000;
#endif
unsigned int max_apic_id;
static lapic_thermal_handler_t *lapic_thermal_function;
static void *lapic_thermal_function_arg;
static int pcint_refcnt = 0;

SYSCTL_NODE(_hw, OID_AUTO, apic, CTLFLAG_RD | CTLFLAG_MPSAFE, 0,
    "APIC options");
SYSCTL_INT(_hw_apic, OID_AUTO, x2apic_mode, CTLFLAG_RD, &x2apic_mode, 0, "");
SYSCTL_INT(_hw_apic, OID_AUTO, eoi_suppression, CTLFLAG_RD,
    &lapic_eoi_suppression, 0, "");
SYSCTL_INT(_hw_apic, OID_AUTO, timer_tsc_deadline, CTLFLAG_RD,
    &lapic_timer_tsc_deadline, 0, "");
#ifdef SMP
SYSCTL_INT(_hw_apic, OID_AUTO, ds_idle_timeout, CTLFLAG_RWTUN,
    &lapic_ds_idle_timeout, 0,
    "timeout (in us) for APIC Delivery Status to become Idle (xAPIC only)");
#endif

static void lapic_calibrate_initcount(struct lapic *la);

/*
 * Use __nosanitizethread to exempt the LAPIC I/O accessors from KCSan
 * instrumentation.  Otherwise, if x2APIC is not available, use of the global
 * lapic_map will generate a KCSan false positive.  While the mapping is
 * shared among all CPUs, the physical access will always take place on the
 * local CPU's APIC, so there isn't in fact a race here.  Furthermore, the
 * KCSan warning printf can cause a panic if issued during LAPIC access,
 * due to attempted recursive use of event timer resources.
 */

static uint32_t __nosanitizethread
lapic_read32(enum LAPIC_REGISTERS reg)
{
        uint32_t res;

        if (x2apic_mode) {
                res = rdmsr32(MSR_APIC_000 + reg);
        } else {
                res = *(volatile uint32_t *)(lapic_map + reg * LAPIC_MEM_MUL);
        }
        return (res);
}

static void __nosanitizethread
lapic_write32(enum LAPIC_REGISTERS reg, uint32_t val)
{

        if (x2apic_mode) {
                mfence();
                lfence();
                wrmsr(MSR_APIC_000 + reg, val);
        } else {
                *(volatile uint32_t *)(lapic_map + reg * LAPIC_MEM_MUL) = val;
        }
}

static void __nosanitizethread
lapic_write32_nofence(enum LAPIC_REGISTERS reg, uint32_t val)
{

        if (x2apic_mode) {
                wrmsr(MSR_APIC_000 + reg, val);
        } else {
                *(volatile uint32_t *)(lapic_map + reg * LAPIC_MEM_MUL) = val;
        }
}

static inline uint32_t __pure2
lapic_version(void)
{
        return (lapic_read32(LAPIC_VERSION));
}

/*
 * Calculate the max index of the present LVT entry from the value of
 * the LAPIC version register.
 */
static inline int __pure2
lapic_version_maxlvt(uint32_t version)
{
        return ((version & APIC_VER_MAXLVT) >> MAXLVTSHIFT);
}

static inline int __pure2
lapic_maxlvt(void)
{
        return (lapic_version_maxlvt(lapic_version()));
}

#ifdef SMP
static uint64_t
lapic_read_icr_lo(void)
{

        return (lapic_read32(LAPIC_ICR_LO));
}

static void
lapic_write_icr(uint32_t vhi, uint32_t vlo)
{
        register_t saveintr;
        uint64_t v;

        if (x2apic_mode) {
                v = ((uint64_t)vhi << 32) | vlo;
                mfence();
                wrmsr(MSR_APIC_000 + LAPIC_ICR_LO, v);
        } else {
                saveintr = intr_disable();
                lapic_write32(LAPIC_ICR_HI, vhi);
                lapic_write32(LAPIC_ICR_LO, vlo);
                intr_restore(saveintr);
        }
}

static void
lapic_write_icr_lo(uint32_t vlo)
{

        if (x2apic_mode) {
                mfence();
                wrmsr(MSR_APIC_000 + LAPIC_ICR_LO, vlo);
        } else {
                lapic_write32(LAPIC_ICR_LO, vlo);
        }
}

static void
lapic_write_self_ipi(uint32_t vector)
{

        KASSERT(x2apic_mode, ("SELF IPI write in xAPIC mode"));
        wrmsr(MSR_APIC_000 + LAPIC_SELF_IPI, vector);
}
#endif /* SMP */

static void
lapic_enable_x2apic(void)
{
        uint64_t apic_base;

        apic_base = rdmsr(MSR_APICBASE);
        apic_base |= APICBASE_X2APIC | APICBASE_ENABLED;
        wrmsr(MSR_APICBASE, apic_base);
}

bool
lapic_is_x2apic(void)
{
        uint64_t apic_base;

        apic_base = rdmsr(MSR_APICBASE);
        return ((apic_base & (APICBASE_X2APIC | APICBASE_ENABLED)) ==
            (APICBASE_X2APIC | APICBASE_ENABLED));
}

static void     lapic_early_mask_vecs(void);
static void     lapic_enable(void);
static void     lapic_resume(struct pic *pic, bool suspend_cancelled);
static void     lapic_timer_oneshot(struct lapic *);
static void     lapic_timer_oneshot_nointr(struct lapic *, uint32_t);
static void     lapic_timer_periodic(struct lapic *);
static void     lapic_timer_deadline(struct lapic *);
static void     lapic_timer_stop(struct lapic *);
static void     lapic_timer_set_divisor(u_int divisor);
static uint32_t lvt_mode(struct lapic *la, u_int pin, uint32_t value);
static int      lapic_et_start(struct eventtimer *et,
                    sbintime_t first, sbintime_t period);
static int      lapic_et_stop(struct eventtimer *et);
static u_int    apic_idt_to_irq(u_int apic_id, u_int vector);
static void     lapic_set_tpr(u_int vector);

struct pic lapic_pic = { .pic_resume = lapic_resume };

static uint32_t
lvt_mode_impl(struct lapic *la, struct lvt *lvt, u_int pin, uint32_t value)
{

        value &= ~(APIC_LVT_M | APIC_LVT_TM | APIC_LVT_IIPP | APIC_LVT_DM |
            APIC_LVT_VECTOR);
        if (lvt->lvt_edgetrigger == 0)
                value |= APIC_LVT_TM;
        if (lvt->lvt_activehi == 0)
                value |= APIC_LVT_IIPP_INTALO;
        if (lvt->lvt_masked)
                value |= APIC_LVT_M;
        value |= lvt->lvt_mode;
        switch (lvt->lvt_mode) {
        case APIC_LVT_DM_NMI:
        case APIC_LVT_DM_SMI:
        case APIC_LVT_DM_INIT:
        case APIC_LVT_DM_EXTINT:
                if (!lvt->lvt_edgetrigger) {
                        if (bootverbose) {
                                printf(
                                    "lapic%u: Forcing LINT%u to edge trigger\n",
                                    la->la_id, pin);
                        }
                        value &= ~APIC_LVT_TM;
                }
                /* Use a vector of 0. */
                break;
        case APIC_LVT_DM_FIXED:
                value |= lvt->lvt_vector;
                break;
        default:
                panic("bad APIC LVT delivery mode: %#x\n", value);
        }
        return (value);
}

static uint32_t
lvt_mode(struct lapic *la, u_int pin, uint32_t value)
{
        struct lvt *lvt;

        KASSERT(pin <= APIC_LVT_MAX,
            ("%s: pin %u out of range", __func__, pin));
        if (la->la_lvts[pin].lvt_active)
                lvt = &la->la_lvts[pin];
        else
                lvt = &lvts[pin];

        return (lvt_mode_impl(la, lvt, pin, value));
}

static uint32_t
elvt_mode(struct lapic *la, u_int idx, uint32_t value)
{
        struct lvt *elvt;

        KASSERT(idx <= APIC_ELVT_MAX,
            ("%s: idx %u out of range", __func__, idx));

        if (la->la_elvts[idx].lvt_active)
            elvt = &la->la_elvts[idx];
        else
            elvt = &elvts[idx];
        KASSERT(elvt->lvt_active, ("%s: ELVT%u is not active", __func__, idx));
        KASSERT(elvt->lvt_edgetrigger,
            ("%s: ELVT%u is not edge triggered", __func__, idx));
        KASSERT(elvt->lvt_activehi,
            ("%s: ELVT%u is not active high", __func__, idx));
        return (lvt_mode_impl(la, elvt, idx, value));
}

/*
 * Map the local APIC and setup necessary interrupt vectors.
 */
void
lapic_init(vm_paddr_t addr)
{
#ifdef SMP
        uint64_t r, r1, r2, rx;
#endif
        uint32_t ver;
        int i;
        bool arat;

        TSENTER();

        /*
         * Enable x2APIC mode if possible. Map the local APIC
         * registers page.
         *
         * Keep the LAPIC registers page mapped uncached for x2APIC
         * mode too, to have direct map page attribute set to
         * uncached.  This is needed to work around CPU errata present
         * on all Intel processors.
         */
        KASSERT(trunc_page(addr) == addr,
            ("local APIC not aligned on a page boundary"));
        lapic_paddr = addr;
        lapic_map = pmap_mapdev(addr, PAGE_SIZE);
        if (x2apic_mode) {
                lapic_enable_x2apic();
                lapic_map = NULL;
        }

        /* Setup the spurious interrupt handler. */
        setidt(APIC_SPURIOUS_INT, IDTVEC(spuriousint), SDT_APIC, SEL_KPL,
            GSEL_APIC);

        /* Perform basic initialization of the BSP's local APIC. */
        lapic_enable();
        lapic_early_mask_vecs();

        /* Set BSP's per-CPU local APIC ID. */
        PCPU_SET(apic_id, lapic_id());

        /* Local APIC timer interrupt. */
        setidt(APIC_TIMER_INT, pti ? IDTVEC(timerint_pti) : IDTVEC(timerint),
            SDT_APIC, SEL_KPL, GSEL_APIC);

        /* Local APIC error interrupt. */
        setidt(APIC_ERROR_INT, pti ? IDTVEC(errorint_pti) : IDTVEC(errorint),
            SDT_APIC, SEL_KPL, GSEL_APIC);

        /* Thermal interrupt */
        setidt(APIC_THERMAL_INT, pti ? IDTVEC(thermalint_pti) : IDTVEC(thermalint),
            SDT_APIC, SEL_KPL, GSEL_APIC);

        /* Local APIC CMCI. */
        setidt(APIC_CMC_INT, pti ? IDTVEC(cmcint_pti) : IDTVEC(cmcint),
            SDT_APIC, SEL_KPL, GSEL_APIC);

        if ((resource_int_value("apic", 0, "clock", &i) != 0 || i != 0)) {
                /* Set if APIC timer runs in C3. */
                arat = (cpu_power_eax & CPUTPM1_ARAT);

                bzero(&lapic_et, sizeof(lapic_et));
                lapic_et.et_name = "LAPIC";
                lapic_et.et_flags = ET_FLAGS_PERIODIC | ET_FLAGS_ONESHOT |
                    ET_FLAGS_PERCPU;
                lapic_et.et_quality = 600;
                if (!arat) {
                        lapic_et.et_flags |= ET_FLAGS_C3STOP;
                        lapic_et.et_quality = 100;
                }
                if ((cpu_feature & CPUID_TSC) != 0 &&
                    (cpu_feature2 & CPUID2_TSCDLT) != 0 &&
                    tsc_is_invariant && tsc_freq != 0) {
                        lapic_timer_tsc_deadline = 1;
                        TUNABLE_INT_FETCH("hw.apic.timer_tsc_deadline",
                            &lapic_timer_tsc_deadline);
                }

                lapic_et.et_frequency = 0;
                /* We don't know frequency yet, so trying to guess. */
                lapic_et.et_min_period = 0x00001000LL;
                lapic_et.et_max_period = SBT_1S;
                lapic_et.et_start = lapic_et_start;
                lapic_et.et_stop = lapic_et_stop;
                lapic_et.et_priv = NULL;
                et_register(&lapic_et);
        }

        /*
         * Set lapic_eoi_suppression after lapic_enable(), to not
         * enable suppression in the hardware prematurely.  Note that
         * we by default enable suppression even when system only has
         * one IO-APIC, since EOI is broadcasted to all APIC agents,
         * including CPUs, otherwise.
         *
         * It seems that at least some KVM versions report
         * EOI_SUPPRESSION bit, but auto-EOI does not work.
         */
        ver = lapic_version();
        if ((ver & APIC_VER_EOI_SUPPRESSION) != 0) {
                lapic_eoi_suppression = 1;
                if (vm_guest == VM_GUEST_KVM) {
                        if (bootverbose)
                                printf(
                       "KVM -- disabling lapic eoi suppression\n");
                        lapic_eoi_suppression = 0;
                }
                TUNABLE_INT_FETCH("hw.apic.eoi_suppression",
                    &lapic_eoi_suppression);
        }

#ifdef SMP
#define LOOPS   1000
        /*
         * Calibrate the busy loop waiting for IPI ack in xAPIC mode.
         * lapic_ipi_wait_mult contains the number of iterations which
         * approximately delay execution for 1 microsecond (the
         * argument to lapic_ipi_wait() is in microseconds).
         *
         * We assume that TSC is present and already measured.
         * Possible TSC frequency jumps are irrelevant to the
         * calibration loop below, the CPU clock management code is
         * not yet started, and we do not enter sleep states.
         */
        KASSERT((cpu_feature & CPUID_TSC) != 0 && tsc_freq != 0,
            ("TSC not initialized"));
        if (!x2apic_mode) {
                r = rdtsc();
                for (rx = 0; rx < LOOPS; rx++) {
                        (void)lapic_read_icr_lo();
                        ia32_pause();
                }
                r = rdtsc() - r;
                r1 = tsc_freq * LOOPS;
                r2 = r * 1000000;
                lapic_ipi_wait_mult = r1 >= r2 ? r1 / r2 : 1;
                if (bootverbose) {
                        printf("LAPIC: ipi_wait() us multiplier %ju (r %ju "
                            "tsc %ju)\n", (uintmax_t)lapic_ipi_wait_mult,
                            (uintmax_t)r, (uintmax_t)tsc_freq);
                }
        }
#undef LOOPS
#endif /* SMP */

        TSEXIT();
}

/*
 * Create a local APIC instance.
 */
void
lapic_create(u_int apic_id, int boot_cpu)
{
        int i;

        if (apic_id > max_apic_id) {
                printf("APIC: Ignoring local APIC with ID %d\n", apic_id);
                if (boot_cpu)
                        panic("Can't ignore BSP");
                return;
        }
        KASSERT(!lapics[apic_id].la_present, ("duplicate local APIC %u",
            apic_id));

        /*
         * Assume no local LVT overrides and a cluster of 0 and
         * intra-cluster ID of 0.
         */
        lapics[apic_id].la_present = 1;
        lapics[apic_id].la_id = apic_id;
        for (i = 0; i <= APIC_LVT_MAX; i++) {
                lapics[apic_id].la_lvts[i] = lvts[i];
                lapics[apic_id].la_lvts[i].lvt_active = 0;
        }
        for (i = 0; i <= APIC_ELVT_MAX; i++) {
                lapics[apic_id].la_elvts[i] = elvts[i];
                lapics[apic_id].la_elvts[i].lvt_active = 0;
        }
        for (i = 0; i <= APIC_NUM_IOINTS; i++)
            lapics[apic_id].la_ioint_irqs[i] = IRQ_FREE;
        lapics[apic_id].la_ioint_irqs[IDT_SYSCALL - APIC_IO_INTS] = IRQ_SYSCALL;
        lapics[apic_id].la_ioint_irqs[APIC_TIMER_INT - APIC_IO_INTS] =
            IRQ_TIMER;
#ifdef KDTRACE_HOOKS
        lapics[apic_id].la_ioint_irqs[IDT_DTRACE_RET - APIC_IO_INTS] =
            IRQ_DTRACE_RET;
#endif
#ifdef XENHVM
        lapics[apic_id].la_ioint_irqs[IDT_EVTCHN - APIC_IO_INTS] = IRQ_EVTCHN;
#endif

#ifdef SMP
        cpu_add(apic_id, boot_cpu);
#endif
}

static inline uint32_t
amd_read_ext_features(void)
{
        uint32_t version;

        if (cpu_vendor_id != CPU_VENDOR_AMD &&
            cpu_vendor_id != CPU_VENDOR_HYGON)
                return (0);
        version = lapic_version();
        if ((version & APIC_VER_AMD_EXT_SPACE) != 0)
                return (lapic_read32(LAPIC_EXT_FEATURES));
        else
                return (0);
}

static inline uint32_t
amd_read_elvt_count(void)
{
        uint32_t extf;
        uint32_t count;

        extf = amd_read_ext_features();
        count = (extf & APIC_EXTF_ELVT_MASK) >> APIC_EXTF_ELVT_SHIFT;
        count = min(count, APIC_ELVT_MAX + 1);
        return (count);
}

/*
 * Dump contents of local APIC registers
 */
void
lapic_dump(const char* str)
{
        const uint32_t version = lapic_version();
        const int maxlvt = lapic_version_maxlvt(version);
        uint32_t extf;
        int elvt_count;
        int i;

        printf("cpu%d %s:\n", PCPU_GET(cpuid), str);
        printf("     ID: 0x%08x   VER: 0x%08x LDR: 0x%08x DFR: 0x%08x",
            lapic_read32(LAPIC_ID), version,
            lapic_read32(LAPIC_LDR), x2apic_mode ? 0 : lapic_read32(LAPIC_DFR));
        if ((cpu_feature2 & CPUID2_X2APIC) != 0)
                printf(" x2APIC: %d", x2apic_mode);
        printf("\n  lint0: 0x%08x lint1: 0x%08x TPR: 0x%08x SVR: 0x%08x\n",
            lapic_read32(LAPIC_LVT_LINT0), lapic_read32(LAPIC_LVT_LINT1),
            lapic_read32(LAPIC_TPR), lapic_read32(LAPIC_SVR));
        printf("  timer: 0x%08x err: 0x%08x", lapic_read32(LAPIC_LVT_TIMER),
            lapic_read32(LAPIC_LVT_ERROR));
        if (maxlvt >= APIC_LVT_THERMAL)
                printf(" therm: 0x%08x", lapic_read32(LAPIC_LVT_THERMAL));
        if (maxlvt >= APIC_LVT_PMC)
                printf(" pmc: 0x%08x", lapic_read32(LAPIC_LVT_PCINT));
        printf("\n");
        if (maxlvt >= APIC_LVT_CMCI)
                printf("   cmci: 0x%08x\n", lapic_read32(LAPIC_LVT_CMCI));
        extf = amd_read_ext_features();
        if (extf != 0) {
                printf("   AMD ext features: 0x%08x", extf);
                elvt_count = amd_read_elvt_count();
                for (i = 0; i < elvt_count; i++)
                        printf("%s elvt%d: 0x%08x", (i % 4) ? "" : "\n ", i,
                            lapic_read32(LAPIC_EXT_LVT0 + i));
                printf("\n");
        }
}

void
lapic_xapic_mode(void)
{
        register_t saveintr;

        saveintr = intr_disable();
        if (x2apic_mode)
                lapic_enable_x2apic();
        intr_restore(saveintr);
}

static void
lapic_early_mask_vec(const struct lvt *l)
{
        uint32_t v;

        if (l->lvt_masked != 0) {
                v = lapic_read32(l->lvt_reg);
                v |= APIC_LVT_M;
                lapic_write32(l->lvt_reg, v);
        }
}

/* Done on BSP only */
static void
lapic_early_mask_vecs(void)
{
        int elvt_count, lvts_count, i;

        lvts_count = min(nitems(lvts), lapic_maxlvt() + 1);
        for (i = 0; i < lvts_count; i++)
                lapic_early_mask_vec(&lvts[i]);

        elvt_count = amd_read_elvt_count();
        for (i = 0; i < elvt_count; i++)
                lapic_early_mask_vec(&elvts[i]);
}

void
lapic_setup(int boot)
{
        const uint32_t version = lapic_version();
        const uint32_t maxlvt = lapic_version_maxlvt(version);
        struct lapic *la;
        register_t saveintr;
        int elvt_count;
        int i;

        saveintr = intr_disable();

        la = &lapics[lapic_id()];
        KASSERT(la->la_present, ("missing APIC structure"));

        /* Initialize the TPR to allow all interrupts. */
        lapic_set_tpr(0);

        /* Setup spurious vector and enable the local APIC. */
        lapic_enable();

        /* Program LINT[01] LVT entries. */
        lapic_write32(LAPIC_LVT_LINT0, lvt_mode(la, APIC_LVT_LINT0,
            lapic_read32(LAPIC_LVT_LINT0)));
        lapic_write32(LAPIC_LVT_LINT1, lvt_mode(la, APIC_LVT_LINT1,
            lapic_read32(LAPIC_LVT_LINT1)));

        /* Program the PMC LVT entry if present. */
        if (maxlvt >= APIC_LVT_PMC) {
                lapic_write32(LAPIC_LVT_PCINT, lvt_mode(la, APIC_LVT_PMC,
                    LAPIC_LVT_PCINT));
        }

        /*
         * Program the timer LVT.  Calibration is deferred until it is certain
         * that we have a reliable timecounter.
         */
        la->lvt_timer_base = lvt_mode(la, APIC_LVT_TIMER,
            lapic_read32(LAPIC_LVT_TIMER));
        la->lvt_timer_last = la->lvt_timer_base;
        lapic_write32(LAPIC_LVT_TIMER, la->lvt_timer_base);

        if (boot)
                la->la_timer_mode = LAT_MODE_UNDEF;
        else if (la->la_timer_mode != LAT_MODE_UNDEF) {
                KASSERT(la->la_timer_period != 0, ("lapic%u: zero divisor",
                    lapic_id()));
                switch (la->la_timer_mode) {
                case LAT_MODE_PERIODIC:
                        lapic_timer_set_divisor(lapic_timer_divisor);
                        lapic_timer_periodic(la);
                        break;
                case LAT_MODE_ONESHOT:
                        lapic_timer_set_divisor(lapic_timer_divisor);
                        lapic_timer_oneshot(la);
                        break;
                case LAT_MODE_DEADLINE:
                        lapic_timer_deadline(la);
                        break;
                default:
                        panic("corrupted la_timer_mode %p %d", la,
                            la->la_timer_mode);
                }
        }

        /* Program error LVT and clear any existing errors. */
        lapic_write32(LAPIC_LVT_ERROR, lvt_mode(la, APIC_LVT_ERROR,
            lapic_read32(LAPIC_LVT_ERROR)));
        lapic_write32(LAPIC_ESR, 0);

        /* Thermal LVT */
        if (maxlvt >= APIC_LVT_THERMAL)
                lapic_write32(LAPIC_LVT_THERMAL, lvt_mode(la, APIC_LVT_THERMAL,
                    lapic_read32(LAPIC_LVT_THERMAL)));

        /* Program the CMCI LVT entry if present. */
        if (maxlvt >= APIC_LVT_CMCI) {
                lapic_write32(LAPIC_LVT_CMCI, lvt_mode(la, APIC_LVT_CMCI,
                    lapic_read32(LAPIC_LVT_CMCI)));
        }

        elvt_count = amd_read_elvt_count();
        for (i = 0; i < elvt_count; i++) {
                if (la->la_elvts[i].lvt_active)
                        lapic_write32(LAPIC_EXT_LVT0 + i,
                            elvt_mode(la, i, lapic_read32(LAPIC_EXT_LVT0 + i)));
        }

        intr_restore(saveintr);
}

static void
lapic_intrcnt(void *dummy __unused)
{
        struct pcpu *pc;
        struct lapic *la;
        char buf[MAXCOMLEN + 1];

        /* If there are no APICs, skip this function. */
        if (lapics == NULL)
                return;

        STAILQ_FOREACH(pc, &cpuhead, pc_allcpu) {
                la = &lapics[pc->pc_apic_id];
                if (!la->la_present)
                    continue;

                snprintf(buf, sizeof(buf), "cpu%d:timer", pc->pc_cpuid);
                intrcnt_add(buf, &la->la_timer_count);
        }
}
SYSINIT(lapic_intrcnt, SI_SUB_INTR, SI_ORDER_MIDDLE, lapic_intrcnt, NULL);

void
lapic_reenable_pcint(void)
{
        uint32_t value;

        if (refcount_load(&pcint_refcnt) == 0)
                return;

        value = lapic_read32(LAPIC_LVT_PCINT);
        value &= ~APIC_LVT_M;
        lapic_write32(LAPIC_LVT_PCINT, value);

        if ((amd_feature2 & AMDID2_IBS) != 0) {
                value = lapic_read32(LAPIC_EXT_LVT0);
                value &= ~APIC_LVT_M;
                lapic_write32(LAPIC_EXT_LVT0, value);
        }
}

static void
lapic_update_pcint(void *dummy)
{
        struct lapic *la;

        la = &lapics[lapic_id()];
        lapic_write32(LAPIC_LVT_PCINT, lvt_mode(la, APIC_LVT_PMC,
            lapic_read32(LAPIC_LVT_PCINT)));

        if ((amd_feature2 & AMDID2_IBS) != 0) {
                lapic_write32(LAPIC_EXT_LVT0, elvt_mode(la, APIC_ELVT_IBS,
                    lapic_read32(LAPIC_EXT_LVT0)));
        }
}

void
lapic_calibrate_timer(void)
{
        struct lapic *la;
        register_t intr;

#ifdef DEV_ATPIC
        /* Fail if the local APIC is not present. */
        if (!x2apic_mode && lapic_map == NULL)
                return;
#endif

        intr = intr_disable();
        la = &lapics[lapic_id()];

        lapic_calibrate_initcount(la);

        intr_restore(intr);

        if (lapic_timer_tsc_deadline && bootverbose) {
                printf("lapic: deadline tsc mode, Frequency %ju Hz\n",
                    (uintmax_t)tsc_freq);
        }
}

int
lapic_enable_pcint(void)
{
#ifdef DEV_ATPIC
        /* Fail if the local APIC is not present. */
        if (!x2apic_mode && lapic_map == NULL)
                return (0);
#endif

        /* Fail if the PMC LVT is not present. */
        if (lapic_maxlvt() < APIC_LVT_PMC)
                return (0);
        if (refcount_acquire(&pcint_refcnt) > 0)
                return (1);
        lvts[APIC_LVT_PMC].lvt_masked = 0;

        if ((amd_feature2 & AMDID2_IBS) != 0)
                elvts[APIC_ELVT_IBS].lvt_masked = 0;

        MPASS(mp_ncpus == 1 || smp_started);
        smp_rendezvous(NULL, lapic_update_pcint, NULL, NULL);
        return (1);
}

void
lapic_disable_pcint(void)
{
#ifdef DEV_ATPIC
        /* Fail if the local APIC is not present. */
        if (!x2apic_mode && lapic_map == NULL)
                return;
#endif

        /* Fail if the PMC LVT is not present. */
        if (lapic_maxlvt() < APIC_LVT_PMC)
                return;
        if (!refcount_release(&pcint_refcnt))
                return;
        lvts[APIC_LVT_PMC].lvt_masked = 1;
        elvts[APIC_ELVT_IBS].lvt_masked = 1;

#ifdef SMP
        /* The APs should always be started when hwpmc is unloaded. */
        KASSERT(mp_ncpus == 1 || smp_started, ("hwpmc unloaded too early"));
#endif
        smp_rendezvous(NULL, lapic_update_pcint, NULL, NULL);
}

static int
lapic_calibrate_initcount_cpuid_vm(void)
{
        u_int regs[4];
        uint64_t freq;

        /* Get value from CPUID leaf if possible. */
        if (vm_guest == VM_GUEST_NO)
                return (false);
        if (hv_high < 0x40000010)
                return (false);
        do_cpuid(0x40000010, regs);
        freq = (uint64_t)(regs[1]) * 1000;

        /* Pick timer divisor. */
        lapic_timer_divisor = 2;
        do {
                if (freq / lapic_timer_divisor < APIC_TIMER_MAX_COUNT)
                        break;
                lapic_timer_divisor <<= 1;
        } while (lapic_timer_divisor <= 128);
        if (lapic_timer_divisor > 128)
                return (false);

        /* Record divided frequency. */
        count_freq = freq / lapic_timer_divisor;
        return (count_freq != 0);
}

static uint64_t
cb_lapic_getcount(void)
{

        return (APIC_TIMER_MAX_COUNT - lapic_read32(LAPIC_CCR_TIMER));
}

static void
lapic_calibrate_initcount(struct lapic *la)
{
        uint64_t freq;

        if (lapic_calibrate_initcount_cpuid_vm())
                goto done;

        /* Calibrate the APIC timer frequency. */
        lapic_timer_set_divisor(2);
        lapic_timer_oneshot_nointr(la, APIC_TIMER_MAX_COUNT);
        fpu_kern_enter(curthread, NULL, FPU_KERN_NOCTX);
        freq = clockcalib(cb_lapic_getcount, "lapic");
        fpu_kern_leave(curthread, NULL);

        /* Pick a different divisor if necessary. */
        lapic_timer_divisor = 2;
        do {
                if (freq * 2 / lapic_timer_divisor < APIC_TIMER_MAX_COUNT)
                        break;
                lapic_timer_divisor <<= 1;
        } while (lapic_timer_divisor <= 128);
        if (lapic_timer_divisor > 128)
                panic("lapic: Divisor too big");
        count_freq = freq * 2 / lapic_timer_divisor;
done:
        if (bootverbose) {
                printf("lapic: Divisor %lu, Frequency %lu Hz\n",
                    lapic_timer_divisor, count_freq);
        }
}

static void
lapic_change_mode(struct eventtimer *et, struct lapic *la,
    enum lat_timer_mode newmode)
{
        if (la->la_timer_mode == newmode)
                return;
        switch (newmode) {
        case LAT_MODE_PERIODIC:
                lapic_timer_set_divisor(lapic_timer_divisor);
                et->et_frequency = count_freq;
                break;
        case LAT_MODE_DEADLINE:
                et->et_frequency = tsc_freq;
                break;
        case LAT_MODE_ONESHOT:
                lapic_timer_set_divisor(lapic_timer_divisor);
                et->et_frequency = count_freq;
                break;
        default:
                panic("lapic_change_mode %d", newmode);
        }
        la->la_timer_mode = newmode;
        et->et_min_period = (0x00000002LLU << 32) / et->et_frequency;
        et->et_max_period = (0xfffffffeLLU << 32) / et->et_frequency;
}

static int
lapic_et_start(struct eventtimer *et, sbintime_t first, sbintime_t period)
{
        struct lapic *la;

        la = &lapics[PCPU_GET(apic_id)];
        if (period != 0) {
                lapic_change_mode(et, la, LAT_MODE_PERIODIC);
                la->la_timer_period = ((uint32_t)et->et_frequency * period) >>
                    32;
                lapic_timer_periodic(la);
        } else if (lapic_timer_tsc_deadline) {
                lapic_change_mode(et, la, LAT_MODE_DEADLINE);
                la->la_timer_period = (et->et_frequency * first) >> 32;
                lapic_timer_deadline(la);
        } else {
                lapic_change_mode(et, la, LAT_MODE_ONESHOT);
                la->la_timer_period = ((uint32_t)et->et_frequency * first) >>
                    32;
                lapic_timer_oneshot(la);
        }
        return (0);
}

static int
lapic_et_stop(struct eventtimer *et)
{
        struct lapic *la;

        la = &lapics[PCPU_GET(apic_id)];
        lapic_timer_stop(la);
        la->la_timer_mode = LAT_MODE_UNDEF;
        return (0);
}

void
lapic_disable(void)
{
        uint32_t value;

        /* Software disable the local APIC. */
        value = lapic_read32(LAPIC_SVR);
        value &= ~APIC_SVR_SWEN;
        lapic_write32(LAPIC_SVR, value);
}

static void
lapic_enable(void)
{
        uint32_t value;

        /* Program the spurious vector to enable the local APIC. */
        value = lapic_read32(LAPIC_SVR);
        value &= ~(APIC_SVR_VECTOR | APIC_SVR_FOCUS);
        value |= APIC_SVR_FEN | APIC_SVR_SWEN | APIC_SPURIOUS_INT;
        if (lapic_eoi_suppression)
                value |= APIC_SVR_EOI_SUPPRESSION;
        lapic_write32(LAPIC_SVR, value);
}

/* Reset the local APIC on the BSP during resume. */
static void
lapic_resume(struct pic *pic, bool suspend_cancelled)
{

        lapic_setup(0);
}

int
lapic_id(void)
{
        uint32_t v;

        KASSERT(x2apic_mode || lapic_map != NULL, ("local APIC is not mapped"));
        v = lapic_read32(LAPIC_ID);
        if (!x2apic_mode)
                v >>= APIC_ID_SHIFT;
        return (v);
}

int
lapic_intr_pending(u_int vector)
{
        uint32_t irr;

        /*
         * The IRR registers are an array of registers each of which
         * only describes 32 interrupts in the low 32 bits.  Thus, we
         * divide the vector by 32 to get the register index.
         * Finally, we modulus the vector by 32 to determine the
         * individual bit to test.
         */
        irr = lapic_read32(LAPIC_IRR0 + vector / 32);
        return (irr & 1 << (vector % 32));
}

void
lapic_set_logical_id(u_int apic_id, u_int cluster, u_int cluster_id)
{
        struct lapic *la;

        KASSERT(lapics[apic_id].la_present, ("%s: APIC %u doesn't exist",
            __func__, apic_id));
        KASSERT(cluster <= APIC_MAX_CLUSTER, ("%s: cluster %u too big",
            __func__, cluster));
        KASSERT(cluster_id <= APIC_MAX_INTRACLUSTER_ID,
            ("%s: intra cluster id %u too big", __func__, cluster_id));
        la = &lapics[apic_id];
        la->la_cluster = cluster;
        la->la_cluster_id = cluster_id;
}

int
lapic_set_lvt_mask(u_int apic_id, u_int pin, u_char masked)
{

        if (pin > APIC_LVT_MAX)
                return (EINVAL);
        if (apic_id == APIC_ID_ALL) {
                lvts[pin].lvt_masked = masked;
                if (bootverbose)
                        printf("lapic:");
        } else {
                KASSERT(lapics[apic_id].la_present,
                    ("%s: missing APIC %u", __func__, apic_id));
                lapics[apic_id].la_lvts[pin].lvt_masked = masked;
                lapics[apic_id].la_lvts[pin].lvt_active = 1;
                if (bootverbose)
                        printf("lapic%u:", apic_id);
        }
        if (bootverbose)
                printf(" LINT%u %s\n", pin, masked ? "masked" : "unmasked");
        return (0);
}

int
lapic_set_lvt_mode(u_int apic_id, u_int pin, u_int32_t mode)
{
        struct lvt *lvt;

        if (pin > APIC_LVT_MAX)
                return (EINVAL);
        if (apic_id == APIC_ID_ALL) {
                lvt = &lvts[pin];
                if (bootverbose)
                        printf("lapic:");
        } else {
                KASSERT(lapics[apic_id].la_present,
                    ("%s: missing APIC %u", __func__, apic_id));
                lvt = &lapics[apic_id].la_lvts[pin];
                lvt->lvt_active = 1;
                if (bootverbose)
                        printf("lapic%u:", apic_id);
        }
        lvt->lvt_mode = mode;
        switch (mode) {
        case APIC_LVT_DM_NMI:
        case APIC_LVT_DM_SMI:
        case APIC_LVT_DM_INIT:
        case APIC_LVT_DM_EXTINT:
                lvt->lvt_edgetrigger = 1;
                lvt->lvt_activehi = 1;
                if (mode == APIC_LVT_DM_EXTINT)
                        lvt->lvt_masked = 1;
                else
                        lvt->lvt_masked = 0;
                break;
        default:
                panic("Unsupported delivery mode: 0x%x\n", mode);
        }
        if (bootverbose) {
                printf(" Routing ");
                switch (mode) {
                case APIC_LVT_DM_NMI:
                        printf("NMI");
                        break;
                case APIC_LVT_DM_SMI:
                        printf("SMI");
                        break;
                case APIC_LVT_DM_INIT:
                        printf("INIT");
                        break;
                case APIC_LVT_DM_EXTINT:
                        printf("ExtINT");
                        break;
                }
                printf(" -> LINT%u\n", pin);
        }
        return (0);
}

int
lapic_set_lvt_polarity(u_int apic_id, u_int pin, enum intr_polarity pol)
{

        if (pin > APIC_LVT_MAX || pol == INTR_POLARITY_CONFORM)
                return (EINVAL);
        if (apic_id == APIC_ID_ALL) {
                lvts[pin].lvt_activehi = (pol == INTR_POLARITY_HIGH);
                if (bootverbose)
                        printf("lapic:");
        } else {
                KASSERT(lapics[apic_id].la_present,
                    ("%s: missing APIC %u", __func__, apic_id));
                lapics[apic_id].la_lvts[pin].lvt_active = 1;
                lapics[apic_id].la_lvts[pin].lvt_activehi =
                    (pol == INTR_POLARITY_HIGH);
                if (bootverbose)
                        printf("lapic%u:", apic_id);
        }
        if (bootverbose)
                printf(" LINT%u polarity: %s\n", pin,
                    pol == INTR_POLARITY_HIGH ? "high" : "low");
        return (0);
}

int
lapic_set_lvt_triggermode(u_int apic_id, u_int pin,
     enum intr_trigger trigger)
{

        if (pin > APIC_LVT_MAX || trigger == INTR_TRIGGER_CONFORM)
                return (EINVAL);
        if (apic_id == APIC_ID_ALL) {
                lvts[pin].lvt_edgetrigger = (trigger == INTR_TRIGGER_EDGE);
                if (bootverbose)
                        printf("lapic:");
        } else {
                KASSERT(lapics[apic_id].la_present,
                    ("%s: missing APIC %u", __func__, apic_id));
                lapics[apic_id].la_lvts[pin].lvt_edgetrigger =
                    (trigger == INTR_TRIGGER_EDGE);
                lapics[apic_id].la_lvts[pin].lvt_active = 1;
                if (bootverbose)
                        printf("lapic%u:", apic_id);
        }
        if (bootverbose)
                printf(" LINT%u trigger: %s\n", pin,
                    trigger == INTR_TRIGGER_EDGE ? "edge" : "level");
        return (0);
}

/*
 * Adjust the TPR of the current CPU so that it blocks all interrupts below
 * the passed in vector.
 */
static void
lapic_set_tpr(u_int vector)
{
#ifdef CHEAP_TPR
        lapic_write32(LAPIC_TPR, vector);
#else
        uint32_t tpr;

        tpr = lapic_read32(LAPIC_TPR) & ~APIC_TPR_PRIO;
        tpr |= vector;
        lapic_write32(LAPIC_TPR, tpr);
#endif
}

void
lapic_eoi(void)
{

        lapic_write32_nofence(LAPIC_EOI, 0);
}

void
lapic_handle_intr(int vector, struct trapframe *frame)
{
        struct intsrc *isrc;

        kasan_mark(frame, sizeof(*frame), sizeof(*frame), 0);
        kmsan_mark(&vector, sizeof(vector), KMSAN_STATE_INITED);
        kmsan_mark(frame, sizeof(*frame), KMSAN_STATE_INITED);
        trap_check_kstack();

        isrc = intr_lookup_source(apic_idt_to_irq(PCPU_GET(apic_id),
            vector));
        KASSERT(isrc != NULL,
            ("lapic_handle_intr: vector %d unrecognized at lapic %u",
            vector, PCPU_GET(apic_id)));
        intr_execute_handlers(isrc, frame);
}

void
lapic_handle_timer(struct trapframe *frame)
{
        struct lapic *la;
        struct trapframe *oldframe;
        struct thread *td;

        /* Send EOI first thing. */
        lapic_eoi();

        kasan_mark(frame, sizeof(*frame), sizeof(*frame), 0);
        kmsan_mark(frame, sizeof(*frame), KMSAN_STATE_INITED);
        trap_check_kstack();

        /* Look up our local APIC structure for the tick counters. */
        la = &lapics[PCPU_GET(apic_id)];
        (*la->la_timer_count)++;
        critical_enter();
        if (lapic_et.et_active) {
                td = curthread;
                td->td_intr_nesting_level++;
                oldframe = td->td_intr_frame;
                td->td_intr_frame = frame;
                lapic_et.et_event_cb(&lapic_et, lapic_et.et_arg);
                td->td_intr_frame = oldframe;
                td->td_intr_nesting_level--;
        }
        critical_exit();
}

static void
lapic_timer_set_divisor(u_int divisor)
{

        KASSERT(powerof2(divisor), ("lapic: invalid divisor %u", divisor));
        KASSERT(ffs(divisor) <= nitems(lapic_timer_divisors),
                ("lapic: invalid divisor %u", divisor));
        lapic_write32(LAPIC_DCR_TIMER, lapic_timer_divisors[ffs(divisor) - 1]);
}

static void
lapic_timer_oneshot(struct lapic *la)
{
        uint32_t value;

        value = la->lvt_timer_base;
        value &= ~(APIC_LVTT_TM | APIC_LVT_M);
        value |= APIC_LVTT_TM_ONE_SHOT;
        la->lvt_timer_last = value;
        lapic_write32(LAPIC_LVT_TIMER, value);
        lapic_write32(LAPIC_ICR_TIMER, la->la_timer_period);
}

static void
lapic_timer_oneshot_nointr(struct lapic *la, uint32_t count)
{
        uint32_t value;

        value = la->lvt_timer_base;
        value &= ~APIC_LVTT_TM;
        value |= APIC_LVTT_TM_ONE_SHOT | APIC_LVT_M;
        la->lvt_timer_last = value;
        lapic_write32(LAPIC_LVT_TIMER, value);
        lapic_write32(LAPIC_ICR_TIMER, count);
}

static void
lapic_timer_periodic(struct lapic *la)
{
        uint32_t value;

        value = la->lvt_timer_base;
        value &= ~(APIC_LVTT_TM | APIC_LVT_M);
        value |= APIC_LVTT_TM_PERIODIC;
        la->lvt_timer_last = value;
        lapic_write32(LAPIC_LVT_TIMER, value);
        lapic_write32(LAPIC_ICR_TIMER, la->la_timer_period);
}

static void
lapic_timer_deadline(struct lapic *la)
{
        uint32_t value;

        value = la->lvt_timer_base;
        value &= ~(APIC_LVTT_TM | APIC_LVT_M);
        value |= APIC_LVTT_TM_TSCDLT;
        if (value != la->lvt_timer_last) {
                la->lvt_timer_last = value;
                lapic_write32_nofence(LAPIC_LVT_TIMER, value);
                if (!x2apic_mode)
                        mfence();
        }
        wrmsr(MSR_TSC_DEADLINE, la->la_timer_period + rdtsc());
}

static void
lapic_timer_stop(struct lapic *la)
{
        uint32_t value;

        if (la->la_timer_mode == LAT_MODE_DEADLINE) {
                wrmsr(MSR_TSC_DEADLINE, 0);
                mfence();
        } else {
                value = la->lvt_timer_base;
                value &= ~APIC_LVTT_TM;
                value |= APIC_LVT_M;
                la->lvt_timer_last = value;
                lapic_write32(LAPIC_LVT_TIMER, value);
        }
}

void
lapic_handle_cmc(void)
{
        trap_check_kstack();

        lapic_eoi();
        cmc_intr();
}

/*
 * Called from the mca_init() to activate the CMC interrupt if this CPU is
 * responsible for monitoring any MC banks for CMC events.  Since mca_init()
 * is called prior to lapic_setup() during boot, this just needs to unmask
 * this CPU's LVT_CMCI entry.
 */
void
lapic_enable_cmc(void)
{
        u_int apic_id;

#ifdef DEV_ATPIC
        if (!x2apic_mode && lapic_map == NULL)
                return;
#endif
        apic_id = PCPU_GET(apic_id);
        KASSERT(lapics[apic_id].la_present,
            ("%s: missing APIC %u", __func__, apic_id));
        lapics[apic_id].la_lvts[APIC_LVT_CMCI].lvt_masked = 0;
        lapics[apic_id].la_lvts[APIC_LVT_CMCI].lvt_active = 1;
}

int
lapic_enable_mca_elvt(void)
{
        u_int apic_id;
        uint32_t value;
        int elvt_count;

#ifdef DEV_ATPIC
        if (lapic_map == NULL)
                return (-1);
#endif

        apic_id = PCPU_GET(apic_id);
        KASSERT(lapics[apic_id].la_present,
            ("%s: missing APIC %u", __func__, apic_id));
        elvt_count = amd_read_elvt_count();
        if (elvt_count <= APIC_ELVT_MCA)
                return (-1);

        value = lapic_read32(LAPIC_EXT_LVT0 + APIC_ELVT_MCA);
        if ((value & APIC_LVT_M) == 0) {
                if (bootverbose)
                        printf("AMD MCE Thresholding Extended LVT is already active\n");
                return (APIC_ELVT_MCA);
        }
        lapics[apic_id].la_elvts[APIC_ELVT_MCA].lvt_masked = 0;
        lapics[apic_id].la_elvts[APIC_ELVT_MCA].lvt_active = 1;
        return (APIC_ELVT_MCA);
}

void
lapic_handle_thermal(void)
{
        lapic_thermal_handler_t *func;

        func = (lapic_thermal_handler_t *)atomic_load_acq_ptr(
            (uintptr_t *)&lapic_thermal_function);

        if (func != NULL)
                func(PCPU_GET(cpuid), lapic_thermal_function_arg);

        lapic_eoi();
}

static void
lapic_update_thermal(void *dummy __unused)
{
        struct lapic *la;

        la = &lapics[lapic_id()];
        lapic_write32(LAPIC_LVT_THERMAL, lvt_mode(la, APIC_LVT_THERMAL,
            lapic_read32(LAPIC_LVT_THERMAL)));
}

bool
lapic_enable_thermal(lapic_thermal_handler_t *func, void *func_arg)
{
#ifdef DEV_ATPIC
        /* Fail if the local APIC is not present. */
        if (!x2apic_mode && lapic_map == NULL)
                return (false);
#endif

        if (lapic_maxlvt() < APIC_LVT_THERMAL)
                return (false);

        lapic_thermal_function_arg = func_arg;
        atomic_store_rel_ptr((uintptr_t *)&lapic_thermal_function,
            (uintptr_t)func);

        lvts[APIC_LVT_THERMAL].lvt_masked = 0;

        MPASS(mp_ncpus == 1 || smp_started);
        smp_rendezvous(NULL, lapic_update_thermal, NULL, NULL);

        return (true);
}

void
lapic_disable_thermal(void)
{
#ifdef DEV_ATPIC
        /* Fail if the local APIC is not present. */
        if (!x2apic_mode && lapic_map == NULL)
                return;
#endif

        if (lapic_maxlvt() < APIC_LVT_THERMAL)
                return;

        lvts[APIC_LVT_THERMAL].lvt_masked = 1;

#ifdef SMP
        KASSERT(mp_ncpus == 1 || smp_started, ("thermal driver unloaded too early"));
#endif
        smp_rendezvous(NULL, lapic_update_thermal, NULL, NULL);

        atomic_store_rel_ptr((uintptr_t *)&lapic_thermal_function,
            (uintptr_t)NULL);
}

void
lapic_handle_error(void)
{
        uint32_t esr;

        trap_check_kstack();

        /*
         * Read the contents of the error status register.  Write to
         * the register first before reading from it to force the APIC
         * to update its value to indicate any errors that have
         * occurred since the previous write to the register.
         */
        lapic_write32(LAPIC_ESR, 0);
        esr = lapic_read32(LAPIC_ESR);

        printf("CPU%d: local APIC error 0x%x\n", PCPU_GET(cpuid), esr);
        lapic_eoi();
}

u_int
apic_cpuid(u_int apic_id)
{
#ifdef SMP
        return apic_cpuids[apic_id];
#else
        return 0;
#endif
}

/* Request a free IDT vector to be used by the specified IRQ. */
u_int
apic_alloc_vector(u_int apic_id, u_int irq)
{
        u_int vector;

        KASSERT(irq < num_io_irqs, ("Invalid IRQ %u", irq));

        /*
         * Search for a free vector.  Currently we just use a very simple
         * algorithm to find the first free vector.
         */
        mtx_lock_spin(&icu_lock);
        for (vector = 0; vector < APIC_NUM_IOINTS; vector++) {
                if (lapics[apic_id].la_ioint_irqs[vector] != IRQ_FREE)
                        continue;
                lapics[apic_id].la_ioint_irqs[vector] = irq;
                mtx_unlock_spin(&icu_lock);
                return (vector + APIC_IO_INTS);
        }
        mtx_unlock_spin(&icu_lock);
        return (0);
}

/*
 * Request 'count' free contiguous IDT vectors to be used by 'count'
 * IRQs.  'count' must be a power of two and the vectors will be
 * aligned on a boundary of 'align'.  If the request cannot be
 * satisfied, 0 is returned.
 */
u_int
apic_alloc_vectors(u_int apic_id, u_int *irqs, u_int count, u_int align)
{
        u_int first, run, vector;

        KASSERT(powerof2(count), ("bad count"));
        KASSERT(powerof2(align), ("bad align"));
        KASSERT(align >= count, ("align < count"));
#ifdef INVARIANTS
        for (run = 0; run < count; run++)
                KASSERT(irqs[run] < num_io_irqs, ("Invalid IRQ %u at index %u",
                    irqs[run], run));
#endif

        /*
         * Search for 'count' free vectors.  As with apic_alloc_vector(),
         * this just uses a simple first fit algorithm.
         */
        run = 0;
        first = 0;
        mtx_lock_spin(&icu_lock);
        for (vector = 0; vector < APIC_NUM_IOINTS; vector++) {
                /* Vector is in use, end run. */
                if (lapics[apic_id].la_ioint_irqs[vector] != IRQ_FREE) {
                        run = 0;
                        first = 0;
                        continue;
                }

                /* Start a new run if run == 0 and vector is aligned. */
                if (run == 0) {
                        if (((vector + APIC_IO_INTS) & (align - 1)) != 0)
                                continue;
                        first = vector;
                }
                run++;

                /* Keep looping if the run isn't long enough yet. */
                if (run < count)
                        continue;

                /* Found a run, assign IRQs and return the first vector. */
                for (vector = 0; vector < count; vector++)
                        lapics[apic_id].la_ioint_irqs[first + vector] =
                            irqs[vector];
                mtx_unlock_spin(&icu_lock);
                return (first + APIC_IO_INTS);
        }
        mtx_unlock_spin(&icu_lock);
        printf("APIC: Couldn't find APIC vectors for %u IRQs\n", count);
        return (0);
}

/*
 * Enable a vector for a particular apic_id.  Since all lapics share idt
 * entries and ioint_handlers this enables the vector on all lapics.  lapics
 * which do not have the vector configured would report spurious interrupts
 * should it fire.
 */
void
apic_enable_vector(u_int apic_id, u_int vector)
{

        KASSERT(vector != IDT_SYSCALL, ("Attempt to overwrite syscall entry"));
        KASSERT(ioint_handlers[vector / 32] != NULL,
            ("No ISR handler for vector %u", vector));
#ifdef KDTRACE_HOOKS
        KASSERT(vector != IDT_DTRACE_RET,
            ("Attempt to overwrite DTrace entry"));
#endif
        setidt(vector, (pti ? ioint_pti_handlers : ioint_handlers)[vector / 32],
            SDT_APIC, SEL_KPL, GSEL_APIC);
}

void
apic_disable_vector(u_int apic_id, u_int vector)
{

        KASSERT(vector != IDT_SYSCALL, ("Attempt to overwrite syscall entry"));
#ifdef KDTRACE_HOOKS
        KASSERT(vector != IDT_DTRACE_RET,
            ("Attempt to overwrite DTrace entry"));
#endif
        KASSERT(ioint_handlers[vector / 32] != NULL,
            ("No ISR handler for vector %u", vector));
#ifdef notyet
        /*
         * We can not currently clear the idt entry because other cpus
         * may have a valid vector at this offset.
         */
        setidt(vector, pti ? &IDTVEC(rsvd_pti) : &IDTVEC(rsvd), SDT_APIC,
            SEL_KPL, GSEL_APIC);
#endif
}

/* Release an APIC vector when it's no longer in use. */
void
apic_free_vector(u_int apic_id, u_int vector, u_int irq)
{
        struct thread *td;

        KASSERT(vector >= APIC_IO_INTS && vector != IDT_SYSCALL &&
            vector <= APIC_IO_INTS + APIC_NUM_IOINTS,
            ("Vector %u does not map to an IRQ line", vector));
        KASSERT(irq < num_io_irqs, ("Invalid IRQ %u", irq));
        KASSERT(lapics[apic_id].la_ioint_irqs[vector - APIC_IO_INTS] ==
            irq, ("IRQ mismatch"));
#ifdef KDTRACE_HOOKS
        KASSERT(vector != IDT_DTRACE_RET,
            ("Attempt to overwrite DTrace entry"));
#endif

        /*
         * Bind us to the cpu that owned the vector before freeing it so
         * we don't lose an interrupt delivery race.
         */
        td = curthread;
        if (!rebooting) {
                thread_lock(td);
                if (sched_is_bound(td))
                        panic("apic_free_vector: Thread already bound.\n");
                sched_bind(td, apic_cpuid(apic_id));
                thread_unlock(td);
        }
        mtx_lock_spin(&icu_lock);
        lapics[apic_id].la_ioint_irqs[vector - APIC_IO_INTS] = IRQ_FREE;
        mtx_unlock_spin(&icu_lock);
        if (!rebooting) {
                thread_lock(td);
                sched_unbind(td);
                thread_unlock(td);
        }
}

/* Map an IDT vector (APIC) to an IRQ (interrupt source). */
static u_int
apic_idt_to_irq(u_int apic_id, u_int vector)
{
        int irq;

        KASSERT(vector >= APIC_IO_INTS && vector != IDT_SYSCALL &&
            vector <= APIC_IO_INTS + APIC_NUM_IOINTS,
            ("Vector %u does not map to an IRQ line", vector));
#ifdef KDTRACE_HOOKS
        KASSERT(vector != IDT_DTRACE_RET,
            ("Attempt to overwrite DTrace entry"));
#endif
        irq = lapics[apic_id].la_ioint_irqs[vector - APIC_IO_INTS];
        if (irq < 0)
                irq = 0;
        return (irq);
}

#ifdef DDB
/*
 * Dump data about APIC IDT vector mappings.
 */
DB_SHOW_COMMAND_FLAGS(apic, db_show_apic, DB_CMD_MEMSAFE)
{
        struct intsrc *isrc;
        int i, verbose;
        u_int apic_id;
        u_int irq;

        if (strcmp(modif, "vv") == 0)
                verbose = 2;
        else if (strcmp(modif, "v") == 0)
                verbose = 1;
        else
                verbose = 0;
        for (apic_id = 0; apic_id <= max_apic_id; apic_id++) {
                if (lapics[apic_id].la_present == 0)
                        continue;
                db_printf("Interrupts bound to lapic %u\n", apic_id);
                for (i = 0; i < APIC_NUM_IOINTS + 1 && !db_pager_quit; i++) {
                        irq = lapics[apic_id].la_ioint_irqs[i];
                        if (irq == IRQ_FREE || irq == IRQ_SYSCALL)
                                continue;
#ifdef KDTRACE_HOOKS
                        if (irq == IRQ_DTRACE_RET)
                                continue;
#endif
#ifdef XENHVM
                        if (irq == IRQ_EVTCHN)
                                continue;
#endif
                        db_printf("vec 0x%2x -> ", i + APIC_IO_INTS);
                        if (irq == IRQ_TIMER)
                                db_printf("lapic timer\n");
                        else if (irq < num_io_irqs) {
                                isrc = intr_lookup_source(irq);
                                if (isrc == NULL || verbose == 0)
                                        db_printf("IRQ %u\n", irq);
                                else
                                        db_dump_intr_event(isrc->is_event,
                                            verbose == 2);
                        } else
                                db_printf("IRQ %u ???\n", irq);
                }
        }
}

static void
dump_mask(const char *prefix, uint32_t v, int base)
{
        int i, first;

        first = 1;
        for (i = 0; i < 32; i++)
                if (v & (1 << i)) {
                        if (first) {
                                db_printf("%s:", prefix);
                                first = 0;
                        }
                        db_printf(" %02x", base + i);
                }
        if (!first)
                db_printf("\n");
}

/* Show info from the lapic regs for this CPU. */
DB_SHOW_COMMAND_FLAGS(lapic, db_show_lapic, DB_CMD_MEMSAFE)
{
        const struct lvt *l;
        int elvt_count, lvts_count, i;
        const uint32_t v = lapic_version();
        const int maxlvt = lapic_version_maxlvt(v);
        const uint32_t vr = lapic_read32(LAPIC_SVR);

        db_printf("lapic ID = %d\n", lapic_id());
        db_printf("version  = %d.%d (%#x) \n", (v & APIC_VER_VERSION) >> 4,
            v & 0xf, v);
        db_printf("max LVT  = %d\n", maxlvt);
        db_printf("SVR      = %02x (%s)\n", vr & APIC_SVR_VECTOR,
            vr & APIC_SVR_ENABLE ? "enabled" : "disabled");
        db_printf("TPR      = %02x\n", lapic_read32(LAPIC_TPR));

        lvts_count = min(nitems(lvts), maxlvt + 1);
        for (i = 0; i < lvts_count; i++) {
                l = &lvts[i];
                db_printf("LVT%d  (reg %#x %-5s) = %#010x\n", i, l->lvt_reg,
                    l->lvt_desc, lapic_read32(l->lvt_reg));
        }

        elvt_count = amd_read_elvt_count();
        for (i = 0; i < elvt_count; i++) {
                l = &elvts[i];
                db_printf("ELVT%d (reg %#x %-5s) = %#010x\n", i, l->lvt_reg,
                    l->lvt_desc, lapic_read32(l->lvt_reg));
        }

#define dump_field(prefix, regn, index)                                 \
        dump_mask(__XSTRING(prefix ## index),                           \
            lapic_read32(LAPIC_ ## regn ## index),                      \
            index * 32)

        db_printf("In-service Interrupts:\n");
        dump_field(isr, ISR, 0);
        dump_field(isr, ISR, 1);
        dump_field(isr, ISR, 2);
        dump_field(isr, ISR, 3);
        dump_field(isr, ISR, 4);
        dump_field(isr, ISR, 5);
        dump_field(isr, ISR, 6);
        dump_field(isr, ISR, 7);

        db_printf("TMR Interrupts:\n");
        dump_field(tmr, TMR, 0);
        dump_field(tmr, TMR, 1);
        dump_field(tmr, TMR, 2);
        dump_field(tmr, TMR, 3);
        dump_field(tmr, TMR, 4);
        dump_field(tmr, TMR, 5);
        dump_field(tmr, TMR, 6);
        dump_field(tmr, TMR, 7);

        db_printf("IRR Interrupts:\n");
        dump_field(irr, IRR, 0);
        dump_field(irr, IRR, 1);
        dump_field(irr, IRR, 2);
        dump_field(irr, IRR, 3);
        dump_field(irr, IRR, 4);
        dump_field(irr, IRR, 5);
        dump_field(irr, IRR, 6);
        dump_field(irr, IRR, 7);

#undef dump_field
}
#endif

/*
 * APIC probing support code.  This includes code to manage enumerators.
 */

static SLIST_HEAD(, apic_enumerator) enumerators =
        SLIST_HEAD_INITIALIZER(enumerators);
static struct apic_enumerator *best_enum;

void
apic_register_enumerator(struct apic_enumerator *enumerator)
{
#ifdef INVARIANTS
        struct apic_enumerator *apic_enum;

        SLIST_FOREACH(apic_enum, &enumerators, apic_next) {
                if (apic_enum == enumerator)
                        panic("%s: Duplicate register of %s", __func__,
                            enumerator->apic_name);
        }
#endif
        SLIST_INSERT_HEAD(&enumerators, enumerator, apic_next);
}

/*
 * We have to look for CPU's very, very early because certain subsystems
 * want to know how many CPU's we have extremely early on in the boot
 * process.
 */
static void
apic_init(void *dummy __unused)
{
        struct apic_enumerator *enumerator;
        int retval, best;

        /* We only support built in local APICs. */
        if (!(cpu_feature & CPUID_APIC))
                return;

        /* Don't probe if APIC mode is disabled. */
        if (resource_disabled("apic", 0))
                return;

        /* Probe all the enumerators to find the best match. */
        best_enum = NULL;
        best = 0;
        SLIST_FOREACH(enumerator, &enumerators, apic_next) {
                retval = enumerator->apic_probe();
                if (retval > 0)
                        continue;
                if (best_enum == NULL || best < retval) {
                        best_enum = enumerator;
                        best = retval;
                }
        }
        if (best_enum == NULL) {
                if (bootverbose)
                        printf("APIC: Could not find any APICs.\n");
#ifndef DEV_ATPIC
                panic("running without device atpic requires a local APIC");
#endif
                return;
        }

        if (bootverbose)
                printf("APIC: Using the %s enumerator.\n",
                    best_enum->apic_name);

#ifdef I686_CPU
        /*
         * To work around an errata, we disable the local APIC on some
         * CPUs during early startup.  We need to turn the local APIC back
         * on on such CPUs now.
         */
        ppro_reenable_apic();
#endif

        /* Probe the CPU's in the system. */
        retval = best_enum->apic_probe_cpus();
        if (retval != 0)
                printf("%s: Failed to probe CPUs: returned %d\n",
                    best_enum->apic_name, retval);

}
SYSINIT(apic_init, SI_SUB_TUNABLES - 1, SI_ORDER_SECOND, apic_init, NULL);

/*
 * Setup the local APIC.  We have to do this prior to starting up the APs
 * in the SMP case.
 */
static void
apic_setup_local(void *dummy __unused)
{
        int retval;

        if (best_enum == NULL)
                return;

        lapics = malloc(sizeof(*lapics) * (max_apic_id + 1), M_LAPIC,
            M_WAITOK | M_ZERO);

        /* Initialize the local APIC. */
        retval = best_enum->apic_setup_local();
        if (retval != 0)
                printf("%s: Failed to setup the local APIC: returned %d\n",
                    best_enum->apic_name, retval);
}
SYSINIT(apic_setup_local, SI_SUB_CPU, SI_ORDER_SECOND, apic_setup_local, NULL);

/* Are we in a VM which supports the Extended Destination ID standard? */
int apic_ext_dest_id = -1;
SYSCTL_INT(_machdep, OID_AUTO, apic_ext_dest_id, CTLFLAG_RDTUN, &apic_ext_dest_id, 0,
    "Use APIC Extended Destination IDs");

/* Detect support for Extended Destination IDs. */
static void
detect_extended_dest_id(void)
{
        u_int regs[4];

        /* Check if we support extended destination IDs. */
        switch (vm_guest) {
        case VM_GUEST_XEN:
                cpuid_count(hv_base + 4, 0, regs);
                if (regs[0] & XEN_HVM_CPUID_EXT_DEST_ID)
                        apic_ext_dest_id = 1;
                break;
        case VM_GUEST_HV:
                cpuid_count(CPUID_LEAF_HV_STACK_INTERFACE, 0, regs);
                if (regs[0] != HYPERV_STACK_INTERFACE_EAX_SIG)
                        break;
                cpuid_count(CPUID_LEAF_HV_STACK_PROPERTIES, 0, regs);
                if (regs[0] & HYPERV_PROPERTIES_EXT_DEST_ID)
                        apic_ext_dest_id = 1;
                break;
        case VM_GUEST_KVM:
                kvm_cpuid_get_features(regs);
                if (regs[0] & KVM_FEATURE_MSI_EXT_DEST_ID)
                        apic_ext_dest_id = 1;
                break;
        case VM_GUEST_BHYVE:
                if (hv_high < CPUID_BHYVE_FEATURES)
                        break;
                cpuid_count(CPUID_BHYVE_FEATURES, 0, regs);
                if (regs[0] & CPUID_BHYVE_FEAT_EXT_DEST_ID)
                        apic_ext_dest_id = 1;
                break;
        }
}

/*
 * Setup the I/O APICs.
 */
static void
apic_setup_io(void *dummy __unused)
{
        int retval;

        if (best_enum == NULL)
                return;

        /* Check hypervisor support for extended destination IDs. */
        if (apic_ext_dest_id == -1)
                detect_extended_dest_id();

        /*
         * Local APIC must be registered before other PICs and pseudo PICs
         * for proper suspend/resume order.
         */
        intr_register_pic(&lapic_pic);

        retval = best_enum->apic_setup_io();
        if (retval != 0)
                printf("%s: Failed to setup I/O APICs: returned %d\n",
                    best_enum->apic_name, retval);

        /*
         * Finish setting up the local APIC on the BSP once we know
         * how to properly program the LINT pins.  In particular, this
         * enables the EOI suppression mode, if LAPIC supports it and
         * user did not disable the mode.
         */
        lapic_setup(1);
        if (bootverbose)
                lapic_dump("BSP");

        /* Enable the MSI "pic". */
        msi_init();

#ifdef XENHVM
        xen_intr_alloc_irqs();
#endif
}
SYSINIT(apic_setup_io, SI_SUB_INTR, SI_ORDER_THIRD, apic_setup_io, NULL);

#ifdef SMP
/*
 * Inter Processor Interrupt functions.  The lapic_ipi_*() functions are
 * private to the MD code.  The public interface for the rest of the
 * kernel is defined in mp_machdep.c.
 */

/*
 * Wait delay microseconds for IPI to be sent.  If delay is -1, we
 * wait forever.
 */
int
lapic_ipi_wait(int delay)
{
        uint64_t rx;

        /* LAPIC_ICR.APIC_DELSTAT_MASK is undefined in x2APIC mode */
        if (x2apic_mode)
                return (1);

        for (rx = 0; delay == -1 || rx < lapic_ipi_wait_mult * delay; rx++) {
                if ((lapic_read_icr_lo() & APIC_DELSTAT_MASK) ==
                    APIC_DELSTAT_IDLE)
                        return (1);
                ia32_pause();
        }
        return (0);
}

void
lapic_ipi_raw(register_t icrlo, u_int dest)
{
        uint32_t icrhi;

        /* XXX: Need more sanity checking of icrlo? */
        KASSERT(x2apic_mode || lapic_map != NULL,
            ("%s called too early", __func__));
        KASSERT(x2apic_mode ||
            (dest & ~(APIC_ID_MASK >> APIC_ID_SHIFT)) == 0,
            ("%s: invalid dest field", __func__));
        KASSERT((icrlo & APIC_ICRLO_RESV_MASK) == 0,
            ("%s: reserved bits set in ICR LO register", __func__));

        if ((icrlo & APIC_DEST_MASK) == APIC_DEST_DESTFLD) {
                if (x2apic_mode)
                        icrhi = dest;
                else
                        icrhi = dest << APIC_ID_SHIFT;
                lapic_write_icr(icrhi, icrlo);
        } else {
                lapic_write_icr_lo(icrlo);
        }
}

#ifdef DETECT_DEADLOCK
#define AFTER_SPIN      50
#endif

static void
native_lapic_ipi_vectored(u_int vector, int dest)
{
        register_t icrlo, destfield;

        KASSERT((vector & ~APIC_VECTOR_MASK) == 0,
            ("%s: invalid vector %d", __func__, vector));

        destfield = 0;
        switch (dest) {
        case APIC_IPI_DEST_SELF:
                if (x2apic_mode && vector < IPI_NMI_FIRST) {
                        lapic_write_self_ipi(vector);
                        return;
                }
                icrlo = APIC_DEST_SELF;
                break;
        case APIC_IPI_DEST_ALL:
                icrlo = APIC_DEST_ALLISELF;
                break;
        case APIC_IPI_DEST_OTHERS:
                icrlo = APIC_DEST_ALLESELF;
                break;
        default:
                icrlo = 0;
                KASSERT(x2apic_mode ||
                    (dest & ~(APIC_ID_MASK >> APIC_ID_SHIFT)) == 0,
                    ("%s: invalid destination 0x%x", __func__, dest));
                destfield = dest;
        }

        /*
         * NMI IPIs are just fake vectors used to send a NMI.  Use special rules
         * regarding NMIs if passed, otherwise specify the vector.
         */
        if (vector >= IPI_NMI_FIRST)
                icrlo |= APIC_DELMODE_NMI;
        else
                icrlo |= vector | APIC_DELMODE_FIXED;
        icrlo |= APIC_DESTMODE_PHY | APIC_TRIGMOD_EDGE | APIC_LEVEL_ASSERT;

        /* Wait for an earlier IPI to finish. */
        if (!lapic_ipi_wait(lapic_ds_idle_timeout)) {
                if (KERNEL_PANICKED())
                        return;
                else
                        panic("APIC: Previous IPI is stuck");
        }

        lapic_ipi_raw(icrlo, destfield);

#ifdef DETECT_DEADLOCK
        /* Wait for IPI to be delivered. */
        if (!lapic_ipi_wait(AFTER_SPIN)) {
#ifdef needsattention
                /*
                 * XXX FIXME:
                 *
                 * The above function waits for the message to actually be
                 * delivered.  It breaks out after an arbitrary timeout
                 * since the message should eventually be delivered (at
                 * least in theory) and that if it wasn't we would catch
                 * the failure with the check above when the next IPI is
                 * sent.
                 *
                 * We could skip this wait entirely, EXCEPT it probably
                 * protects us from other routines that assume that the
                 * message was delivered and acted upon when this function
                 * returns.
                 */
                printf("APIC: IPI might be stuck\n");
#else /* !needsattention */
                /* Wait until mesage is sent without a timeout. */
                while (lapic_read_icr_lo() & APIC_DELSTAT_PEND)
                        ia32_pause();
#endif /* needsattention */
        }
#endif /* DETECT_DEADLOCK */
}

void (*ipi_vectored)(u_int, int) = &native_lapic_ipi_vectored;
#endif /* SMP */

void (*fred_ipi_handlers[IPI_DYN_LAST - IPI_DYN_FIRST + 1])(struct trapframe *);

/*
 * Since the IDT is shared by all CPUs the IPI slot update needs to be globally
 * visible.
 *
 * Consider the case where an IPI is generated immediately after allocation:
 *     vector = lapic_ipi_alloc(ipifunc);
 *     ipi_selected(other_cpus, vector);
 *
 * In xAPIC mode a write to ICR_LO has serializing semantics because the
 * APIC page is mapped as an uncached region. In x2APIC mode there is an
 * explicit 'mfence' before the ICR MSR is written. Therefore in both cases
 * the IDT slot update is globally visible before the IPI is delivered.
 */
int
lapic_ipi_alloc(inthand_t *ipifunc, void (*fred_ipifunc)(struct trapframe *))
{
        void (*fip)(struct trapframe *);
        int idx, vector;

        KASSERT(ipifunc != &IDTVEC(rsvd) && ipifunc != &IDTVEC(rsvd_pti),
            ("invalid ipifunc %p", ipifunc));

        vector = -1;
        mtx_lock_spin(&icu_lock);
        for (idx = IPI_DYN_FIRST; idx <= IPI_DYN_LAST; idx++) {
                fip = fred_ipi_handlers[idx - IPI_DYN_FIRST];
                if (fip == NULL) {
                        vector = idx;
                        fred_ipi_handlers[idx - IPI_DYN_FIRST] = fred_ipifunc;
                        setidt(vector, ipifunc, SDT_APIC, SEL_KPL, GSEL_APIC);
                        break;
                }
        }
        mtx_unlock_spin(&icu_lock);
        return (vector);
}

void
lapic_ipi_free(int vector)
{
        struct gate_descriptor *ip;
        long func __diagused;

        KASSERT(vector >= IPI_DYN_FIRST && vector <= IPI_DYN_LAST,
            ("%s: invalid vector %d", __func__, vector));

        mtx_lock_spin(&icu_lock);
        KASSERT(fred_ipi_handlers[vector - IPI_DYN_FIRST] != NULL,
            ("NULL fred func %d", vector));
        fred_ipi_handlers[vector - IPI_DYN_FIRST] = NULL;
        if (!fred) {
                ip = &idt[vector];
                func = (ip->gd_hioffset << 16) | ip->gd_looffset;
#ifdef __i386__
                func -= setidt_disp;
#endif
                KASSERT(func != (uintptr_t)&IDTVEC(rsvd) &&
                    func != (uintptr_t)&IDTVEC(rsvd_pti),
                    ("invalid idtfunc %d %#lx", vector, func));
                setidt(vector, pti ? &IDTVEC(rsvd_pti) : &IDTVEC(rsvd),
                    SDT_APIC, SEL_KPL, GSEL_APIC);
        }
        mtx_unlock_spin(&icu_lock);
}