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);
 | 
						|
}
 |