2 % (c) The University of Glasgow, 1996-2000
4 \section[CmdLineOpts]{Things to do with command-line options}
10 SimplifierSwitch(..), isAmongSimpl,
15 DynFlag(..), -- needed non-abstractly by DriverFlags
24 -- Manipulating DynFlags
25 defaultDynFlags, -- DynFlags
26 dopt, -- DynFlag -> DynFlags -> Bool
27 dopt_set, dopt_unset, -- DynFlags -> DynFlag -> DynFlags
28 dopt_CoreToDo, -- DynFlags -> [CoreToDo]
29 dopt_StgToDo, -- DynFlags -> [StgToDo]
30 dopt_HscLang, -- DynFlags -> HscLang
31 dopt_OutName, -- DynFlags -> String
33 -- Manipulating the DynFlags state
34 getDynFlags, -- IO DynFlags
35 setDynFlags, -- DynFlags -> IO ()
36 updDynFlags, -- (DynFlags -> DynFlags) -> IO ()
37 dynFlag, -- (DynFlags -> a) -> IO a
38 setDynFlag, unSetDynFlag, -- DynFlag -> IO ()
39 saveDynFlags, -- IO ()
40 restoreDynFlags, -- IO DynFlags
42 -- sets of warning opts
47 -- Output style options
49 opt_PprStyle_RawTypes,
54 opt_AutoSccsOnAllToplevs,
55 opt_AutoSccsOnExportedToplevs,
56 opt_AutoSccsOnIndividualCafs,
64 opt_MaxContextReductionDepth,
65 opt_IrrefutableTuples,
69 opt_NoMonomorphismRestriction,
76 opt_LiberateCaseThreshold,
77 opt_StgDoLetNoEscapes,
80 opt_UnboxStrictFields,
81 opt_SimplNoPreInlining,
82 opt_SimplDoEtaReduction,
83 opt_SimplDoLambdaEtaExpansion,
85 opt_SimplExcessPrecision,
89 opt_UF_CreationThreshold,
91 opt_UF_FunAppDiscount,
100 opt_EnsureSplittableC,
105 opt_IgnoreIfacePragmas,
108 opt_OmitInterfacePragmas,
116 #include "HsVersions.h"
118 import Array ( array, (//) )
120 import IOExts ( IORef, readIORef, writeIORef )
121 import Constants -- Default values for some flags
126 import Maybes ( firstJust )
127 import Panic ( panic )
129 #if __GLASGOW_HASKELL__ < 301
130 import ArrBase ( Array(..) )
132 import PrelArr ( Array(..) )
136 %************************************************************************
138 \subsection{Command-line options}
140 %************************************************************************
142 The hsc command-line options are split into two categories:
147 Static flags are represented by top-level values of type Bool or Int,
148 for example. They therefore have the same value throughout the
151 Dynamic flags are represented by an abstract type, DynFlags, which is
152 passed into hsc by the compilation manager for every compilation.
153 Dynamic flags are those that change on a per-compilation basis,
154 perhaps because they may be present in the OPTIONS pragma at the top
157 Other flag-related blurb:
159 A list of {\em ToDo}s is things to be done in a particular part of
160 processing. A (fictitious) example for the Core-to-Core simplifier
161 might be: run the simplifier, then run the strictness analyser, then
162 run the simplifier again (three ``todos'').
164 There are three ``to-do processing centers'' at the moment. In the
165 main loop (\tr{main/Main.lhs}), in the Core-to-Core processing loop
166 (\tr{simplCore/SimplCore.lhs), and in the STG-to-STG processing loop
167 (\tr{simplStg/SimplStg.lhs}).
169 %************************************************************************
171 \subsection{Datatypes associated with command-line options}
173 %************************************************************************
177 = SwBool Bool -- on/off
178 | SwString FAST_STRING -- nothing or a String
179 | SwInt Int -- nothing or an Int
183 data CoreToDo -- These are diff core-to-core passes,
184 -- which may be invoked in any order,
185 -- as many times as you like.
187 = CoreDoSimplify -- The core-to-core simplifier.
188 (SimplifierSwitch -> SwitchResult)
189 -- Each run of the simplifier can take a different
190 -- set of simplifier-specific flags.
192 | CoreDoFloatOutwards Bool -- True <=> float lambdas to top level
197 | CoreDoWorkerWrapper
204 | CoreDoRuleCheck String -- Check for non-application of rules
205 -- matching this string
207 | CoreDoNothing -- useful when building up lists of these things
212 = StgDoMassageForProfiling -- should be (next to) last
213 -- There's also setStgVarInfo, but its absolute "lastness"
214 -- is so critical that it is hardwired in (no flag).
219 data SimplifierSwitch
220 = MaxSimplifierIterations Int
221 | SimplInlinePhase Int
227 %************************************************************************
229 \subsection{Dynamic command-line options}
231 %************************************************************************
244 | Opt_D_dump_inlinings
245 | Opt_D_dump_occur_anal
250 | Opt_D_dump_simpl_iterations
260 | Opt_D_dump_worker_wrapper
261 | Opt_D_dump_rn_trace
262 | Opt_D_dump_rn_stats
264 | Opt_D_dump_simpl_stats
265 | Opt_D_dump_tc_trace
268 | Opt_D_verbose_core2core
269 | Opt_D_verbose_stg2stg
271 | Opt_D_dump_hi_diffs
272 | Opt_D_dump_minimal_imports
277 | Opt_WarnDuplicateExports
279 | Opt_WarnIncompletePatterns
280 | Opt_WarnMissingFields
281 | Opt_WarnMissingMethods
282 | Opt_WarnMissingSigs
283 | Opt_WarnNameShadowing
284 | Opt_WarnOverlappingPatterns
285 | Opt_WarnSimplePatterns
286 | Opt_WarnTypeDefaults
287 | Opt_WarnUnusedBinds
288 | Opt_WarnUnusedImports
289 | Opt_WarnUnusedMatches
290 | Opt_WarnDeprecations
294 | Opt_AllowOverlappingInstances
295 | Opt_AllowUndecidableInstances
298 | Opt_NoImplicitPrelude
302 data DynFlags = DynFlags {
303 coreToDo :: [CoreToDo],
304 stgToDo :: [StgToDo],
306 hscOutName :: String, -- name of the output file
307 hscStubHOutName :: String, -- name of the .stub_h output file
308 hscStubCOutName :: String, -- name of the .stub_c output file
309 extCoreName :: String, -- name of the .core output file
310 verbosity :: Int, -- verbosity level
311 cppFlag :: Bool, -- preprocess with cpp?
312 stolen_x86_regs :: Int,
313 cmdlineHcIncludes :: [String], -- -#includes
315 -- options for particular phases
339 defaultDynFlags = DynFlags {
340 coreToDo = [], stgToDo = [],
343 hscStubHOutName = "", hscStubCOutName = "",
348 cmdlineHcIncludes = [],
358 flags = standardWarnings,
364 0 | print errors & warnings only
365 1 | minimal verbosity: print "compiling M ... done." for each module.
366 2 | equivalent to -dshow-passes
367 3 | equivalent to existing "ghc -v"
368 4 | "ghc -v -ddump-most"
369 5 | "ghc -v -ddump-all"
372 dopt :: DynFlag -> DynFlags -> Bool
373 dopt f dflags = f `elem` (flags dflags)
375 dopt_CoreToDo :: DynFlags -> [CoreToDo]
376 dopt_CoreToDo = coreToDo
378 dopt_StgToDo :: DynFlags -> [StgToDo]
379 dopt_StgToDo = stgToDo
381 dopt_OutName :: DynFlags -> String
382 dopt_OutName = hscOutName
384 dopt_HscLang :: DynFlags -> HscLang
385 dopt_HscLang = hscLang
387 dopt_set :: DynFlags -> DynFlag -> DynFlags
388 dopt_set dfs f = dfs{ flags = f : flags dfs }
390 dopt_unset :: DynFlags -> DynFlag -> DynFlags
391 dopt_unset dfs f = dfs{ flags = filter (/= f) (flags dfs) }
394 -----------------------------------------------------------------------------
395 -- Mess about with the mutable variables holding the dynamic arguments
398 -- is the "baseline" dynamic flags, initialised from
399 -- the defaults and command line options, and updated by the
400 -- ':s' command in GHCi.
403 -- is the dynamic flags for the current compilation. It is reset
404 -- to the value of v_InitDynFlags before each compilation, then
405 -- updated by reading any OPTIONS pragma in the current module.
408 GLOBAL_VAR(v_InitDynFlags, defaultDynFlags, DynFlags)
409 GLOBAL_VAR(v_DynFlags, defaultDynFlags, DynFlags)
411 setDynFlags :: DynFlags -> IO ()
412 setDynFlags dfs = writeIORef v_DynFlags dfs
414 saveDynFlags :: IO ()
415 saveDynFlags = do dfs <- readIORef v_DynFlags
416 writeIORef v_InitDynFlags dfs
418 restoreDynFlags :: IO DynFlags
419 restoreDynFlags = do dfs <- readIORef v_InitDynFlags
420 writeIORef v_DynFlags dfs
423 getDynFlags :: IO DynFlags
424 getDynFlags = readIORef v_DynFlags
426 updDynFlags :: (DynFlags -> DynFlags) -> IO ()
427 updDynFlags f = do dfs <- readIORef v_DynFlags
428 writeIORef v_DynFlags (f dfs)
430 dynFlag :: (DynFlags -> a) -> IO a
431 dynFlag f = do dflags <- readIORef v_DynFlags; return (f dflags)
433 setDynFlag, unSetDynFlag :: DynFlag -> IO ()
434 setDynFlag f = updDynFlags (\dfs -> dopt_set dfs f)
435 unSetDynFlag f = updDynFlags (\dfs -> dopt_unset dfs f)
439 %************************************************************************
441 \subsection{Warnings}
443 %************************************************************************
447 = [ Opt_WarnDeprecations,
448 Opt_WarnOverlappingPatterns,
449 Opt_WarnMissingFields,
450 Opt_WarnMissingMethods,
451 Opt_WarnDuplicateExports
455 = standardWarnings ++
456 [ Opt_WarnUnusedBinds,
457 Opt_WarnUnusedMatches,
458 Opt_WarnUnusedImports,
459 Opt_WarnIncompletePatterns,
465 [ Opt_WarnTypeDefaults,
466 Opt_WarnNameShadowing,
472 %************************************************************************
474 \subsection{Classifying command-line options}
476 %************************************************************************
479 -- v_Statis_hsc_opts is here to avoid a circular dependency with
481 GLOBAL_VAR(v_Static_hsc_opts, [], [String])
483 lookUp :: FAST_STRING -> Bool
484 lookup_int :: String -> Maybe Int
485 lookup_def_int :: String -> Int -> Int
486 lookup_def_float :: String -> Float -> Float
487 lookup_str :: String -> Maybe String
489 unpacked_static_opts = unsafePerformIO (readIORef v_Static_hsc_opts)
490 packed_static_opts = map _PK_ unpacked_static_opts
492 lookUp sw = sw `elem` packed_static_opts
494 lookup_str sw = firstJust (map (startsWith sw) unpacked_static_opts)
496 lookup_int sw = case (lookup_str sw) of
498 Just xx -> Just (read xx)
500 lookup_def_int sw def = case (lookup_str sw) of
501 Nothing -> def -- Use default
504 lookup_def_float sw def = case (lookup_str sw) of
505 Nothing -> def -- Use default
510 Putting the compiler options into temporary at-files
511 may turn out to be necessary later on if we turn hsc into
512 a pure Win32 application where I think there's a command-line
513 length limit of 255. unpacked_opts understands the @ option.
515 unpacked_opts :: [String]
519 map _UNPK_ argv -- NOT ARGV any more: v_Static_hsc_opts
521 expandAts ('@':fname) = words (unsafePerformIO (readFile fname))
526 %************************************************************************
528 \subsection{Static options}
530 %************************************************************************
534 opt_PprStyle_NoPrags = lookUp SLIT("-dppr-noprags")
535 opt_PprStyle_Debug = lookUp SLIT("-dppr-debug")
536 opt_PprStyle_RawTypes = lookUp SLIT("-dppr-rawtypes")
537 opt_PprUserLength = lookup_def_int "-dppr-user-length" 5 --ToDo: give this a name
540 opt_AutoSccsOnAllToplevs = lookUp SLIT("-fauto-sccs-on-all-toplevs")
541 opt_AutoSccsOnExportedToplevs = lookUp SLIT("-fauto-sccs-on-exported-toplevs")
542 opt_AutoSccsOnIndividualCafs = lookUp SLIT("-fauto-sccs-on-individual-cafs")
543 opt_AutoSccsOnDicts = lookUp SLIT("-fauto-sccs-on-dicts")
544 opt_SccProfilingOn = lookUp SLIT("-fscc-profiling")
545 opt_DoTickyProfiling = lookUp SLIT("-fticky-ticky")
548 opt_AllStrict = lookUp SLIT("-fall-strict")
549 opt_NoMonomorphismRestriction = lookUp SLIT("-fno-monomorphism-restriction")
550 opt_DictsStrict = lookUp SLIT("-fdicts-strict")
551 opt_IrrefutableTuples = lookUp SLIT("-firrefutable-tuples")
552 opt_MaxContextReductionDepth = lookup_def_int "-fcontext-stack" mAX_CONTEXT_REDUCTION_DEPTH
553 opt_NumbersStrict = lookUp SLIT("-fnumbers-strict")
554 opt_Parallel = lookUp SLIT("-fparallel")
555 opt_SMP = lookUp SLIT("-fsmp")
558 opt_NoMethodSharing = lookUp SLIT("-fno-method-sharing")
559 opt_DoSemiTagging = lookUp SLIT("-fsemi-tagging")
560 opt_FoldrBuildOn = lookUp SLIT("-ffoldr-build-on")
561 opt_LiberateCaseThreshold = lookup_def_int "-fliberate-case-threshold" (10::Int)
562 opt_StgDoLetNoEscapes = lookUp SLIT("-flet-no-escape")
563 opt_UnfoldCasms = lookUp SLIT("-funfold-casms-in-hi-file")
564 opt_UsageSPOn = lookUp SLIT("-fusagesp-on")
565 opt_UnboxStrictFields = lookUp SLIT("-funbox-strict-fields")
566 opt_MaxWorkerArgs = lookup_def_int "-fmax-worker-args" (10::Int)
569 The optional '-inpackage=P' flag tells what package
570 we are compiling this module for.
571 The Prelude, for example is compiled with '-inpackage std'
573 opt_InPackage = case lookup_str "-inpackage=" of
575 Nothing -> SLIT("Main") -- The package name if none is specified
577 opt_EmitCExternDecls = lookUp SLIT("-femit-extern-decls")
578 opt_EnsureSplittableC = lookUp SLIT("-fglobalise-toplev-names")
579 opt_GranMacros = lookUp SLIT("-fgransim")
580 opt_HiVersion = read cProjectVersionInt :: Int
581 opt_HistorySize = lookup_def_int "-fhistory-size" 20
582 opt_IgnoreAsserts = lookUp SLIT("-fignore-asserts")
583 opt_IgnoreIfacePragmas = lookUp SLIT("-fignore-interface-pragmas")
584 opt_NoHiCheck = lookUp SLIT("-fno-hi-version-check")
585 opt_OmitBlackHoling = lookUp SLIT("-dno-black-holing")
586 opt_OmitInterfacePragmas = lookUp SLIT("-fomit-interface-pragmas")
587 opt_RuntimeTypes = lookUp SLIT("-fruntime-types")
589 -- Simplifier switches
590 opt_SimplNoPreInlining = lookUp SLIT("-fno-pre-inlining")
591 -- NoPreInlining is there just to see how bad things
592 -- get if you don't do it!
593 opt_SimplDoEtaReduction = lookUp SLIT("-fdo-eta-reduction")
594 opt_SimplDoLambdaEtaExpansion = lookUp SLIT("-fdo-lambda-eta-expansion")
595 opt_SimplCaseMerge = lookUp SLIT("-fcase-merge")
596 opt_SimplExcessPrecision = lookUp SLIT("-fexcess-precision")
599 opt_UF_CreationThreshold = lookup_def_int "-funfolding-creation-threshold" (45::Int)
600 opt_UF_UseThreshold = lookup_def_int "-funfolding-use-threshold" (8::Int) -- Discounts can be big
601 opt_UF_FunAppDiscount = lookup_def_int "-funfolding-fun-discount" (6::Int) -- It's great to inline a fn
602 opt_UF_KeenessFactor = lookup_def_float "-funfolding-keeness-factor" (1.5::Float)
603 opt_UF_UpdateInPlace = lookUp SLIT("-funfolding-update-in-place")
605 opt_UF_CheapOp = ( 1 :: Int) -- Only one instruction; and the args are charged for
606 opt_UF_DearOp = ( 4 :: Int)
608 opt_NoPruneDecls = lookUp SLIT("-fno-prune-decls")
609 opt_NoPruneTyDecls = lookUp SLIT("-fno-prune-tydecls")
610 opt_Static = lookUp SLIT("-static")
611 opt_Unregisterised = lookUp SLIT("-funregisterised")
612 opt_EmitExternalCore = lookUp SLIT("-fext-core")
615 %************************************************************************
617 \subsection{List of static hsc flags}
619 %************************************************************************
624 "fauto-sccs-on-all-toplevs",
625 "fauto-sccs-on-exported-toplevs",
626 "fauto-sccs-on-individual-cafs",
627 "fauto-sccs-on-dicts",
632 "firrefutable-tuples",
639 "funfold-casms-in-hi-file",
641 "funbox-strict-fields",
642 "femit-extern-decls",
643 "fglobalise-toplev-names",
646 "fignore-interface-pragmas",
647 "fno-hi-version-check",
649 "fno-method-sharing",
650 "fno-monomorphism-restriction",
651 "fomit-interface-pragmas",
655 "fdo-lambda-eta-expansion",
658 "funfolding-update-in-place",
665 || any (flip prefixMatch f) [
667 "fliberate-case-threshold",
670 "funfolding-creation-threshold",
671 "funfolding-use-threshold",
672 "funfolding-fun-discount",
673 "funfolding-keeness-factor"
677 %************************************************************************
679 \subsection{Switch ordering}
681 %************************************************************************
683 These things behave just like enumeration types.
686 instance Eq SimplifierSwitch where
687 a == b = tagOf_SimplSwitch a ==# tagOf_SimplSwitch b
689 instance Ord SimplifierSwitch where
690 a < b = tagOf_SimplSwitch a <# tagOf_SimplSwitch b
691 a <= b = tagOf_SimplSwitch a <=# tagOf_SimplSwitch b
694 tagOf_SimplSwitch (SimplInlinePhase _) = _ILIT(1)
695 tagOf_SimplSwitch (MaxSimplifierIterations _) = _ILIT(2)
696 tagOf_SimplSwitch DontApplyRules = _ILIT(3)
697 tagOf_SimplSwitch SimplLetToCase = _ILIT(4)
698 tagOf_SimplSwitch NoCaseOfCase = _ILIT(5)
700 -- If you add anything here, be sure to change lAST_SIMPL_SWITCH_TAG, too!
702 lAST_SIMPL_SWITCH_TAG = 5
705 %************************************************************************
707 \subsection{Switch lookup}
709 %************************************************************************
712 isAmongSimpl :: [SimplifierSwitch] -> SimplifierSwitch -> SwitchResult
713 isAmongSimpl on_switches -- Switches mentioned later occur *earlier*
714 -- in the list; defaults right at the end.
716 tidied_on_switches = foldl rm_dups [] on_switches
717 -- The fold*l* ensures that we keep the latest switches;
718 -- ie the ones that occur earliest in the list.
720 sw_tbl :: Array Int SwitchResult
721 sw_tbl = (array (0, lAST_SIMPL_SWITCH_TAG) -- bounds...
725 all_undefined = [ (i, SwBool False) | i <- [0 .. lAST_SIMPL_SWITCH_TAG ] ]
727 defined_elems = map mk_assoc_elem tidied_on_switches
729 -- (avoid some unboxing, bounds checking, and other horrible things:)
730 #if __GLASGOW_HASKELL__ < 405
731 case sw_tbl of { Array bounds_who_needs_'em stuff ->
733 case sw_tbl of { Array _ _ stuff ->
736 case (indexArray# stuff (tagOf_SimplSwitch switch)) of
737 #if __GLASGOW_HASKELL__ < 400
739 #elif __GLASGOW_HASKELL__ < 403
746 mk_assoc_elem k@(MaxSimplifierIterations lvl)
747 = (iBox (tagOf_SimplSwitch k), SwInt lvl)
748 mk_assoc_elem k@(SimplInlinePhase n)
749 = (iBox (tagOf_SimplSwitch k), SwInt n)
751 = (iBox (tagOf_SimplSwitch k), SwBool True) -- I'm here, Mom!
753 -- cannot have duplicates if we are going to use the array thing
754 rm_dups switches_so_far switch
755 = if switch `is_elem` switches_so_far
757 else switch : switches_so_far
759 sw `is_elem` [] = False
760 sw `is_elem` (s:ss) = (tagOf_SimplSwitch sw) ==# (tagOf_SimplSwitch s)
765 %************************************************************************
767 \subsection{Misc functions for command-line options}
769 %************************************************************************
773 switchIsOn :: (switch -> SwitchResult) -> switch -> Bool
775 switchIsOn lookup_fn switch
776 = case (lookup_fn switch) of
777 SwBool False -> False
780 intSwitchSet :: (switch -> SwitchResult)
784 intSwitchSet lookup_fn switch
785 = case (lookup_fn (switch (panic "intSwitchSet"))) of
786 SwInt int -> Just int
791 startsWith :: String -> String -> Maybe String
792 -- startsWith pfx (pfx++rest) = Just rest
794 startsWith [] str = Just str
795 startsWith (c:cs) (s:ss)
796 = if c /= s then Nothing else startsWith cs ss
797 startsWith _ [] = Nothing
799 endsWith :: String -> String -> Maybe String
801 = case (startsWith (reverse cs) (reverse ss)) of
803 Just rs -> Just (reverse rs)