Moduleghc-10.0.0.20260917GHC2024

GHC.Settings

Run-time settings

7 types
57 values

Packageghc-10.0.0.20260917
Exports64
LanguageGHC2024
LicenceBSD-3-Clause
SourceSettings.hs

datadata Settings

Constructors

Settings
- sGhcNameVersion :: !GhcNameVersion
- sFileSettings :: !FileSettings
- sTargetPlatform :: Platform
- sToolSettings :: !ToolSettings
- sPlatformMisc :: !PlatformMisc
- sUnitSettings :: !UnitSettings
- sRawSettings :: [(String, String)]
- sRawTarget :: Target

datadata ToolSettings

Settings for other executables GHC calls.

Probably should further split down by phase, or split between platform-specific and platform-agnostic.

Constructors

ToolSettings
- toolSettings_ldSupportsCompactUnwind :: Bool
- toolSettings_ldSupportsFilelist :: Bool
- toolSettings_ldSupportsSingleModule :: Bool
- toolSettings_mergeObjsSupportsResponseFiles :: Bool
- toolSettings_ldIsGnuLd :: Bool
- toolSettings_ldSupportsVerbatimNamespace :: Bool
- toolSettings_ccSupportsNoPie :: Bool
- toolSettings_arSupportsDashL :: Bool
- toolSettings_cmmCppSupportsG0 :: Bool
- toolSettings_pgm_L :: String
- toolSettings_pgm_P :: (String, [Option])
  The Haskell C preprocessor and default options (not added by -optP)
- toolSettings_pgm_JSP :: (String, [Option])
  The JavaScript C preprocessor and default options (not added by -optP)
- toolSettings_pgm_CmmP :: (String, [Option])
  The C-- C Preprocessor and default options (not added by -optP)
- toolSettings_pgm_F :: String
- toolSettings_pgm_c :: String
- toolSettings_pgm_cxx :: String
- toolSettings_pgm_cpp :: (String, [Option])
  The C preprocessor (distinct from the Haskell C preprocessor!)
- toolSettings_pgm_a :: (String, [Option])
- toolSettings_pgm_l :: (String, [Option])
- toolSettings_pgm_lm :: Maybe (String, [Option])
  N.B. On Windows we don't have a linker which supports object merging, hence the Maybe. See Note [Object merging] in GHC.Driver.Pipeline.Execute for details.
- toolSettings_pgm_windres :: String
- toolSettings_pgm_ar :: String
- toolSettings_pgm_otool :: String
- toolSettings_pgm_install_name_tool :: String
- toolSettings_pgm_ranlib :: String
- toolSettings_pgm_lo :: (String, [Option])
  LLVM: opt llvm optimiser
- toolSettings_pgm_lc :: (String, [Option])
  LLVM: llc static compiler
- toolSettings_pgm_las :: (String, [Option])
  LLVM: assembler
- toolSettings_pgm_i :: String
- toolSettings_opt_L :: [String]
- toolSettings_opt_P :: [String]
- toolSettings_opt_JSP :: [String]
- toolSettings_opt_CmmP :: [String]
- toolSettings_opt_P_fingerprint :: Fingerprint
  cached Fingerprint of sOpt_P See Note [Repeated -optP hashing]
- toolSettings_opt_JSP_fingerprint :: Fingerprint
  cached Fingerprint of sOpt_JSP See Note [Repeated -optP hashing]
- toolSettings_opt_CmmP_fingerprint :: Fingerprint
  cached Fingerprint of sOpt_CmmP See Note [Repeated -optP hashing]
- toolSettings_opt_F :: [String]
- toolSettings_opt_c :: [String]
- toolSettings_opt_cxx :: [String]
- toolSettings_opt_a :: [String]
- toolSettings_opt_l :: [String]
- toolSettings_opt_lm :: [String]
- toolSettings_opt_windres :: [String]
- toolSettings_opt_lo :: [String]
  LLVM: llvm optimiser
- toolSettings_opt_lc :: [String]
  LLVM: llc static compiler
- toolSettings_opt_las :: [String]
- toolSettings_opt_i :: [String]
  iserv options
- toolSettings_extraGccViaCFlags :: [String]

datadata FileSettings

Paths to various files and directories used by GHC, including those that provide more settings.

Constructors

FileSettings
- fileSettings_ghcUsagePath :: FilePath
- fileSettings_ghciUsagePath :: FilePath
- fileSettings_toolDir :: Maybe FilePath
- fileSettings_topDir :: FilePath
- fileSettings_globalPackageDatabase :: FilePath

datadata UnitSettings

Constructors

UnitSettings
- unitSettings_baseUnitId :: !UnitId

datadata GhcNameVersion

Settings for what GHC this is.

Constructors

GhcNameVersion
- ghcNameVersion_programName :: String
- ghcNameVersion_projectVersion :: String

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
  Enable Darwin .subsections_via_symbols directive
  See Note [Subsections Via Symbols] in GHC.CmmToAsm.X86.Ppr
- 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-10.0.0.20260917 · GHC.Platform
Ord PlatformDefined in ghc-10.0.0.20260917 · GHC.Platform
Read PlatformDefined in ghc-10.0.0.20260917 · GHC.Platform
Show PlatformDefined in ghc-10.0.0.20260917 · GHC.Platform
OutputableP Platform CmmGraphDefined in ghc-10.0.0.20260917 · GHC.Cmm
OutputableP Platform CmmInfoTableDefined in ghc-10.0.0.20260917 · GHC.Cmm
OutputableP Platform CmmStaticDefined in ghc-10.0.0.20260917 · GHC.Cmm
OutputableP Platform CmmTopInfoDefined in ghc-10.0.0.20260917 · GHC.Cmm
OutputableP Platform CLabelDefined in ghc-10.0.0.20260917 · GHC.Cmm.CLabel
OutputableP Platform InfoProvEntDefined in ghc-10.0.0.20260917 · GHC.Cmm.CLabel
OutputableP Platform DebugBlockDefined in ghc-10.0.0.20260917 · GHC.Cmm.DebugBlock
OutputableP Platform UnwindExprDefined in ghc-10.0.0.20260917 · GHC.Cmm.DebugBlock
OutputableP Platform UnwindPointDefined in ghc-10.0.0.20260917 · GHC.Cmm.DebugBlock
OutputableP Platform CmmExprDefined in ghc-10.0.0.20260917 · GHC.Cmm.Expr
OutputableP Platform CmmLitDefined in ghc-10.0.0.20260917 · GHC.Cmm.Expr
OutputableP Platform ForeignTargetDefined in ghc-10.0.0.20260917 · GHC.Cmm.Node
OutputableP Platform DwarfFrameBlockDefined in ghc-10.0.0.20260917 · GHC.CmmToAsm.Dwarf.Types
OutputableP Platform LiveInfoDefined in ghc-10.0.0.20260917 · GHC.CmmToAsm.Reg.Liveness
OutputableP Platform CgLocDefined in ghc-10.0.0.20260917 · GHC.StgToCmm.Closure
OutputableP Platform CgIdInfoDefined in ghc-10.0.0.20260917 · GHC.StgToCmm.Monad
OutputableP Platform (GenCmmStatics a)Defined in ghc-10.0.0.20260917 · GHC.Cmm
OutputableP Platform (CmmNode e x)Defined in ghc-10.0.0.20260917 · GHC.Cmm.Node
OutputableP Platform (Block CmmNode C C)Defined in ghc-10.0.0.20260917 · GHC.Cmm.Node
OutputableP Platform (Block CmmNode C O)Defined in ghc-10.0.0.20260917 · GHC.Cmm.Node
OutputableP Platform (Block CmmNode O C)Defined in ghc-10.0.0.20260917 · GHC.Cmm.Node
OutputableP Platform (Block CmmNode O O)Defined in ghc-10.0.0.20260917 · GHC.Cmm.Node
OutputableP Platform (Graph CmmNode e x)Defined in ghc-10.0.0.20260917 · GHC.Cmm.Node
(OutputableP Platform d, OutputableP Platform info, OutputableP Platform i) => OutputableP Platform (GenCmmDecl d info i)Defined in ghc-10.0.0.20260917 · GHC.Cmm

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
- platformMisc_targetRTSLinkerOnlySupportsSharedLibs :: Bool

Accessors

57 declarations

valuedynLibSuffix :: GhcNameVersion -> String

Dynamic library suffix

valuebytecodeLibSuffix :: String

valuesProgramName :: Settings -> String

valuesProjectVersion :: Settings -> String

valuesGhcUsagePath :: Settings -> FilePath

valuesGhciUsagePath :: Settings -> FilePath

valuesToolDir :: Settings -> Maybe FilePath

valuesTopDir :: Settings -> FilePath

valuesGlobalPackageDatabasePath :: Settings -> FilePath

valuesLdSupportsCompactUnwind :: Settings -> Bool

valuesLdSupportsFilelist :: Settings -> Bool

valuesMergeObjsSupportsResponseFiles :: Settings -> Bool

valuesLdIsGnuLd :: Settings -> Bool

valuesGccSupportsNoPie :: Settings -> Bool

valuesArSupportsDashL :: Settings -> Bool

valuesPgm_L :: Settings -> String

valuesPgm_P :: Settings -> (String, [Option])

valuesPgm_JSP :: Settings -> (String, [Option])

valuesPgm_CmmP :: Settings -> (String, [Option])

valuesPgm_F :: Settings -> String

valuesPgm_c :: Settings -> String

valuesPgm_cxx :: Settings -> String

valuesPgm_cpp :: Settings -> (String, [Option])

valuesPgm_a :: Settings -> (String, [Option])

valuesPgm_l :: Settings -> (String, [Option])

valuesPgm_lm :: Settings -> Maybe (String, [Option])

valuesPgm_windres :: Settings -> String

valuesPgm_ar :: Settings -> String

valuesPgm_otool :: Settings -> String

valuesPgm_install_name_tool :: Settings -> String

valuesPgm_ranlib :: Settings -> String

valuesPgm_lo :: Settings -> (String, [Option])

valuesPgm_lc :: Settings -> (String, [Option])

valuesPgm_las :: Settings -> (String, [Option])

valuesPgm_i :: Settings -> String

valuesOpt_L :: Settings -> [String]

valuesOpt_P :: Settings -> [String]

valuesOpt_P_fingerprint :: Settings -> Fingerprint

valuesOpt_JSP :: Settings -> [String]

valuesOpt_JSP_fingerprint :: Settings -> Fingerprint

valuesOpt_CmmP :: Settings -> [String]

valuesOpt_CmmP_fingerprint :: Settings -> Fingerprint

valuesOpt_F :: Settings -> [String]

valuesOpt_c :: Settings -> [String]

valuesOpt_cxx :: Settings -> [String]

valuesOpt_a :: Settings -> [String]

valuesOpt_l :: Settings -> [String]

valuesOpt_lm :: Settings -> [String]

valuesOpt_windres :: Settings -> [String]

valuesOpt_lo :: Settings -> [String]

valuesOpt_lc :: Settings -> [String]

valuesOpt_i :: Settings -> [String]

valuesExtraGccViaCFlags :: Settings -> [String]

valuesTargetPlatformString :: Settings -> String

valuesGhcWithInterpreter :: Settings -> Bool

valuesLibFFI :: Settings -> Bool

valuesTargetRTSLinkerOnlySupportsSharedLibs :: Settings -> Bool