]>
Commit | Line | Data |
---|---|---|
94e68c3e | 1 | /** @file\r |
4cbd2175 | 2 | Long Jump functions.\r |
94e68c3e | 3 | \r |
4 | Copyright (c) 2006, Intel Corporation\r | |
5 | All rights reserved. This program and the accompanying materials\r | |
6 | are licensed and made available under the terms and conditions of the BSD License\r | |
7 | which accompanies this distribution. The full text of the license may be found at\r | |
8 | http://opensource.org/licenses/bsd-license.php\r | |
9 | \r | |
10 | THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r | |
11 | WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r | |
12 | \r | |
13 | Module Name: LongJump.c\r | |
14 | \r | |
15 | **/\r | |
16 | \r | |
1ea5ca46 | 17 | /**\r |
18 | Worker function that checks ASSERT condition for JumpBuffer\r | |
19 | \r | |
20 | Checks ASSERT condition for JumpBuffer.\r | |
21 | \r | |
22 | If JumpBuffer is NULL, then ASSERT().\r | |
23 | For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().\r | |
24 | \r | |
25 | @param JumpBuffer A pointer to CPU context buffer.\r | |
26 | \r | |
27 | **/\r | |
94e68c3e | 28 | VOID\r |
4cbd2175 | 29 | InternalAssertJumpBuffer (\r |
30 | IN BASE_LIBRARY_JUMP_BUFFER *JumpBuffer\r | |
31 | );\r | |
32 | \r | |
1ea5ca46 | 33 | /**\r |
34 | Restores the CPU context that was saved with SetJump().\r | |
35 | \r | |
36 | Restores the CPU context from the buffer specified by JumpBuffer.\r | |
37 | This function never returns to the caller.\r | |
38 | Instead is resumes execution based on the state of JumpBuffer.\r | |
39 | \r | |
40 | @param JumpBuffer A pointer to CPU context buffer.\r | |
41 | @param Value The value to return when the SetJump() context is restored.\r | |
42 | \r | |
43 | **/\r | |
4cbd2175 | 44 | VOID\r |
45 | EFIAPI\r | |
46 | InternalLongJump (\r | |
47 | IN BASE_LIBRARY_JUMP_BUFFER *JumpBuffer,\r | |
48 | IN UINTN Value\r | |
94e68c3e | 49 | );\r |
50 | \r | |
51 | /**\r | |
52 | Restores the CPU context that was saved with SetJump().\r | |
53 | \r | |
54 | Restores the CPU context from the buffer specified by JumpBuffer.\r | |
55 | This function never returns to the caller.\r | |
56 | Instead is resumes execution based on the state of JumpBuffer.\r | |
57 | \r | |
58 | If JumpBuffer is NULL, then ASSERT().\r | |
1ea5ca46 | 59 | For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().\r |
94e68c3e | 60 | If Value is 0, then ASSERT().\r |
61 | \r | |
62 | @param JumpBuffer A pointer to CPU context buffer.\r | |
63 | @param Value The value to return when the SetJump() context is restored.\r | |
64 | \r | |
65 | **/\r | |
66 | VOID\r | |
67 | EFIAPI\r | |
68 | LongJump (\r | |
4cbd2175 | 69 | IN BASE_LIBRARY_JUMP_BUFFER *JumpBuffer,\r |
70 | IN UINTN Value\r | |
94e68c3e | 71 | )\r |
72 | {\r | |
4cbd2175 | 73 | InternalAssertJumpBuffer (JumpBuffer);\r |
0ffa1286 | 74 | ASSERT (Value != 0);\r |
75 | \r | |
4cbd2175 | 76 | InternalLongJump (JumpBuffer, Value);\r |
94e68c3e | 77 | }\r |