MaxOS::hardwarecommunication::ExceptionHandler Class Reference

Base class for handing CPU expection interrupts. More...

#include <interrupts.h>

Inheritance diagram for MaxOS::hardwarecommunication::ExceptionHandler:

Public Member Functions
	ExceptionHandler (uint8_t interrupt_number)
	Create a new base exception handler for an interrupt.
	~ExceptionHandler ()
virtual string	get_message (system::cpu_status_t *status)
	Get an human readable error message explaining this exception.
virtual system::cpu_status_t *	handle_interrupt (system::cpu_status_t *status)
	Handle the interrupt relating to this exception.
Public Member Functions inherited from MaxOS::hardwarecommunication::InterruptHandler
virtual void	handle_interrupt ()
	Handles an interrupt.

Additional Inherited Members
Protected Member Functions inherited from MaxOS::hardwarecommunication::InterruptHandler
	InterruptHandler (uint8_t interrupt_number, int64_t redirect=-1, uint64_t redirect_index=0)
	Creates a new interrupt handler and registers it with the interrupt manager.
virtual	~InterruptHandler ()
	Destroys the interrupt handler and unregisters it from the interrupt manager.
Protected Attributes inherited from MaxOS::hardwarecommunication::InterruptHandler
uint8_t	m_interrupt_number
	The interrupt number this handler handles.

Detailed Description

Base class for handing CPU expection interrupts.

Definition at line 61 of file interrupts.h.

Constructor & Destructor Documentation

ExceptionHandler()

ExceptionHandler::ExceptionHandler

(

uint8_t

interrupt_number

)

Create a new base exception handler for an interrupt.

Parameters

interrupt_number

The interrupt this exception handles

Definition at line 92 of file interrupts.cpp.

: InterruptHandler(interrupt_number)
{
}

~ExceptionHandler()

ExceptionHandler::~ExceptionHandler ( )

default

Default destructor for a ExceptionHandler

Member Function Documentation

get_message()

string ExceptionHandler::get_message ( system::cpu_status_t *  status )

virtual

Get an human readable error message explaining this exception.

Parameters

status

The CPU state at time of exception

Returns

The error message

Reimplemented in MaxOS::hardwarecommunication::DivideByZeroHandler, MaxOS::hardwarecommunication::InvaildOpCodeHandler, MaxOS::hardwarecommunication::GeneralProtectionHandler, and MaxOS::hardwarecommunication::PageFaultHandler.

Definition at line 108 of file interrupts.cpp.

                                                               {
 
    return "Unimplemented message for exception\n";
 
}

Referenced by handle_interrupt().

handle_interrupt()

cpu_status_t * ExceptionHandler::handle_interrupt ( system::cpu_status_t *  status )

virtual

Handle the interrupt relating to this exception.

Parameters

status

The CPU state at time of exception

Returns

The new CPU state to move to or null if no recoverable state

Reimplemented from MaxOS::hardwarecommunication::InterruptHandler.

Reimplemented in MaxOS::runtime::TrapFlagExcpetion, and MaxOS::runtime::BreakPointException.

Definition at line 120 of file interrupts.cpp.

                                                                     {
 
    // Get the message
    string msg = get_message(status);
 
    // Try to avoid the panic
    cpu_status_t* can_avoid = CPU::prepare_for_panic(status, msg);
    if (can_avoid != nullptr)
        return can_avoid;
 
    // Have to panic (must have occurred in kernel)
    CPU::PANIC(msg.c_str(), status);
 
    // Shouldn't return, fault if this happens
    return nullptr;
 
}

References get_message(), MaxOS::system::CPU::PANIC(), and MaxOS::system::CPU::prepare_for_panic().

---

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

• /home/runner/work/MaxOS/MaxOS/kernel/include/hardwarecommunication/interrupts.h
• /home/runner/work/MaxOS/MaxOS/kernel/src/hardwarecommunication/interrupts.cpp