5 -- (c) The University of Glasgow 2005
8 -- Most flags are dynamic flags, which means they can change from
9 -- compilation to compilation using @OPTIONS_GHC@ pragmas, and in a
10 -- multi-session GHC each session can be using different dynamic
11 -- flags. Dynamic flags can also be set at the prompt in GHCi.
13 -- * Dynamic flags and associated configuration types
25 HscTarget(..), isObjectTarget, defaultObjectTarget,
26 GhcMode(..), isOneShot,
27 GhcLink(..), isNoLink,
31 fFlags, fLangFlags, xFlags,
32 DPHBackend(..), dphPackageMaybe,
36 ghcUsagePath, ghciUsagePath, topDir, tmpDir, rawSettings,
37 extraGccViaCFlags, systemPackageConfig,
38 pgm_L, pgm_P, pgm_F, pgm_c, pgm_s, pgm_a, pgm_l, pgm_dll, pgm_T,
39 pgm_sysman, pgm_windres, pgm_lo, pgm_lc,
40 opt_L, opt_P, opt_F, opt_c, opt_m, opt_a, opt_l,
41 opt_windres, opt_lo, opt_lc,
44 -- ** Manipulating DynFlags
45 defaultDynFlags, -- Settings -> DynFlags
46 initDynFlags, -- DynFlags -> IO DynFlags
48 getOpts, -- DynFlags -> (DynFlags -> [a]) -> [a]
55 -- ** Parsing DynFlags
57 parseDynamicNoPackageFlags,
60 supportedLanguagesAndExtensions,
62 -- ** DynFlag C compiler options
65 -- * Configuration of the stg-to-stg passes
69 -- * Compiler configuration suitable for display to the user
72 -- Only in stage 2 can we be sure that the RTS
73 -- exposes the appropriate runtime boolean
78 #include "HsVersions.h"
80 #ifndef OMIT_NATIVE_CODEGEN
85 import PrelNames ( mAIN )
87 import {-# SOURCE #-} Packages (PackageState)
88 import DriverPhases ( Phase(..), phaseInputExt )
91 import Constants ( mAX_CONTEXT_REDUCTION_DEPTH )
94 import Maybes ( orElse )
99 import Foreign.C ( CInt )
101 import {-# SOURCE #-} ErrUtils ( Severity(..), Message, mkLocMessage )
104 import System.IO.Unsafe ( unsafePerformIO )
107 import Control.Monad ( when )
111 import Data.Map (Map)
112 import qualified Data.Map as Map
114 import System.FilePath
115 import System.IO ( stderr, hPutChar )
117 -- -----------------------------------------------------------------------------
120 -- | Enumerates the simple on-or-off dynamic flags
127 | Opt_D_dump_cmmz_pretty
131 | Opt_D_dump_asm_native
132 | Opt_D_dump_asm_liveness
133 | Opt_D_dump_asm_coalesce
134 | Opt_D_dump_asm_regalloc
135 | Opt_D_dump_asm_regalloc_stages
136 | Opt_D_dump_asm_conflicts
137 | Opt_D_dump_asm_stats
138 | Opt_D_dump_asm_expanded
140 | Opt_D_dump_core_stats
146 | Opt_D_dump_inlinings
147 | Opt_D_dump_rule_firings
148 | Opt_D_dump_rule_rewrites
149 | Opt_D_dump_occur_anal
153 | Opt_D_dump_simpl_iterations
154 | Opt_D_dump_simpl_phases
163 | Opt_D_dump_worker_wrapper
164 | Opt_D_dump_rn_trace
165 | Opt_D_dump_rn_stats
167 | Opt_D_dump_simpl_stats
168 | Opt_D_dump_cs_trace -- Constraint solver in type checker
169 | Opt_D_dump_tc_trace
170 | Opt_D_dump_if_trace
171 | Opt_D_dump_vt_trace
178 | Opt_D_verbose_core2core
179 | Opt_D_verbose_stg2stg
181 | Opt_D_dump_hi_diffs
182 | Opt_D_dump_minimal_imports
183 | Opt_D_dump_mod_cycles
184 | Opt_D_dump_view_pattern_commoning
185 | Opt_D_faststring_stats
186 | Opt_DumpToFile -- ^ Append dump output to files instead of stdout.
187 | Opt_D_no_debug_output
193 | Opt_WarnIsError -- -Werror; makes warnings fatal
194 | Opt_WarnDuplicateExports
196 | Opt_WarnImplicitPrelude
197 | Opt_WarnIncompletePatterns
198 | Opt_WarnIncompleteUniPatterns
199 | Opt_WarnIncompletePatternsRecUpd
200 | Opt_WarnMissingFields
201 | Opt_WarnMissingImportList
202 | Opt_WarnMissingMethods
203 | Opt_WarnMissingSigs
204 | Opt_WarnMissingLocalSigs
205 | Opt_WarnNameShadowing
206 | Opt_WarnOverlappingPatterns
207 | Opt_WarnTypeDefaults
208 | Opt_WarnMonomorphism
209 | Opt_WarnUnusedBinds
210 | Opt_WarnUnusedImports
211 | Opt_WarnUnusedMatches
212 | Opt_WarnWarningsDeprecations
213 | Opt_WarnDeprecatedFlags
214 | Opt_WarnDodgyExports
215 | Opt_WarnDodgyImports
217 | Opt_WarnAutoOrphans
220 | Opt_WarnUnrecognisedPragmas
221 | Opt_WarnDodgyForeignImports
222 | Opt_WarnLazyUnliftedBindings
223 | Opt_WarnUnusedDoBind
224 | Opt_WarnWrongDoBind
225 | Opt_WarnAlternativeLayoutRuleTransitional
227 | Opt_PrintExplicitForalls
234 | Opt_StaticArgumentTransformation
238 | Opt_DoLambdaEtaExpansion
242 | Opt_UnboxStrictFields
243 | Opt_MethodSharing -- Now a no-op; remove in GHC 7.2
245 | Opt_EnableRewriteRules -- Apply rewrite rules during simplification
247 | Opt_RegsGraph -- do graph coloring register allocation
248 | Opt_RegsIterative -- do iterative coalescing graph coloring register allocation
251 | Opt_IgnoreInterfacePragmas
252 | Opt_OmitInterfacePragmas
253 | Opt_ExposeAllUnfoldings
256 | Opt_AutoSccsOnAllToplevs
257 | Opt_AutoSccsOnExportedToplevs
258 | Opt_AutoSccsOnIndividualCafs
264 | Opt_ExcessPrecision
265 | Opt_EagerBlackHoling
266 | Opt_ReadUserPackageConf
270 | Opt_HideAllPackages
271 | Opt_PrintBindResult
275 | Opt_BreakOnException
277 | Opt_PrintEvldWithShow
278 | Opt_PrintBindContents
281 | Opt_EmitExternalCore
283 | Opt_BuildingCabalPackage
291 | Opt_ConvertToZipCfgAndBack
292 | Opt_AutoLinkPackages
293 | Opt_ImplicitImportQualified
301 | Opt_KeepRawTokenStream
306 data Language = Haskell98 | Haskell2010
310 | Opt_OverlappingInstances
311 | Opt_UndecidableInstances
312 | Opt_IncoherentInstances
313 | Opt_MonomorphismRestriction
316 | Opt_RelaxedPolyRec -- Deprecated
317 | Opt_ExtendedDefaultRules -- Use GHC's extended rules for defaulting
318 | Opt_ForeignFunctionInterface
319 | Opt_UnliftedFFITypes
320 | Opt_GHCForeignImportPrim
321 | Opt_ParallelArrays -- Syntactic support for parallel arrays
322 | Opt_Arrows -- Arrow-notation syntax
323 | Opt_TemplateHaskell
326 | Opt_Generics -- "Derivable type classes"
327 | Opt_ImplicitPrelude
328 | Opt_ScopedTypeVariables
332 | Opt_OverloadedStrings
333 | Opt_DisambiguateRecordFields
334 | Opt_RecordWildCards
340 | Opt_DoAndIfThenElse
341 | Opt_RebindableSyntax
343 | Opt_StandaloneDeriving
344 | Opt_DeriveDataTypeable
346 | Opt_DeriveTraversable
349 | Opt_TypeSynonymInstances
350 | Opt_FlexibleContexts
351 | Opt_FlexibleInstances
352 | Opt_ConstrainedClassMethods
353 | Opt_MultiParamTypeClasses
354 | Opt_FunctionalDependencies
356 | Opt_PolymorphicComponents
357 | Opt_ExistentialQuantification
361 | Opt_ParallelListComp
362 | Opt_TransformListComp
363 | Opt_GeneralizedNewtypeDeriving
366 | Opt_PostfixOperators
369 | Opt_LiberalTypeSynonyms
372 | Opt_ImpredicativeTypes
376 | Opt_AlternativeLayoutRule
377 | Opt_AlternativeLayoutRuleTransitional
378 | Opt_DatatypeContexts
379 | Opt_NondecreasingIndentation
383 -- | Contains not only a collection of 'DynFlag's but also a plethora of
384 -- information relating to the compilation of a single file or GHC session
385 data DynFlags = DynFlags {
388 hscTarget :: HscTarget,
389 hscOutName :: String, -- ^ Name of the output file
390 extCoreName :: String, -- ^ Name of the .hcr output file
391 verbosity :: Int, -- ^ Verbosity level: see Note [Verbosity levels]
392 optLevel :: Int, -- ^ Optimisation level
393 simplPhases :: Int, -- ^ Number of simplifier phases
394 maxSimplIterations :: Int, -- ^ Max simplifier iterations
395 shouldDumpSimplPhase :: Maybe String,
396 ruleCheck :: Maybe String,
397 strictnessBefore :: [Int], -- ^ Additional demand analysis
399 specConstrThreshold :: Maybe Int, -- ^ Threshold for SpecConstr
400 specConstrCount :: Maybe Int, -- ^ Max number of specialisations for any one function
401 liberateCaseThreshold :: Maybe Int, -- ^ Threshold for LiberateCase
402 floatLamArgs :: Maybe Int, -- ^ Arg count for lambda floating
403 -- See CoreMonad.FloatOutSwitches
405 #ifndef OMIT_NATIVE_CODEGEN
406 targetPlatform :: Platform, -- ^ The platform we're compiling for. Used by the NCG.
408 cmdlineHcIncludes :: [String], -- ^ @\-\#includes@
409 importPaths :: [FilePath],
411 mainFunIs :: Maybe String,
412 ctxtStkDepth :: Int, -- ^ Typechecker context stack depth
414 dphBackend :: DPHBackend,
416 thisPackage :: PackageId, -- ^ name of package currently being compiled
419 ways :: [Way], -- ^ Way flags from the command line
420 buildTag :: String, -- ^ The global \"way\" (e.g. \"p\" for prof)
421 rtsBuildTag :: String, -- ^ The RTS \"way\"
423 -- For object splitting
424 splitInfo :: Maybe (String,Int),
427 objectDir :: Maybe String,
428 dylibInstallName :: Maybe String,
429 hiDir :: Maybe String,
430 stubDir :: Maybe String,
436 outputFile :: Maybe String,
437 outputHi :: Maybe String,
438 dynLibLoader :: DynLibLoader,
440 -- | This is set by 'DriverPipeline.runPipeline' based on where
441 -- its output is going.
442 dumpPrefix :: Maybe FilePath,
444 -- | Override the 'dumpPrefix' set by 'DriverPipeline.runPipeline'.
445 -- Set by @-ddump-file-prefix@
446 dumpPrefixForce :: Maybe FilePath,
448 includePaths :: [String],
449 libraryPaths :: [String],
450 frameworkPaths :: [String], -- used on darwin only
451 cmdlineFrameworks :: [String], -- ditto
453 rtsOpts :: Maybe String,
454 rtsOptsEnabled :: RtsOptsEnabled,
456 hpcDir :: String, -- ^ Path to store the .mix files
458 settings :: Settings,
461 depMakefile :: FilePath,
462 depIncludePkgDeps :: Bool,
463 depExcludeMods :: [ModuleName],
464 depSuffixes :: [String],
467 extraPkgConfs :: [FilePath],
468 -- ^ The @-package-conf@ flags given on the command line, in the order
471 packageFlags :: [PackageFlag],
472 -- ^ The @-package@ and @-hide-package@ flags from the command-line
475 -- NB. do not modify this field, it is calculated by
476 -- Packages.initPackages and Packages.updatePackages.
477 pkgDatabase :: Maybe [PackageConfig],
478 pkgState :: PackageState,
481 -- These have to be IORefs, because the defaultCleanupHandler needs to
482 -- know what to clean when an exception happens
483 filesToClean :: IORef [FilePath],
484 dirsToClean :: IORef (Map FilePath FilePath),
488 -- Don't change this without updating extensionFlags:
489 language :: Maybe Language,
490 -- Don't change this without updating extensionFlags:
491 extensions :: [OnOff ExtensionFlag],
492 -- extensionFlags should always be equal to
493 -- flattenExtensionFlags language extensions
494 extensionFlags :: [ExtensionFlag],
496 -- | Message output action: use "ErrUtils" instead of this if you can
497 log_action :: Severity -> SrcSpan -> PprStyle -> Message -> IO (),
499 haddockOptions :: Maybe String
502 data Settings = Settings {
503 sGhcUsagePath :: FilePath, -- Filled in by SysTools
504 sGhciUsagePath :: FilePath, -- ditto
506 sTmpDir :: String, -- no trailing '/'
507 -- You shouldn't need to look things up in rawSettings directly.
508 -- They should have their own fields instead.
509 sRawSettings :: [(String, String)],
510 sExtraGccViaCFlags :: [String],
511 sSystemPackageConfig :: FilePath,
512 -- commands for particular phases
514 sPgm_P :: (String,[Option]),
516 sPgm_c :: (String,[Option]),
517 sPgm_s :: (String,[Option]),
518 sPgm_a :: (String,[Option]),
519 sPgm_l :: (String,[Option]),
520 sPgm_dll :: (String,[Option]),
522 sPgm_sysman :: String,
523 sPgm_windres :: String,
524 sPgm_lo :: (String,[Option]), -- LLVM: opt llvm optimiser
525 sPgm_lc :: (String,[Option]), -- LLVM: llc static compiler
526 -- options for particular phases
534 sOpt_windres :: [String],
535 sOpt_lo :: [String], -- LLVM: llvm optimiser
536 sOpt_lc :: [String] -- LLVM: llc static compiler
540 ghcUsagePath :: DynFlags -> FilePath
541 ghcUsagePath dflags = sGhcUsagePath (settings dflags)
542 ghciUsagePath :: DynFlags -> FilePath
543 ghciUsagePath dflags = sGhciUsagePath (settings dflags)
544 topDir :: DynFlags -> FilePath
545 topDir dflags = sTopDir (settings dflags)
546 tmpDir :: DynFlags -> String
547 tmpDir dflags = sTmpDir (settings dflags)
548 rawSettings :: DynFlags -> [(String, String)]
549 rawSettings dflags = sRawSettings (settings dflags)
550 extraGccViaCFlags :: DynFlags -> [String]
551 extraGccViaCFlags dflags = sExtraGccViaCFlags (settings dflags)
552 systemPackageConfig :: DynFlags -> FilePath
553 systemPackageConfig dflags = sSystemPackageConfig (settings dflags)
554 pgm_L :: DynFlags -> String
555 pgm_L dflags = sPgm_L (settings dflags)
556 pgm_P :: DynFlags -> (String,[Option])
557 pgm_P dflags = sPgm_P (settings dflags)
558 pgm_F :: DynFlags -> String
559 pgm_F dflags = sPgm_F (settings dflags)
560 pgm_c :: DynFlags -> (String,[Option])
561 pgm_c dflags = sPgm_c (settings dflags)
562 pgm_s :: DynFlags -> (String,[Option])
563 pgm_s dflags = sPgm_s (settings dflags)
564 pgm_a :: DynFlags -> (String,[Option])
565 pgm_a dflags = sPgm_a (settings dflags)
566 pgm_l :: DynFlags -> (String,[Option])
567 pgm_l dflags = sPgm_l (settings dflags)
568 pgm_dll :: DynFlags -> (String,[Option])
569 pgm_dll dflags = sPgm_dll (settings dflags)
570 pgm_T :: DynFlags -> String
571 pgm_T dflags = sPgm_T (settings dflags)
572 pgm_sysman :: DynFlags -> String
573 pgm_sysman dflags = sPgm_sysman (settings dflags)
574 pgm_windres :: DynFlags -> String
575 pgm_windres dflags = sPgm_windres (settings dflags)
576 pgm_lo :: DynFlags -> (String,[Option])
577 pgm_lo dflags = sPgm_lo (settings dflags)
578 pgm_lc :: DynFlags -> (String,[Option])
579 pgm_lc dflags = sPgm_lc (settings dflags)
580 opt_L :: DynFlags -> [String]
581 opt_L dflags = sOpt_L (settings dflags)
582 opt_P :: DynFlags -> [String]
583 opt_P dflags = sOpt_P (settings dflags)
584 opt_F :: DynFlags -> [String]
585 opt_F dflags = sOpt_F (settings dflags)
586 opt_c :: DynFlags -> [String]
587 opt_c dflags = sOpt_c (settings dflags)
588 opt_m :: DynFlags -> [String]
589 opt_m dflags = sOpt_m (settings dflags)
590 opt_a :: DynFlags -> [String]
591 opt_a dflags = sOpt_a (settings dflags)
592 opt_l :: DynFlags -> [String]
593 opt_l dflags = sOpt_l (settings dflags)
594 opt_windres :: DynFlags -> [String]
595 opt_windres dflags = sOpt_windres (settings dflags)
596 opt_lo :: DynFlags -> [String]
597 opt_lo dflags = sOpt_lo (settings dflags)
598 opt_lc :: DynFlags -> [String]
599 opt_lc dflags = sOpt_lc (settings dflags)
601 wayNames :: DynFlags -> [WayName]
602 wayNames = map wayName . ways
604 -- | The target code type of the compilation (if any).
606 -- Whenever you change the target, also make sure to set 'ghcLink' to
607 -- something sensible.
609 -- 'HscNothing' can be used to avoid generating any output, however, note
612 -- * This will not run the desugaring step, thus no warnings generated in
613 -- this step will be output. In particular, this includes warnings related
614 -- to pattern matching. You can run the desugarer manually using
615 -- 'GHC.desugarModule'.
617 -- * If a program uses Template Haskell the typechecker may try to run code
618 -- from an imported module. This will fail if no code has been generated
619 -- for this module. You can use 'GHC.needsTemplateHaskell' to detect
620 -- whether this might be the case and choose to either switch to a
621 -- different target or avoid typechecking such modules. (The latter may
622 -- preferable for security reasons.)
625 = HscC -- ^ Generate C code.
626 | HscAsm -- ^ Generate assembly using the native code generator.
627 | HscLlvm -- ^ Generate assembly using the llvm code generator.
628 | HscJava -- ^ Generate Java bytecode.
629 | HscInterpreted -- ^ Generate bytecode. (Requires 'LinkInMemory')
630 | HscNothing -- ^ Don't generate any code. See notes above.
633 -- | Will this target result in an object file on the disk?
634 isObjectTarget :: HscTarget -> Bool
635 isObjectTarget HscC = True
636 isObjectTarget HscAsm = True
637 isObjectTarget HscLlvm = True
638 isObjectTarget _ = False
640 -- | The 'GhcMode' tells us whether we're doing multi-module
641 -- compilation (controlled via the "GHC" API) or one-shot
642 -- (single-module) compilation. This makes a difference primarily to
643 -- the "Finder": in one-shot mode we look for interface files for
644 -- imported modules, but in multi-module mode we look for source files
645 -- in order to check whether they need to be recompiled.
647 = CompManager -- ^ @\-\-make@, GHCi, etc.
648 | OneShot -- ^ @ghc -c Foo.hs@
649 | MkDepend -- ^ @ghc -M@, see "Finder" for why we need this
652 instance Outputable GhcMode where
653 ppr CompManager = ptext (sLit "CompManager")
654 ppr OneShot = ptext (sLit "OneShot")
655 ppr MkDepend = ptext (sLit "MkDepend")
657 isOneShot :: GhcMode -> Bool
658 isOneShot OneShot = True
659 isOneShot _other = False
661 -- | What to do in the link step, if there is one.
663 = NoLink -- ^ Don't link at all
664 | LinkBinary -- ^ Link object code into a binary
665 | LinkInMemory -- ^ Use the in-memory dynamic linker (works for both
666 -- bytecode and object code).
667 | LinkDynLib -- ^ Link objects into a dynamic lib (DLL on Windows, DSO on ELF platforms)
670 isNoLink :: GhcLink -> Bool
671 isNoLink NoLink = True
674 -- Is it worth evaluating this Bool and caching it in the DynFlags value
675 -- during initDynFlags?
676 doingTickyProfiling :: DynFlags -> Bool
677 doingTickyProfiling _ = opt_Ticky
678 -- XXX -ticky is a static flag, because it implies -debug which is also
679 -- static. If the way flags were made dynamic, we could fix this.
682 = ExposePackage String
683 | ExposePackageId String
685 | IgnorePackage String
688 defaultHscTarget :: HscTarget
689 defaultHscTarget = defaultObjectTarget
691 -- | The 'HscTarget' value corresponding to the default way to create
692 -- object files on the current platform.
693 defaultObjectTarget :: HscTarget
695 | cGhcUnregisterised == "YES" = HscC
696 | cGhcWithNativeCodeGen == "YES" = HscAsm
697 | otherwise = HscLlvm
704 data RtsOptsEnabled = RtsOptsNone | RtsOptsSafeOnly | RtsOptsAll
707 -- | Used by 'GHC.newSession' to partially initialize a new 'DynFlags' value
708 initDynFlags :: DynFlags -> IO DynFlags
709 initDynFlags dflags = do
710 -- someday these will be dynamic flags
711 ways <- readIORef v_Ways
712 refFilesToClean <- newIORef []
713 refDirsToClean <- newIORef Map.empty
716 buildTag = mkBuildTag (filter (not . wayRTSOnly) ways),
717 rtsBuildTag = mkBuildTag ways,
718 filesToClean = refFilesToClean,
719 dirsToClean = refDirsToClean
722 -- | The normal 'DynFlags'. Note that they is not suitable for use in this form
723 -- and must be fully initialized by 'GHC.newSession' first.
724 defaultDynFlags :: Settings -> DynFlags
725 defaultDynFlags mySettings =
727 ghcMode = CompManager,
728 ghcLink = LinkBinary,
729 hscTarget = defaultHscTarget,
735 maxSimplIterations = 4,
736 shouldDumpSimplPhase = Nothing,
738 specConstrThreshold = Just 200,
739 specConstrCount = Just 3,
740 liberateCaseThreshold = Just 200,
741 floatLamArgs = Just 0, -- Default: float only if no fvs
742 strictnessBefore = [],
744 #ifndef OMIT_NATIVE_CODEGEN
745 targetPlatform = defaultTargetPlatform,
747 cmdlineHcIncludes = [],
751 ctxtStkDepth = mAX_CONTEXT_REDUCTION_DEPTH,
753 dphBackend = DPHNone,
755 thisPackage = mainPackageId,
758 dylibInstallName = Nothing,
762 objectSuf = phaseInputExt StopLn,
763 hcSuf = phaseInputExt HCc,
766 outputFile = Nothing,
768 dynLibLoader = SystemDependent,
769 dumpPrefix = Nothing,
770 dumpPrefixForce = Nothing,
774 cmdlineFrameworks = [],
776 rtsOptsEnabled = RtsOptsSafeOnly,
782 pkgDatabase = Nothing,
783 pkgState = panic "no package state yet: call GHC.setSessionDynFlags",
784 ways = panic "defaultDynFlags: No ways",
785 buildTag = panic "defaultDynFlags: No buildTag",
786 rtsBuildTag = panic "defaultDynFlags: No rtsBuildTag",
788 settings = mySettings,
790 depMakefile = "Makefile",
791 depIncludePkgDeps = False,
794 -- end of ghc -M values
795 filesToClean = panic "defaultDynFlags: No filesToClean",
796 dirsToClean = panic "defaultDynFlags: No dirsToClean",
797 haddockOptions = Nothing,
798 flags = defaultFlags,
801 extensionFlags = flattenExtensionFlags Nothing [],
803 log_action = \severity srcSpan style msg ->
805 SevOutput -> printOutput (msg style)
806 SevInfo -> printErrs (msg style)
807 SevFatal -> printErrs (msg style)
810 printErrs ((mkLocMessage srcSpan msg) style)
811 -- careful (#2302): printErrs prints in UTF-8, whereas
812 -- converting to string first and using hPutStr would
813 -- just emit the low 8 bits of each unicode char.
817 Note [Verbosity levels]
818 ~~~~~~~~~~~~~~~~~~~~~~~
819 0 | print errors & warnings only
820 1 | minimal verbosity: print "compiling M ... done." for each module.
821 2 | equivalent to -dshow-passes
822 3 | equivalent to existing "ghc -v"
823 4 | "ghc -v -ddump-most"
824 5 | "ghc -v -ddump-all"
830 -- OnOffs accumulate in reverse order, so we use foldr in order to
831 -- process them in the right order
832 flattenExtensionFlags :: Maybe Language -> [OnOff ExtensionFlag]
834 flattenExtensionFlags ml = foldr f defaultExtensionFlags
835 where f (On f) flags = f : delete f flags
836 f (Off f) flags = delete f flags
837 defaultExtensionFlags = languageExtensions ml
839 languageExtensions :: Maybe Language -> [ExtensionFlag]
841 languageExtensions Nothing
842 -- Nothing => the default case
843 = Opt_MonoPatBinds -- Experimentally, I'm making this non-standard
844 -- behaviour the default, to see if anyone notices
846 -- In due course I'd like Opt_MonoLocalBinds to be on by default
847 -- But NB it's implied by GADTs etc
848 -- SLPJ September 2010
849 : Opt_NondecreasingIndentation -- This has been on by default for some time
850 : languageExtensions (Just Haskell2010)
852 languageExtensions (Just Haskell98)
853 = [Opt_ImplicitPrelude,
854 Opt_MonomorphismRestriction,
856 Opt_DatatypeContexts,
857 Opt_NondecreasingIndentation
858 -- strictly speaking non-standard, but we always had this
859 -- on implicitly before the option was added in 7.1, and
860 -- turning it off breaks code, so we're keeping it on for
861 -- backwards compatibility. Cabal uses -XHaskell98 by
862 -- default unless you specify another language.
865 languageExtensions (Just Haskell2010)
866 = [Opt_ImplicitPrelude,
867 Opt_MonomorphismRestriction,
868 Opt_DatatypeContexts,
870 Opt_ForeignFunctionInterface,
875 -- | Test whether a 'DynFlag' is set
876 dopt :: DynFlag -> DynFlags -> Bool
877 dopt f dflags = f `elem` (flags dflags)
880 dopt_set :: DynFlags -> DynFlag -> DynFlags
881 dopt_set dfs f = dfs{ flags = f : flags dfs }
883 -- | Unset a 'DynFlag'
884 dopt_unset :: DynFlags -> DynFlag -> DynFlags
885 dopt_unset dfs f = dfs{ flags = filter (/= f) (flags dfs) }
887 -- | Test whether a 'ExtensionFlag' is set
888 xopt :: ExtensionFlag -> DynFlags -> Bool
889 xopt f dflags = f `elem` extensionFlags dflags
891 -- | Set a 'ExtensionFlag'
892 xopt_set :: DynFlags -> ExtensionFlag -> DynFlags
894 = let onoffs = On f : extensions dfs
895 in dfs { extensions = onoffs,
896 extensionFlags = flattenExtensionFlags (language dfs) onoffs }
898 -- | Unset a 'ExtensionFlag'
899 xopt_unset :: DynFlags -> ExtensionFlag -> DynFlags
901 = let onoffs = Off f : extensions dfs
902 in dfs { extensions = onoffs,
903 extensionFlags = flattenExtensionFlags (language dfs) onoffs }
905 setLanguage :: Language -> DynP ()
906 setLanguage l = upd f
907 where f dfs = let mLang = Just l
908 oneoffs = extensions dfs
911 extensionFlags = flattenExtensionFlags mLang oneoffs
914 -- | Retrieve the options corresponding to a particular @opt_*@ field in the correct order
915 getOpts :: DynFlags -- ^ 'DynFlags' to retrieve the options from
916 -> (DynFlags -> [a]) -- ^ Relevant record accessor: one of the @opt_*@ accessors
917 -> [a] -- ^ Correctly ordered extracted options
918 getOpts dflags opts = reverse (opts dflags)
919 -- We add to the options from the front, so we need to reverse the list
921 -- | Gets the verbosity flag for the current verbosity level. This is fed to
922 -- other tools, so GHC-specific verbosity flags like @-ddump-most@ are not included
923 getVerbFlags :: DynFlags -> [String]
925 | verbosity dflags >= 4 = ["-v"]
928 setObjectDir, setHiDir, setStubDir, setOutputDir, setDylibInstallName,
929 setObjectSuf, setHiSuf, setHcSuf, parseDynLibLoaderMode,
930 setPgmP, addOptl, addOptP,
931 addCmdlineFramework, addHaddockOpts
932 :: String -> DynFlags -> DynFlags
933 setOutputFile, setOutputHi, setDumpPrefixForce
934 :: Maybe String -> DynFlags -> DynFlags
936 setObjectDir f d = d{ objectDir = Just f}
937 setHiDir f d = d{ hiDir = Just f}
938 setStubDir f d = d{ stubDir = Just f, includePaths = f : includePaths d }
939 -- -stubdir D adds an implicit -I D, so that gcc can find the _stub.h file
940 -- \#included from the .hc file when compiling via C (i.e. unregisterised
942 setOutputDir f = setObjectDir f . setHiDir f . setStubDir f
943 setDylibInstallName f d = d{ dylibInstallName = Just f}
945 setObjectSuf f d = d{ objectSuf = f}
946 setHiSuf f d = d{ hiSuf = f}
947 setHcSuf f d = d{ hcSuf = f}
949 setOutputFile f d = d{ outputFile = f}
950 setOutputHi f d = d{ outputHi = f}
952 parseDynLibLoaderMode f d =
954 ("deploy", "") -> d{ dynLibLoader = Deployable }
955 ("sysdep", "") -> d{ dynLibLoader = SystemDependent }
956 _ -> ghcError (CmdLineError ("Unknown dynlib loader: " ++ f))
958 setDumpPrefixForce f d = d { dumpPrefixForce = f}
960 -- XXX HACK: Prelude> words "'does not' work" ===> ["'does","not'","work"]
961 -- Config.hs should really use Option.
962 setPgmP f = let (pgm:args) = words f in alterSettings (\s -> s { sPgm_P = (pgm, map Option args)})
963 addOptl f = alterSettings (\s -> s { sOpt_l = f : sOpt_l s})
964 addOptP f = alterSettings (\s -> s { sOpt_P = f : sOpt_P s})
967 setDepMakefile :: FilePath -> DynFlags -> DynFlags
968 setDepMakefile f d = d { depMakefile = deOptDep f }
970 setDepIncludePkgDeps :: Bool -> DynFlags -> DynFlags
971 setDepIncludePkgDeps b d = d { depIncludePkgDeps = b }
973 addDepExcludeMod :: String -> DynFlags -> DynFlags
975 = d { depExcludeMods = mkModuleName (deOptDep m) : depExcludeMods d }
977 addDepSuffix :: FilePath -> DynFlags -> DynFlags
978 addDepSuffix s d = d { depSuffixes = deOptDep s : depSuffixes d }
981 -- We used to use "-optdep-flag -optdeparg", so for legacy applications
982 -- we need to strip the "-optdep" off of the arg
983 deOptDep :: String -> String
984 deOptDep x = case stripPrefix "-optdep" x of
988 addCmdlineFramework f d = d{ cmdlineFrameworks = f : cmdlineFrameworks d}
990 addHaddockOpts f d = d{ haddockOptions = Just f}
992 -- -----------------------------------------------------------------------------
993 -- Command-line options
995 -- | When invoking external tools as part of the compilation pipeline, we
996 -- pass these a sequence of options on the command-line. Rather than
997 -- just using a list of Strings, we use a type that allows us to distinguish
998 -- between filepaths and 'other stuff'. The reason for this is that
999 -- this type gives us a handle on transforming filenames, and filenames only,
1000 -- to whatever format they're expected to be on a particular platform.
1002 = FileOption -- an entry that _contains_ filename(s) / filepaths.
1003 String -- a non-filepath prefix that shouldn't be
1004 -- transformed (e.g., "/out=")
1005 String -- the filepath/filename portion
1008 showOpt :: Option -> String
1009 showOpt (FileOption pre f) = pre ++ f
1010 showOpt (Option s) = s
1012 -----------------------------------------------------------------------------
1013 -- Setting the optimisation level
1015 updOptLevel :: Int -> DynFlags -> DynFlags
1016 -- ^ Sets the 'DynFlags' to be appropriate to the optimisation level
1018 = dfs2{ optLevel = final_n }
1020 final_n = max 0 (min 2 n) -- Clamp to 0 <= n <= 2
1021 dfs1 = foldr (flip dopt_unset) dfs remove_dopts
1022 dfs2 = foldr (flip dopt_set) dfs1 extra_dopts
1024 extra_dopts = [ f | (ns,f) <- optLevelFlags, final_n `elem` ns ]
1025 remove_dopts = [ f | (ns,f) <- optLevelFlags, final_n `notElem` ns ]
1027 -- -----------------------------------------------------------------------------
1028 -- StgToDo: abstraction of stg-to-stg passes to run.
1031 = StgDoMassageForProfiling -- should be (next to) last
1032 -- There's also setStgVarInfo, but its absolute "lastness"
1033 -- is so critical that it is hardwired in (no flag).
1036 getStgToDo :: DynFlags -> [StgToDo]
1040 stg_stats = dopt Opt_StgStats dflags
1042 todo1 = if stg_stats then [D_stg_stats] else []
1044 todo2 | WayProf `elem` wayNames dflags
1045 = StgDoMassageForProfiling : todo1
1049 {- **********************************************************************
1053 %********************************************************************* -}
1055 -- -----------------------------------------------------------------------------
1056 -- Parsing the dynamic flags.
1058 -- | Parse dynamic flags from a list of command line arguments. Returns the
1059 -- the parsed 'DynFlags', the left-over arguments, and a list of warnings.
1060 -- Throws a 'UsageError' if errors occurred during parsing (such as unknown
1061 -- flags or missing arguments).
1062 parseDynamicFlags :: Monad m =>
1063 DynFlags -> [Located String]
1064 -> m (DynFlags, [Located String], [Located String])
1065 -- ^ Updated 'DynFlags', left-over arguments, and
1066 -- list of warnings.
1067 parseDynamicFlags dflags args = parseDynamicFlags_ dflags args True
1069 -- | Like 'parseDynamicFlags' but does not allow the package flags (-package,
1070 -- -hide-package, -ignore-package, -hide-all-packages, -package-conf).
1071 parseDynamicNoPackageFlags :: Monad m =>
1072 DynFlags -> [Located String]
1073 -> m (DynFlags, [Located String], [Located String])
1074 -- ^ Updated 'DynFlags', left-over arguments, and
1075 -- list of warnings.
1076 parseDynamicNoPackageFlags dflags args = parseDynamicFlags_ dflags args False
1078 parseDynamicFlags_ :: Monad m =>
1079 DynFlags -> [Located String] -> Bool
1080 -> m (DynFlags, [Located String], [Located String])
1081 parseDynamicFlags_ dflags0 args pkg_flags = do
1082 -- XXX Legacy support code
1083 -- We used to accept things like
1084 -- optdep-f -optdepdepend
1085 -- optdep-f -optdep depend
1086 -- optdep -f -optdepdepend
1087 -- optdep -f -optdep depend
1088 -- but the spaces trip up proper argument handling. So get rid of them.
1089 let f (L p "-optdep" : L _ x : xs) = (L p ("-optdep" ++ x)) : f xs
1090 f (x : xs) = x : f xs
1094 -- Note: -ignore-package (package_flags) must precede -i* (dynamic_flags)
1095 flag_spec | pkg_flags = package_flags ++ dynamic_flags
1096 | otherwise = dynamic_flags
1098 let ((leftover, errs, warns), dflags1)
1099 = runCmdLine (processArgs flag_spec args') dflags0
1100 when (not (null errs)) $ ghcError $ errorsToGhcException errs
1102 let (pic_warns, dflags2)
1103 #if !(x86_64_TARGET_ARCH && linux_TARGET_OS)
1104 | (not opt_Static || opt_PIC) && hscTarget dflags1 == HscLlvm
1105 = ([L noSrcSpan $ "Warning: -fllvm is incompatible with -fPIC and -"
1106 ++ "dynamic on this platform;\n ignoring -fllvm"],
1107 dflags1{ hscTarget = HscAsm })
1109 | otherwise = ([], dflags1)
1111 return (dflags2, leftover, pic_warns ++ warns)
1114 {- **********************************************************************
1116 DynFlags specifications
1118 %********************************************************************* -}
1120 allFlags :: [String]
1121 allFlags = map ('-':) $
1122 [ flagName flag | flag <- dynamic_flags, ok (flagOptKind flag) ] ++
1123 map ("fno-"++) flags ++
1124 map ("f"++) flags ++
1125 map ("f"++) flags' ++
1126 map ("X"++) supportedExtensions
1127 where ok (PrefixPred _ _) = False
1129 flags = [ name | (name, _, _) <- fFlags ]
1130 flags' = [ name | (name, _, _) <- fLangFlags ]
1132 --------------- The main flags themselves ------------------
1133 dynamic_flags :: [Flag (CmdLineP DynFlags)]
1135 Flag "n" (NoArg (setDynFlag Opt_DryRun))
1136 , Flag "cpp" (NoArg (setExtensionFlag Opt_Cpp))
1137 , Flag "F" (NoArg (setDynFlag Opt_Pp))
1139 (HasArg (\s -> do { addCmdlineHCInclude s
1140 ; addWarn "-#include and INCLUDE pragmas are deprecated: They no longer have any effect" }))
1141 , Flag "v" (OptIntSuffix setVerbosity)
1143 ------- Specific phases --------------------------------------------
1144 -- need to appear before -pgmL to be parsed as LLVM flags.
1145 , Flag "pgmlo" (hasArg (\f -> alterSettings (\s -> s { sPgm_lo = (f,[])})))
1146 , Flag "pgmlc" (hasArg (\f -> alterSettings (\s -> s { sPgm_lc = (f,[])})))
1147 , Flag "pgmL" (hasArg (\f -> alterSettings (\s -> s { sPgm_L = f})))
1148 , Flag "pgmP" (hasArg setPgmP)
1149 , Flag "pgmF" (hasArg (\f -> alterSettings (\s -> s { sPgm_F = f})))
1150 , Flag "pgmc" (hasArg (\f -> alterSettings (\s -> s { sPgm_c = (f,[])})))
1151 , Flag "pgmm" (HasArg (\_ -> addWarn "The -keep-raw-s-files flag does nothing; it will be removed in a future GHC release"))
1152 , Flag "pgms" (hasArg (\f -> alterSettings (\s -> s { sPgm_s = (f,[])})))
1153 , Flag "pgma" (hasArg (\f -> alterSettings (\s -> s { sPgm_a = (f,[])})))
1154 , Flag "pgml" (hasArg (\f -> alterSettings (\s -> s { sPgm_l = (f,[])})))
1155 , Flag "pgmdll" (hasArg (\f -> alterSettings (\s -> s { sPgm_dll = (f,[])})))
1156 , Flag "pgmwindres" (hasArg (\f -> alterSettings (\s -> s { sPgm_windres = f})))
1158 -- need to appear before -optl/-opta to be parsed as LLVM flags.
1159 , Flag "optlo" (hasArg (\f -> alterSettings (\s -> s { sOpt_lo = f : sOpt_lo s})))
1160 , Flag "optlc" (hasArg (\f -> alterSettings (\s -> s { sOpt_lc = f : sOpt_lc s})))
1161 , Flag "optL" (hasArg (\f -> alterSettings (\s -> s { sOpt_L = f : sOpt_L s})))
1162 , Flag "optP" (hasArg addOptP)
1163 , Flag "optF" (hasArg (\f -> alterSettings (\s -> s { sOpt_F = f : sOpt_F s})))
1164 , Flag "optc" (hasArg (\f -> alterSettings (\s -> s { sOpt_c = f : sOpt_c s})))
1165 , Flag "optm" (hasArg (\f -> alterSettings (\s -> s { sOpt_m = f : sOpt_m s})))
1166 , Flag "opta" (hasArg (\f -> alterSettings (\s -> s { sOpt_a = f : sOpt_a s})))
1167 , Flag "optl" (hasArg addOptl)
1168 , Flag "optwindres" (hasArg (\f -> alterSettings (\s -> s { sOpt_windres = f : sOpt_windres s})))
1171 (NoArg (if can_split
1172 then setDynFlag Opt_SplitObjs
1173 else addWarn "ignoring -fsplit-objs"))
1175 -------- ghc -M -----------------------------------------------------
1176 , Flag "dep-suffix" (hasArg addDepSuffix)
1177 , Flag "optdep-s" (hasArgDF addDepSuffix "Use -dep-suffix instead")
1178 , Flag "dep-makefile" (hasArg setDepMakefile)
1179 , Flag "optdep-f" (hasArgDF setDepMakefile "Use -dep-makefile instead")
1180 , Flag "optdep-w" (NoArg (deprecate "doesn't do anything"))
1181 , Flag "include-pkg-deps" (noArg (setDepIncludePkgDeps True))
1182 , Flag "optdep--include-prelude" (noArgDF (setDepIncludePkgDeps True) "Use -include-pkg-deps instead")
1183 , Flag "optdep--include-pkg-deps" (noArgDF (setDepIncludePkgDeps True) "Use -include-pkg-deps instead")
1184 , Flag "exclude-module" (hasArg addDepExcludeMod)
1185 , Flag "optdep--exclude-module" (hasArgDF addDepExcludeMod "Use -exclude-module instead")
1186 , Flag "optdep-x" (hasArgDF addDepExcludeMod "Use -exclude-module instead")
1188 -------- Linking ----------------------------------------------------
1189 , Flag "no-link" (noArg (\d -> d{ ghcLink=NoLink }))
1190 , Flag "shared" (noArg (\d -> d{ ghcLink=LinkDynLib }))
1191 , Flag "dynload" (hasArg parseDynLibLoaderMode)
1192 , Flag "dylib-install-name" (hasArg setDylibInstallName)
1194 ------- Libraries ---------------------------------------------------
1195 , Flag "L" (Prefix addLibraryPath)
1196 , Flag "l" (AnySuffix (upd . addOptl))
1198 ------- Frameworks --------------------------------------------------
1199 -- -framework-path should really be -F ...
1200 , Flag "framework-path" (HasArg addFrameworkPath)
1201 , Flag "framework" (hasArg addCmdlineFramework)
1203 ------- Output Redirection ------------------------------------------
1204 , Flag "odir" (hasArg setObjectDir)
1205 , Flag "o" (SepArg (upd . setOutputFile . Just))
1206 , Flag "ohi" (hasArg (setOutputHi . Just ))
1207 , Flag "osuf" (hasArg setObjectSuf)
1208 , Flag "hcsuf" (hasArg setHcSuf)
1209 , Flag "hisuf" (hasArg setHiSuf)
1210 , Flag "hidir" (hasArg setHiDir)
1211 , Flag "tmpdir" (hasArg setTmpDir)
1212 , Flag "stubdir" (hasArg setStubDir)
1213 , Flag "outputdir" (hasArg setOutputDir)
1214 , Flag "ddump-file-prefix" (hasArg (setDumpPrefixForce . Just))
1216 ------- Keeping temporary files -------------------------------------
1217 -- These can be singular (think ghc -c) or plural (think ghc --make)
1218 , Flag "keep-hc-file" (NoArg (setDynFlag Opt_KeepHcFiles))
1219 , Flag "keep-hc-files" (NoArg (setDynFlag Opt_KeepHcFiles))
1220 , Flag "keep-s-file" (NoArg (setDynFlag Opt_KeepSFiles))
1221 , Flag "keep-s-files" (NoArg (setDynFlag Opt_KeepSFiles))
1222 , Flag "keep-raw-s-file" (NoArg (addWarn "The -keep-raw-s-file flag does nothing; it will be removed in a future GHC release"))
1223 , Flag "keep-raw-s-files" (NoArg (addWarn "The -keep-raw-s-files flag does nothing; it will be removed in a future GHC release"))
1224 , Flag "keep-llvm-file" (NoArg (setDynFlag Opt_KeepLlvmFiles))
1225 , Flag "keep-llvm-files" (NoArg (setDynFlag Opt_KeepLlvmFiles))
1226 -- This only makes sense as plural
1227 , Flag "keep-tmp-files" (NoArg (setDynFlag Opt_KeepTmpFiles))
1229 ------- Miscellaneous ----------------------------------------------
1230 , Flag "no-auto-link-packages" (NoArg (unSetDynFlag Opt_AutoLinkPackages))
1231 , Flag "no-hs-main" (NoArg (setDynFlag Opt_NoHsMain))
1232 , Flag "with-rtsopts" (HasArg setRtsOpts)
1233 , Flag "rtsopts" (NoArg (setRtsOptsEnabled RtsOptsAll))
1234 , Flag "rtsopts=all" (NoArg (setRtsOptsEnabled RtsOptsAll))
1235 , Flag "rtsopts=some" (NoArg (setRtsOptsEnabled RtsOptsSafeOnly))
1236 , Flag "rtsopts=none" (NoArg (setRtsOptsEnabled RtsOptsNone))
1237 , Flag "no-rtsopts" (NoArg (setRtsOptsEnabled RtsOptsNone))
1238 , Flag "main-is" (SepArg setMainIs)
1239 , Flag "haddock" (NoArg (setDynFlag Opt_Haddock))
1240 , Flag "haddock-opts" (hasArg addHaddockOpts)
1241 , Flag "hpcdir" (SepArg setOptHpcDir)
1243 ------- recompilation checker --------------------------------------
1244 , Flag "recomp" (NoArg (do { unSetDynFlag Opt_ForceRecomp
1245 ; deprecate "Use -fno-force-recomp instead" }))
1246 , Flag "no-recomp" (NoArg (do { setDynFlag Opt_ForceRecomp
1247 ; deprecate "Use -fforce-recomp instead" }))
1249 ------ HsCpp opts ---------------------------------------------------
1250 , Flag "D" (AnySuffix (upd . addOptP))
1251 , Flag "U" (AnySuffix (upd . addOptP))
1253 ------- Include/Import Paths ----------------------------------------
1254 , Flag "I" (Prefix addIncludePath)
1255 , Flag "i" (OptPrefix addImportPath)
1257 ------ Debugging ----------------------------------------------------
1258 , Flag "dstg-stats" (NoArg (setDynFlag Opt_StgStats))
1260 , Flag "ddump-cmm" (setDumpFlag Opt_D_dump_cmm)
1261 , Flag "ddump-raw-cmm" (setDumpFlag Opt_D_dump_raw_cmm)
1262 , Flag "ddump-cmmz" (setDumpFlag Opt_D_dump_cmmz)
1263 , Flag "ddump-cmmz-pretty" (setDumpFlag Opt_D_dump_cmmz_pretty)
1264 , Flag "ddump-core-stats" (setDumpFlag Opt_D_dump_core_stats)
1265 , Flag "ddump-cps-cmm" (setDumpFlag Opt_D_dump_cps_cmm)
1266 , Flag "ddump-cvt-cmm" (setDumpFlag Opt_D_dump_cvt_cmm)
1267 , Flag "ddump-asm" (setDumpFlag Opt_D_dump_asm)
1268 , Flag "ddump-asm-native" (setDumpFlag Opt_D_dump_asm_native)
1269 , Flag "ddump-asm-liveness" (setDumpFlag Opt_D_dump_asm_liveness)
1270 , Flag "ddump-asm-coalesce" (setDumpFlag Opt_D_dump_asm_coalesce)
1271 , Flag "ddump-asm-regalloc" (setDumpFlag Opt_D_dump_asm_regalloc)
1272 , Flag "ddump-asm-conflicts" (setDumpFlag Opt_D_dump_asm_conflicts)
1273 , Flag "ddump-asm-regalloc-stages" (setDumpFlag Opt_D_dump_asm_regalloc_stages)
1274 , Flag "ddump-asm-stats" (setDumpFlag Opt_D_dump_asm_stats)
1275 , Flag "ddump-asm-expanded" (setDumpFlag Opt_D_dump_asm_expanded)
1276 , Flag "ddump-llvm" (NoArg (do { setObjTarget HscLlvm
1277 ; setDumpFlag' Opt_D_dump_llvm}))
1278 , Flag "ddump-cpranal" (setDumpFlag Opt_D_dump_cpranal)
1279 , Flag "ddump-deriv" (setDumpFlag Opt_D_dump_deriv)
1280 , Flag "ddump-ds" (setDumpFlag Opt_D_dump_ds)
1281 , Flag "ddump-flatC" (setDumpFlag Opt_D_dump_flatC)
1282 , Flag "ddump-foreign" (setDumpFlag Opt_D_dump_foreign)
1283 , Flag "ddump-inlinings" (setDumpFlag Opt_D_dump_inlinings)
1284 , Flag "ddump-rule-firings" (setDumpFlag Opt_D_dump_rule_firings)
1285 , Flag "ddump-rule-rewrites" (setDumpFlag Opt_D_dump_rule_rewrites)
1286 , Flag "ddump-occur-anal" (setDumpFlag Opt_D_dump_occur_anal)
1287 , Flag "ddump-parsed" (setDumpFlag Opt_D_dump_parsed)
1288 , Flag "ddump-rn" (setDumpFlag Opt_D_dump_rn)
1289 , Flag "ddump-simpl" (setDumpFlag Opt_D_dump_simpl)
1290 , Flag "ddump-simpl-iterations" (setDumpFlag Opt_D_dump_simpl_iterations)
1291 , Flag "ddump-simpl-phases" (OptPrefix setDumpSimplPhases)
1292 , Flag "ddump-spec" (setDumpFlag Opt_D_dump_spec)
1293 , Flag "ddump-prep" (setDumpFlag Opt_D_dump_prep)
1294 , Flag "ddump-stg" (setDumpFlag Opt_D_dump_stg)
1295 , Flag "ddump-stranal" (setDumpFlag Opt_D_dump_stranal)
1296 , Flag "ddump-tc" (setDumpFlag Opt_D_dump_tc)
1297 , Flag "ddump-types" (setDumpFlag Opt_D_dump_types)
1298 , Flag "ddump-rules" (setDumpFlag Opt_D_dump_rules)
1299 , Flag "ddump-cse" (setDumpFlag Opt_D_dump_cse)
1300 , Flag "ddump-worker-wrapper" (setDumpFlag Opt_D_dump_worker_wrapper)
1301 , Flag "ddump-rn-trace" (setDumpFlag Opt_D_dump_rn_trace)
1302 , Flag "ddump-if-trace" (setDumpFlag Opt_D_dump_if_trace)
1303 , Flag "ddump-cs-trace" (setDumpFlag Opt_D_dump_cs_trace)
1304 , Flag "ddump-tc-trace" (setDumpFlag Opt_D_dump_tc_trace)
1305 , Flag "ddump-vt-trace" (setDumpFlag Opt_D_dump_vt_trace)
1306 , Flag "ddump-splices" (setDumpFlag Opt_D_dump_splices)
1307 , Flag "ddump-rn-stats" (setDumpFlag Opt_D_dump_rn_stats)
1308 , Flag "ddump-opt-cmm" (setDumpFlag Opt_D_dump_opt_cmm)
1309 , Flag "ddump-simpl-stats" (setDumpFlag Opt_D_dump_simpl_stats)
1310 , Flag "ddump-bcos" (setDumpFlag Opt_D_dump_BCOs)
1311 , Flag "dsource-stats" (setDumpFlag Opt_D_source_stats)
1312 , Flag "dverbose-core2core" (NoArg (do { setVerbosity (Just 2)
1313 ; setVerboseCore2Core }))
1314 , Flag "dverbose-stg2stg" (setDumpFlag Opt_D_verbose_stg2stg)
1315 , Flag "ddump-hi" (setDumpFlag Opt_D_dump_hi)
1316 , Flag "ddump-minimal-imports" (setDumpFlag Opt_D_dump_minimal_imports)
1317 , Flag "ddump-vect" (setDumpFlag Opt_D_dump_vect)
1318 , Flag "ddump-hpc" (setDumpFlag Opt_D_dump_hpc)
1319 , Flag "ddump-mod-cycles" (setDumpFlag Opt_D_dump_mod_cycles)
1320 , Flag "ddump-view-pattern-commoning" (setDumpFlag Opt_D_dump_view_pattern_commoning)
1321 , Flag "ddump-to-file" (setDumpFlag Opt_DumpToFile)
1322 , Flag "ddump-hi-diffs" (setDumpFlag Opt_D_dump_hi_diffs)
1323 , Flag "ddump-rtti" (setDumpFlag Opt_D_dump_rtti)
1324 , Flag "dcore-lint" (NoArg (setDynFlag Opt_DoCoreLinting))
1325 , Flag "dstg-lint" (NoArg (setDynFlag Opt_DoStgLinting))
1326 , Flag "dcmm-lint" (NoArg (setDynFlag Opt_DoCmmLinting))
1327 , Flag "dasm-lint" (NoArg (setDynFlag Opt_DoAsmLinting))
1328 , Flag "dshow-passes" (NoArg (do forceRecompile
1329 setVerbosity (Just 2)))
1330 , Flag "dfaststring-stats" (NoArg (setDynFlag Opt_D_faststring_stats))
1332 ------ Machine dependant (-m<blah>) stuff ---------------------------
1334 , Flag "monly-2-regs" (NoArg (addWarn "The -monly-2-regs flag does nothing; it will be removed in a future GHC release"))
1335 , Flag "monly-3-regs" (NoArg (addWarn "The -monly-3-regs flag does nothing; it will be removed in a future GHC release"))
1336 , Flag "monly-4-regs" (NoArg (addWarn "The -monly-4-regs flag does nothing; it will be removed in a future GHC release"))
1337 , Flag "msse2" (NoArg (setDynFlag Opt_SSE2))
1339 ------ Warning opts -------------------------------------------------
1340 , Flag "W" (NoArg (mapM_ setDynFlag minusWOpts))
1341 , Flag "Werror" (NoArg (setDynFlag Opt_WarnIsError))
1342 , Flag "Wwarn" (NoArg (unSetDynFlag Opt_WarnIsError))
1343 , Flag "Wall" (NoArg (mapM_ setDynFlag minusWallOpts))
1344 , Flag "Wnot" (NoArg (do { mapM_ unSetDynFlag minusWallOpts
1345 ; deprecate "Use -w instead" }))
1346 , Flag "w" (NoArg (mapM_ unSetDynFlag minuswRemovesOpts))
1348 ------ Optimisation flags ------------------------------------------
1349 , Flag "O" (noArgM (setOptLevel 1))
1350 , Flag "Onot" (noArgM (\dflags -> do deprecate "Use -O0 instead"
1351 setOptLevel 0 dflags))
1352 , Flag "Odph" (noArgM setDPHOpt)
1353 , Flag "O" (optIntSuffixM (\mb_n -> setOptLevel (mb_n `orElse` 1)))
1354 -- If the number is missing, use 1
1356 , Flag "fsimplifier-phases" (intSuffix (\n d -> d{ simplPhases = n }))
1357 , Flag "fmax-simplifier-iterations" (intSuffix (\n d -> d{ maxSimplIterations = n }))
1358 , Flag "fspec-constr-threshold" (intSuffix (\n d -> d{ specConstrThreshold = Just n }))
1359 , Flag "fno-spec-constr-threshold" (noArg (\d -> d{ specConstrThreshold = Nothing }))
1360 , Flag "fspec-constr-count" (intSuffix (\n d -> d{ specConstrCount = Just n }))
1361 , Flag "fno-spec-constr-count" (noArg (\d -> d{ specConstrCount = Nothing }))
1362 , Flag "fliberate-case-threshold" (intSuffix (\n d -> d{ liberateCaseThreshold = Just n }))
1363 , Flag "fno-liberate-case-threshold" (noArg (\d -> d{ liberateCaseThreshold = Nothing }))
1364 , Flag "frule-check" (SepArg (\s -> upd (\d -> d{ ruleCheck = Just s })))
1365 , Flag "fcontext-stack" (intSuffix (\n d -> d{ ctxtStkDepth = n }))
1366 , Flag "fstrictness-before" (intSuffix (\n d -> d{ strictnessBefore = n : strictnessBefore d }))
1367 , Flag "ffloat-lam-args" (intSuffix (\n d -> d{ floatLamArgs = Just n }))
1368 , Flag "ffloat-all-lams" (noArg (\d -> d{ floatLamArgs = Nothing }))
1370 ------ Profiling ----------------------------------------------------
1372 -- XXX Should the -f* flags be deprecated?
1373 -- They don't seem to be documented
1374 , Flag "fauto-sccs-on-all-toplevs" (NoArg (setDynFlag Opt_AutoSccsOnAllToplevs))
1375 , Flag "auto-all" (NoArg (setDynFlag Opt_AutoSccsOnAllToplevs))
1376 , Flag "no-auto-all" (NoArg (unSetDynFlag Opt_AutoSccsOnAllToplevs))
1377 , Flag "fauto-sccs-on-exported-toplevs" (NoArg (setDynFlag Opt_AutoSccsOnExportedToplevs))
1378 , Flag "auto" (NoArg (setDynFlag Opt_AutoSccsOnExportedToplevs))
1379 , Flag "no-auto" (NoArg (unSetDynFlag Opt_AutoSccsOnExportedToplevs))
1380 , Flag "fauto-sccs-on-individual-cafs" (NoArg (setDynFlag Opt_AutoSccsOnIndividualCafs))
1381 , Flag "caf-all" (NoArg (setDynFlag Opt_AutoSccsOnIndividualCafs))
1382 , Flag "no-caf-all" (NoArg (unSetDynFlag Opt_AutoSccsOnIndividualCafs))
1384 ------ DPH flags ----------------------------------------------------
1386 , Flag "fdph-seq" (NoArg (setDPHBackend DPHSeq))
1387 , Flag "fdph-par" (NoArg (setDPHBackend DPHPar))
1388 , Flag "fdph-this" (NoArg (setDPHBackend DPHThis))
1389 , Flag "fdph-none" (NoArg (setDPHBackend DPHNone))
1391 ------ Compiler flags -----------------------------------------------
1393 , Flag "fasm" (NoArg (setObjTarget HscAsm))
1394 , Flag "fvia-c" (NoArg
1395 (addWarn "The -fvia-c flag does nothing; it will be removed in a future GHC release"))
1396 , Flag "fvia-C" (NoArg
1397 (addWarn "The -fvia-C flag does nothing; it will be removed in a future GHC release"))
1398 , Flag "fllvm" (NoArg (setObjTarget HscLlvm))
1400 , Flag "fno-code" (NoArg (do upd $ \d -> d{ ghcLink=NoLink }
1401 setTarget HscNothing))
1402 , Flag "fbyte-code" (NoArg (setTarget HscInterpreted))
1403 , Flag "fobject-code" (NoArg (setTarget defaultHscTarget))
1404 , Flag "fglasgow-exts" (NoArg (enableGlasgowExts >> deprecate "Use individual extensions instead"))
1405 , Flag "fno-glasgow-exts" (NoArg (disableGlasgowExts >> deprecate "Use individual extensions instead"))
1407 ++ map (mkFlag turnOn "f" setDynFlag ) fFlags
1408 ++ map (mkFlag turnOff "fno-" unSetDynFlag) fFlags
1409 ++ map (mkFlag turnOn "f" setExtensionFlag ) fLangFlags
1410 ++ map (mkFlag turnOff "fno-" unSetExtensionFlag) fLangFlags
1411 ++ map (mkFlag turnOn "X" setExtensionFlag ) xFlags
1412 ++ map (mkFlag turnOff "XNo" unSetExtensionFlag) xFlags
1413 ++ map (mkFlag turnOn "X" setLanguage) languageFlags
1415 package_flags :: [Flag (CmdLineP DynFlags)]
1417 ------- Packages ----------------------------------------------------
1418 Flag "package-conf" (HasArg extraPkgConf_)
1419 , Flag "no-user-package-conf" (NoArg (unSetDynFlag Opt_ReadUserPackageConf))
1420 , Flag "package-name" (hasArg setPackageName)
1421 , Flag "package-id" (HasArg exposePackageId)
1422 , Flag "package" (HasArg exposePackage)
1423 , Flag "hide-package" (HasArg hidePackage)
1424 , Flag "hide-all-packages" (NoArg (setDynFlag Opt_HideAllPackages))
1425 , Flag "ignore-package" (HasArg ignorePackage)
1426 , Flag "syslib" (HasArg (\s -> do { exposePackage s
1427 ; deprecate "Use -package instead" }))
1430 type TurnOnFlag = Bool -- True <=> we are turning the flag on
1431 -- False <=> we are turning the flag off
1432 turnOn :: TurnOnFlag; turnOn = True
1433 turnOff :: TurnOnFlag; turnOff = False
1436 = ( String -- Flag in string form
1437 , flag -- Flag in internal form
1438 , TurnOnFlag -> DynP ()) -- Extra action to run when the flag is found
1439 -- Typically, emit a warning or error
1441 mkFlag :: TurnOnFlag -- ^ True <=> it should be turned on
1442 -> String -- ^ The flag prefix
1443 -> (flag -> DynP ()) -- ^ What to do when the flag is found
1444 -> FlagSpec flag -- ^ Specification of this particular flag
1445 -> Flag (CmdLineP DynFlags)
1446 mkFlag turn_on flagPrefix f (name, flag, extra_action)
1447 = Flag (flagPrefix ++ name) (NoArg (f flag >> extra_action turn_on))
1449 deprecatedForExtension :: String -> TurnOnFlag -> DynP ()
1450 deprecatedForExtension lang turn_on
1451 = deprecate ("use -X" ++ flag ++ " or pragma {-# LANGUAGE " ++ flag ++ " #-} instead")
1453 flag | turn_on = lang
1454 | otherwise = "No"++lang
1456 useInstead :: String -> TurnOnFlag -> DynP ()
1457 useInstead flag turn_on
1458 = deprecate ("Use -f" ++ no ++ flag ++ " instead")
1460 no = if turn_on then "" else "no-"
1462 nop :: TurnOnFlag -> DynP ()
1465 -- | These @-f\<blah\>@ flags can all be reversed with @-fno-\<blah\>@
1466 fFlags :: [FlagSpec DynFlag]
1468 ( "warn-dodgy-foreign-imports", Opt_WarnDodgyForeignImports, nop ),
1469 ( "warn-dodgy-exports", Opt_WarnDodgyExports, nop ),
1470 ( "warn-dodgy-imports", Opt_WarnDodgyImports, nop ),
1471 ( "warn-duplicate-exports", Opt_WarnDuplicateExports, nop ),
1472 ( "warn-hi-shadowing", Opt_WarnHiShadows, nop ),
1473 ( "warn-implicit-prelude", Opt_WarnImplicitPrelude, nop ),
1474 ( "warn-incomplete-patterns", Opt_WarnIncompletePatterns, nop ),
1475 ( "warn-incomplete-uni-patterns", Opt_WarnIncompleteUniPatterns, nop ),
1476 ( "warn-incomplete-record-updates", Opt_WarnIncompletePatternsRecUpd, nop ),
1477 ( "warn-missing-fields", Opt_WarnMissingFields, nop ),
1478 ( "warn-missing-import-lists", Opt_WarnMissingImportList, nop ),
1479 ( "warn-missing-methods", Opt_WarnMissingMethods, nop ),
1480 ( "warn-missing-signatures", Opt_WarnMissingSigs, nop ),
1481 ( "warn-missing-local-sigs", Opt_WarnMissingLocalSigs, nop ),
1482 ( "warn-name-shadowing", Opt_WarnNameShadowing, nop ),
1483 ( "warn-overlapping-patterns", Opt_WarnOverlappingPatterns, nop ),
1484 ( "warn-type-defaults", Opt_WarnTypeDefaults, nop ),
1485 ( "warn-monomorphism-restriction", Opt_WarnMonomorphism, nop ),
1486 ( "warn-unused-binds", Opt_WarnUnusedBinds, nop ),
1487 ( "warn-unused-imports", Opt_WarnUnusedImports, nop ),
1488 ( "warn-unused-matches", Opt_WarnUnusedMatches, nop ),
1489 ( "warn-warnings-deprecations", Opt_WarnWarningsDeprecations, nop ),
1490 ( "warn-deprecations", Opt_WarnWarningsDeprecations, nop ),
1491 ( "warn-deprecated-flags", Opt_WarnDeprecatedFlags, nop ),
1492 ( "warn-orphans", Opt_WarnOrphans, nop ),
1493 ( "warn-identities", Opt_WarnIdentities, nop ),
1494 ( "warn-auto-orphans", Opt_WarnAutoOrphans, nop ),
1495 ( "warn-tabs", Opt_WarnTabs, nop ),
1496 ( "warn-unrecognised-pragmas", Opt_WarnUnrecognisedPragmas, nop ),
1497 ( "warn-lazy-unlifted-bindings", Opt_WarnLazyUnliftedBindings, nop),
1498 ( "warn-unused-do-bind", Opt_WarnUnusedDoBind, nop ),
1499 ( "warn-wrong-do-bind", Opt_WarnWrongDoBind, nop ),
1500 ( "warn-alternative-layout-rule-transitional", Opt_WarnAlternativeLayoutRuleTransitional, nop ),
1501 ( "print-explicit-foralls", Opt_PrintExplicitForalls, nop ),
1502 ( "strictness", Opt_Strictness, nop ),
1503 ( "specialise", Opt_Specialise, nop ),
1504 ( "float-in", Opt_FloatIn, nop ),
1505 ( "static-argument-transformation", Opt_StaticArgumentTransformation, nop ),
1506 ( "full-laziness", Opt_FullLaziness, nop ),
1507 ( "liberate-case", Opt_LiberateCase, nop ),
1508 ( "spec-constr", Opt_SpecConstr, nop ),
1509 ( "cse", Opt_CSE, nop ),
1510 ( "ignore-interface-pragmas", Opt_IgnoreInterfacePragmas, nop ),
1511 ( "omit-interface-pragmas", Opt_OmitInterfacePragmas, nop ),
1512 ( "expose-all-unfoldings", Opt_ExposeAllUnfoldings, nop ),
1513 ( "do-lambda-eta-expansion", Opt_DoLambdaEtaExpansion, nop ),
1514 ( "ignore-asserts", Opt_IgnoreAsserts, nop ),
1515 ( "do-eta-reduction", Opt_DoEtaReduction, nop ),
1516 ( "case-merge", Opt_CaseMerge, nop ),
1517 ( "unbox-strict-fields", Opt_UnboxStrictFields, nop ),
1518 ( "method-sharing", Opt_MethodSharing,
1519 \_ -> deprecate "doesn't do anything any more"),
1520 -- Remove altogether in GHC 7.2
1521 ( "dicts-cheap", Opt_DictsCheap, nop ),
1522 ( "excess-precision", Opt_ExcessPrecision, nop ),
1523 ( "eager-blackholing", Opt_EagerBlackHoling, nop ),
1524 ( "print-bind-result", Opt_PrintBindResult, nop ),
1525 ( "force-recomp", Opt_ForceRecomp, nop ),
1526 ( "hpc-no-auto", Opt_Hpc_No_Auto, nop ),
1527 ( "rewrite-rules", Opt_EnableRewriteRules, useInstead "enable-rewrite-rules" ),
1528 ( "enable-rewrite-rules", Opt_EnableRewriteRules, nop ),
1529 ( "break-on-exception", Opt_BreakOnException, nop ),
1530 ( "break-on-error", Opt_BreakOnError, nop ),
1531 ( "print-evld-with-show", Opt_PrintEvldWithShow, nop ),
1532 ( "print-bind-contents", Opt_PrintBindContents, nop ),
1533 ( "run-cps", Opt_RunCPS, nop ),
1534 ( "run-cpsz", Opt_RunCPSZ, nop ),
1535 ( "new-codegen", Opt_TryNewCodeGen, nop ),
1536 ( "convert-to-zipper-and-back", Opt_ConvertToZipCfgAndBack, nop ),
1537 ( "vectorise", Opt_Vectorise, nop ),
1538 ( "regs-graph", Opt_RegsGraph, nop ),
1539 ( "regs-iterative", Opt_RegsIterative, nop ),
1540 ( "gen-manifest", Opt_GenManifest, nop ),
1541 ( "embed-manifest", Opt_EmbedManifest, nop ),
1542 ( "ext-core", Opt_EmitExternalCore, nop ),
1543 ( "shared-implib", Opt_SharedImplib, nop ),
1544 ( "ghci-sandbox", Opt_GhciSandbox, nop ),
1545 ( "helpful-errors", Opt_HelpfulErrors, nop ),
1546 ( "building-cabal-package", Opt_BuildingCabalPackage, nop ),
1547 ( "implicit-import-qualified", Opt_ImplicitImportQualified, nop )
1550 -- | These @-f\<blah\>@ flags can all be reversed with @-fno-\<blah\>@
1551 fLangFlags :: [FlagSpec ExtensionFlag]
1553 ( "th", Opt_TemplateHaskell,
1554 deprecatedForExtension "TemplateHaskell" >> checkTemplateHaskellOk ),
1555 ( "fi", Opt_ForeignFunctionInterface,
1556 deprecatedForExtension "ForeignFunctionInterface" ),
1557 ( "ffi", Opt_ForeignFunctionInterface,
1558 deprecatedForExtension "ForeignFunctionInterface" ),
1559 ( "arrows", Opt_Arrows,
1560 deprecatedForExtension "Arrows" ),
1561 ( "generics", Opt_Generics,
1562 deprecatedForExtension "Generics" ),
1563 ( "implicit-prelude", Opt_ImplicitPrelude,
1564 deprecatedForExtension "ImplicitPrelude" ),
1565 ( "bang-patterns", Opt_BangPatterns,
1566 deprecatedForExtension "BangPatterns" ),
1567 ( "monomorphism-restriction", Opt_MonomorphismRestriction,
1568 deprecatedForExtension "MonomorphismRestriction" ),
1569 ( "mono-pat-binds", Opt_MonoPatBinds,
1570 deprecatedForExtension "MonoPatBinds" ),
1571 ( "extended-default-rules", Opt_ExtendedDefaultRules,
1572 deprecatedForExtension "ExtendedDefaultRules" ),
1573 ( "implicit-params", Opt_ImplicitParams,
1574 deprecatedForExtension "ImplicitParams" ),
1575 ( "scoped-type-variables", Opt_ScopedTypeVariables,
1576 deprecatedForExtension "ScopedTypeVariables" ),
1577 ( "parr", Opt_ParallelArrays,
1578 deprecatedForExtension "ParallelArrays" ),
1579 ( "PArr", Opt_ParallelArrays,
1580 deprecatedForExtension "ParallelArrays" ),
1581 ( "allow-overlapping-instances", Opt_OverlappingInstances,
1582 deprecatedForExtension "OverlappingInstances" ),
1583 ( "allow-undecidable-instances", Opt_UndecidableInstances,
1584 deprecatedForExtension "UndecidableInstances" ),
1585 ( "allow-incoherent-instances", Opt_IncoherentInstances,
1586 deprecatedForExtension "IncoherentInstances" )
1589 supportedLanguages :: [String]
1590 supportedLanguages = [ name | (name, _, _) <- languageFlags ]
1592 supportedExtensions :: [String]
1593 supportedExtensions = [ name' | (name, _, _) <- xFlags, name' <- [name, "No" ++ name] ]
1595 supportedLanguagesAndExtensions :: [String]
1596 supportedLanguagesAndExtensions = supportedLanguages ++ supportedExtensions
1598 -- | These -X<blah> flags cannot be reversed with -XNo<blah>
1599 languageFlags :: [FlagSpec Language]
1601 ( "Haskell98", Haskell98, nop ),
1602 ( "Haskell2010", Haskell2010, nop )
1605 -- | These -X<blah> flags can all be reversed with -XNo<blah>
1606 xFlags :: [FlagSpec ExtensionFlag]
1608 ( "CPP", Opt_Cpp, nop ),
1609 ( "PostfixOperators", Opt_PostfixOperators, nop ),
1610 ( "TupleSections", Opt_TupleSections, nop ),
1611 ( "PatternGuards", Opt_PatternGuards, nop ),
1612 ( "UnicodeSyntax", Opt_UnicodeSyntax, nop ),
1613 ( "MagicHash", Opt_MagicHash, nop ),
1614 ( "PolymorphicComponents", Opt_PolymorphicComponents, nop ),
1615 ( "ExistentialQuantification", Opt_ExistentialQuantification, nop ),
1616 ( "KindSignatures", Opt_KindSignatures, nop ),
1617 ( "EmptyDataDecls", Opt_EmptyDataDecls, nop ),
1618 ( "ParallelListComp", Opt_ParallelListComp, nop ),
1619 ( "TransformListComp", Opt_TransformListComp, nop ),
1620 ( "ForeignFunctionInterface", Opt_ForeignFunctionInterface, nop ),
1621 ( "UnliftedFFITypes", Opt_UnliftedFFITypes, nop ),
1622 ( "GHCForeignImportPrim", Opt_GHCForeignImportPrim, nop ),
1623 ( "LiberalTypeSynonyms", Opt_LiberalTypeSynonyms, nop ),
1624 ( "Rank2Types", Opt_Rank2Types, nop ),
1625 ( "RankNTypes", Opt_RankNTypes, nop ),
1626 ( "ImpredicativeTypes", Opt_ImpredicativeTypes, nop),
1627 ( "TypeOperators", Opt_TypeOperators, nop ),
1628 ( "RecursiveDo", Opt_RecursiveDo,
1629 deprecatedForExtension "DoRec"),
1630 ( "DoRec", Opt_DoRec, nop ),
1631 ( "Arrows", Opt_Arrows, nop ),
1632 ( "ParallelArrays", Opt_ParallelArrays, nop ),
1633 ( "TemplateHaskell", Opt_TemplateHaskell, checkTemplateHaskellOk ),
1634 ( "QuasiQuotes", Opt_QuasiQuotes, nop ),
1635 ( "Generics", Opt_Generics, nop ),
1636 ( "ImplicitPrelude", Opt_ImplicitPrelude, nop ),
1637 ( "RecordWildCards", Opt_RecordWildCards, nop ),
1638 ( "NamedFieldPuns", Opt_RecordPuns, nop ),
1639 ( "RecordPuns", Opt_RecordPuns,
1640 deprecatedForExtension "NamedFieldPuns" ),
1641 ( "DisambiguateRecordFields", Opt_DisambiguateRecordFields, nop ),
1642 ( "OverloadedStrings", Opt_OverloadedStrings, nop ),
1643 ( "GADTs", Opt_GADTs, nop ),
1644 ( "GADTSyntax", Opt_GADTSyntax, nop ),
1645 ( "ViewPatterns", Opt_ViewPatterns, nop ),
1646 ( "TypeFamilies", Opt_TypeFamilies, nop ),
1647 ( "BangPatterns", Opt_BangPatterns, nop ),
1648 ( "MonomorphismRestriction", Opt_MonomorphismRestriction, nop ),
1649 ( "NPlusKPatterns", Opt_NPlusKPatterns, nop ),
1650 ( "DoAndIfThenElse", Opt_DoAndIfThenElse, nop ),
1651 ( "RebindableSyntax", Opt_RebindableSyntax, nop ),
1652 ( "MonoPatBinds", Opt_MonoPatBinds, nop ),
1653 ( "ExplicitForAll", Opt_ExplicitForAll, nop ),
1654 ( "AlternativeLayoutRule", Opt_AlternativeLayoutRule, nop ),
1655 ( "AlternativeLayoutRuleTransitional",Opt_AlternativeLayoutRuleTransitional, nop ),
1656 ( "DatatypeContexts", Opt_DatatypeContexts, nop ),
1657 ( "NondecreasingIndentation", Opt_NondecreasingIndentation, nop ),
1658 ( "RelaxedLayout", Opt_RelaxedLayout, nop ),
1659 ( "MonoLocalBinds", Opt_MonoLocalBinds, nop ),
1660 ( "RelaxedPolyRec", Opt_RelaxedPolyRec,
1661 \ turn_on -> if not turn_on
1662 then deprecate "You can't turn off RelaxedPolyRec any more"
1664 ( "ExtendedDefaultRules", Opt_ExtendedDefaultRules, nop ),
1665 ( "ImplicitParams", Opt_ImplicitParams, nop ),
1666 ( "ScopedTypeVariables", Opt_ScopedTypeVariables, nop ),
1668 ( "PatternSignatures", Opt_ScopedTypeVariables,
1669 deprecatedForExtension "ScopedTypeVariables" ),
1671 ( "UnboxedTuples", Opt_UnboxedTuples, nop ),
1672 ( "StandaloneDeriving", Opt_StandaloneDeriving, nop ),
1673 ( "DeriveDataTypeable", Opt_DeriveDataTypeable, nop ),
1674 ( "DeriveFunctor", Opt_DeriveFunctor, nop ),
1675 ( "DeriveTraversable", Opt_DeriveTraversable, nop ),
1676 ( "DeriveFoldable", Opt_DeriveFoldable, nop ),
1677 ( "TypeSynonymInstances", Opt_TypeSynonymInstances, nop ),
1678 ( "FlexibleContexts", Opt_FlexibleContexts, nop ),
1679 ( "FlexibleInstances", Opt_FlexibleInstances, nop ),
1680 ( "ConstrainedClassMethods", Opt_ConstrainedClassMethods, nop ),
1681 ( "MultiParamTypeClasses", Opt_MultiParamTypeClasses, nop ),
1682 ( "FunctionalDependencies", Opt_FunctionalDependencies, nop ),
1683 ( "GeneralizedNewtypeDeriving", Opt_GeneralizedNewtypeDeriving, nop ),
1684 ( "OverlappingInstances", Opt_OverlappingInstances, nop ),
1685 ( "UndecidableInstances", Opt_UndecidableInstances, nop ),
1686 ( "IncoherentInstances", Opt_IncoherentInstances, nop ),
1687 ( "PackageImports", Opt_PackageImports, nop )
1690 defaultFlags :: [DynFlag]
1692 = [ Opt_AutoLinkPackages,
1693 Opt_ReadUserPackageConf,
1697 #if GHC_DEFAULT_NEW_CODEGEN
1703 Opt_PrintBindContents,
1708 ++ [f | (ns,f) <- optLevelFlags, 0 `elem` ns]
1709 -- The default -O0 options
1713 impliedFlags :: [(ExtensionFlag, TurnOnFlag, ExtensionFlag)]
1715 = [ (Opt_RankNTypes, turnOn, Opt_ExplicitForAll)
1716 , (Opt_Rank2Types, turnOn, Opt_ExplicitForAll)
1717 , (Opt_ScopedTypeVariables, turnOn, Opt_ExplicitForAll)
1718 , (Opt_LiberalTypeSynonyms, turnOn, Opt_ExplicitForAll)
1719 , (Opt_ExistentialQuantification, turnOn, Opt_ExplicitForAll)
1720 , (Opt_PolymorphicComponents, turnOn, Opt_ExplicitForAll)
1721 , (Opt_FlexibleInstances, turnOn, Opt_TypeSynonymInstances)
1722 , (Opt_FunctionalDependencies, turnOn, Opt_MultiParamTypeClasses)
1724 , (Opt_RebindableSyntax, turnOff, Opt_ImplicitPrelude) -- NB: turn off!
1726 , (Opt_GADTs, turnOn, Opt_GADTSyntax)
1727 , (Opt_GADTs, turnOn, Opt_MonoLocalBinds)
1728 , (Opt_TypeFamilies, turnOn, Opt_MonoLocalBinds)
1730 , (Opt_TypeFamilies, turnOn, Opt_KindSignatures) -- Type families use kind signatures
1731 -- all over the place
1733 , (Opt_ImpredicativeTypes, turnOn, Opt_RankNTypes)
1735 -- Record wild-cards implies field disambiguation
1736 -- Otherwise if you write (C {..}) you may well get
1737 -- stuff like " 'a' not in scope ", which is a bit silly
1738 -- if the compiler has just filled in field 'a' of constructor 'C'
1739 , (Opt_RecordWildCards, turnOn, Opt_DisambiguateRecordFields)
1741 , (Opt_ParallelArrays, turnOn, Opt_ParallelListComp)
1744 optLevelFlags :: [([Int], DynFlag)]
1746 = [ ([0], Opt_IgnoreInterfacePragmas)
1747 , ([0], Opt_OmitInterfacePragmas)
1749 , ([1,2], Opt_IgnoreAsserts)
1750 , ([1,2], Opt_EnableRewriteRules) -- Off for -O0; see Note [Scoping for Builtin rules]
1752 , ([1,2], Opt_DoEtaReduction)
1753 , ([1,2], Opt_CaseMerge)
1754 , ([1,2], Opt_Strictness)
1756 , ([1,2], Opt_FullLaziness)
1757 , ([1,2], Opt_Specialise)
1758 , ([1,2], Opt_FloatIn)
1760 , ([2], Opt_LiberateCase)
1761 , ([2], Opt_SpecConstr)
1762 , ([2], Opt_RegsGraph)
1764 -- , ([2], Opt_StaticArgumentTransformation)
1765 -- Max writes: I think it's probably best not to enable SAT with -O2 for the
1766 -- 6.10 release. The version of SAT in HEAD at the moment doesn't incorporate
1767 -- several improvements to the heuristics, and I'm concerned that without
1768 -- those changes SAT will interfere with some attempts to write "high
1769 -- performance Haskell", as we saw in some posts on Haskell-Cafe earlier
1770 -- this year. In particular, the version in HEAD lacks the tail call
1771 -- criterion, so many things that look like reasonable loops will be
1772 -- turned into functions with extra (unneccesary) thunk creation.
1774 , ([0,1,2], Opt_DoLambdaEtaExpansion)
1775 -- This one is important for a tiresome reason:
1776 -- we want to make sure that the bindings for data
1777 -- constructors are eta-expanded. This is probably
1778 -- a good thing anyway, but it seems fragile.
1781 -- -----------------------------------------------------------------------------
1782 -- Standard sets of warning options
1784 standardWarnings :: [DynFlag]
1786 = [ Opt_WarnWarningsDeprecations,
1787 Opt_WarnDeprecatedFlags,
1788 Opt_WarnUnrecognisedPragmas,
1789 Opt_WarnOverlappingPatterns,
1790 Opt_WarnMissingFields,
1791 Opt_WarnMissingMethods,
1792 Opt_WarnDuplicateExports,
1793 Opt_WarnLazyUnliftedBindings,
1794 Opt_WarnDodgyForeignImports,
1795 Opt_WarnWrongDoBind,
1796 Opt_WarnAlternativeLayoutRuleTransitional
1799 minusWOpts :: [DynFlag]
1800 -- Things you get with -W
1802 = standardWarnings ++
1803 [ Opt_WarnUnusedBinds,
1804 Opt_WarnUnusedMatches,
1805 Opt_WarnUnusedImports,
1806 Opt_WarnIncompletePatterns,
1807 Opt_WarnDodgyExports,
1808 Opt_WarnDodgyImports
1811 minusWallOpts :: [DynFlag]
1812 -- Things you get with -Wall
1815 [ Opt_WarnTypeDefaults,
1816 Opt_WarnNameShadowing,
1817 Opt_WarnMissingSigs,
1820 Opt_WarnUnusedDoBind
1823 minuswRemovesOpts :: [DynFlag]
1824 -- minuswRemovesOpts should be every warning option
1828 Opt_WarnIncompletePatternsRecUpd,
1829 Opt_WarnIncompleteUniPatterns,
1830 Opt_WarnMonomorphism,
1831 Opt_WarnUnrecognisedPragmas,
1832 Opt_WarnAutoOrphans,
1833 Opt_WarnImplicitPrelude
1836 enableGlasgowExts :: DynP ()
1837 enableGlasgowExts = do setDynFlag Opt_PrintExplicitForalls
1838 mapM_ setExtensionFlag glasgowExtsFlags
1840 disableGlasgowExts :: DynP ()
1841 disableGlasgowExts = do unSetDynFlag Opt_PrintExplicitForalls
1842 mapM_ unSetExtensionFlag glasgowExtsFlags
1844 glasgowExtsFlags :: [ExtensionFlag]
1845 glasgowExtsFlags = [
1846 Opt_ForeignFunctionInterface
1847 , Opt_UnliftedFFITypes
1848 , Opt_ImplicitParams
1849 , Opt_ScopedTypeVariables
1851 , Opt_TypeSynonymInstances
1852 , Opt_StandaloneDeriving
1853 , Opt_DeriveDataTypeable
1855 , Opt_DeriveFoldable
1856 , Opt_DeriveTraversable
1857 , Opt_FlexibleContexts
1858 , Opt_FlexibleInstances
1859 , Opt_ConstrainedClassMethods
1860 , Opt_MultiParamTypeClasses
1861 , Opt_FunctionalDependencies
1863 , Opt_PolymorphicComponents
1864 , Opt_ExistentialQuantification
1866 , Opt_PostfixOperators
1868 , Opt_LiberalTypeSynonyms
1872 , Opt_ParallelListComp
1873 , Opt_EmptyDataDecls
1874 , Opt_KindSignatures
1875 , Opt_GeneralizedNewtypeDeriving ]
1878 -- Consult the RTS to find whether GHC itself has been built profiled
1879 -- If so, you can't use Template Haskell
1880 foreign import ccall unsafe "rts_isProfiled" rtsIsProfiledIO :: IO CInt
1882 rtsIsProfiled :: Bool
1883 rtsIsProfiled = unsafePerformIO rtsIsProfiledIO /= 0
1886 checkTemplateHaskellOk :: Bool -> DynP ()
1888 checkTemplateHaskellOk turn_on
1889 | turn_on && rtsIsProfiled
1890 = addErr "You can't use Template Haskell with a profiled compiler"
1894 -- In stage 1 we don't know that the RTS has rts_isProfiled,
1895 -- so we simply say "ok". It doesn't matter because TH isn't
1896 -- available in stage 1 anyway.
1897 checkTemplateHaskellOk _ = return ()
1900 {- **********************************************************************
1902 DynFlags constructors
1904 %********************************************************************* -}
1906 type DynP = EwM (CmdLineP DynFlags)
1908 upd :: (DynFlags -> DynFlags) -> DynP ()
1909 upd f = liftEwM (do dflags <- getCmdLineState
1910 putCmdLineState $! f dflags)
1912 updM :: (DynFlags -> DynP DynFlags) -> DynP ()
1913 updM f = do dflags <- liftEwM getCmdLineState
1915 liftEwM $ putCmdLineState $! dflags'
1917 --------------- Constructor functions for OptKind -----------------
1918 noArg :: (DynFlags -> DynFlags) -> OptKind (CmdLineP DynFlags)
1919 noArg fn = NoArg (upd fn)
1921 noArgM :: (DynFlags -> DynP DynFlags) -> OptKind (CmdLineP DynFlags)
1922 noArgM fn = NoArg (updM fn)
1924 noArgDF :: (DynFlags -> DynFlags) -> String -> OptKind (CmdLineP DynFlags)
1925 noArgDF fn deprec = NoArg (upd fn >> deprecate deprec)
1927 hasArg :: (String -> DynFlags -> DynFlags) -> OptKind (CmdLineP DynFlags)
1928 hasArg fn = HasArg (upd . fn)
1930 hasArgDF :: (String -> DynFlags -> DynFlags) -> String -> OptKind (CmdLineP DynFlags)
1931 hasArgDF fn deprec = HasArg (\s -> do { upd (fn s)
1932 ; deprecate deprec })
1934 intSuffix :: (Int -> DynFlags -> DynFlags) -> OptKind (CmdLineP DynFlags)
1935 intSuffix fn = IntSuffix (\n -> upd (fn n))
1937 optIntSuffixM :: (Maybe Int -> DynFlags -> DynP DynFlags)
1938 -> OptKind (CmdLineP DynFlags)
1939 optIntSuffixM fn = OptIntSuffix (\mi -> updM (fn mi))
1941 setDumpFlag :: DynFlag -> OptKind (CmdLineP DynFlags)
1942 setDumpFlag dump_flag = NoArg (setDumpFlag' dump_flag)
1944 --------------------------
1945 setDynFlag, unSetDynFlag :: DynFlag -> DynP ()
1946 setDynFlag f = upd (\dfs -> dopt_set dfs f)
1947 unSetDynFlag f = upd (\dfs -> dopt_unset dfs f)
1949 --------------------------
1950 setExtensionFlag, unSetExtensionFlag :: ExtensionFlag -> DynP ()
1951 setExtensionFlag f = do { upd (\dfs -> xopt_set dfs f)
1954 deps = [ if turn_on then setExtensionFlag d
1955 else unSetExtensionFlag d
1956 | (f', turn_on, d) <- impliedFlags, f' == f ]
1957 -- When you set f, set the ones it implies
1958 -- NB: use setExtensionFlag recursively, in case the implied flags
1959 -- implies further flags
1961 unSetExtensionFlag f = upd (\dfs -> xopt_unset dfs f)
1962 -- When you un-set f, however, we don't un-set the things it implies
1963 -- (except for -fno-glasgow-exts, which is treated specially)
1965 --------------------------
1966 alterSettings :: (Settings -> Settings) -> DynFlags -> DynFlags
1967 alterSettings f dflags = dflags { settings = f (settings dflags) }
1969 --------------------------
1970 setDumpFlag' :: DynFlag -> DynP ()
1971 setDumpFlag' dump_flag
1972 = do { setDynFlag dump_flag
1973 ; when want_recomp forceRecompile }
1975 -- Certain dumpy-things are really interested in what's going
1976 -- on during recompilation checking, so in those cases we
1977 -- don't want to turn it off.
1978 want_recomp = dump_flag `notElem` [Opt_D_dump_if_trace,
1979 Opt_D_dump_hi_diffs]
1981 forceRecompile :: DynP ()
1982 -- Whenver we -ddump, force recompilation (by switching off the
1983 -- recompilation checker), else you don't see the dump! However,
1984 -- don't switch it off in --make mode, else *everything* gets
1985 -- recompiled which probably isn't what you want
1986 forceRecompile = do { dfs <- liftEwM getCmdLineState
1987 ; when (force_recomp dfs) (setDynFlag Opt_ForceRecomp) }
1989 force_recomp dfs = isOneShot (ghcMode dfs)
1991 setVerboseCore2Core :: DynP ()
1992 setVerboseCore2Core = do forceRecompile
1993 setDynFlag Opt_D_verbose_core2core
1994 upd (\dfs -> dfs { shouldDumpSimplPhase = Nothing })
1997 setDumpSimplPhases :: String -> DynP ()
1998 setDumpSimplPhases s = do forceRecompile
1999 upd (\dfs -> dfs { shouldDumpSimplPhase = Just spec })
2001 spec = case s of { ('=' : s') -> s'; _ -> s }
2003 setVerbosity :: Maybe Int -> DynP ()
2004 setVerbosity mb_n = upd (\dfs -> dfs{ verbosity = mb_n `orElse` 3 })
2006 addCmdlineHCInclude :: String -> DynP ()
2007 addCmdlineHCInclude a = upd (\s -> s{cmdlineHcIncludes = a : cmdlineHcIncludes s})
2009 extraPkgConf_ :: FilePath -> DynP ()
2010 extraPkgConf_ p = upd (\s -> s{ extraPkgConfs = p : extraPkgConfs s })
2012 exposePackage, exposePackageId, hidePackage, ignorePackage :: String -> DynP ()
2014 upd (\s -> s{ packageFlags = ExposePackage p : packageFlags s })
2016 upd (\s -> s{ packageFlags = ExposePackageId p : packageFlags s })
2018 upd (\s -> s{ packageFlags = HidePackage p : packageFlags s })
2020 upd (\s -> s{ packageFlags = IgnorePackage p : packageFlags s })
2022 setPackageName :: String -> DynFlags -> DynFlags
2023 setPackageName p s = s{ thisPackage = stringToPackageId p }
2025 -- If we're linking a binary, then only targets that produce object
2026 -- code are allowed (requests for other target types are ignored).
2027 setTarget :: HscTarget -> DynP ()
2028 setTarget l = upd set
2031 | ghcLink dfs /= LinkBinary || isObjectTarget l = dfs{ hscTarget = l }
2034 -- Changes the target only if we're compiling object code. This is
2035 -- used by -fasm and -fllvm, which switch from one to the other, but
2036 -- not from bytecode to object-code. The idea is that -fasm/-fllvm
2037 -- can be safely used in an OPTIONS_GHC pragma.
2038 setObjTarget :: HscTarget -> DynP ()
2039 setObjTarget l = upd set
2042 | isObjectTarget (hscTarget dfs) = dfs { hscTarget = l }
2045 setOptLevel :: Int -> DynFlags -> DynP DynFlags
2046 setOptLevel n dflags
2047 | hscTarget dflags == HscInterpreted && n > 0
2048 = do addWarn "-O conflicts with --interactive; -O ignored."
2051 = return (updOptLevel n dflags)
2054 -- -Odph is equivalent to
2056 -- -O2 optimise as much as possible
2057 -- -fmax-simplifier-iterations20 this is necessary sometimes
2058 -- -fsimplifier-phases=3 we use an additional simplifier phase for fusion
2060 setDPHOpt :: DynFlags -> DynP DynFlags
2061 setDPHOpt dflags = setOptLevel 2 (dflags { maxSimplIterations = 20
2065 -- Determines the package used by the vectoriser for the symbols of the vectorised code.
2066 -- 'DPHNone' indicates that no data-parallel backend library is available; hence, the
2067 -- vectoriser cannot be used.
2069 data DPHBackend = DPHPar -- "dph-par"
2070 | DPHSeq -- "dph-seq"
2071 | DPHThis -- the currently compiled package
2072 | DPHNone -- no DPH library available
2073 deriving(Eq, Ord, Enum, Show)
2075 setDPHBackend :: DPHBackend -> DynP ()
2076 setDPHBackend backend = upd $ \dflags -> dflags { dphBackend = backend }
2078 -- Query the DPH backend package to be used by the vectoriser and desugaring of DPH syntax.
2080 dphPackageMaybe :: DynFlags -> Maybe PackageId
2081 dphPackageMaybe dflags
2082 = case dphBackend dflags of
2083 DPHPar -> Just dphParPackageId
2084 DPHSeq -> Just dphSeqPackageId
2085 DPHThis -> Just (thisPackage dflags)
2088 setMainIs :: String -> DynP ()
2090 | not (null main_fn) && isLower (head main_fn)
2091 -- The arg looked like "Foo.Bar.baz"
2092 = upd $ \d -> d{ mainFunIs = Just main_fn,
2093 mainModIs = mkModule mainPackageId (mkModuleName main_mod) }
2095 | isUpper (head arg) -- The arg looked like "Foo" or "Foo.Bar"
2096 = upd $ \d -> d{ mainModIs = mkModule mainPackageId (mkModuleName arg) }
2098 | otherwise -- The arg looked like "baz"
2099 = upd $ \d -> d{ mainFunIs = Just arg }
2101 (main_mod, main_fn) = splitLongestPrefix arg (== '.')
2103 -----------------------------------------------------------------------------
2104 -- Paths & Libraries
2106 addImportPath, addLibraryPath, addIncludePath, addFrameworkPath :: FilePath -> DynP ()
2108 -- -i on its own deletes the import paths
2109 addImportPath "" = upd (\s -> s{importPaths = []})
2110 addImportPath p = upd (\s -> s{importPaths = importPaths s ++ splitPathList p})
2114 upd (\s -> s{libraryPaths = libraryPaths s ++ splitPathList p})
2117 upd (\s -> s{includePaths = includePaths s ++ splitPathList p})
2119 addFrameworkPath p =
2120 upd (\s -> s{frameworkPaths = frameworkPaths s ++ splitPathList p})
2122 #ifndef mingw32_TARGET_OS
2123 split_marker :: Char
2124 split_marker = ':' -- not configurable (ToDo)
2127 splitPathList :: String -> [String]
2128 splitPathList s = filter notNull (splitUp s)
2129 -- empty paths are ignored: there might be a trailing
2130 -- ':' in the initial list, for example. Empty paths can
2131 -- cause confusion when they are translated into -I options
2132 -- for passing to gcc.
2134 #ifndef mingw32_TARGET_OS
2135 splitUp xs = split split_marker xs
2137 -- Windows: 'hybrid' support for DOS-style paths in directory lists.
2139 -- That is, if "foo:bar:baz" is used, this interpreted as
2140 -- consisting of three entries, 'foo', 'bar', 'baz'.
2141 -- However, with "c:/foo:c:\\foo;x:/bar", this is interpreted
2142 -- as 3 elts, "c:/foo", "c:\\foo", "x:/bar"
2144 -- Notice that no attempt is made to fully replace the 'standard'
2145 -- split marker ':' with the Windows / DOS one, ';'. The reason being
2146 -- that this will cause too much breakage for users & ':' will
2147 -- work fine even with DOS paths, if you're not insisting on being silly.
2150 splitUp (x:':':div:xs) | div `elem` dir_markers
2151 = ((x:':':div:p): splitUp rs)
2153 (p,rs) = findNextPath xs
2154 -- we used to check for existence of the path here, but that
2155 -- required the IO monad to be threaded through the command-line
2156 -- parser which is quite inconvenient. The
2157 splitUp xs = cons p (splitUp rs)
2159 (p,rs) = findNextPath xs
2164 -- will be called either when we've consumed nought or the
2165 -- "<Drive>:/" part of a DOS path, so splitting is just a Q of
2166 -- finding the next split marker.
2168 case break (`elem` split_markers) xs of
2169 (p, _:ds) -> (p, ds)
2172 split_markers :: [Char]
2173 split_markers = [':', ';']
2175 dir_markers :: [Char]
2176 dir_markers = ['/', '\\']
2179 -- -----------------------------------------------------------------------------
2180 -- tmpDir, where we store temporary files.
2182 setTmpDir :: FilePath -> DynFlags -> DynFlags
2183 setTmpDir dir = alterSettings (\s -> s { sTmpDir = normalise dir })
2184 -- we used to fix /cygdrive/c/.. on Windows, but this doesn't
2185 -- seem necessary now --SDM 7/2/2008
2187 -----------------------------------------------------------------------------
2190 setRtsOpts :: String -> DynP ()
2191 setRtsOpts arg = upd $ \ d -> d {rtsOpts = Just arg}
2193 setRtsOptsEnabled :: RtsOptsEnabled -> DynP ()
2194 setRtsOptsEnabled arg = upd $ \ d -> d {rtsOptsEnabled = arg}
2196 -----------------------------------------------------------------------------
2199 setOptHpcDir :: String -> DynP ()
2200 setOptHpcDir arg = upd $ \ d -> d{hpcDir = arg}
2202 -----------------------------------------------------------------------------
2203 -- Via-C compilation stuff
2205 -- There are some options that we need to pass to gcc when compiling
2206 -- Haskell code via C, but are only supported by recent versions of
2207 -- gcc. The configure script decides which of these options we need,
2208 -- and puts them in the "settings" file in $topdir. The advantage of
2209 -- having these in a separate file is that the file can be created at
2210 -- install-time depending on the available gcc version, and even
2211 -- re-generated later if gcc is upgraded.
2213 -- The options below are not dependent on the version of gcc, only the
2216 picCCOpts :: DynFlags -> [String]
2218 #if darwin_TARGET_OS
2219 -- Apple prefers to do things the other way round.
2220 -- PIC is on by default.
2221 -- -mdynamic-no-pic:
2222 -- Turn off PIC code generation.
2224 -- Don't generate "common" symbols - these are unwanted
2225 -- in dynamic libraries.
2228 = ["-fno-common", "-U __PIC__","-D__PIC__"]
2230 = ["-mdynamic-no-pic"]
2231 #elif mingw32_TARGET_OS
2232 -- no -fPIC for Windows
2234 = ["-U __PIC__","-D__PIC__"]
2238 -- we need -fPIC for C files when we are compiling with -dynamic,
2239 -- otherwise things like stub.c files don't get compiled
2240 -- correctly. They need to reference data in the Haskell
2241 -- objects, but can't without -fPIC. See
2242 -- http://hackage.haskell.org/trac/ghc/wiki/Commentary/PositionIndependentCode
2243 | opt_PIC || not opt_Static
2244 = ["-fPIC", "-U __PIC__", "-D__PIC__"]
2249 -- -----------------------------------------------------------------------------
2253 can_split = cSupportsSplitObjs == "YES"
2255 -- -----------------------------------------------------------------------------
2258 compilerInfo :: DynFlags -> [(String, String)]
2260 = -- We always make "Project name" be first to keep parsing in
2261 -- other languages simple, i.e. when looking for other fields,
2262 -- you don't have to worry whether there is a leading '[' or not
2263 ("Project name", cProjectName)
2264 -- Next come the settings, so anything else can be overridden
2265 -- in the settings file (as "lookup" uses the first match for the
2267 : rawSettings dflags
2268 ++ [("Project version", cProjectVersion),
2269 ("Booter version", cBooterVersion),
2271 ("Build platform", cBuildPlatformString),
2272 ("Host platform", cHostPlatformString),
2273 ("Target platform", cTargetPlatformString),
2274 ("Have interpreter", cGhcWithInterpreter),
2275 ("Object splitting supported", cSupportsSplitObjs),
2276 ("Have native code generator", cGhcWithNativeCodeGen),
2277 ("Support SMP", cGhcWithSMP),
2278 ("Unregisterised", cGhcUnregisterised),
2279 ("Tables next to code", cGhcEnableTablesNextToCode),
2280 ("RTS ways", cGhcRTSWays),
2281 ("Leading underscore", cLeadingUnderscore),
2282 ("Debug on", show debugIsOn),
2283 ("LibDir", topDir dflags),
2284 ("Global Package DB", systemPackageConfig dflags),
2285 ("Gcc Linker flags", show cGccLinkerOpts),
2286 ("Ld Linker flags", show cLdLinkerOpts)