1 -----------------------------------------------------------------------------
2 -- $Id: DriverFlags.hs,v 1.28 2000/12/06 13:03:29 simonmar Exp $
6 -- (c) Simon Marlow 2000
8 -----------------------------------------------------------------------------
10 module DriverFlags where
12 #include "HsVersions.h"
14 import PackageMaintenance
17 import TmpFiles ( v_TmpDir )
21 import TmpFiles ( newTempName )
22 import Directory ( removeFile )
30 -----------------------------------------------------------------------------
33 -- Flag parsing is now done in stages:
35 -- * parse the initial list of flags and remove any flags understood
36 -- by the driver only. Determine whether we're in multi-compilation
37 -- or single-compilation mode.
39 -- * gather the list of "static" hsc flags, and assign them to the global
40 -- static hsc flags variable.
42 -- * build the inital DynFlags from the remaining flags.
44 -- * complain if we've got any flags left over.
46 -- * for each source file: grab the OPTIONS, and build a new DynFlags
47 -- to pass to the compiler.
49 -----------------------------------------------------------------------------
50 -- Process command-line
53 = NoArg (IO ()) -- flag with no argument
54 | HasArg (String -> IO ()) -- flag has an argument (maybe prefix)
55 | SepArg (String -> IO ()) -- flag has a separate argument
56 | Prefix (String -> IO ()) -- flag is a prefix only
57 | OptPrefix (String -> IO ()) -- flag may be a prefix
58 | AnySuffix (String -> IO ()) -- flag is a prefix, pass whole arg to fn
59 | PassFlag (String -> IO ()) -- flag with no arg, pass flag to fn
60 | PrefixPred (String -> Bool) (String -> IO ())
61 | AnySuffixPred (String -> Bool) (String -> IO ())
63 processArgs :: [(String,OptKind)] -> [String] -> [String]
64 -> IO [String] -- returns spare args
65 processArgs _spec [] spare = return (reverse spare)
66 processArgs spec args@(('-':arg):args') spare = do
67 case findArg spec arg of
69 do args' <- processOneArg action rest args
70 processArgs spec args' spare
72 processArgs spec args' (('-':arg):spare)
73 processArgs spec (arg:args) spare =
74 processArgs spec args (arg:spare)
76 processOneArg :: OptKind -> String -> [String] -> IO [String]
77 processOneArg action rest (dash_arg@('-':arg):args) =
81 then io >> return args
82 else unknownFlagErr dash_arg
86 then fio rest >> return args
88 [] -> unknownFlagErr dash_arg
89 (arg1:args1) -> fio arg1 >> return args1
93 [] -> unknownFlagErr dash_arg
94 (arg1:args1) -> fio arg1 >> return args1
98 then fio rest >> return args
99 else unknownFlagErr dash_arg
103 then fio rest >> return args
104 else unknownFlagErr dash_arg
106 OptPrefix fio -> fio rest >> return args
108 AnySuffix fio -> fio dash_arg >> return args
110 AnySuffixPred p fio -> fio dash_arg >> return args
114 then unknownFlagErr dash_arg
115 else fio dash_arg >> return args
117 findArg :: [(String,OptKind)] -> String -> Maybe (String,OptKind)
119 = case [ (remove_spaces rest, k)
120 | (pat,k) <- spec, Just rest <- [my_prefix_match pat arg],
126 arg_ok (NoArg _) rest arg = null rest
127 arg_ok (HasArg _) rest arg = True
128 arg_ok (SepArg _) rest arg = null rest
129 arg_ok (Prefix _) rest arg = not (null rest)
130 arg_ok (PrefixPred p _) rest arg = not (null rest) && p rest
131 arg_ok (OptPrefix _) rest arg = True
132 arg_ok (PassFlag _) rest arg = null rest
133 arg_ok (AnySuffix _) rest arg = True
134 arg_ok (AnySuffixPred p _) rest arg = p arg
136 -----------------------------------------------------------------------------
139 -- note that ordering is important in the following list: any flag which
140 -- is a prefix flag (i.e. HasArg, Prefix, OptPrefix, AnySuffix) will override
141 -- flags further down the list with the same prefix.
144 [ ------- help -------------------------------------------------------
145 ( "?" , NoArg long_usage)
146 , ( "-help" , NoArg long_usage)
149 ------- version ----------------------------------------------------
150 , ( "-version" , NoArg (do hPutStrLn stdout (cProjectName
151 ++ ", version " ++ cProjectVersion)
152 exitWith ExitSuccess))
153 , ( "-numeric-version", NoArg (do hPutStrLn stdout cProjectVersion
154 exitWith ExitSuccess))
156 ------- verbosity ----------------------------------------------------
157 , ( "n" , NoArg (writeIORef v_Dry_run True) )
159 ------- recompilation checker --------------------------------------
160 , ( "recomp" , NoArg (writeIORef v_Recomp True) )
161 , ( "no-recomp" , NoArg (writeIORef v_Recomp False) )
163 ------- ways --------------------------------------------------------
164 , ( "prof" , NoArg (addNoDups v_Ways WayProf) )
165 , ( "unreg" , NoArg (addNoDups v_Ways WayUnreg) )
166 , ( "ticky" , NoArg (addNoDups v_Ways WayTicky) )
167 , ( "parallel" , NoArg (addNoDups v_Ways WayPar) )
168 , ( "gransim" , NoArg (addNoDups v_Ways WayGran) )
169 , ( "smp" , NoArg (addNoDups v_Ways WaySMP) )
170 , ( "debug" , NoArg (addNoDups v_Ways WayDebug) )
173 ------ Debugging ----------------------------------------------------
174 , ( "dppr-noprags", PassFlag (add v_Opt_C) )
175 , ( "dppr-debug", PassFlag (add v_Opt_C) )
176 , ( "dppr-user-length", AnySuffix (add v_Opt_C) )
177 -- rest of the debugging flags are dynamic
179 ------- Interface files ---------------------------------------------
180 , ( "hi" , NoArg (writeIORef v_ProduceHi True) )
181 , ( "nohi" , NoArg (writeIORef v_ProduceHi False) )
183 --------- Profiling --------------------------------------------------
184 , ( "auto-dicts" , NoArg (add v_Opt_C "-fauto-sccs-on-dicts") )
185 , ( "auto-all" , NoArg (add v_Opt_C "-fauto-sccs-on-all-toplevs") )
186 , ( "auto" , NoArg (add v_Opt_C "-fauto-sccs-on-exported-toplevs") )
187 , ( "caf-all" , NoArg (add v_Opt_C "-fauto-sccs-on-individual-cafs") )
188 -- "ignore-sccs" doesn't work (ToDo)
190 , ( "no-auto-dicts" , NoArg (add v_Anti_opt_C "-fauto-sccs-on-dicts") )
191 , ( "no-auto-all" , NoArg (add v_Anti_opt_C "-fauto-sccs-on-all-toplevs") )
192 , ( "no-auto" , NoArg (add v_Anti_opt_C "-fauto-sccs-on-exported-toplevs") )
193 , ( "no-caf-all" , NoArg (add v_Anti_opt_C "-fauto-sccs-on-individual-cafs") )
195 ------- Miscellaneous -----------------------------------------------
196 , ( "no-link-chk" , NoArg (return ()) ) -- ignored for backwards compat
197 , ( "no-hs-main" , NoArg (writeIORef v_NoHsMain True) )
199 ------- Output Redirection ------------------------------------------
200 , ( "odir" , HasArg (writeIORef v_Output_dir . Just) )
201 , ( "o" , SepArg (writeIORef v_Output_file . Just) )
202 , ( "osuf" , HasArg (writeIORef v_Object_suf . Just) )
203 , ( "hisuf" , HasArg (writeIORef v_Hi_suf) )
204 , ( "tmpdir" , HasArg (writeIORef v_TmpDir . (++ "/")) )
205 , ( "ohi" , HasArg (\s -> case s of
206 "-" -> writeIORef v_Hi_on_stdout True
207 _ -> writeIORef v_Output_hi (Just s)) )
210 , ( "keep-hc-file" , AnySuffix (\_ -> writeIORef v_Keep_hc_files True) )
211 , ( "keep-s-file" , AnySuffix (\_ -> writeIORef v_Keep_s_files True) )
212 , ( "keep-raw-s-file", AnySuffix (\_ -> writeIORef v_Keep_raw_s_files True) )
213 , ( "keep-tmp-files" , AnySuffix (\_ -> writeIORef v_Keep_tmp_files True) )
215 , ( "split-objs" , NoArg (if can_split
216 then do writeIORef v_Split_object_files True
217 add v_Opt_C "-fglobalise-toplev-names"
218 else hPutStrLn stderr
219 "warning: don't know how to split \
220 \object files on this architecture"
223 ------- Include/Import Paths ----------------------------------------
224 , ( "i" , OptPrefix (addToDirList v_Import_paths) )
225 , ( "I" , Prefix (addToDirList v_Include_paths) )
227 ------- Libraries ---------------------------------------------------
228 , ( "L" , Prefix (addToDirList v_Library_paths) )
229 , ( "l" , Prefix (add v_Cmdline_libraries) )
231 ------- Packages ----------------------------------------------------
232 , ( "package-name" , HasArg (\s -> add v_Opt_C ("-inpackage="++s)) )
234 , ( "package" , HasArg (addPackage) )
235 , ( "syslib" , HasArg (addPackage) ) -- for compatibility w/ old vsns
237 , ( "-list-packages" , NoArg (listPackages) )
238 , ( "-add-package" , NoArg (newPackage) )
239 , ( "-delete-package" , SepArg (deletePackage) )
241 ------- Specific phases --------------------------------------------
242 , ( "pgmL" , HasArg (writeIORef v_Pgm_L) )
243 , ( "pgmP" , HasArg (writeIORef v_Pgm_P) )
244 , ( "pgmc" , HasArg (writeIORef v_Pgm_c) )
245 , ( "pgmm" , HasArg (writeIORef v_Pgm_m) )
246 , ( "pgms" , HasArg (writeIORef v_Pgm_s) )
247 , ( "pgma" , HasArg (writeIORef v_Pgm_a) )
248 , ( "pgml" , HasArg (writeIORef v_Pgm_l) )
250 , ( "optdep" , HasArg (add v_Opt_dep) )
251 , ( "optl" , HasArg (add v_Opt_l) )
252 , ( "optdll" , HasArg (add v_Opt_dll) )
254 ------ Warning opts -------------------------------------------------
255 , ( "W" , NoArg (writeIORef v_Warning_opt W_) )
256 , ( "Wall" , NoArg (writeIORef v_Warning_opt W_all) )
257 , ( "Wnot" , NoArg (writeIORef v_Warning_opt W_not) )
258 , ( "w" , NoArg (writeIORef v_Warning_opt W_not) )
260 ----- Linker --------------------------------------------------------
261 , ( "static" , NoArg (writeIORef v_Static True) )
262 , ( "rdynamic" , NoArg (return ()) ) -- ignored for compat w/ gcc
264 ----- RTS opts ------------------------------------------------------
266 , ( "H" , HasArg (setHeapSize . fromIntegral . decodeSize) )
269 ------ Compiler flags -----------------------------------------------
270 , ( "O2-for-C" , NoArg (writeIORef v_minus_o2_for_C True) )
271 , ( "O" , OptPrefix (setOptLevel) )
273 , ( "fno-asm-mangling" , NoArg (writeIORef v_Do_asm_mangling False) )
275 , ( "fmax-simplifier-iterations",
276 Prefix (writeIORef v_MaxSimplifierIterations . read) )
278 , ( "fusagesp" , NoArg (do writeIORef v_UsageSPInf True
279 add v_Opt_C "-fusagesp-on") )
281 , ( "fexcess-precision" , NoArg (do writeIORef v_Excess_precision True
282 add v_Opt_C "-fexcess-precision"))
284 -- flags that are "active negatives"
285 , ( "fno-implicit-prelude" , PassFlag (add v_Opt_C) )
286 , ( "fno-prune-tydecls" , PassFlag (add v_Opt_C) )
287 , ( "fno-prune-instdecls" , PassFlag (add v_Opt_C) )
288 , ( "fno-pre-inlining" , PassFlag (add v_Opt_C) )
290 -- All other "-fno-<blah>" options cancel out "-f<blah>" on the hsc cmdline
291 , ( "fno-", PrefixPred (\s -> isStaticHscFlag ("f"++s))
292 (\s -> add v_Anti_opt_C ("-f"++s)) )
294 -- Pass all remaining "-f<blah>" options to hsc
295 , ( "f", AnySuffixPred (isStaticHscFlag) (add v_Opt_C) )
298 -----------------------------------------------------------------------------
299 -- parse the dynamic arguments
302 -- is the "baseline" dynamic flags, initialised from
303 -- the defaults and command line options.
306 -- is the dynamic flags for the current compilation. It is reset
307 -- to the value of v_InitDynFlags before each compilation, then
308 -- updated by reading any OPTIONS pragma in the current module.
310 GLOBAL_VAR(v_InitDynFlags, defaultDynFlags, DynFlags)
311 GLOBAL_VAR(v_DynFlags, defaultDynFlags, DynFlags)
314 dfs <- readIORef v_DynFlags
315 writeIORef v_DynFlags (f dfs)
317 getDynFlags :: IO DynFlags
318 getDynFlags = readIORef v_DynFlags
320 dynFlag :: (DynFlags -> a) -> IO a
321 dynFlag f = do dflags <- readIORef v_DynFlags; return (f dflags)
323 setDynFlag f = updDynFlags (\dfs -> dfs{ flags = f : flags dfs })
324 unSetDynFlag f = updDynFlags (\dfs -> dfs{ flags = filter (/= f) (flags dfs) })
326 -- we can only change HscC to HscAsm and vice-versa with dynamic flags
327 -- (-fvia-C and -fasm).
329 dfs <- readIORef v_DynFlags
331 HscC -> writeIORef v_DynFlags dfs{ hscLang = l }
332 HscAsm -> writeIORef v_DynFlags dfs{ hscLang = l }
335 setVerbosityAtLeast n =
336 updDynFlags (\dfs -> if verbosity dfs < n
337 then dfs{ verbosity = n }
340 setVerbosity "" = updDynFlags (\dfs -> dfs{ verbosity = 2 })
342 | all isDigit n = updDynFlags (\dfs -> dfs{ verbosity = read n })
343 | otherwise = throwDyn (OtherError "can't parse verbosity flag (-v<n>)")
346 verb <- dynFlag verbosity
347 if verb >= 3 then return "-v" else return ""
351 ( "cpp", NoArg (updateState (\s -> s{ cpp_flag = True })) )
352 , ( "#include", HasArg (addCmdlineHCInclude) )
354 , ( "v", OptPrefix (setVerbosity) )
356 , ( "optL", HasArg (addOpt_L) )
357 , ( "optP", HasArg (addOpt_P) )
358 , ( "optc", HasArg (addOpt_c) )
359 , ( "optm", HasArg (addOpt_m) )
360 , ( "opta", HasArg (addOpt_a) )
362 ------ HsCpp opts ---------------------------------------------------
363 , ( "D", Prefix (\s -> addOpt_P ("-D'"++s++"'") ) )
364 , ( "U", Prefix (\s -> addOpt_P ("-U'"++s++"'") ) )
366 ------ Debugging ----------------------------------------------------
367 , ( "dstg-stats", NoArg (writeIORef v_StgStats True) )
369 , ( "ddump-absC", NoArg (setDynFlag Opt_D_dump_absC) )
370 , ( "ddump-asm", NoArg (setDynFlag Opt_D_dump_asm) )
371 , ( "ddump-cpranal", NoArg (setDynFlag Opt_D_dump_cpranal) )
372 , ( "ddump-deriv", NoArg (setDynFlag Opt_D_dump_deriv) )
373 , ( "ddump-ds", NoArg (setDynFlag Opt_D_dump_ds) )
374 , ( "ddump-flatC", NoArg (setDynFlag Opt_D_dump_flatC) )
375 , ( "ddump-foreign", NoArg (setDynFlag Opt_D_dump_foreign) )
376 , ( "ddump-inlinings", NoArg (setDynFlag Opt_D_dump_inlinings) )
377 , ( "ddump-occur-anal", NoArg (setDynFlag Opt_D_dump_occur_anal) )
378 , ( "ddump-parsed", NoArg (setDynFlag Opt_D_dump_parsed) )
379 , ( "ddump-realC", NoArg (setDynFlag Opt_D_dump_realC) )
380 , ( "ddump-rn", NoArg (setDynFlag Opt_D_dump_rn) )
381 , ( "ddump-simpl", NoArg (setDynFlag Opt_D_dump_simpl) )
382 , ( "ddump-simpl-iterations", NoArg (setDynFlag Opt_D_dump_simpl_iterations) )
383 , ( "ddump-spec", NoArg (setDynFlag Opt_D_dump_spec) )
384 , ( "ddump-sat", NoArg (setDynFlag Opt_D_dump_sat) )
385 , ( "ddump-stg", NoArg (setDynFlag Opt_D_dump_stg) )
386 , ( "ddump-stranal", NoArg (setDynFlag Opt_D_dump_stranal) )
387 , ( "ddump-tc", NoArg (setDynFlag Opt_D_dump_tc) )
388 , ( "ddump-types", NoArg (setDynFlag Opt_D_dump_types) )
389 , ( "ddump-rules", NoArg (setDynFlag Opt_D_dump_rules) )
390 , ( "ddump-usagesp", NoArg (setDynFlag Opt_D_dump_usagesp) )
391 , ( "ddump-cse", NoArg (setDynFlag Opt_D_dump_cse) )
392 , ( "ddump-worker-wrapper", NoArg (setDynFlag Opt_D_dump_worker_wrapper) )
393 , ( "dshow-passes", NoArg (setVerbosity "2") )
394 , ( "ddump-rn-trace", NoArg (setDynFlag Opt_D_dump_rn_trace) )
395 , ( "ddump-rn-stats", NoArg (setDynFlag Opt_D_dump_rn_stats) )
396 , ( "ddump-stix", NoArg (setDynFlag Opt_D_dump_stix) )
397 , ( "ddump-simpl-stats", NoArg (setDynFlag Opt_D_dump_simpl_stats) )
398 , ( "ddump-interpsyn", NoArg (setDynFlag Opt_D_dump_InterpSyn) )
399 , ( "dsource-stats", NoArg (setDynFlag Opt_D_source_stats) )
400 , ( "dverbose-core2core", NoArg (setDynFlag Opt_D_verbose_core2core) )
401 , ( "dverbose-stg2stg", NoArg (setDynFlag Opt_D_verbose_stg2stg) )
402 , ( "ddump-hi-diffs", NoArg (setDynFlag Opt_D_dump_hi_diffs) )
403 , ( "ddump-hi", NoArg (setDynFlag Opt_D_dump_hi) )
404 , ( "ddump-minimal-imports", NoArg (setDynFlag Opt_D_dump_minimal_imports) )
405 , ( "dcore-lint", NoArg (setDynFlag Opt_DoCoreLinting) )
406 , ( "dstg-lint", NoArg (setDynFlag Opt_DoStgLinting) )
407 , ( "dusagesp-lint", NoArg (setDynFlag Opt_DoUSPLinting) )
409 ------ Warnings ----------------------------------------------------
411 , ( "fwarn-duplicate-exports", NoArg (setDynFlag Opt_WarnDuplicateExports) )
412 , ( "fwarn-hi-shadowing", NoArg (setDynFlag Opt_WarnHiShadows) )
413 , ( "fwarn-incomplete-patterns", NoArg (setDynFlag Opt_WarnIncompletePatterns) )
414 , ( "fwarn-missing-fields", NoArg (setDynFlag Opt_WarnMissingFields) )
415 , ( "fwarn-missing-methods", NoArg (setDynFlag Opt_WarnMissingMethods))
416 , ( "fwarn-missing-signatures", NoArg (setDynFlag Opt_WarnMissingSigs) )
417 , ( "fwarn-name-shadowing", NoArg (setDynFlag Opt_WarnNameShadowing) )
418 , ( "fwarn-overlapping-patterns", NoArg (setDynFlag Opt_WarnOverlappingPatterns ) )
419 , ( "fwarn-simple-patterns", NoArg (setDynFlag Opt_WarnSimplePatterns))
420 , ( "fwarn-type-defaults", NoArg (setDynFlag Opt_WarnTypeDefaults) )
421 , ( "fwarn-unused-binds", NoArg (setDynFlag Opt_WarnUnusedBinds) )
422 , ( "fwarn-unused-imports", NoArg (setDynFlag Opt_WarnUnusedImports) )
423 , ( "fwarn-unused-matches", NoArg (setDynFlag Opt_WarnUnusedMatches) )
424 , ( "fwarn-deprecations", NoArg (setDynFlag Opt_WarnDeprecations) )
426 ------ Machine dependant (-m<blah>) stuff ---------------------------
428 , ( "monly-2-regs", NoArg (updateState (\s -> s{stolen_x86_regs = 2}) ))
429 , ( "monly-3-regs", NoArg (updateState (\s -> s{stolen_x86_regs = 3}) ))
430 , ( "monly-4-regs", NoArg (updateState (\s -> s{stolen_x86_regs = 4}) ))
432 ------ Compiler flags -----------------------------------------------
434 , ( "fasm" , AnySuffix (\_ -> setLang HscAsm) )
436 , ( "fvia-c" , NoArg (setLang HscC) )
437 , ( "fvia-C" , NoArg (setLang HscC) )
439 , ( "fglasgow-exts", NoArg (setDynFlag Opt_GlasgowExts) )
440 , ( "fno-implicit-prelude", NoArg (setDynFlag Opt_NoImplicitPrelude) )
442 , ( "fallow-overlapping-instances",
443 NoArg (setDynFlag Opt_AllowOverlappingInstances) )
445 , ( "fallow-undecidable-instances",
446 NoArg (setDynFlag Opt_AllowUndecidableInstances) )
448 , ( "fgenerics", NoArg (setDynFlag Opt_Generics) )
450 , ( "freport-compile", NoArg (setDynFlag Opt_ReportCompile) )
453 -----------------------------------------------------------------------------
454 -- convert sizes like "3.5M" into integers
456 decodeSize :: String -> Integer
458 | c == "" = truncate n
459 | c == "K" || c == "k" = truncate (n * 1000)
460 | c == "M" || c == "m" = truncate (n * 1000 * 1000)
461 | c == "G" || c == "g" = truncate (n * 1000 * 1000 * 1000)
462 | otherwise = throwDyn (OtherError ("can't decode size: " ++ str))
463 where (m, c) = span pred str
465 pred c = isDigit c || c == '.'
467 floatOpt :: IORef Double -> String -> IO ()
469 = writeIORef ref (read str :: Double)
472 foreign import "setHeapSize" unsafe setHeapSize :: Int -> IO ()
475 -----------------------------------------------------------------------------
476 -- Build the Hsc static command line opts
478 buildStaticHscOpts :: IO [String]
479 buildStaticHscOpts = do
481 opt_C_ <- getStaticOpts v_Opt_C -- misc hsc opts from the command line
484 minus_o <- readIORef v_OptLevel
485 let optimisation_opts =
487 0 -> hsc_minusNoO_flags
488 1 -> hsc_minusO_flags
489 2 -> hsc_minusO2_flags
490 _ -> error "unknown opt level"
493 let stg_opts = [ "-flet-no-escape" ]
494 -- let-no-escape always on for now
496 -- take into account -fno-* flags by removing the equivalent -f*
497 -- flag from our list.
498 anti_flags <- getStaticOpts v_Anti_opt_C
499 let basic_opts = opt_C_ ++ optimisation_opts ++ stg_opts
500 filtered_opts = filter (`notElem` anti_flags) basic_opts
502 static <- (do s <- readIORef v_Static; if s then return "-static"
505 return ( static : filtered_opts )
507 -----------------------------------------------------------------------------
508 -- Running an external program
510 -- sigh, here because both DriverMkDepend & DriverPipeline need it.
512 runSomething phase_name cmd
514 verb <- dynFlag verbosity
515 when (verb >= 2) $ putStrLn ("*** " ++ phase_name)
516 when (verb >= 3) $ putStrLn cmd
520 n <- readIORef v_Dry_run
524 #ifndef mingw32_TARGET_OS
525 exit_code <- system cmd `catchAllIO`
526 (\_ -> throwDyn (PhaseFailed phase_name (ExitFailure 1)))
528 tmp <- newTempName "sh"
529 h <- openFile tmp WriteMode
532 exit_code <- system ("sh - " ++ tmp) `catchAllIO`
533 (\_ -> throwDyn (PhaseFailed phase_name (ExitFailure 1)))
537 if exit_code /= ExitSuccess
538 then throwDyn (PhaseFailed phase_name exit_code)
539 else do when (verb >= 3) (putStr "\n")