[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1

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

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.

Implementation Specifics

The getexcept kernel service is part of Base Operating System (BOS) Runtime.

Related Information

Kernel Extension and Device Driver Management Kernel Services and in AIX Version 4.3 Kernel Extensions and Device Support Programming Concepts.


[ Previous | Next | Contents | Home | Search ]