Module idt 

Interrupt Descriptor Table (IDT) for Strat9-OS

Handles CPU exceptions and hardware IRQs. Inspired by MaestroOS idt.rs and Redox-OS kernel.

Modules

irq

IRQ interrupt vector numbers (PIC1_OFFSET + IRQ number)

Structs

IdtStorage 🔒

Combined IDT storage + lock in a single struct to prevent memory corruption. The static mut InterruptDescriptorTable initialization was corrupting the adjacent AtomicBool lock.

Idtr 🔒

InterruptReturnDecision

Decision returned by the raw interrupt trampolines.

LiveIdtGateInfo

SwapGsGuard 🔒

RAII guard: swap GS to kernel on entry if we came from Ring 3, and restore user GS automatically on drop (covers every exit path including early returns).

Constants

KERNEL_CODE_SELECTOR 🔒

Kernel code segment selector for IDT entries.

Statics

IDT_STORAGEWrapper 🔒

RESCHED_IPI_TRACE_BUDGET 🔒

USER_PF_TRACE_BUDGET 🔒

Functions

ahci_handler 🔒

AHCI storage controller IRQ handler.

breakpoint_handler 🔒

Performs the breakpoint handler operation.

decode_error_code 🔒

Decodes PageFaultErrorCode bits into a human-readable string.

double_fault_handler 🔒

Performs the double fault handler operation.

dump_memory_bytes 🔒

Hex + ASCII dump of count bytes at virtual address vaddr. Each page boundary is translated through the raw page tables.

dump_nearby_vma_regions 🔒

Dumps VMA regions near the faulting address.

dump_page_fault_full 🔒

Full diagnostic dump for a non-recoverable page fault.

dump_page_table_walk 🔒

Detailed page table walk with flag decoding at every level.

dump_user_pf_context 🔒

Performs the dump user pf context operation.

format_pte_flags 🔒

Formats page table entry flags into a short human-readable byte string.

general_protection_fault_handler 🔒

Performs the general protection fault handler operation.

init

invalid_opcode_handler 🔒

Performs the invalid opcode handler operation.

keyboard_handler 🔒

Performs the keyboard handler operation.

lapic_timer_entry 🔒 ^⚠

Raw Local APIC timer interrupt entry.

lapic_timer_handler 🔒

Local APIC timer handler (dedicated vector, e.g. 0xD2).

lapic_timer_inner 🔒

legacy_timer_handler 🔒

Legacy external timer IRQ handler (PIC/IOAPIC IRQ0 path, vector 0x20).

live_gate_info

load

lock_idt_storage 🔒

mouse_handler 🔒

PS/2 Mouse IRQ12 handler.

needs_swapgs 🔒

Determine whether swapgs is needed at interrupt/exception entry.

nic_handler 🔒

NIC IRQ handler

non_maskable_interrupt_handler 🔒

nvme_handler 🔒

NVMe storage controller IRQ handler.

page_fault_handler 🔒

Performs the page fault handler operation.

register_ahci_irq

Register the AHCI storage controller IRQ handler.

register_lapic_timer_vector

Register the Local APIC timer IRQ vector to use the timer handler.

register_nic_irq

Register the NIC IRQ handler.

register_nvme_irq

Register the NVMe storage controller IRQ handler.

register_nvme_irq_vector

Register the NVMe storage controller IRQ handler for a specific vector.

register_virtio_block_irq

Register the VirtIO block device IRQ handler

register_xhci_irq

register_xhci_irq_vector

Register the xHCI USB controller IRQ handler.

resched_ipi_entry 🔒 ^⚠

Raw reschedule IPI entry.

resched_ipi_handler 🔒

Cross-CPU reschedule IPI handler (vector 0xF0).

resched_ipi_inner 🔒

spurious_handler 🔒

Spurious interrupt handler (APIC vector 0xFF). Per Intel SDM: do NOT send EOI for spurious interrupts.

stack_segment_fault_handler 🔒

Performs the stack segment fault handler operation.

tlb_shootdown_handler 🔒

Cross-CPU TLB shootdown IPI handler (vector 0xF0).

translate_via_raw_pt 🔒

Translates a virtual address to a physical address via a manual 4-level page table walk. Returns Some(phys) or None if any level is absent.

unlock_idt_storage 🔒

virtio_block_handler 🔒

VirtIO Block device IRQ handler

xhci_handler 🔒

xHCI USB controller IRQ handler