Struct sunrise_kernel::i386::structures::idt::IdtEntry

#[repr(C)]pub struct IdtEntry<F> {
    pointer_low: u16,
    gdt_selector: SegmentSelector,
    zero: u8,
    options: EntryOptions,
    pointer_high: u16,
    phantom: PhantomData<F>,
}

An Interrupt Descriptor Table entry.

The generic parameter can either be HandlerFunc or HandlerFuncWithErrCode, depending on the interrupt vector.

Fields

pointer_low: u16

Low word of the interrupt handler's virtual address. In an interrupt/trap gate, the processor will far jump to this pointer when the interrupt occurs. It is unused for task gates.

gdt_selector: SegmentSelector

A segment selector.

• For interrupt/trap gates, the selector will be used when far jumping to the handler. It should be a selector to a code segment.
• For task gates, the selector will be used to perform hardware task switching. It should be a selector to a TSS segment.

zero: u8

Unused.

options: EntryOptions

Option bitfield.

pointer_high: u16

High word of the interrupt handler's virtual address.

phantom: PhantomData<F>

Type-safety guarantee: ensure that the function handler has the correct amount of arguments, return types, etc...

Implementations

impl<F> IdtEntry<F>

fn missing() -> Self

Creates a non-present IDT entry (but sets the must-be-one bits).

pub unsafe fn set_interrupt_gate_addr(&mut self, addr: u32) -> &mut EntryOptions

Set an interrupt gate function for the IDT entry and sets the present bit.

For the code selector field, this function uses the code segment selector currently active in the CPU.

The function returns a mutable reference to the entry's options that allows further customization.

Safety

The provided addr must be a valid virtual address to a function following the x86-interrupt ABI.

pub unsafe fn set_handler_task_gate(&mut self, tss_selector: SegmentSelector)

Set a task gate for the IDT entry and sets the present bit.

Safety

tss_selector must point to a valid TSS, which will remain present. The TSS' eip should point to the handler function. The TSS' esp and esp0 should point to a usable stack for the handler function.

impl<T> IdtEntry<T>

pub fn set_handler_fn(
    &mut self,
    handler_asm_wrapper: extern "C" fn()
) -> &mut EntryOptions

Set an interrupt gate function for the IDT entry and sets the present bit.

For the code selector field, this function uses the code segment selector currently active in the CPU.

The function returns a mutable reference to the entry's options that allows further customization.

Trait Implementations

impl<F: Clone> Clone for IdtEntry<F>

fn clone(&self) -> IdtEntry<F>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<F: Copy> Copy for IdtEntry<F>

impl<F> Debug for IdtEntry<F>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.