SetJumpLongJump.c File Reference

#include "BaseLibInternals.h"

Go to the source code of this file.

Functions
RETURNS_TWICE UINTN EFIAPI	SetJump (OUT BASE_LIBRARY_JUMP_BUFFER *JumpBuffer)
VOID EFIAPI	InternalLongJump (IN BASE_LIBRARY_JUMP_BUFFER *JumpBuffer, IN UINTN Value)

Detailed Description

Implementation of SetJump() and LongJump() on EBC.

SetJump() and LongJump() are not currently supported for the EBC processor type. Implementation for EBC just returns 0 for SetJump(), and ASSERT() for LongJump().

Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file SetJumpLongJump.c.

Function Documentation

InternalLongJump()

VOID EFIAPI InternalLongJump	(	IN BASE_LIBRARY_JUMP_BUFFER *	JumpBuffer,
		IN UINTN	Value
	)

Restores the CPU context that was saved with SetJump().

Restores the CPU context from the buffer specified by JumpBuffer. This function never returns to the caller. Instead it resumes execution based on the state of JumpBuffer.

Parameters

JumpBuffer	A pointer to CPU context buffer.
Value	The value to return when the SetJump() context is restored.

Definition at line 53 of file SetJumpLongJump.c.

SetJump()

RETURNS_TWICE UINTN EFIAPI SetJump

(

OUT BASE_LIBRARY_JUMP_BUFFER *

JumpBuffer

)

Saves the current CPU context that can be restored with a call to LongJump() and returns 0.

Saves the current CPU context in the buffer specified by JumpBuffer and returns 0. The initial call to SetJump() must always return 0. Subsequent calls to LongJump() cause a non-zero value to be returned by SetJump().

If JumpBuffer is NULL, then ASSERT(). For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().

Parameters

JumpBuffer

A pointer to CPU context buffer.

Return values

0	Indicates a return from SetJump().

Definition at line 32 of file SetJumpLongJump.c.