Safe Haskell	None
Language	Haskell2010

GHC.Toolchain.Target

Contents

A Toolchain Target
- Queries
- Lenses
Re-exports

Synopsis

data Target = Target {
- tgtArchOs :: ArchOS
- tgtVendor :: Maybe String
- tgtLocallyExecutable :: Bool
- tgtSupportsGnuNonexecStack :: Bool
- tgtSupportsSubsectionsViaSymbols :: Bool
- tgtSupportsIdentDirective :: Bool
- tgtWordSize :: WordSize
- tgtEndianness :: ByteOrder
- tgtSymbolsHaveLeadingUnderscore :: Bool
- tgtLlvmTarget :: String
- tgtUnregisterised :: Bool
- tgtTablesNextToCode :: Bool
- tgtUseLibffiForAdjustors :: Bool
- tgtHasLibm :: Bool
- tgtRTSWithLibdw :: Maybe Library
- tgtCCompiler :: Cc
- tgtCxxCompiler :: Cxx
- tgtCPreprocessor :: Cpp
- tgtHsCPreprocessor :: HsCpp
- tgtJsCPreprocessor :: Maybe JsCpp
- tgtCmmCPreprocessor :: CmmCpp
- tgtCCompilerLink :: CcLink
- tgtAr :: Ar
- tgtRanlib :: Maybe Ranlib
- tgtNm :: Nm
- tgtMergeObjs :: Maybe MergeObjs
- tgtLlc :: Maybe Program
- tgtOpt :: Maybe Program
- tgtLlvmAs :: Maybe Program
- tgtWindres :: Maybe Program
- tgtDlltool :: Maybe Program
- tgtOtool :: Maybe Program
- tgtInstallNameTool :: Maybe Program
}
targetPlatformTriple :: Target -> String
data WordSize
- = WS4
- | WS8
wordSize2Bytes :: WordSize -> Int
tgtSupportsSMP :: Target -> Bool
tgtRTSLinkerOnlySupportsSharedLibs :: Target -> Bool
_tgtCC :: Lens Target Cc
_tgtCxx :: Lens Target Cxx
_tgtCpp :: Lens Target Cpp
_tgtHsCpp :: Lens Target HsCpp
data ByteOrder
- = BigEndian
- | LittleEndian

A Toolchain Target

data Target Source #

A Target consists of:

a target architecture and operating system
various bits of information about the platform
various toolchain components targetting that platform

Constructors

Target

Fields

tgtArchOs :: ArchOS
tgtVendor :: Maybe String
This is the vendor component of the triple, the other two components are found in tgtArchOs
tgtLocallyExecutable :: Bool
tgtSupportsGnuNonexecStack :: Bool
tgtSupportsSubsectionsViaSymbols :: Bool
tgtSupportsIdentDirective :: Bool
tgtWordSize :: WordSize
tgtEndianness :: ByteOrder
tgtSymbolsHaveLeadingUnderscore :: Bool
tgtLlvmTarget :: String
tgtUnregisterised :: Bool
tgtTablesNextToCode :: Bool
tgtUseLibffiForAdjustors :: Bool
We need to know whether or not to include libffi headers, and generate additional code for it
tgtHasLibm :: Bool
Does this target have a libm library that should always be linked against?
tgtRTSWithLibdw :: Maybe Library
Whether this target RTS is built with libdw support (for DWARF unwinding), and if yes, the Library configuration.
tgtCCompiler :: Cc
tgtCxxCompiler :: Cxx
tgtCPreprocessor :: Cpp
tgtHsCPreprocessor :: HsCpp
tgtJsCPreprocessor :: Maybe JsCpp
tgtCmmCPreprocessor :: CmmCpp
We set it only in javascript target
tgtCCompilerLink :: CcLink
tgtAr :: Ar
tgtRanlib :: Maybe Ranlib
N.B. Most ar implementations will add an index by default without ranlib so this is often optional
tgtNm :: Nm
tgtMergeObjs :: Maybe MergeObjs
We don't need a merge objects tool if we Ar supports -L
tgtLlc :: Maybe Program
tgtOpt :: Maybe Program
tgtLlvmAs :: Maybe Program
assembler used to assemble LLVM backend output; typically clang
tgtWindres :: Maybe Program
tgtDlltool :: Maybe Program
tgtOtool :: Maybe Program
tgtInstallNameTool :: Maybe Program

Instances

Instances details

Eq Target Source #
Instance details Defined in GHC.Toolchain.Target Methods (==) :: Target -> Target -> Bool Source # (/=) :: Target -> Target -> Bool Source #
Ord Target Source #
Instance details Defined in GHC.Toolchain.Target Methods compare :: Target -> Target -> Ordering Source # (<) :: Target -> Target -> Bool Source # (<=) :: Target -> Target -> Bool Source # (>) :: Target -> Target -> Bool Source # (>=) :: Target -> Target -> Bool Source # max :: Target -> Target -> Target Source # min :: Target -> Target -> Target Source #
Read Target Source #
Instance details Defined in GHC.Toolchain.Target Methods readsPrec :: Int -> ReadS Target Source # readList :: ReadS [Target] Source # readPrec :: ReadPrec Target Source # readListPrec :: ReadPrec [Target] Source #
Show Target Source #	Handwritten Show instance to have have better diffs against the toolchain targets generated by configure
Instance details Defined in GHC.Toolchain.Target Methods showsPrec :: Int -> Target -> ShowS Source # show :: Target -> String Source # showList :: [Target] -> ShowS Source #

targetPlatformTriple :: Target -> String Source #

Reconstruct the platform triple from a toolchain target (specifically from tgtArchOs and tgtVendor)

data WordSize Source #

Constructors

WS4
WS8

Instances

Instances details

Eq WordSize Source #
Instance details Defined in GHC.Toolchain.Target Methods (==) :: WordSize -> WordSize -> Bool Source # (/=) :: WordSize -> WordSize -> Bool Source #
Ord WordSize Source #
Instance details Defined in GHC.Toolchain.Target Methods compare :: WordSize -> WordSize -> Ordering Source # (<) :: WordSize -> WordSize -> Bool Source # (<=) :: WordSize -> WordSize -> Bool Source # (>) :: WordSize -> WordSize -> Bool Source # (>=) :: WordSize -> WordSize -> Bool Source # max :: WordSize -> WordSize -> WordSize Source # min :: WordSize -> WordSize -> WordSize Source #
Read WordSize Source #
Instance details Defined in GHC.Toolchain.Target Methods readsPrec :: Int -> ReadS WordSize Source # readList :: ReadS [WordSize] Source # readPrec :: ReadPrec WordSize Source # readListPrec :: ReadPrec [WordSize] Source #
Show WordSize Source #
Instance details Defined in GHC.Toolchain.Target Methods showsPrec :: Int -> WordSize -> ShowS Source # show :: WordSize -> String Source # showList :: [WordSize] -> ShowS Source #

wordSize2Bytes :: WordSize -> Int Source #

The word size as an integer representing the number of bytes

Queries

tgtSupportsSMP :: Target -> Bool Source #

tgtRTSLinkerOnlySupportsSharedLibs :: Target -> Bool Source #

Does the target RTS linker only support loading shared libraries? If true, this has several implications: 1. The GHC driver must not do loadArchive/loadObj etc and must always do loadDLL, regardless of whether host GHC is dynamic or not. 2. The GHC driver will always enable -dynamic-too when compiling vanilla way with TH codegen requirement. 3. ghci will always enforce dynamic ways even if -dynamic or -dynamic-too is not explicitly passed. 4. Cabal must not build ghci objects since it's not supported by the target. 5. The testsuite driver will use dyn way for TH/ghci tests even when host GHC is static. 6. TH/ghci doesn't work if stage1 is built without shared libraries (e.g. quickest/fully_static).

Lenses

_tgtCC :: Lens Target Cc Source #

_tgtCxx :: Lens Target Cxx Source #

_tgtCpp :: Lens Target Cpp Source #

_tgtHsCpp :: Lens Target HsCpp Source #

Re-exports

data ByteOrder Source #

Byte ordering.

Constructors

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

Instances

Instances details

Eq ByteOrder Source #

Since: base-4.11.0.0

Instance details

Defined in GHC.Internal.ByteOrder

Methods

(==) :: ByteOrder -> ByteOrder -> Bool Source #

(/=) :: ByteOrder -> ByteOrder -> Bool Source #

Ord ByteOrder Source #

Since: base-4.11.0.0

Instance details

Defined in GHC.Internal.ByteOrder

Methods

compare :: ByteOrder -> ByteOrder -> Ordering Source #

(<) :: ByteOrder -> ByteOrder -> Bool Source #

(<=) :: ByteOrder -> ByteOrder -> Bool Source #

(>) :: ByteOrder -> ByteOrder -> Bool Source #

(>=) :: ByteOrder -> ByteOrder -> Bool Source #

max :: ByteOrder -> ByteOrder -> ByteOrder Source #

min :: ByteOrder -> ByteOrder -> ByteOrder Source #

Bounded ByteOrder Source #

Since: base-4.11.0.0

Instance details

Defined in GHC.Internal.ByteOrder

Methods

minBound :: ByteOrder Source #

maxBound :: ByteOrder Source #

Enum ByteOrder Source #

Since: base-4.11.0.0

Instance details

Defined in GHC.Internal.ByteOrder

Methods

succ :: ByteOrder -> ByteOrder Source #

pred :: ByteOrder -> ByteOrder Source #

toEnum :: Int -> ByteOrder Source #

fromEnum :: ByteOrder -> Int Source #

enumFrom :: ByteOrder -> [ByteOrder] Source #

enumFromThen :: ByteOrder -> ByteOrder -> [ByteOrder] Source #

enumFromTo :: ByteOrder -> ByteOrder -> [ByteOrder] Source #

enumFromThenTo :: ByteOrder -> ByteOrder -> ByteOrder -> [ByteOrder] Source #

Generic ByteOrder Source #

Instance details

Defined in GHC.Internal.Generics

Associated Types

type Rep ByteOrder	Since: base-4.15.0.0
Instance details Defined in GHC.Internal.Generics type Rep ByteOrder = D1 ('MetaData "ByteOrder" "GHC.Internal.ByteOrder" "ghc-internal" 'False) (C1 ('MetaCons "BigEndian" 'PrefixI 'False) (U1 :: Type -> Type) :+: C1 ('MetaCons "LittleEndian" 'PrefixI 'False) (U1 :: Type -> Type))