getexcept Kernel Service

Purpose

Allows kernel exception handlers to retrieve additional exception information.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/except.h>

void getexcept
(
exceptp)
struct except *exceptp;

Parameter

Item Description
exceptp Specifies the address of an except structure, as defined in the /usr/include/sys/except.h file. The getexcept service copies detailed exception data from the current machine-state save area into this caller-supplied structure.

Description

The getexcept kernel service provides exception handlers the capability to retrieve additional information concerning the exception from the machine-state save area.

The getexcept service should only be used by exception handlers when called to handle an exception. The contents of the structure pointed at by the exceptp parameter is platform-specific, but is described in the /usr/include/sys/except.h file for each type of exception that provides additional data. This data is typically included in any error logging data for the exception. It can be also used to attempt to handle or recover from the exception.

Execution Environment

The getexcept kernel service can be called from either the process or interrupt environment. It should be called only when handling an exception.

Return Values

The getexcept service has no return values.