root/arch/x86/kvm/ioapic.h
/* SPDX-License-Identifier: GPL-2.0 */
#ifndef __KVM_IO_APIC_H
#define __KVM_IO_APIC_H

#include <linux/kvm_host.h>
#include <kvm/iodev.h>
#include "irq.h"

#ifdef CONFIG_KVM_IOAPIC

struct kvm;
struct kvm_vcpu;

#define IOAPIC_NUM_PINS  KVM_IOAPIC_NUM_PINS
#define IOAPIC_VERSION_ID 0x11  /* IOAPIC version */
#define IOAPIC_EDGE_TRIG  0
#define IOAPIC_LEVEL_TRIG 1

#define IOAPIC_DEFAULT_BASE_ADDRESS  0xfec00000
#define IOAPIC_MEM_LENGTH            0x100

/* Direct registers. */
#define IOAPIC_REG_SELECT  0x00
#define IOAPIC_REG_WINDOW  0x10

/* Indirect registers. */
#define IOAPIC_REG_APIC_ID 0x00 /* x86 IOAPIC only */
#define IOAPIC_REG_VERSION 0x01
#define IOAPIC_REG_ARB_ID  0x02 /* x86 IOAPIC only */

/*ioapic delivery mode*/
#define IOAPIC_FIXED                    0x0
#define IOAPIC_LOWEST_PRIORITY          0x1
#define IOAPIC_PMI                      0x2
#define IOAPIC_NMI                      0x4
#define IOAPIC_INIT                     0x5
#define IOAPIC_EXTINT                   0x7

#define RTC_GSI 8

struct rtc_status {
        int pending_eoi;

        /* vcpu bitmap where IRQ has been sent */
        DECLARE_BITMAP(map, KVM_MAX_VCPU_IDS);

        /*
         * Vector sent to a given vcpu, only valid when
         * the vcpu's bit in map is set
         */
        u8 vectors[KVM_MAX_VCPU_IDS];
};

union kvm_ioapic_redirect_entry {
        u64 bits;
        struct {
                u8 vector;
                u8 delivery_mode:3;
                u8 dest_mode:1;
                u8 delivery_status:1;
                u8 polarity:1;
                u8 remote_irr:1;
                u8 trig_mode:1;
                u8 mask:1;
                u8 reserve:7;
                u8 reserved[4];
                u8 dest_id;
        } fields;
};

struct kvm_ioapic {
        u64 base_address;
        u32 ioregsel;
        u32 id;
        u32 irr;
        u32 pad;
        union kvm_ioapic_redirect_entry redirtbl[IOAPIC_NUM_PINS];
        unsigned long irq_states[IOAPIC_NUM_PINS];
        struct kvm_io_device dev;
        struct kvm *kvm;
        spinlock_t lock;
        struct rtc_status rtc_status;
        struct delayed_work eoi_inject;
        u32 irq_eoi[IOAPIC_NUM_PINS];
        u32 irr_delivered;

        /* reads protected by irq_srcu, writes by irq_lock */
        struct hlist_head mask_notifier_list;
};

struct kvm_irq_mask_notifier {
        void (*func)(struct kvm_irq_mask_notifier *kimn, bool masked);
        int irq;
        struct hlist_node link;
};

void kvm_register_irq_mask_notifier(struct kvm *kvm, int irq,
                                    struct kvm_irq_mask_notifier *kimn);
void kvm_unregister_irq_mask_notifier(struct kvm *kvm, int irq,
                                      struct kvm_irq_mask_notifier *kimn);
void kvm_fire_mask_notifiers(struct kvm *kvm, unsigned irqchip, unsigned pin,
                             bool mask);

void kvm_rtc_eoi_tracking_restore_one(struct kvm_vcpu *vcpu);
void kvm_ioapic_update_eoi(struct kvm_vcpu *vcpu, int vector,
                        int trigger_mode);
int kvm_ioapic_init(struct kvm *kvm);
void kvm_ioapic_destroy(struct kvm *kvm);
int kvm_ioapic_set_irq(struct kvm_kernel_irq_routing_entry *e, struct kvm *kvm,
                       int irq_source_id, int level, bool line_status);

void kvm_get_ioapic(struct kvm *kvm, struct kvm_ioapic_state *state);
void kvm_set_ioapic(struct kvm *kvm, struct kvm_ioapic_state *state);
void kvm_ioapic_scan_entry(struct kvm_vcpu *vcpu,
                           ulong *ioapic_handled_vectors);
#endif /* CONFIG_KVM_IOAPIC */

static inline int ioapic_in_kernel(struct kvm *kvm)
{
        return irqchip_full(kvm);
}

void kvm_scan_ioapic_routes(struct kvm_vcpu *vcpu,
                            ulong *ioapic_handled_vectors);
void kvm_scan_ioapic_irq(struct kvm_vcpu *vcpu, u32 dest_id, u16 dest_mode,
                         u8 vector, unsigned long *ioapic_handled_vectors);
#endif