2 -- Temporary, until rtsIsProfiled is fixed
8 -- (c) The University of Glasgow 2005
11 -- Most flags are dynamic flags, which means they can change from
12 -- compilation to compilation using @OPTIONS_GHC@ pragmas, and in a
13 -- multi-session GHC each session can be using different dynamic
14 -- flags. Dynamic flags can also be set at the prompt in GHCi.
16 -- * Dynamic flags and associated configuration types
28 HscTarget(..), isObjectTarget, defaultObjectTarget,
29 GhcMode(..), isOneShot,
30 GhcLink(..), isNoLink,
34 fFlags, fLangFlags, xFlags,
38 -- ** Manipulating DynFlags
39 defaultDynFlags, -- DynFlags
40 initDynFlags, -- DynFlags -> IO DynFlags
42 getOpts, -- DynFlags -> (DynFlags -> [a]) -> [a]
49 -- ** Parsing DynFlags
51 parseDynamicNoPackageFlags,
54 supportedLanguagesAndExtensions,
56 -- ** DynFlag C compiler options
57 machdepCCOpts, picCCOpts,
59 -- * Configuration of the stg-to-stg passes
63 -- * Compiler configuration suitable for display to the user
67 -- Only in stage 2 can we be sure that the RTS
68 -- exposes the appropriate runtime boolean
73 #include "HsVersions.h"
75 #ifndef OMIT_NATIVE_CODEGEN
80 import PrelNames ( mAIN )
82 import {-# SOURCE #-} Packages (PackageState)
83 import DriverPhases ( Phase(..), phaseInputExt )
86 import Constants ( mAX_CONTEXT_REDUCTION_DEPTH )
89 import Maybes ( orElse )
93 import Foreign.C ( CInt )
94 import {-# SOURCE #-} ErrUtils ( Severity(..), Message, mkLocMessage )
96 import System.IO.Unsafe ( unsafePerformIO )
98 import Control.Monad ( when )
102 import Data.Map (Map)
103 import qualified Data.Map as Map
104 import System.FilePath
105 import System.IO ( stderr, hPutChar )
107 -- -----------------------------------------------------------------------------
110 -- | Enumerates the simple on-or-off dynamic flags
116 | Opt_D_dump_cmmz_pretty
120 | Opt_D_dump_asm_native
121 | Opt_D_dump_asm_liveness
122 | Opt_D_dump_asm_coalesce
123 | Opt_D_dump_asm_regalloc
124 | Opt_D_dump_asm_regalloc_stages
125 | Opt_D_dump_asm_conflicts
126 | Opt_D_dump_asm_stats
127 | Opt_D_dump_asm_expanded
134 | Opt_D_dump_inlinings
135 | Opt_D_dump_rule_firings
136 | Opt_D_dump_occur_anal
140 | Opt_D_dump_simpl_iterations
141 | Opt_D_dump_simpl_phases
150 | Opt_D_dump_worker_wrapper
151 | Opt_D_dump_rn_trace
152 | Opt_D_dump_rn_stats
154 | Opt_D_dump_simpl_stats
155 | Opt_D_dump_tc_trace
156 | Opt_D_dump_if_trace
163 | Opt_D_verbose_core2core
164 | Opt_D_verbose_stg2stg
166 | Opt_D_dump_hi_diffs
167 | Opt_D_dump_minimal_imports
168 | Opt_D_dump_mod_cycles
169 | Opt_D_dump_view_pattern_commoning
170 | Opt_D_faststring_stats
171 | Opt_DumpToFile -- ^ Append dump output to files instead of stdout.
172 | Opt_D_no_debug_output
178 | Opt_WarnIsError -- -Werror; makes warnings fatal
179 | Opt_WarnDuplicateExports
181 | Opt_WarnImplicitPrelude
182 | Opt_WarnIncompletePatterns
183 | Opt_WarnIncompletePatternsRecUpd
184 | Opt_WarnMissingFields
185 | Opt_WarnMissingImportList
186 | Opt_WarnMissingMethods
187 | Opt_WarnMissingSigs
188 | Opt_WarnMissingLocalSigs
189 | Opt_WarnNameShadowing
190 | Opt_WarnOverlappingPatterns
191 | Opt_WarnTypeDefaults
192 | Opt_WarnMonomorphism
193 | Opt_WarnUnusedBinds
194 | Opt_WarnUnusedImports
195 | Opt_WarnUnusedMatches
196 | Opt_WarnWarningsDeprecations
197 | Opt_WarnDeprecatedFlags
198 | Opt_WarnDodgyExports
199 | Opt_WarnDodgyImports
201 | Opt_WarnAutoOrphans
203 | Opt_WarnUnrecognisedPragmas
204 | Opt_WarnDodgyForeignImports
205 | Opt_WarnLazyUnliftedBindings
206 | Opt_WarnUnusedDoBind
207 | Opt_WarnWrongDoBind
208 | Opt_WarnAlternativeLayoutRuleTransitional
210 | Opt_PrintExplicitForalls
217 | Opt_StaticArgumentTransformation
221 | Opt_DoLambdaEtaExpansion
225 | Opt_UnboxStrictFields
226 | Opt_MethodSharing -- Now a no-op; remove in GHC 7.2
228 | Opt_EnableRewriteRules -- Apply rewrite rules during simplification
230 | Opt_RegsGraph -- do graph coloring register allocation
231 | Opt_RegsIterative -- do iterative coalescing graph coloring register allocation
234 | Opt_IgnoreInterfacePragmas
235 | Opt_OmitInterfacePragmas
236 | Opt_ExposeAllUnfoldings
239 | Opt_AutoSccsOnAllToplevs
240 | Opt_AutoSccsOnExportedToplevs
241 | Opt_AutoSccsOnIndividualCafs
248 | Opt_ExcessPrecision
249 | Opt_EagerBlackHoling
250 | Opt_ReadUserPackageConf
254 | Opt_HideAllPackages
255 | Opt_PrintBindResult
259 | Opt_BreakOnException
261 | Opt_PrintEvldWithShow
262 | Opt_PrintBindContents
265 | Opt_EmitExternalCore
267 | Opt_BuildingCabalPackage
274 | Opt_ConvertToZipCfgAndBack
275 | Opt_AutoLinkPackages
276 | Opt_ImplicitImportQualified
285 | Opt_KeepRawTokenStream
290 data Language = Haskell98 | Haskell2010
294 | Opt_OverlappingInstances
295 | Opt_UndecidableInstances
296 | Opt_IncoherentInstances
297 | Opt_MonomorphismRestriction
300 | Opt_RelaxedPolyRec -- Deprecated
301 | Opt_ExtendedDefaultRules -- Use GHC's extended rules for defaulting
302 | Opt_ForeignFunctionInterface
303 | Opt_UnliftedFFITypes
304 | Opt_GHCForeignImportPrim
305 | Opt_PArr -- Syntactic support for parallel arrays
306 | Opt_Arrows -- Arrow-notation syntax
307 | Opt_TemplateHaskell
310 | Opt_Generics -- "Derivable type classes"
311 | Opt_ImplicitPrelude
312 | Opt_ScopedTypeVariables
316 | Opt_OverloadedStrings
317 | Opt_DisambiguateRecordFields
318 | Opt_RecordWildCards
323 | Opt_DoAndIfThenElse
324 | Opt_RebindableSyntax
326 | Opt_StandaloneDeriving
327 | Opt_DeriveDataTypeable
329 | Opt_DeriveTraversable
332 | Opt_TypeSynonymInstances
333 | Opt_FlexibleContexts
334 | Opt_FlexibleInstances
335 | Opt_ConstrainedClassMethods
336 | Opt_MultiParamTypeClasses
337 | Opt_FunctionalDependencies
339 | Opt_PolymorphicComponents
340 | Opt_ExistentialQuantification
344 | Opt_ParallelListComp
345 | Opt_TransformListComp
346 | Opt_GeneralizedNewtypeDeriving
349 | Opt_PostfixOperators
352 | Opt_LiberalTypeSynonyms
355 | Opt_ImpredicativeTypes
358 | Opt_NewQualifiedOperators
360 | Opt_AlternativeLayoutRule
361 | Opt_AlternativeLayoutRuleTransitional
362 | Opt_DatatypeContexts
365 -- | Contains not only a collection of 'DynFlag's but also a plethora of
366 -- information relating to the compilation of a single file or GHC session
367 data DynFlags = DynFlags {
370 hscTarget :: HscTarget,
371 hscOutName :: String, -- ^ Name of the output file
372 extCoreName :: String, -- ^ Name of the .hcr output file
373 verbosity :: Int, -- ^ Verbosity level: see Note [Verbosity levels]
374 optLevel :: Int, -- ^ Optimisation level
375 simplPhases :: Int, -- ^ Number of simplifier phases
376 maxSimplIterations :: Int, -- ^ Max simplifier iterations
377 shouldDumpSimplPhase :: Maybe String,
378 ruleCheck :: Maybe String,
379 strictnessBefore :: [Int], -- ^ Additional demand analysis
381 specConstrThreshold :: Maybe Int, -- ^ Threshold for SpecConstr
382 specConstrCount :: Maybe Int, -- ^ Max number of specialisations for any one function
383 liberateCaseThreshold :: Maybe Int, -- ^ Threshold for LiberateCase
385 #ifndef OMIT_NATIVE_CODEGEN
386 targetPlatform :: Platform, -- ^ The platform we're compiling for. Used by the NCG.
388 stolen_x86_regs :: Int,
389 cmdlineHcIncludes :: [String], -- ^ @\-\#includes@
390 importPaths :: [FilePath],
392 mainFunIs :: Maybe String,
393 ctxtStkDepth :: Int, -- ^ Typechecker context stack depth
395 dphBackend :: DPHBackend,
397 thisPackage :: PackageId, -- ^ name of package currently being compiled
400 ways :: [Way], -- ^ Way flags from the command line
401 buildTag :: String, -- ^ The global \"way\" (e.g. \"p\" for prof)
402 rtsBuildTag :: String, -- ^ The RTS \"way\"
404 -- For object splitting
405 splitInfo :: Maybe (String,Int),
408 objectDir :: Maybe String,
409 dylibInstallName :: Maybe String,
410 hiDir :: Maybe String,
411 stubDir :: Maybe String,
417 outputFile :: Maybe String,
418 outputHi :: Maybe String,
419 dynLibLoader :: DynLibLoader,
421 -- | This is set by 'DriverPipeline.runPipeline' based on where
422 -- its output is going.
423 dumpPrefix :: Maybe FilePath,
425 -- | Override the 'dumpPrefix' set by 'DriverPipeline.runPipeline'.
426 -- Set by @-ddump-file-prefix@
427 dumpPrefixForce :: Maybe FilePath,
429 includePaths :: [String],
430 libraryPaths :: [String],
431 frameworkPaths :: [String], -- used on darwin only
432 cmdlineFrameworks :: [String], -- ditto
433 tmpDir :: String, -- no trailing '/'
435 ghcUsagePath :: FilePath, -- Filled in by SysTools
436 ghciUsagePath :: FilePath, -- ditto
437 rtsOpts :: Maybe String,
438 rtsOptsEnabled :: RtsOptsEnabled,
440 hpcDir :: String, -- ^ Path to store the .mix files
442 -- options for particular phases
450 opt_windres :: [String],
451 opt_lo :: [String], -- LLVM: llvm optimiser
452 opt_lc :: [String], -- LLVM: llc static compiler
454 -- commands for particular phases
456 pgm_P :: (String,[Option]),
458 pgm_c :: (String,[Option]),
459 pgm_m :: (String,[Option]),
460 pgm_s :: (String,[Option]),
461 pgm_a :: (String,[Option]),
462 pgm_l :: (String,[Option]),
463 pgm_dll :: (String,[Option]),
465 pgm_sysman :: String,
466 pgm_windres :: String,
467 pgm_lo :: (String,[Option]), -- LLVM: opt llvm optimiser
468 pgm_lc :: (String,[Option]), -- LLVM: llc static compiler
471 depMakefile :: FilePath,
472 depIncludePkgDeps :: Bool,
473 depExcludeMods :: [ModuleName],
474 depSuffixes :: [String],
477 extraPkgConfs :: [FilePath],
478 topDir :: FilePath, -- filled in by SysTools
479 systemPackageConfig :: FilePath, -- ditto
480 -- ^ The @-package-conf@ flags given on the command line, in the order
483 packageFlags :: [PackageFlag],
484 -- ^ The @-package@ and @-hide-package@ flags from the command-line
487 -- NB. do not modify this field, it is calculated by
488 -- Packages.initPackages and Packages.updatePackages.
489 pkgDatabase :: Maybe [PackageConfig],
490 pkgState :: PackageState,
493 -- These have to be IORefs, because the defaultCleanupHandler needs to
494 -- know what to clean when an exception happens
495 filesToClean :: IORef [FilePath],
496 dirsToClean :: IORef (Map FilePath FilePath),
500 -- Don't change this without updating extensionFlags:
501 language :: Maybe Language,
502 -- Don't change this without updating extensionFlags:
503 extensions :: [OnOff ExtensionFlag],
504 -- extensionFlags should always be equal to
505 -- flattenExtensionFlags language extensions
506 extensionFlags :: [ExtensionFlag],
508 -- | Message output action: use "ErrUtils" instead of this if you can
509 log_action :: Severity -> SrcSpan -> PprStyle -> Message -> IO (),
511 haddockOptions :: Maybe String
514 wayNames :: DynFlags -> [WayName]
515 wayNames = map wayName . ways
517 -- | The target code type of the compilation (if any).
519 -- Whenever you change the target, also make sure to set 'ghcLink' to
520 -- something sensible.
522 -- 'HscNothing' can be used to avoid generating any output, however, note
525 -- * This will not run the desugaring step, thus no warnings generated in
526 -- this step will be output. In particular, this includes warnings related
527 -- to pattern matching. You can run the desugarer manually using
528 -- 'GHC.desugarModule'.
530 -- * If a program uses Template Haskell the typechecker may try to run code
531 -- from an imported module. This will fail if no code has been generated
532 -- for this module. You can use 'GHC.needsTemplateHaskell' to detect
533 -- whether this might be the case and choose to either switch to a
534 -- different target or avoid typechecking such modules. (The latter may
535 -- preferable for security reasons.)
538 = HscC -- ^ Generate C code.
539 | HscAsm -- ^ Generate assembly using the native code generator.
540 | HscLlvm -- ^ Generate assembly using the llvm code generator.
541 | HscJava -- ^ Generate Java bytecode.
542 | HscInterpreted -- ^ Generate bytecode. (Requires 'LinkInMemory')
543 | HscNothing -- ^ Don't generate any code. See notes above.
546 -- | Will this target result in an object file on the disk?
547 isObjectTarget :: HscTarget -> Bool
548 isObjectTarget HscC = True
549 isObjectTarget HscAsm = True
550 isObjectTarget HscLlvm = True
551 isObjectTarget _ = False
553 -- | The 'GhcMode' tells us whether we're doing multi-module
554 -- compilation (controlled via the "GHC" API) or one-shot
555 -- (single-module) compilation. This makes a difference primarily to
556 -- the "Finder": in one-shot mode we look for interface files for
557 -- imported modules, but in multi-module mode we look for source files
558 -- in order to check whether they need to be recompiled.
560 = CompManager -- ^ @\-\-make@, GHCi, etc.
561 | OneShot -- ^ @ghc -c Foo.hs@
562 | MkDepend -- ^ @ghc -M@, see "Finder" for why we need this
565 instance Outputable GhcMode where
566 ppr CompManager = ptext (sLit "CompManager")
567 ppr OneShot = ptext (sLit "OneShot")
568 ppr MkDepend = ptext (sLit "MkDepend")
570 isOneShot :: GhcMode -> Bool
571 isOneShot OneShot = True
572 isOneShot _other = False
574 -- | What to do in the link step, if there is one.
576 = NoLink -- ^ Don't link at all
577 | LinkBinary -- ^ Link object code into a binary
578 | LinkInMemory -- ^ Use the in-memory dynamic linker (works for both
579 -- bytecode and object code).
580 | LinkDynLib -- ^ Link objects into a dynamic lib (DLL on Windows, DSO on ELF platforms)
583 isNoLink :: GhcLink -> Bool
584 isNoLink NoLink = True
587 -- Is it worth evaluating this Bool and caching it in the DynFlags value
588 -- during initDynFlags?
589 doingTickyProfiling :: DynFlags -> Bool
590 doingTickyProfiling _ = opt_Ticky
591 -- XXX -ticky is a static flag, because it implies -debug which is also
592 -- static. If the way flags were made dynamic, we could fix this.
595 = ExposePackage String
596 | ExposePackageId String
598 | IgnorePackage String
601 defaultHscTarget :: HscTarget
602 defaultHscTarget = defaultObjectTarget
604 -- | The 'HscTarget' value corresponding to the default way to create
605 -- object files on the current platform.
606 defaultObjectTarget :: HscTarget
608 | cGhcWithNativeCodeGen == "YES" = HscAsm
616 data RtsOptsEnabled = RtsOptsNone | RtsOptsSafeOnly | RtsOptsAll
618 -- | Used by 'GHC.newSession' to partially initialize a new 'DynFlags' value
619 initDynFlags :: DynFlags -> IO DynFlags
620 initDynFlags dflags = do
621 -- someday these will be dynamic flags
622 ways <- readIORef v_Ways
623 refFilesToClean <- newIORef []
624 refDirsToClean <- newIORef Map.empty
627 buildTag = mkBuildTag (filter (not . wayRTSOnly) ways),
628 rtsBuildTag = mkBuildTag ways,
629 filesToClean = refFilesToClean,
630 dirsToClean = refDirsToClean
633 -- | The normal 'DynFlags'. Note that they is not suitable for use in this form
634 -- and must be fully initialized by 'GHC.newSession' first.
635 defaultDynFlags :: DynFlags
638 ghcMode = CompManager,
639 ghcLink = LinkBinary,
640 hscTarget = defaultHscTarget,
646 maxSimplIterations = 4,
647 shouldDumpSimplPhase = Nothing,
649 specConstrThreshold = Just 200,
650 specConstrCount = Just 3,
651 liberateCaseThreshold = Just 200,
652 strictnessBefore = [],
654 #ifndef OMIT_NATIVE_CODEGEN
655 targetPlatform = defaultTargetPlatform,
658 cmdlineHcIncludes = [],
662 ctxtStkDepth = mAX_CONTEXT_REDUCTION_DEPTH,
666 thisPackage = mainPackageId,
669 dylibInstallName = Nothing,
673 objectSuf = phaseInputExt StopLn,
674 hcSuf = phaseInputExt HCc,
677 outputFile = Nothing,
679 dynLibLoader = SystemDependent,
680 dumpPrefix = Nothing,
681 dumpPrefixForce = Nothing,
685 cmdlineFrameworks = [],
686 tmpDir = cDEFAULT_TMPDIR,
688 rtsOptsEnabled = RtsOptsSafeOnly,
694 then ["-D__PIC__", "-U __PIC__"] -- this list is reversed
707 pkgDatabase = Nothing,
708 pkgState = panic "no package state yet: call GHC.setSessionDynFlags",
709 ways = panic "defaultDynFlags: No ways",
710 buildTag = panic "defaultDynFlags: No buildTag",
711 rtsBuildTag = panic "defaultDynFlags: No rtsBuildTag",
713 -- initSysTools fills all these in
714 ghcUsagePath = panic "defaultDynFlags: No ghciUsagePath",
715 ghciUsagePath = panic "defaultDynFlags: No ghciUsagePath",
716 topDir = panic "defaultDynFlags: No topDir",
717 systemPackageConfig = panic "no systemPackageConfig: call GHC.setSessionDynFlags",
718 pgm_L = panic "defaultDynFlags: No pgm_L",
719 pgm_P = panic "defaultDynFlags: No pgm_P",
720 pgm_F = panic "defaultDynFlags: No pgm_F",
721 pgm_c = panic "defaultDynFlags: No pgm_c",
722 pgm_m = panic "defaultDynFlags: No pgm_m",
723 pgm_s = panic "defaultDynFlags: No pgm_s",
724 pgm_a = panic "defaultDynFlags: No pgm_a",
725 pgm_l = panic "defaultDynFlags: No pgm_l",
726 pgm_dll = panic "defaultDynFlags: No pgm_dll",
727 pgm_T = panic "defaultDynFlags: No pgm_T",
728 pgm_sysman = panic "defaultDynFlags: No pgm_sysman",
729 pgm_windres = panic "defaultDynFlags: No pgm_windres",
730 pgm_lo = panic "defaultDynFlags: No pgm_lo",
731 pgm_lc = panic "defaultDynFlags: No pgm_lc",
732 -- end of initSysTools values
734 depMakefile = "Makefile",
735 depIncludePkgDeps = False,
738 -- end of ghc -M values
739 filesToClean = panic "defaultDynFlags: No filesToClean",
740 dirsToClean = panic "defaultDynFlags: No dirsToClean",
741 haddockOptions = Nothing,
742 flags = defaultFlags,
745 extensionFlags = flattenExtensionFlags Nothing [],
747 log_action = \severity srcSpan style msg ->
749 SevOutput -> printOutput (msg style)
750 SevInfo -> printErrs (msg style)
751 SevFatal -> printErrs (msg style)
754 printErrs ((mkLocMessage srcSpan msg) style)
755 -- careful (#2302): printErrs prints in UTF-8, whereas
756 -- converting to string first and using hPutStr would
757 -- just emit the low 8 bits of each unicode char.
761 Note [Verbosity levels]
762 ~~~~~~~~~~~~~~~~~~~~~~~
763 0 | print errors & warnings only
764 1 | minimal verbosity: print "compiling M ... done." for each module.
765 2 | equivalent to -dshow-passes
766 3 | equivalent to existing "ghc -v"
767 4 | "ghc -v -ddump-most"
768 5 | "ghc -v -ddump-all"
774 -- OnOffs accumulate in reverse order, so we use foldr in order to
775 -- process them in the right order
776 flattenExtensionFlags :: Maybe Language -> [OnOff ExtensionFlag]
778 flattenExtensionFlags ml = foldr f defaultExtensionFlags
779 where f (On f) flags = f : delete f flags
780 f (Off f) flags = delete f flags
781 defaultExtensionFlags = languageExtensions ml
783 languageExtensions :: Maybe Language -> [ExtensionFlag]
785 languageExtensions Nothing
786 -- Nothing => the default case
787 = Opt_MonoPatBinds -- Experimentally, I'm making this non-standard
788 -- behaviour the default, to see if anyone notices
790 -- In due course I'd like Opt_MonoLocalBinds to be on by default
791 -- But NB it's implied by GADTs etc
792 -- SLPJ September 2010
793 : languageExtensions (Just Haskell2010)
795 languageExtensions (Just Haskell98)
796 = [Opt_ImplicitPrelude,
797 Opt_MonomorphismRestriction,
799 Opt_DatatypeContexts]
801 languageExtensions (Just Haskell2010)
802 = [Opt_ImplicitPrelude,
803 Opt_MonomorphismRestriction,
804 Opt_DatatypeContexts,
806 Opt_ForeignFunctionInterface,
811 -- | Test whether a 'DynFlag' is set
812 dopt :: DynFlag -> DynFlags -> Bool
813 dopt f dflags = f `elem` (flags dflags)
816 dopt_set :: DynFlags -> DynFlag -> DynFlags
817 dopt_set dfs f = dfs{ flags = f : flags dfs }
819 -- | Unset a 'DynFlag'
820 dopt_unset :: DynFlags -> DynFlag -> DynFlags
821 dopt_unset dfs f = dfs{ flags = filter (/= f) (flags dfs) }
823 -- | Test whether a 'ExtensionFlag' is set
824 xopt :: ExtensionFlag -> DynFlags -> Bool
825 xopt f dflags = f `elem` extensionFlags dflags
827 -- | Set a 'ExtensionFlag'
828 xopt_set :: DynFlags -> ExtensionFlag -> DynFlags
830 = let onoffs = On f : extensions dfs
831 in dfs { extensions = onoffs,
832 extensionFlags = flattenExtensionFlags (language dfs) onoffs }
834 -- | Unset a 'ExtensionFlag'
835 xopt_unset :: DynFlags -> ExtensionFlag -> DynFlags
837 = let onoffs = Off f : extensions dfs
838 in dfs { extensions = onoffs,
839 extensionFlags = flattenExtensionFlags (language dfs) onoffs }
841 setLanguage :: Language -> DynP ()
842 setLanguage l = upd f
843 where f dfs = let mLang = Just l
844 oneoffs = extensions dfs
847 extensionFlags = flattenExtensionFlags mLang oneoffs
850 -- | Retrieve the options corresponding to a particular @opt_*@ field in the correct order
851 getOpts :: DynFlags -- ^ 'DynFlags' to retrieve the options from
852 -> (DynFlags -> [a]) -- ^ Relevant record accessor: one of the @opt_*@ accessors
853 -> [a] -- ^ Correctly ordered extracted options
854 getOpts dflags opts = reverse (opts dflags)
855 -- We add to the options from the front, so we need to reverse the list
857 -- | Gets the verbosity flag for the current verbosity level. This is fed to
858 -- other tools, so GHC-specific verbosity flags like @-ddump-most@ are not included
859 getVerbFlag :: DynFlags -> String
861 | verbosity dflags >= 3 = "-v"
864 setObjectDir, setHiDir, setStubDir, setOutputDir, setDylibInstallName,
865 setObjectSuf, setHiSuf, setHcSuf, parseDynLibLoaderMode,
866 setPgmP, addOptl, addOptP,
867 addCmdlineFramework, addHaddockOpts
868 :: String -> DynFlags -> DynFlags
869 setOutputFile, setOutputHi, setDumpPrefixForce
870 :: Maybe String -> DynFlags -> DynFlags
872 setObjectDir f d = d{ objectDir = Just f}
873 setHiDir f d = d{ hiDir = Just f}
874 setStubDir f d = d{ stubDir = Just f, includePaths = f : includePaths d }
875 -- -stubdir D adds an implicit -I D, so that gcc can find the _stub.h file
876 -- \#included from the .hc file when compiling with -fvia-C.
877 setOutputDir f = setObjectDir f . setHiDir f . setStubDir f
878 setDylibInstallName f d = d{ dylibInstallName = Just f}
880 setObjectSuf f d = d{ objectSuf = f}
881 setHiSuf f d = d{ hiSuf = f}
882 setHcSuf f d = d{ hcSuf = f}
884 setOutputFile f d = d{ outputFile = f}
885 setOutputHi f d = d{ outputHi = f}
887 parseDynLibLoaderMode f d =
889 ("deploy", "") -> d{ dynLibLoader = Deployable }
890 ("sysdep", "") -> d{ dynLibLoader = SystemDependent }
891 _ -> ghcError (CmdLineError ("Unknown dynlib loader: " ++ f))
893 setDumpPrefixForce f d = d { dumpPrefixForce = f}
895 -- XXX HACK: Prelude> words "'does not' work" ===> ["'does","not'","work"]
896 -- Config.hs should really use Option.
897 setPgmP f d = let (pgm:args) = words f in d{ pgm_P = (pgm, map Option args)}
898 addOptl f d = d{ opt_l = f : opt_l d}
899 addOptP f d = d{ opt_P = f : opt_P d}
902 setDepMakefile :: FilePath -> DynFlags -> DynFlags
903 setDepMakefile f d = d { depMakefile = deOptDep f }
905 setDepIncludePkgDeps :: Bool -> DynFlags -> DynFlags
906 setDepIncludePkgDeps b d = d { depIncludePkgDeps = b }
908 addDepExcludeMod :: String -> DynFlags -> DynFlags
910 = d { depExcludeMods = mkModuleName (deOptDep m) : depExcludeMods d }
912 addDepSuffix :: FilePath -> DynFlags -> DynFlags
913 addDepSuffix s d = d { depSuffixes = deOptDep s : depSuffixes d }
916 -- We used to use "-optdep-flag -optdeparg", so for legacy applications
917 -- we need to strip the "-optdep" off of the arg
918 deOptDep :: String -> String
919 deOptDep x = case stripPrefix "-optdep" x of
923 addCmdlineFramework f d = d{ cmdlineFrameworks = f : cmdlineFrameworks d}
925 addHaddockOpts f d = d{ haddockOptions = Just f}
927 -- -----------------------------------------------------------------------------
928 -- Command-line options
930 -- | When invoking external tools as part of the compilation pipeline, we
931 -- pass these a sequence of options on the command-line. Rather than
932 -- just using a list of Strings, we use a type that allows us to distinguish
933 -- between filepaths and 'other stuff'. The reason for this is that
934 -- this type gives us a handle on transforming filenames, and filenames only,
935 -- to whatever format they're expected to be on a particular platform.
937 = FileOption -- an entry that _contains_ filename(s) / filepaths.
938 String -- a non-filepath prefix that shouldn't be
939 -- transformed (e.g., "/out=")
940 String -- the filepath/filename portion
943 showOpt :: Option -> String
944 showOpt (FileOption pre f) = pre ++ f
945 showOpt (Option s) = s
947 -----------------------------------------------------------------------------
948 -- Setting the optimisation level
950 updOptLevel :: Int -> DynFlags -> DynFlags
951 -- ^ Sets the 'DynFlags' to be appropriate to the optimisation level
953 = dfs2{ optLevel = final_n }
955 final_n = max 0 (min 2 n) -- Clamp to 0 <= n <= 2
956 dfs1 = foldr (flip dopt_unset) dfs remove_dopts
957 dfs2 = foldr (flip dopt_set) dfs1 extra_dopts
959 extra_dopts = [ f | (ns,f) <- optLevelFlags, final_n `elem` ns ]
960 remove_dopts = [ f | (ns,f) <- optLevelFlags, final_n `notElem` ns ]
962 -- -----------------------------------------------------------------------------
963 -- StgToDo: abstraction of stg-to-stg passes to run.
966 = StgDoMassageForProfiling -- should be (next to) last
967 -- There's also setStgVarInfo, but its absolute "lastness"
968 -- is so critical that it is hardwired in (no flag).
971 getStgToDo :: DynFlags -> [StgToDo]
975 stg_stats = dopt Opt_StgStats dflags
977 todo1 = if stg_stats then [D_stg_stats] else []
979 todo2 | WayProf `elem` wayNames dflags
980 = StgDoMassageForProfiling : todo1
984 {- **********************************************************************
988 %********************************************************************* -}
990 -- -----------------------------------------------------------------------------
991 -- Parsing the dynamic flags.
993 -- | Parse dynamic flags from a list of command line arguments. Returns the
994 -- the parsed 'DynFlags', the left-over arguments, and a list of warnings.
995 -- Throws a 'UsageError' if errors occurred during parsing (such as unknown
996 -- flags or missing arguments).
997 parseDynamicFlags :: Monad m =>
998 DynFlags -> [Located String]
999 -> m (DynFlags, [Located String], [Located String])
1000 -- ^ Updated 'DynFlags', left-over arguments, and
1001 -- list of warnings.
1002 parseDynamicFlags dflags args = parseDynamicFlags_ dflags args True
1004 -- | Like 'parseDynamicFlags' but does not allow the package flags (-package,
1005 -- -hide-package, -ignore-package, -hide-all-packages, -package-conf).
1006 parseDynamicNoPackageFlags :: Monad m =>
1007 DynFlags -> [Located String]
1008 -> m (DynFlags, [Located String], [Located String])
1009 -- ^ Updated 'DynFlags', left-over arguments, and
1010 -- list of warnings.
1011 parseDynamicNoPackageFlags dflags args = parseDynamicFlags_ dflags args False
1013 parseDynamicFlags_ :: Monad m =>
1014 DynFlags -> [Located String] -> Bool
1015 -> m (DynFlags, [Located String], [Located String])
1016 parseDynamicFlags_ dflags0 args pkg_flags = do
1017 -- XXX Legacy support code
1018 -- We used to accept things like
1019 -- optdep-f -optdepdepend
1020 -- optdep-f -optdep depend
1021 -- optdep -f -optdepdepend
1022 -- optdep -f -optdep depend
1023 -- but the spaces trip up proper argument handling. So get rid of them.
1024 let f (L p "-optdep" : L _ x : xs) = (L p ("-optdep" ++ x)) : f xs
1025 f (x : xs) = x : f xs
1029 -- Note: -ignore-package (package_flags) must precede -i* (dynamic_flags)
1030 flag_spec | pkg_flags = package_flags ++ dynamic_flags
1031 | otherwise = dynamic_flags
1033 let ((leftover, errs, warns), dflags1)
1034 = runCmdLine (processArgs flag_spec args') dflags0
1035 when (not (null errs)) $ ghcError $ errorsToGhcException errs
1037 -- Cannot use -fPIC with registerised -fvia-C, because the mangler
1038 -- isn't up to the job. We know that if hscTarget == HscC, then the
1039 -- user has explicitly used -fvia-C, because -fasm is the default,
1040 -- unless there is no NCG on this platform. The latter case is
1041 -- checked when the -fPIC flag is parsed.
1043 let (pic_warns, dflags2)
1044 | opt_PIC && hscTarget dflags1 == HscC && cGhcUnregisterised == "NO"
1045 = ([L noSrcSpan $ "Warning: -fvia-C is incompatible with -fPIC; ignoring -fvia-C"],
1046 dflags1{ hscTarget = HscAsm })
1047 #if !(x86_64_TARGET_ARCH && linux_TARGET_OS)
1048 | (not opt_Static || opt_PIC) && hscTarget dflags1 == HscLlvm
1049 = ([L noSrcSpan $ "Warning: -fllvm is incompatible with -fPIC and -"
1050 ++ "dynamic on this platform;\n ignoring -fllvm"],
1051 dflags1{ hscTarget = HscAsm })
1053 | otherwise = ([], dflags1)
1055 return (dflags2, leftover, pic_warns ++ warns)
1058 {- **********************************************************************
1060 DynFlags specifications
1062 %********************************************************************* -}
1064 allFlags :: [String]
1065 allFlags = map ('-':) $
1066 [ flagName flag | flag <- dynamic_flags, ok (flagOptKind flag) ] ++
1067 map ("fno-"++) flags ++
1068 map ("f"++) flags ++
1069 map ("f"++) flags' ++
1070 map ("X"++) supportedExtensions
1071 where ok (PrefixPred _ _) = False
1073 flags = [ name | (name, _, _) <- fFlags ]
1074 flags' = [ name | (name, _, _) <- fLangFlags ]
1076 --------------- The main flags themselves ------------------
1077 dynamic_flags :: [Flag (CmdLineP DynFlags)]
1079 Flag "n" (NoArg (setDynFlag Opt_DryRun))
1080 , Flag "cpp" (NoArg (setExtensionFlag Opt_Cpp))
1081 , Flag "F" (NoArg (setDynFlag Opt_Pp))
1083 (HasArg (\s -> do { addCmdlineHCInclude s
1084 ; addWarn "-#include and INCLUDE pragmas are deprecated: They no longer have any effect" }))
1085 , Flag "v" (OptIntSuffix setVerbosity)
1087 ------- Specific phases --------------------------------------------
1088 -- need to appear before -pgmL to be parsed as LLVM flags.
1089 , Flag "pgmlo" (hasArg (\f d -> d{ pgm_lo = (f,[])}))
1090 , Flag "pgmlc" (hasArg (\f d -> d{ pgm_lc = (f,[])}))
1091 , Flag "pgmL" (hasArg (\f d -> d{ pgm_L = f}))
1092 , Flag "pgmP" (hasArg setPgmP)
1093 , Flag "pgmF" (hasArg (\f d -> d{ pgm_F = f}))
1094 , Flag "pgmc" (hasArg (\f d -> d{ pgm_c = (f,[])}))
1095 , Flag "pgmm" (hasArg (\f d -> d{ pgm_m = (f,[])}))
1096 , Flag "pgms" (hasArg (\f d -> d{ pgm_s = (f,[])}))
1097 , Flag "pgma" (hasArg (\f d -> d{ pgm_a = (f,[])}))
1098 , Flag "pgml" (hasArg (\f d -> d{ pgm_l = (f,[])}))
1099 , Flag "pgmdll" (hasArg (\f d -> d{ pgm_dll = (f,[])}))
1100 , Flag "pgmwindres" (hasArg (\f d -> d{ pgm_windres = f}))
1102 -- need to appear before -optl/-opta to be parsed as LLVM flags.
1103 , Flag "optlo" (hasArg (\f d -> d{ opt_lo = f : opt_lo d}))
1104 , Flag "optlc" (hasArg (\f d -> d{ opt_lc = f : opt_lc d}))
1105 , Flag "optL" (hasArg (\f d -> d{ opt_L = f : opt_L d}))
1106 , Flag "optP" (hasArg addOptP)
1107 , Flag "optF" (hasArg (\f d -> d{ opt_F = f : opt_F d}))
1108 , Flag "optc" (hasArg (\f d -> d{ opt_c = f : opt_c d}))
1109 , Flag "optm" (hasArg (\f d -> d{ opt_m = f : opt_m d}))
1110 , Flag "opta" (hasArg (\f d -> d{ opt_a = f : opt_a d}))
1111 , Flag "optl" (hasArg addOptl)
1112 , Flag "optwindres" (hasArg (\f d -> d{ opt_windres = f : opt_windres d}))
1115 (NoArg (if can_split
1116 then setDynFlag Opt_SplitObjs
1117 else addWarn "ignoring -fsplit-objs"))
1119 -------- ghc -M -----------------------------------------------------
1120 , Flag "dep-suffix" (hasArg addDepSuffix)
1121 , Flag "optdep-s" (hasArgDF addDepSuffix "Use -dep-suffix instead")
1122 , Flag "dep-makefile" (hasArg setDepMakefile)
1123 , Flag "optdep-f" (hasArgDF setDepMakefile "Use -dep-makefile instead")
1124 , Flag "optdep-w" (NoArg (deprecate "doesn't do anything"))
1125 , Flag "include-pkg-deps" (noArg (setDepIncludePkgDeps True))
1126 , Flag "optdep--include-prelude" (noArgDF (setDepIncludePkgDeps True) "Use -include-pkg-deps instead")
1127 , Flag "optdep--include-pkg-deps" (noArgDF (setDepIncludePkgDeps True) "Use -include-pkg-deps instead")
1128 , Flag "exclude-module" (hasArg addDepExcludeMod)
1129 , Flag "optdep--exclude-module" (hasArgDF addDepExcludeMod "Use -exclude-module instead")
1130 , Flag "optdep-x" (hasArgDF addDepExcludeMod "Use -exclude-module instead")
1132 -------- Linking ----------------------------------------------------
1133 , Flag "no-link" (noArg (\d -> d{ ghcLink=NoLink }))
1134 , Flag "shared" (noArg (\d -> d{ ghcLink=LinkDynLib }))
1135 , Flag "dynload" (hasArg parseDynLibLoaderMode)
1136 , Flag "dylib-install-name" (hasArg setDylibInstallName)
1138 ------- Libraries ---------------------------------------------------
1139 , Flag "L" (Prefix addLibraryPath)
1140 , Flag "l" (AnySuffix (upd . addOptl))
1142 ------- Frameworks --------------------------------------------------
1143 -- -framework-path should really be -F ...
1144 , Flag "framework-path" (HasArg addFrameworkPath)
1145 , Flag "framework" (hasArg addCmdlineFramework)
1147 ------- Output Redirection ------------------------------------------
1148 , Flag "odir" (hasArg setObjectDir)
1149 , Flag "o" (SepArg (upd . setOutputFile . Just))
1150 , Flag "ohi" (hasArg (setOutputHi . Just ))
1151 , Flag "osuf" (hasArg setObjectSuf)
1152 , Flag "hcsuf" (hasArg setHcSuf)
1153 , Flag "hisuf" (hasArg setHiSuf)
1154 , Flag "hidir" (hasArg setHiDir)
1155 , Flag "tmpdir" (hasArg setTmpDir)
1156 , Flag "stubdir" (hasArg setStubDir)
1157 , Flag "outputdir" (hasArg setOutputDir)
1158 , Flag "ddump-file-prefix" (hasArg (setDumpPrefixForce . Just))
1160 ------- Keeping temporary files -------------------------------------
1161 -- These can be singular (think ghc -c) or plural (think ghc --make)
1162 , Flag "keep-hc-file" (NoArg (setDynFlag Opt_KeepHcFiles))
1163 , Flag "keep-hc-files" (NoArg (setDynFlag Opt_KeepHcFiles))
1164 , Flag "keep-s-file" (NoArg (setDynFlag Opt_KeepSFiles))
1165 , Flag "keep-s-files" (NoArg (setDynFlag Opt_KeepSFiles))
1166 , Flag "keep-raw-s-file" (NoArg (setDynFlag Opt_KeepRawSFiles))
1167 , Flag "keep-raw-s-files" (NoArg (setDynFlag Opt_KeepRawSFiles))
1168 , Flag "keep-llvm-file" (NoArg (setDynFlag Opt_KeepLlvmFiles))
1169 , Flag "keep-llvm-files" (NoArg (setDynFlag Opt_KeepLlvmFiles))
1170 -- This only makes sense as plural
1171 , Flag "keep-tmp-files" (NoArg (setDynFlag Opt_KeepTmpFiles))
1173 ------- Miscellaneous ----------------------------------------------
1174 , Flag "no-auto-link-packages" (NoArg (unSetDynFlag Opt_AutoLinkPackages))
1175 , Flag "no-hs-main" (NoArg (setDynFlag Opt_NoHsMain))
1176 , Flag "with-rtsopts" (HasArg setRtsOpts)
1177 , Flag "rtsopts" (NoArg (setRtsOptsEnabled RtsOptsAll))
1178 , Flag "rtsopts=all" (NoArg (setRtsOptsEnabled RtsOptsAll))
1179 , Flag "rtsopts=some" (NoArg (setRtsOptsEnabled RtsOptsSafeOnly))
1180 , Flag "rtsopts=none" (NoArg (setRtsOptsEnabled RtsOptsNone))
1181 , Flag "no-rtsopts" (NoArg (setRtsOptsEnabled RtsOptsNone))
1182 , Flag "main-is" (SepArg setMainIs)
1183 , Flag "haddock" (NoArg (setDynFlag Opt_Haddock))
1184 , Flag "haddock-opts" (hasArg addHaddockOpts)
1185 , Flag "hpcdir" (SepArg setOptHpcDir)
1187 ------- recompilation checker --------------------------------------
1188 , Flag "recomp" (NoArg (do { unSetDynFlag Opt_ForceRecomp
1189 ; deprecate "Use -fno-force-recomp instead" }))
1190 , Flag "no-recomp" (NoArg (do { setDynFlag Opt_ForceRecomp
1191 ; deprecate "Use -fforce-recomp instead" }))
1193 ------ HsCpp opts ---------------------------------------------------
1194 , Flag "D" (AnySuffix (upd . addOptP))
1195 , Flag "U" (AnySuffix (upd . addOptP))
1197 ------- Include/Import Paths ----------------------------------------
1198 , Flag "I" (Prefix addIncludePath)
1199 , Flag "i" (OptPrefix addImportPath)
1201 ------ Debugging ----------------------------------------------------
1202 , Flag "dstg-stats" (NoArg (setDynFlag Opt_StgStats))
1204 , Flag "ddump-cmm" (setDumpFlag Opt_D_dump_cmm)
1205 , Flag "ddump-cmmz" (setDumpFlag Opt_D_dump_cmmz)
1206 , Flag "ddump-cmmz-pretty" (setDumpFlag Opt_D_dump_cmmz_pretty)
1207 , Flag "ddump-cps-cmm" (setDumpFlag Opt_D_dump_cps_cmm)
1208 , Flag "ddump-cvt-cmm" (setDumpFlag Opt_D_dump_cvt_cmm)
1209 , Flag "ddump-asm" (setDumpFlag Opt_D_dump_asm)
1210 , Flag "ddump-asm-native" (setDumpFlag Opt_D_dump_asm_native)
1211 , Flag "ddump-asm-liveness" (setDumpFlag Opt_D_dump_asm_liveness)
1212 , Flag "ddump-asm-coalesce" (setDumpFlag Opt_D_dump_asm_coalesce)
1213 , Flag "ddump-asm-regalloc" (setDumpFlag Opt_D_dump_asm_regalloc)
1214 , Flag "ddump-asm-conflicts" (setDumpFlag Opt_D_dump_asm_conflicts)
1215 , Flag "ddump-asm-regalloc-stages" (setDumpFlag Opt_D_dump_asm_regalloc_stages)
1216 , Flag "ddump-asm-stats" (setDumpFlag Opt_D_dump_asm_stats)
1217 , Flag "ddump-asm-expanded" (setDumpFlag Opt_D_dump_asm_expanded)
1218 , Flag "ddump-llvm" (NoArg (do { setObjTarget HscLlvm
1219 ; setDumpFlag' Opt_D_dump_llvm}))
1220 , Flag "ddump-cpranal" (setDumpFlag Opt_D_dump_cpranal)
1221 , Flag "ddump-deriv" (setDumpFlag Opt_D_dump_deriv)
1222 , Flag "ddump-ds" (setDumpFlag Opt_D_dump_ds)
1223 , Flag "ddump-flatC" (setDumpFlag Opt_D_dump_flatC)
1224 , Flag "ddump-foreign" (setDumpFlag Opt_D_dump_foreign)
1225 , Flag "ddump-inlinings" (setDumpFlag Opt_D_dump_inlinings)
1226 , Flag "ddump-rule-firings" (setDumpFlag Opt_D_dump_rule_firings)
1227 , Flag "ddump-occur-anal" (setDumpFlag Opt_D_dump_occur_anal)
1228 , Flag "ddump-parsed" (setDumpFlag Opt_D_dump_parsed)
1229 , Flag "ddump-rn" (setDumpFlag Opt_D_dump_rn)
1230 , Flag "ddump-simpl" (setDumpFlag Opt_D_dump_simpl)
1231 , Flag "ddump-simpl-iterations" (setDumpFlag Opt_D_dump_simpl_iterations)
1232 , Flag "ddump-simpl-phases" (OptPrefix setDumpSimplPhases)
1233 , Flag "ddump-spec" (setDumpFlag Opt_D_dump_spec)
1234 , Flag "ddump-prep" (setDumpFlag Opt_D_dump_prep)
1235 , Flag "ddump-stg" (setDumpFlag Opt_D_dump_stg)
1236 , Flag "ddump-stranal" (setDumpFlag Opt_D_dump_stranal)
1237 , Flag "ddump-tc" (setDumpFlag Opt_D_dump_tc)
1238 , Flag "ddump-types" (setDumpFlag Opt_D_dump_types)
1239 , Flag "ddump-rules" (setDumpFlag Opt_D_dump_rules)
1240 , Flag "ddump-cse" (setDumpFlag Opt_D_dump_cse)
1241 , Flag "ddump-worker-wrapper" (setDumpFlag Opt_D_dump_worker_wrapper)
1242 , Flag "ddump-rn-trace" (setDumpFlag Opt_D_dump_rn_trace)
1243 , Flag "ddump-if-trace" (setDumpFlag Opt_D_dump_if_trace)
1244 , Flag "ddump-tc-trace" (setDumpFlag Opt_D_dump_tc_trace)
1245 , Flag "ddump-splices" (setDumpFlag Opt_D_dump_splices)
1246 , Flag "ddump-rn-stats" (setDumpFlag Opt_D_dump_rn_stats)
1247 , Flag "ddump-opt-cmm" (setDumpFlag Opt_D_dump_opt_cmm)
1248 , Flag "ddump-simpl-stats" (setDumpFlag Opt_D_dump_simpl_stats)
1249 , Flag "ddump-bcos" (setDumpFlag Opt_D_dump_BCOs)
1250 , Flag "dsource-stats" (setDumpFlag Opt_D_source_stats)
1251 , Flag "dverbose-core2core" (NoArg (do { setVerbosity (Just 2)
1252 ; setVerboseCore2Core }))
1253 , Flag "dverbose-stg2stg" (setDumpFlag Opt_D_verbose_stg2stg)
1254 , Flag "ddump-hi" (setDumpFlag Opt_D_dump_hi)
1255 , Flag "ddump-minimal-imports" (setDumpFlag Opt_D_dump_minimal_imports)
1256 , Flag "ddump-vect" (setDumpFlag Opt_D_dump_vect)
1257 , Flag "ddump-hpc" (setDumpFlag Opt_D_dump_hpc)
1258 , Flag "ddump-mod-cycles" (setDumpFlag Opt_D_dump_mod_cycles)
1259 , Flag "ddump-view-pattern-commoning" (setDumpFlag Opt_D_dump_view_pattern_commoning)
1260 , Flag "ddump-to-file" (setDumpFlag Opt_DumpToFile)
1261 , Flag "ddump-hi-diffs" (setDumpFlag Opt_D_dump_hi_diffs)
1262 , Flag "ddump-rtti" (setDumpFlag Opt_D_dump_rtti)
1263 , Flag "dcore-lint" (NoArg (setDynFlag Opt_DoCoreLinting))
1264 , Flag "dstg-lint" (NoArg (setDynFlag Opt_DoStgLinting))
1265 , Flag "dcmm-lint" (NoArg (setDynFlag Opt_DoCmmLinting))
1266 , Flag "dasm-lint" (NoArg (setDynFlag Opt_DoAsmLinting))
1267 , Flag "dshow-passes" (NoArg (do forceRecompile
1268 setVerbosity (Just 2)))
1269 , Flag "dfaststring-stats" (NoArg (setDynFlag Opt_D_faststring_stats))
1271 ------ Machine dependant (-m<blah>) stuff ---------------------------
1273 , Flag "monly-2-regs" (noArg (\s -> s{stolen_x86_regs = 2}))
1274 , Flag "monly-3-regs" (noArg (\s -> s{stolen_x86_regs = 3}))
1275 , Flag "monly-4-regs" (noArg (\s -> s{stolen_x86_regs = 4}))
1276 , Flag "msse2" (NoArg (setDynFlag Opt_SSE2))
1278 ------ Warning opts -------------------------------------------------
1279 , Flag "W" (NoArg (mapM_ setDynFlag minusWOpts))
1280 , Flag "Werror" (NoArg (setDynFlag Opt_WarnIsError))
1281 , Flag "Wwarn" (NoArg (unSetDynFlag Opt_WarnIsError))
1282 , Flag "Wall" (NoArg (mapM_ setDynFlag minusWallOpts))
1283 , Flag "Wnot" (NoArg (do { mapM_ unSetDynFlag minusWallOpts
1284 ; deprecate "Use -w instead" }))
1285 , Flag "w" (NoArg (mapM_ unSetDynFlag minuswRemovesOpts))
1287 ------ Optimisation flags ------------------------------------------
1288 , Flag "O" (noArg (setOptLevel 1))
1289 , Flag "Onot" (noArgDF (setOptLevel 0) "Use -O0 instead")
1290 , Flag "Odph" (noArg setDPHOpt)
1291 , Flag "O" (OptIntSuffix (\mb_n -> upd (setOptLevel (mb_n `orElse` 1))))
1292 -- If the number is missing, use 1
1294 , Flag "fsimplifier-phases" (intSuffix (\n d -> d{ simplPhases = n }))
1295 , Flag "fmax-simplifier-iterations" (intSuffix (\n d -> d{ maxSimplIterations = n }))
1296 , Flag "fspec-constr-threshold" (intSuffix (\n d -> d{ specConstrThreshold = Just n }))
1297 , Flag "fno-spec-constr-threshold" (noArg (\d -> d{ specConstrThreshold = Nothing }))
1298 , Flag "fspec-constr-count" (intSuffix (\n d -> d{ specConstrCount = Just n }))
1299 , Flag "fno-spec-constr-count" (noArg (\d -> d{ specConstrCount = Nothing }))
1300 , Flag "fliberate-case-threshold" (intSuffix (\n d -> d{ liberateCaseThreshold = Just n }))
1301 , Flag "fno-liberate-case-threshold" (noArg (\d -> d{ liberateCaseThreshold = Nothing }))
1302 , Flag "frule-check" (SepArg (\s -> upd (\d -> d{ ruleCheck = Just s })))
1303 , Flag "fcontext-stack" (intSuffix (\n d -> d{ ctxtStkDepth = n }))
1304 , Flag "fstrictness-before" (intSuffix (\n d -> d{ strictnessBefore = n : strictnessBefore d }))
1306 ------ Profiling ----------------------------------------------------
1308 -- XXX Should the -f* flags be deprecated?
1309 -- They don't seem to be documented
1310 , Flag "fauto-sccs-on-all-toplevs" (NoArg (setDynFlag Opt_AutoSccsOnAllToplevs))
1311 , Flag "auto-all" (NoArg (setDynFlag Opt_AutoSccsOnAllToplevs))
1312 , Flag "no-auto-all" (NoArg (unSetDynFlag Opt_AutoSccsOnAllToplevs))
1313 , Flag "fauto-sccs-on-exported-toplevs" (NoArg (setDynFlag Opt_AutoSccsOnExportedToplevs))
1314 , Flag "auto" (NoArg (setDynFlag Opt_AutoSccsOnExportedToplevs))
1315 , Flag "no-auto" (NoArg (unSetDynFlag Opt_AutoSccsOnExportedToplevs))
1316 , Flag "fauto-sccs-on-individual-cafs" (NoArg (setDynFlag Opt_AutoSccsOnIndividualCafs))
1317 , Flag "caf-all" (NoArg (setDynFlag Opt_AutoSccsOnIndividualCafs))
1318 , Flag "no-caf-all" (NoArg (unSetDynFlag Opt_AutoSccsOnIndividualCafs))
1320 ------ DPH flags ----------------------------------------------------
1322 , Flag "fdph-seq" (NoArg (setDPHBackend DPHSeq))
1323 , Flag "fdph-par" (NoArg (setDPHBackend DPHPar))
1324 , Flag "fdph-this" (NoArg (setDPHBackend DPHThis))
1326 ------ Compiler flags -----------------------------------------------
1328 , Flag "fasm" (NoArg (setObjTarget HscAsm))
1329 , Flag "fvia-c" (NoArg (setObjTarget HscC >>
1330 (addWarn "The -fvia-c flag will be removed in a future GHC release")))
1331 , Flag "fvia-C" (NoArg (setObjTarget HscC >>
1332 (addWarn "The -fvia-C flag will be removed in a future GHC release")))
1333 , Flag "fllvm" (NoArg (setObjTarget HscLlvm))
1335 , Flag "fno-code" (NoArg (do upd $ \d -> d{ ghcLink=NoLink }
1336 setTarget HscNothing))
1337 , Flag "fbyte-code" (NoArg (setTarget HscInterpreted))
1338 , Flag "fobject-code" (NoArg (setTarget defaultHscTarget))
1339 , Flag "fglasgow-exts" (NoArg (enableGlasgowExts >> deprecate "Use individual extensions instead"))
1340 , Flag "fno-glasgow-exts" (NoArg (disableGlasgowExts >> deprecate "Use individual extensions instead"))
1342 ++ map (mkFlag True "f" setDynFlag ) fFlags
1343 ++ map (mkFlag False "fno-" unSetDynFlag) fFlags
1344 ++ map (mkFlag True "f" setExtensionFlag ) fLangFlags
1345 ++ map (mkFlag False "fno-" unSetExtensionFlag) fLangFlags
1346 ++ map (mkFlag True "X" setExtensionFlag ) xFlags
1347 ++ map (mkFlag False "XNo" unSetExtensionFlag) xFlags
1348 ++ map (mkFlag True "X" setLanguage) languageFlags
1350 package_flags :: [Flag (CmdLineP DynFlags)]
1352 ------- Packages ----------------------------------------------------
1353 Flag "package-conf" (HasArg extraPkgConf_)
1354 , Flag "no-user-package-conf" (NoArg (unSetDynFlag Opt_ReadUserPackageConf))
1355 , Flag "package-name" (hasArg setPackageName)
1356 , Flag "package-id" (HasArg exposePackageId)
1357 , Flag "package" (HasArg exposePackage)
1358 , Flag "hide-package" (HasArg hidePackage)
1359 , Flag "hide-all-packages" (NoArg (setDynFlag Opt_HideAllPackages))
1360 , Flag "ignore-package" (HasArg ignorePackage)
1361 , Flag "syslib" (HasArg (\s -> do { exposePackage s
1362 ; deprecate "Use -package instead" }))
1366 = ( String -- Flag in string form
1367 , flag -- Flag in internal form
1368 , Bool -> DynP ()) -- Extra action to run when the flag is found
1369 -- Typically, emit a warning or error
1370 -- True <=> we are turning the flag on
1371 -- False <=> we are turning the flag off
1374 mkFlag :: Bool -- ^ True <=> it should be turned on
1375 -> String -- ^ The flag prefix
1376 -> (flag -> DynP ()) -- ^ What to do when the flag is found
1377 -> FlagSpec flag -- ^ Specification of this particular flag
1378 -> Flag (CmdLineP DynFlags)
1379 mkFlag turnOn flagPrefix f (name, flag, extra_action)
1380 = Flag (flagPrefix ++ name) (NoArg (f flag >> extra_action turnOn))
1382 deprecatedForExtension :: String -> Bool -> DynP ()
1383 deprecatedForExtension lang turn_on
1384 = deprecate ("use -X" ++ flag ++ " or pragma {-# LANGUAGE " ++ flag ++ " #-} instead")
1386 flag | turn_on = lang
1387 | otherwise = "No"++lang
1389 useInstead :: String -> Bool -> DynP ()
1390 useInstead flag turn_on
1391 = deprecate ("Use -f" ++ no ++ flag ++ " instead")
1393 no = if turn_on then "" else "no-"
1395 nop :: Bool -> DynP ()
1398 -- | These @-f\<blah\>@ flags can all be reversed with @-fno-\<blah\>@
1399 fFlags :: [FlagSpec DynFlag]
1401 ( "warn-dodgy-foreign-imports", Opt_WarnDodgyForeignImports, nop ),
1402 ( "warn-dodgy-exports", Opt_WarnDodgyExports, nop ),
1403 ( "warn-dodgy-imports", Opt_WarnDodgyImports, nop ),
1404 ( "warn-duplicate-exports", Opt_WarnDuplicateExports, nop ),
1405 ( "warn-hi-shadowing", Opt_WarnHiShadows, nop ),
1406 ( "warn-implicit-prelude", Opt_WarnImplicitPrelude, nop ),
1407 ( "warn-incomplete-patterns", Opt_WarnIncompletePatterns, nop ),
1408 ( "warn-incomplete-record-updates", Opt_WarnIncompletePatternsRecUpd, nop ),
1409 ( "warn-missing-fields", Opt_WarnMissingFields, nop ),
1410 ( "warn-missing-import-lists", Opt_WarnMissingImportList, nop ),
1411 ( "warn-missing-methods", Opt_WarnMissingMethods, nop ),
1412 ( "warn-missing-signatures", Opt_WarnMissingSigs, nop ),
1413 ( "warn-missing-local-sigs", Opt_WarnMissingLocalSigs, nop ),
1414 ( "warn-name-shadowing", Opt_WarnNameShadowing, nop ),
1415 ( "warn-overlapping-patterns", Opt_WarnOverlappingPatterns, nop ),
1416 ( "warn-type-defaults", Opt_WarnTypeDefaults, nop ),
1417 ( "warn-monomorphism-restriction", Opt_WarnMonomorphism, nop ),
1418 ( "warn-unused-binds", Opt_WarnUnusedBinds, nop ),
1419 ( "warn-unused-imports", Opt_WarnUnusedImports, nop ),
1420 ( "warn-unused-matches", Opt_WarnUnusedMatches, nop ),
1421 ( "warn-warnings-deprecations", Opt_WarnWarningsDeprecations, nop ),
1422 ( "warn-deprecations", Opt_WarnWarningsDeprecations, nop ),
1423 ( "warn-deprecated-flags", Opt_WarnDeprecatedFlags, nop ),
1424 ( "warn-orphans", Opt_WarnOrphans, nop ),
1425 ( "warn-auto-orphans", Opt_WarnAutoOrphans, nop ),
1426 ( "warn-tabs", Opt_WarnTabs, nop ),
1427 ( "warn-unrecognised-pragmas", Opt_WarnUnrecognisedPragmas, nop ),
1428 ( "warn-lazy-unlifted-bindings", Opt_WarnLazyUnliftedBindings, nop),
1429 ( "warn-unused-do-bind", Opt_WarnUnusedDoBind, nop ),
1430 ( "warn-wrong-do-bind", Opt_WarnWrongDoBind, nop ),
1431 ( "warn-alternative-layout-rule-transitional", Opt_WarnAlternativeLayoutRuleTransitional, nop ),
1432 ( "print-explicit-foralls", Opt_PrintExplicitForalls, nop ),
1433 ( "strictness", Opt_Strictness, nop ),
1434 ( "specialise", Opt_Specialise, nop ),
1435 ( "float-in", Opt_FloatIn, nop ),
1436 ( "static-argument-transformation", Opt_StaticArgumentTransformation, nop ),
1437 ( "full-laziness", Opt_FullLaziness, nop ),
1438 ( "liberate-case", Opt_LiberateCase, nop ),
1439 ( "spec-constr", Opt_SpecConstr, nop ),
1440 ( "cse", Opt_CSE, nop ),
1441 ( "ignore-interface-pragmas", Opt_IgnoreInterfacePragmas, nop ),
1442 ( "omit-interface-pragmas", Opt_OmitInterfacePragmas, nop ),
1443 ( "expose-all-unfoldings", Opt_ExposeAllUnfoldings, nop ),
1444 ( "do-lambda-eta-expansion", Opt_DoLambdaEtaExpansion, nop ),
1445 ( "ignore-asserts", Opt_IgnoreAsserts, nop ),
1446 ( "do-eta-reduction", Opt_DoEtaReduction, nop ),
1447 ( "case-merge", Opt_CaseMerge, nop ),
1448 ( "unbox-strict-fields", Opt_UnboxStrictFields, nop ),
1449 ( "method-sharing", Opt_MethodSharing,
1450 \_ -> deprecate "doesn't do anything any more"),
1451 -- Remove altogether in GHC 7.2
1452 ( "dicts-cheap", Opt_DictsCheap, nop ),
1453 ( "excess-precision", Opt_ExcessPrecision, nop ),
1454 ( "eager-blackholing", Opt_EagerBlackHoling, nop ),
1455 ( "asm-mangling", Opt_DoAsmMangling, nop ),
1456 ( "print-bind-result", Opt_PrintBindResult, nop ),
1457 ( "force-recomp", Opt_ForceRecomp, nop ),
1458 ( "hpc-no-auto", Opt_Hpc_No_Auto, nop ),
1459 ( "rewrite-rules", Opt_EnableRewriteRules, useInstead "enable-rewrite-rules" ),
1460 ( "enable-rewrite-rules", Opt_EnableRewriteRules, nop ),
1461 ( "break-on-exception", Opt_BreakOnException, nop ),
1462 ( "break-on-error", Opt_BreakOnError, nop ),
1463 ( "print-evld-with-show", Opt_PrintEvldWithShow, nop ),
1464 ( "print-bind-contents", Opt_PrintBindContents, nop ),
1465 ( "run-cps", Opt_RunCPS, nop ),
1466 ( "run-cpsz", Opt_RunCPSZ, nop ),
1467 ( "new-codegen", Opt_TryNewCodeGen, nop ),
1468 ( "convert-to-zipper-and-back", Opt_ConvertToZipCfgAndBack, nop ),
1469 ( "vectorise", Opt_Vectorise, nop ),
1470 ( "regs-graph", Opt_RegsGraph, nop ),
1471 ( "regs-iterative", Opt_RegsIterative, nop ),
1472 ( "gen-manifest", Opt_GenManifest, nop ),
1473 ( "embed-manifest", Opt_EmbedManifest, nop ),
1474 ( "ext-core", Opt_EmitExternalCore, nop ),
1475 ( "shared-implib", Opt_SharedImplib, nop ),
1476 ( "ghci-sandbox", Opt_GhciSandbox, nop ),
1477 ( "building-cabal-package", Opt_BuildingCabalPackage, nop ),
1478 ( "implicit-import-qualified", Opt_ImplicitImportQualified, nop )
1481 -- | These @-f\<blah\>@ flags can all be reversed with @-fno-\<blah\>@
1482 fLangFlags :: [FlagSpec ExtensionFlag]
1484 ( "th", Opt_TemplateHaskell,
1485 deprecatedForExtension "TemplateHaskell" >> checkTemplateHaskellOk ),
1486 ( "fi", Opt_ForeignFunctionInterface,
1487 deprecatedForExtension "ForeignFunctionInterface" ),
1488 ( "ffi", Opt_ForeignFunctionInterface,
1489 deprecatedForExtension "ForeignFunctionInterface" ),
1490 ( "arrows", Opt_Arrows,
1491 deprecatedForExtension "Arrows" ),
1492 ( "generics", Opt_Generics,
1493 deprecatedForExtension "Generics" ),
1494 ( "implicit-prelude", Opt_ImplicitPrelude,
1495 deprecatedForExtension "ImplicitPrelude" ),
1496 ( "bang-patterns", Opt_BangPatterns,
1497 deprecatedForExtension "BangPatterns" ),
1498 ( "monomorphism-restriction", Opt_MonomorphismRestriction,
1499 deprecatedForExtension "MonomorphismRestriction" ),
1500 ( "mono-pat-binds", Opt_MonoPatBinds,
1501 deprecatedForExtension "MonoPatBinds" ),
1502 ( "extended-default-rules", Opt_ExtendedDefaultRules,
1503 deprecatedForExtension "ExtendedDefaultRules" ),
1504 ( "implicit-params", Opt_ImplicitParams,
1505 deprecatedForExtension "ImplicitParams" ),
1506 ( "scoped-type-variables", Opt_ScopedTypeVariables,
1507 deprecatedForExtension "ScopedTypeVariables" ),
1509 deprecatedForExtension "PArr" ),
1510 ( "allow-overlapping-instances", Opt_OverlappingInstances,
1511 deprecatedForExtension "OverlappingInstances" ),
1512 ( "allow-undecidable-instances", Opt_UndecidableInstances,
1513 deprecatedForExtension "UndecidableInstances" ),
1514 ( "allow-incoherent-instances", Opt_IncoherentInstances,
1515 deprecatedForExtension "IncoherentInstances" )
1518 supportedLanguages :: [String]
1519 supportedLanguages = [ name | (name, _, _) <- languageFlags ]
1521 supportedExtensions :: [String]
1522 supportedExtensions = [ name' | (name, _, _) <- xFlags, name' <- [name, "No" ++ name] ]
1524 supportedLanguagesAndExtensions :: [String]
1525 supportedLanguagesAndExtensions = supportedLanguages ++ supportedExtensions
1527 -- | These -X<blah> flags cannot be reversed with -XNo<blah>
1528 languageFlags :: [FlagSpec Language]
1530 ( "Haskell98", Haskell98, nop ),
1531 ( "Haskell2010", Haskell2010, nop )
1534 -- | These -X<blah> flags can all be reversed with -XNo<blah>
1535 xFlags :: [FlagSpec ExtensionFlag]
1537 ( "CPP", Opt_Cpp, nop ),
1538 ( "PostfixOperators", Opt_PostfixOperators, nop ),
1539 ( "TupleSections", Opt_TupleSections, nop ),
1540 ( "PatternGuards", Opt_PatternGuards, nop ),
1541 ( "UnicodeSyntax", Opt_UnicodeSyntax, nop ),
1542 ( "MagicHash", Opt_MagicHash, nop ),
1543 ( "PolymorphicComponents", Opt_PolymorphicComponents, nop ),
1544 ( "ExistentialQuantification", Opt_ExistentialQuantification, nop ),
1545 ( "KindSignatures", Opt_KindSignatures, nop ),
1546 ( "EmptyDataDecls", Opt_EmptyDataDecls, nop ),
1547 ( "ParallelListComp", Opt_ParallelListComp, nop ),
1548 ( "TransformListComp", Opt_TransformListComp, nop ),
1549 ( "ForeignFunctionInterface", Opt_ForeignFunctionInterface, nop ),
1550 ( "UnliftedFFITypes", Opt_UnliftedFFITypes, nop ),
1551 ( "GHCForeignImportPrim", Opt_GHCForeignImportPrim, nop ),
1552 ( "LiberalTypeSynonyms", Opt_LiberalTypeSynonyms, nop ),
1553 ( "Rank2Types", Opt_Rank2Types, nop ),
1554 ( "RankNTypes", Opt_RankNTypes, nop ),
1555 ( "ImpredicativeTypes", Opt_ImpredicativeTypes, nop),
1556 ( "TypeOperators", Opt_TypeOperators, nop ),
1557 ( "RecursiveDo", Opt_RecursiveDo,
1558 deprecatedForExtension "DoRec"),
1559 ( "DoRec", Opt_DoRec, nop ),
1560 ( "Arrows", Opt_Arrows, nop ),
1561 ( "PArr", Opt_PArr, nop ),
1562 ( "TemplateHaskell", Opt_TemplateHaskell, checkTemplateHaskellOk ),
1563 ( "QuasiQuotes", Opt_QuasiQuotes, nop ),
1564 ( "Generics", Opt_Generics, nop ),
1565 ( "ImplicitPrelude", Opt_ImplicitPrelude, nop ),
1566 ( "RecordWildCards", Opt_RecordWildCards, nop ),
1567 ( "NamedFieldPuns", Opt_RecordPuns, nop ),
1568 ( "RecordPuns", Opt_RecordPuns,
1569 deprecatedForExtension "NamedFieldPuns" ),
1570 ( "DisambiguateRecordFields", Opt_DisambiguateRecordFields, nop ),
1571 ( "OverloadedStrings", Opt_OverloadedStrings, nop ),
1572 ( "GADTs", Opt_GADTs, nop ),
1573 ( "ViewPatterns", Opt_ViewPatterns, nop ),
1574 ( "TypeFamilies", Opt_TypeFamilies, nop ),
1575 ( "BangPatterns", Opt_BangPatterns, nop ),
1576 ( "MonomorphismRestriction", Opt_MonomorphismRestriction, nop ),
1577 ( "NPlusKPatterns", Opt_NPlusKPatterns, nop ),
1578 ( "DoAndIfThenElse", Opt_DoAndIfThenElse, nop ),
1579 ( "RebindableSyntax", Opt_RebindableSyntax, nop ),
1580 ( "MonoPatBinds", Opt_MonoPatBinds, nop ),
1581 ( "ExplicitForAll", Opt_ExplicitForAll, nop ),
1582 ( "AlternativeLayoutRule", Opt_AlternativeLayoutRule, nop ),
1583 ( "AlternativeLayoutRuleTransitional",Opt_AlternativeLayoutRuleTransitional, nop ),
1584 ( "DatatypeContexts", Opt_DatatypeContexts, nop ),
1585 ( "MonoLocalBinds", Opt_MonoLocalBinds, nop ),
1586 ( "RelaxedPolyRec", Opt_RelaxedPolyRec,
1587 \ turn_on -> if not turn_on
1588 then deprecate "You can't turn off RelaxedPolyRec any more"
1590 ( "ExtendedDefaultRules", Opt_ExtendedDefaultRules, nop ),
1591 ( "ImplicitParams", Opt_ImplicitParams, nop ),
1592 ( "ScopedTypeVariables", Opt_ScopedTypeVariables, nop ),
1594 ( "PatternSignatures", Opt_ScopedTypeVariables,
1595 deprecatedForExtension "ScopedTypeVariables" ),
1597 ( "UnboxedTuples", Opt_UnboxedTuples, nop ),
1598 ( "StandaloneDeriving", Opt_StandaloneDeriving, nop ),
1599 ( "DeriveDataTypeable", Opt_DeriveDataTypeable, nop ),
1600 ( "DeriveFunctor", Opt_DeriveFunctor, nop ),
1601 ( "DeriveTraversable", Opt_DeriveTraversable, nop ),
1602 ( "DeriveFoldable", Opt_DeriveFoldable, nop ),
1603 ( "TypeSynonymInstances", Opt_TypeSynonymInstances, nop ),
1604 ( "FlexibleContexts", Opt_FlexibleContexts, nop ),
1605 ( "FlexibleInstances", Opt_FlexibleInstances, nop ),
1606 ( "ConstrainedClassMethods", Opt_ConstrainedClassMethods, nop ),
1607 ( "MultiParamTypeClasses", Opt_MultiParamTypeClasses, nop ),
1608 ( "FunctionalDependencies", Opt_FunctionalDependencies, nop ),
1609 ( "GeneralizedNewtypeDeriving", Opt_GeneralizedNewtypeDeriving, nop ),
1610 ( "OverlappingInstances", Opt_OverlappingInstances, nop ),
1611 ( "UndecidableInstances", Opt_UndecidableInstances, nop ),
1612 ( "IncoherentInstances", Opt_IncoherentInstances, nop ),
1613 ( "PackageImports", Opt_PackageImports, nop ),
1614 ( "NewQualifiedOperators", Opt_NewQualifiedOperators,
1615 \_ -> deprecate "The new qualified operator syntax was rejected by Haskell'" )
1618 defaultFlags :: [DynFlag]
1620 = [ Opt_AutoLinkPackages,
1621 Opt_ReadUserPackageConf,
1629 Opt_PrintBindContents,
1633 ++ [f | (ns,f) <- optLevelFlags, 0 `elem` ns]
1634 -- The default -O0 options
1638 impliedFlags :: [(ExtensionFlag, ExtensionFlag)]
1640 = [ (Opt_RankNTypes, Opt_ExplicitForAll)
1641 , (Opt_Rank2Types, Opt_ExplicitForAll)
1642 , (Opt_ScopedTypeVariables, Opt_ExplicitForAll)
1643 , (Opt_LiberalTypeSynonyms, Opt_ExplicitForAll)
1644 , (Opt_ExistentialQuantification, Opt_ExplicitForAll)
1645 , (Opt_PolymorphicComponents, Opt_ExplicitForAll)
1647 , (Opt_RebindableSyntax, Opt_ImplicitPrelude)
1649 , (Opt_GADTs, Opt_MonoLocalBinds)
1650 , (Opt_TypeFamilies, Opt_MonoLocalBinds)
1652 , (Opt_TypeFamilies, Opt_KindSignatures) -- Type families use kind signatures
1653 -- all over the place
1655 , (Opt_ImpredicativeTypes, Opt_RankNTypes)
1657 -- Record wild-cards implies field disambiguation
1658 -- Otherwise if you write (C {..}) you may well get
1659 -- stuff like " 'a' not in scope ", which is a bit silly
1660 -- if the compiler has just filled in field 'a' of constructor 'C'
1661 , (Opt_RecordWildCards, Opt_DisambiguateRecordFields)
1664 optLevelFlags :: [([Int], DynFlag)]
1666 = [ ([0], Opt_IgnoreInterfacePragmas)
1667 , ([0], Opt_OmitInterfacePragmas)
1669 , ([1,2], Opt_IgnoreAsserts)
1670 , ([1,2], Opt_EnableRewriteRules) -- Off for -O0; see Note [Scoping for Builtin rules]
1672 , ([1,2], Opt_DoEtaReduction)
1673 , ([1,2], Opt_CaseMerge)
1674 , ([1,2], Opt_Strictness)
1676 , ([1,2], Opt_FullLaziness)
1677 , ([1,2], Opt_Specialise)
1678 , ([1,2], Opt_FloatIn)
1680 , ([2], Opt_LiberateCase)
1681 , ([2], Opt_SpecConstr)
1682 , ([2], Opt_RegsGraph)
1684 -- , ([2], Opt_StaticArgumentTransformation)
1685 -- Max writes: I think it's probably best not to enable SAT with -O2 for the
1686 -- 6.10 release. The version of SAT in HEAD at the moment doesn't incorporate
1687 -- several improvements to the heuristics, and I'm concerned that without
1688 -- those changes SAT will interfere with some attempts to write "high
1689 -- performance Haskell", as we saw in some posts on Haskell-Cafe earlier
1690 -- this year. In particular, the version in HEAD lacks the tail call
1691 -- criterion, so many things that look like reasonable loops will be
1692 -- turned into functions with extra (unneccesary) thunk creation.
1694 , ([0,1,2], Opt_DoLambdaEtaExpansion)
1695 -- This one is important for a tiresome reason:
1696 -- we want to make sure that the bindings for data
1697 -- constructors are eta-expanded. This is probably
1698 -- a good thing anyway, but it seems fragile.
1701 -- -----------------------------------------------------------------------------
1702 -- Standard sets of warning options
1704 standardWarnings :: [DynFlag]
1706 = [ Opt_WarnWarningsDeprecations,
1707 Opt_WarnDeprecatedFlags,
1708 Opt_WarnUnrecognisedPragmas,
1709 Opt_WarnOverlappingPatterns,
1710 Opt_WarnMissingFields,
1711 Opt_WarnMissingMethods,
1712 Opt_WarnDuplicateExports,
1713 Opt_WarnLazyUnliftedBindings,
1714 Opt_WarnDodgyForeignImports,
1715 Opt_WarnWrongDoBind,
1716 Opt_WarnAlternativeLayoutRuleTransitional
1719 minusWOpts :: [DynFlag]
1721 = standardWarnings ++
1722 [ Opt_WarnUnusedBinds,
1723 Opt_WarnUnusedMatches,
1724 Opt_WarnUnusedImports,
1725 Opt_WarnIncompletePatterns,
1726 Opt_WarnDodgyExports,
1727 Opt_WarnDodgyImports
1730 minusWallOpts :: [DynFlag]
1733 [ Opt_WarnTypeDefaults,
1734 Opt_WarnNameShadowing,
1735 Opt_WarnMissingSigs,
1738 Opt_WarnUnusedDoBind
1741 -- minuswRemovesOpts should be every warning option
1742 minuswRemovesOpts :: [DynFlag]
1745 [Opt_WarnImplicitPrelude,
1746 Opt_WarnIncompletePatternsRecUpd,
1747 Opt_WarnMonomorphism,
1748 Opt_WarnUnrecognisedPragmas,
1749 Opt_WarnAutoOrphans,
1753 enableGlasgowExts :: DynP ()
1754 enableGlasgowExts = do setDynFlag Opt_PrintExplicitForalls
1755 mapM_ setExtensionFlag glasgowExtsFlags
1757 disableGlasgowExts :: DynP ()
1758 disableGlasgowExts = do unSetDynFlag Opt_PrintExplicitForalls
1759 mapM_ unSetExtensionFlag glasgowExtsFlags
1761 glasgowExtsFlags :: [ExtensionFlag]
1762 glasgowExtsFlags = [
1763 Opt_ForeignFunctionInterface
1764 , Opt_UnliftedFFITypes
1765 , Opt_ImplicitParams
1766 , Opt_ScopedTypeVariables
1768 , Opt_TypeSynonymInstances
1769 , Opt_StandaloneDeriving
1770 , Opt_DeriveDataTypeable
1772 , Opt_DeriveFoldable
1773 , Opt_DeriveTraversable
1774 , Opt_FlexibleContexts
1775 , Opt_FlexibleInstances
1776 , Opt_ConstrainedClassMethods
1777 , Opt_MultiParamTypeClasses
1778 , Opt_FunctionalDependencies
1780 , Opt_PolymorphicComponents
1781 , Opt_ExistentialQuantification
1783 , Opt_PostfixOperators
1785 , Opt_LiberalTypeSynonyms
1789 , Opt_ParallelListComp
1790 , Opt_EmptyDataDecls
1791 , Opt_KindSignatures
1792 , Opt_GeneralizedNewtypeDeriving ]
1795 -- Consult the RTS to find whether GHC itself has been built profiled
1796 -- If so, you can't use Template Haskell
1797 foreign import ccall unsafe "rts_isProfiled" rtsIsProfiledIO :: IO CInt
1799 rtsIsProfiled :: Bool
1800 rtsIsProfiled = unsafePerformIO rtsIsProfiledIO /= 0
1802 checkTemplateHaskellOk :: Bool -> DynP ()
1803 checkTemplateHaskellOk turn_on
1804 | turn_on && rtsIsProfiled
1805 = addErr "You can't use Template Haskell with a profiled compiler"
1809 -- In stage 1 we don't know that the RTS has rts_isProfiled,
1810 -- so we simply say "ok". It doesn't matter because TH isn't
1811 -- available in stage 1 anyway.
1812 checkTemplateHaskellOk turn_on = return ()
1815 {- **********************************************************************
1817 DynFlags constructors
1819 %********************************************************************* -}
1821 type DynP = EwM (CmdLineP DynFlags)
1823 upd :: (DynFlags -> DynFlags) -> DynP ()
1824 upd f = liftEwM (do { dfs <- getCmdLineState
1825 ; putCmdLineState $! (f dfs) })
1827 --------------- Constructor functions for OptKind -----------------
1828 noArg :: (DynFlags -> DynFlags) -> OptKind (CmdLineP DynFlags)
1829 noArg fn = NoArg (upd fn)
1831 noArgDF :: (DynFlags -> DynFlags) -> String -> OptKind (CmdLineP DynFlags)
1832 noArgDF fn deprec = NoArg (upd fn >> deprecate deprec)
1834 hasArg :: (String -> DynFlags -> DynFlags) -> OptKind (CmdLineP DynFlags)
1835 hasArg fn = HasArg (upd . fn)
1837 hasArgDF :: (String -> DynFlags -> DynFlags) -> String -> OptKind (CmdLineP DynFlags)
1838 hasArgDF fn deprec = HasArg (\s -> do { upd (fn s)
1839 ; deprecate deprec })
1841 intSuffix :: (Int -> DynFlags -> DynFlags) -> OptKind (CmdLineP DynFlags)
1842 intSuffix fn = IntSuffix (\n -> upd (fn n))
1844 setDumpFlag :: DynFlag -> OptKind (CmdLineP DynFlags)
1845 setDumpFlag dump_flag = NoArg (setDumpFlag' dump_flag)
1847 --------------------------
1848 setDynFlag, unSetDynFlag :: DynFlag -> DynP ()
1849 setDynFlag f = upd (\dfs -> dopt_set dfs f)
1850 unSetDynFlag f = upd (\dfs -> dopt_unset dfs f)
1852 --------------------------
1853 setExtensionFlag, unSetExtensionFlag :: ExtensionFlag -> DynP ()
1854 setExtensionFlag f = do { upd (\dfs -> xopt_set dfs f)
1855 ; mapM_ setExtensionFlag deps }
1857 deps = [ d | (f', d) <- impliedFlags, f' == f ]
1858 -- When you set f, set the ones it implies
1859 -- NB: use setExtensionFlag recursively, in case the implied flags
1860 -- implies further flags
1861 -- When you un-set f, however, we don't un-set the things it implies
1862 -- (except for -fno-glasgow-exts, which is treated specially)
1864 unSetExtensionFlag f = upd (\dfs -> xopt_unset dfs f)
1866 --------------------------
1867 setDumpFlag' :: DynFlag -> DynP ()
1868 setDumpFlag' dump_flag
1869 = do { setDynFlag dump_flag
1870 ; when want_recomp forceRecompile }
1872 -- Certain dumpy-things are really interested in what's going
1873 -- on during recompilation checking, so in those cases we
1874 -- don't want to turn it off.
1875 want_recomp = dump_flag `notElem` [Opt_D_dump_if_trace,
1876 Opt_D_dump_hi_diffs]
1878 forceRecompile :: DynP ()
1879 -- Whenver we -ddump, force recompilation (by switching off the
1880 -- recompilation checker), else you don't see the dump! However,
1881 -- don't switch it off in --make mode, else *everything* gets
1882 -- recompiled which probably isn't what you want
1883 forceRecompile = do { dfs <- liftEwM getCmdLineState
1884 ; when (force_recomp dfs) (setDynFlag Opt_ForceRecomp) }
1886 force_recomp dfs = isOneShot (ghcMode dfs)
1888 setVerboseCore2Core :: DynP ()
1889 setVerboseCore2Core = do forceRecompile
1890 setDynFlag Opt_D_verbose_core2core
1891 upd (\dfs -> dfs { shouldDumpSimplPhase = Nothing })
1894 setDumpSimplPhases :: String -> DynP ()
1895 setDumpSimplPhases s = do forceRecompile
1896 upd (\dfs -> dfs { shouldDumpSimplPhase = Just spec })
1898 spec = case s of { ('=' : s') -> s'; _ -> s }
1900 setVerbosity :: Maybe Int -> DynP ()
1901 setVerbosity mb_n = upd (\dfs -> dfs{ verbosity = mb_n `orElse` 3 })
1903 addCmdlineHCInclude :: String -> DynP ()
1904 addCmdlineHCInclude a = upd (\s -> s{cmdlineHcIncludes = a : cmdlineHcIncludes s})
1906 extraPkgConf_ :: FilePath -> DynP ()
1907 extraPkgConf_ p = upd (\s -> s{ extraPkgConfs = p : extraPkgConfs s })
1909 exposePackage, exposePackageId, hidePackage, ignorePackage :: String -> DynP ()
1911 upd (\s -> s{ packageFlags = ExposePackage p : packageFlags s })
1913 upd (\s -> s{ packageFlags = ExposePackageId p : packageFlags s })
1915 upd (\s -> s{ packageFlags = HidePackage p : packageFlags s })
1917 upd (\s -> s{ packageFlags = IgnorePackage p : packageFlags s })
1919 setPackageName :: String -> DynFlags -> DynFlags
1920 setPackageName p s = s{ thisPackage = stringToPackageId p }
1922 -- If we're linking a binary, then only targets that produce object
1923 -- code are allowed (requests for other target types are ignored).
1924 setTarget :: HscTarget -> DynP ()
1925 setTarget l = upd set
1928 | ghcLink dfs /= LinkBinary || isObjectTarget l = dfs{ hscTarget = l }
1931 -- Changes the target only if we're compiling object code. This is
1932 -- used by -fasm and -fvia-C, which switch from one to the other, but
1933 -- not from bytecode to object-code. The idea is that -fasm/-fvia-C
1934 -- can be safely used in an OPTIONS_GHC pragma.
1935 setObjTarget :: HscTarget -> DynP ()
1936 setObjTarget l = upd set
1939 | isObjectTarget (hscTarget dfs) = dfs { hscTarget = l }
1942 setOptLevel :: Int -> DynFlags -> DynFlags
1943 setOptLevel n dflags
1944 | hscTarget dflags == HscInterpreted && n > 0
1946 -- not in IO any more, oh well:
1947 -- putStr "warning: -O conflicts with --interactive; -O ignored.\n"
1949 = updOptLevel n dflags
1952 -- -Odph is equivalent to
1954 -- -O2 optimise as much as possible
1955 -- -fno-method-sharing sharing specialisation defeats fusion
1957 -- -fdicts-cheap always inline dictionaries
1958 -- -fmax-simplifier-iterations20 this is necessary sometimes
1959 -- -fsimplifier-phases=3 we use an additional simplifier phase
1961 -- -fno-spec-constr-threshold run SpecConstr even for big loops
1962 -- -fno-spec-constr-count SpecConstr as much as possible
1963 -- -finline-enough-args hack to prevent excessive inlining
1965 setDPHOpt :: DynFlags -> DynFlags
1966 setDPHOpt dflags = setOptLevel 2 (dflags { maxSimplIterations = 20
1968 , specConstrThreshold = Nothing
1969 , specConstrCount = Nothing
1971 `dopt_set` Opt_DictsCheap
1973 data DPHBackend = DPHPar
1976 deriving(Eq, Ord, Enum, Show)
1978 setDPHBackend :: DPHBackend -> DynP ()
1979 setDPHBackend backend
1981 upd $ \dflags -> dflags { dphBackend = backend }
1982 mapM_ exposePackage (dph_packages backend)
1984 dph_packages DPHThis = []
1985 dph_packages DPHPar = ["dph-prim-par", "dph-par"]
1986 dph_packages DPHSeq = ["dph-prim-seq", "dph-seq"]
1988 dphPackage :: DynFlags -> PackageId
1989 dphPackage dflags = case dphBackend dflags of
1990 DPHPar -> dphParPackageId
1991 DPHSeq -> dphSeqPackageId
1992 DPHThis -> thisPackage dflags
1994 setMainIs :: String -> DynP ()
1996 | not (null main_fn) && isLower (head main_fn)
1997 -- The arg looked like "Foo.Bar.baz"
1998 = upd $ \d -> d{ mainFunIs = Just main_fn,
1999 mainModIs = mkModule mainPackageId (mkModuleName main_mod) }
2001 | isUpper (head arg) -- The arg looked like "Foo" or "Foo.Bar"
2002 = upd $ \d -> d{ mainModIs = mkModule mainPackageId (mkModuleName arg) }
2004 | otherwise -- The arg looked like "baz"
2005 = upd $ \d -> d{ mainFunIs = Just arg }
2007 (main_mod, main_fn) = splitLongestPrefix arg (== '.')
2009 -----------------------------------------------------------------------------
2010 -- Paths & Libraries
2012 addImportPath, addLibraryPath, addIncludePath, addFrameworkPath :: FilePath -> DynP ()
2014 -- -i on its own deletes the import paths
2015 addImportPath "" = upd (\s -> s{importPaths = []})
2016 addImportPath p = upd (\s -> s{importPaths = importPaths s ++ splitPathList p})
2020 upd (\s -> s{libraryPaths = libraryPaths s ++ splitPathList p})
2023 upd (\s -> s{includePaths = includePaths s ++ splitPathList p})
2025 addFrameworkPath p =
2026 upd (\s -> s{frameworkPaths = frameworkPaths s ++ splitPathList p})
2028 #ifndef mingw32_TARGET_OS
2029 split_marker :: Char
2030 split_marker = ':' -- not configurable (ToDo)
2033 splitPathList :: String -> [String]
2034 splitPathList s = filter notNull (splitUp s)
2035 -- empty paths are ignored: there might be a trailing
2036 -- ':' in the initial list, for example. Empty paths can
2037 -- cause confusion when they are translated into -I options
2038 -- for passing to gcc.
2040 #ifndef mingw32_TARGET_OS
2041 splitUp xs = split split_marker xs
2043 -- Windows: 'hybrid' support for DOS-style paths in directory lists.
2045 -- That is, if "foo:bar:baz" is used, this interpreted as
2046 -- consisting of three entries, 'foo', 'bar', 'baz'.
2047 -- However, with "c:/foo:c:\\foo;x:/bar", this is interpreted
2048 -- as 3 elts, "c:/foo", "c:\\foo", "x:/bar"
2050 -- Notice that no attempt is made to fully replace the 'standard'
2051 -- split marker ':' with the Windows / DOS one, ';'. The reason being
2052 -- that this will cause too much breakage for users & ':' will
2053 -- work fine even with DOS paths, if you're not insisting on being silly.
2056 splitUp (x:':':div:xs) | div `elem` dir_markers
2057 = ((x:':':div:p): splitUp rs)
2059 (p,rs) = findNextPath xs
2060 -- we used to check for existence of the path here, but that
2061 -- required the IO monad to be threaded through the command-line
2062 -- parser which is quite inconvenient. The
2063 splitUp xs = cons p (splitUp rs)
2065 (p,rs) = findNextPath xs
2070 -- will be called either when we've consumed nought or the
2071 -- "<Drive>:/" part of a DOS path, so splitting is just a Q of
2072 -- finding the next split marker.
2074 case break (`elem` split_markers) xs of
2075 (p, _:ds) -> (p, ds)
2078 split_markers :: [Char]
2079 split_markers = [':', ';']
2081 dir_markers :: [Char]
2082 dir_markers = ['/', '\\']
2085 -- -----------------------------------------------------------------------------
2086 -- tmpDir, where we store temporary files.
2088 setTmpDir :: FilePath -> DynFlags -> DynFlags
2089 setTmpDir dir dflags = dflags{ tmpDir = normalise dir }
2090 -- we used to fix /cygdrive/c/.. on Windows, but this doesn't
2091 -- seem necessary now --SDM 7/2/2008
2093 -----------------------------------------------------------------------------
2096 setRtsOpts :: String -> DynP ()
2097 setRtsOpts arg = upd $ \ d -> d {rtsOpts = Just arg}
2099 setRtsOptsEnabled :: RtsOptsEnabled -> DynP ()
2100 setRtsOptsEnabled arg = upd $ \ d -> d {rtsOptsEnabled = arg}
2102 -----------------------------------------------------------------------------
2105 setOptHpcDir :: String -> DynP ()
2106 setOptHpcDir arg = upd $ \ d -> d{hpcDir = arg}
2108 -----------------------------------------------------------------------------
2109 -- Via-C compilation stuff
2111 -- There are some options that we need to pass to gcc when compiling
2112 -- Haskell code via C, but are only supported by recent versions of
2113 -- gcc. The configure script decides which of these options we need,
2114 -- and puts them in the file "extra-gcc-opts" in $topdir, which is
2115 -- read before each via-C compilation. The advantage of having these
2116 -- in a separate file is that the file can be created at install-time
2117 -- depending on the available gcc version, and even re-generated later
2118 -- if gcc is upgraded.
2120 -- The options below are not dependent on the version of gcc, only the
2123 machdepCCOpts :: DynFlags -> ([String], -- flags for all C compilations
2124 [String]) -- for registerised HC compilations
2125 machdepCCOpts dflags = let (flagsAll, flagsRegHc) = machdepCCOpts' dflags
2126 in (cCcOpts ++ flagsAll, flagsRegHc)
2128 machdepCCOpts' :: DynFlags -> ([String], -- flags for all C compilations
2129 [String]) -- for registerised HC compilations
2130 machdepCCOpts' _dflags
2131 #if alpha_TARGET_ARCH
2133 #ifdef HAVE_THREADED_RTS_SUPPORT
2137 -- For now, to suppress the gcc warning "call-clobbered
2138 -- register used for global register variable", we simply
2139 -- disable all warnings altogether using the -w flag. Oh well.
2141 #elif hppa_TARGET_ARCH
2142 -- ___HPUX_SOURCE, not _HPUX_SOURCE, is #defined if -ansi!
2143 -- (very nice, but too bad the HP /usr/include files don't agree.)
2144 = ( ["-D_HPUX_SOURCE"], [] )
2146 #elif m68k_TARGET_ARCH
2147 -- -fno-defer-pop : for the .hc files, we want all the pushing/
2148 -- popping of args to routines to be explicit; if we let things
2149 -- be deferred 'til after an STGJUMP, imminent death is certain!
2151 -- -fomit-frame-pointer : *don't*
2152 -- It's better to have a6 completely tied up being a frame pointer
2153 -- rather than let GCC pick random things to do with it.
2154 -- (If we want to steal a6, then we would try to do things
2155 -- as on iX86, where we *do* steal the frame pointer [%ebp].)
2156 = ( [], ["-fno-defer-pop", "-fno-omit-frame-pointer"] )
2158 #elif i386_TARGET_ARCH
2159 -- -fno-defer-pop : basically the same game as for m68k
2161 -- -fomit-frame-pointer : *must* in .hc files; because we're stealing
2162 -- the fp (%ebp) for our register maps.
2163 = let n_regs = stolen_x86_regs _dflags
2166 [ if opt_Static then "-DDONT_WANT_WIN32_DLL_SUPPORT" else ""
2169 "-fomit-frame-pointer",
2170 -- we want -fno-builtin, because when gcc inlines
2171 -- built-in functions like memcpy() it tends to
2172 -- run out of registers, requiring -monly-n-regs
2174 "-DSTOLEN_X86_REGS="++show n_regs ]
2177 #elif ia64_TARGET_ARCH
2178 = ( [], ["-fomit-frame-pointer", "-G0"] )
2180 #elif x86_64_TARGET_ARCH
2183 ["-fomit-frame-pointer",
2184 "-fno-asynchronous-unwind-tables",
2185 -- the unwind tables are unnecessary for HC code,
2186 -- and get in the way of -split-objs. Another option
2187 -- would be to throw them away in the mangler, but this
2190 -- calling builtins like strlen() using the FFI can
2191 -- cause gcc to run out of regs, so use the external
2195 #elif sparc_TARGET_ARCH
2197 -- For now, to suppress the gcc warning "call-clobbered
2198 -- register used for global register variable", we simply
2199 -- disable all warnings altogether using the -w flag. Oh well.
2201 #elif powerpc_apple_darwin_TARGET
2203 -- Disable Apple's precompiling preprocessor. It's a great thing
2204 -- for "normal" programs, but it doesn't support register variable
2206 = ( [], ["-no-cpp-precomp"] )
2211 picCCOpts :: DynFlags -> [String]
2213 #if darwin_TARGET_OS
2214 -- Apple prefers to do things the other way round.
2215 -- PIC is on by default.
2216 -- -mdynamic-no-pic:
2217 -- Turn off PIC code generation.
2219 -- Don't generate "common" symbols - these are unwanted
2220 -- in dynamic libraries.
2223 = ["-fno-common", "-U __PIC__","-D__PIC__"]
2225 = ["-mdynamic-no-pic"]
2226 #elif mingw32_TARGET_OS
2227 -- no -fPIC for Windows
2229 = ["-U __PIC__","-D__PIC__"]
2233 -- we need -fPIC for C files when we are compiling with -dynamic,
2234 -- otherwise things like stub.c files don't get compiled
2235 -- correctly. They need to reference data in the Haskell
2236 -- objects, but can't without -fPIC. See
2237 -- http://hackage.haskell.org/trac/ghc/wiki/Commentary/PositionIndependentCode
2238 | opt_PIC || not opt_Static
2239 = ["-fPIC", "-U __PIC__", "-D__PIC__"]
2244 -- -----------------------------------------------------------------------------
2248 can_split = cSplitObjs == "YES"
2250 -- -----------------------------------------------------------------------------
2253 data Printable = String String
2254 | FromDynFlags (DynFlags -> String)
2256 compilerInfo :: [(String, Printable)]
2257 compilerInfo = [("Project name", String cProjectName),
2258 ("Project version", String cProjectVersion),
2259 ("Booter version", String cBooterVersion),
2260 ("Stage", String cStage),
2261 ("Build platform", String cBuildPlatform),
2262 ("Host platform", String cHostPlatform),
2263 ("Target platform", String cTargetPlatform),
2264 ("Have interpreter", String cGhcWithInterpreter),
2265 ("Object splitting", String cSplitObjs),
2266 ("Have native code generator", String cGhcWithNativeCodeGen),
2267 ("Have llvm code generator", String cGhcWithLlvmCodeGen),
2268 ("Use archives for ghci", String (show cUseArchivesForGhci)),
2269 ("Support SMP", String cGhcWithSMP),
2270 ("Unregisterised", String cGhcUnregisterised),
2271 ("Tables next to code", String cGhcEnableTablesNextToCode),
2272 ("RTS ways", String cGhcRTSWays),
2273 ("Leading underscore", String cLeadingUnderscore),
2274 ("Debug on", String (show debugIsOn)),
2275 ("LibDir", FromDynFlags topDir),
2276 ("Global Package DB", FromDynFlags systemPackageConfig)