https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Liming Gao <liming.gao@intel.com>
		
			
				
	
	
		
			148 lines
		
	
	
		
			6.1 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			148 lines
		
	
	
		
			6.1 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
|   Non-existing BaseLib functions on x64
 | |
| 
 | |
|   Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>
 | |
|   SPDX-License-Identifier: BSD-2-Clause-Patent
 | |
| 
 | |
| **/
 | |
| 
 | |
| #include <Library/BaseLib.h>
 | |
| #include <Library/DebugLib.h>
 | |
| 
 | |
| /**
 | |
|   Enables the 32-bit paging mode on the CPU.
 | |
| 
 | |
|   Enables the 32-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables
 | |
|   must be properly initialized prior to calling this service. This function
 | |
|   assumes the current execution mode is 32-bit protected mode. This function is
 | |
|   only available on IA-32. After the 32-bit paging mode is enabled, control is
 | |
|   transferred to the function specified by EntryPoint using the new stack
 | |
|   specified by NewStack and passing in the parameters specified by Context1 and
 | |
|   Context2. Context1 and Context2 are optional and may be NULL. The function
 | |
|   EntryPoint must never return.
 | |
| 
 | |
|   There are a number of constraints that must be followed before calling this
 | |
|   function:
 | |
|   1)  Interrupts must be disabled.
 | |
|   2)  The caller must be in 32-bit protected mode with flat descriptors. This
 | |
|       means all descriptors must have a base of 0 and a limit of 4GB.
 | |
|   3)  CR0 and CR4 must be compatible with 32-bit protected mode with flat
 | |
|       descriptors.
 | |
|   4)  CR3 must point to valid page tables that will be used once the transition
 | |
|       is complete, and those page tables must guarantee that the pages for this
 | |
|       function and the stack are identity mapped.
 | |
| 
 | |
|   @param  EntryPoint  A pointer to function to call with the new stack after
 | |
|                       paging is enabled.
 | |
|   @param  Context1    A pointer to the context to pass into the EntryPoint
 | |
|                       function as the first parameter after paging is enabled.
 | |
|   @param  Context2    A pointer to the context to pass into the EntryPoint
 | |
|                       function as the second parameter after paging is enabled.
 | |
|   @param  NewStack    A pointer to the new stack to use for the EntryPoint
 | |
|                       function after paging is enabled.
 | |
| 
 | |
| **/
 | |
| VOID
 | |
| EFIAPI
 | |
| InternalX86EnablePaging32 (
 | |
|   IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,
 | |
|   IN      VOID                      *Context1,  OPTIONAL
 | |
|   IN      VOID                      *Context2,  OPTIONAL
 | |
|   IN      VOID                      *NewStack
 | |
|   )
 | |
| {
 | |
|   //
 | |
|   // This function cannot work on x64 platform
 | |
|   //
 | |
|   ASSERT (FALSE);
 | |
| }
 | |
| 
 | |
| /**
 | |
|   Disables the 32-bit paging mode on the CPU.
 | |
| 
 | |
|   Disables the 32-bit paging mode on the CPU and returns to 32-bit protected
 | |
|   mode. This function assumes the current execution mode is 32-paged protected
 | |
|   mode. This function is only available on IA-32. After the 32-bit paging mode
 | |
|   is disabled, control is transferred to the function specified by EntryPoint
 | |
|   using the new stack specified by NewStack and passing in the parameters
 | |
|   specified by Context1 and Context2. Context1 and Context2 are optional and
 | |
|   may be NULL. The function EntryPoint must never return.
 | |
| 
 | |
|   There are a number of constraints that must be followed before calling this
 | |
|   function:
 | |
|   1)  Interrupts must be disabled.
 | |
|   2)  The caller must be in 32-bit paged mode.
 | |
|   3)  CR0, CR3, and CR4 must be compatible with 32-bit paged mode.
 | |
|   4)  CR3 must point to valid page tables that guarantee that the pages for
 | |
|       this function and the stack are identity mapped.
 | |
| 
 | |
|   @param  EntryPoint  A pointer to function to call with the new stack after
 | |
|                       paging is disabled.
 | |
|   @param  Context1    A pointer to the context to pass into the EntryPoint
 | |
|                       function as the first parameter after paging is disabled.
 | |
|   @param  Context2    A pointer to the context to pass into the EntryPoint
 | |
|                       function as the second parameter after paging is
 | |
|                       disabled.
 | |
|   @param  NewStack    A pointer to the new stack to use for the EntryPoint
 | |
|                       function after paging is disabled.
 | |
| 
 | |
| **/
 | |
| VOID
 | |
| EFIAPI
 | |
| InternalX86DisablePaging32 (
 | |
|   IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,
 | |
|   IN      VOID                      *Context1,  OPTIONAL
 | |
|   IN      VOID                      *Context2,  OPTIONAL
 | |
|   IN      VOID                      *NewStack
 | |
|   )
 | |
| {
 | |
|   //
 | |
|   // This function cannot work on x64 platform
 | |
|   //
 | |
|   ASSERT (FALSE);
 | |
| }
 | |
| 
 | |
| 
 | |
| /**
 | |
|   Enables the 64-bit paging mode on the CPU.
 | |
| 
 | |
|   Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables
 | |
|   must be properly initialized prior to calling this service. This function
 | |
|   assumes the current execution mode is 32-bit protected mode with flat
 | |
|   descriptors. This function is only available on IA-32. After the 64-bit
 | |
|   paging mode is enabled, control is transferred to the function specified by
 | |
|   EntryPoint using the new stack specified by NewStack and passing in the
 | |
|   parameters specified by Context1 and Context2. Context1 and Context2 are
 | |
|   optional and may be 0. The function EntryPoint must never return.
 | |
| 
 | |
|   @param  Cs          The 16-bit selector to load in the CS before EntryPoint
 | |
|                       is called. The descriptor in the GDT that this selector
 | |
|                       references must be setup for long mode.
 | |
|   @param  EntryPoint  The 64-bit virtual address of the function to call with
 | |
|                       the new stack after paging is enabled.
 | |
|   @param  Context1    The 64-bit virtual address of the context to pass into
 | |
|                       the EntryPoint function as the first parameter after
 | |
|                       paging is enabled.
 | |
|   @param  Context2    The 64-bit virtual address of the context to pass into
 | |
|                       the EntryPoint function as the second parameter after
 | |
|                       paging is enabled.
 | |
|   @param  NewStack    The 64-bit virtual address of the new stack to use for
 | |
|                       the EntryPoint function after paging is enabled.
 | |
| 
 | |
| **/
 | |
| VOID
 | |
| EFIAPI
 | |
| InternalX86EnablePaging64 (
 | |
|   IN      UINT16                    Cs,
 | |
|   IN      UINT64                    EntryPoint,
 | |
|   IN      UINT64                    Context1,  OPTIONAL
 | |
|   IN      UINT64                    Context2,  OPTIONAL
 | |
|   IN      UINT64                    NewStack
 | |
|   )
 | |
| {
 | |
|   //
 | |
|   // This function cannot work on x64 platform.
 | |
|   //
 | |
|   ASSERT (FALSE);
 | |
| }
 |