Let 'loadModule' generate proper code depending on the 'hscTarget'.
[ghc-hetmet.git] / compiler / main / DriverPipeline.hs
1 {-# OPTIONS -fno-cse #-}
2 -- -fno-cse is needed for GLOBAL_VAR's to behave properly
3
4 -----------------------------------------------------------------------------
5 --
6 -- GHC Driver
7 --
8 -- (c) The University of Glasgow 2005
9 --
10 -----------------------------------------------------------------------------
11
12 module DriverPipeline (
13         -- Run a series of compilation steps in a pipeline, for a
14         -- collection of source files.
15    oneShot, compileFile,
16
17         -- Interfaces for the batch-mode driver
18    linkBinary,
19
20         -- Interfaces for the compilation manager (interpreted/batch-mode)
21    preprocess, 
22    compile, compile',
23    link, 
24
25   ) where
26
27 #include "HsVersions.h"
28
29 import Packages
30 import HeaderInfo
31 import DriverPhases
32 import SysTools
33 import HscMain
34 import Finder
35 import HscTypes
36 import Outputable
37 import Module
38 import LazyUniqFM               ( eltsUFM )
39 import ErrUtils
40 import DynFlags
41 import StaticFlags      ( v_Ld_inputs, opt_Static, WayName(..) )
42 import Config
43 import Panic
44 import Util
45 import StringBuffer     ( hGetStringBuffer )
46 import BasicTypes       ( SuccessFlag(..) )
47 import Maybes           ( expectJust )
48 import ParserCoreUtils  ( getCoreModuleName )
49 import SrcLoc
50 import FastString
51 import MonadUtils
52
53 import Data.Either
54 import Exception
55 import Data.IORef       ( readIORef, writeIORef, IORef )
56 import GHC.Exts         ( Int(..) )
57 import System.Directory
58 import System.FilePath
59 import System.IO
60 import System.IO.Error as IO
61 import Control.Monad
62 import Data.List        ( isSuffixOf )
63 import Data.Maybe
64 import System.Environment
65
66 -- ---------------------------------------------------------------------------
67 -- Pre-process
68
69 -- | Just preprocess a file, put the result in a temp. file (used by the
70 -- compilation manager during the summary phase).
71 --
72 -- We return the augmented DynFlags, because they contain the result
73 -- of slurping in the OPTIONS pragmas
74
75 preprocess :: GhcMonad m =>
76               HscEnv
77            -> (FilePath, Maybe Phase) -- ^ filename and starting phase
78            -> m (DynFlags, FilePath)
79 preprocess hsc_env (filename, mb_phase) =
80   ASSERT2(isJust mb_phase || isHaskellSrcFilename filename, text filename) 
81   runPipeline anyHsc hsc_env (filename, mb_phase) 
82         Nothing Temporary Nothing{-no ModLocation-}
83
84 -- ---------------------------------------------------------------------------
85
86 -- | Compile
87 --
88 -- Compile a single module, under the control of the compilation manager.
89 --
90 -- This is the interface between the compilation manager and the
91 -- compiler proper (hsc), where we deal with tedious details like
92 -- reading the OPTIONS pragma from the source file, and passing the
93 -- output of hsc through the C compiler.
94 --
95 -- NB.  No old interface can also mean that the source has changed.
96
97 compile :: GhcMonad m =>
98            HscEnv
99         -> ModSummary      -- ^ summary for module being compiled
100         -> Int             -- ^ module N ...
101         -> Int             -- ^ ... of M
102         -> Maybe ModIface  -- ^ old interface, if we have one
103         -> Maybe Linkable  -- ^ old linkable, if we have one
104         -> m HomeModInfo   -- ^ the complete HomeModInfo, if successful
105
106 compile = compile' (hscCompileNothing, hscCompileInteractive, hscCompileBatch)
107
108 type Compiler m a = HscEnv -> ModSummary -> Bool
109                   -> Maybe ModIface -> Maybe (Int, Int)
110                   -> m a
111
112 compile' :: GhcMonad m =>
113            (Compiler m (HscStatus, ModIface, ModDetails),
114             Compiler m (InteractiveStatus, ModIface, ModDetails),
115             Compiler m (HscStatus, ModIface, ModDetails))
116         -> HscEnv
117         -> ModSummary      -- ^ summary for module being compiled
118         -> Int             -- ^ module N ...
119         -> Int             -- ^ ... of M
120         -> Maybe ModIface  -- ^ old interface, if we have one
121         -> Maybe Linkable  -- ^ old linkable, if we have one
122         -> m HomeModInfo   -- ^ the complete HomeModInfo, if successful
123
124 compile' (nothingCompiler, interactiveCompiler, batchCompiler)
125         hsc_env0 summary mod_index nmods mb_old_iface maybe_old_linkable
126  = do
127    let dflags0     = ms_hspp_opts summary
128        this_mod    = ms_mod summary
129        src_flavour = ms_hsc_src summary
130        location    = ms_location summary
131        input_fn    = expectJust "compile:hs" (ml_hs_file location) 
132        input_fnpp  = ms_hspp_file summary
133
134    liftIO $ debugTraceMsg dflags0 2 (text "compile: input file" <+> text input_fnpp)
135
136    let basename = dropExtension input_fn
137
138   -- We add the directory in which the .hs files resides) to the import path.
139   -- This is needed when we try to compile the .hc file later, if it
140   -- imports a _stub.h file that we created here.
141    let current_dir = case takeDirectory basename of
142                      "" -> "." -- XXX Hack
143                      d -> d
144        old_paths   = includePaths dflags0
145        dflags      = dflags0 { includePaths = current_dir : old_paths }
146        hsc_env     = hsc_env0 {hsc_dflags = dflags}
147
148    -- Figure out what lang we're generating
149    let hsc_lang = hscMaybeAdjustTarget dflags StopLn src_flavour (hscTarget dflags)
150    -- ... and what the next phase should be
151    let next_phase = hscNextPhase dflags src_flavour hsc_lang
152    -- ... and what file to generate the output into
153    output_fn <- liftIO $ getOutputFilename next_phase
154                         Temporary basename dflags next_phase (Just location)
155
156    let dflags' = dflags { hscTarget = hsc_lang,
157                                 hscOutName = output_fn,
158                                 extCoreName = basename ++ ".hcr" }
159    let hsc_env' = hsc_env { hsc_dflags = dflags' }
160
161    -- -fforce-recomp should also work with --make
162    let force_recomp = dopt Opt_ForceRecomp dflags
163        source_unchanged = isJust maybe_old_linkable && not force_recomp
164        object_filename = ml_obj_file location
165
166    let getStubLinkable False = return []
167        getStubLinkable True
168            = do stub_o <- compileStub hsc_env' this_mod location
169                 return [ DotO stub_o ]
170
171        handleBatch HscNoRecomp
172            = ASSERT (isJust maybe_old_linkable)
173              return maybe_old_linkable
174
175        handleBatch (HscRecomp hasStub _)
176            | isHsBoot src_flavour
177                = do when (isObjectTarget hsc_lang) $ -- interpreted reaches here too
178                        liftIO $ SysTools.touch dflags' "Touching object file"
179                                    object_filename
180                     return maybe_old_linkable
181
182            | otherwise
183                = do stub_unlinked <- getStubLinkable hasStub
184                     (hs_unlinked, unlinked_time) <-
185                         case hsc_lang of
186                           HscNothing
187                             -> return ([], ms_hs_date summary)
188                           -- We're in --make mode: finish the compilation pipeline.
189                           _other
190                             -> do runPipeline StopLn hsc_env' (output_fn,Nothing)
191                                               (Just basename)
192                                               Persistent
193                                               (Just location)
194                                   -- The object filename comes from the ModLocation
195                                   o_time <- liftIO $ getModificationTime object_filename
196                                   return ([DotO object_filename], o_time)
197                     let linkable = LM unlinked_time this_mod
198                                    (hs_unlinked ++ stub_unlinked)
199                     return (Just linkable)
200
201        handleInterpreted HscNoRecomp
202            = ASSERT (isJust maybe_old_linkable)
203              return maybe_old_linkable
204        handleInterpreted (HscRecomp _hasStub Nothing)
205            = ASSERT (isHsBoot src_flavour)
206              return maybe_old_linkable
207        handleInterpreted (HscRecomp hasStub (Just (comp_bc, modBreaks)))
208            = do stub_unlinked <- getStubLinkable hasStub
209                 let hs_unlinked = [BCOs comp_bc modBreaks]
210                     unlinked_time = ms_hs_date summary
211                   -- Why do we use the timestamp of the source file here,
212                   -- rather than the current time?  This works better in
213                   -- the case where the local clock is out of sync
214                   -- with the filesystem's clock.  It's just as accurate:
215                   -- if the source is modified, then the linkable will
216                   -- be out of date.
217                 let linkable = LM unlinked_time this_mod
218                                (hs_unlinked ++ stub_unlinked)
219                 return (Just linkable)
220
221    let -- runCompiler :: Compiler result -> (result -> Maybe Linkable)
222        --            -> m HomeModInfo
223        runCompiler compiler handle
224            = do (result, iface, details)
225                     <- compiler hsc_env' summary source_unchanged mb_old_iface
226                                 (Just (mod_index, nmods))
227                 linkable <- handle result
228                 return (HomeModInfo{ hm_details  = details,
229                                      hm_iface    = iface,
230                                      hm_linkable = linkable })
231    -- run the compiler
232    case hsc_lang of
233       HscInterpreted ->
234                 runCompiler interactiveCompiler handleInterpreted
235       HscNothing -> 
236                 runCompiler nothingCompiler handleBatch
237       _other -> 
238                 runCompiler batchCompiler handleBatch
239
240
241 -----------------------------------------------------------------------------
242 -- stub .h and .c files (for foreign export support)
243
244 -- The _stub.c file is derived from the haskell source file, possibly taking
245 -- into account the -stubdir option.
246 --
247 -- Consequently, we derive the _stub.o filename from the haskell object
248 -- filename.  
249 --
250 -- This isn't necessarily the same as the object filename we
251 -- would get if we just compiled the _stub.c file using the pipeline.
252 -- For example:
253 --
254 --    ghc src/A.hs -odir obj
255 -- 
256 -- results in obj/A.o, and src/A_stub.c.  If we compile src/A_stub.c with
257 -- -odir obj, we would get obj/src/A_stub.o, which is wrong; we want
258 -- obj/A_stub.o.
259
260 compileStub :: GhcMonad m => HscEnv -> Module -> ModLocation
261             -> m FilePath
262 compileStub hsc_env mod location = do
263         let (o_base, o_ext) = splitExtension (ml_obj_file location)
264             stub_o = (o_base ++ "_stub") <.> o_ext
265
266         -- compile the _stub.c file w/ gcc
267         let (stub_c,_,_) = mkStubPaths (hsc_dflags hsc_env) (moduleName mod) location
268         runPipeline StopLn hsc_env (stub_c,Nothing)  Nothing
269                 (SpecificFile stub_o) Nothing{-no ModLocation-}
270
271         return stub_o
272
273
274 -- ---------------------------------------------------------------------------
275 -- Link
276
277 link :: GhcLink                 -- interactive or batch
278      -> DynFlags                -- dynamic flags
279      -> Bool                    -- attempt linking in batch mode?
280      -> HomePackageTable        -- what to link
281      -> IO SuccessFlag
282
283 -- For the moment, in the batch linker, we don't bother to tell doLink
284 -- which packages to link -- it just tries all that are available.
285 -- batch_attempt_linking should only be *looked at* in batch mode.  It
286 -- should only be True if the upsweep was successful and someone
287 -- exports main, i.e., we have good reason to believe that linking
288 -- will succeed.
289
290 #ifdef GHCI
291 link LinkInMemory _ _ _
292     = do -- Not Linking...(demand linker will do the job)
293          return Succeeded
294 #endif
295
296 link NoLink _ _ _
297    = return Succeeded
298
299 link LinkBinary dflags batch_attempt_linking hpt
300    | batch_attempt_linking
301    = do
302         let
303             home_mod_infos = eltsUFM hpt
304
305             -- the packages we depend on
306             pkg_deps  = concatMap (dep_pkgs . mi_deps . hm_iface) home_mod_infos
307
308             -- the linkables to link
309             linkables = map (expectJust "link".hm_linkable) home_mod_infos
310
311         debugTraceMsg dflags 3 (text "link: linkables are ..." $$ vcat (map ppr linkables))
312
313         -- check for the -no-link flag
314         if isNoLink (ghcLink dflags)
315           then do debugTraceMsg dflags 3 (text "link(batch): linking omitted (-c flag given).")
316                   return Succeeded
317           else do
318
319         let getOfiles (LM _ _ us) = map nameOfObject (filter isObject us)
320             obj_files = concatMap getOfiles linkables
321
322             exe_file = exeFileName dflags
323
324         linking_needed <- linkingNeeded dflags linkables pkg_deps
325
326         if not (dopt Opt_ForceRecomp dflags) && not linking_needed
327            then do debugTraceMsg dflags 2 (text exe_file <+> ptext (sLit "is up to date, linking not required."))
328                    return Succeeded
329            else do
330
331         debugTraceMsg dflags 1 (ptext (sLit "Linking") <+> text exe_file
332                                  <+> text "...")
333
334         -- Don't showPass in Batch mode; doLink will do that for us.
335         let link = case ghcLink dflags of
336                 LinkBinary  -> linkBinary
337                 LinkDynLib  -> linkDynLib
338                 other       -> panicBadLink other
339         link dflags obj_files pkg_deps
340
341         debugTraceMsg dflags 3 (text "link: done")
342
343         -- linkBinary only returns if it succeeds
344         return Succeeded
345
346    | otherwise
347    = do debugTraceMsg dflags 3 (text "link(batch): upsweep (partially) failed OR" $$
348                                 text "   Main.main not exported; not linking.")
349         return Succeeded
350
351 -- warning suppression
352 link other _ _ _ = panicBadLink other
353
354 panicBadLink :: GhcLink -> a
355 panicBadLink other = panic ("link: GHC not built to link this way: " ++
356                             show other)
357
358
359 linkingNeeded :: DynFlags -> [Linkable] -> [PackageId] -> IO Bool
360 linkingNeeded dflags linkables pkg_deps = do
361         -- if the modification time on the executable is later than the
362         -- modification times on all of the objects and libraries, then omit
363         -- linking (unless the -fforce-recomp flag was given).
364   let exe_file = exeFileName dflags
365   e_exe_time <- IO.try $ getModificationTime exe_file
366   case e_exe_time of
367     Left _  -> return True
368     Right t -> do
369         -- first check object files and extra_ld_inputs
370         extra_ld_inputs <- readIORef v_Ld_inputs
371         e_extra_times <- mapM (IO.try . getModificationTime) extra_ld_inputs
372         let (errs,extra_times) = splitEithers e_extra_times
373         let obj_times =  map linkableTime linkables ++ extra_times
374         if not (null errs) || any (t <) obj_times
375             then return True 
376             else do
377
378         -- next, check libraries. XXX this only checks Haskell libraries,
379         -- not extra_libraries or -l things from the command line.
380         let pkg_map = pkgIdMap (pkgState dflags)
381             pkg_hslibs  = [ (libraryDirs c, lib)
382                           | Just c <- map (lookupPackage pkg_map) pkg_deps,
383                             lib <- packageHsLibs dflags c ]
384
385         pkg_libfiles <- mapM (uncurry findHSLib) pkg_hslibs
386         if any isNothing pkg_libfiles then return True else do
387         e_lib_times <- mapM (IO.try . getModificationTime)
388                           (catMaybes pkg_libfiles)
389         let (lib_errs,lib_times) = splitEithers e_lib_times
390         if not (null lib_errs) || any (t <) lib_times
391            then return True
392            else return False
393
394 findHSLib :: [String] -> String -> IO (Maybe FilePath)
395 findHSLib dirs lib = do
396   let batch_lib_file = "lib" ++ lib <.> "a"
397   found <- filterM doesFileExist (map (</> batch_lib_file) dirs)
398   case found of
399     [] -> return Nothing
400     (x:_) -> return (Just x)
401
402 -- -----------------------------------------------------------------------------
403 -- Compile files in one-shot mode.
404
405 oneShot :: GhcMonad m =>
406            HscEnv -> Phase -> [(String, Maybe Phase)] -> m ()
407 oneShot hsc_env stop_phase srcs = do
408   o_files <- mapM (compileFile hsc_env stop_phase) srcs
409   liftIO $ doLink (hsc_dflags hsc_env) stop_phase o_files
410
411 compileFile :: GhcMonad m =>
412                HscEnv -> Phase -> (FilePath, Maybe Phase) -> m FilePath
413 compileFile hsc_env stop_phase (src, mb_phase) = do
414    exists <- liftIO $ doesFileExist src
415    when (not exists) $ 
416         ghcError (CmdLineError ("does not exist: " ++ src))
417    
418    let
419         dflags = hsc_dflags hsc_env
420         split     = dopt Opt_SplitObjs dflags
421         mb_o_file = outputFile dflags
422         ghc_link  = ghcLink dflags      -- Set by -c or -no-link
423
424         -- When linking, the -o argument refers to the linker's output. 
425         -- otherwise, we use it as the name for the pipeline's output.
426         output
427          | StopLn <- stop_phase, not (isNoLink ghc_link) = Persistent
428                 -- -o foo applies to linker
429          | Just o_file <- mb_o_file = SpecificFile o_file
430                 -- -o foo applies to the file we are compiling now
431          | otherwise = Persistent
432
433         stop_phase' = case stop_phase of 
434                         As | split -> SplitAs
435                         _          -> stop_phase
436
437    ( _, out_file) <- runPipeline stop_phase' hsc_env
438                             (src, mb_phase) Nothing output
439                             Nothing{-no ModLocation-}
440    return out_file
441
442
443 doLink :: DynFlags -> Phase -> [FilePath] -> IO ()
444 doLink dflags stop_phase o_files
445   | not (isStopLn stop_phase)
446   = return ()           -- We stopped before the linking phase
447
448   | otherwise
449   = case ghcLink dflags of
450         NoLink     -> return ()
451         LinkBinary -> linkBinary dflags o_files link_pkgs
452         LinkDynLib -> linkDynLib dflags o_files []
453         other      -> panicBadLink other
454   where
455    -- Always link in the haskell98 package for static linking.  Other
456    -- packages have to be specified via the -package flag.
457     link_pkgs
458      | dopt Opt_AutoLinkPackages dflags = [haskell98PackageId]
459      | otherwise                        = []
460
461
462 -- ---------------------------------------------------------------------------
463
464 data PipelineOutput 
465   = Temporary
466         -- ^ Output should be to a temporary file: we're going to
467         -- run more compilation steps on this output later.
468   | Persistent
469         -- ^ We want a persistent file, i.e. a file in the current directory
470         -- derived from the input filename, but with the appropriate extension.
471         -- eg. in "ghc -c Foo.hs" the output goes into ./Foo.o.
472   | SpecificFile FilePath
473         -- ^ The output must go into the specified file.
474
475 -- | Run a compilation pipeline, consisting of multiple phases.
476 --
477 -- This is the interface to the compilation pipeline, which runs
478 -- a series of compilation steps on a single source file, specifying
479 -- at which stage to stop.
480 --
481 -- The DynFlags can be modified by phases in the pipeline (eg. by
482 -- GHC_OPTIONS pragmas), and the changes affect later phases in the
483 -- pipeline.
484 runPipeline
485   :: GhcMonad m =>
486      Phase                      -- ^ When to stop
487   -> HscEnv                     -- ^ Compilation environment
488   -> (FilePath,Maybe Phase)     -- ^ Input filename (and maybe -x suffix)
489   -> Maybe FilePath             -- ^ original basename (if different from ^^^)
490   -> PipelineOutput             -- ^ Output filename
491   -> Maybe ModLocation          -- ^ A ModLocation, if this is a Haskell module
492   -> m (DynFlags, FilePath)     -- ^ (final flags, output filename)
493
494 runPipeline stop_phase hsc_env0 (input_fn, mb_phase) mb_basename output maybe_loc
495   = do
496   let dflags0 = hsc_dflags hsc_env0
497       (input_basename, suffix) = splitExtension input_fn
498       suffix' = drop 1 suffix -- strip off the .
499       basename | Just b <- mb_basename = b
500                | otherwise             = input_basename
501
502       -- Decide where dump files should go based on the pipeline output
503       dflags = dflags0 { dumpPrefix = Just (basename ++ ".") }
504       hsc_env = hsc_env0 {hsc_dflags = dflags}
505
506         -- If we were given a -x flag, then use that phase to start from
507       start_phase = fromMaybe (startPhase suffix') mb_phase
508
509   -- We want to catch cases of "you can't get there from here" before
510   -- we start the pipeline, because otherwise it will just run off the
511   -- end.
512   --
513   -- There is a partial ordering on phases, where A < B iff A occurs
514   -- before B in a normal compilation pipeline.
515
516   when (not (start_phase `happensBefore` stop_phase)) $
517         ghcError (UsageError 
518                     ("cannot compile this file to desired target: "
519                        ++ input_fn))
520
521   -- this is a function which will be used to calculate output file names
522   -- as we go along (we partially apply it to some of its inputs here)
523   let get_output_fn = getOutputFilename stop_phase output basename
524
525   -- Execute the pipeline...
526   (dflags', output_fn, maybe_loc) <- 
527         pipeLoop hsc_env start_phase stop_phase input_fn 
528                  basename suffix' get_output_fn maybe_loc
529
530   -- Sometimes, a compilation phase doesn't actually generate any output
531   -- (eg. the CPP phase when -fcpp is not turned on).  If we end on this
532   -- stage, but we wanted to keep the output, then we have to explicitly
533   -- copy the file, remembering to prepend a {-# LINE #-} pragma so that
534   -- further compilation stages can tell what the original filename was.
535   case output of
536     Temporary -> 
537         return (dflags', output_fn)
538     _other -> liftIO $
539         do final_fn <- get_output_fn dflags' stop_phase maybe_loc
540            when (final_fn /= output_fn) $ do
541               let msg = ("Copying `" ++ output_fn ++"' to `" ++ final_fn ++ "'")
542                   line_prag = Just ("{-# LINE 1 \"" ++ input_fn ++ "\" #-}\n")
543               copyWithHeader dflags msg line_prag output_fn final_fn
544            return (dflags', final_fn)
545
546
547
548 pipeLoop :: GhcMonad m =>
549             HscEnv -> Phase -> Phase
550          -> FilePath  -> String -> Suffix
551          -> (DynFlags -> Phase -> Maybe ModLocation -> IO FilePath)
552          -> Maybe ModLocation
553          -> m (DynFlags, FilePath, Maybe ModLocation)
554
555 pipeLoop hsc_env phase stop_phase 
556          input_fn orig_basename orig_suff 
557          orig_get_output_fn maybe_loc
558
559   | phase `eqPhase` stop_phase            -- All done
560   = return (hsc_dflags hsc_env, input_fn, maybe_loc)
561
562   | not (phase `happensBefore` stop_phase)
563         -- Something has gone wrong.  We'll try to cover all the cases when
564         -- this could happen, so if we reach here it is a panic.
565         -- eg. it might happen if the -C flag is used on a source file that
566         -- has {-# OPTIONS -fasm #-}.
567   = panic ("pipeLoop: at phase " ++ show phase ++ 
568            " but I wanted to stop at phase " ++ show stop_phase)
569
570   | otherwise 
571   = do (next_phase, dflags', maybe_loc, output_fn)
572           <- runPhase phase stop_phase hsc_env orig_basename 
573                       orig_suff input_fn orig_get_output_fn maybe_loc
574        let hsc_env' = hsc_env {hsc_dflags = dflags'}
575        pipeLoop hsc_env' next_phase stop_phase output_fn
576                 orig_basename orig_suff orig_get_output_fn maybe_loc
577
578 getOutputFilename
579   :: Phase -> PipelineOutput -> String
580   -> DynFlags -> Phase{-next phase-} -> Maybe ModLocation -> IO FilePath
581 getOutputFilename stop_phase output basename
582  = func
583  where
584         func dflags next_phase maybe_location
585            | is_last_phase, Persistent <- output     = persistent_fn
586            | is_last_phase, SpecificFile f <- output = return f
587            | keep_this_output                        = persistent_fn
588            | otherwise                               = newTempName dflags suffix
589            where
590                 hcsuf      = hcSuf dflags
591                 odir       = objectDir dflags
592                 osuf       = objectSuf dflags
593                 keep_hc    = dopt Opt_KeepHcFiles dflags
594                 keep_raw_s = dopt Opt_KeepRawSFiles dflags
595                 keep_s     = dopt Opt_KeepSFiles dflags
596
597                 myPhaseInputExt HCc    = hcsuf
598                 myPhaseInputExt StopLn = osuf
599                 myPhaseInputExt other  = phaseInputExt other
600
601                 is_last_phase = next_phase `eqPhase` stop_phase
602
603                 -- sometimes, we keep output from intermediate stages
604                 keep_this_output = 
605                      case next_phase of
606                              StopLn              -> True
607                              Mangle | keep_raw_s -> True
608                              As     | keep_s     -> True
609                              HCc    | keep_hc    -> True
610                              _other              -> False
611
612                 suffix = myPhaseInputExt next_phase
613
614                 -- persistent object files get put in odir
615                 persistent_fn 
616                    | StopLn <- next_phase = return odir_persistent
617                    | otherwise            = return persistent
618
619                 persistent = basename <.> suffix
620
621                 odir_persistent
622                    | Just loc <- maybe_location = ml_obj_file loc
623                    | Just d <- odir = d </> persistent
624                    | otherwise      = persistent
625
626
627 -- -----------------------------------------------------------------------------
628 -- | Each phase in the pipeline returns the next phase to execute, and the
629 -- name of the file in which the output was placed.
630 --
631 -- We must do things dynamically this way, because we often don't know
632 -- what the rest of the phases will be until part-way through the
633 -- compilation: for example, an {-# OPTIONS -fasm #-} at the beginning
634 -- of a source file can change the latter stages of the pipeline from
635 -- taking the via-C route to using the native code generator.
636 --
637 runPhase :: GhcMonad m =>
638             Phase       -- ^ Do this phase first
639          -> Phase       -- ^ Stop just before this phase
640          -> HscEnv
641          -> String      -- ^ basename of original input source
642          -> String      -- ^ its extension
643          -> FilePath    -- ^ name of file which contains the input to this phase.
644          -> (DynFlags -> Phase -> Maybe ModLocation -> IO FilePath)
645                         -- ^ how to calculate the output filename
646          -> Maybe ModLocation           -- ^ the ModLocation, if we have one
647          -> m (Phase,                   -- next phase
648                DynFlags,                -- new dynamic flags
649                Maybe ModLocation,       -- the ModLocation, if we have one
650                FilePath)                -- output filename
651
652         -- Invariant: the output filename always contains the output
653         -- Interesting case: Hsc when there is no recompilation to do
654         --                   Then the output filename is still a .o file 
655
656 -------------------------------------------------------------------------------
657 -- Unlit phase 
658
659 runPhase (Unlit sf) _stop hsc_env _basename _suff input_fn get_output_fn maybe_loc
660   = do
661        let dflags = hsc_dflags hsc_env
662        output_fn <- liftIO $ get_output_fn dflags (Cpp sf) maybe_loc
663
664        let unlit_flags = getOpts dflags opt_L
665            flags = map SysTools.Option unlit_flags ++
666                    [ -- The -h option passes the file name for unlit to
667                      -- put in a #line directive
668                      SysTools.Option     "-h"
669                      -- cpp interprets \b etc as escape sequences,
670                      -- so we use / for filenames in pragmas
671                    , SysTools.Option $ reslash Forwards $ normalise input_fn
672                    , SysTools.FileOption "" input_fn
673                    , SysTools.FileOption "" output_fn
674                    ]
675
676        liftIO $ SysTools.runUnlit dflags flags
677
678        return (Cpp sf, dflags, maybe_loc, output_fn)
679
680 -------------------------------------------------------------------------------
681 -- Cpp phase : (a) gets OPTIONS out of file
682 --             (b) runs cpp if necessary
683
684 runPhase (Cpp sf) _stop hsc_env _basename _suff input_fn get_output_fn maybe_loc
685   = do let dflags0 = hsc_dflags hsc_env
686        src_opts <- liftIO $ getOptionsFromFile dflags0 input_fn
687        (dflags, unhandled_flags, warns)
688            <- liftIO $ parseDynamicNoPackageFlags dflags0 src_opts
689        handleFlagWarnings dflags warns
690        checkProcessArgsResult unhandled_flags
691
692        if not (dopt Opt_Cpp dflags) then
693            -- no need to preprocess CPP, just pass input file along
694            -- to the next phase of the pipeline.
695           return (HsPp sf, dflags, maybe_loc, input_fn)
696         else do
697             output_fn <- liftIO $ get_output_fn dflags (HsPp sf) maybe_loc
698             liftIO $ doCpp dflags True{-raw-} False{-no CC opts-} input_fn output_fn
699             return (HsPp sf, dflags, maybe_loc, output_fn)
700
701 -------------------------------------------------------------------------------
702 -- HsPp phase 
703
704 runPhase (HsPp sf) _stop hsc_env basename suff input_fn get_output_fn maybe_loc
705   = do let dflags = hsc_dflags hsc_env
706        if not (dopt Opt_Pp dflags) then
707            -- no need to preprocess, just pass input file along
708            -- to the next phase of the pipeline.
709           return (Hsc sf, dflags, maybe_loc, input_fn)
710         else do
711             let hspp_opts = getOpts dflags opt_F
712             let orig_fn = basename <.> suff
713             output_fn <- liftIO $ get_output_fn dflags (Hsc sf) maybe_loc
714             liftIO $ SysTools.runPp dflags
715                            ( [ SysTools.Option     orig_fn
716                              , SysTools.Option     input_fn
717                              , SysTools.FileOption "" output_fn
718                              ] ++
719                              map SysTools.Option hspp_opts
720                            )
721             return (Hsc sf, dflags, maybe_loc, output_fn)
722
723 -----------------------------------------------------------------------------
724 -- Hsc phase
725
726 -- Compilation of a single module, in "legacy" mode (_not_ under
727 -- the direction of the compilation manager).
728 runPhase (Hsc src_flavour) stop hsc_env basename suff input_fn get_output_fn _maybe_loc 
729  = do   -- normal Hsc mode, not mkdependHS
730         let dflags0 = hsc_dflags hsc_env
731
732   -- we add the current directory (i.e. the directory in which
733   -- the .hs files resides) to the include path, since this is
734   -- what gcc does, and it's probably what you want.
735         let current_dir = case takeDirectory basename of
736                       "" -> "." -- XXX Hack
737                       d -> d
738         
739             paths = includePaths dflags0
740             dflags = dflags0 { includePaths = current_dir : paths }
741         
742   -- gather the imports and module name
743         (hspp_buf,mod_name,imps,src_imps) <- 
744             case src_flavour of
745                 ExtCoreFile -> do  -- no explicit imports in ExtCore input.
746                     m <- liftIO $ getCoreModuleName input_fn
747                     return (Nothing, mkModuleName m, [], [])
748
749                 _           -> do
750                     buf <- liftIO $ hGetStringBuffer input_fn
751                     (src_imps,imps,L _ mod_name) <- getImports dflags buf input_fn (basename <.> suff)
752                     return (Just buf, mod_name, imps, src_imps)
753
754   -- Build a ModLocation to pass to hscMain.
755   -- The source filename is rather irrelevant by now, but it's used
756   -- by hscMain for messages.  hscMain also needs 
757   -- the .hi and .o filenames, and this is as good a way
758   -- as any to generate them, and better than most. (e.g. takes 
759   -- into accout the -osuf flags)
760         location1 <- liftIO $ mkHomeModLocation2 dflags mod_name basename suff
761
762   -- Boot-ify it if necessary
763         let location2 | isHsBoot src_flavour = addBootSuffixLocn location1
764                       | otherwise            = location1 
765                                         
766
767   -- Take -ohi into account if present
768   -- This can't be done in mkHomeModuleLocation because
769   -- it only applies to the module being compiles
770         let ohi = outputHi dflags
771             location3 | Just fn <- ohi = location2{ ml_hi_file = fn }
772                       | otherwise      = location2
773
774   -- Take -o into account if present
775   -- Very like -ohi, but we must *only* do this if we aren't linking
776   -- (If we're linking then the -o applies to the linked thing, not to
777   -- the object file for one module.)
778   -- Note the nasty duplication with the same computation in compileFile above
779         let expl_o_file = outputFile dflags
780             location4 | Just ofile <- expl_o_file
781                       , isNoLink (ghcLink dflags)
782                       = location3 { ml_obj_file = ofile }
783                       | otherwise = location3
784
785             o_file = ml_obj_file location4      -- The real object file
786
787
788   -- Figure out if the source has changed, for recompilation avoidance.
789   --
790   -- Setting source_unchanged to True means that M.o seems
791   -- to be up to date wrt M.hs; so no need to recompile unless imports have
792   -- changed (which the compiler itself figures out).
793   -- Setting source_unchanged to False tells the compiler that M.o is out of
794   -- date wrt M.hs (or M.o doesn't exist) so we must recompile regardless.
795         src_timestamp <- liftIO $ getModificationTime (basename <.> suff)
796
797         let force_recomp = dopt Opt_ForceRecomp dflags
798         source_unchanged <-
799           if force_recomp || not (isStopLn stop)
800                 -- Set source_unchanged to False unconditionally if
801                 --      (a) recompilation checker is off, or
802                 --      (b) we aren't going all the way to .o file (e.g. ghc -S)
803              then return False  
804                 -- Otherwise look at file modification dates
805              else do o_file_exists <- liftIO $ doesFileExist o_file
806                      if not o_file_exists
807                         then return False       -- Need to recompile
808                         else do t2 <- liftIO $ getModificationTime o_file
809                                 if t2 > src_timestamp
810                                   then return True
811                                   else return False
812
813   -- get the DynFlags
814         let hsc_lang = hscMaybeAdjustTarget dflags stop src_flavour (hscTarget dflags)
815         let next_phase = hscNextPhase dflags src_flavour hsc_lang
816         output_fn  <- liftIO $ get_output_fn dflags next_phase (Just location4)
817
818         let dflags' = dflags { hscTarget = hsc_lang,
819                                hscOutName = output_fn,
820                                extCoreName = basename ++ ".hcr" }
821
822         let hsc_env' = hsc_env {hsc_dflags = dflags'}
823
824   -- Tell the finder cache about this module
825         mod <- liftIO $ addHomeModuleToFinder hsc_env' mod_name location4
826
827   -- Make the ModSummary to hand to hscMain
828         let
829             mod_summary = ModSummary {  ms_mod       = mod, 
830                                         ms_hsc_src   = src_flavour,
831                                         ms_hspp_file = input_fn,
832                                         ms_hspp_opts = dflags,
833                                         ms_hspp_buf  = hspp_buf,
834                                         ms_location  = location4,
835                                         ms_hs_date   = src_timestamp,
836                                         ms_obj_date  = Nothing,
837                                         ms_imps      = imps,
838                                         ms_srcimps   = src_imps }
839
840   -- run the compiler!
841         result <- hscCompileOneShot hsc_env'
842                           mod_summary source_unchanged 
843                           Nothing       -- No iface
844                           Nothing       -- No "module i of n" progress info
845
846         case result of
847           HscNoRecomp
848               -> do liftIO $ SysTools.touch dflags' "Touching object file" o_file
849                     -- The .o file must have a later modification date
850                     -- than the source file (else we wouldn't be in HscNoRecomp)
851                     -- but we touch it anyway, to keep 'make' happy (we think).
852                     return (StopLn, dflags', Just location4, o_file)
853           (HscRecomp hasStub _)
854               -> do when hasStub $
855                          do stub_o <- compileStub hsc_env' mod location4
856                             liftIO $ consIORef v_Ld_inputs stub_o
857                     -- In the case of hs-boot files, generate a dummy .o-boot 
858                     -- stamp file for the benefit of Make
859                     when (isHsBoot src_flavour) $
860                       liftIO $ SysTools.touch dflags' "Touching object file" o_file
861                     return (next_phase, dflags', Just location4, output_fn)
862
863 -----------------------------------------------------------------------------
864 -- Cmm phase
865
866 runPhase CmmCpp _stop hsc_env _basename _suff input_fn get_output_fn maybe_loc
867   = do
868        let dflags = hsc_dflags hsc_env
869        output_fn <- liftIO $ get_output_fn dflags Cmm maybe_loc
870        liftIO $ doCpp dflags False{-not raw-} True{-include CC opts-} input_fn output_fn
871        return (Cmm, dflags, maybe_loc, output_fn)
872
873 runPhase Cmm stop hsc_env basename _ input_fn get_output_fn maybe_loc
874   = do
875         let dflags = hsc_dflags hsc_env
876         let hsc_lang = hscMaybeAdjustTarget dflags stop HsSrcFile (hscTarget dflags)
877         let next_phase = hscNextPhase dflags HsSrcFile hsc_lang
878         output_fn <- liftIO $ get_output_fn dflags next_phase maybe_loc
879
880         let dflags' = dflags { hscTarget = hsc_lang,
881                                hscOutName = output_fn,
882                                extCoreName = basename ++ ".hcr" }
883         let hsc_env' = hsc_env {hsc_dflags = dflags'}
884
885         hscCmmFile hsc_env' input_fn
886
887         -- XXX: catch errors above and convert them into ghcError?  Original
888         -- code was:
889         --
890         --when (not ok) $ ghcError (PhaseFailed "cmm" (ExitFailure 1))
891
892         return (next_phase, dflags, maybe_loc, output_fn)
893
894 -----------------------------------------------------------------------------
895 -- Cc phase
896
897 -- we don't support preprocessing .c files (with -E) now.  Doing so introduces
898 -- way too many hacks, and I can't say I've ever used it anyway.
899
900 runPhase cc_phase _stop hsc_env _basename _suff input_fn get_output_fn maybe_loc
901    | cc_phase `eqPhase` Cc || cc_phase `eqPhase` Ccpp || cc_phase `eqPhase` HCc
902    = do let dflags = hsc_dflags hsc_env
903         let cc_opts = getOpts dflags opt_c
904             hcc = cc_phase `eqPhase` HCc
905
906         let cmdline_include_paths = includePaths dflags
907
908         -- HC files have the dependent packages stamped into them
909         pkgs <- if hcc then liftIO (getHCFilePackages input_fn) else return []
910
911         -- add package include paths even if we're just compiling .c
912         -- files; this is the Value Add(TM) that using ghc instead of
913         -- gcc gives you :)
914         pkg_include_dirs <- liftIO $ getPackageIncludePath dflags pkgs
915         let include_paths = foldr (\ x xs -> "-I" : x : xs) []
916                               (cmdline_include_paths ++ pkg_include_dirs)
917
918         let (md_c_flags, md_regd_c_flags) = machdepCCOpts dflags
919         gcc_extra_viac_flags <- liftIO $ getExtraViaCOpts dflags
920         let pic_c_flags = picCCOpts dflags
921
922         let verb = getVerbFlag dflags
923
924         -- cc-options are not passed when compiling .hc files.  Our
925         -- hc code doesn't not #include any header files anyway, so these
926         -- options aren't necessary.
927         pkg_extra_cc_opts <-
928           if cc_phase `eqPhase` HCc
929              then return []
930              else liftIO $ getPackageExtraCcOpts dflags pkgs
931
932 #ifdef darwin_TARGET_OS
933         pkg_framework_paths <- liftIO $ getPackageFrameworkPath dflags pkgs
934         let cmdline_framework_paths = frameworkPaths dflags
935         let framework_paths = map ("-F"++) 
936                         (cmdline_framework_paths ++ pkg_framework_paths)
937 #endif
938
939         let split_objs = dopt Opt_SplitObjs dflags
940             split_opt | hcc && split_objs = [ "-DUSE_SPLIT_MARKERS" ]
941                       | otherwise         = [ ]
942
943         let cc_opt | optLevel dflags >= 2 = "-O2"
944                    | otherwise            = "-O"
945
946         -- Decide next phase
947         
948         let mangle = dopt Opt_DoAsmMangling dflags
949             next_phase
950                 | hcc && mangle     = Mangle
951                 | otherwise         = As
952         output_fn <- liftIO $ get_output_fn dflags next_phase maybe_loc
953
954         let
955           more_hcc_opts =
956 #if i386_TARGET_ARCH
957                 -- on x86 the floating point regs have greater precision
958                 -- than a double, which leads to unpredictable results.
959                 -- By default, we turn this off with -ffloat-store unless
960                 -- the user specified -fexcess-precision.
961                 (if dopt Opt_ExcessPrecision dflags 
962                         then [] 
963                         else [ "-ffloat-store" ]) ++
964 #endif
965                 -- gcc's -fstrict-aliasing allows two accesses to memory
966                 -- to be considered non-aliasing if they have different types.
967                 -- This interacts badly with the C code we generate, which is
968                 -- very weakly typed, being derived from C--.
969                 ["-fno-strict-aliasing"]
970
971
972
973         liftIO $ SysTools.runCc dflags (
974                 -- force the C compiler to interpret this file as C when
975                 -- compiling .hc files, by adding the -x c option.
976                 -- Also useful for plain .c files, just in case GHC saw a 
977                 -- -x c option.
978                         [ SysTools.Option "-x", if cc_phase `eqPhase` Ccpp
979                                                 then SysTools.Option "c++" else SysTools.Option "c"] ++
980                         [ SysTools.FileOption "" input_fn
981                         , SysTools.Option "-o"
982                         , SysTools.FileOption "" output_fn
983                         ]
984                        ++ map SysTools.Option (
985                           md_c_flags
986                        ++ pic_c_flags
987 #ifdef sparc_TARGET_ARCH
988         -- We only support SparcV9 and better because V8 lacks an atomic CAS
989         -- instruction. Note that the user can still override this
990         -- (e.g., -mcpu=ultrasparc) as GCC picks the "best" -mcpu flag
991         -- regardless of the ordering.
992         --
993         -- This is a temporary hack.
994                        ++ ["-mcpu=v9"]
995 #endif
996                        ++ (if hcc && mangle
997                              then md_regd_c_flags
998                              else [])
999                        ++ (if hcc
1000                              then if mangle 
1001                                      then gcc_extra_viac_flags
1002                                      else filter (=="-fwrapv")
1003                                                 gcc_extra_viac_flags
1004                                 -- still want -fwrapv even for unreg'd
1005                              else [])
1006                        ++ (if hcc 
1007                              then more_hcc_opts
1008                              else [])
1009                        ++ [ verb, "-S", "-Wimplicit", cc_opt ]
1010                        ++ [ "-D__GLASGOW_HASKELL__="++cProjectVersionInt ]
1011 #ifdef darwin_TARGET_OS
1012                        ++ framework_paths
1013 #endif
1014                        ++ cc_opts
1015                        ++ split_opt
1016                        ++ include_paths
1017                        ++ pkg_extra_cc_opts
1018                        ))
1019
1020         return (next_phase, dflags, maybe_loc, output_fn)
1021
1022         -- ToDo: postprocess the output from gcc
1023
1024 -----------------------------------------------------------------------------
1025 -- Mangle phase
1026
1027 runPhase Mangle _stop hsc_env _basename _suff input_fn get_output_fn maybe_loc
1028    = do let dflags = hsc_dflags hsc_env
1029         let mangler_opts = getOpts dflags opt_m
1030
1031 #if i386_TARGET_ARCH
1032         machdep_opts <- return [ show (stolen_x86_regs dflags) ]
1033 #else
1034         machdep_opts <- return []
1035 #endif
1036
1037         let split = dopt Opt_SplitObjs dflags
1038             next_phase
1039                 | split = SplitMangle
1040                 | otherwise = As
1041         output_fn <- liftIO $ get_output_fn dflags next_phase maybe_loc
1042
1043         liftIO $ SysTools.runMangle dflags (map SysTools.Option mangler_opts
1044                           ++ [ SysTools.FileOption "" input_fn
1045                              , SysTools.FileOption "" output_fn
1046                              ]
1047                           ++ map SysTools.Option machdep_opts)
1048
1049         return (next_phase, dflags, maybe_loc, output_fn)
1050
1051 -----------------------------------------------------------------------------
1052 -- Splitting phase
1053
1054 runPhase SplitMangle _stop hsc_env _basename _suff input_fn _get_output_fn maybe_loc
1055   = liftIO $
1056     do  -- tmp_pfx is the prefix used for the split .s files
1057         -- We also use it as the file to contain the no. of split .s files (sigh)
1058         let dflags = hsc_dflags hsc_env
1059         split_s_prefix <- SysTools.newTempName dflags "split"
1060         let n_files_fn = split_s_prefix
1061
1062         SysTools.runSplit dflags
1063                           [ SysTools.FileOption "" input_fn
1064                           , SysTools.FileOption "" split_s_prefix
1065                           , SysTools.FileOption "" n_files_fn
1066                           ]
1067
1068         -- Save the number of split files for future references
1069         s <- readFile n_files_fn
1070         let n_files = read s :: Int
1071         writeIORef v_Split_info (split_s_prefix, n_files)
1072
1073         -- Remember to delete all these files
1074         addFilesToClean [ split_s_prefix ++ "__" ++ show n ++ ".s"
1075                         | n <- [1..n_files]]
1076
1077         return (SplitAs, dflags, maybe_loc, "**splitmangle**")
1078           -- we don't use the filename
1079
1080 -----------------------------------------------------------------------------
1081 -- As phase
1082
1083 runPhase As _stop hsc_env _basename _suff input_fn get_output_fn maybe_loc
1084   = liftIO $
1085     do  let dflags = hsc_dflags hsc_env
1086         let as_opts =  getOpts dflags opt_a
1087         let cmdline_include_paths = includePaths dflags
1088
1089         output_fn <- get_output_fn dflags StopLn maybe_loc
1090
1091         -- we create directories for the object file, because it
1092         -- might be a hierarchical module.
1093         createDirectoryHierarchy (takeDirectory output_fn)
1094
1095         SysTools.runAs dflags   
1096                        (map SysTools.Option as_opts
1097                        ++ [ SysTools.Option ("-I" ++ p) | p <- cmdline_include_paths ]
1098 #ifdef sparc_TARGET_ARCH
1099         -- We only support SparcV9 and better because V8 lacks an atomic CAS
1100         -- instruction so we have to make sure that the assembler accepts the
1101         -- instruction set. Note that the user can still override this
1102         -- (e.g., -mcpu=ultrasparc). GCC picks the "best" -mcpu flag
1103         -- regardless of the ordering.
1104         --
1105         -- This is a temporary hack.
1106                        ++ [ SysTools.Option "-mcpu=v9" ]
1107 #endif
1108                        ++ [ SysTools.Option "-c"
1109                           , SysTools.FileOption "" input_fn
1110                           , SysTools.Option "-o"
1111                           , SysTools.FileOption "" output_fn
1112                           ])
1113
1114         return (StopLn, dflags, maybe_loc, output_fn)
1115
1116
1117 runPhase SplitAs _stop hsc_env _basename _suff _input_fn get_output_fn maybe_loc
1118   = liftIO $ do
1119         let dflags = hsc_dflags hsc_env
1120         output_fn <- get_output_fn dflags StopLn maybe_loc
1121
1122         let base_o = dropExtension output_fn
1123             split_odir  = base_o ++ "_split"
1124             osuf = objectSuf dflags
1125
1126         createDirectoryHierarchy split_odir
1127
1128         -- remove M_split/ *.o, because we're going to archive M_split/ *.o
1129         -- later and we don't want to pick up any old objects.
1130         fs <- getDirectoryContents split_odir
1131         mapM_ removeFile $ map (split_odir </>) $ filter (osuf `isSuffixOf`) fs
1132
1133         let as_opts = getOpts dflags opt_a
1134
1135         (split_s_prefix, n) <- readIORef v_Split_info
1136
1137         let split_s   n = split_s_prefix ++ "__" ++ show n <.> "s"
1138             split_obj n = split_odir </>
1139                           takeFileName base_o ++ "__" ++ show n <.> osuf
1140
1141         let assemble_file n
1142               = SysTools.runAs dflags
1143                          (map SysTools.Option as_opts ++
1144                           [ SysTools.Option "-c"
1145                           , SysTools.Option "-o"
1146                           , SysTools.FileOption "" (split_obj n)
1147                           , SysTools.FileOption "" (split_s n)
1148                           ])
1149
1150         mapM_ assemble_file [1..n]
1151
1152         -- and join the split objects into a single object file:
1153         let ld_r args = SysTools.runLink dflags ([
1154                             SysTools.Option "-nostdlib",
1155                             SysTools.Option "-nodefaultlibs",
1156                             SysTools.Option "-Wl,-r",
1157                             SysTools.Option ld_x_flag,
1158                             SysTools.Option "-o",
1159                             SysTools.FileOption "" output_fn ] ++ args)
1160             ld_x_flag | null cLD_X = ""
1161                       | otherwise  = "-Wl,-x"
1162
1163         if cLdIsGNULd == "YES"
1164             then do
1165                   let script = split_odir </> "ld.script"
1166                   writeFile script $
1167                       "INPUT(" ++ unwords (map split_obj [1..n]) ++ ")"
1168                   ld_r [SysTools.FileOption "" script]
1169             else do
1170                   ld_r (map (SysTools.FileOption "" . split_obj) [1..n])
1171
1172         return (StopLn, dflags, maybe_loc, output_fn)
1173
1174 -- warning suppression
1175 runPhase other _stop _dflags _basename _suff _input_fn _get_output_fn _maybe_loc =
1176    panic ("runPhase: don't know how to run phase " ++ show other)
1177 -----------------------------------------------------------------------------
1178 -- MoveBinary sort-of-phase
1179 -- After having produced a binary, move it somewhere else and generate a
1180 -- wrapper script calling the binary. Currently, we need this only in 
1181 -- a parallel way (i.e. in GUM), because PVM expects the binary in a
1182 -- central directory.
1183 -- This is called from linkBinary below, after linking. I haven't made it
1184 -- a separate phase to minimise interfering with other modules, and
1185 -- we don't need the generality of a phase (MoveBinary is always
1186 -- done after linking and makes only sense in a parallel setup)   -- HWL
1187
1188 runPhase_MoveBinary :: DynFlags -> FilePath -> [PackageId] -> IO Bool
1189 runPhase_MoveBinary dflags input_fn dep_packages
1190     | WayPar `elem` (wayNames dflags) && not opt_Static =
1191         panic ("Don't know how to combine PVM wrapper and dynamic wrapper")
1192     | WayPar `elem` (wayNames dflags) = do
1193         let sysMan = pgm_sysman dflags
1194         pvm_root <- getEnv "PVM_ROOT"
1195         pvm_arch <- getEnv "PVM_ARCH"
1196         let
1197            pvm_executable_base = "=" ++ input_fn
1198            pvm_executable = pvm_root ++ "/bin/" ++ pvm_arch ++ "/" ++ pvm_executable_base
1199         -- nuke old binary; maybe use configur'ed names for cp and rm?
1200         tryIO (removeFile pvm_executable)
1201         -- move the newly created binary into PVM land
1202         copy dflags "copying PVM executable" input_fn pvm_executable
1203         -- generate a wrapper script for running a parallel prg under PVM
1204         writeFile input_fn (mk_pvm_wrapper_script pvm_executable pvm_executable_base sysMan)
1205         return True
1206     | not opt_Static =
1207         case (dynLibLoader dflags) of
1208           Wrapped wrapmode ->
1209               do
1210                 let (o_base, o_ext) = splitExtension input_fn
1211                 let wrapped_executable | o_ext == "exe" = (o_base ++ ".dyn") <.> o_ext
1212                                        | otherwise = input_fn ++ ".dyn"
1213                 behaviour <- wrapper_behaviour dflags wrapmode dep_packages
1214
1215                 -- THINKME isn't this possible to do a bit nicer?
1216                 let behaviour' = concatMap (\x -> if x=='\\' then "\\\\" else [x]) behaviour
1217                 renameFile input_fn wrapped_executable
1218                 let rtsDetails = (getPackageDetails (pkgState dflags) rtsPackageId);
1219                 SysTools.runCc dflags
1220                   ([ SysTools.FileOption "" ((head (libraryDirs rtsDetails)) ++ "/dyn-wrapper.c")
1221                    , SysTools.Option ("-DBEHAVIOUR=\"" ++ behaviour' ++ "\"")
1222                    , SysTools.Option "-o"
1223                    , SysTools.FileOption "" input_fn
1224                    ] ++ map (SysTools.FileOption "-I") (includeDirs rtsDetails))
1225                 return True
1226           _ -> return True
1227     | otherwise = return True
1228
1229 wrapper_behaviour :: DynFlags -> Maybe [Char] -> [PackageId] -> IO [Char]
1230 wrapper_behaviour dflags mode dep_packages =
1231     let seperateBySemiColon strs = tail $ concatMap (';':) strs
1232     in case mode of
1233       Nothing -> do
1234                 pkg_lib_paths <- getPackageLibraryPath dflags dep_packages
1235                 return ('H' : (seperateBySemiColon pkg_lib_paths))
1236       Just s -> do
1237         allpkg <- getPreloadPackagesAnd dflags dep_packages
1238         putStrLn (unwords (map (packageIdString . packageConfigId) allpkg))
1239         return $ 'F':s ++ ';':(seperateBySemiColon (map (packageIdString . packageConfigId) allpkg))
1240
1241 -- generates a Perl skript starting a parallel prg under PVM
1242 mk_pvm_wrapper_script :: String -> String -> String -> String
1243 mk_pvm_wrapper_script pvm_executable pvm_executable_base sysMan = unlines $
1244  [
1245   "eval 'exec perl -S $0 ${1+\"$@\"}'", 
1246   "  if $running_under_some_shell;",
1247   "# =!=!=!=!=!=!=!=!=!=!=!",
1248   "# This script is automatically generated: DO NOT EDIT!!!",
1249   "# Generated by Glasgow Haskell Compiler",
1250   "# ngoqvam choHbogh vaj' vIHoHnISbej !!!!",
1251   "#",
1252   "$pvm_executable      = '" ++ pvm_executable ++ "';",
1253   "$pvm_executable_base = '" ++ pvm_executable_base ++ "';",
1254   "$SysMan = '" ++ sysMan ++ "';",
1255   "",
1256   {- ToDo: add the magical shortcuts again iff we actually use them -- HWL
1257   "# first, some magical shortcuts to run "commands" on the binary",
1258   "# (which is hidden)",
1259   "if ($#ARGV == 1 && $ARGV[0] eq '+RTS' && $ARGV[1] =~ /^--((size|file|strip|rm|nm).*)/ ) {",
1260   "    local($cmd) = $1;",
1261   "    system("$cmd $pvm_executable");",
1262   "    exit(0); # all done",
1263   "}", -}
1264   "",
1265   "# Now, run the real binary; process the args first",
1266   "$ENV{'PE'} = $pvm_executable_base;", --  ++ pvm_executable_base,
1267   "$debug = '';",
1268   "$nprocessors = 0; # the default: as many PEs as machines in PVM config",
1269   "@nonPVM_args = ();",
1270   "$in_RTS_args = 0;",
1271   "",
1272   "args: while ($a = shift(@ARGV)) {",
1273   "    if ( $a eq '+RTS' ) {",
1274   "        $in_RTS_args = 1;",
1275   "    } elsif ( $a eq '-RTS' ) {",
1276   "        $in_RTS_args = 0;",
1277   "    }",
1278   "    if ( $a eq '-d' && $in_RTS_args ) {",
1279   "        $debug = '-';",
1280   "    } elsif ( $a =~ /^-qN(\\d+)/ && $in_RTS_args ) {",
1281   "        $nprocessors = $1;",
1282   "    } elsif ( $a =~ /^-qp(\\d+)/ && $in_RTS_args ) {",
1283   "        $nprocessors = $1;",
1284   "    } else {",
1285   "        push(@nonPVM_args, $a);",
1286   "    }",
1287   "}",
1288   "",
1289   "local($return_val) = 0;",
1290   "# Start the parallel execution by calling SysMan",
1291   "system(\"$SysMan $debug $pvm_executable $nprocessors @nonPVM_args\");",
1292   "$return_val = $?;",
1293   "# ToDo: fix race condition moving files and flushing them!!",
1294   "system(\"cp $ENV{'HOME'}/$pvm_executable_base.???.gr .\") if -f \"$ENV{'HOME'}/$pvm_executable_base.002.gr\";",
1295   "exit($return_val);"
1296  ]
1297
1298 -----------------------------------------------------------------------------
1299 -- Look for the /* GHC_PACKAGES ... */ comment at the top of a .hc file
1300
1301 getHCFilePackages :: FilePath -> IO [PackageId]
1302 getHCFilePackages filename =
1303   Exception.bracket (openFile filename ReadMode) hClose $ \h -> do
1304     l <- hGetLine h
1305     case l of
1306       '/':'*':' ':'G':'H':'C':'_':'P':'A':'C':'K':'A':'G':'E':'S':rest ->
1307           return (map stringToPackageId (words rest))
1308       _other ->
1309           return []
1310
1311 -----------------------------------------------------------------------------
1312 -- Static linking, of .o files
1313
1314 -- The list of packages passed to link is the list of packages on
1315 -- which this program depends, as discovered by the compilation
1316 -- manager.  It is combined with the list of packages that the user
1317 -- specifies on the command line with -package flags.  
1318 --
1319 -- In one-shot linking mode, we can't discover the package
1320 -- dependencies (because we haven't actually done any compilation or
1321 -- read any interface files), so the user must explicitly specify all
1322 -- the packages.
1323
1324 linkBinary :: DynFlags -> [FilePath] -> [PackageId] -> IO ()
1325 linkBinary dflags o_files dep_packages = do
1326     let verb = getVerbFlag dflags
1327         output_fn = exeFileName dflags
1328
1329     -- get the full list of packages to link with, by combining the
1330     -- explicit packages with the auto packages and all of their
1331     -- dependencies, and eliminating duplicates.
1332
1333     pkg_lib_paths <- getPackageLibraryPath dflags dep_packages
1334     let pkg_lib_path_opts = concat (map get_pkg_lib_path_opts pkg_lib_paths)
1335 #ifdef linux_TARGET_OS
1336         get_pkg_lib_path_opts l | (dynLibLoader dflags)==SystemDependent && not opt_Static = ["-L" ++ l, "-Wl,-rpath", "-Wl," ++ l]
1337                                 | otherwise = ["-L" ++ l]
1338 #else
1339         get_pkg_lib_path_opts l = ["-L" ++ l]
1340 #endif
1341
1342     let lib_paths = libraryPaths dflags
1343     let lib_path_opts = map ("-L"++) lib_paths
1344
1345     pkg_link_opts <- getPackageLinkOpts dflags dep_packages
1346
1347 #ifdef darwin_TARGET_OS
1348     pkg_framework_paths <- getPackageFrameworkPath dflags dep_packages
1349     let pkg_framework_path_opts = map ("-F"++) pkg_framework_paths
1350
1351     let framework_paths = frameworkPaths dflags
1352         framework_path_opts = map ("-F"++) framework_paths
1353
1354     pkg_frameworks <- getPackageFrameworks dflags dep_packages
1355     let pkg_framework_opts = concat [ ["-framework", fw] | fw <- pkg_frameworks ]
1356     
1357     let frameworks = cmdlineFrameworks dflags
1358         framework_opts = concat [ ["-framework", fw] | fw <- reverse frameworks ]
1359          -- reverse because they're added in reverse order from the cmd line
1360 #endif
1361 #ifdef mingw32_TARGET_OS
1362     let dynMain = if not opt_Static then
1363                       (head (libraryDirs (getPackageDetails (pkgState dflags) rtsPackageId))) ++ "/Main.dyn_o"
1364                   else
1365                       ""
1366 #endif
1367         -- probably _stub.o files
1368     extra_ld_inputs <- readIORef v_Ld_inputs
1369
1370         -- opts from -optl-<blah> (including -l<blah> options)
1371     let extra_ld_opts = getOpts dflags opt_l
1372
1373     let ways = wayNames dflags
1374
1375     -- Here are some libs that need to be linked at the *end* of
1376     -- the command line, because they contain symbols that are referred to
1377     -- by the RTS.  We can't therefore use the ordinary way opts for these.
1378     let
1379         debug_opts | WayDebug `elem` ways = [ 
1380 #if defined(HAVE_LIBBFD)
1381                         "-lbfd", "-liberty"
1382 #endif
1383                          ]
1384                    | otherwise            = []
1385
1386     let
1387         thread_opts | WayThreaded `elem` ways = [ 
1388 #if !defined(mingw32_TARGET_OS) && !defined(freebsd_TARGET_OS)
1389                         "-lpthread"
1390 #endif
1391 #if defined(osf3_TARGET_OS)
1392                         , "-lexc"
1393 #endif
1394                         ]
1395                     | otherwise               = []
1396
1397     rc_objs <- maybeCreateManifest dflags output_fn
1398
1399     let (md_c_flags, _) = machdepCCOpts dflags
1400     SysTools.runLink dflags ( 
1401                        [ SysTools.Option verb
1402                        , SysTools.Option "-o"
1403                        , SysTools.FileOption "" output_fn
1404                        ]
1405                       ++ map SysTools.Option (
1406                          md_c_flags
1407                       ++ o_files
1408 #ifdef mingw32_TARGET_OS
1409                       ++ [dynMain]
1410 #endif
1411                       ++ extra_ld_inputs
1412                       ++ lib_path_opts
1413                       ++ extra_ld_opts
1414                       ++ rc_objs
1415 #ifdef darwin_TARGET_OS
1416                       ++ framework_path_opts
1417                       ++ framework_opts
1418 #endif
1419                       ++ pkg_lib_path_opts
1420                       ++ pkg_link_opts
1421 #ifdef darwin_TARGET_OS
1422                       ++ pkg_framework_path_opts
1423                       ++ pkg_framework_opts
1424 #endif
1425                       ++ debug_opts
1426                       ++ thread_opts
1427                     ))
1428
1429     -- parallel only: move binary to another dir -- HWL
1430     success <- runPhase_MoveBinary dflags output_fn dep_packages
1431     if success then return ()
1432                else ghcError (InstallationError ("cannot move binary"))
1433
1434
1435 exeFileName :: DynFlags -> FilePath
1436 exeFileName dflags
1437   | Just s <- outputFile dflags =
1438 #if defined(mingw32_HOST_OS)
1439       if null (takeExtension s)
1440         then s <.> "exe"
1441         else s
1442 #else
1443       s
1444 #endif
1445   | otherwise = 
1446 #if defined(mingw32_HOST_OS)
1447         "main.exe"
1448 #else
1449         "a.out"
1450 #endif
1451
1452 maybeCreateManifest
1453    :: DynFlags
1454    -> FilePath                          -- filename of executable
1455    -> IO [FilePath]                     -- extra objects to embed, maybe
1456 #ifndef mingw32_TARGET_OS
1457 maybeCreateManifest _ _ = do
1458   return []
1459 #else
1460 maybeCreateManifest dflags exe_filename = do
1461   if not (dopt Opt_GenManifest dflags) then return [] else do
1462
1463   let manifest_filename = exe_filename <.> "manifest"
1464
1465   writeFile manifest_filename $ 
1466       "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n"++
1467       "  <assembly xmlns=\"urn:schemas-microsoft-com:asm.v1\" manifestVersion=\"1.0\">\n"++
1468       "  <assemblyIdentity version=\"1.0.0.0\"\n"++
1469       "     processorArchitecture=\"X86\"\n"++
1470       "     name=\"" ++ dropExtension exe_filename ++ "\"\n"++
1471       "     type=\"win32\"/>\n\n"++
1472       "  <trustInfo xmlns=\"urn:schemas-microsoft-com:asm.v3\">\n"++
1473       "    <security>\n"++
1474       "      <requestedPrivileges>\n"++
1475       "        <requestedExecutionLevel level=\"asInvoker\" uiAccess=\"false\"/>\n"++
1476       "        </requestedPrivileges>\n"++
1477       "       </security>\n"++
1478       "  </trustInfo>\n"++
1479       "</assembly>\n"
1480
1481   -- Windows will find the manifest file if it is named foo.exe.manifest.
1482   -- However, for extra robustness, and so that we can move the binary around,
1483   -- we can embed the manifest in the binary itself using windres:
1484   if not (dopt Opt_EmbedManifest dflags) then return [] else do
1485
1486   rc_filename <- newTempName dflags "rc"
1487   rc_obj_filename <- newTempName dflags (objectSuf dflags)
1488
1489   writeFile rc_filename $
1490       "1 24 MOVEABLE PURE " ++ show manifest_filename ++ "\n"
1491         -- magic numbers :-)
1492         -- show is a bit hackish above, but we need to escape the
1493         -- backslashes in the path.
1494
1495   let wr_opts = getOpts dflags opt_windres
1496   runWindres dflags $ map SysTools.Option $
1497         ["--input="++rc_filename, 
1498          "--output="++rc_obj_filename,
1499          "--output-format=coff"] 
1500         ++ wr_opts
1501         -- no FileOptions here: windres doesn't like seeing
1502         -- backslashes, apparently
1503
1504   return [rc_obj_filename]
1505 #endif
1506
1507
1508 linkDynLib :: DynFlags -> [String] -> [PackageId] -> IO ()
1509 linkDynLib dflags o_files dep_packages = do
1510     let verb = getVerbFlag dflags
1511     let o_file = outputFile dflags
1512
1513     -- We don't want to link our dynamic libs against the RTS package,
1514     -- because the RTS lib comes in several flavours and we want to be
1515     -- able to pick the flavour when a binary is linked.
1516     pkgs <- getPreloadPackagesAnd dflags dep_packages
1517
1518     -- On Windows we need to link the RTS import lib as Windows does
1519     -- not allow undefined symbols.
1520 #if !defined(mingw32_HOST_OS)
1521     let pkgs_no_rts = filter ((/= rtsPackageId) . packageConfigId) pkgs
1522 #else
1523     let pkgs_no_rts = pkgs
1524 #endif
1525     let pkg_lib_paths = collectLibraryPaths pkgs_no_rts
1526     let pkg_lib_path_opts = map ("-L"++) pkg_lib_paths
1527
1528     let lib_paths = libraryPaths dflags
1529     let lib_path_opts = map ("-L"++) lib_paths
1530
1531     let pkg_link_opts = collectLinkOpts dflags pkgs_no_rts
1532
1533         -- probably _stub.o files
1534     extra_ld_inputs <- readIORef v_Ld_inputs
1535
1536     let (md_c_flags, _) = machdepCCOpts dflags
1537     let extra_ld_opts = getOpts dflags opt_l
1538 #if defined(mingw32_HOST_OS)
1539     -----------------------------------------------------------------------------
1540     -- Making a DLL
1541     -----------------------------------------------------------------------------
1542     let output_fn = case o_file of { Just s -> s; Nothing -> "HSdll.dll"; }
1543
1544     SysTools.runLink dflags
1545          ([ SysTools.Option verb
1546           , SysTools.Option "-o"
1547           , SysTools.FileOption "" output_fn
1548           , SysTools.Option "-shared"
1549           , SysTools.FileOption "-Wl,--out-implib=" (output_fn ++ ".a")
1550           ]
1551          ++ map (SysTools.FileOption "") o_files
1552          ++ map SysTools.Option (
1553             md_c_flags
1554          ++ extra_ld_inputs
1555          ++ lib_path_opts
1556          ++ extra_ld_opts
1557          ++ pkg_lib_path_opts
1558          ++ pkg_link_opts
1559         ))
1560 #elif defined(darwin_TARGET_OS)
1561     -----------------------------------------------------------------------------
1562     -- Making a darwin dylib
1563     -----------------------------------------------------------------------------
1564     -- About the options used for Darwin:
1565     -- -dynamiclib
1566     --   Apple's way of saying -shared
1567     -- -undefined dynamic_lookup:
1568     --   Without these options, we'd have to specify the correct dependencies
1569     --   for each of the dylibs. Note that we could (and should) do without this
1570     --   for all libraries except the RTS; all we need to do is to pass the
1571     --   correct HSfoo_dyn.dylib files to the link command.
1572     --   This feature requires Mac OS X 10.3 or later; there is a similar feature,
1573     --   -flat_namespace -undefined suppress, which works on earlier versions,
1574     --   but it has other disadvantages.
1575     -- -single_module
1576     --   Build the dynamic library as a single "module", i.e. no dynamic binding
1577     --   nonsense when referring to symbols from within the library. The NCG
1578     --   assumes that this option is specified (on i386, at least).
1579     -- -Wl,-macosx_version_min -Wl,10.3
1580     --   Tell the linker its safe to assume that the library will run on 10.3 or
1581     --   later, so that it will not complain about the use of the option
1582     --   -undefined dynamic_lookup above.
1583     -- -install_name
1584     --   Causes the dynamic linker to ignore the DYLD_LIBRARY_PATH when loading
1585     --   this lib and instead look for it at its absolute path.
1586     --   When installing the .dylibs (see target.mk), we'll change that path to
1587     --   point to the place they are installed. Therefore, we won't have to set
1588     --   up DYLD_LIBRARY_PATH specifically for ghc.
1589     -----------------------------------------------------------------------------
1590
1591     let output_fn = case o_file of { Just s -> s; Nothing -> "a.out"; }
1592
1593     pwd <- getCurrentDirectory
1594     SysTools.runLink dflags
1595          ([ SysTools.Option verb
1596           , SysTools.Option "-dynamiclib"
1597           , SysTools.Option "-o"
1598           , SysTools.FileOption "" output_fn
1599           ]
1600          ++ map SysTools.Option (
1601             md_c_flags
1602          ++ o_files
1603          ++ [ "-undefined", "dynamic_lookup", "-single_module", "-Wl,-macosx_version_min","-Wl,10.3", "-install_name " ++ (pwd </> output_fn) ]
1604          ++ extra_ld_inputs
1605          ++ lib_path_opts
1606          ++ extra_ld_opts
1607          ++ pkg_lib_path_opts
1608          ++ pkg_link_opts
1609         ))
1610 #else
1611     -----------------------------------------------------------------------------
1612     -- Making a DSO
1613     -----------------------------------------------------------------------------
1614
1615     let output_fn = case o_file of { Just s -> s; Nothing -> "a.out"; }
1616
1617     SysTools.runLink dflags
1618          ([ SysTools.Option verb
1619           , SysTools.Option "-o"
1620           , SysTools.FileOption "" output_fn
1621           ]
1622          ++ map SysTools.Option (
1623             md_c_flags
1624          ++ o_files
1625          ++ [ "-shared", "-Wl,-Bsymbolic" ] -- we need symbolic linking to resolve non-PIC intra-package-relocations
1626          ++ extra_ld_inputs
1627          ++ lib_path_opts
1628          ++ extra_ld_opts
1629          ++ pkg_lib_path_opts
1630          ++ pkg_link_opts
1631         ))
1632 #endif
1633 -- -----------------------------------------------------------------------------
1634 -- Running CPP
1635
1636 doCpp :: DynFlags -> Bool -> Bool -> FilePath -> FilePath -> IO ()
1637 doCpp dflags raw include_cc_opts input_fn output_fn = do
1638     let hscpp_opts = getOpts dflags opt_P
1639     let cmdline_include_paths = includePaths dflags
1640
1641     pkg_include_dirs <- getPackageIncludePath dflags []
1642     let include_paths = foldr (\ x xs -> "-I" : x : xs) []
1643                           (cmdline_include_paths ++ pkg_include_dirs)
1644
1645     let verb = getVerbFlag dflags
1646
1647     let cc_opts
1648           | not include_cc_opts = []
1649           | otherwise           = (optc ++ md_c_flags)
1650                 where 
1651                       optc = getOpts dflags opt_c
1652                       (md_c_flags, _) = machdepCCOpts dflags
1653
1654     let cpp_prog args | raw       = SysTools.runCpp dflags args
1655                       | otherwise = SysTools.runCc dflags (SysTools.Option "-E" : args)
1656
1657     let target_defs = 
1658           [ "-D" ++ HOST_OS     ++ "_BUILD_OS=1",
1659             "-D" ++ HOST_ARCH   ++ "_BUILD_ARCH=1",
1660             "-D" ++ TARGET_OS   ++ "_HOST_OS=1",
1661             "-D" ++ TARGET_ARCH ++ "_HOST_ARCH=1" ]
1662         -- remember, in code we *compile*, the HOST is the same our TARGET,
1663         -- and BUILD is the same as our HOST.
1664
1665     cpp_prog       ([SysTools.Option verb]
1666                     ++ map SysTools.Option include_paths
1667                     ++ map SysTools.Option hsSourceCppOpts
1668                     ++ map SysTools.Option hscpp_opts
1669                     ++ map SysTools.Option cc_opts
1670                     ++ map SysTools.Option target_defs
1671                     ++ [ SysTools.Option     "-x"
1672                        , SysTools.Option     "c"
1673                        , SysTools.Option     input_fn
1674         -- We hackily use Option instead of FileOption here, so that the file
1675         -- name is not back-slashed on Windows.  cpp is capable of
1676         -- dealing with / in filenames, so it works fine.  Furthermore
1677         -- if we put in backslashes, cpp outputs #line directives
1678         -- with *double* backslashes.   And that in turn means that
1679         -- our error messages get double backslashes in them.
1680         -- In due course we should arrange that the lexer deals
1681         -- with these \\ escapes properly.
1682                        , SysTools.Option     "-o"
1683                        , SysTools.FileOption "" output_fn
1684                        ])
1685
1686 cHaskell1Version :: String
1687 cHaskell1Version = "5" -- i.e., Haskell 98
1688
1689 hsSourceCppOpts :: [String]
1690 -- Default CPP defines in Haskell source
1691 hsSourceCppOpts =
1692         [ "-D__HASKELL1__="++cHaskell1Version
1693         , "-D__GLASGOW_HASKELL__="++cProjectVersionInt                          
1694         , "-D__HASKELL98__"
1695         , "-D__CONCURRENT_HASKELL__"
1696         ]
1697
1698
1699 -- -----------------------------------------------------------------------------
1700 -- Misc.
1701
1702 hscNextPhase :: DynFlags -> HscSource -> HscTarget -> Phase
1703 hscNextPhase _ HsBootFile _        =  StopLn
1704 hscNextPhase dflags _ hsc_lang = 
1705   case hsc_lang of
1706         HscC -> HCc
1707         HscAsm | dopt Opt_SplitObjs dflags -> SplitMangle
1708                | otherwise -> As
1709         HscNothing     -> StopLn
1710         HscInterpreted -> StopLn
1711         _other         -> StopLn
1712
1713
1714 hscMaybeAdjustTarget :: DynFlags -> Phase -> HscSource -> HscTarget -> HscTarget
1715 hscMaybeAdjustTarget dflags stop _ current_hsc_lang 
1716   = hsc_lang 
1717   where
1718         keep_hc = dopt Opt_KeepHcFiles dflags
1719         hsc_lang
1720                 -- don't change the lang if we're interpreting
1721                  | current_hsc_lang == HscInterpreted = current_hsc_lang
1722
1723                 -- force -fvia-C if we are being asked for a .hc file
1724                  | HCc <- stop = HscC
1725                  | keep_hc     = HscC
1726                 -- otherwise, stick to the plan
1727                  | otherwise = current_hsc_lang
1728
1729 GLOBAL_VAR(v_Split_info, ("",0), (String,Int))
1730         -- The split prefix and number of files