Moduleghc-9.10.3GHC2021

GHC.Platform

Platform description

14 types
26 values

Packageghc-9.10.3
Exports40
LanguageGHC2021
LicenceBSD-3-Clause
SourcePlatform.hs

datadata Platform

Platform description

This is used to describe platforms so that we can generate code for them.

Constructors

Platform
- platformArchOS :: !ArchOS
  Architecture and OS
- platformWordSize :: !PlatformWordSize
  Word size
- platformByteOrder :: !ByteOrder
  Byte order (endianness)
- platformUnregisterised :: !Bool
- platformHasGnuNonexecStack :: !Bool
- platformHasIdentDirective :: !Bool
- platformHasSubsectionsViaSymbols :: !Bool
- platformIsCrossCompiling :: !Bool
- platformLeadingUnderscore :: !Bool
  Symbols need underscore prefix
- platformTablesNextToCode :: !Bool
  Determines whether we will be compiling info tables that reside just before the entry code, or with an indirection to the entry code. See TABLES_NEXT_TO_CODE in rtsincludertsstorageInfoTables.h.
- platformHasLibm :: !Bool
  Some platforms require that we explicitly link against libm if any math-y things are used (which we assume to include all programs). See #14022.
- platform_constants :: !Maybe PlatformConstants
  Constants such as structure offsets, type sizes, etc.

Instances28Eq, Ord, Read, Show, OutputableP, …

Eq PlatformDefined in ghc-9.10.3 · GHC.Platform
Ord PlatformDefined in ghc-9.10.3 · GHC.Platform
Read PlatformDefined in ghc-9.10.3 · GHC.Platform
Show PlatformDefined in ghc-9.10.3 · GHC.Platform
OutputableP Platform CmmGraphDefined in ghc-9.10.3 · GHC.Cmm
OutputableP Platform CmmInfoTableDefined in ghc-9.10.3 · GHC.Cmm
OutputableP Platform CmmStaticDefined in ghc-9.10.3 · GHC.Cmm
OutputableP Platform CmmTopInfoDefined in ghc-9.10.3 · GHC.Cmm
OutputableP Platform CLabelDefined in ghc-9.10.3 · GHC.Cmm.CLabel
OutputableP Platform InfoProvEntDefined in ghc-9.10.3 · GHC.Cmm.CLabel
OutputableP Platform DebugBlockDefined in ghc-9.10.3 · GHC.Cmm.DebugBlock
OutputableP Platform UnwindExprDefined in ghc-9.10.3 · GHC.Cmm.DebugBlock
OutputableP Platform UnwindPointDefined in ghc-9.10.3 · GHC.Cmm.DebugBlock
OutputableP Platform CmmExprDefined in ghc-9.10.3 · GHC.Cmm.Expr
OutputableP Platform CmmLitDefined in ghc-9.10.3 · GHC.Cmm.Expr
OutputableP Platform ForeignTargetDefined in ghc-9.10.3 · GHC.Cmm.Node
OutputableP Platform DwarfFrameBlockDefined in ghc-9.10.3 · GHC.CmmToAsm.Dwarf.Types
OutputableP Platform LiveInfoDefined in ghc-9.10.3 · GHC.CmmToAsm.Reg.Liveness
OutputableP Platform CgLocDefined in ghc-9.10.3 · GHC.StgToCmm.Closure
OutputableP Platform CgIdInfoDefined in ghc-9.10.3 · GHC.StgToCmm.Monad
OutputableP Platform (GenCmmStatics a)Defined in ghc-9.10.3 · GHC.Cmm
OutputableP Platform (CmmNode e x)Defined in ghc-9.10.3 · GHC.Cmm.Node
OutputableP Platform (Block CmmNode C C)Defined in ghc-9.10.3 · GHC.Cmm.Node
OutputableP Platform (Block CmmNode C O)Defined in ghc-9.10.3 · GHC.Cmm.Node
OutputableP Platform (Block CmmNode O C)Defined in ghc-9.10.3 · GHC.Cmm.Node
OutputableP Platform (Block CmmNode O O)Defined in ghc-9.10.3 · GHC.Cmm.Node
OutputableP Platform (Graph CmmNode e x)Defined in ghc-9.10.3 · GHC.Cmm.Node
(OutputableP Platform d, OutputableP Platform info, OutputableP Platform i) => OutputableP Platform (GenCmmDecl d info i)Defined in ghc-9.10.3 · GHC.Cmm

datadata PlatformWordSize

Constructors

PW4
A 32-bit platform
PW8
A 64-bit platform

Instances4Eq, Ord, Read, Show

Eq PlatformWordSizeDefined in ghc-9.10.3 · GHC.Platform
Ord PlatformWordSizeDefined in ghc-9.10.3 · GHC.Platform
Read PlatformWordSizeDefined in ghc-9.10.3 · GHC.Platform
Show PlatformWordSizeDefined in ghc-9.10.3 · GHC.Platform

valueplatformArch :: Platform -> Arch

Platform architecture

valueplatformOS :: Platform -> OS

Platform OS

datadata ArchOS

Platform architecture and OS.

Constructors

ArchOS
- archOS_arch :: Arch
- archOS_OS :: OS

Instances4Eq, Ord, Read, Show

Eq ArchOSDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Ord ArchOSDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Read ArchOSDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Show ArchOSDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS

datadata Arch

Architectures

Instances4Eq, Ord, Read, Show

Eq ArchDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Ord ArchDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Read ArchDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Show ArchDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS

datadata OS

Operating systems.

Using OSUnknown to generate code should produce a sensible default, but no promises.

OSUnknown OSLinux OSDarwin OSSolaris2 OSMinGW32 OSFreeBSD OSDragonFly OSOpenBSD OSNetBSD OSKFreeBSD OSHaiku OSQNXNTO OSAIX OSHurd OSWasi OSGhcjs

Instances4Eq, Ord, Read, Show

Eq OSDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Ord OSDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Read OSDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Show OSDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS

datadata ArmISA

ARM Instruction Set Architecture

ARMv5 ARMv6 ARMv7

Instances4Eq, Ord, Read, Show

Eq ArmISADefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Ord ArmISADefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Read ArmISADefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Show ArmISADefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS

datadata ArmISAExt

ARM extensions

VFPv2 VFPv3 VFPv3D16 NEON IWMMX2

Instances4Eq, Ord, Read, Show

Eq ArmISAExtDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Ord ArmISAExtDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Read ArmISAExtDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Show ArmISAExtDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS

datadata ArmABI

ARM ABI

SOFT SOFTFP HARD

Instances4Eq, Ord, Read, Show

Eq ArmABIDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Ord ArmABIDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Read ArmABIDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Show ArmABIDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS

datadata PPC_64ABI

PowerPC 64-bit ABI

Constructors

ELF_V1
PowerPC64
ELF_V2
PowerPC64 LE

Instances4Eq, Ord, Read, Show

Eq PPC_64ABIDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Ord PPC_64ABIDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Read PPC_64ABIDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS
Show PPC_64ABIDefined in ghc-platform-0.1.0.0 · GHC.Platform.ArchOS

datadata ByteOrder

Byte ordering.

Constructors

BigEndian
most-significant-byte occurs in lowest address.
LittleEndian
least-significant-byte occurs in lowest address.

Instances8Bounded, Enum, Eq, Ord, Read, Show, …

Bounded ByteOrderDefined in ghc-internal-9.1003.0 · GHC.Internal.ByteOrder
Enum ByteOrderDefined in ghc-internal-9.1003.0 · GHC.Internal.ByteOrder
Eq ByteOrderDefined in ghc-internal-9.1003.0 · GHC.Internal.ByteOrder
Ord ByteOrderDefined in ghc-internal-9.1003.0 · GHC.Internal.ByteOrder
Read ByteOrderDefined in ghc-internal-9.1003.0 · GHC.Internal.ByteOrder
Show ByteOrderDefined in ghc-internal-9.1003.0 · GHC.Internal.ByteOrder
Generic ByteOrderDefined in ghc-internal-9.1003.0 · GHC.Internal.ByteOrder
type Rep ByteOrder = D1 ('MetaData "ByteOrder" "GHC.Internal.ByteOrder" "ghc-internal" 'False) (C1 ('MetaCons "BigEndian" 'PrefixI 'False) U1 :+: C1 ('MetaCons "LittleEndian" 'PrefixI 'False) U1)Defined in ghc-internal-9.1003.0 · GHC.Internal.ByteOrder

valuetarget32Bit :: Platform -> Bool

This predicate tells us whether the platform is 32-bit.

valueisARM :: Arch -> Bool

valueosElfTarget :: OS -> Bool

This predicate tells us whether the OS uses the ELF as its primary object format.

valueosMachOTarget :: OS -> Bool

This predicate tells us whether the OS support Mach-O shared libraries.

valueosSubsectionsViaSymbols :: OS -> Bool

valueplatformUsesFrameworks :: Platform -> Bool

valueplatformWordSizeInBytes :: Platform -> Int

valueplatformWordSizeInBits :: Platform -> Int

valueplatformMinInt :: Platform -> Integer

Minimum representable Int value for the given platform

valueplatformMaxInt :: Platform -> Integer

Maximum representable Int value for the given platform

valueplatformMaxWord :: Platform -> Integer

Maximum representable Word value for the given platform

valueplatformInIntRange :: Platform -> Integer -> Bool

Test if the given Integer is representable with a platform Int

valueplatformInWordRange :: Platform -> Integer -> Bool

Test if the given Integer is representable with a platform Word

valueplatformCConvNeedsExtension :: Platform -> Bool

For some architectures the C calling convention is that any integer shorter than 64 bits is replaced by its 64 bits representation using sign or zero extension.

valueplatformHasRTSLinker :: Platform -> Bool

Does this platform have an RTS linker?

datadata PlatformMisc

Platform-specific settings formerly hard-coded in Config.hs.

These should probably be all be triaged whether they can be computed from other settings or belong in another another place (like Platform above).

Constructors

PlatformMisc
- platformMisc_targetPlatformString :: String
- platformMisc_ghcWithInterpreter :: Bool
- platformMisc_libFFI :: Bool
- platformMisc_llvmTarget :: String

datadata SseVersion

x86 SSE instructions

SSE1 SSE2 SSE3 SSE4 SSE42

Instances2Eq, Ord

Eq SseVersionDefined in ghc-9.10.3 · GHC.Platform
Ord SseVersionDefined in ghc-9.10.3 · GHC.Platform

datadata BmiVersion

x86 BMI (bit manipulation) instructions

BMI1 BMI2

Instances2Eq, Ord

Eq BmiVersionDefined in ghc-9.10.3 · GHC.Platform
Ord BmiVersionDefined in ghc-9.10.3 · GHC.Platform

valuewordAlignment :: Platform -> Alignment

SSE and AVX

2 declarations

valueisSseEnabled :: Platform -> Bool

valueisSse2Enabled :: Platform -> Bool

Platform constants

3 declarations

datadata PlatformConstants

Constructors

PlatformConstants
- pc_CONTROL_GROUP_CONST_291 :: !Int
- pc_STD_HDR_SIZE :: !Int
- pc_PROF_HDR_SIZE :: !Int
- pc_BLOCK_SIZE :: !Int
- pc_BLOCKS_PER_MBLOCK :: !Int
- pc_TICKY_BIN_COUNT :: !Int
- pc_OFFSET_StgRegTable_rR1 :: !Int
- pc_OFFSET_StgRegTable_rR2 :: !Int
- pc_OFFSET_StgRegTable_rR3 :: !Int
- pc_OFFSET_StgRegTable_rR4 :: !Int
- pc_OFFSET_StgRegTable_rR5 :: !Int
- pc_OFFSET_StgRegTable_rR6 :: !Int
- pc_OFFSET_StgRegTable_rR7 :: !Int
- pc_OFFSET_StgRegTable_rR8 :: !Int
- pc_OFFSET_StgRegTable_rR9 :: !Int
- pc_OFFSET_StgRegTable_rR10 :: !Int
- pc_OFFSET_StgRegTable_rF1 :: !Int
- pc_OFFSET_StgRegTable_rF2 :: !Int
- pc_OFFSET_StgRegTable_rF3 :: !Int
- pc_OFFSET_StgRegTable_rF4 :: !Int
- pc_OFFSET_StgRegTable_rF5 :: !Int
- pc_OFFSET_StgRegTable_rF6 :: !Int
- pc_OFFSET_StgRegTable_rD1 :: !Int
- pc_OFFSET_StgRegTable_rD2 :: !Int
- pc_OFFSET_StgRegTable_rD3 :: !Int
- pc_OFFSET_StgRegTable_rD4 :: !Int
- pc_OFFSET_StgRegTable_rD5 :: !Int
- pc_OFFSET_StgRegTable_rD6 :: !Int
- pc_OFFSET_StgRegTable_rXMM1 :: !Int
- pc_OFFSET_StgRegTable_rXMM2 :: !Int
- pc_OFFSET_StgRegTable_rXMM3 :: !Int
- pc_OFFSET_StgRegTable_rXMM4 :: !Int
- pc_OFFSET_StgRegTable_rXMM5 :: !Int
- pc_OFFSET_StgRegTable_rXMM6 :: !Int
- pc_OFFSET_StgRegTable_rYMM1 :: !Int
- pc_OFFSET_StgRegTable_rYMM2 :: !Int
- pc_OFFSET_StgRegTable_rYMM3 :: !Int
- pc_OFFSET_StgRegTable_rYMM4 :: !Int
- pc_OFFSET_StgRegTable_rYMM5 :: !Int
- pc_OFFSET_StgRegTable_rYMM6 :: !Int
- pc_OFFSET_StgRegTable_rZMM1 :: !Int
- pc_OFFSET_StgRegTable_rZMM2 :: !Int
- pc_OFFSET_StgRegTable_rZMM3 :: !Int
- pc_OFFSET_StgRegTable_rZMM4 :: !Int
- pc_OFFSET_StgRegTable_rZMM5 :: !Int
- pc_OFFSET_StgRegTable_rZMM6 :: !Int
- pc_OFFSET_StgRegTable_rL1 :: !Int
- pc_OFFSET_StgRegTable_rSp :: !Int
- pc_OFFSET_StgRegTable_rSpLim :: !Int
- pc_OFFSET_StgRegTable_rHp :: !Int
- pc_OFFSET_StgRegTable_rHpLim :: !Int
- pc_OFFSET_StgRegTable_rCCCS :: !Int
- pc_OFFSET_StgRegTable_rCurrentTSO :: !Int
- pc_OFFSET_StgRegTable_rCurrentNursery :: !Int
- pc_OFFSET_StgRegTable_rHpAlloc :: !Int
- pc_OFFSET_stgEagerBlackholeInfo :: !Int
- pc_OFFSET_stgGCEnter1 :: !Int
- pc_OFFSET_stgGCFun :: !Int
- pc_OFFSET_Capability_r :: !Int
- pc_OFFSET_bdescr_start :: !Int
- pc_OFFSET_bdescr_free :: !Int
- pc_OFFSET_bdescr_blocks :: !Int
- pc_OFFSET_bdescr_flags :: !Int
- pc_SIZEOF_CostCentreStack :: !Int
- pc_OFFSET_CostCentreStack_mem_alloc :: !Int
- pc_REP_CostCentreStack_mem_alloc :: !Int
- pc_OFFSET_CostCentreStack_scc_count :: !Int
- pc_REP_CostCentreStack_scc_count :: !Int
- pc_OFFSET_StgHeader_ccs :: !Int
- pc_OFFSET_StgHeader_ldvw :: !Int
- pc_SIZEOF_StgSMPThunkHeader :: !Int
- pc_OFFSET_StgEntCounter_allocs :: !Int
- pc_REP_StgEntCounter_allocs :: !Int
- pc_OFFSET_StgEntCounter_allocd :: !Int
- pc_REP_StgEntCounter_allocd :: !Int
- pc_OFFSET_StgEntCounter_registeredp :: !Int
- pc_OFFSET_StgEntCounter_link :: !Int
- pc_OFFSET_StgEntCounter_entry_count :: !Int
- pc_SIZEOF_StgUpdateFrame_NoHdr :: !Int
- pc_SIZEOF_StgOrigThunkInfoFrame_NoHdr :: !Int
- pc_SIZEOF_StgMutArrPtrs_NoHdr :: !Int
- pc_OFFSET_StgMutArrPtrs_ptrs :: !Int
- pc_OFFSET_StgMutArrPtrs_size :: !Int
- pc_SIZEOF_StgSmallMutArrPtrs_NoHdr :: !Int
- pc_OFFSET_StgSmallMutArrPtrs_ptrs :: !Int
- pc_SIZEOF_StgArrBytes_NoHdr :: !Int
- pc_OFFSET_StgArrBytes_bytes :: !Int
- pc_OFFSET_StgTSO_alloc_limit :: !Int
- pc_OFFSET_StgTSO_cccs :: !Int
- pc_OFFSET_StgTSO_stackobj :: !Int
- pc_OFFSET_StgStack_sp :: !Int
- pc_OFFSET_StgStack_stack :: !Int
- pc_OFFSET_StgUpdateFrame_updatee :: !Int
- pc_OFFSET_StgOrigThunkInfoFrame_info_ptr :: !Int
- pc_OFFSET_StgFunInfoExtraFwd_arity :: !Int
- pc_REP_StgFunInfoExtraFwd_arity :: !Int
- pc_SIZEOF_StgFunInfoExtraRev :: !Int
- pc_OFFSET_StgFunInfoExtraRev_arity :: !Int
- pc_REP_StgFunInfoExtraRev_arity :: !Int
- pc_MAX_SPEC_SELECTEE_SIZE :: !Int
- pc_MAX_SPEC_AP_SIZE :: !Int
- pc_MIN_PAYLOAD_SIZE :: !Int
- pc_MIN_INTLIKE :: !Int
- pc_MAX_INTLIKE :: !Int
- pc_MIN_CHARLIKE :: !Int
- pc_MAX_CHARLIKE :: !Int
- pc_MUT_ARR_PTRS_CARD_BITS :: !Int
- pc_MAX_Vanilla_REG :: !Int
- pc_MAX_Float_REG :: !Int
- pc_MAX_Double_REG :: !Int
- pc_MAX_Long_REG :: !Int
- pc_MAX_XMM_REG :: !Int
- pc_MAX_Real_Vanilla_REG :: !Int
- pc_MAX_Real_Float_REG :: !Int
- pc_MAX_Real_Double_REG :: !Int
- pc_MAX_Real_XMM_REG :: !Int
- pc_MAX_Real_Long_REG :: !Int
- pc_RESERVED_C_STACK_BYTES :: !Int
- pc_RESERVED_STACK_WORDS :: !Int
- pc_AP_STACK_SPLIM :: !Int
- pc_WORD_SIZE :: !Int
- pc_CINT_SIZE :: !Int
- pc_CLONG_SIZE :: !Int
- pc_CLONG_LONG_SIZE :: !Int
- pc_BITMAP_BITS_SHIFT :: !Int
- pc_TAG_BITS :: !Int
- pc_LDV_SHIFT :: !Int
- pc_ILDV_CREATE_MASK :: !Integer
- pc_ILDV_STATE_CREATE :: !Integer
- pc_ILDV_STATE_USE :: !Integer
- pc_USE_INLINE_SRT_FIELD :: !Bool

Instances4Eq, Ord, Read, Show

Eq PlatformConstantsDefined in ghc-9.10.3 · GHC.Platform.Constants
Ord PlatformConstantsDefined in ghc-9.10.3 · GHC.Platform.Constants
Read PlatformConstantsDefined in ghc-9.10.3 · GHC.Platform.Constants
Show PlatformConstantsDefined in ghc-9.10.3 · GHC.Platform.Constants

valuelookupPlatformConstants :: [FilePath] -> IO (Maybe PlatformConstants)

Try to locate "DerivedConstants.h" file in the given dirs and to parse the PlatformConstants from it.

See Note [Platform constants]

valueplatformConstants :: Platform -> PlatformConstants

Shared libraries

4 declarations

valueplatformSOName :: Platform -> FilePath -> FilePath

valueplatformHsSOName :: Platform -> FilePath -> FilePath

valueplatformSOExt :: Platform -> FilePath