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"
83 import PrelNames ( mAIN )
85 import {-# SOURCE #-} Packages (PackageState)
86 import DriverPhases ( Phase(..), phaseInputExt )
89 import Constants ( mAX_CONTEXT_REDUCTION_DEPTH )
92 import Maybes ( orElse )
97 import Foreign.C ( CInt )
99 import {-# SOURCE #-} ErrUtils ( Severity(..), Message, mkLocMessage )
102 import System.IO.Unsafe ( unsafePerformIO )
105 import Control.Monad ( when )
109 import Data.Map (Map)
110 import qualified Data.Map as Map
111 import System.FilePath
112 import System.IO ( stderr, hPutChar )
114 -- -----------------------------------------------------------------------------
117 -- | Enumerates the simple on-or-off dynamic flags
124 | Opt_D_dump_cmmz_pretty
128 | Opt_D_dump_asm_native
129 | Opt_D_dump_asm_liveness
130 | Opt_D_dump_asm_coalesce
131 | Opt_D_dump_asm_regalloc
132 | Opt_D_dump_asm_regalloc_stages
133 | Opt_D_dump_asm_conflicts
134 | Opt_D_dump_asm_stats
135 | Opt_D_dump_asm_expanded
137 | Opt_D_dump_core_stats
143 | Opt_D_dump_inlinings
144 | Opt_D_dump_rule_firings
145 | Opt_D_dump_rule_rewrites
146 | Opt_D_dump_occur_anal
150 | Opt_D_dump_simpl_iterations
151 | Opt_D_dump_simpl_phases
160 | Opt_D_dump_worker_wrapper
161 | Opt_D_dump_rn_trace
162 | Opt_D_dump_rn_stats
164 | Opt_D_dump_simpl_stats
165 | Opt_D_dump_cs_trace -- Constraint solver in type checker
166 | Opt_D_dump_tc_trace
167 | Opt_D_dump_if_trace
168 | Opt_D_dump_vt_trace
175 | Opt_D_verbose_core2core
176 | Opt_D_verbose_stg2stg
178 | Opt_D_dump_hi_diffs
179 | Opt_D_dump_minimal_imports
180 | Opt_D_dump_mod_cycles
181 | Opt_D_dump_view_pattern_commoning
182 | Opt_D_faststring_stats
183 | Opt_DumpToFile -- ^ Append dump output to files instead of stdout.
184 | Opt_D_no_debug_output
190 | Opt_WarnIsError -- -Werror; makes warnings fatal
191 | Opt_WarnDuplicateExports
193 | Opt_WarnImplicitPrelude
194 | Opt_WarnIncompletePatterns
195 | Opt_WarnIncompleteUniPatterns
196 | Opt_WarnIncompletePatternsRecUpd
197 | Opt_WarnMissingFields
198 | Opt_WarnMissingImportList
199 | Opt_WarnMissingMethods
200 | Opt_WarnMissingSigs
201 | Opt_WarnMissingLocalSigs
202 | Opt_WarnNameShadowing
203 | Opt_WarnOverlappingPatterns
204 | Opt_WarnTypeDefaults
205 | Opt_WarnMonomorphism
206 | Opt_WarnUnusedBinds
207 | Opt_WarnUnusedImports
208 | Opt_WarnUnusedMatches
209 | Opt_WarnWarningsDeprecations
210 | Opt_WarnDeprecatedFlags
211 | Opt_WarnDodgyExports
212 | Opt_WarnDodgyImports
214 | Opt_WarnAutoOrphans
217 | Opt_WarnUnrecognisedPragmas
218 | Opt_WarnDodgyForeignImports
219 | Opt_WarnLazyUnliftedBindings
220 | Opt_WarnUnusedDoBind
221 | Opt_WarnWrongDoBind
222 | Opt_WarnAlternativeLayoutRuleTransitional
224 | Opt_PrintExplicitForalls
231 | Opt_StaticArgumentTransformation
235 | Opt_DoLambdaEtaExpansion
239 | Opt_UnboxStrictFields
240 | Opt_MethodSharing -- Now a no-op; remove in GHC 7.2
242 | Opt_EnableRewriteRules -- Apply rewrite rules during simplification
244 | Opt_RegsGraph -- do graph coloring register allocation
245 | Opt_RegsIterative -- do iterative coalescing graph coloring register allocation
248 | Opt_IgnoreInterfacePragmas
249 | Opt_OmitInterfacePragmas
250 | Opt_ExposeAllUnfoldings
253 | Opt_AutoSccsOnAllToplevs
254 | Opt_AutoSccsOnExportedToplevs
255 | Opt_AutoSccsOnIndividualCafs
261 | Opt_ExcessPrecision
262 | Opt_EagerBlackHoling
263 | Opt_ReadUserPackageConf
267 | Opt_HideAllPackages
268 | Opt_PrintBindResult
272 | Opt_BreakOnException
274 | Opt_PrintEvldWithShow
275 | Opt_PrintBindContents
278 | Opt_EmitExternalCore
280 | Opt_BuildingCabalPackage
288 | Opt_ConvertToZipCfgAndBack
289 | Opt_AutoLinkPackages
290 | Opt_ImplicitImportQualified
298 | Opt_KeepRawTokenStream
303 data Language = Haskell98 | Haskell2010
307 | Opt_OverlappingInstances
308 | Opt_UndecidableInstances
309 | Opt_IncoherentInstances
310 | Opt_MonomorphismRestriction
313 | Opt_RelaxedPolyRec -- Deprecated
314 | Opt_ExtendedDefaultRules -- Use GHC's extended rules for defaulting
315 | Opt_ForeignFunctionInterface
316 | Opt_UnliftedFFITypes
317 | Opt_GHCForeignImportPrim
318 | Opt_ParallelArrays -- Syntactic support for parallel arrays
319 | Opt_Arrows -- Arrow-notation syntax
320 | Opt_TemplateHaskell
323 | Opt_ImplicitPrelude
324 | Opt_ScopedTypeVariables
328 | Opt_OverloadedStrings
329 | Opt_DisambiguateRecordFields
330 | Opt_RecordWildCards
336 | Opt_DoAndIfThenElse
337 | Opt_RebindableSyntax
339 | Opt_StandaloneDeriving
340 | Opt_DeriveDataTypeable
342 | Opt_DeriveTraversable
344 | Opt_DeriveGeneric -- Allow deriving Generic/1
345 | Opt_DefaultSignatures -- Allow extra signatures for defmeths
346 | Opt_Generics -- Old generic classes, now deprecated
348 | Opt_TypeSynonymInstances
349 | Opt_FlexibleContexts
350 | Opt_FlexibleInstances
351 | Opt_ConstrainedClassMethods
352 | Opt_MultiParamTypeClasses
353 | Opt_FunctionalDependencies
355 | Opt_PolymorphicComponents
356 | Opt_ExistentialQuantification
360 | Opt_ParallelListComp
361 | Opt_TransformListComp
362 | Opt_MonadComprehensions
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 targetPlatform :: Platform.Platform, -- ^ The platform we're compiling for. Used by the NCG.
406 cmdlineHcIncludes :: [String], -- ^ @\-\#includes@
407 importPaths :: [FilePath],
409 mainFunIs :: Maybe String,
410 ctxtStkDepth :: Int, -- ^ Typechecker context stack depth
412 dphBackend :: DPHBackend,
414 thisPackage :: PackageId, -- ^ name of package currently being compiled
417 ways :: [Way], -- ^ Way flags from the command line
418 buildTag :: String, -- ^ The global \"way\" (e.g. \"p\" for prof)
419 rtsBuildTag :: String, -- ^ The RTS \"way\"
421 -- For object splitting
422 splitInfo :: Maybe (String,Int),
425 objectDir :: Maybe String,
426 dylibInstallName :: Maybe String,
427 hiDir :: Maybe String,
428 stubDir :: Maybe String,
434 outputFile :: Maybe String,
435 outputHi :: Maybe String,
436 dynLibLoader :: DynLibLoader,
438 -- | This is set by 'DriverPipeline.runPipeline' based on where
439 -- its output is going.
440 dumpPrefix :: Maybe FilePath,
442 -- | Override the 'dumpPrefix' set by 'DriverPipeline.runPipeline'.
443 -- Set by @-ddump-file-prefix@
444 dumpPrefixForce :: Maybe FilePath,
446 includePaths :: [String],
447 libraryPaths :: [String],
448 frameworkPaths :: [String], -- used on darwin only
449 cmdlineFrameworks :: [String], -- ditto
451 rtsOpts :: Maybe String,
452 rtsOptsEnabled :: RtsOptsEnabled,
454 hpcDir :: String, -- ^ Path to store the .mix files
456 settings :: Settings,
459 depMakefile :: FilePath,
460 depIncludePkgDeps :: Bool,
461 depExcludeMods :: [ModuleName],
462 depSuffixes :: [String],
465 extraPkgConfs :: [FilePath],
466 -- ^ The @-package-conf@ flags given on the command line, in the order
469 packageFlags :: [PackageFlag],
470 -- ^ The @-package@ and @-hide-package@ flags from the command-line
473 -- NB. do not modify this field, it is calculated by
474 -- Packages.initPackages and Packages.updatePackages.
475 pkgDatabase :: Maybe [PackageConfig],
476 pkgState :: PackageState,
479 -- These have to be IORefs, because the defaultCleanupHandler needs to
480 -- know what to clean when an exception happens
481 filesToClean :: IORef [FilePath],
482 dirsToClean :: IORef (Map FilePath FilePath),
486 -- Don't change this without updating extensionFlags:
487 language :: Maybe Language,
488 -- Don't change this without updating extensionFlags:
489 extensions :: [OnOff ExtensionFlag],
490 -- extensionFlags should always be equal to
491 -- flattenExtensionFlags language extensions
492 extensionFlags :: [ExtensionFlag],
494 -- | Message output action: use "ErrUtils" instead of this if you can
495 log_action :: Severity -> SrcSpan -> PprStyle -> Message -> IO (),
497 haddockOptions :: Maybe String
500 data Settings = Settings {
501 sGhcUsagePath :: FilePath, -- Filled in by SysTools
502 sGhciUsagePath :: FilePath, -- ditto
504 sTmpDir :: String, -- no trailing '/'
505 -- You shouldn't need to look things up in rawSettings directly.
506 -- They should have their own fields instead.
507 sRawSettings :: [(String, String)],
508 sExtraGccViaCFlags :: [String],
509 sSystemPackageConfig :: FilePath,
510 -- commands for particular phases
512 sPgm_P :: (String,[Option]),
514 sPgm_c :: (String,[Option]),
515 sPgm_s :: (String,[Option]),
516 sPgm_a :: (String,[Option]),
517 sPgm_l :: (String,[Option]),
518 sPgm_dll :: (String,[Option]),
520 sPgm_sysman :: String,
521 sPgm_windres :: String,
522 sPgm_lo :: (String,[Option]), -- LLVM: opt llvm optimiser
523 sPgm_lc :: (String,[Option]), -- LLVM: llc static compiler
524 -- options for particular phases
532 sOpt_windres :: [String],
533 sOpt_lo :: [String], -- LLVM: llvm optimiser
534 sOpt_lc :: [String] -- LLVM: llc static compiler
538 ghcUsagePath :: DynFlags -> FilePath
539 ghcUsagePath dflags = sGhcUsagePath (settings dflags)
540 ghciUsagePath :: DynFlags -> FilePath
541 ghciUsagePath dflags = sGhciUsagePath (settings dflags)
542 topDir :: DynFlags -> FilePath
543 topDir dflags = sTopDir (settings dflags)
544 tmpDir :: DynFlags -> String
545 tmpDir dflags = sTmpDir (settings dflags)
546 rawSettings :: DynFlags -> [(String, String)]
547 rawSettings dflags = sRawSettings (settings dflags)
548 extraGccViaCFlags :: DynFlags -> [String]
549 extraGccViaCFlags dflags = sExtraGccViaCFlags (settings dflags)
550 systemPackageConfig :: DynFlags -> FilePath
551 systemPackageConfig dflags = sSystemPackageConfig (settings dflags)
552 pgm_L :: DynFlags -> String
553 pgm_L dflags = sPgm_L (settings dflags)
554 pgm_P :: DynFlags -> (String,[Option])
555 pgm_P dflags = sPgm_P (settings dflags)
556 pgm_F :: DynFlags -> String
557 pgm_F dflags = sPgm_F (settings dflags)
558 pgm_c :: DynFlags -> (String,[Option])
559 pgm_c dflags = sPgm_c (settings dflags)
560 pgm_s :: DynFlags -> (String,[Option])
561 pgm_s dflags = sPgm_s (settings dflags)
562 pgm_a :: DynFlags -> (String,[Option])
563 pgm_a dflags = sPgm_a (settings dflags)
564 pgm_l :: DynFlags -> (String,[Option])
565 pgm_l dflags = sPgm_l (settings dflags)
566 pgm_dll :: DynFlags -> (String,[Option])
567 pgm_dll dflags = sPgm_dll (settings dflags)
568 pgm_T :: DynFlags -> String
569 pgm_T dflags = sPgm_T (settings dflags)
570 pgm_sysman :: DynFlags -> String
571 pgm_sysman dflags = sPgm_sysman (settings dflags)
572 pgm_windres :: DynFlags -> String
573 pgm_windres dflags = sPgm_windres (settings dflags)
574 pgm_lo :: DynFlags -> (String,[Option])
575 pgm_lo dflags = sPgm_lo (settings dflags)
576 pgm_lc :: DynFlags -> (String,[Option])
577 pgm_lc dflags = sPgm_lc (settings dflags)
578 opt_L :: DynFlags -> [String]
579 opt_L dflags = sOpt_L (settings dflags)
580 opt_P :: DynFlags -> [String]
581 opt_P dflags = sOpt_P (settings dflags)
582 opt_F :: DynFlags -> [String]
583 opt_F dflags = sOpt_F (settings dflags)
584 opt_c :: DynFlags -> [String]
585 opt_c dflags = sOpt_c (settings dflags)
586 opt_m :: DynFlags -> [String]
587 opt_m dflags = sOpt_m (settings dflags)
588 opt_a :: DynFlags -> [String]
589 opt_a dflags = sOpt_a (settings dflags)
590 opt_l :: DynFlags -> [String]
591 opt_l dflags = sOpt_l (settings dflags)
592 opt_windres :: DynFlags -> [String]
593 opt_windres dflags = sOpt_windres (settings dflags)
594 opt_lo :: DynFlags -> [String]
595 opt_lo dflags = sOpt_lo (settings dflags)
596 opt_lc :: DynFlags -> [String]
597 opt_lc dflags = sOpt_lc (settings dflags)
599 wayNames :: DynFlags -> [WayName]
600 wayNames = map wayName . ways
602 -- | The target code type of the compilation (if any).
604 -- Whenever you change the target, also make sure to set 'ghcLink' to
605 -- something sensible.
607 -- 'HscNothing' can be used to avoid generating any output, however, note
610 -- * This will not run the desugaring step, thus no warnings generated in
611 -- this step will be output. In particular, this includes warnings related
612 -- to pattern matching. You can run the desugarer manually using
613 -- 'GHC.desugarModule'.
615 -- * If a program uses Template Haskell the typechecker may try to run code
616 -- from an imported module. This will fail if no code has been generated
617 -- for this module. You can use 'GHC.needsTemplateHaskell' to detect
618 -- whether this might be the case and choose to either switch to a
619 -- different target or avoid typechecking such modules. (The latter may
620 -- preferable for security reasons.)
623 = HscC -- ^ Generate C code.
624 | HscAsm -- ^ Generate assembly using the native code generator.
625 | HscLlvm -- ^ Generate assembly using the llvm code generator.
626 | HscJava -- ^ Generate Java bytecode.
627 | HscInterpreted -- ^ Generate bytecode. (Requires 'LinkInMemory')
628 | HscNothing -- ^ Don't generate any code. See notes above.
631 showHscTargetFlag :: HscTarget -> String
632 showHscTargetFlag HscC = "-fvia-c"
633 showHscTargetFlag HscAsm = "-fasm"
634 showHscTargetFlag HscLlvm = "-fllvm"
635 showHscTargetFlag HscJava = panic "No flag for HscJava"
636 showHscTargetFlag HscInterpreted = "-fbyte-code"
637 showHscTargetFlag HscNothing = "-fno-code"
639 -- | Will this target result in an object file on the disk?
640 isObjectTarget :: HscTarget -> Bool
641 isObjectTarget HscC = True
642 isObjectTarget HscAsm = True
643 isObjectTarget HscLlvm = True
644 isObjectTarget _ = False
646 -- | The 'GhcMode' tells us whether we're doing multi-module
647 -- compilation (controlled via the "GHC" API) or one-shot
648 -- (single-module) compilation. This makes a difference primarily to
649 -- the "Finder": in one-shot mode we look for interface files for
650 -- imported modules, but in multi-module mode we look for source files
651 -- in order to check whether they need to be recompiled.
653 = CompManager -- ^ @\-\-make@, GHCi, etc.
654 | OneShot -- ^ @ghc -c Foo.hs@
655 | MkDepend -- ^ @ghc -M@, see "Finder" for why we need this
658 instance Outputable GhcMode where
659 ppr CompManager = ptext (sLit "CompManager")
660 ppr OneShot = ptext (sLit "OneShot")
661 ppr MkDepend = ptext (sLit "MkDepend")
663 isOneShot :: GhcMode -> Bool
664 isOneShot OneShot = True
665 isOneShot _other = False
667 -- | What to do in the link step, if there is one.
669 = NoLink -- ^ Don't link at all
670 | LinkBinary -- ^ Link object code into a binary
671 | LinkInMemory -- ^ Use the in-memory dynamic linker (works for both
672 -- bytecode and object code).
673 | LinkDynLib -- ^ Link objects into a dynamic lib (DLL on Windows, DSO on ELF platforms)
676 isNoLink :: GhcLink -> Bool
677 isNoLink NoLink = True
680 -- Is it worth evaluating this Bool and caching it in the DynFlags value
681 -- during initDynFlags?
682 doingTickyProfiling :: DynFlags -> Bool
683 doingTickyProfiling _ = opt_Ticky
684 -- XXX -ticky is a static flag, because it implies -debug which is also
685 -- static. If the way flags were made dynamic, we could fix this.
688 = ExposePackage String
689 | ExposePackageId String
691 | IgnorePackage String
694 defaultHscTarget :: HscTarget
695 defaultHscTarget = defaultObjectTarget
697 -- | The 'HscTarget' value corresponding to the default way to create
698 -- object files on the current platform.
699 defaultObjectTarget :: HscTarget
701 | cGhcUnregisterised == "YES" = HscC
702 | cGhcWithNativeCodeGen == "YES" = HscAsm
703 | otherwise = HscLlvm
710 data RtsOptsEnabled = RtsOptsNone | RtsOptsSafeOnly | RtsOptsAll
713 -- | Used by 'GHC.newSession' to partially initialize a new 'DynFlags' value
714 initDynFlags :: DynFlags -> IO DynFlags
715 initDynFlags dflags = do
716 -- someday these will be dynamic flags
717 ways <- readIORef v_Ways
718 refFilesToClean <- newIORef []
719 refDirsToClean <- newIORef Map.empty
722 buildTag = mkBuildTag (filter (not . wayRTSOnly) ways),
723 rtsBuildTag = mkBuildTag ways,
724 filesToClean = refFilesToClean,
725 dirsToClean = refDirsToClean
728 -- | The normal 'DynFlags'. Note that they is not suitable for use in this form
729 -- and must be fully initialized by 'GHC.newSession' first.
730 defaultDynFlags :: Settings -> DynFlags
731 defaultDynFlags mySettings =
733 ghcMode = CompManager,
734 ghcLink = LinkBinary,
735 hscTarget = defaultHscTarget,
741 maxSimplIterations = 4,
742 shouldDumpSimplPhase = Nothing,
744 specConstrThreshold = Just 200,
745 specConstrCount = Just 3,
746 liberateCaseThreshold = Just 200,
747 floatLamArgs = Just 0, -- Default: float only if no fvs
748 strictnessBefore = [],
750 targetPlatform = defaultTargetPlatform,
751 cmdlineHcIncludes = [],
755 ctxtStkDepth = mAX_CONTEXT_REDUCTION_DEPTH,
757 dphBackend = DPHNone,
759 thisPackage = mainPackageId,
762 dylibInstallName = Nothing,
766 objectSuf = phaseInputExt StopLn,
767 hcSuf = phaseInputExt HCc,
770 outputFile = Nothing,
772 dynLibLoader = SystemDependent,
773 dumpPrefix = Nothing,
774 dumpPrefixForce = Nothing,
778 cmdlineFrameworks = [],
780 rtsOptsEnabled = RtsOptsSafeOnly,
786 pkgDatabase = Nothing,
787 pkgState = panic "no package state yet: call GHC.setSessionDynFlags",
788 ways = panic "defaultDynFlags: No ways",
789 buildTag = panic "defaultDynFlags: No buildTag",
790 rtsBuildTag = panic "defaultDynFlags: No rtsBuildTag",
792 settings = mySettings,
794 depMakefile = "Makefile",
795 depIncludePkgDeps = False,
798 -- end of ghc -M values
799 filesToClean = panic "defaultDynFlags: No filesToClean",
800 dirsToClean = panic "defaultDynFlags: No dirsToClean",
801 haddockOptions = Nothing,
802 flags = defaultFlags,
805 extensionFlags = flattenExtensionFlags Nothing [],
807 log_action = \severity srcSpan style msg ->
809 SevOutput -> printSDoc msg style
810 SevInfo -> printErrs msg style
811 SevFatal -> printErrs msg style
814 printErrs (mkLocMessage srcSpan msg) style
815 -- careful (#2302): printErrs prints in UTF-8, whereas
816 -- converting to string first and using hPutStr would
817 -- just emit the low 8 bits of each unicode char.
821 Note [Verbosity levels]
822 ~~~~~~~~~~~~~~~~~~~~~~~
823 0 | print errors & warnings only
824 1 | minimal verbosity: print "compiling M ... done." for each module.
825 2 | equivalent to -dshow-passes
826 3 | equivalent to existing "ghc -v"
827 4 | "ghc -v -ddump-most"
828 5 | "ghc -v -ddump-all"
834 -- OnOffs accumulate in reverse order, so we use foldr in order to
835 -- process them in the right order
836 flattenExtensionFlags :: Maybe Language -> [OnOff ExtensionFlag]
838 flattenExtensionFlags ml = foldr f defaultExtensionFlags
839 where f (On f) flags = f : delete f flags
840 f (Off f) flags = delete f flags
841 defaultExtensionFlags = languageExtensions ml
843 languageExtensions :: Maybe Language -> [ExtensionFlag]
845 languageExtensions Nothing
846 -- Nothing => the default case
847 = Opt_MonoPatBinds -- Experimentally, I'm making this non-standard
848 -- behaviour the default, to see if anyone notices
850 -- In due course I'd like Opt_MonoLocalBinds to be on by default
851 -- But NB it's implied by GADTs etc
852 -- SLPJ September 2010
853 : Opt_NondecreasingIndentation -- This has been on by default for some time
854 : languageExtensions (Just Haskell2010)
856 languageExtensions (Just Haskell98)
857 = [Opt_ImplicitPrelude,
858 Opt_MonomorphismRestriction,
860 Opt_DatatypeContexts,
861 Opt_NondecreasingIndentation
862 -- strictly speaking non-standard, but we always had this
863 -- on implicitly before the option was added in 7.1, and
864 -- turning it off breaks code, so we're keeping it on for
865 -- backwards compatibility. Cabal uses -XHaskell98 by
866 -- default unless you specify another language.
869 languageExtensions (Just Haskell2010)
870 = [Opt_ImplicitPrelude,
871 Opt_MonomorphismRestriction,
872 Opt_DatatypeContexts,
874 Opt_ForeignFunctionInterface,
879 -- | Test whether a 'DynFlag' is set
880 dopt :: DynFlag -> DynFlags -> Bool
881 dopt f dflags = f `elem` (flags dflags)
884 dopt_set :: DynFlags -> DynFlag -> DynFlags
885 dopt_set dfs f = dfs{ flags = f : flags dfs }
887 -- | Unset a 'DynFlag'
888 dopt_unset :: DynFlags -> DynFlag -> DynFlags
889 dopt_unset dfs f = dfs{ flags = filter (/= f) (flags dfs) }
891 -- | Test whether a 'ExtensionFlag' is set
892 xopt :: ExtensionFlag -> DynFlags -> Bool
893 xopt f dflags = f `elem` extensionFlags dflags
895 -- | Set a 'ExtensionFlag'
896 xopt_set :: DynFlags -> ExtensionFlag -> DynFlags
898 = let onoffs = On f : extensions dfs
899 in dfs { extensions = onoffs,
900 extensionFlags = flattenExtensionFlags (language dfs) onoffs }
902 -- | Unset a 'ExtensionFlag'
903 xopt_unset :: DynFlags -> ExtensionFlag -> DynFlags
905 = let onoffs = Off f : extensions dfs
906 in dfs { extensions = onoffs,
907 extensionFlags = flattenExtensionFlags (language dfs) onoffs }
909 setLanguage :: Language -> DynP ()
910 setLanguage l = upd f
911 where f dfs = let mLang = Just l
912 oneoffs = extensions dfs
915 extensionFlags = flattenExtensionFlags mLang oneoffs
918 -- | Retrieve the options corresponding to a particular @opt_*@ field in the correct order
919 getOpts :: DynFlags -- ^ 'DynFlags' to retrieve the options from
920 -> (DynFlags -> [a]) -- ^ Relevant record accessor: one of the @opt_*@ accessors
921 -> [a] -- ^ Correctly ordered extracted options
922 getOpts dflags opts = reverse (opts dflags)
923 -- We add to the options from the front, so we need to reverse the list
925 -- | Gets the verbosity flag for the current verbosity level. This is fed to
926 -- other tools, so GHC-specific verbosity flags like @-ddump-most@ are not included
927 getVerbFlags :: DynFlags -> [String]
929 | verbosity dflags >= 4 = ["-v"]
932 setObjectDir, setHiDir, setStubDir, setOutputDir, setDylibInstallName,
933 setObjectSuf, setHiSuf, setHcSuf, parseDynLibLoaderMode,
934 setPgmP, addOptl, addOptP,
935 addCmdlineFramework, addHaddockOpts
936 :: String -> DynFlags -> DynFlags
937 setOutputFile, setOutputHi, setDumpPrefixForce
938 :: Maybe String -> DynFlags -> DynFlags
940 setObjectDir f d = d{ objectDir = Just f}
941 setHiDir f d = d{ hiDir = Just f}
942 setStubDir f d = d{ stubDir = Just f, includePaths = f : includePaths d }
943 -- -stubdir D adds an implicit -I D, so that gcc can find the _stub.h file
944 -- \#included from the .hc file when compiling via C (i.e. unregisterised
946 setOutputDir f = setObjectDir f . setHiDir f . setStubDir f
947 setDylibInstallName f d = d{ dylibInstallName = Just f}
949 setObjectSuf f d = d{ objectSuf = f}
950 setHiSuf f d = d{ hiSuf = f}
951 setHcSuf f d = d{ hcSuf = f}
953 setOutputFile f d = d{ outputFile = f}
954 setOutputHi f d = d{ outputHi = f}
956 parseDynLibLoaderMode f d =
958 ("deploy", "") -> d{ dynLibLoader = Deployable }
959 ("sysdep", "") -> d{ dynLibLoader = SystemDependent }
960 _ -> ghcError (CmdLineError ("Unknown dynlib loader: " ++ f))
962 setDumpPrefixForce f d = d { dumpPrefixForce = f}
964 -- XXX HACK: Prelude> words "'does not' work" ===> ["'does","not'","work"]
965 -- Config.hs should really use Option.
966 setPgmP f = let (pgm:args) = words f in alterSettings (\s -> s { sPgm_P = (pgm, map Option args)})
967 addOptl f = alterSettings (\s -> s { sOpt_l = f : sOpt_l s})
968 addOptP f = alterSettings (\s -> s { sOpt_P = f : sOpt_P s})
971 setDepMakefile :: FilePath -> DynFlags -> DynFlags
972 setDepMakefile f d = d { depMakefile = deOptDep f }
974 setDepIncludePkgDeps :: Bool -> DynFlags -> DynFlags
975 setDepIncludePkgDeps b d = d { depIncludePkgDeps = b }
977 addDepExcludeMod :: String -> DynFlags -> DynFlags
979 = d { depExcludeMods = mkModuleName (deOptDep m) : depExcludeMods d }
981 addDepSuffix :: FilePath -> DynFlags -> DynFlags
982 addDepSuffix s d = d { depSuffixes = deOptDep s : depSuffixes d }
985 -- We used to use "-optdep-flag -optdeparg", so for legacy applications
986 -- we need to strip the "-optdep" off of the arg
987 deOptDep :: String -> String
988 deOptDep x = case stripPrefix "-optdep" x of
992 addCmdlineFramework f d = d{ cmdlineFrameworks = f : cmdlineFrameworks d}
994 addHaddockOpts f d = d{ haddockOptions = Just f}
996 -- -----------------------------------------------------------------------------
997 -- Command-line options
999 -- | When invoking external tools as part of the compilation pipeline, we
1000 -- pass these a sequence of options on the command-line. Rather than
1001 -- just using a list of Strings, we use a type that allows us to distinguish
1002 -- between filepaths and 'other stuff'. The reason for this is that
1003 -- this type gives us a handle on transforming filenames, and filenames only,
1004 -- to whatever format they're expected to be on a particular platform.
1006 = FileOption -- an entry that _contains_ filename(s) / filepaths.
1007 String -- a non-filepath prefix that shouldn't be
1008 -- transformed (e.g., "/out=")
1009 String -- the filepath/filename portion
1012 showOpt :: Option -> String
1013 showOpt (FileOption pre f) = pre ++ f
1014 showOpt (Option s) = s
1016 -----------------------------------------------------------------------------
1017 -- Setting the optimisation level
1019 updOptLevel :: Int -> DynFlags -> DynFlags
1020 -- ^ Sets the 'DynFlags' to be appropriate to the optimisation level
1022 = dfs2{ optLevel = final_n }
1024 final_n = max 0 (min 2 n) -- Clamp to 0 <= n <= 2
1025 dfs1 = foldr (flip dopt_unset) dfs remove_dopts
1026 dfs2 = foldr (flip dopt_set) dfs1 extra_dopts
1028 extra_dopts = [ f | (ns,f) <- optLevelFlags, final_n `elem` ns ]
1029 remove_dopts = [ f | (ns,f) <- optLevelFlags, final_n `notElem` ns ]
1031 -- -----------------------------------------------------------------------------
1032 -- StgToDo: abstraction of stg-to-stg passes to run.
1035 = StgDoMassageForProfiling -- should be (next to) last
1036 -- There's also setStgVarInfo, but its absolute "lastness"
1037 -- is so critical that it is hardwired in (no flag).
1040 getStgToDo :: DynFlags -> [StgToDo]
1044 stg_stats = dopt Opt_StgStats dflags
1046 todo1 = if stg_stats then [D_stg_stats] else []
1048 todo2 | WayProf `elem` wayNames dflags
1049 = StgDoMassageForProfiling : todo1
1053 {- **********************************************************************
1057 %********************************************************************* -}
1059 -- -----------------------------------------------------------------------------
1060 -- Parsing the dynamic flags.
1062 -- | Parse dynamic flags from a list of command line arguments. Returns the
1063 -- the parsed 'DynFlags', the left-over arguments, and a list of warnings.
1064 -- Throws a 'UsageError' if errors occurred during parsing (such as unknown
1065 -- flags or missing arguments).
1066 parseDynamicFlags :: Monad m =>
1067 DynFlags -> [Located String]
1068 -> m (DynFlags, [Located String], [Located String])
1069 -- ^ Updated 'DynFlags', left-over arguments, and
1070 -- list of warnings.
1071 parseDynamicFlags dflags args = parseDynamicFlags_ dflags args True
1073 -- | Like 'parseDynamicFlags' but does not allow the package flags (-package,
1074 -- -hide-package, -ignore-package, -hide-all-packages, -package-conf).
1075 parseDynamicNoPackageFlags :: Monad m =>
1076 DynFlags -> [Located String]
1077 -> m (DynFlags, [Located String], [Located String])
1078 -- ^ Updated 'DynFlags', left-over arguments, and
1079 -- list of warnings.
1080 parseDynamicNoPackageFlags dflags args = parseDynamicFlags_ dflags args False
1082 parseDynamicFlags_ :: Monad m =>
1083 DynFlags -> [Located String] -> Bool
1084 -> m (DynFlags, [Located String], [Located String])
1085 parseDynamicFlags_ dflags0 args pkg_flags = do
1086 -- XXX Legacy support code
1087 -- We used to accept things like
1088 -- optdep-f -optdepdepend
1089 -- optdep-f -optdep depend
1090 -- optdep -f -optdepdepend
1091 -- optdep -f -optdep depend
1092 -- but the spaces trip up proper argument handling. So get rid of them.
1093 let f (L p "-optdep" : L _ x : xs) = (L p ("-optdep" ++ x)) : f xs
1094 f (x : xs) = x : f xs
1098 -- Note: -ignore-package (package_flags) must precede -i* (dynamic_flags)
1099 flag_spec | pkg_flags = package_flags ++ dynamic_flags
1100 | otherwise = dynamic_flags
1102 let ((leftover, errs, warns), dflags1)
1103 = runCmdLine (processArgs flag_spec args') dflags0
1104 when (not (null errs)) $ ghcError $ errorsToGhcException errs
1106 return (dflags1, leftover, warns)
1109 {- **********************************************************************
1111 DynFlags specifications
1113 %********************************************************************* -}
1115 allFlags :: [String]
1116 allFlags = map ('-':) $
1117 [ flagName flag | flag <- dynamic_flags, ok (flagOptKind flag) ] ++
1118 map ("fno-"++) flags ++
1119 map ("f"++) flags ++
1120 map ("f"++) flags' ++
1121 map ("X"++) supportedExtensions
1122 where ok (PrefixPred _ _) = False
1124 flags = [ name | (name, _, _) <- fFlags ]
1125 flags' = [ name | (name, _, _) <- fLangFlags ]
1127 --------------- The main flags themselves ------------------
1128 dynamic_flags :: [Flag (CmdLineP DynFlags)]
1130 Flag "n" (NoArg (setDynFlag Opt_DryRun))
1131 , Flag "cpp" (NoArg (setExtensionFlag Opt_Cpp))
1132 , Flag "F" (NoArg (setDynFlag Opt_Pp))
1134 (HasArg (\s -> do { addCmdlineHCInclude s
1135 ; addWarn "-#include and INCLUDE pragmas are deprecated: They no longer have any effect" }))
1136 , Flag "v" (OptIntSuffix setVerbosity)
1138 ------- Specific phases --------------------------------------------
1139 -- need to appear before -pgmL to be parsed as LLVM flags.
1140 , Flag "pgmlo" (hasArg (\f -> alterSettings (\s -> s { sPgm_lo = (f,[])})))
1141 , Flag "pgmlc" (hasArg (\f -> alterSettings (\s -> s { sPgm_lc = (f,[])})))
1142 , Flag "pgmL" (hasArg (\f -> alterSettings (\s -> s { sPgm_L = f})))
1143 , Flag "pgmP" (hasArg setPgmP)
1144 , Flag "pgmF" (hasArg (\f -> alterSettings (\s -> s { sPgm_F = f})))
1145 , Flag "pgmc" (hasArg (\f -> alterSettings (\s -> s { sPgm_c = (f,[])})))
1146 , Flag "pgmm" (HasArg (\_ -> addWarn "The -keep-raw-s-files flag does nothing; it will be removed in a future GHC release"))
1147 , Flag "pgms" (hasArg (\f -> alterSettings (\s -> s { sPgm_s = (f,[])})))
1148 , Flag "pgma" (hasArg (\f -> alterSettings (\s -> s { sPgm_a = (f,[])})))
1149 , Flag "pgml" (hasArg (\f -> alterSettings (\s -> s { sPgm_l = (f,[])})))
1150 , Flag "pgmdll" (hasArg (\f -> alterSettings (\s -> s { sPgm_dll = (f,[])})))
1151 , Flag "pgmwindres" (hasArg (\f -> alterSettings (\s -> s { sPgm_windres = f})))
1153 -- need to appear before -optl/-opta to be parsed as LLVM flags.
1154 , Flag "optlo" (hasArg (\f -> alterSettings (\s -> s { sOpt_lo = f : sOpt_lo s})))
1155 , Flag "optlc" (hasArg (\f -> alterSettings (\s -> s { sOpt_lc = f : sOpt_lc s})))
1156 , Flag "optL" (hasArg (\f -> alterSettings (\s -> s { sOpt_L = f : sOpt_L s})))
1157 , Flag "optP" (hasArg addOptP)
1158 , Flag "optF" (hasArg (\f -> alterSettings (\s -> s { sOpt_F = f : sOpt_F s})))
1159 , Flag "optc" (hasArg (\f -> alterSettings (\s -> s { sOpt_c = f : sOpt_c s})))
1160 , Flag "optm" (hasArg (\f -> alterSettings (\s -> s { sOpt_m = f : sOpt_m s})))
1161 , Flag "opta" (hasArg (\f -> alterSettings (\s -> s { sOpt_a = f : sOpt_a s})))
1162 , Flag "optl" (hasArg addOptl)
1163 , Flag "optwindres" (hasArg (\f -> alterSettings (\s -> s { sOpt_windres = f : sOpt_windres s})))
1166 (NoArg (if can_split
1167 then setDynFlag Opt_SplitObjs
1168 else addWarn "ignoring -fsplit-objs"))
1170 -------- ghc -M -----------------------------------------------------
1171 , Flag "dep-suffix" (hasArg addDepSuffix)
1172 , Flag "optdep-s" (hasArgDF addDepSuffix "Use -dep-suffix instead")
1173 , Flag "dep-makefile" (hasArg setDepMakefile)
1174 , Flag "optdep-f" (hasArgDF setDepMakefile "Use -dep-makefile instead")
1175 , Flag "optdep-w" (NoArg (deprecate "doesn't do anything"))
1176 , Flag "include-pkg-deps" (noArg (setDepIncludePkgDeps True))
1177 , Flag "optdep--include-prelude" (noArgDF (setDepIncludePkgDeps True) "Use -include-pkg-deps instead")
1178 , Flag "optdep--include-pkg-deps" (noArgDF (setDepIncludePkgDeps True) "Use -include-pkg-deps instead")
1179 , Flag "exclude-module" (hasArg addDepExcludeMod)
1180 , Flag "optdep--exclude-module" (hasArgDF addDepExcludeMod "Use -exclude-module instead")
1181 , Flag "optdep-x" (hasArgDF addDepExcludeMod "Use -exclude-module instead")
1183 -------- Linking ----------------------------------------------------
1184 , Flag "no-link" (noArg (\d -> d{ ghcLink=NoLink }))
1185 , Flag "shared" (noArg (\d -> d{ ghcLink=LinkDynLib }))
1186 , Flag "dynload" (hasArg parseDynLibLoaderMode)
1187 , Flag "dylib-install-name" (hasArg setDylibInstallName)
1189 ------- Libraries ---------------------------------------------------
1190 , Flag "L" (Prefix addLibraryPath)
1191 , Flag "l" (AnySuffix (upd . addOptl))
1193 ------- Frameworks --------------------------------------------------
1194 -- -framework-path should really be -F ...
1195 , Flag "framework-path" (HasArg addFrameworkPath)
1196 , Flag "framework" (hasArg addCmdlineFramework)
1198 ------- Output Redirection ------------------------------------------
1199 , Flag "odir" (hasArg setObjectDir)
1200 , Flag "o" (SepArg (upd . setOutputFile . Just))
1201 , Flag "ohi" (hasArg (setOutputHi . Just ))
1202 , Flag "osuf" (hasArg setObjectSuf)
1203 , Flag "hcsuf" (hasArg setHcSuf)
1204 , Flag "hisuf" (hasArg setHiSuf)
1205 , Flag "hidir" (hasArg setHiDir)
1206 , Flag "tmpdir" (hasArg setTmpDir)
1207 , Flag "stubdir" (hasArg setStubDir)
1208 , Flag "outputdir" (hasArg setOutputDir)
1209 , Flag "ddump-file-prefix" (hasArg (setDumpPrefixForce . Just))
1211 ------- Keeping temporary files -------------------------------------
1212 -- These can be singular (think ghc -c) or plural (think ghc --make)
1213 , Flag "keep-hc-file" (NoArg (setDynFlag Opt_KeepHcFiles))
1214 , Flag "keep-hc-files" (NoArg (setDynFlag Opt_KeepHcFiles))
1215 , Flag "keep-s-file" (NoArg (setDynFlag Opt_KeepSFiles))
1216 , Flag "keep-s-files" (NoArg (setDynFlag Opt_KeepSFiles))
1217 , Flag "keep-raw-s-file" (NoArg (addWarn "The -keep-raw-s-file flag does nothing; it will be removed in a future GHC release"))
1218 , Flag "keep-raw-s-files" (NoArg (addWarn "The -keep-raw-s-files flag does nothing; it will be removed in a future GHC release"))
1219 , Flag "keep-llvm-file" (NoArg (setDynFlag Opt_KeepLlvmFiles))
1220 , Flag "keep-llvm-files" (NoArg (setDynFlag Opt_KeepLlvmFiles))
1221 -- This only makes sense as plural
1222 , Flag "keep-tmp-files" (NoArg (setDynFlag Opt_KeepTmpFiles))
1224 ------- Miscellaneous ----------------------------------------------
1225 , Flag "no-auto-link-packages" (NoArg (unSetDynFlag Opt_AutoLinkPackages))
1226 , Flag "no-hs-main" (NoArg (setDynFlag Opt_NoHsMain))
1227 , Flag "with-rtsopts" (HasArg setRtsOpts)
1228 , Flag "rtsopts" (NoArg (setRtsOptsEnabled RtsOptsAll))
1229 , Flag "rtsopts=all" (NoArg (setRtsOptsEnabled RtsOptsAll))
1230 , Flag "rtsopts=some" (NoArg (setRtsOptsEnabled RtsOptsSafeOnly))
1231 , Flag "rtsopts=none" (NoArg (setRtsOptsEnabled RtsOptsNone))
1232 , Flag "no-rtsopts" (NoArg (setRtsOptsEnabled RtsOptsNone))
1233 , Flag "main-is" (SepArg setMainIs)
1234 , Flag "haddock" (NoArg (setDynFlag Opt_Haddock))
1235 , Flag "haddock-opts" (hasArg addHaddockOpts)
1236 , Flag "hpcdir" (SepArg setOptHpcDir)
1238 ------- recompilation checker --------------------------------------
1239 , Flag "recomp" (NoArg (do { unSetDynFlag Opt_ForceRecomp
1240 ; deprecate "Use -fno-force-recomp instead" }))
1241 , Flag "no-recomp" (NoArg (do { setDynFlag Opt_ForceRecomp
1242 ; deprecate "Use -fforce-recomp instead" }))
1244 ------ HsCpp opts ---------------------------------------------------
1245 , Flag "D" (AnySuffix (upd . addOptP))
1246 , Flag "U" (AnySuffix (upd . addOptP))
1248 ------- Include/Import Paths ----------------------------------------
1249 , Flag "I" (Prefix addIncludePath)
1250 , Flag "i" (OptPrefix addImportPath)
1252 ------ Debugging ----------------------------------------------------
1253 , Flag "dstg-stats" (NoArg (setDynFlag Opt_StgStats))
1255 , Flag "ddump-cmm" (setDumpFlag Opt_D_dump_cmm)
1256 , Flag "ddump-raw-cmm" (setDumpFlag Opt_D_dump_raw_cmm)
1257 , Flag "ddump-cmmz" (setDumpFlag Opt_D_dump_cmmz)
1258 , Flag "ddump-cmmz-pretty" (setDumpFlag Opt_D_dump_cmmz_pretty)
1259 , Flag "ddump-core-stats" (setDumpFlag Opt_D_dump_core_stats)
1260 , Flag "ddump-cps-cmm" (setDumpFlag Opt_D_dump_cps_cmm)
1261 , Flag "ddump-cvt-cmm" (setDumpFlag Opt_D_dump_cvt_cmm)
1262 , Flag "ddump-asm" (setDumpFlag Opt_D_dump_asm)
1263 , Flag "ddump-asm-native" (setDumpFlag Opt_D_dump_asm_native)
1264 , Flag "ddump-asm-liveness" (setDumpFlag Opt_D_dump_asm_liveness)
1265 , Flag "ddump-asm-coalesce" (setDumpFlag Opt_D_dump_asm_coalesce)
1266 , Flag "ddump-asm-regalloc" (setDumpFlag Opt_D_dump_asm_regalloc)
1267 , Flag "ddump-asm-conflicts" (setDumpFlag Opt_D_dump_asm_conflicts)
1268 , Flag "ddump-asm-regalloc-stages" (setDumpFlag Opt_D_dump_asm_regalloc_stages)
1269 , Flag "ddump-asm-stats" (setDumpFlag Opt_D_dump_asm_stats)
1270 , Flag "ddump-asm-expanded" (setDumpFlag Opt_D_dump_asm_expanded)
1271 , Flag "ddump-llvm" (NoArg (do { setObjTarget HscLlvm
1272 ; setDumpFlag' Opt_D_dump_llvm}))
1273 , Flag "ddump-cpranal" (setDumpFlag Opt_D_dump_cpranal)
1274 , Flag "ddump-deriv" (setDumpFlag Opt_D_dump_deriv)
1275 , Flag "ddump-ds" (setDumpFlag Opt_D_dump_ds)
1276 , Flag "ddump-flatC" (setDumpFlag Opt_D_dump_flatC)
1277 , Flag "ddump-foreign" (setDumpFlag Opt_D_dump_foreign)
1278 , Flag "ddump-inlinings" (setDumpFlag Opt_D_dump_inlinings)
1279 , Flag "ddump-rule-firings" (setDumpFlag Opt_D_dump_rule_firings)
1280 , Flag "ddump-rule-rewrites" (setDumpFlag Opt_D_dump_rule_rewrites)
1281 , Flag "ddump-occur-anal" (setDumpFlag Opt_D_dump_occur_anal)
1282 , Flag "ddump-parsed" (setDumpFlag Opt_D_dump_parsed)
1283 , Flag "ddump-rn" (setDumpFlag Opt_D_dump_rn)
1284 , Flag "ddump-simpl" (setDumpFlag Opt_D_dump_simpl)
1285 , Flag "ddump-simpl-iterations" (setDumpFlag Opt_D_dump_simpl_iterations)
1286 , Flag "ddump-simpl-phases" (OptPrefix setDumpSimplPhases)
1287 , Flag "ddump-spec" (setDumpFlag Opt_D_dump_spec)
1288 , Flag "ddump-prep" (setDumpFlag Opt_D_dump_prep)
1289 , Flag "ddump-stg" (setDumpFlag Opt_D_dump_stg)
1290 , Flag "ddump-stranal" (setDumpFlag Opt_D_dump_stranal)
1291 , Flag "ddump-tc" (setDumpFlag Opt_D_dump_tc)
1292 , Flag "ddump-types" (setDumpFlag Opt_D_dump_types)
1293 , Flag "ddump-rules" (setDumpFlag Opt_D_dump_rules)
1294 , Flag "ddump-cse" (setDumpFlag Opt_D_dump_cse)
1295 , Flag "ddump-worker-wrapper" (setDumpFlag Opt_D_dump_worker_wrapper)
1296 , Flag "ddump-rn-trace" (setDumpFlag Opt_D_dump_rn_trace)
1297 , Flag "ddump-if-trace" (setDumpFlag Opt_D_dump_if_trace)
1298 , Flag "ddump-cs-trace" (setDumpFlag Opt_D_dump_cs_trace)
1299 , Flag "ddump-tc-trace" (setDumpFlag Opt_D_dump_tc_trace)
1300 , Flag "ddump-vt-trace" (setDumpFlag Opt_D_dump_vt_trace)
1301 , Flag "ddump-splices" (setDumpFlag Opt_D_dump_splices)
1302 , Flag "ddump-rn-stats" (setDumpFlag Opt_D_dump_rn_stats)
1303 , Flag "ddump-opt-cmm" (setDumpFlag Opt_D_dump_opt_cmm)
1304 , Flag "ddump-simpl-stats" (setDumpFlag Opt_D_dump_simpl_stats)
1305 , Flag "ddump-bcos" (setDumpFlag Opt_D_dump_BCOs)
1306 , Flag "dsource-stats" (setDumpFlag Opt_D_source_stats)
1307 , Flag "dverbose-core2core" (NoArg (do { setVerbosity (Just 2)
1308 ; setVerboseCore2Core }))
1309 , Flag "dverbose-stg2stg" (setDumpFlag Opt_D_verbose_stg2stg)
1310 , Flag "ddump-hi" (setDumpFlag Opt_D_dump_hi)
1311 , Flag "ddump-minimal-imports" (setDumpFlag Opt_D_dump_minimal_imports)
1312 , Flag "ddump-vect" (setDumpFlag Opt_D_dump_vect)
1313 , Flag "ddump-hpc" (setDumpFlag Opt_D_dump_hpc)
1314 , Flag "ddump-mod-cycles" (setDumpFlag Opt_D_dump_mod_cycles)
1315 , Flag "ddump-view-pattern-commoning" (setDumpFlag Opt_D_dump_view_pattern_commoning)
1316 , Flag "ddump-to-file" (setDumpFlag Opt_DumpToFile)
1317 , Flag "ddump-hi-diffs" (setDumpFlag Opt_D_dump_hi_diffs)
1318 , Flag "ddump-rtti" (setDumpFlag Opt_D_dump_rtti)
1319 , Flag "dcore-lint" (NoArg (setDynFlag Opt_DoCoreLinting))
1320 , Flag "dstg-lint" (NoArg (setDynFlag Opt_DoStgLinting))
1321 , Flag "dcmm-lint" (NoArg (setDynFlag Opt_DoCmmLinting))
1322 , Flag "dasm-lint" (NoArg (setDynFlag Opt_DoAsmLinting))
1323 , Flag "dshow-passes" (NoArg (do forceRecompile
1324 setVerbosity (Just 2)))
1325 , Flag "dfaststring-stats" (NoArg (setDynFlag Opt_D_faststring_stats))
1327 ------ Machine dependant (-m<blah>) stuff ---------------------------
1329 , Flag "monly-2-regs" (NoArg (addWarn "The -monly-2-regs flag does nothing; it will be removed in a future GHC release"))
1330 , Flag "monly-3-regs" (NoArg (addWarn "The -monly-3-regs flag does nothing; it will be removed in a future GHC release"))
1331 , Flag "monly-4-regs" (NoArg (addWarn "The -monly-4-regs flag does nothing; it will be removed in a future GHC release"))
1332 , Flag "msse2" (NoArg (setDynFlag Opt_SSE2))
1334 ------ Warning opts -------------------------------------------------
1335 , Flag "W" (NoArg (mapM_ setDynFlag minusWOpts))
1336 , Flag "Werror" (NoArg (setDynFlag Opt_WarnIsError))
1337 , Flag "Wwarn" (NoArg (unSetDynFlag Opt_WarnIsError))
1338 , Flag "Wall" (NoArg (mapM_ setDynFlag minusWallOpts))
1339 , Flag "Wnot" (NoArg (do { mapM_ unSetDynFlag minusWallOpts
1340 ; deprecate "Use -w instead" }))
1341 , Flag "w" (NoArg (mapM_ unSetDynFlag minuswRemovesOpts))
1343 ------ Optimisation flags ------------------------------------------
1344 , Flag "O" (noArgM (setOptLevel 1))
1345 , Flag "Onot" (noArgM (\dflags -> do deprecate "Use -O0 instead"
1346 setOptLevel 0 dflags))
1347 , Flag "Odph" (noArgM setDPHOpt)
1348 , Flag "O" (optIntSuffixM (\mb_n -> setOptLevel (mb_n `orElse` 1)))
1349 -- If the number is missing, use 1
1351 , Flag "fsimplifier-phases" (intSuffix (\n d -> d{ simplPhases = n }))
1352 , Flag "fmax-simplifier-iterations" (intSuffix (\n d -> d{ maxSimplIterations = n }))
1353 , Flag "fspec-constr-threshold" (intSuffix (\n d -> d{ specConstrThreshold = Just n }))
1354 , Flag "fno-spec-constr-threshold" (noArg (\d -> d{ specConstrThreshold = Nothing }))
1355 , Flag "fspec-constr-count" (intSuffix (\n d -> d{ specConstrCount = Just n }))
1356 , Flag "fno-spec-constr-count" (noArg (\d -> d{ specConstrCount = Nothing }))
1357 , Flag "fliberate-case-threshold" (intSuffix (\n d -> d{ liberateCaseThreshold = Just n }))
1358 , Flag "fno-liberate-case-threshold" (noArg (\d -> d{ liberateCaseThreshold = Nothing }))
1359 , Flag "frule-check" (SepArg (\s -> upd (\d -> d{ ruleCheck = Just s })))
1360 , Flag "fcontext-stack" (intSuffix (\n d -> d{ ctxtStkDepth = n }))
1361 , Flag "fstrictness-before" (intSuffix (\n d -> d{ strictnessBefore = n : strictnessBefore d }))
1362 , Flag "ffloat-lam-args" (intSuffix (\n d -> d{ floatLamArgs = Just n }))
1363 , Flag "ffloat-all-lams" (noArg (\d -> d{ floatLamArgs = Nothing }))
1365 ------ Profiling ----------------------------------------------------
1367 -- XXX Should the -f* flags be deprecated?
1368 -- They don't seem to be documented
1369 , Flag "fauto-sccs-on-all-toplevs" (NoArg (setDynFlag Opt_AutoSccsOnAllToplevs))
1370 , Flag "auto-all" (NoArg (setDynFlag Opt_AutoSccsOnAllToplevs))
1371 , Flag "no-auto-all" (NoArg (unSetDynFlag Opt_AutoSccsOnAllToplevs))
1372 , Flag "fauto-sccs-on-exported-toplevs" (NoArg (setDynFlag Opt_AutoSccsOnExportedToplevs))
1373 , Flag "auto" (NoArg (setDynFlag Opt_AutoSccsOnExportedToplevs))
1374 , Flag "no-auto" (NoArg (unSetDynFlag Opt_AutoSccsOnExportedToplevs))
1375 , Flag "fauto-sccs-on-individual-cafs" (NoArg (setDynFlag Opt_AutoSccsOnIndividualCafs))
1376 , Flag "caf-all" (NoArg (setDynFlag Opt_AutoSccsOnIndividualCafs))
1377 , Flag "no-caf-all" (NoArg (unSetDynFlag Opt_AutoSccsOnIndividualCafs))
1379 ------ DPH flags ----------------------------------------------------
1381 , Flag "fdph-seq" (NoArg (setDPHBackend DPHSeq))
1382 , Flag "fdph-par" (NoArg (setDPHBackend DPHPar))
1383 , Flag "fdph-this" (NoArg (setDPHBackend DPHThis))
1384 , Flag "fdph-none" (NoArg (setDPHBackend DPHNone))
1386 ------ Compiler flags -----------------------------------------------
1388 , Flag "fasm" (NoArg (setObjTarget HscAsm))
1389 , Flag "fvia-c" (NoArg
1390 (addWarn "The -fvia-c flag does nothing; it will be removed in a future GHC release"))
1391 , Flag "fvia-C" (NoArg
1392 (addWarn "The -fvia-C flag does nothing; it will be removed in a future GHC release"))
1393 , Flag "fllvm" (NoArg (setObjTarget HscLlvm))
1395 , Flag "fno-code" (NoArg (do upd $ \d -> d{ ghcLink=NoLink }
1396 setTarget HscNothing))
1397 , Flag "fbyte-code" (NoArg (setTarget HscInterpreted))
1398 , Flag "fobject-code" (NoArg (setTarget defaultHscTarget))
1399 , Flag "fglasgow-exts" (NoArg (enableGlasgowExts >> deprecate "Use individual extensions instead"))
1400 , Flag "fno-glasgow-exts" (NoArg (disableGlasgowExts >> deprecate "Use individual extensions instead"))
1402 ++ map (mkFlag turnOn "f" setDynFlag ) fFlags
1403 ++ map (mkFlag turnOff "fno-" unSetDynFlag) fFlags
1404 ++ map (mkFlag turnOn "f" setExtensionFlag ) fLangFlags
1405 ++ map (mkFlag turnOff "fno-" unSetExtensionFlag) fLangFlags
1406 ++ map (mkFlag turnOn "X" setExtensionFlag ) xFlags
1407 ++ map (mkFlag turnOff "XNo" unSetExtensionFlag) xFlags
1408 ++ map (mkFlag turnOn "X" setLanguage) languageFlags
1410 package_flags :: [Flag (CmdLineP DynFlags)]
1412 ------- Packages ----------------------------------------------------
1413 Flag "package-conf" (HasArg extraPkgConf_)
1414 , Flag "no-user-package-conf" (NoArg (unSetDynFlag Opt_ReadUserPackageConf))
1415 , Flag "package-name" (hasArg setPackageName)
1416 , Flag "package-id" (HasArg exposePackageId)
1417 , Flag "package" (HasArg exposePackage)
1418 , Flag "hide-package" (HasArg hidePackage)
1419 , Flag "hide-all-packages" (NoArg (setDynFlag Opt_HideAllPackages))
1420 , Flag "ignore-package" (HasArg ignorePackage)
1421 , Flag "syslib" (HasArg (\s -> do { exposePackage s
1422 ; deprecate "Use -package instead" }))
1425 type TurnOnFlag = Bool -- True <=> we are turning the flag on
1426 -- False <=> we are turning the flag off
1427 turnOn :: TurnOnFlag; turnOn = True
1428 turnOff :: TurnOnFlag; turnOff = False
1431 = ( String -- Flag in string form
1432 , flag -- Flag in internal form
1433 , TurnOnFlag -> DynP ()) -- Extra action to run when the flag is found
1434 -- Typically, emit a warning or error
1436 mkFlag :: TurnOnFlag -- ^ True <=> it should be turned on
1437 -> String -- ^ The flag prefix
1438 -> (flag -> DynP ()) -- ^ What to do when the flag is found
1439 -> FlagSpec flag -- ^ Specification of this particular flag
1440 -> Flag (CmdLineP DynFlags)
1441 mkFlag turn_on flagPrefix f (name, flag, extra_action)
1442 = Flag (flagPrefix ++ name) (NoArg (f flag >> extra_action turn_on))
1444 deprecatedForExtension :: String -> TurnOnFlag -> DynP ()
1445 deprecatedForExtension lang turn_on
1446 = deprecate ("use -X" ++ flag ++ " or pragma {-# LANGUAGE " ++ flag ++ " #-} instead")
1448 flag | turn_on = lang
1449 | otherwise = "No"++lang
1451 useInstead :: String -> TurnOnFlag -> DynP ()
1452 useInstead flag turn_on
1453 = deprecate ("Use -f" ++ no ++ flag ++ " instead")
1455 no = if turn_on then "" else "no-"
1457 nop :: TurnOnFlag -> DynP ()
1460 -- | These @-f\<blah\>@ flags can all be reversed with @-fno-\<blah\>@
1461 fFlags :: [FlagSpec DynFlag]
1463 ( "warn-dodgy-foreign-imports", Opt_WarnDodgyForeignImports, nop ),
1464 ( "warn-dodgy-exports", Opt_WarnDodgyExports, nop ),
1465 ( "warn-dodgy-imports", Opt_WarnDodgyImports, nop ),
1466 ( "warn-duplicate-exports", Opt_WarnDuplicateExports, nop ),
1467 ( "warn-hi-shadowing", Opt_WarnHiShadows, nop ),
1468 ( "warn-implicit-prelude", Opt_WarnImplicitPrelude, nop ),
1469 ( "warn-incomplete-patterns", Opt_WarnIncompletePatterns, nop ),
1470 ( "warn-incomplete-uni-patterns", Opt_WarnIncompleteUniPatterns, nop ),
1471 ( "warn-incomplete-record-updates", Opt_WarnIncompletePatternsRecUpd, nop ),
1472 ( "warn-missing-fields", Opt_WarnMissingFields, nop ),
1473 ( "warn-missing-import-lists", Opt_WarnMissingImportList, nop ),
1474 ( "warn-missing-methods", Opt_WarnMissingMethods, nop ),
1475 ( "warn-missing-signatures", Opt_WarnMissingSigs, nop ),
1476 ( "warn-missing-local-sigs", Opt_WarnMissingLocalSigs, nop ),
1477 ( "warn-name-shadowing", Opt_WarnNameShadowing, nop ),
1478 ( "warn-overlapping-patterns", Opt_WarnOverlappingPatterns, nop ),
1479 ( "warn-type-defaults", Opt_WarnTypeDefaults, nop ),
1480 ( "warn-monomorphism-restriction", Opt_WarnMonomorphism, nop ),
1481 ( "warn-unused-binds", Opt_WarnUnusedBinds, nop ),
1482 ( "warn-unused-imports", Opt_WarnUnusedImports, nop ),
1483 ( "warn-unused-matches", Opt_WarnUnusedMatches, nop ),
1484 ( "warn-warnings-deprecations", Opt_WarnWarningsDeprecations, nop ),
1485 ( "warn-deprecations", Opt_WarnWarningsDeprecations, nop ),
1486 ( "warn-deprecated-flags", Opt_WarnDeprecatedFlags, nop ),
1487 ( "warn-orphans", Opt_WarnOrphans, nop ),
1488 ( "warn-identities", Opt_WarnIdentities, nop ),
1489 ( "warn-auto-orphans", Opt_WarnAutoOrphans, nop ),
1490 ( "warn-tabs", Opt_WarnTabs, nop ),
1491 ( "warn-unrecognised-pragmas", Opt_WarnUnrecognisedPragmas, nop ),
1492 ( "warn-lazy-unlifted-bindings", Opt_WarnLazyUnliftedBindings, nop),
1493 ( "warn-unused-do-bind", Opt_WarnUnusedDoBind, nop ),
1494 ( "warn-wrong-do-bind", Opt_WarnWrongDoBind, nop ),
1495 ( "warn-alternative-layout-rule-transitional", Opt_WarnAlternativeLayoutRuleTransitional, nop ),
1496 ( "print-explicit-foralls", Opt_PrintExplicitForalls, nop ),
1497 ( "strictness", Opt_Strictness, nop ),
1498 ( "specialise", Opt_Specialise, nop ),
1499 ( "float-in", Opt_FloatIn, nop ),
1500 ( "static-argument-transformation", Opt_StaticArgumentTransformation, nop ),
1501 ( "full-laziness", Opt_FullLaziness, nop ),
1502 ( "liberate-case", Opt_LiberateCase, nop ),
1503 ( "spec-constr", Opt_SpecConstr, nop ),
1504 ( "cse", Opt_CSE, nop ),
1505 ( "ignore-interface-pragmas", Opt_IgnoreInterfacePragmas, nop ),
1506 ( "omit-interface-pragmas", Opt_OmitInterfacePragmas, nop ),
1507 ( "expose-all-unfoldings", Opt_ExposeAllUnfoldings, nop ),
1508 ( "do-lambda-eta-expansion", Opt_DoLambdaEtaExpansion, nop ),
1509 ( "ignore-asserts", Opt_IgnoreAsserts, nop ),
1510 ( "do-eta-reduction", Opt_DoEtaReduction, nop ),
1511 ( "case-merge", Opt_CaseMerge, nop ),
1512 ( "unbox-strict-fields", Opt_UnboxStrictFields, nop ),
1513 ( "method-sharing", Opt_MethodSharing,
1514 \_ -> deprecate "doesn't do anything any more"),
1515 -- Remove altogether in GHC 7.2
1516 ( "dicts-cheap", Opt_DictsCheap, nop ),
1517 ( "excess-precision", Opt_ExcessPrecision, nop ),
1518 ( "eager-blackholing", Opt_EagerBlackHoling, nop ),
1519 ( "print-bind-result", Opt_PrintBindResult, nop ),
1520 ( "force-recomp", Opt_ForceRecomp, nop ),
1521 ( "hpc-no-auto", Opt_Hpc_No_Auto, nop ),
1522 ( "rewrite-rules", Opt_EnableRewriteRules, useInstead "enable-rewrite-rules" ),
1523 ( "enable-rewrite-rules", Opt_EnableRewriteRules, nop ),
1524 ( "break-on-exception", Opt_BreakOnException, nop ),
1525 ( "break-on-error", Opt_BreakOnError, nop ),
1526 ( "print-evld-with-show", Opt_PrintEvldWithShow, nop ),
1527 ( "print-bind-contents", Opt_PrintBindContents, nop ),
1528 ( "run-cps", Opt_RunCPS, nop ),
1529 ( "run-cpsz", Opt_RunCPSZ, nop ),
1530 ( "new-codegen", Opt_TryNewCodeGen, nop ),
1531 ( "convert-to-zipper-and-back", Opt_ConvertToZipCfgAndBack, nop ),
1532 ( "vectorise", Opt_Vectorise, nop ),
1533 ( "regs-graph", Opt_RegsGraph, nop ),
1534 ( "regs-iterative", Opt_RegsIterative, nop ),
1535 ( "gen-manifest", Opt_GenManifest, nop ),
1536 ( "embed-manifest", Opt_EmbedManifest, nop ),
1537 ( "ext-core", Opt_EmitExternalCore, nop ),
1538 ( "shared-implib", Opt_SharedImplib, nop ),
1539 ( "ghci-sandbox", Opt_GhciSandbox, nop ),
1540 ( "helpful-errors", Opt_HelpfulErrors, nop ),
1541 ( "building-cabal-package", Opt_BuildingCabalPackage, nop ),
1542 ( "implicit-import-qualified", Opt_ImplicitImportQualified, nop )
1545 -- | These @-f\<blah\>@ flags can all be reversed with @-fno-\<blah\>@
1546 fLangFlags :: [FlagSpec ExtensionFlag]
1548 ( "th", Opt_TemplateHaskell,
1549 deprecatedForExtension "TemplateHaskell" >> checkTemplateHaskellOk ),
1550 ( "fi", Opt_ForeignFunctionInterface,
1551 deprecatedForExtension "ForeignFunctionInterface" ),
1552 ( "ffi", Opt_ForeignFunctionInterface,
1553 deprecatedForExtension "ForeignFunctionInterface" ),
1554 ( "arrows", Opt_Arrows,
1555 deprecatedForExtension "Arrows" ),
1556 ( "generics", Opt_Generics,
1557 deprecatedForExtension "Generics" ),
1558 ( "implicit-prelude", Opt_ImplicitPrelude,
1559 deprecatedForExtension "ImplicitPrelude" ),
1560 ( "bang-patterns", Opt_BangPatterns,
1561 deprecatedForExtension "BangPatterns" ),
1562 ( "monomorphism-restriction", Opt_MonomorphismRestriction,
1563 deprecatedForExtension "MonomorphismRestriction" ),
1564 ( "mono-pat-binds", Opt_MonoPatBinds,
1565 deprecatedForExtension "MonoPatBinds" ),
1566 ( "extended-default-rules", Opt_ExtendedDefaultRules,
1567 deprecatedForExtension "ExtendedDefaultRules" ),
1568 ( "implicit-params", Opt_ImplicitParams,
1569 deprecatedForExtension "ImplicitParams" ),
1570 ( "scoped-type-variables", Opt_ScopedTypeVariables,
1571 deprecatedForExtension "ScopedTypeVariables" ),
1572 ( "parr", Opt_ParallelArrays,
1573 deprecatedForExtension "ParallelArrays" ),
1574 ( "PArr", Opt_ParallelArrays,
1575 deprecatedForExtension "ParallelArrays" ),
1576 ( "allow-overlapping-instances", Opt_OverlappingInstances,
1577 deprecatedForExtension "OverlappingInstances" ),
1578 ( "allow-undecidable-instances", Opt_UndecidableInstances,
1579 deprecatedForExtension "UndecidableInstances" ),
1580 ( "allow-incoherent-instances", Opt_IncoherentInstances,
1581 deprecatedForExtension "IncoherentInstances" )
1584 supportedLanguages :: [String]
1585 supportedLanguages = [ name | (name, _, _) <- languageFlags ]
1587 supportedExtensions :: [String]
1588 supportedExtensions = [ name' | (name, _, _) <- xFlags, name' <- [name, "No" ++ name] ]
1590 supportedLanguagesAndExtensions :: [String]
1591 supportedLanguagesAndExtensions = supportedLanguages ++ supportedExtensions
1593 -- | These -X<blah> flags cannot be reversed with -XNo<blah>
1594 languageFlags :: [FlagSpec Language]
1596 ( "Haskell98", Haskell98, nop ),
1597 ( "Haskell2010", Haskell2010, nop )
1600 -- | These -X<blah> flags can all be reversed with -XNo<blah>
1601 xFlags :: [FlagSpec ExtensionFlag]
1603 ( "CPP", Opt_Cpp, nop ),
1604 ( "PostfixOperators", Opt_PostfixOperators, nop ),
1605 ( "TupleSections", Opt_TupleSections, nop ),
1606 ( "PatternGuards", Opt_PatternGuards, nop ),
1607 ( "UnicodeSyntax", Opt_UnicodeSyntax, nop ),
1608 ( "MagicHash", Opt_MagicHash, nop ),
1609 ( "PolymorphicComponents", Opt_PolymorphicComponents, nop ),
1610 ( "ExistentialQuantification", Opt_ExistentialQuantification, nop ),
1611 ( "KindSignatures", Opt_KindSignatures, nop ),
1612 ( "EmptyDataDecls", Opt_EmptyDataDecls, nop ),
1613 ( "ParallelListComp", Opt_ParallelListComp, nop ),
1614 ( "TransformListComp", Opt_TransformListComp, nop ),
1615 ( "MonadComprehensions", Opt_MonadComprehensions, nop),
1616 ( "ForeignFunctionInterface", Opt_ForeignFunctionInterface, nop ),
1617 ( "UnliftedFFITypes", Opt_UnliftedFFITypes, nop ),
1618 ( "GHCForeignImportPrim", Opt_GHCForeignImportPrim, nop ),
1619 ( "LiberalTypeSynonyms", Opt_LiberalTypeSynonyms, nop ),
1620 ( "Rank2Types", Opt_Rank2Types, nop ),
1621 ( "RankNTypes", Opt_RankNTypes, nop ),
1622 ( "ImpredicativeTypes", Opt_ImpredicativeTypes, nop),
1623 ( "TypeOperators", Opt_TypeOperators, nop ),
1624 ( "RecursiveDo", Opt_RecursiveDo, -- Enables 'mdo'
1625 deprecatedForExtension "DoRec"),
1626 ( "DoRec", Opt_DoRec, nop ), -- Enables 'rec' keyword
1627 ( "Arrows", Opt_Arrows, nop ),
1628 ( "ParallelArrays", Opt_ParallelArrays, nop ),
1629 ( "TemplateHaskell", Opt_TemplateHaskell, checkTemplateHaskellOk ),
1630 ( "QuasiQuotes", Opt_QuasiQuotes, nop ),
1631 ( "Generics", Opt_Generics,
1632 \ _ -> deprecate "it does nothing; look into -XDefaultSignatures and -XDeriveGeneric for generic programming support." ),
1633 ( "ImplicitPrelude", Opt_ImplicitPrelude, nop ),
1634 ( "RecordWildCards", Opt_RecordWildCards, nop ),
1635 ( "NamedFieldPuns", Opt_RecordPuns, nop ),
1636 ( "RecordPuns", Opt_RecordPuns,
1637 deprecatedForExtension "NamedFieldPuns" ),
1638 ( "DisambiguateRecordFields", Opt_DisambiguateRecordFields, nop ),
1639 ( "OverloadedStrings", Opt_OverloadedStrings, nop ),
1640 ( "GADTs", Opt_GADTs, nop ),
1641 ( "GADTSyntax", Opt_GADTSyntax, nop ),
1642 ( "ViewPatterns", Opt_ViewPatterns, nop ),
1643 ( "TypeFamilies", Opt_TypeFamilies, nop ),
1644 ( "BangPatterns", Opt_BangPatterns, nop ),
1645 ( "MonomorphismRestriction", Opt_MonomorphismRestriction, nop ),
1646 ( "NPlusKPatterns", Opt_NPlusKPatterns, nop ),
1647 ( "DoAndIfThenElse", Opt_DoAndIfThenElse, nop ),
1648 ( "RebindableSyntax", Opt_RebindableSyntax, nop ),
1649 ( "MonoPatBinds", Opt_MonoPatBinds, nop ),
1650 ( "ExplicitForAll", Opt_ExplicitForAll, nop ),
1651 ( "AlternativeLayoutRule", Opt_AlternativeLayoutRule, nop ),
1652 ( "AlternativeLayoutRuleTransitional",Opt_AlternativeLayoutRuleTransitional, nop ),
1653 ( "DatatypeContexts", Opt_DatatypeContexts, nop ),
1654 ( "NondecreasingIndentation", Opt_NondecreasingIndentation, nop ),
1655 ( "RelaxedLayout", Opt_RelaxedLayout, nop ),
1656 ( "MonoLocalBinds", Opt_MonoLocalBinds, nop ),
1657 ( "RelaxedPolyRec", Opt_RelaxedPolyRec,
1658 \ turn_on -> if not turn_on
1659 then deprecate "You can't turn off RelaxedPolyRec any more"
1661 ( "ExtendedDefaultRules", Opt_ExtendedDefaultRules, nop ),
1662 ( "ImplicitParams", Opt_ImplicitParams, nop ),
1663 ( "ScopedTypeVariables", Opt_ScopedTypeVariables, nop ),
1665 ( "PatternSignatures", Opt_ScopedTypeVariables,
1666 deprecatedForExtension "ScopedTypeVariables" ),
1668 ( "UnboxedTuples", Opt_UnboxedTuples, nop ),
1669 ( "StandaloneDeriving", Opt_StandaloneDeriving, nop ),
1670 ( "DeriveDataTypeable", Opt_DeriveDataTypeable, nop ),
1671 ( "DeriveFunctor", Opt_DeriveFunctor, nop ),
1672 ( "DeriveTraversable", Opt_DeriveTraversable, nop ),
1673 ( "DeriveFoldable", Opt_DeriveFoldable, nop ),
1674 ( "DeriveGeneric", Opt_DeriveGeneric, nop ),
1675 ( "DefaultSignatures", Opt_DefaultSignatures, nop ),
1676 ( "TypeSynonymInstances", Opt_TypeSynonymInstances, nop ),
1677 ( "FlexibleContexts", Opt_FlexibleContexts, nop ),
1678 ( "FlexibleInstances", Opt_FlexibleInstances, nop ),
1679 ( "ConstrainedClassMethods", Opt_ConstrainedClassMethods, nop ),
1680 ( "MultiParamTypeClasses", Opt_MultiParamTypeClasses, nop ),
1681 ( "FunctionalDependencies", Opt_FunctionalDependencies, nop ),
1682 ( "GeneralizedNewtypeDeriving", Opt_GeneralizedNewtypeDeriving, nop ),
1683 ( "OverlappingInstances", Opt_OverlappingInstances, nop ),
1684 ( "UndecidableInstances", Opt_UndecidableInstances, nop ),
1685 ( "IncoherentInstances", Opt_IncoherentInstances, nop ),
1686 ( "PackageImports", Opt_PackageImports, nop )
1689 defaultFlags :: [DynFlag]
1691 = [ Opt_AutoLinkPackages,
1692 Opt_ReadUserPackageConf,
1696 #if GHC_DEFAULT_NEW_CODEGEN
1702 Opt_PrintBindContents,
1707 ++ [f | (ns,f) <- optLevelFlags, 0 `elem` ns]
1708 -- The default -O0 options
1712 impliedFlags :: [(ExtensionFlag, TurnOnFlag, ExtensionFlag)]
1714 = [ (Opt_RankNTypes, turnOn, Opt_ExplicitForAll)
1715 , (Opt_Rank2Types, turnOn, Opt_ExplicitForAll)
1716 , (Opt_ScopedTypeVariables, turnOn, Opt_ExplicitForAll)
1717 , (Opt_LiberalTypeSynonyms, turnOn, Opt_ExplicitForAll)
1718 , (Opt_ExistentialQuantification, turnOn, Opt_ExplicitForAll)
1719 , (Opt_PolymorphicComponents, turnOn, Opt_ExplicitForAll)
1720 , (Opt_FlexibleInstances, turnOn, Opt_TypeSynonymInstances)
1721 , (Opt_FunctionalDependencies, turnOn, Opt_MultiParamTypeClasses)
1723 , (Opt_RebindableSyntax, turnOff, Opt_ImplicitPrelude) -- NB: turn off!
1725 , (Opt_GADTs, turnOn, Opt_GADTSyntax)
1726 , (Opt_GADTs, turnOn, Opt_MonoLocalBinds)
1727 , (Opt_TypeFamilies, turnOn, Opt_MonoLocalBinds)
1729 , (Opt_TypeFamilies, turnOn, Opt_KindSignatures) -- Type families use kind signatures
1730 -- all over the place
1732 , (Opt_ImpredicativeTypes, turnOn, Opt_RankNTypes)
1734 -- Record wild-cards implies field disambiguation
1735 -- Otherwise if you write (C {..}) you may well get
1736 -- stuff like " 'a' not in scope ", which is a bit silly
1737 -- if the compiler has just filled in field 'a' of constructor 'C'
1738 , (Opt_RecordWildCards, turnOn, Opt_DisambiguateRecordFields)
1740 , (Opt_ParallelArrays, turnOn, Opt_ParallelListComp)
1743 optLevelFlags :: [([Int], DynFlag)]
1745 = [ ([0], Opt_IgnoreInterfacePragmas)
1746 , ([0], Opt_OmitInterfacePragmas)
1748 , ([1,2], Opt_IgnoreAsserts)
1749 , ([1,2], Opt_EnableRewriteRules) -- Off for -O0; see Note [Scoping for Builtin rules]
1751 , ([1,2], Opt_DoEtaReduction)
1752 , ([1,2], Opt_CaseMerge)
1753 , ([1,2], Opt_Strictness)
1755 , ([1,2], Opt_FullLaziness)
1756 , ([1,2], Opt_Specialise)
1757 , ([1,2], Opt_FloatIn)
1759 , ([2], Opt_LiberateCase)
1760 , ([2], Opt_SpecConstr)
1761 , ([2], Opt_RegsGraph)
1763 -- , ([2], Opt_StaticArgumentTransformation)
1764 -- Max writes: I think it's probably best not to enable SAT with -O2 for the
1765 -- 6.10 release. The version of SAT in HEAD at the moment doesn't incorporate
1766 -- several improvements to the heuristics, and I'm concerned that without
1767 -- those changes SAT will interfere with some attempts to write "high
1768 -- performance Haskell", as we saw in some posts on Haskell-Cafe earlier
1769 -- this year. In particular, the version in HEAD lacks the tail call
1770 -- criterion, so many things that look like reasonable loops will be
1771 -- turned into functions with extra (unneccesary) thunk creation.
1773 , ([0,1,2], Opt_DoLambdaEtaExpansion)
1774 -- This one is important for a tiresome reason:
1775 -- we want to make sure that the bindings for data
1776 -- constructors are eta-expanded. This is probably
1777 -- a good thing anyway, but it seems fragile.
1780 -- -----------------------------------------------------------------------------
1781 -- Standard sets of warning options
1783 standardWarnings :: [DynFlag]
1785 = [ Opt_WarnWarningsDeprecations,
1786 Opt_WarnDeprecatedFlags,
1787 Opt_WarnUnrecognisedPragmas,
1788 Opt_WarnOverlappingPatterns,
1789 Opt_WarnMissingFields,
1790 Opt_WarnMissingMethods,
1791 Opt_WarnDuplicateExports,
1792 Opt_WarnLazyUnliftedBindings,
1793 Opt_WarnDodgyForeignImports,
1794 Opt_WarnWrongDoBind,
1795 Opt_WarnAlternativeLayoutRuleTransitional
1798 minusWOpts :: [DynFlag]
1799 -- Things you get with -W
1801 = standardWarnings ++
1802 [ Opt_WarnUnusedBinds,
1803 Opt_WarnUnusedMatches,
1804 Opt_WarnUnusedImports,
1805 Opt_WarnIncompletePatterns,
1806 Opt_WarnDodgyExports,
1807 Opt_WarnDodgyImports
1810 minusWallOpts :: [DynFlag]
1811 -- Things you get with -Wall
1814 [ Opt_WarnTypeDefaults,
1815 Opt_WarnNameShadowing,
1816 Opt_WarnMissingSigs,
1819 Opt_WarnUnusedDoBind
1822 minuswRemovesOpts :: [DynFlag]
1823 -- minuswRemovesOpts should be every warning option
1827 Opt_WarnIncompletePatternsRecUpd,
1828 Opt_WarnIncompleteUniPatterns,
1829 Opt_WarnMonomorphism,
1830 Opt_WarnUnrecognisedPragmas,
1831 Opt_WarnAutoOrphans,
1832 Opt_WarnImplicitPrelude
1835 enableGlasgowExts :: DynP ()
1836 enableGlasgowExts = do setDynFlag Opt_PrintExplicitForalls
1837 mapM_ setExtensionFlag glasgowExtsFlags
1839 disableGlasgowExts :: DynP ()
1840 disableGlasgowExts = do unSetDynFlag Opt_PrintExplicitForalls
1841 mapM_ unSetExtensionFlag glasgowExtsFlags
1843 glasgowExtsFlags :: [ExtensionFlag]
1844 glasgowExtsFlags = [
1845 Opt_ForeignFunctionInterface
1846 , Opt_UnliftedFFITypes
1847 , Opt_ImplicitParams
1848 , Opt_ScopedTypeVariables
1850 , Opt_TypeSynonymInstances
1851 , Opt_StandaloneDeriving
1852 , Opt_DeriveDataTypeable
1854 , Opt_DeriveFoldable
1855 , 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 })
1996 setDumpSimplPhases :: String -> DynP ()
1997 setDumpSimplPhases s = do forceRecompile
1998 upd (\dfs -> dfs { shouldDumpSimplPhase = Just spec })
2000 spec = case s of { ('=' : s') -> s'; _ -> s }
2002 setVerbosity :: Maybe Int -> DynP ()
2003 setVerbosity mb_n = upd (\dfs -> dfs{ verbosity = mb_n `orElse` 3 })
2005 addCmdlineHCInclude :: String -> DynP ()
2006 addCmdlineHCInclude a = upd (\s -> s{cmdlineHcIncludes = a : cmdlineHcIncludes s})
2008 extraPkgConf_ :: FilePath -> DynP ()
2009 extraPkgConf_ p = upd (\s -> s{ extraPkgConfs = p : extraPkgConfs s })
2011 exposePackage, exposePackageId, hidePackage, ignorePackage :: String -> DynP ()
2013 upd (\s -> s{ packageFlags = ExposePackage p : packageFlags s })
2015 upd (\s -> s{ packageFlags = ExposePackageId p : packageFlags s })
2017 upd (\s -> s{ packageFlags = HidePackage p : packageFlags s })
2019 upd (\s -> s{ packageFlags = IgnorePackage p : packageFlags s })
2021 setPackageName :: String -> DynFlags -> DynFlags
2022 setPackageName p s = s{ thisPackage = stringToPackageId p }
2024 -- If we're linking a binary, then only targets that produce object
2025 -- code are allowed (requests for other target types are ignored).
2026 setTarget :: HscTarget -> DynP ()
2027 setTarget l = upd set
2030 | ghcLink dfs /= LinkBinary || isObjectTarget l = dfs{ hscTarget = l }
2033 -- Changes the target only if we're compiling object code. This is
2034 -- used by -fasm and -fllvm, which switch from one to the other, but
2035 -- not from bytecode to object-code. The idea is that -fasm/-fllvm
2036 -- can be safely used in an OPTIONS_GHC pragma.
2037 setObjTarget :: HscTarget -> DynP ()
2038 setObjTarget l = updM set
2041 | isObjectTarget (hscTarget dflags)
2044 | cGhcUnregisterised /= "YES" ->
2045 do addWarn ("Compiler not unregisterised, so ignoring " ++ flag)
2048 | cGhcWithNativeCodeGen /= "YES" ->
2049 do addWarn ("Compiler has no native codegen, so ignoring " ++
2053 | cGhcUnregisterised == "YES" ->
2054 do addWarn ("Compiler unregisterised, so ignoring " ++ flag)
2056 | not ((arch == ArchX86_64) && (os == OSLinux || os == OSDarwin)) &&
2057 (not opt_Static || opt_PIC)
2059 do addWarn ("Ignoring " ++ flag ++ " as it is incompatible with -fPIC and -dynamic on this platform")
2061 _ -> return $ dflags { hscTarget = l }
2062 | otherwise = return dflags
2063 where platform = targetPlatform dflags
2064 arch = platformArch platform
2065 os = platformOS platform
2066 flag = showHscTargetFlag l
2068 setOptLevel :: Int -> DynFlags -> DynP DynFlags
2069 setOptLevel n dflags
2070 | hscTarget dflags == HscInterpreted && n > 0
2071 = do addWarn "-O conflicts with --interactive; -O ignored."
2074 = return (updOptLevel n dflags)
2077 -- -Odph is equivalent to
2079 -- -O2 optimise as much as possible
2080 -- -fmax-simplifier-iterations20 this is necessary sometimes
2081 -- -fsimplifier-phases=3 we use an additional simplifier phase for fusion
2083 setDPHOpt :: DynFlags -> DynP DynFlags
2084 setDPHOpt dflags = setOptLevel 2 (dflags { maxSimplIterations = 20
2088 -- Determines the package used by the vectoriser for the symbols of the vectorised code.
2089 -- 'DPHNone' indicates that no data-parallel backend library is available; hence, the
2090 -- vectoriser cannot be used.
2092 data DPHBackend = DPHPar -- "dph-par"
2093 | DPHSeq -- "dph-seq"
2094 | DPHThis -- the currently compiled package
2095 | DPHNone -- no DPH library available
2096 deriving(Eq, Ord, Enum, Show)
2098 setDPHBackend :: DPHBackend -> DynP ()
2099 setDPHBackend backend = upd $ \dflags -> dflags { dphBackend = backend }
2101 -- Query the DPH backend package to be used by the vectoriser and desugaring of DPH syntax.
2103 dphPackageMaybe :: DynFlags -> Maybe PackageId
2104 dphPackageMaybe dflags
2105 = case dphBackend dflags of
2106 DPHPar -> Just dphParPackageId
2107 DPHSeq -> Just dphSeqPackageId
2108 DPHThis -> Just (thisPackage dflags)
2111 setMainIs :: String -> DynP ()
2113 | not (null main_fn) && isLower (head main_fn)
2114 -- The arg looked like "Foo.Bar.baz"
2115 = upd $ \d -> d{ mainFunIs = Just main_fn,
2116 mainModIs = mkModule mainPackageId (mkModuleName main_mod) }
2118 | isUpper (head arg) -- The arg looked like "Foo" or "Foo.Bar"
2119 = upd $ \d -> d{ mainModIs = mkModule mainPackageId (mkModuleName arg) }
2121 | otherwise -- The arg looked like "baz"
2122 = upd $ \d -> d{ mainFunIs = Just arg }
2124 (main_mod, main_fn) = splitLongestPrefix arg (== '.')
2126 -----------------------------------------------------------------------------
2127 -- Paths & Libraries
2129 addImportPath, addLibraryPath, addIncludePath, addFrameworkPath :: FilePath -> DynP ()
2131 -- -i on its own deletes the import paths
2132 addImportPath "" = upd (\s -> s{importPaths = []})
2133 addImportPath p = upd (\s -> s{importPaths = importPaths s ++ splitPathList p})
2136 upd (\s -> s{libraryPaths = libraryPaths s ++ splitPathList p})
2139 upd (\s -> s{includePaths = includePaths s ++ splitPathList p})
2141 addFrameworkPath p =
2142 upd (\s -> s{frameworkPaths = frameworkPaths s ++ splitPathList p})
2144 #ifndef mingw32_TARGET_OS
2145 split_marker :: Char
2146 split_marker = ':' -- not configurable (ToDo)
2149 splitPathList :: String -> [String]
2150 splitPathList s = filter notNull (splitUp s)
2151 -- empty paths are ignored: there might be a trailing
2152 -- ':' in the initial list, for example. Empty paths can
2153 -- cause confusion when they are translated into -I options
2154 -- for passing to gcc.
2156 #ifndef mingw32_TARGET_OS
2157 splitUp xs = split split_marker xs
2159 -- Windows: 'hybrid' support for DOS-style paths in directory lists.
2161 -- That is, if "foo:bar:baz" is used, this interpreted as
2162 -- consisting of three entries, 'foo', 'bar', 'baz'.
2163 -- However, with "c:/foo:c:\\foo;x:/bar", this is interpreted
2164 -- as 3 elts, "c:/foo", "c:\\foo", "x:/bar"
2166 -- Notice that no attempt is made to fully replace the 'standard'
2167 -- split marker ':' with the Windows / DOS one, ';'. The reason being
2168 -- that this will cause too much breakage for users & ':' will
2169 -- work fine even with DOS paths, if you're not insisting on being silly.
2172 splitUp (x:':':div:xs) | div `elem` dir_markers
2173 = ((x:':':div:p): splitUp rs)
2175 (p,rs) = findNextPath xs
2176 -- we used to check for existence of the path here, but that
2177 -- required the IO monad to be threaded through the command-line
2178 -- parser which is quite inconvenient. The
2179 splitUp xs = cons p (splitUp rs)
2181 (p,rs) = findNextPath xs
2186 -- will be called either when we've consumed nought or the
2187 -- "<Drive>:/" part of a DOS path, so splitting is just a Q of
2188 -- finding the next split marker.
2190 case break (`elem` split_markers) xs of
2191 (p, _:ds) -> (p, ds)
2194 split_markers :: [Char]
2195 split_markers = [':', ';']
2197 dir_markers :: [Char]
2198 dir_markers = ['/', '\\']
2201 -- -----------------------------------------------------------------------------
2202 -- tmpDir, where we store temporary files.
2204 setTmpDir :: FilePath -> DynFlags -> DynFlags
2205 setTmpDir dir = alterSettings (\s -> s { sTmpDir = normalise dir })
2206 -- we used to fix /cygdrive/c/.. on Windows, but this doesn't
2207 -- seem necessary now --SDM 7/2/2008
2209 -----------------------------------------------------------------------------
2212 setRtsOpts :: String -> DynP ()
2213 setRtsOpts arg = upd $ \ d -> d {rtsOpts = Just arg}
2215 setRtsOptsEnabled :: RtsOptsEnabled -> DynP ()
2216 setRtsOptsEnabled arg = upd $ \ d -> d {rtsOptsEnabled = arg}
2218 -----------------------------------------------------------------------------
2221 setOptHpcDir :: String -> DynP ()
2222 setOptHpcDir arg = upd $ \ d -> d{hpcDir = arg}
2224 -----------------------------------------------------------------------------
2225 -- Via-C compilation stuff
2227 -- There are some options that we need to pass to gcc when compiling
2228 -- Haskell code via C, but are only supported by recent versions of
2229 -- gcc. The configure script decides which of these options we need,
2230 -- and puts them in the "settings" file in $topdir. The advantage of
2231 -- having these in a separate file is that the file can be created at
2232 -- install-time depending on the available gcc version, and even
2233 -- re-generated later if gcc is upgraded.
2235 -- The options below are not dependent on the version of gcc, only the
2238 picCCOpts :: DynFlags -> [String]
2240 #if darwin_TARGET_OS
2241 -- Apple prefers to do things the other way round.
2242 -- PIC is on by default.
2243 -- -mdynamic-no-pic:
2244 -- Turn off PIC code generation.
2246 -- Don't generate "common" symbols - these are unwanted
2247 -- in dynamic libraries.
2250 = ["-fno-common", "-U __PIC__","-D__PIC__"]
2252 = ["-mdynamic-no-pic"]
2253 #elif mingw32_TARGET_OS
2254 -- no -fPIC for Windows
2256 = ["-U __PIC__","-D__PIC__"]
2260 -- we need -fPIC for C files when we are compiling with -dynamic,
2261 -- otherwise things like stub.c files don't get compiled
2262 -- correctly. They need to reference data in the Haskell
2263 -- objects, but can't without -fPIC. See
2264 -- http://hackage.haskell.org/trac/ghc/wiki/Commentary/PositionIndependentCode
2265 | opt_PIC || not opt_Static
2266 = ["-fPIC", "-U __PIC__", "-D__PIC__"]
2271 -- -----------------------------------------------------------------------------
2275 can_split = cSupportsSplitObjs == "YES"
2277 -- -----------------------------------------------------------------------------
2280 compilerInfo :: DynFlags -> [(String, String)]
2282 = -- We always make "Project name" be first to keep parsing in
2283 -- other languages simple, i.e. when looking for other fields,
2284 -- you don't have to worry whether there is a leading '[' or not
2285 ("Project name", cProjectName)
2286 -- Next come the settings, so anything else can be overridden
2287 -- in the settings file (as "lookup" uses the first match for the
2289 : rawSettings dflags
2290 ++ [("Project version", cProjectVersion),
2291 ("Booter version", cBooterVersion),
2293 ("Build platform", cBuildPlatformString),
2294 ("Host platform", cHostPlatformString),
2295 ("Target platform", cTargetPlatformString),
2296 ("Have interpreter", cGhcWithInterpreter),
2297 ("Object splitting supported", cSupportsSplitObjs),
2298 ("Have native code generator", cGhcWithNativeCodeGen),
2299 ("Support SMP", cGhcWithSMP),
2300 ("Unregisterised", cGhcUnregisterised),
2301 ("Tables next to code", cGhcEnableTablesNextToCode),
2302 ("RTS ways", cGhcRTSWays),
2303 ("Leading underscore", cLeadingUnderscore),
2304 ("Debug on", show debugIsOn),
2305 ("LibDir", topDir dflags),
2306 ("Global Package DB", systemPackageConfig dflags),
2307 ("Gcc Linker flags", show cGccLinkerOpts),
2308 ("Ld Linker flags", show cLdLinkerOpts)