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
20 flattenExtensionFlags,
21 ensureFlattenedExtensionFlags,
32 HscTarget(..), isObjectTarget, defaultObjectTarget,
33 GhcMode(..), isOneShot,
34 GhcLink(..), isNoLink,
38 fFlags, fLangFlags, xFlags,
42 -- ** Manipulating DynFlags
43 defaultDynFlags, -- DynFlags
44 initDynFlags, -- DynFlags -> IO DynFlags
46 getOpts, -- DynFlags -> (DynFlags -> [a]) -> [a]
53 -- ** Parsing DynFlags
55 parseDynamicNoPackageFlags,
58 supportedLanguagesAndExtensions,
60 -- ** DynFlag C compiler options
61 machdepCCOpts, picCCOpts,
63 -- * Configuration of the stg-to-stg passes
67 -- * Compiler configuration suitable for display to the user
71 -- Only in stage 2 can we be sure that the RTS
72 -- exposes the appropriate runtime boolean
77 #include "HsVersions.h"
79 #ifndef OMIT_NATIVE_CODEGEN
84 import PrelNames ( mAIN )
86 import {-# SOURCE #-} Packages (PackageState)
87 import DriverPhases ( Phase(..), phaseInputExt )
90 import Constants ( mAX_CONTEXT_REDUCTION_DEPTH )
93 import Maybes ( orElse )
97 import Foreign.C ( CInt )
98 import {-# SOURCE #-} ErrUtils ( Severity(..), Message, mkLocMessage )
100 import System.IO.Unsafe ( unsafePerformIO )
102 import Control.Monad ( when )
106 import Data.Map (Map)
107 import qualified Data.Map as Map
108 import System.FilePath
109 import System.IO ( stderr, hPutChar )
111 -- -----------------------------------------------------------------------------
114 -- | Enumerates the simple on-or-off dynamic flags
120 | Opt_D_dump_cmmz_pretty
124 | Opt_D_dump_asm_native
125 | Opt_D_dump_asm_liveness
126 | Opt_D_dump_asm_coalesce
127 | Opt_D_dump_asm_regalloc
128 | Opt_D_dump_asm_regalloc_stages
129 | Opt_D_dump_asm_conflicts
130 | Opt_D_dump_asm_stats
131 | Opt_D_dump_asm_expanded
138 | Opt_D_dump_inlinings
139 | Opt_D_dump_rule_firings
140 | Opt_D_dump_occur_anal
144 | Opt_D_dump_simpl_iterations
145 | Opt_D_dump_simpl_phases
154 | Opt_D_dump_worker_wrapper
155 | Opt_D_dump_rn_trace
156 | Opt_D_dump_rn_stats
158 | Opt_D_dump_simpl_stats
159 | Opt_D_dump_tc_trace
160 | Opt_D_dump_if_trace
167 | Opt_D_verbose_core2core
168 | Opt_D_verbose_stg2stg
170 | Opt_D_dump_hi_diffs
171 | Opt_D_dump_minimal_imports
172 | Opt_D_dump_mod_cycles
173 | Opt_D_dump_view_pattern_commoning
174 | Opt_D_faststring_stats
175 | Opt_DumpToFile -- ^ Append dump output to files instead of stdout.
176 | Opt_D_no_debug_output
182 | Opt_WarnIsError -- -Werror; makes warnings fatal
183 | Opt_WarnDuplicateExports
185 | Opt_WarnImplicitPrelude
186 | Opt_WarnIncompletePatterns
187 | Opt_WarnIncompletePatternsRecUpd
188 | Opt_WarnMissingFields
189 | Opt_WarnMissingImportList
190 | Opt_WarnMissingMethods
191 | Opt_WarnMissingSigs
192 | Opt_WarnMissingLocalSigs
193 | Opt_WarnNameShadowing
194 | Opt_WarnOverlappingPatterns
195 | Opt_WarnTypeDefaults
196 | Opt_WarnMonomorphism
197 | Opt_WarnUnusedBinds
198 | Opt_WarnUnusedImports
199 | Opt_WarnUnusedMatches
200 | Opt_WarnWarningsDeprecations
201 | Opt_WarnDeprecatedFlags
202 | Opt_WarnDodgyExports
203 | Opt_WarnDodgyImports
206 | Opt_WarnUnrecognisedPragmas
207 | Opt_WarnDodgyForeignImports
208 | Opt_WarnLazyUnliftedBindings
209 | Opt_WarnUnusedDoBind
210 | Opt_WarnWrongDoBind
211 | Opt_WarnAlternativeLayoutRuleTransitional
213 | Opt_PrintExplicitForalls
220 | Opt_StaticArgumentTransformation
224 | Opt_DoLambdaEtaExpansion
228 | Opt_UnboxStrictFields
231 | Opt_EnableRewriteRules -- Apply rewrite rules during simplification
233 | Opt_RegsGraph -- do graph coloring register allocation
234 | Opt_RegsIterative -- do iterative coalescing graph coloring register allocation
237 | Opt_IgnoreInterfacePragmas
238 | Opt_OmitInterfacePragmas
239 | Opt_ExposeAllUnfoldings
242 | Opt_AutoSccsOnAllToplevs
243 | Opt_AutoSccsOnExportedToplevs
244 | Opt_AutoSccsOnIndividualCafs
251 | Opt_ExcessPrecision
252 | Opt_EagerBlackHoling
253 | Opt_ReadUserPackageConf
257 | Opt_HideAllPackages
258 | Opt_PrintBindResult
262 | Opt_BreakOnException
264 | Opt_PrintEvldWithShow
265 | Opt_PrintBindContents
268 | Opt_EmitExternalCore
270 | Opt_BuildingCabalPackage
276 | Opt_ConvertToZipCfgAndBack
277 | Opt_AutoLinkPackages
278 | Opt_ImplicitImportQualified
287 | Opt_KeepRawTokenStream
292 data Language = Haskell98 | Haskell2010
296 | Opt_OverlappingInstances
297 | Opt_UndecidableInstances
298 | Opt_IncoherentInstances
299 | Opt_MonomorphismRestriction
302 | Opt_RelaxedPolyRec -- Deprecated
303 | Opt_ExtendedDefaultRules -- Use GHC's extended rules for defaulting
304 | Opt_ForeignFunctionInterface
305 | Opt_UnliftedFFITypes
306 | Opt_GHCForeignImportPrim
307 | Opt_PArr -- Syntactic support for parallel arrays
308 | Opt_Arrows -- Arrow-notation syntax
309 | Opt_TemplateHaskell
312 | Opt_Generics -- "Derivable type classes"
313 | Opt_ImplicitPrelude
314 | Opt_ScopedTypeVariables
318 | Opt_OverloadedStrings
319 | Opt_DisambiguateRecordFields
320 | Opt_RecordWildCards
325 | Opt_DoAndIfThenElse
327 | Opt_StandaloneDeriving
328 | Opt_DeriveDataTypeable
330 | Opt_DeriveTraversable
333 | Opt_TypeSynonymInstances
334 | Opt_FlexibleContexts
335 | Opt_FlexibleInstances
336 | Opt_ConstrainedClassMethods
337 | Opt_MultiParamTypeClasses
338 | Opt_FunctionalDependencies
340 | Opt_PolymorphicComponents
341 | Opt_ExistentialQuantification
345 | Opt_ParallelListComp
346 | Opt_TransformListComp
347 | Opt_GeneralizedNewtypeDeriving
350 | Opt_PostfixOperators
353 | Opt_LiberalTypeSynonyms
356 | Opt_ImpredicativeTypes
359 | Opt_NewQualifiedOperators
361 | Opt_AlternativeLayoutRule
362 | Opt_AlternativeLayoutRuleTransitional
363 | Opt_DatatypeContexts
366 -- | Contains not only a collection of 'DynFlag's but also a plethora of
367 -- information relating to the compilation of a single file or GHC session
368 data DynFlags = DynFlags {
371 hscTarget :: HscTarget,
372 hscOutName :: String, -- ^ Name of the output file
373 extCoreName :: String, -- ^ Name of the .hcr output file
374 verbosity :: Int, -- ^ Verbosity level: see Note [Verbosity levels]
375 optLevel :: Int, -- ^ Optimisation level
376 simplPhases :: Int, -- ^ Number of simplifier phases
377 maxSimplIterations :: Int, -- ^ Max simplifier iterations
378 shouldDumpSimplPhase :: Maybe String,
379 ruleCheck :: Maybe String,
380 strictnessBefore :: [Int], -- ^ Additional demand analysis
382 specConstrThreshold :: Maybe Int, -- ^ Threshold for SpecConstr
383 specConstrCount :: Maybe Int, -- ^ Max number of specialisations for any one function
384 liberateCaseThreshold :: Maybe Int, -- ^ Threshold for LiberateCase
386 #ifndef OMIT_NATIVE_CODEGEN
387 targetPlatform :: Platform, -- ^ The platform we're compiling for. Used by the NCG.
389 stolen_x86_regs :: Int,
390 cmdlineHcIncludes :: [String], -- ^ @\-\#includes@
391 importPaths :: [FilePath],
393 mainFunIs :: Maybe String,
394 ctxtStkDepth :: Int, -- ^ Typechecker context stack depth
396 dphBackend :: DPHBackend,
398 thisPackage :: PackageId, -- ^ name of package currently being compiled
401 ways :: [Way], -- ^ Way flags from the command line
402 buildTag :: String, -- ^ The global \"way\" (e.g. \"p\" for prof)
403 rtsBuildTag :: String, -- ^ The RTS \"way\"
405 -- For object splitting
406 splitInfo :: Maybe (String,Int),
409 objectDir :: Maybe String,
410 dylibInstallName :: Maybe String,
411 hiDir :: Maybe String,
412 stubDir :: Maybe String,
418 outputFile :: Maybe String,
419 outputHi :: Maybe String,
420 dynLibLoader :: DynLibLoader,
422 -- | This is set by 'DriverPipeline.runPipeline' based on where
423 -- its output is going.
424 dumpPrefix :: Maybe FilePath,
426 -- | Override the 'dumpPrefix' set by 'DriverPipeline.runPipeline'.
427 -- Set by @-ddump-file-prefix@
428 dumpPrefixForce :: Maybe FilePath,
430 includePaths :: [String],
431 libraryPaths :: [String],
432 frameworkPaths :: [String], -- used on darwin only
433 cmdlineFrameworks :: [String], -- ditto
434 tmpDir :: String, -- no trailing '/'
436 ghcUsagePath :: FilePath, -- Filled in by SysTools
437 ghciUsagePath :: FilePath, -- ditto
438 rtsOpts :: Maybe String,
439 rtsOptsEnabled :: RtsOptsEnabled,
441 hpcDir :: String, -- ^ Path to store the .mix files
443 -- options for particular phases
451 opt_windres :: [String],
452 opt_lo :: [String], -- LLVM: llvm optimiser
453 opt_lc :: [String], -- LLVM: llc static compiler
455 -- commands for particular phases
457 pgm_P :: (String,[Option]),
459 pgm_c :: (String,[Option]),
460 pgm_m :: (String,[Option]),
461 pgm_s :: (String,[Option]),
462 pgm_a :: (String,[Option]),
463 pgm_l :: (String,[Option]),
464 pgm_dll :: (String,[Option]),
466 pgm_sysman :: String,
467 pgm_windres :: String,
468 pgm_lo :: (String,[Option]), -- LLVM: opt llvm optimiser
469 pgm_lc :: (String,[Option]), -- LLVM: llc static compiler
472 depMakefile :: FilePath,
473 depIncludePkgDeps :: Bool,
474 depExcludeMods :: [ModuleName],
475 depSuffixes :: [String],
478 extraPkgConfs :: [FilePath],
479 topDir :: FilePath, -- filled in by SysTools
480 systemPackageConfig :: FilePath, -- ditto
481 -- ^ The @-package-conf@ flags given on the command line, in the order
484 packageFlags :: [PackageFlag],
485 -- ^ The @-package@ and @-hide-package@ flags from the command-line
488 -- NB. do not modify this field, it is calculated by
489 -- Packages.initPackages and Packages.updatePackages.
490 pkgDatabase :: Maybe [PackageConfig],
491 pkgState :: PackageState,
494 -- These have to be IORefs, because the defaultCleanupHandler needs to
495 -- know what to clean when an exception happens
496 filesToClean :: IORef [FilePath],
497 dirsToClean :: IORef (Map FilePath FilePath),
501 language :: Maybe Language,
502 extensionFlags :: Either [OnOff ExtensionFlag]
505 -- | Message output action: use "ErrUtils" instead of this if you can
506 log_action :: Severity -> SrcSpan -> PprStyle -> Message -> IO (),
508 haddockOptions :: Maybe String
511 wayNames :: DynFlags -> [WayName]
512 wayNames = map wayName . ways
514 -- | The target code type of the compilation (if any).
516 -- Whenever you change the target, also make sure to set 'ghcLink' to
517 -- something sensible.
519 -- 'HscNothing' can be used to avoid generating any output, however, note
522 -- * This will not run the desugaring step, thus no warnings generated in
523 -- this step will be output. In particular, this includes warnings related
524 -- to pattern matching. You can run the desugarer manually using
525 -- 'GHC.desugarModule'.
527 -- * If a program uses Template Haskell the typechecker may try to run code
528 -- from an imported module. This will fail if no code has been generated
529 -- for this module. You can use 'GHC.needsTemplateHaskell' to detect
530 -- whether this might be the case and choose to either switch to a
531 -- different target or avoid typechecking such modules. (The latter may
532 -- preferable for security reasons.)
535 = HscC -- ^ Generate C code.
536 | HscAsm -- ^ Generate assembly using the native code generator.
537 | HscLlvm -- ^ Generate assembly using the llvm code generator.
538 | HscJava -- ^ Generate Java bytecode.
539 | HscInterpreted -- ^ Generate bytecode. (Requires 'LinkInMemory')
540 | HscNothing -- ^ Don't generate any code. See notes above.
543 -- | Will this target result in an object file on the disk?
544 isObjectTarget :: HscTarget -> Bool
545 isObjectTarget HscC = True
546 isObjectTarget HscAsm = True
547 isObjectTarget HscLlvm = True
548 isObjectTarget _ = False
550 -- | The 'GhcMode' tells us whether we're doing multi-module
551 -- compilation (controlled via the "GHC" API) or one-shot
552 -- (single-module) compilation. This makes a difference primarily to
553 -- the "Finder": in one-shot mode we look for interface files for
554 -- imported modules, but in multi-module mode we look for source files
555 -- in order to check whether they need to be recompiled.
557 = CompManager -- ^ @\-\-make@, GHCi, etc.
558 | OneShot -- ^ @ghc -c Foo.hs@
559 | MkDepend -- ^ @ghc -M@, see "Finder" for why we need this
562 instance Outputable GhcMode where
563 ppr CompManager = ptext (sLit "CompManager")
564 ppr OneShot = ptext (sLit "OneShot")
565 ppr MkDepend = ptext (sLit "MkDepend")
567 isOneShot :: GhcMode -> Bool
568 isOneShot OneShot = True
569 isOneShot _other = False
571 -- | What to do in the link step, if there is one.
573 = NoLink -- ^ Don't link at all
574 | LinkBinary -- ^ Link object code into a binary
575 | LinkInMemory -- ^ Use the in-memory dynamic linker (works for both
576 -- bytecode and object code).
577 | LinkDynLib -- ^ Link objects into a dynamic lib (DLL on Windows, DSO on ELF platforms)
580 isNoLink :: GhcLink -> Bool
581 isNoLink NoLink = True
584 -- Is it worth evaluating this Bool and caching it in the DynFlags value
585 -- during initDynFlags?
586 doingTickyProfiling :: DynFlags -> Bool
587 doingTickyProfiling _ = opt_Ticky
588 -- XXX -ticky is a static flag, because it implies -debug which is also
589 -- static. If the way flags were made dynamic, we could fix this.
592 = ExposePackage String
593 | ExposePackageId String
595 | IgnorePackage String
598 defaultHscTarget :: HscTarget
599 defaultHscTarget = defaultObjectTarget
601 -- | The 'HscTarget' value corresponding to the default way to create
602 -- object files on the current platform.
603 defaultObjectTarget :: HscTarget
605 | cGhcWithNativeCodeGen == "YES" = HscAsm
613 data RtsOptsEnabled = RtsOptsNone | RtsOptsSafeOnly | RtsOptsAll
615 -- | Used by 'GHC.newSession' to partially initialize a new 'DynFlags' value
616 initDynFlags :: DynFlags -> IO DynFlags
617 initDynFlags dflags = do
618 -- someday these will be dynamic flags
619 ways <- readIORef v_Ways
620 refFilesToClean <- newIORef []
621 refDirsToClean <- newIORef Map.empty
624 buildTag = mkBuildTag (filter (not . wayRTSOnly) ways),
625 rtsBuildTag = mkBuildTag ways,
626 filesToClean = refFilesToClean,
627 dirsToClean = refDirsToClean
630 -- | The normal 'DynFlags'. Note that they is not suitable for use in this form
631 -- and must be fully initialized by 'GHC.newSession' first.
632 defaultDynFlags :: DynFlags
635 ghcMode = CompManager,
636 ghcLink = LinkBinary,
637 hscTarget = defaultHscTarget,
643 maxSimplIterations = 4,
644 shouldDumpSimplPhase = Nothing,
646 specConstrThreshold = Just 200,
647 specConstrCount = Just 3,
648 liberateCaseThreshold = Just 200,
649 strictnessBefore = [],
651 #ifndef OMIT_NATIVE_CODEGEN
652 targetPlatform = defaultTargetPlatform,
655 cmdlineHcIncludes = [],
659 ctxtStkDepth = mAX_CONTEXT_REDUCTION_DEPTH,
663 thisPackage = mainPackageId,
666 dylibInstallName = Nothing,
670 objectSuf = phaseInputExt StopLn,
671 hcSuf = phaseInputExt HCc,
674 outputFile = Nothing,
676 dynLibLoader = SystemDependent,
677 dumpPrefix = Nothing,
678 dumpPrefixForce = Nothing,
682 cmdlineFrameworks = [],
683 tmpDir = cDEFAULT_TMPDIR,
685 rtsOptsEnabled = RtsOptsSafeOnly,
691 then ["-D__PIC__", "-U __PIC__"] -- this list is reversed
704 pkgDatabase = Nothing,
705 pkgState = panic "no package state yet: call GHC.setSessionDynFlags",
706 ways = panic "defaultDynFlags: No ways",
707 buildTag = panic "defaultDynFlags: No buildTag",
708 rtsBuildTag = panic "defaultDynFlags: No rtsBuildTag",
710 -- initSysTools fills all these in
711 ghcUsagePath = panic "defaultDynFlags: No ghciUsagePath",
712 ghciUsagePath = panic "defaultDynFlags: No ghciUsagePath",
713 topDir = panic "defaultDynFlags: No topDir",
714 systemPackageConfig = panic "no systemPackageConfig: call GHC.setSessionDynFlags",
715 pgm_L = panic "defaultDynFlags: No pgm_L",
716 pgm_P = panic "defaultDynFlags: No pgm_P",
717 pgm_F = panic "defaultDynFlags: No pgm_F",
718 pgm_c = panic "defaultDynFlags: No pgm_c",
719 pgm_m = panic "defaultDynFlags: No pgm_m",
720 pgm_s = panic "defaultDynFlags: No pgm_s",
721 pgm_a = panic "defaultDynFlags: No pgm_a",
722 pgm_l = panic "defaultDynFlags: No pgm_l",
723 pgm_dll = panic "defaultDynFlags: No pgm_dll",
724 pgm_T = panic "defaultDynFlags: No pgm_T",
725 pgm_sysman = panic "defaultDynFlags: No pgm_sysman",
726 pgm_windres = panic "defaultDynFlags: No pgm_windres",
727 pgm_lo = panic "defaultDynFlags: No pgm_lo",
728 pgm_lc = panic "defaultDynFlags: No pgm_lc",
729 -- end of initSysTools values
731 depMakefile = "Makefile",
732 depIncludePkgDeps = False,
735 -- end of ghc -M values
736 filesToClean = panic "defaultDynFlags: No filesToClean",
737 dirsToClean = panic "defaultDynFlags: No dirsToClean",
738 haddockOptions = Nothing,
739 flags = defaultFlags,
741 extensionFlags = Left [],
743 log_action = \severity srcSpan style msg ->
745 SevOutput -> printOutput (msg style)
746 SevInfo -> printErrs (msg style)
747 SevFatal -> printErrs (msg style)
750 printErrs ((mkLocMessage srcSpan msg) style)
751 -- careful (#2302): printErrs prints in UTF-8, whereas
752 -- converting to string first and using hPutStr would
753 -- just emit the low 8 bits of each unicode char.
757 Note [Verbosity levels]
758 ~~~~~~~~~~~~~~~~~~~~~~~
759 0 | print errors & warnings only
760 1 | minimal verbosity: print "compiling M ... done." for each module.
761 2 | equivalent to -dshow-passes
762 3 | equivalent to existing "ghc -v"
763 4 | "ghc -v -ddump-most"
764 5 | "ghc -v -ddump-all"
770 flattenExtensionFlags :: DynFlags -> DynFlags
771 flattenExtensionFlags dflags
772 = case extensionFlags dflags of
775 extensionFlags = Right $ flattenExtensionFlags' (language dflags) onoffs
778 panic "Flattening already-flattened extension flags"
780 ensureFlattenedExtensionFlags :: DynFlags -> DynFlags
781 ensureFlattenedExtensionFlags dflags
782 = case extensionFlags dflags of
785 extensionFlags = Right $ flattenExtensionFlags' (language dflags) onoffs
790 -- OnOffs accumulate in reverse order, so we use foldr in order to
791 -- process them in the right order
792 flattenExtensionFlags' :: Maybe Language -> [OnOff ExtensionFlag]
794 flattenExtensionFlags' ml = foldr f defaultExtensionFlags
795 where f (On f) flags = f : delete f flags
796 f (Off f) flags = delete f flags
797 defaultExtensionFlags = languageExtensions ml
799 languageExtensions :: Maybe Language -> [ExtensionFlag]
800 languageExtensions Nothing
801 = Opt_MonoPatBinds -- Experimentally, I'm making this non-standard
802 -- behaviour the default, to see if anyone notices
804 -- In due course I'd like Opt_MonoLocalBinds to be on by default
805 -- SLPJ September 2010
806 : languageExtensions (Just Haskell2010)
807 languageExtensions (Just Haskell98)
808 = [Opt_ImplicitPrelude,
809 Opt_MonomorphismRestriction,
811 Opt_DatatypeContexts]
812 languageExtensions (Just Haskell2010)
813 = [Opt_ImplicitPrelude,
814 Opt_MonomorphismRestriction,
815 Opt_DatatypeContexts,
817 Opt_ForeignFunctionInterface,
822 -- | Test whether a 'DynFlag' is set
823 dopt :: DynFlag -> DynFlags -> Bool
824 dopt f dflags = f `elem` (flags dflags)
827 dopt_set :: DynFlags -> DynFlag -> DynFlags
828 dopt_set dfs f = dfs{ flags = f : flags dfs }
830 -- | Unset a 'DynFlag'
831 dopt_unset :: DynFlags -> DynFlag -> DynFlags
832 dopt_unset dfs f = dfs{ flags = filter (/= f) (flags dfs) }
834 -- | Test whether a 'ExtensionFlag' is set
835 xopt :: ExtensionFlag -> DynFlags -> Bool
836 xopt f dflags = case extensionFlags dflags of
837 Left _ -> panic ("Testing for extension flag " ++ show f ++ " before flattening")
838 Right flags -> f `elem` flags
840 -- | Set a 'ExtensionFlag'
841 xopt_set :: DynFlags -> ExtensionFlag -> DynFlags
842 xopt_set dfs f = case extensionFlags dfs of
843 Left onoffs -> dfs { extensionFlags = Left (On f : onoffs) }
844 Right _ -> panic ("Setting extension flag " ++ show f ++ " after flattening")
846 -- | Set a 'ExtensionFlag'
847 xopt_set_flattened :: DynFlags -> ExtensionFlag -> DynFlags
848 xopt_set_flattened dfs f = case extensionFlags dfs of
850 panic ("Setting extension flag " ++ show f ++ " before flattening, but expected flattened")
852 dfs { extensionFlags = Right (f : delete f flags) }
854 -- | Unset a 'ExtensionFlag'
855 xopt_unset :: DynFlags -> ExtensionFlag -> DynFlags
856 xopt_unset dfs f = case extensionFlags dfs of
857 Left onoffs -> dfs { extensionFlags = Left (Off f : onoffs) }
858 Right _ -> panic ("Unsetting extension flag " ++ show f ++ " after flattening")
860 -- | Unset a 'ExtensionFlag'
861 xopt_unset_flattened :: DynFlags -> ExtensionFlag -> DynFlags
862 xopt_unset_flattened dfs f = case extensionFlags dfs of
864 panic ("Unsetting extension flag " ++ show f ++ " before flattening, but expected flattened")
866 dfs { extensionFlags = Right (delete f flags) }
868 -- | Retrieve the options corresponding to a particular @opt_*@ field in the correct order
869 getOpts :: DynFlags -- ^ 'DynFlags' to retrieve the options from
870 -> (DynFlags -> [a]) -- ^ Relevant record accessor: one of the @opt_*@ accessors
871 -> [a] -- ^ Correctly ordered extracted options
872 getOpts dflags opts = reverse (opts dflags)
873 -- We add to the options from the front, so we need to reverse the list
875 -- | Gets the verbosity flag for the current verbosity level. This is fed to
876 -- other tools, so GHC-specific verbosity flags like @-ddump-most@ are not included
877 getVerbFlag :: DynFlags -> String
879 | verbosity dflags >= 3 = "-v"
882 setObjectDir, setHiDir, setStubDir, setOutputDir, setDylibInstallName,
883 setObjectSuf, setHiSuf, setHcSuf, parseDynLibLoaderMode,
884 setPgmP, addOptl, addOptP,
885 addCmdlineFramework, addHaddockOpts
886 :: String -> DynFlags -> DynFlags
887 setOutputFile, setOutputHi, setDumpPrefixForce
888 :: Maybe String -> DynFlags -> DynFlags
890 setObjectDir f d = d{ objectDir = Just f}
891 setHiDir f d = d{ hiDir = Just f}
892 setStubDir f d = d{ stubDir = Just f, includePaths = f : includePaths d }
893 -- -stubdir D adds an implicit -I D, so that gcc can find the _stub.h file
894 -- \#included from the .hc file when compiling with -fvia-C.
895 setOutputDir f = setObjectDir f . setHiDir f . setStubDir f
896 setDylibInstallName f d = d{ dylibInstallName = Just f}
898 setObjectSuf f d = d{ objectSuf = f}
899 setHiSuf f d = d{ hiSuf = f}
900 setHcSuf f d = d{ hcSuf = f}
902 setOutputFile f d = d{ outputFile = f}
903 setOutputHi f d = d{ outputHi = f}
905 parseDynLibLoaderMode f d =
907 ("deploy", "") -> d{ dynLibLoader = Deployable }
908 ("sysdep", "") -> d{ dynLibLoader = SystemDependent }
909 _ -> ghcError (CmdLineError ("Unknown dynlib loader: " ++ f))
911 setDumpPrefixForce f d = d { dumpPrefixForce = f}
913 -- XXX HACK: Prelude> words "'does not' work" ===> ["'does","not'","work"]
914 -- Config.hs should really use Option.
915 setPgmP f d = let (pgm:args) = words f in d{ pgm_P = (pgm, map Option args)}
916 addOptl f d = d{ opt_l = f : opt_l d}
917 addOptP f d = d{ opt_P = f : opt_P d}
920 setDepMakefile :: FilePath -> DynFlags -> DynFlags
921 setDepMakefile f d = d { depMakefile = deOptDep f }
923 setDepIncludePkgDeps :: Bool -> DynFlags -> DynFlags
924 setDepIncludePkgDeps b d = d { depIncludePkgDeps = b }
926 addDepExcludeMod :: String -> DynFlags -> DynFlags
928 = d { depExcludeMods = mkModuleName (deOptDep m) : depExcludeMods d }
930 addDepSuffix :: FilePath -> DynFlags -> DynFlags
931 addDepSuffix s d = d { depSuffixes = deOptDep s : depSuffixes d }
934 -- We used to use "-optdep-flag -optdeparg", so for legacy applications
935 -- we need to strip the "-optdep" off of the arg
936 deOptDep :: String -> String
937 deOptDep x = case stripPrefix "-optdep" x of
941 addCmdlineFramework f d = d{ cmdlineFrameworks = f : cmdlineFrameworks d}
943 addHaddockOpts f d = d{ haddockOptions = Just f}
945 -- -----------------------------------------------------------------------------
946 -- Command-line options
948 -- | When invoking external tools as part of the compilation pipeline, we
949 -- pass these a sequence of options on the command-line. Rather than
950 -- just using a list of Strings, we use a type that allows us to distinguish
951 -- between filepaths and 'other stuff'. The reason for this is that
952 -- this type gives us a handle on transforming filenames, and filenames only,
953 -- to whatever format they're expected to be on a particular platform.
955 = FileOption -- an entry that _contains_ filename(s) / filepaths.
956 String -- a non-filepath prefix that shouldn't be
957 -- transformed (e.g., "/out=")
958 String -- the filepath/filename portion
961 showOpt :: Option -> String
962 showOpt (FileOption pre f) = pre ++ f
963 showOpt (Option s) = s
965 -----------------------------------------------------------------------------
966 -- Setting the optimisation level
968 updOptLevel :: Int -> DynFlags -> DynFlags
969 -- ^ Sets the 'DynFlags' to be appropriate to the optimisation level
971 = dfs2{ optLevel = final_n }
973 final_n = max 0 (min 2 n) -- Clamp to 0 <= n <= 2
974 dfs1 = foldr (flip dopt_unset) dfs remove_dopts
975 dfs2 = foldr (flip dopt_set) dfs1 extra_dopts
977 extra_dopts = [ f | (ns,f) <- optLevelFlags, final_n `elem` ns ]
978 remove_dopts = [ f | (ns,f) <- optLevelFlags, final_n `notElem` ns ]
980 -- -----------------------------------------------------------------------------
981 -- StgToDo: abstraction of stg-to-stg passes to run.
984 = StgDoMassageForProfiling -- should be (next to) last
985 -- There's also setStgVarInfo, but its absolute "lastness"
986 -- is so critical that it is hardwired in (no flag).
989 getStgToDo :: DynFlags -> [StgToDo]
993 stg_stats = dopt Opt_StgStats dflags
995 todo1 = if stg_stats then [D_stg_stats] else []
997 todo2 | WayProf `elem` wayNames dflags
998 = StgDoMassageForProfiling : todo1
1002 {- **********************************************************************
1006 %********************************************************************* -}
1008 -- -----------------------------------------------------------------------------
1009 -- Parsing the dynamic flags.
1011 -- | Parse dynamic flags from a list of command line arguments. Returns the
1012 -- the parsed 'DynFlags', the left-over arguments, and a list of warnings.
1013 -- Throws a 'UsageError' if errors occurred during parsing (such as unknown
1014 -- flags or missing arguments).
1015 parseDynamicFlags :: Monad m =>
1016 DynFlags -> [Located String]
1017 -> m (DynFlags, [Located String], [Located String])
1018 -- ^ Updated 'DynFlags', left-over arguments, and
1019 -- list of warnings.
1020 parseDynamicFlags dflags args = parseDynamicFlags_ dflags args True
1022 -- | Like 'parseDynamicFlags' but does not allow the package flags (-package,
1023 -- -hide-package, -ignore-package, -hide-all-packages, -package-conf).
1024 parseDynamicNoPackageFlags :: Monad m =>
1025 DynFlags -> [Located String]
1026 -> m (DynFlags, [Located String], [Located String])
1027 -- ^ Updated 'DynFlags', left-over arguments, and
1028 -- list of warnings.
1029 parseDynamicNoPackageFlags dflags args = parseDynamicFlags_ dflags args False
1031 parseDynamicFlags_ :: Monad m =>
1032 DynFlags -> [Located String] -> Bool
1033 -> m (DynFlags, [Located String], [Located String])
1034 parseDynamicFlags_ dflags0 args pkg_flags = do
1035 -- XXX Legacy support code
1036 -- We used to accept things like
1037 -- optdep-f -optdepdepend
1038 -- optdep-f -optdep depend
1039 -- optdep -f -optdepdepend
1040 -- optdep -f -optdep depend
1041 -- but the spaces trip up proper argument handling. So get rid of them.
1042 let f (L p "-optdep" : L _ x : xs) = (L p ("-optdep" ++ x)) : f xs
1043 f (x : xs) = x : f xs
1047 -- Note: -ignore-package (package_flags) must precede -i* (dynamic_flags)
1048 flag_spec | pkg_flags = package_flags ++ dynamic_flags
1049 | otherwise = dynamic_flags
1051 let ((leftover, errs, warns), dflags1)
1052 = runCmdLine (processArgs flag_spec args') dflags0
1053 when (not (null errs)) $ ghcError $ errorsToGhcException errs
1055 -- Cannot use -fPIC with registerised -fvia-C, because the mangler
1056 -- isn't up to the job. We know that if hscTarget == HscC, then the
1057 -- user has explicitly used -fvia-C, because -fasm is the default,
1058 -- unless there is no NCG on this platform. The latter case is
1059 -- checked when the -fPIC flag is parsed.
1061 let (pic_warns, dflags2)
1062 | opt_PIC && hscTarget dflags1 == HscC && cGhcUnregisterised == "NO"
1063 = ([L noSrcSpan $ "Warning: -fvia-C is incompatible with -fPIC; ignoring -fvia-C"],
1064 dflags1{ hscTarget = HscAsm })
1065 #if !(x86_64_TARGET_ARCH && linux_TARGET_OS)
1066 | (not opt_Static || opt_PIC) && hscTarget dflags1 == HscLlvm
1067 = ([L noSrcSpan $ "Warning: -fllvm is incompatible with -fPIC and -"
1068 ++ "dynamic on this platform;\n ignoring -fllvm"],
1069 dflags1{ hscTarget = HscAsm })
1071 | otherwise = ([], dflags1)
1073 return (dflags2, leftover, pic_warns ++ warns)
1076 {- **********************************************************************
1078 DynFlags specifications
1080 %********************************************************************* -}
1082 allFlags :: [String]
1083 allFlags = map ('-':) $
1084 [ flagName flag | flag <- dynamic_flags, ok (flagOptKind flag) ] ++
1085 map ("fno-"++) flags ++
1086 map ("f"++) flags ++
1087 map ("f"++) flags' ++
1088 map ("X"++) supportedExtensions
1089 where ok (PrefixPred _ _) = False
1091 flags = [ name | (name, _, _) <- fFlags ]
1092 flags' = [ name | (name, _, _) <- fLangFlags ]
1094 --------------- The main flags themselves ------------------
1095 dynamic_flags :: [Flag (CmdLineP DynFlags)]
1097 Flag "n" (NoArg (setDynFlag Opt_DryRun))
1098 , Flag "cpp" (NoArg (setExtensionFlag Opt_Cpp))
1099 , Flag "F" (NoArg (setDynFlag Opt_Pp))
1101 (HasArg (\s -> do { addCmdlineHCInclude s
1102 ; addWarn "-#include and INCLUDE pragmas are deprecated: They no longer have any effect" }))
1103 , Flag "v" (OptIntSuffix setVerbosity)
1105 ------- Specific phases --------------------------------------------
1106 -- need to appear before -pgmL to be parsed as LLVM flags.
1107 , Flag "pgmlo" (hasArg (\f d -> d{ pgm_lo = (f,[])}))
1108 , Flag "pgmlc" (hasArg (\f d -> d{ pgm_lc = (f,[])}))
1109 , Flag "pgmL" (hasArg (\f d -> d{ pgm_L = f}))
1110 , Flag "pgmP" (hasArg setPgmP)
1111 , Flag "pgmF" (hasArg (\f d -> d{ pgm_F = f}))
1112 , Flag "pgmc" (hasArg (\f d -> d{ pgm_c = (f,[])}))
1113 , Flag "pgmm" (hasArg (\f d -> d{ pgm_m = (f,[])}))
1114 , Flag "pgms" (hasArg (\f d -> d{ pgm_s = (f,[])}))
1115 , Flag "pgma" (hasArg (\f d -> d{ pgm_a = (f,[])}))
1116 , Flag "pgml" (hasArg (\f d -> d{ pgm_l = (f,[])}))
1117 , Flag "pgmdll" (hasArg (\f d -> d{ pgm_dll = (f,[])}))
1118 , Flag "pgmwindres" (hasArg (\f d -> d{ pgm_windres = f}))
1120 -- need to appear before -optl/-opta to be parsed as LLVM flags.
1121 , Flag "optlo" (hasArg (\f d -> d{ opt_lo = f : opt_lo d}))
1122 , Flag "optlc" (hasArg (\f d -> d{ opt_lc = f : opt_lc d}))
1123 , Flag "optL" (hasArg (\f d -> d{ opt_L = f : opt_L d}))
1124 , Flag "optP" (hasArg addOptP)
1125 , Flag "optF" (hasArg (\f d -> d{ opt_F = f : opt_F d}))
1126 , Flag "optc" (hasArg (\f d -> d{ opt_c = f : opt_c d}))
1127 , Flag "optm" (hasArg (\f d -> d{ opt_m = f : opt_m d}))
1128 , Flag "opta" (hasArg (\f d -> d{ opt_a = f : opt_a d}))
1129 , Flag "optl" (hasArg addOptl)
1130 , Flag "optwindres" (hasArg (\f d -> d{ opt_windres = f : opt_windres d}))
1133 (NoArg (if can_split
1134 then setDynFlag Opt_SplitObjs
1135 else addWarn "ignoring -fsplit-objs"))
1137 -------- ghc -M -----------------------------------------------------
1138 , Flag "dep-suffix" (hasArg addDepSuffix)
1139 , Flag "optdep-s" (hasArgDF addDepSuffix "Use -dep-suffix instead")
1140 , Flag "dep-makefile" (hasArg setDepMakefile)
1141 , Flag "optdep-f" (hasArgDF setDepMakefile "Use -dep-makefile instead")
1142 , Flag "optdep-w" (NoArg (deprecate "doesn't do anything"))
1143 , Flag "include-pkg-deps" (noArg (setDepIncludePkgDeps True))
1144 , Flag "optdep--include-prelude" (noArgDF (setDepIncludePkgDeps True) "Use -include-pkg-deps instead")
1145 , Flag "optdep--include-pkg-deps" (noArgDF (setDepIncludePkgDeps True) "Use -include-pkg-deps instead")
1146 , Flag "exclude-module" (hasArg addDepExcludeMod)
1147 , Flag "optdep--exclude-module" (hasArgDF addDepExcludeMod "Use -exclude-module instead")
1148 , Flag "optdep-x" (hasArgDF addDepExcludeMod "Use -exclude-module instead")
1150 -------- Linking ----------------------------------------------------
1151 , Flag "no-link" (noArg (\d -> d{ ghcLink=NoLink }))
1152 , Flag "shared" (noArg (\d -> d{ ghcLink=LinkDynLib }))
1153 , Flag "dynload" (hasArg parseDynLibLoaderMode)
1154 , Flag "dylib-install-name" (hasArg setDylibInstallName)
1156 ------- Libraries ---------------------------------------------------
1157 , Flag "L" (Prefix addLibraryPath)
1158 , Flag "l" (AnySuffix (upd . addOptl))
1160 ------- Frameworks --------------------------------------------------
1161 -- -framework-path should really be -F ...
1162 , Flag "framework-path" (HasArg addFrameworkPath)
1163 , Flag "framework" (hasArg addCmdlineFramework)
1165 ------- Output Redirection ------------------------------------------
1166 , Flag "odir" (hasArg setObjectDir)
1167 , Flag "o" (SepArg (upd . setOutputFile . Just))
1168 , Flag "ohi" (hasArg (setOutputHi . Just ))
1169 , Flag "osuf" (hasArg setObjectSuf)
1170 , Flag "hcsuf" (hasArg setHcSuf)
1171 , Flag "hisuf" (hasArg setHiSuf)
1172 , Flag "hidir" (hasArg setHiDir)
1173 , Flag "tmpdir" (hasArg setTmpDir)
1174 , Flag "stubdir" (hasArg setStubDir)
1175 , Flag "outputdir" (hasArg setOutputDir)
1176 , Flag "ddump-file-prefix" (hasArg (setDumpPrefixForce . Just))
1178 ------- Keeping temporary files -------------------------------------
1179 -- These can be singular (think ghc -c) or plural (think ghc --make)
1180 , Flag "keep-hc-file" (NoArg (setDynFlag Opt_KeepHcFiles))
1181 , Flag "keep-hc-files" (NoArg (setDynFlag Opt_KeepHcFiles))
1182 , Flag "keep-s-file" (NoArg (setDynFlag Opt_KeepSFiles))
1183 , Flag "keep-s-files" (NoArg (setDynFlag Opt_KeepSFiles))
1184 , Flag "keep-raw-s-file" (NoArg (setDynFlag Opt_KeepRawSFiles))
1185 , Flag "keep-raw-s-files" (NoArg (setDynFlag Opt_KeepRawSFiles))
1186 , Flag "keep-llvm-file" (NoArg (setDynFlag Opt_KeepLlvmFiles))
1187 , Flag "keep-llvm-files" (NoArg (setDynFlag Opt_KeepLlvmFiles))
1188 -- This only makes sense as plural
1189 , Flag "keep-tmp-files" (NoArg (setDynFlag Opt_KeepTmpFiles))
1191 ------- Miscellaneous ----------------------------------------------
1192 , Flag "no-auto-link-packages" (NoArg (unSetDynFlag Opt_AutoLinkPackages))
1193 , Flag "no-hs-main" (NoArg (setDynFlag Opt_NoHsMain))
1194 , Flag "with-rtsopts" (HasArg setRtsOpts)
1195 , Flag "rtsopts" (NoArg (setRtsOptsEnabled RtsOptsAll))
1196 , Flag "rtsopts=all" (NoArg (setRtsOptsEnabled RtsOptsAll))
1197 , Flag "rtsopts=some" (NoArg (setRtsOptsEnabled RtsOptsSafeOnly))
1198 , Flag "rtsopts=none" (NoArg (setRtsOptsEnabled RtsOptsNone))
1199 , Flag "no-rtsopts" (NoArg (setRtsOptsEnabled RtsOptsNone))
1200 , Flag "main-is" (SepArg setMainIs)
1201 , Flag "haddock" (NoArg (setDynFlag Opt_Haddock))
1202 , Flag "haddock-opts" (hasArg addHaddockOpts)
1203 , Flag "hpcdir" (SepArg setOptHpcDir)
1205 ------- recompilation checker --------------------------------------
1206 , Flag "recomp" (NoArg (do { unSetDynFlag Opt_ForceRecomp
1207 ; deprecate "Use -fno-force-recomp instead" }))
1208 , Flag "no-recomp" (NoArg (do { setDynFlag Opt_ForceRecomp
1209 ; deprecate "Use -fforce-recomp instead" }))
1211 ------ HsCpp opts ---------------------------------------------------
1212 , Flag "D" (AnySuffix (upd . addOptP))
1213 , Flag "U" (AnySuffix (upd . addOptP))
1215 ------- Include/Import Paths ----------------------------------------
1216 , Flag "I" (Prefix addIncludePath)
1217 , Flag "i" (OptPrefix addImportPath)
1219 ------ Debugging ----------------------------------------------------
1220 , Flag "dstg-stats" (NoArg (setDynFlag Opt_StgStats))
1222 , Flag "ddump-cmm" (setDumpFlag Opt_D_dump_cmm)
1223 , Flag "ddump-cmmz" (setDumpFlag Opt_D_dump_cmmz)
1224 , Flag "ddump-cmmz-pretty" (setDumpFlag Opt_D_dump_cmmz_pretty)
1225 , Flag "ddump-cps-cmm" (setDumpFlag Opt_D_dump_cps_cmm)
1226 , Flag "ddump-cvt-cmm" (setDumpFlag Opt_D_dump_cvt_cmm)
1227 , Flag "ddump-asm" (setDumpFlag Opt_D_dump_asm)
1228 , Flag "ddump-asm-native" (setDumpFlag Opt_D_dump_asm_native)
1229 , Flag "ddump-asm-liveness" (setDumpFlag Opt_D_dump_asm_liveness)
1230 , Flag "ddump-asm-coalesce" (setDumpFlag Opt_D_dump_asm_coalesce)
1231 , Flag "ddump-asm-regalloc" (setDumpFlag Opt_D_dump_asm_regalloc)
1232 , Flag "ddump-asm-conflicts" (setDumpFlag Opt_D_dump_asm_conflicts)
1233 , Flag "ddump-asm-regalloc-stages" (setDumpFlag Opt_D_dump_asm_regalloc_stages)
1234 , Flag "ddump-asm-stats" (setDumpFlag Opt_D_dump_asm_stats)
1235 , Flag "ddump-asm-expanded" (setDumpFlag Opt_D_dump_asm_expanded)
1236 , Flag "ddump-llvm" (NoArg (do { setObjTarget HscLlvm
1237 ; setDumpFlag' Opt_D_dump_llvm}))
1238 , Flag "ddump-cpranal" (setDumpFlag Opt_D_dump_cpranal)
1239 , Flag "ddump-deriv" (setDumpFlag Opt_D_dump_deriv)
1240 , Flag "ddump-ds" (setDumpFlag Opt_D_dump_ds)
1241 , Flag "ddump-flatC" (setDumpFlag Opt_D_dump_flatC)
1242 , Flag "ddump-foreign" (setDumpFlag Opt_D_dump_foreign)
1243 , Flag "ddump-inlinings" (setDumpFlag Opt_D_dump_inlinings)
1244 , Flag "ddump-rule-firings" (setDumpFlag Opt_D_dump_rule_firings)
1245 , Flag "ddump-occur-anal" (setDumpFlag Opt_D_dump_occur_anal)
1246 , Flag "ddump-parsed" (setDumpFlag Opt_D_dump_parsed)
1247 , Flag "ddump-rn" (setDumpFlag Opt_D_dump_rn)
1248 , Flag "ddump-simpl" (setDumpFlag Opt_D_dump_simpl)
1249 , Flag "ddump-simpl-iterations" (setDumpFlag Opt_D_dump_simpl_iterations)
1250 , Flag "ddump-simpl-phases" (OptPrefix setDumpSimplPhases)
1251 , Flag "ddump-spec" (setDumpFlag Opt_D_dump_spec)
1252 , Flag "ddump-prep" (setDumpFlag Opt_D_dump_prep)
1253 , Flag "ddump-stg" (setDumpFlag Opt_D_dump_stg)
1254 , Flag "ddump-stranal" (setDumpFlag Opt_D_dump_stranal)
1255 , Flag "ddump-tc" (setDumpFlag Opt_D_dump_tc)
1256 , Flag "ddump-types" (setDumpFlag Opt_D_dump_types)
1257 , Flag "ddump-rules" (setDumpFlag Opt_D_dump_rules)
1258 , Flag "ddump-cse" (setDumpFlag Opt_D_dump_cse)
1259 , Flag "ddump-worker-wrapper" (setDumpFlag Opt_D_dump_worker_wrapper)
1260 , Flag "ddump-rn-trace" (setDumpFlag Opt_D_dump_rn_trace)
1261 , Flag "ddump-if-trace" (setDumpFlag Opt_D_dump_if_trace)
1262 , Flag "ddump-tc-trace" (setDumpFlag Opt_D_dump_tc_trace)
1263 , Flag "ddump-splices" (setDumpFlag Opt_D_dump_splices)
1264 , Flag "ddump-rn-stats" (setDumpFlag Opt_D_dump_rn_stats)
1265 , Flag "ddump-opt-cmm" (setDumpFlag Opt_D_dump_opt_cmm)
1266 , Flag "ddump-simpl-stats" (setDumpFlag Opt_D_dump_simpl_stats)
1267 , Flag "ddump-bcos" (setDumpFlag Opt_D_dump_BCOs)
1268 , Flag "dsource-stats" (setDumpFlag Opt_D_source_stats)
1269 , Flag "dverbose-core2core" (NoArg (do { setVerbosity (Just 2)
1270 ; setVerboseCore2Core }))
1271 , Flag "dverbose-stg2stg" (setDumpFlag Opt_D_verbose_stg2stg)
1272 , Flag "ddump-hi" (setDumpFlag Opt_D_dump_hi)
1273 , Flag "ddump-minimal-imports" (setDumpFlag Opt_D_dump_minimal_imports)
1274 , Flag "ddump-vect" (setDumpFlag Opt_D_dump_vect)
1275 , Flag "ddump-hpc" (setDumpFlag Opt_D_dump_hpc)
1276 , Flag "ddump-mod-cycles" (setDumpFlag Opt_D_dump_mod_cycles)
1277 , Flag "ddump-view-pattern-commoning" (setDumpFlag Opt_D_dump_view_pattern_commoning)
1278 , Flag "ddump-to-file" (setDumpFlag Opt_DumpToFile)
1279 , Flag "ddump-hi-diffs" (setDumpFlag Opt_D_dump_hi_diffs)
1280 , Flag "ddump-rtti" (setDumpFlag Opt_D_dump_rtti)
1281 , Flag "dcore-lint" (NoArg (setDynFlag Opt_DoCoreLinting))
1282 , Flag "dstg-lint" (NoArg (setDynFlag Opt_DoStgLinting))
1283 , Flag "dcmm-lint" (NoArg (setDynFlag Opt_DoCmmLinting))
1284 , Flag "dasm-lint" (NoArg (setDynFlag Opt_DoAsmLinting))
1285 , Flag "dshow-passes" (NoArg (do forceRecompile
1286 setVerbosity (Just 2)))
1287 , Flag "dfaststring-stats" (NoArg (setDynFlag Opt_D_faststring_stats))
1289 ------ Machine dependant (-m<blah>) stuff ---------------------------
1291 , Flag "monly-2-regs" (noArg (\s -> s{stolen_x86_regs = 2}))
1292 , Flag "monly-3-regs" (noArg (\s -> s{stolen_x86_regs = 3}))
1293 , Flag "monly-4-regs" (noArg (\s -> s{stolen_x86_regs = 4}))
1294 , Flag "msse2" (NoArg (setDynFlag Opt_SSE2))
1296 ------ Warning opts -------------------------------------------------
1297 , Flag "W" (NoArg (mapM_ setDynFlag minusWOpts))
1298 , Flag "Werror" (NoArg (setDynFlag Opt_WarnIsError))
1299 , Flag "Wwarn" (NoArg (unSetDynFlag Opt_WarnIsError))
1300 , Flag "Wall" (NoArg (mapM_ setDynFlag minusWallOpts))
1301 , Flag "Wnot" (NoArg (do { mapM_ unSetDynFlag minusWallOpts
1302 ; deprecate "Use -w instead" }))
1303 , Flag "w" (NoArg (mapM_ unSetDynFlag minuswRemovesOpts))
1305 ------ Optimisation flags ------------------------------------------
1306 , Flag "O" (noArg (setOptLevel 1))
1307 , Flag "Onot" (noArgDF (setOptLevel 0) "Use -O0 instead")
1308 , Flag "Odph" (noArg setDPHOpt)
1309 , Flag "O" (OptIntSuffix (\mb_n -> upd (setOptLevel (mb_n `orElse` 1))))
1310 -- If the number is missing, use 1
1312 , Flag "fsimplifier-phases" (intSuffix (\n d -> d{ simplPhases = n }))
1313 , Flag "fmax-simplifier-iterations" (intSuffix (\n d -> d{ maxSimplIterations = n }))
1314 , Flag "fspec-constr-threshold" (intSuffix (\n d -> d{ specConstrThreshold = Just n }))
1315 , Flag "fno-spec-constr-threshold" (noArg (\d -> d{ specConstrThreshold = Nothing }))
1316 , Flag "fspec-constr-count" (intSuffix (\n d -> d{ specConstrCount = Just n }))
1317 , Flag "fno-spec-constr-count" (noArg (\d -> d{ specConstrCount = Nothing }))
1318 , Flag "fliberate-case-threshold" (intSuffix (\n d -> d{ liberateCaseThreshold = Just n }))
1319 , Flag "fno-liberate-case-threshold" (noArg (\d -> d{ liberateCaseThreshold = Nothing }))
1320 , Flag "frule-check" (SepArg (\s -> upd (\d -> d{ ruleCheck = Just s })))
1321 , Flag "fcontext-stack" (intSuffix (\n d -> d{ ctxtStkDepth = n }))
1322 , Flag "fstrictness-before" (intSuffix (\n d -> d{ strictnessBefore = n : strictnessBefore d }))
1324 ------ Profiling ----------------------------------------------------
1326 -- XXX Should the -f* flags be deprecated?
1327 -- They don't seem to be documented
1328 , Flag "fauto-sccs-on-all-toplevs" (NoArg (setDynFlag Opt_AutoSccsOnAllToplevs))
1329 , Flag "auto-all" (NoArg (setDynFlag Opt_AutoSccsOnAllToplevs))
1330 , Flag "no-auto-all" (NoArg (unSetDynFlag Opt_AutoSccsOnAllToplevs))
1331 , Flag "fauto-sccs-on-exported-toplevs" (NoArg (setDynFlag Opt_AutoSccsOnExportedToplevs))
1332 , Flag "auto" (NoArg (setDynFlag Opt_AutoSccsOnExportedToplevs))
1333 , Flag "no-auto" (NoArg (unSetDynFlag Opt_AutoSccsOnExportedToplevs))
1334 , Flag "fauto-sccs-on-individual-cafs" (NoArg (setDynFlag Opt_AutoSccsOnIndividualCafs))
1335 , Flag "caf-all" (NoArg (setDynFlag Opt_AutoSccsOnIndividualCafs))
1336 , Flag "no-caf-all" (NoArg (unSetDynFlag Opt_AutoSccsOnIndividualCafs))
1338 ------ DPH flags ----------------------------------------------------
1340 , Flag "fdph-seq" (NoArg (setDPHBackend DPHSeq))
1341 , Flag "fdph-par" (NoArg (setDPHBackend DPHPar))
1342 , Flag "fdph-this" (NoArg (setDPHBackend DPHThis))
1344 ------ Compiler flags -----------------------------------------------
1346 , Flag "fasm" (NoArg (setObjTarget HscAsm))
1347 , Flag "fvia-c" (NoArg (setObjTarget HscC >>
1348 (addWarn "The -fvia-c flag will be removed in a future GHC release")))
1349 , Flag "fvia-C" (NoArg (setObjTarget HscC >>
1350 (addWarn "The -fvia-C flag will be removed in a future GHC release")))
1351 , Flag "fllvm" (NoArg (setObjTarget HscLlvm))
1353 , Flag "fno-code" (NoArg (do upd $ \d -> d{ ghcLink=NoLink }
1354 setTarget HscNothing))
1355 , Flag "fbyte-code" (NoArg (setTarget HscInterpreted))
1356 , Flag "fobject-code" (NoArg (setTarget defaultHscTarget))
1357 , Flag "fglasgow-exts" (NoArg enableGlasgowExts)
1358 , Flag "fno-glasgow-exts" (NoArg disableGlasgowExts)
1360 ++ map (mkFlag True "f" setDynFlag ) fFlags
1361 ++ map (mkFlag False "fno-" unSetDynFlag) fFlags
1362 ++ map (mkFlag True "f" setExtensionFlag ) fLangFlags
1363 ++ map (mkFlag False "fno-" unSetExtensionFlag) fLangFlags
1364 ++ map (mkFlag True "X" setExtensionFlag ) xFlags
1365 ++ map (mkFlag False "XNo" unSetExtensionFlag) xFlags
1366 ++ map (mkFlag True "X" setLanguage) languageFlags
1368 package_flags :: [Flag (CmdLineP DynFlags)]
1370 ------- Packages ----------------------------------------------------
1371 Flag "package-conf" (HasArg extraPkgConf_)
1372 , Flag "no-user-package-conf" (NoArg (unSetDynFlag Opt_ReadUserPackageConf))
1373 , Flag "package-name" (hasArg setPackageName)
1374 , Flag "package-id" (HasArg exposePackageId)
1375 , Flag "package" (HasArg exposePackage)
1376 , Flag "hide-package" (HasArg hidePackage)
1377 , Flag "hide-all-packages" (NoArg (setDynFlag Opt_HideAllPackages))
1378 , Flag "ignore-package" (HasArg ignorePackage)
1379 , Flag "syslib" (HasArg (\s -> do { exposePackage s
1380 ; deprecate "Use -package instead" }))
1384 = ( String -- Flag in string form
1385 , flag -- Flag in internal form
1386 , Bool -> DynP ()) -- Extra action to run when the flag is found
1387 -- Typically, emit a warning or error
1388 -- True <=> we are turning the flag on
1389 -- False <=> we are turning the flag off
1392 mkFlag :: Bool -- ^ True <=> it should be turned on
1393 -> String -- ^ The flag prefix
1394 -> (flag -> DynP ()) -- ^ What to do when the flag is found
1395 -> FlagSpec flag -- ^ Specification of this particular flag
1396 -> Flag (CmdLineP DynFlags)
1397 mkFlag turnOn flagPrefix f (name, flag, extra_action)
1398 = Flag (flagPrefix ++ name) (NoArg (f flag >> extra_action turnOn))
1400 deprecatedForExtension :: String -> Bool -> DynP ()
1401 deprecatedForExtension lang turn_on
1402 = deprecate ("use -X" ++ flag ++ " or pragma {-# LANGUAGE " ++ flag ++ " #-} instead")
1404 flag | turn_on = lang
1405 | otherwise = "No"++lang
1407 useInstead :: String -> Bool -> DynP ()
1408 useInstead flag turn_on
1409 = deprecate ("Use -f" ++ no ++ flag ++ " instead")
1411 no = if turn_on then "" else "no-"
1413 nop :: Bool -> DynP ()
1416 -- | These @-f\<blah\>@ flags can all be reversed with @-fno-\<blah\>@
1417 fFlags :: [FlagSpec DynFlag]
1419 ( "warn-dodgy-foreign-imports", Opt_WarnDodgyForeignImports, nop ),
1420 ( "warn-dodgy-exports", Opt_WarnDodgyExports, nop ),
1421 ( "warn-dodgy-imports", Opt_WarnDodgyImports, nop ),
1422 ( "warn-duplicate-exports", Opt_WarnDuplicateExports, nop ),
1423 ( "warn-hi-shadowing", Opt_WarnHiShadows, nop ),
1424 ( "warn-implicit-prelude", Opt_WarnImplicitPrelude, nop ),
1425 ( "warn-incomplete-patterns", Opt_WarnIncompletePatterns, nop ),
1426 ( "warn-incomplete-record-updates", Opt_WarnIncompletePatternsRecUpd, nop ),
1427 ( "warn-missing-fields", Opt_WarnMissingFields, nop ),
1428 ( "warn-missing-import-lists", Opt_WarnMissingImportList, nop ),
1429 ( "warn-missing-methods", Opt_WarnMissingMethods, nop ),
1430 ( "warn-missing-signatures", Opt_WarnMissingSigs, nop ),
1431 ( "warn-missing-local-sigs", Opt_WarnMissingLocalSigs, nop ),
1432 ( "warn-name-shadowing", Opt_WarnNameShadowing, nop ),
1433 ( "warn-overlapping-patterns", Opt_WarnOverlappingPatterns, nop ),
1434 ( "warn-type-defaults", Opt_WarnTypeDefaults, nop ),
1435 ( "warn-monomorphism-restriction", Opt_WarnMonomorphism, nop ),
1436 ( "warn-unused-binds", Opt_WarnUnusedBinds, nop ),
1437 ( "warn-unused-imports", Opt_WarnUnusedImports, nop ),
1438 ( "warn-unused-matches", Opt_WarnUnusedMatches, nop ),
1439 ( "warn-warnings-deprecations", Opt_WarnWarningsDeprecations, nop ),
1440 ( "warn-deprecations", Opt_WarnWarningsDeprecations, nop ),
1441 ( "warn-deprecated-flags", Opt_WarnDeprecatedFlags, nop ),
1442 ( "warn-orphans", Opt_WarnOrphans, nop ),
1443 ( "warn-tabs", Opt_WarnTabs, nop ),
1444 ( "warn-unrecognised-pragmas", Opt_WarnUnrecognisedPragmas, nop ),
1445 ( "warn-lazy-unlifted-bindings", Opt_WarnLazyUnliftedBindings, nop),
1446 ( "warn-unused-do-bind", Opt_WarnUnusedDoBind, nop ),
1447 ( "warn-wrong-do-bind", Opt_WarnWrongDoBind, nop ),
1448 ( "warn-alternative-layout-rule-transitional", Opt_WarnAlternativeLayoutRuleTransitional, nop ),
1449 ( "print-explicit-foralls", Opt_PrintExplicitForalls, nop ),
1450 ( "strictness", Opt_Strictness, nop ),
1451 ( "specialise", Opt_Specialise, nop ),
1452 ( "float-in", Opt_FloatIn, nop ),
1453 ( "static-argument-transformation", Opt_StaticArgumentTransformation, nop ),
1454 ( "full-laziness", Opt_FullLaziness, nop ),
1455 ( "liberate-case", Opt_LiberateCase, nop ),
1456 ( "spec-constr", Opt_SpecConstr, nop ),
1457 ( "cse", Opt_CSE, nop ),
1458 ( "ignore-interface-pragmas", Opt_IgnoreInterfacePragmas, nop ),
1459 ( "omit-interface-pragmas", Opt_OmitInterfacePragmas, nop ),
1460 ( "expose-all-unfoldings", Opt_ExposeAllUnfoldings, nop ),
1461 ( "do-lambda-eta-expansion", Opt_DoLambdaEtaExpansion, nop ),
1462 ( "ignore-asserts", Opt_IgnoreAsserts, nop ),
1463 ( "do-eta-reduction", Opt_DoEtaReduction, nop ),
1464 ( "case-merge", Opt_CaseMerge, nop ),
1465 ( "unbox-strict-fields", Opt_UnboxStrictFields, nop ),
1466 ( "method-sharing", Opt_MethodSharing, nop ),
1467 ( "dicts-cheap", Opt_DictsCheap, nop ),
1468 ( "excess-precision", Opt_ExcessPrecision, nop ),
1469 ( "eager-blackholing", Opt_EagerBlackHoling, nop ),
1470 ( "asm-mangling", Opt_DoAsmMangling, nop ),
1471 ( "print-bind-result", Opt_PrintBindResult, nop ),
1472 ( "force-recomp", Opt_ForceRecomp, nop ),
1473 ( "hpc-no-auto", Opt_Hpc_No_Auto, nop ),
1474 ( "rewrite-rules", Opt_EnableRewriteRules, useInstead "enable-rewrite-rules" ),
1475 ( "enable-rewrite-rules", Opt_EnableRewriteRules, nop ),
1476 ( "break-on-exception", Opt_BreakOnException, nop ),
1477 ( "break-on-error", Opt_BreakOnError, nop ),
1478 ( "print-evld-with-show", Opt_PrintEvldWithShow, nop ),
1479 ( "print-bind-contents", Opt_PrintBindContents, nop ),
1480 ( "run-cps", Opt_RunCPS, nop ),
1481 ( "run-cpsz", Opt_RunCPSZ, nop ),
1482 ( "new-codegen", Opt_TryNewCodeGen, nop ),
1483 ( "convert-to-zipper-and-back", Opt_ConvertToZipCfgAndBack, nop ),
1484 ( "vectorise", Opt_Vectorise, nop ),
1485 ( "regs-graph", Opt_RegsGraph, nop ),
1486 ( "regs-iterative", Opt_RegsIterative, nop ),
1487 ( "gen-manifest", Opt_GenManifest, nop ),
1488 ( "embed-manifest", Opt_EmbedManifest, nop ),
1489 ( "ext-core", Opt_EmitExternalCore, nop ),
1490 ( "shared-implib", Opt_SharedImplib, nop ),
1491 ( "building-cabal-package", Opt_BuildingCabalPackage, nop ),
1492 ( "implicit-import-qualified", Opt_ImplicitImportQualified, nop )
1495 -- | These @-f\<blah\>@ flags can all be reversed with @-fno-\<blah\>@
1496 fLangFlags :: [FlagSpec ExtensionFlag]
1498 ( "th", Opt_TemplateHaskell,
1499 deprecatedForExtension "TemplateHaskell" >> checkTemplateHaskellOk ),
1500 ( "fi", Opt_ForeignFunctionInterface,
1501 deprecatedForExtension "ForeignFunctionInterface" ),
1502 ( "ffi", Opt_ForeignFunctionInterface,
1503 deprecatedForExtension "ForeignFunctionInterface" ),
1504 ( "arrows", Opt_Arrows,
1505 deprecatedForExtension "Arrows" ),
1506 ( "generics", Opt_Generics,
1507 deprecatedForExtension "Generics" ),
1508 ( "implicit-prelude", Opt_ImplicitPrelude,
1509 deprecatedForExtension "ImplicitPrelude" ),
1510 ( "bang-patterns", Opt_BangPatterns,
1511 deprecatedForExtension "BangPatterns" ),
1512 ( "monomorphism-restriction", Opt_MonomorphismRestriction,
1513 deprecatedForExtension "MonomorphismRestriction" ),
1514 ( "mono-pat-binds", Opt_MonoPatBinds,
1515 deprecatedForExtension "MonoPatBinds" ),
1516 ( "extended-default-rules", Opt_ExtendedDefaultRules,
1517 deprecatedForExtension "ExtendedDefaultRules" ),
1518 ( "implicit-params", Opt_ImplicitParams,
1519 deprecatedForExtension "ImplicitParams" ),
1520 ( "scoped-type-variables", Opt_ScopedTypeVariables,
1521 deprecatedForExtension "ScopedTypeVariables" ),
1523 deprecatedForExtension "PArr" ),
1524 ( "allow-overlapping-instances", Opt_OverlappingInstances,
1525 deprecatedForExtension "OverlappingInstances" ),
1526 ( "allow-undecidable-instances", Opt_UndecidableInstances,
1527 deprecatedForExtension "UndecidableInstances" ),
1528 ( "allow-incoherent-instances", Opt_IncoherentInstances,
1529 deprecatedForExtension "IncoherentInstances" )
1532 supportedLanguages :: [String]
1533 supportedLanguages = [ name | (name, _, _) <- languageFlags ]
1535 supportedExtensions :: [String]
1536 supportedExtensions = [ name' | (name, _, _) <- xFlags, name' <- [name, "No" ++ name] ]
1538 supportedLanguagesAndExtensions :: [String]
1539 supportedLanguagesAndExtensions = supportedLanguages ++ supportedExtensions
1541 -- | These -X<blah> flags cannot be reversed with -XNo<blah>
1542 languageFlags :: [FlagSpec Language]
1544 ( "Haskell98", Haskell98, nop ),
1545 ( "Haskell2010", Haskell2010, nop )
1548 -- | These -X<blah> flags can all be reversed with -XNo<blah>
1549 xFlags :: [FlagSpec ExtensionFlag]
1551 ( "CPP", Opt_Cpp, nop ),
1552 ( "PostfixOperators", Opt_PostfixOperators, nop ),
1553 ( "TupleSections", Opt_TupleSections, nop ),
1554 ( "PatternGuards", Opt_PatternGuards, nop ),
1555 ( "UnicodeSyntax", Opt_UnicodeSyntax, nop ),
1556 ( "MagicHash", Opt_MagicHash, nop ),
1557 ( "PolymorphicComponents", Opt_PolymorphicComponents, nop ),
1558 ( "ExistentialQuantification", Opt_ExistentialQuantification, nop ),
1559 ( "KindSignatures", Opt_KindSignatures, nop ),
1560 ( "EmptyDataDecls", Opt_EmptyDataDecls, nop ),
1561 ( "ParallelListComp", Opt_ParallelListComp, nop ),
1562 ( "TransformListComp", Opt_TransformListComp, nop ),
1563 ( "ForeignFunctionInterface", Opt_ForeignFunctionInterface, nop ),
1564 ( "UnliftedFFITypes", Opt_UnliftedFFITypes, nop ),
1565 ( "GHCForeignImportPrim", Opt_GHCForeignImportPrim, nop ),
1566 ( "LiberalTypeSynonyms", Opt_LiberalTypeSynonyms, nop ),
1567 ( "Rank2Types", Opt_Rank2Types, nop ),
1568 ( "RankNTypes", Opt_RankNTypes, nop ),
1569 ( "ImpredicativeTypes", Opt_ImpredicativeTypes, nop),
1570 ( "TypeOperators", Opt_TypeOperators, nop ),
1571 ( "RecursiveDo", Opt_RecursiveDo,
1572 deprecatedForExtension "DoRec"),
1573 ( "DoRec", Opt_DoRec, nop ),
1574 ( "Arrows", Opt_Arrows, nop ),
1575 ( "PArr", Opt_PArr, nop ),
1576 ( "TemplateHaskell", Opt_TemplateHaskell, checkTemplateHaskellOk ),
1577 ( "QuasiQuotes", Opt_QuasiQuotes, nop ),
1578 ( "Generics", Opt_Generics, nop ),
1579 ( "ImplicitPrelude", Opt_ImplicitPrelude, nop ),
1580 ( "RecordWildCards", Opt_RecordWildCards, nop ),
1581 ( "NamedFieldPuns", Opt_RecordPuns, nop ),
1582 ( "RecordPuns", Opt_RecordPuns,
1583 deprecatedForExtension "NamedFieldPuns" ),
1584 ( "DisambiguateRecordFields", Opt_DisambiguateRecordFields, nop ),
1585 ( "OverloadedStrings", Opt_OverloadedStrings, nop ),
1586 ( "GADTs", Opt_GADTs, nop ),
1587 ( "ViewPatterns", Opt_ViewPatterns, nop ),
1588 ( "TypeFamilies", Opt_TypeFamilies, nop ),
1589 ( "BangPatterns", Opt_BangPatterns, nop ),
1590 ( "MonomorphismRestriction", Opt_MonomorphismRestriction, nop ),
1591 ( "NPlusKPatterns", Opt_NPlusKPatterns, nop ),
1592 ( "DoAndIfThenElse", Opt_DoAndIfThenElse, nop ),
1593 ( "MonoPatBinds", Opt_MonoPatBinds, nop ),
1594 ( "ExplicitForAll", Opt_ExplicitForAll, nop ),
1595 ( "AlternativeLayoutRule", Opt_AlternativeLayoutRule, nop ),
1596 ( "AlternativeLayoutRuleTransitional",Opt_AlternativeLayoutRuleTransitional, nop ),
1597 ( "DatatypeContexts", Opt_DatatypeContexts, nop ),
1598 ( "MonoLocalBinds", Opt_MonoLocalBinds, nop ),
1599 ( "RelaxedPolyRec", Opt_RelaxedPolyRec,
1600 \ turn_on -> if not turn_on
1601 then deprecate "You can't turn off RelaxedPolyRec any more"
1603 ( "ExtendedDefaultRules", Opt_ExtendedDefaultRules, nop ),
1604 ( "ImplicitParams", Opt_ImplicitParams, nop ),
1605 ( "ScopedTypeVariables", Opt_ScopedTypeVariables, nop ),
1607 ( "PatternSignatures", Opt_ScopedTypeVariables,
1608 deprecatedForExtension "ScopedTypeVariables" ),
1610 ( "UnboxedTuples", Opt_UnboxedTuples, nop ),
1611 ( "StandaloneDeriving", Opt_StandaloneDeriving, nop ),
1612 ( "DeriveDataTypeable", Opt_DeriveDataTypeable, nop ),
1613 ( "DeriveFunctor", Opt_DeriveFunctor, nop ),
1614 ( "DeriveTraversable", Opt_DeriveTraversable, nop ),
1615 ( "DeriveFoldable", Opt_DeriveFoldable, nop ),
1616 ( "TypeSynonymInstances", Opt_TypeSynonymInstances, nop ),
1617 ( "FlexibleContexts", Opt_FlexibleContexts, nop ),
1618 ( "FlexibleInstances", Opt_FlexibleInstances, nop ),
1619 ( "ConstrainedClassMethods", Opt_ConstrainedClassMethods, nop ),
1620 ( "MultiParamTypeClasses", Opt_MultiParamTypeClasses, nop ),
1621 ( "FunctionalDependencies", Opt_FunctionalDependencies, nop ),
1622 ( "GeneralizedNewtypeDeriving", Opt_GeneralizedNewtypeDeriving, nop ),
1623 ( "OverlappingInstances", Opt_OverlappingInstances, nop ),
1624 ( "UndecidableInstances", Opt_UndecidableInstances, nop ),
1625 ( "IncoherentInstances", Opt_IncoherentInstances, nop ),
1626 ( "PackageImports", Opt_PackageImports, nop ),
1627 ( "NewQualifiedOperators", Opt_NewQualifiedOperators,
1628 \_ -> deprecate "The new qualified operator syntax was rejected by Haskell'" )
1631 defaultFlags :: [DynFlag]
1633 = [ Opt_AutoLinkPackages,
1634 Opt_ReadUserPackageConf,
1644 Opt_PrintBindContents
1647 ++ [f | (ns,f) <- optLevelFlags, 0 `elem` ns]
1648 -- The default -O0 options
1652 impliedFlags :: [(ExtensionFlag, ExtensionFlag)]
1654 = [ (Opt_RankNTypes, Opt_ExplicitForAll)
1655 , (Opt_Rank2Types, Opt_ExplicitForAll)
1656 , (Opt_ScopedTypeVariables, Opt_ExplicitForAll)
1657 , (Opt_LiberalTypeSynonyms, Opt_ExplicitForAll)
1658 , (Opt_ExistentialQuantification, Opt_ExplicitForAll)
1659 , (Opt_PolymorphicComponents, Opt_ExplicitForAll)
1661 , (Opt_GADTs, Opt_MonoLocalBinds)
1662 , (Opt_TypeFamilies, Opt_MonoLocalBinds)
1664 , (Opt_TypeFamilies, Opt_KindSignatures) -- Type families use kind signatures
1665 -- all over the place
1667 , (Opt_ImpredicativeTypes, Opt_RankNTypes)
1669 -- Record wild-cards implies field disambiguation
1670 -- Otherwise if you write (C {..}) you may well get
1671 -- stuff like " 'a' not in scope ", which is a bit silly
1672 -- if the compiler has just filled in field 'a' of constructor 'C'
1673 , (Opt_RecordWildCards, Opt_DisambiguateRecordFields)
1676 optLevelFlags :: [([Int], DynFlag)]
1678 = [ ([0], Opt_IgnoreInterfacePragmas)
1679 , ([0], Opt_OmitInterfacePragmas)
1681 , ([1,2], Opt_IgnoreAsserts)
1682 , ([1,2], Opt_EnableRewriteRules) -- Off for -O0; see Note [Scoping for Builtin rules]
1684 , ([1,2], Opt_DoEtaReduction)
1685 , ([1,2], Opt_CaseMerge)
1686 , ([1,2], Opt_Strictness)
1688 , ([1,2], Opt_FullLaziness)
1689 , ([1,2], Opt_Specialise)
1690 , ([1,2], Opt_FloatIn)
1692 , ([2], Opt_LiberateCase)
1693 , ([2], Opt_SpecConstr)
1694 , ([2], Opt_RegsGraph)
1696 -- , ([2], Opt_StaticArgumentTransformation)
1697 -- Max writes: I think it's probably best not to enable SAT with -O2 for the
1698 -- 6.10 release. The version of SAT in HEAD at the moment doesn't incorporate
1699 -- several improvements to the heuristics, and I'm concerned that without
1700 -- those changes SAT will interfere with some attempts to write "high
1701 -- performance Haskell", as we saw in some posts on Haskell-Cafe earlier
1702 -- this year. In particular, the version in HEAD lacks the tail call
1703 -- criterion, so many things that look like reasonable loops will be
1704 -- turned into functions with extra (unneccesary) thunk creation.
1706 , ([0,1,2], Opt_DoLambdaEtaExpansion)
1707 -- This one is important for a tiresome reason:
1708 -- we want to make sure that the bindings for data
1709 -- constructors are eta-expanded. This is probably
1710 -- a good thing anyway, but it seems fragile.
1713 -- -----------------------------------------------------------------------------
1714 -- Standard sets of warning options
1716 standardWarnings :: [DynFlag]
1718 = [ Opt_WarnWarningsDeprecations,
1719 Opt_WarnDeprecatedFlags,
1720 Opt_WarnUnrecognisedPragmas,
1721 Opt_WarnOverlappingPatterns,
1722 Opt_WarnMissingFields,
1723 Opt_WarnMissingMethods,
1724 Opt_WarnDuplicateExports,
1725 Opt_WarnLazyUnliftedBindings,
1726 Opt_WarnDodgyForeignImports,
1727 Opt_WarnWrongDoBind,
1728 Opt_WarnAlternativeLayoutRuleTransitional
1731 minusWOpts :: [DynFlag]
1733 = standardWarnings ++
1734 [ Opt_WarnUnusedBinds,
1735 Opt_WarnUnusedMatches,
1736 Opt_WarnUnusedImports,
1737 Opt_WarnIncompletePatterns,
1738 Opt_WarnDodgyExports,
1739 Opt_WarnDodgyImports
1742 minusWallOpts :: [DynFlag]
1745 [ Opt_WarnTypeDefaults,
1746 Opt_WarnNameShadowing,
1747 Opt_WarnMissingSigs,
1750 Opt_WarnUnusedDoBind
1753 -- minuswRemovesOpts should be every warning option
1754 minuswRemovesOpts :: [DynFlag]
1757 [Opt_WarnImplicitPrelude,
1758 Opt_WarnIncompletePatternsRecUpd,
1759 Opt_WarnMonomorphism,
1760 Opt_WarnUnrecognisedPragmas,
1764 enableGlasgowExts :: DynP ()
1765 enableGlasgowExts = do setDynFlag Opt_PrintExplicitForalls
1766 mapM_ setExtensionFlag glasgowExtsFlags
1768 disableGlasgowExts :: DynP ()
1769 disableGlasgowExts = do unSetDynFlag Opt_PrintExplicitForalls
1770 mapM_ unSetExtensionFlag glasgowExtsFlags
1772 glasgowExtsFlags :: [ExtensionFlag]
1773 glasgowExtsFlags = [
1774 Opt_ForeignFunctionInterface
1775 , Opt_UnliftedFFITypes
1777 , Opt_ImplicitParams
1778 , Opt_ScopedTypeVariables
1780 , Opt_TypeSynonymInstances
1781 , Opt_StandaloneDeriving
1782 , Opt_DeriveDataTypeable
1784 , Opt_DeriveFoldable
1785 , Opt_DeriveTraversable
1786 , Opt_FlexibleContexts
1787 , Opt_FlexibleInstances
1788 , Opt_ConstrainedClassMethods
1789 , Opt_MultiParamTypeClasses
1790 , Opt_FunctionalDependencies
1792 , Opt_PolymorphicComponents
1793 , Opt_ExistentialQuantification
1795 , Opt_PostfixOperators
1797 , Opt_LiberalTypeSynonyms
1801 , Opt_ParallelListComp
1802 , Opt_EmptyDataDecls
1803 , Opt_KindSignatures
1804 , Opt_GeneralizedNewtypeDeriving
1805 , Opt_TypeFamilies ]
1808 -- Consult the RTS to find whether GHC itself has been built profiled
1809 -- If so, you can't use Template Haskell
1810 foreign import ccall unsafe "rts_isProfiled" rtsIsProfiledIO :: IO CInt
1812 rtsIsProfiled :: Bool
1813 rtsIsProfiled = unsafePerformIO rtsIsProfiledIO /= 0
1815 checkTemplateHaskellOk :: Bool -> DynP ()
1816 checkTemplateHaskellOk turn_on
1817 | turn_on && rtsIsProfiled
1818 = addErr "You can't use Template Haskell with a profiled compiler"
1822 -- In stage 1 we don't know that the RTS has rts_isProfiled,
1823 -- so we simply say "ok". It doesn't matter because TH isn't
1824 -- available in stage 1 anyway.
1825 checkTemplateHaskellOk turn_on = return ()
1828 {- **********************************************************************
1830 DynFlags constructors
1832 %********************************************************************* -}
1834 type DynP = EwM (CmdLineP DynFlags)
1836 upd :: (DynFlags -> DynFlags) -> DynP ()
1837 upd f = liftEwM (do { dfs <- getCmdLineState
1838 ; putCmdLineState $! (f dfs) })
1840 --------------- Constructor functions for OptKind -----------------
1841 noArg :: (DynFlags -> DynFlags) -> OptKind (CmdLineP DynFlags)
1842 noArg fn = NoArg (upd fn)
1844 noArgDF :: (DynFlags -> DynFlags) -> String -> OptKind (CmdLineP DynFlags)
1845 noArgDF fn deprec = NoArg (upd fn >> deprecate deprec)
1847 hasArg :: (String -> DynFlags -> DynFlags) -> OptKind (CmdLineP DynFlags)
1848 hasArg fn = HasArg (upd . fn)
1850 hasArgDF :: (String -> DynFlags -> DynFlags) -> String -> OptKind (CmdLineP DynFlags)
1851 hasArgDF fn deprec = HasArg (\s -> do { upd (fn s)
1852 ; deprecate deprec })
1854 intSuffix :: (Int -> DynFlags -> DynFlags) -> OptKind (CmdLineP DynFlags)
1855 intSuffix fn = IntSuffix (\n -> upd (fn n))
1857 setDumpFlag :: DynFlag -> OptKind (CmdLineP DynFlags)
1858 setDumpFlag dump_flag = NoArg (setDumpFlag' dump_flag)
1860 --------------------------
1861 setDynFlag, unSetDynFlag :: DynFlag -> DynP ()
1862 setDynFlag f = upd (\dfs -> dopt_set dfs f)
1863 unSetDynFlag f = upd (\dfs -> dopt_unset dfs f)
1865 --------------------------
1866 setLanguage :: Language -> DynP ()
1867 setLanguage l = upd (\dfs -> dfs { language = Just l })
1869 --------------------------
1870 setExtensionFlag, unSetExtensionFlag :: ExtensionFlag -> DynP ()
1871 setExtensionFlag f = do { upd (\dfs -> xopt_set dfs f)
1872 ; mapM_ setExtensionFlag deps }
1874 deps = [ d | (f', d) <- impliedFlags, f' == f ]
1875 -- When you set f, set the ones it implies
1876 -- NB: use setExtensionFlag recursively, in case the implied flags
1877 -- implies further flags
1878 -- When you un-set f, however, we don't un-set the things it implies
1879 -- (except for -fno-glasgow-exts, which is treated specially)
1881 unSetExtensionFlag f = upd (\dfs -> xopt_unset dfs f)
1883 --------------------------
1884 setDumpFlag' :: DynFlag -> DynP ()
1885 setDumpFlag' dump_flag
1886 = do { setDynFlag dump_flag
1887 ; when want_recomp forceRecompile }
1889 -- Certain dumpy-things are really interested in what's going
1890 -- on during recompilation checking, so in those cases we
1891 -- don't want to turn it off.
1892 want_recomp = dump_flag `notElem` [Opt_D_dump_if_trace,
1893 Opt_D_dump_hi_diffs]
1895 forceRecompile :: DynP ()
1896 -- Whenver we -ddump, force recompilation (by switching off the
1897 -- recompilation checker), else you don't see the dump! However,
1898 -- don't switch it off in --make mode, else *everything* gets
1899 -- recompiled which probably isn't what you want
1900 forceRecompile = do { dfs <- liftEwM getCmdLineState
1901 ; when (force_recomp dfs) (setDynFlag Opt_ForceRecomp) }
1903 force_recomp dfs = isOneShot (ghcMode dfs)
1905 setVerboseCore2Core :: DynP ()
1906 setVerboseCore2Core = do forceRecompile
1907 setDynFlag Opt_D_verbose_core2core
1908 upd (\dfs -> dfs { shouldDumpSimplPhase = Nothing })
1911 setDumpSimplPhases :: String -> DynP ()
1912 setDumpSimplPhases s = do forceRecompile
1913 upd (\dfs -> dfs { shouldDumpSimplPhase = Just spec })
1915 spec = case s of { ('=' : s') -> s'; _ -> s }
1917 setVerbosity :: Maybe Int -> DynP ()
1918 setVerbosity mb_n = upd (\dfs -> dfs{ verbosity = mb_n `orElse` 3 })
1920 addCmdlineHCInclude :: String -> DynP ()
1921 addCmdlineHCInclude a = upd (\s -> s{cmdlineHcIncludes = a : cmdlineHcIncludes s})
1923 extraPkgConf_ :: FilePath -> DynP ()
1924 extraPkgConf_ p = upd (\s -> s{ extraPkgConfs = p : extraPkgConfs s })
1926 exposePackage, exposePackageId, hidePackage, ignorePackage :: String -> DynP ()
1928 upd (\s -> s{ packageFlags = ExposePackage p : packageFlags s })
1930 upd (\s -> s{ packageFlags = ExposePackageId p : packageFlags s })
1932 upd (\s -> s{ packageFlags = HidePackage p : packageFlags s })
1934 upd (\s -> s{ packageFlags = IgnorePackage p : packageFlags s })
1936 setPackageName :: String -> DynFlags -> DynFlags
1937 setPackageName p s = s{ thisPackage = stringToPackageId p }
1939 -- If we're linking a binary, then only targets that produce object
1940 -- code are allowed (requests for other target types are ignored).
1941 setTarget :: HscTarget -> DynP ()
1942 setTarget l = upd set
1945 | ghcLink dfs /= LinkBinary || isObjectTarget l = dfs{ hscTarget = l }
1948 -- Changes the target only if we're compiling object code. This is
1949 -- used by -fasm and -fvia-C, which switch from one to the other, but
1950 -- not from bytecode to object-code. The idea is that -fasm/-fvia-C
1951 -- can be safely used in an OPTIONS_GHC pragma.
1952 setObjTarget :: HscTarget -> DynP ()
1953 setObjTarget l = upd set
1956 | isObjectTarget (hscTarget dfs) = dfs { hscTarget = l }
1959 setOptLevel :: Int -> DynFlags -> DynFlags
1960 setOptLevel n dflags
1961 | hscTarget dflags == HscInterpreted && n > 0
1963 -- not in IO any more, oh well:
1964 -- putStr "warning: -O conflicts with --interactive; -O ignored.\n"
1966 = updOptLevel n dflags
1969 -- -Odph is equivalent to
1971 -- -O2 optimise as much as possible
1972 -- -fno-method-sharing sharing specialisation defeats fusion
1974 -- -fdicts-cheap always inline dictionaries
1975 -- -fmax-simplifier-iterations20 this is necessary sometimes
1976 -- -fsimplifier-phases=3 we use an additional simplifier phase
1978 -- -fno-spec-constr-threshold run SpecConstr even for big loops
1979 -- -fno-spec-constr-count SpecConstr as much as possible
1980 -- -finline-enough-args hack to prevent excessive inlining
1982 setDPHOpt :: DynFlags -> DynFlags
1983 setDPHOpt dflags = setOptLevel 2 (dflags { maxSimplIterations = 20
1985 , specConstrThreshold = Nothing
1986 , specConstrCount = Nothing
1988 `dopt_set` Opt_DictsCheap
1989 `dopt_unset` Opt_MethodSharing
1991 data DPHBackend = DPHPar
1994 deriving(Eq, Ord, Enum, Show)
1996 setDPHBackend :: DPHBackend -> DynP ()
1997 setDPHBackend backend
1999 upd $ \dflags -> dflags { dphBackend = backend }
2000 mapM_ exposePackage (dph_packages backend)
2002 dph_packages DPHThis = []
2003 dph_packages DPHPar = ["dph-prim-par", "dph-par"]
2004 dph_packages DPHSeq = ["dph-prim-seq", "dph-seq"]
2006 dphPackage :: DynFlags -> PackageId
2007 dphPackage dflags = case dphBackend dflags of
2008 DPHPar -> dphParPackageId
2009 DPHSeq -> dphSeqPackageId
2010 DPHThis -> thisPackage dflags
2012 setMainIs :: String -> DynP ()
2014 | not (null main_fn) && isLower (head main_fn)
2015 -- The arg looked like "Foo.Bar.baz"
2016 = upd $ \d -> d{ mainFunIs = Just main_fn,
2017 mainModIs = mkModule mainPackageId (mkModuleName main_mod) }
2019 | isUpper (head arg) -- The arg looked like "Foo" or "Foo.Bar"
2020 = upd $ \d -> d{ mainModIs = mkModule mainPackageId (mkModuleName arg) }
2022 | otherwise -- The arg looked like "baz"
2023 = upd $ \d -> d{ mainFunIs = Just arg }
2025 (main_mod, main_fn) = splitLongestPrefix arg (== '.')
2027 -----------------------------------------------------------------------------
2028 -- Paths & Libraries
2030 addImportPath, addLibraryPath, addIncludePath, addFrameworkPath :: FilePath -> DynP ()
2032 -- -i on its own deletes the import paths
2033 addImportPath "" = upd (\s -> s{importPaths = []})
2034 addImportPath p = upd (\s -> s{importPaths = importPaths s ++ splitPathList p})
2038 upd (\s -> s{libraryPaths = libraryPaths s ++ splitPathList p})
2041 upd (\s -> s{includePaths = includePaths s ++ splitPathList p})
2043 addFrameworkPath p =
2044 upd (\s -> s{frameworkPaths = frameworkPaths s ++ splitPathList p})
2046 #ifndef mingw32_TARGET_OS
2047 split_marker :: Char
2048 split_marker = ':' -- not configurable (ToDo)
2051 splitPathList :: String -> [String]
2052 splitPathList s = filter notNull (splitUp s)
2053 -- empty paths are ignored: there might be a trailing
2054 -- ':' in the initial list, for example. Empty paths can
2055 -- cause confusion when they are translated into -I options
2056 -- for passing to gcc.
2058 #ifndef mingw32_TARGET_OS
2059 splitUp xs = split split_marker xs
2061 -- Windows: 'hybrid' support for DOS-style paths in directory lists.
2063 -- That is, if "foo:bar:baz" is used, this interpreted as
2064 -- consisting of three entries, 'foo', 'bar', 'baz'.
2065 -- However, with "c:/foo:c:\\foo;x:/bar", this is interpreted
2066 -- as 3 elts, "c:/foo", "c:\\foo", "x:/bar"
2068 -- Notice that no attempt is made to fully replace the 'standard'
2069 -- split marker ':' with the Windows / DOS one, ';'. The reason being
2070 -- that this will cause too much breakage for users & ':' will
2071 -- work fine even with DOS paths, if you're not insisting on being silly.
2074 splitUp (x:':':div:xs) | div `elem` dir_markers
2075 = ((x:':':div:p): splitUp rs)
2077 (p,rs) = findNextPath xs
2078 -- we used to check for existence of the path here, but that
2079 -- required the IO monad to be threaded through the command-line
2080 -- parser which is quite inconvenient. The
2081 splitUp xs = cons p (splitUp rs)
2083 (p,rs) = findNextPath xs
2088 -- will be called either when we've consumed nought or the
2089 -- "<Drive>:/" part of a DOS path, so splitting is just a Q of
2090 -- finding the next split marker.
2092 case break (`elem` split_markers) xs of
2093 (p, _:ds) -> (p, ds)
2096 split_markers :: [Char]
2097 split_markers = [':', ';']
2099 dir_markers :: [Char]
2100 dir_markers = ['/', '\\']
2103 -- -----------------------------------------------------------------------------
2104 -- tmpDir, where we store temporary files.
2106 setTmpDir :: FilePath -> DynFlags -> DynFlags
2107 setTmpDir dir dflags = dflags{ tmpDir = normalise dir }
2108 -- we used to fix /cygdrive/c/.. on Windows, but this doesn't
2109 -- seem necessary now --SDM 7/2/2008
2111 -----------------------------------------------------------------------------
2114 setRtsOpts :: String -> DynP ()
2115 setRtsOpts arg = upd $ \ d -> d {rtsOpts = Just arg}
2117 setRtsOptsEnabled :: RtsOptsEnabled -> DynP ()
2118 setRtsOptsEnabled arg = upd $ \ d -> d {rtsOptsEnabled = arg}
2120 -----------------------------------------------------------------------------
2123 setOptHpcDir :: String -> DynP ()
2124 setOptHpcDir arg = upd $ \ d -> d{hpcDir = arg}
2126 -----------------------------------------------------------------------------
2127 -- Via-C compilation stuff
2129 -- There are some options that we need to pass to gcc when compiling
2130 -- Haskell code via C, but are only supported by recent versions of
2131 -- gcc. The configure script decides which of these options we need,
2132 -- and puts them in the file "extra-gcc-opts" in $topdir, which is
2133 -- read before each via-C compilation. The advantage of having these
2134 -- in a separate file is that the file can be created at install-time
2135 -- depending on the available gcc version, and even re-generated later
2136 -- if gcc is upgraded.
2138 -- The options below are not dependent on the version of gcc, only the
2141 machdepCCOpts :: DynFlags -> ([String], -- flags for all C compilations
2142 [String]) -- for registerised HC compilations
2143 machdepCCOpts dflags = let (flagsAll, flagsRegHc) = machdepCCOpts' dflags
2144 in (cCcOpts ++ flagsAll, flagsRegHc)
2146 machdepCCOpts' :: DynFlags -> ([String], -- flags for all C compilations
2147 [String]) -- for registerised HC compilations
2148 machdepCCOpts' _dflags
2149 #if alpha_TARGET_ARCH
2151 #ifdef HAVE_THREADED_RTS_SUPPORT
2155 -- For now, to suppress the gcc warning "call-clobbered
2156 -- register used for global register variable", we simply
2157 -- disable all warnings altogether using the -w flag. Oh well.
2159 #elif hppa_TARGET_ARCH
2160 -- ___HPUX_SOURCE, not _HPUX_SOURCE, is #defined if -ansi!
2161 -- (very nice, but too bad the HP /usr/include files don't agree.)
2162 = ( ["-D_HPUX_SOURCE"], [] )
2164 #elif m68k_TARGET_ARCH
2165 -- -fno-defer-pop : for the .hc files, we want all the pushing/
2166 -- popping of args to routines to be explicit; if we let things
2167 -- be deferred 'til after an STGJUMP, imminent death is certain!
2169 -- -fomit-frame-pointer : *don't*
2170 -- It's better to have a6 completely tied up being a frame pointer
2171 -- rather than let GCC pick random things to do with it.
2172 -- (If we want to steal a6, then we would try to do things
2173 -- as on iX86, where we *do* steal the frame pointer [%ebp].)
2174 = ( [], ["-fno-defer-pop", "-fno-omit-frame-pointer"] )
2176 #elif i386_TARGET_ARCH
2177 -- -fno-defer-pop : basically the same game as for m68k
2179 -- -fomit-frame-pointer : *must* in .hc files; because we're stealing
2180 -- the fp (%ebp) for our register maps.
2181 = let n_regs = stolen_x86_regs _dflags
2184 [ if opt_Static then "-DDONT_WANT_WIN32_DLL_SUPPORT" else ""
2187 "-fomit-frame-pointer",
2188 -- we want -fno-builtin, because when gcc inlines
2189 -- built-in functions like memcpy() it tends to
2190 -- run out of registers, requiring -monly-n-regs
2192 "-DSTOLEN_X86_REGS="++show n_regs ]
2195 #elif ia64_TARGET_ARCH
2196 = ( [], ["-fomit-frame-pointer", "-G0"] )
2198 #elif x86_64_TARGET_ARCH
2201 ["-fomit-frame-pointer",
2202 "-fno-asynchronous-unwind-tables",
2203 -- the unwind tables are unnecessary for HC code,
2204 -- and get in the way of -split-objs. Another option
2205 -- would be to throw them away in the mangler, but this
2208 -- calling builtins like strlen() using the FFI can
2209 -- cause gcc to run out of regs, so use the external
2213 #elif sparc_TARGET_ARCH
2215 -- For now, to suppress the gcc warning "call-clobbered
2216 -- register used for global register variable", we simply
2217 -- disable all warnings altogether using the -w flag. Oh well.
2219 #elif powerpc_apple_darwin_TARGET
2221 -- Disable Apple's precompiling preprocessor. It's a great thing
2222 -- for "normal" programs, but it doesn't support register variable
2224 = ( [], ["-no-cpp-precomp"] )
2229 picCCOpts :: DynFlags -> [String]
2231 #if darwin_TARGET_OS
2232 -- Apple prefers to do things the other way round.
2233 -- PIC is on by default.
2234 -- -mdynamic-no-pic:
2235 -- Turn off PIC code generation.
2237 -- Don't generate "common" symbols - these are unwanted
2238 -- in dynamic libraries.
2241 = ["-fno-common", "-U __PIC__","-D__PIC__"]
2243 = ["-mdynamic-no-pic"]
2244 #elif mingw32_TARGET_OS
2245 -- no -fPIC for Windows
2247 = ["-U __PIC__","-D__PIC__"]
2251 -- we need -fPIC for C files when we are compiling with -dynamic,
2252 -- otherwise things like stub.c files don't get compiled
2253 -- correctly. They need to reference data in the Haskell
2254 -- objects, but can't without -fPIC. See
2255 -- http://hackage.haskell.org/trac/ghc/wiki/Commentary/PositionIndependentCode
2256 | opt_PIC || not opt_Static
2257 = ["-fPIC", "-U __PIC__", "-D__PIC__"]
2262 -- -----------------------------------------------------------------------------
2266 can_split = cSplitObjs == "YES"
2268 -- -----------------------------------------------------------------------------
2271 data Printable = String String
2272 | FromDynFlags (DynFlags -> String)
2274 compilerInfo :: [(String, Printable)]
2275 compilerInfo = [("Project name", String cProjectName),
2276 ("Project version", String cProjectVersion),
2277 ("Booter version", String cBooterVersion),
2278 ("Stage", String cStage),
2279 ("Build platform", String cBuildPlatform),
2280 ("Host platform", String cHostPlatform),
2281 ("Target platform", String cTargetPlatform),
2282 ("Have interpreter", String cGhcWithInterpreter),
2283 ("Object splitting", String cSplitObjs),
2284 ("Have native code generator", String cGhcWithNativeCodeGen),
2285 ("Have llvm code generator", String cGhcWithLlvmCodeGen),
2286 ("Use archives for ghci", String (show cUseArchivesForGhci)),
2287 ("Support SMP", String cGhcWithSMP),
2288 ("Unregisterised", String cGhcUnregisterised),
2289 ("Tables next to code", String cGhcEnableTablesNextToCode),
2290 ("RTS ways", String cGhcRTSWays),
2291 ("Leading underscore", String cLeadingUnderscore),
2292 ("Debug on", String (show debugIsOn)),
2293 ("LibDir", FromDynFlags topDir),
2294 ("Global Package DB", FromDynFlags systemPackageConfig)