ProcessorBind.h

Go to the documentation of this file.

/** @file
  Processor or Compiler specific defines and types for AArch64.
 
  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
  Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>
  Portions copyright (c) 2011 - 2013, ARM Ltd. All rights reserved.<BR>
 
  SPDX-License-Identifier: BSD-2-Clause-Patent
 
**/
 
#pragma once
 
FILE_LICENCE ( BSD2_PATENT );
FILE_SECBOOT ( PERMITTED );
 
///
/// Define the processor type so other code can make processor based choices
///
#define MDE_CPU_AARCH64
 
//
// Make sure we are using the correct packing rules per EFI specification
//
#if !defined (__GNUC__) && !defined (__ASSEMBLER__)
  #pragma pack()
#endif
 
#if defined (_MSC_EXTENSIONS)
 
//
// Disable some level 4 compilation warnings (same as IA32 and X64)
//
 
//
// Disabling bitfield type checking warnings.
//
  #pragma warning ( disable : 4214 )
 
//
// Disabling the unreferenced formal parameter warnings.
//
  #pragma warning ( disable : 4100 )
 
//
// Disable slightly different base types warning as CHAR8 * can not be set
// to a constant string.
//
  #pragma warning ( disable : 4057 )
 
//
// ASSERT(FALSE) or while (TRUE) are legal constructs so suppress this warning
//
  #pragma warning ( disable : 4127 )
 
//
// This warning is caused by functions defined but not used. For precompiled header only.
//
  #pragma warning ( disable : 4505 )
 
//
// This warning is caused by empty (after preprocessing) source file. For precompiled header only.
//
  #pragma warning ( disable : 4206 )
 
//
// Disable 'potentially uninitialized local variable X used' warnings
//
  #pragma warning ( disable : 4701 )
 
//
// Disable 'potentially uninitialized local pointer variable X used' warnings
//
  #pragma warning ( disable : 4703 )
 
//
// use Microsoft* C compiler dependent integer width types
//
typedef unsigned __int64  UINT64;
typedef __int64           INT64;
typedef unsigned __int32  UINT32;
typedef __int32           INT32;
typedef unsigned short    UINT16;
typedef unsigned short    CHAR16;
typedef short             INT16;
typedef unsigned char     BOOLEAN;
typedef unsigned char     UINT8;
typedef char              CHAR8;
typedef signed char       INT8;
 
#else
 
//
// Assume standard AARCH64 alignment.
//
typedef unsigned long long  UINT64;
typedef long long           INT64;
typedef unsigned int        UINT32;
typedef int                 INT32;
typedef unsigned short      UINT16;
typedef unsigned short      CHAR16;
typedef short               INT16;
typedef unsigned char       BOOLEAN;
typedef unsigned char       UINT8;
typedef char                CHAR8;
typedef signed char         INT8;
 
#endif
 
///
/// Unsigned value of native width.  (4 bytes on supported 32-bit processor instructions,
/// 8 bytes on supported 64-bit processor instructions)
///
typedef UINT64 UINTN;
 
///
/// Signed value of native width.  (4 bytes on supported 32-bit processor instructions,
/// 8 bytes on supported 64-bit processor instructions)
///
typedef INT64 INTN;
 
//
// Processor specific defines
//
 
///
/// A value of native width with the highest bit set.
///
#define MAX_BIT  0x8000000000000000ULL
 
///
/// A value of native width with the two highest bits set.
///
#define MAX_2_BITS  0xC000000000000000ULL
 
///
/// Maximum legal AARCH64  address
///
#define MAX_ADDRESS  0xFFFFFFFFFFFFFFFFULL
 
///
/// Maximum usable address at boot time (48 bits using 4 KB pages)
///
#define MAX_ALLOC_ADDRESS  0xFFFFFFFFFFFFULL
 
///
/// Maximum legal AArch64 INTN and UINTN values.
///
#define MAX_INTN   ((INTN)0x7FFFFFFFFFFFFFFFULL)
#define MAX_UINTN  ((UINTN)0xFFFFFFFFFFFFFFFFULL)
 
///
/// Minimum legal AArch64 INTN value.
///
#define MIN_INTN  (((INTN)-9223372036854775807LL) - 1)
 
///
/// The stack alignment required for AARCH64
///
#define CPU_STACK_ALIGNMENT  16
 
///
/// Page allocation granularity for AARCH64
///
#define DEFAULT_PAGE_ALLOCATION_GRANULARITY  (0x1000)
#define RUNTIME_PAGE_ALLOCATION_GRANULARITY  (0x10000)
 
//
// Modifier to ensure that all protocol member functions and EFI intrinsics
// use the correct C calling convention. All protocol member functions and
// EFI intrinsics are required to modify their member functions with EFIAPI.
//
#define EFIAPI
 
// When compiling with Clang, we still use GNU as for the assembler, so we still
// need to define the GCC_ASM* macros.
#if defined (__GNUC__) || defined (__clang__)
///
/// For GNU assembly code, .global or .globl can declare global symbols.
/// Define this macro to unify the usage.
///
#define ASM_GLOBAL  .globl
 
// PE targets (i.e. building with CLANGPDB) do not support the ELF style .type directive
  #ifdef __ELF__
#define _ASM_TYPE(Name)  .type Name, %function
  #else
#define _ASM_TYPE(Name)
  #endif // __ELF__
 
#define GCC_ASM_EXPORT(func__)  \
         .global  ASM_PFX(func__)    ;\
         _ASM_TYPE(ASM_PFX(func__))
 
#define GCC_ASM_IMPORT(func__)  \
         .extern  _CONCATENATE (__USER_LABEL_PREFIX__, func__)
 
  #if defined (__ARM_FEATURE_BTI_DEFAULT) && __ARM_FEATURE_BTI_DEFAULT == 1
#define AARCH64_BTI_NOTE()                                         \
    .ifndef       .Lgnu_bti_notesize                              ;\
    .pushsection  .note.gnu.property, "a"                         ;\
    .set          NT_GNU_PROPERTY_TYPE_0, 0x5                     ;\
    .set          GNU_PROPERTY_AARCH64_FEATURE_1_AND, 0xc0000000  ;\
    .set          GNU_PROPERTY_AARCH64_FEATURE_1_BTI, 0x1         ;\
    .align        3                                               ;\
    .long         .Lnamesize                                      ;\
    .long         .Lgnu_bti_notesize                              ;\
    .long         NT_GNU_PROPERTY_TYPE_0                          ;\
0:  .asciz        "GNU"                                           ;\
    .set          .Lnamesize, . - 0b                              ;\
    .align        3                                               ;\
1:  .long         GNU_PROPERTY_AARCH64_FEATURE_1_AND              ;\
    .long         .Lvalsize                                       ;\
2:  .long         GNU_PROPERTY_AARCH64_FEATURE_1_BTI              ;\
    .set          .Lvalsize, . - 2b                               ;\
    .align        3                                               ;\
    .set          .Lgnu_bti_notesize, . - 1b                      ;\
    .popsection                                                   ;\
    .endif
 
#define AARCH64_BTI(__type)                                        \
    AARCH64_BTI_NOTE()                                            ;\
    bti           __type
 
  #endif
 
#endif
 
#ifndef AARCH64_BTI
#define AARCH64_BTI_NOTE()
#define AARCH64_BTI(__type)
#endif
 
/**
  Return the pointer to the first instruction of a function given a function pointer.
  On ARM CPU architectures, these two pointer values are the same,
  so the implementation of this macro is very simple.
 
  @param  FunctionPointer   A pointer to a function.
 
  @return The pointer to the first instruction of a function given a function pointer.
 
**/
#define FUNCTION_ENTRY_POINT(FunctionPointer)  (VOID *)(UINTN)(FunctionPointer)
 
#ifndef __USER_LABEL_PREFIX__
#define __USER_LABEL_PREFIX__
#endif