Implements an x86 compatible kernel. More...

#include <IntelKernel.h>

Inheritance diagram for IntelKernel:

Public Member Functions
	IntelKernel (CoreInfo *info)
	Constructor function.

virtual void	enableIRQ (u32 irq, bool enabled)
	Enable or disable an hardware interrupt (IRQ).

Public Member Functions inherited from Kernel
	Kernel (CoreInfo *info)
	Constructor function.

SplitAllocator *	getAllocator ()
	Get physical memory allocator.

ProcessManager *	getProcessManager ()
	Get process manager.

API *	getAPI ()
	Get API.

MemoryContext *	getMemoryContext ()
	Get the current MMU context.

CoreInfo *	getCoreInfo ()
	Get CoreInfo.

Timer *	getTimer ()
	Get Timer.

int	run ()
	Execute the kernel.

virtual Result	sendIRQ (const uint coreId, const uint irq)
	Send a inter-processor-interrupt (IPI) to another core.

virtual void	hookIntVector (u32 vec, InterruptHandler h, ulong p)
	Hooks a function to an hardware interrupt.

virtual void	executeIntVector (u32 vec, CPUState *state)
	Execute an interrupt handler.

virtual Result	loadBootImage ()
	Loads the boot image.

Public Member Functions inherited from WeakSingleton< Kernel >
	WeakSingleton (Kernel *obj)
	Constructor.

Static Private Member Functions
static void	exception (CPUState *state, ulong param, ulong vector)
	Called when the CPU detects a fault.

static void	interrupt (CPUState *state, ulong param, ulong vector)
	Default interrupt handler.

static void	trap (CPUState *state, ulong param, ulong vector)
	Kernel trap handler (system calls).

static void	clocktick (CPUState *state, ulong param, ulong vector)
	i8253 system clock interrupt handler.

Private Attributes
IntelPIT	m_pit
	PIT timer instance.

IntelAPIC	m_apic
	APIC instance (used if available)

IntelPIC	m_pic
	PIC instance.

Additional Inherited Members
Public Types inherited from Kernel
enum	Result { Success , InvalidBootImage , ProcessError , IOError }
	Result codes. More...

Static Public Member Functions inherited from Kernel
static Error	initializeHeap ()
	Initialize heap.

Static Public Member Functions inherited from WeakSingleton< Kernel >
static Kernel *	instance ()
	Retrieve the instance.

Protected Attributes inherited from Kernel
SplitAllocator *	m_alloc
	Physical memory allocator.

ProcessManager *	m_procs
	Process Manager.

API *	m_api
	API handlers object.

CoreInfo *	m_coreInfo
	CoreInfo object for this core.

Vector< List< InterruptHook * > * >	m_interrupts
	Interrupt handlers.

IntController *	m_intControl
	Interrupt Controller.

Timer *	m_timer
	Timer device.

Detailed Description

Implements an x86 compatible kernel.

Todo:: Debugging the kernel under GDB 9.2 on Ubuntu 20.04 seems to give a malformed/corrupted stacktrace It only happens with intel/pc on compilers g++-8 and g++-9 and g++-10.

Definition at line 43 of file IntelKernel.h.

Constructor & Destructor Documentation

◆ IntelKernel()

IntelKernel::IntelKernel ( CoreInfo * info )

Constructor function.

Definition at line 37 of file IntelKernel.cpp.

References IntelPaging::activate(), SplitAllocator::allocate(), Segment::baseHigh, Segment::baseLow, Segment::baseMid, TSS::bitmap, clocktick(), CoreInfo::coreId, enableIRQ(), TSS::esp0, exception(), executeInterrupt(), gdt, IntController::getBase(), IntelAPIC::getCounter(), Timer::getFrequency(), Timer::getInterrupt(), Segment::granularity, Kernel::hookIntVector(), IntelAPIC::initialize(), IntelPaging::initialize(), IntelPIC::initialize(), interrupt(), interruptRun, KERNEL_DS_SEL, KERNEL_TSS, KERNEL_TSS_SEL, kernelTss, Segment::limitHigh, Segment::limitLow, ltr, Kernel::m_alloc, m_apic, Kernel::m_coreInfo, Kernel::m_intControl, m_pic, m_pit, Kernel::m_timer, MegaByte, CoreInfo::memory, NOTICE, PAGESIZE, Memory::Range::phys, Segment::present, Segment::privilege, IntelCore::readCR3(), MemoryBlock::set(), IntelPIT::setFrequency(), TSS::ss0, IntelAPIC::start(), Timer::Success, CoreInfo::timerCounter, trap(), and Segment::type.

Member Function Documentation

◆ clocktick()

void IntelKernel::clocktick	(	CPUState *	state,
		ulong	param,
		ulong	vector
	)

staticprivate

i8253 system clock interrupt handler.

Parameters

state	CPU registers on time of interrupt.
param	Not used.
vector	Not used.

Definition at line 192 of file IntelKernel.cpp.

References IntelAPIC::clear(), enableIRQ(), Timer::getInterrupt(), Kernel::getProcessManager(), WeakSingleton< Kernel >::instance(), m_apic, Kernel::m_timer, ProcessManager::schedule(), and Timer::tick().

Referenced by IntelKernel().

◆ enableIRQ()

void IntelKernel::enableIRQ	(	u32	irq,
		bool	enabled
	)

virtual

Enable or disable an hardware interrupt (IRQ).

Parameters

irq	IRQ number.
enabled	True to enable, and false to disable.

Reimplemented from Kernel.

Definition at line 140 of file IntelKernel.cpp.

References Kernel::enableIRQ(), Timer::getInterrupt(), m_apic, IntelAPIC::start(), and IntelAPIC::stop().

Referenced by clocktick(), and IntelKernel().

◆ exception()

void IntelKernel::exception	(	CPUState *	state,
		ulong	param,
		ulong	vector
	)

staticprivate

Called when the CPU detects a fault.

Parameters

state	Contains CPU registers, interrupt vector and error code.
param	Not used.
vector	Not used.

Definition at line 155 of file IntelKernel.cpp.

References assert, CoreInfo::coreId, coreInfo, ProcessManager::current(), FATAL, Process::getID(), Kernel::getProcessManager(), WeakSingleton< Kernel >::instance(), IntelCore::logException(), ProcessManager::remove(), ProcessManager::schedule(), and ZERO.

Referenced by IntelKernel().

◆ interrupt()

void IntelKernel::interrupt	(	CPUState *	state,
		ulong	param,
		ulong	vector
	)

staticprivate

Default interrupt handler.

Parameters

state	Contains CPU registers, interrupt vector and error code.
param	Not used.
vector	Not used.

Definition at line 168 of file IntelKernel.cpp.

References IntController::clear(), IntController::getBase(), WeakSingleton< Kernel >::instance(), Kernel::m_intControl, and CPUState::vector.

Referenced by IntelKernel().

◆ trap()

void IntelKernel::trap	(	CPUState *	state,
		ulong	param,
		ulong	vector
	)

staticprivate

Kernel trap handler (system calls).

Parameters

state	Contains the arguments for the APIHandler, in CPU registers.
param	Not used.
vector	Not used.

Definition at line 180 of file IntelKernel.cpp.

References CPURegs::eax, CPURegs::ebx, CPURegs::ecx, CPURegs::edi, CPURegs::edx, CPURegs::esi, Kernel::getAPI(), WeakSingleton< Kernel >::instance(), API::invoke(), and CPUState::regs.

Referenced by IntelKernel().

Field Documentation

◆ m_apic

IntelAPIC IntelKernel::m_apic

private

APIC instance (used if available)

Definition at line 104 of file IntelKernel.h.

Referenced by clocktick(), enableIRQ(), and IntelKernel().

◆ m_pic

IntelPIC IntelKernel::m_pic

private

PIC instance.

Definition at line 107 of file IntelKernel.h.

Referenced by IntelKernel().

◆ m_pit

IntelPIT IntelKernel::m_pit

private

PIT timer instance.

Definition at line 101 of file IntelKernel.h.

Referenced by IntelKernel().

The documentation for this class was generated from the following files:

kernel/intel/IntelKernel.h
kernel/intel/IntelKernel.cpp

Public Member Functions

Static Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ IntelKernel()

Member Function Documentation

◆ clocktick()

◆ enableIRQ()

◆ exception()

◆ interrupt()

◆ trap()

Field Documentation

◆ m_apic

◆ m_pic

◆ m_pit