clrjmpx Kernel Service

Purpose

Removes a saved context by popping the last saved jump buffer from the list of saved contexts.

Syntax

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

void clrjmpx (jump_buffer)
label_t *jump_buffer;

Parameter

Description

The clrjmpx kernel service pops the most recent context saved by a call to the setjmpx kernel service. Since each longjmpx call automatically pops the jump buffer for the context to resume, the clrjmpx kernel service should be called only following:

• A normal return from the setjmpx service when the saved context is no longer needed
• Any code to be run that requires the saved context to be correct

The clrjmpx service takes the address of the jump buffer passed in the corresponding setjmpx service.

Execution Environment

The clrjmpx kernel service can be called from either the process or interrupt environment.

Return Values

The clrjmpx service has no return values.

Implementation Specifics

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

Related Information

The longjmpx kernel service, setjmpx kernel service.

Process and Exception Management Kernel Services and Understanding Exception Handling in AIX Version 4.3 Kernel Extensions and Device Support Programming Concepts.