%
% (c) The GRASP/AQUA Project, Glasgow University, 1993-2000
%
+
\section[GHC_Main]{Main driver for Glasgow Haskell compiler}
\begin{code}
-module HscMain ( hscMain ) where
+module HscMain (
+ HscResult(..), hscMain, initPersistentCompilerState
+#ifdef GHCI
+ , hscStmt, hscTcExpr, hscThing,
+ , compileExpr
+#endif
+ ) where
#include "HsVersions.h"
-import Maybe ( isJust )
-import Monad ( when )
-import IO ( hPutStr, hPutStrLn, hClose, stderr,
- openFile, IOMode(..) )
+#ifdef GHCI
+import TcHsSyn ( TypecheckedHsExpr )
+import CodeOutput ( outputForeignStubs )
+import ByteCodeGen ( byteCodeGen, coreExprToBCOs )
+import Linker ( HValue, linkExpr )
+import TidyPgm ( tidyCoreExpr )
+import CorePrep ( corePrepExpr )
+import Flattening ( flattenExpr )
+import TcRnDriver ( tcRnStmt, tcRnExpr, tcRnThing )
+import RdrHsSyn ( RdrNameStmt )
+import Type ( Type )
+import PrelNames ( iNTERACTIVE )
+import StringBuffer ( stringToStringBuffer )
+#endif
+
import HsSyn
-import RdrHsSyn ( RdrNameHsModule )
-import FastString ( unpackFS )
-import StringBuffer ( hGetStringBuffer )
-import Parser ( parse )
-import Lex ( PState(..), ParseResult(..) )
+import RdrName ( nameRdrName )
+import Id ( idName )
+import IdInfo ( CafInfo(..), CgInfoEnv, CgInfo(..) )
+import StringBuffer ( hGetStringBuffer, freeStringBuffer )
+import Parser
+import Lex ( ParseResult(..), ExtFlags(..), mkPState )
import SrcLoc ( mkSrcLoc )
-
-import Rename ( renameModule, checkOldIface, closeIfaceDecls )
-
+import TcRnDriver ( checkOldIface, tcRnModule, tcRnExtCore, tcRnIface )
import Rules ( emptyRuleBase )
-import PrelInfo ( wiredInThings )
-import PrelNames ( knownKeyNames )
+import PrelInfo ( wiredInThingEnv, wiredInThings )
import PrelRules ( builtinRules )
-import MkIface ( completeIface, mkModDetailsFromIface, mkModDetails,
- writeIface )
-import TcModule ( TcResults(..), typecheckModule )
-import TcEnv ( tcEnvTyCons, tcEnvClasses )
+import PrelNames ( knownKeyNames )
+import MkIface ( mkIface )
import InstEnv ( emptyInstEnv )
-import Desugar ( deSugar )
-import SimplCore ( core2core )
-import OccurAnal ( occurAnalyseBinds )
+import Desugar
+import Flattening ( flatten )
+import SimplCore
import CoreUtils ( coreBindsSize )
-import CoreTidy ( tidyCorePgm )
-import CoreToStg ( topCoreBindsToStg )
-import StgSyn ( collectFinalStgBinders )
+import TidyPgm ( tidyCorePgm )
+import CorePrep ( corePrepPgm )
+import StgSyn
+import CoreToStg ( coreToStg )
import SimplStg ( stg2stg )
import CodeGen ( codeGen )
import CodeOutput ( codeOutput )
-import Module ( ModuleName, moduleNameUserString,
- moduleUserString, moduleName, emptyModuleEnv )
+import Module ( ModuleName, moduleName )
import CmdLineOpts
-import ErrUtils ( ghcExit, doIfSet, dumpIfSet_dyn )
+import DriverPhases ( isExtCore_file )
+import ErrUtils ( dumpIfSet_dyn, showPass, printError )
import UniqSupply ( mkSplitUniqSupply )
-import Bag ( emptyBag )
+import Bag ( consBag, emptyBag )
import Outputable
-import Char ( isSpace )
-import StgInterp ( stgToInterpSyn )
import HscStats ( ppSourceStats )
-import HscTypes ( ModDetails, ModIface, PersistentCompilerState(..),
- PersistentRenamerState(..), WhatsImported(..),
- HomeSymbolTable, PackageSymbolTable, ImportVersion,
- GenAvailInfo(..), RdrAvailInfo, OrigNameEnv(..),
- PackageRuleBase, HomeIfaceTable, PackageIfaceTable,
- extendTypeEnv )
-import RnMonad ( ExportItem, ParsedIface(..) )
-import CmSummarise ( ModSummary(..), name_of_summary, ms_get_imports )
-import Finder ( Finder )
-import InterpSyn ( UnlinkedIBind )
-import StgInterp ( ItblEnv )
+import HscTypes
+import MkExternalCore ( emitExternalCore )
+import ParserCore
+import ParserCoreUtils
import FiniteMap ( FiniteMap, plusFM, emptyFM, addToFM )
-import OccName ( OccName, pprOccName )
-import Name ( Name, nameModule, emptyNameEnv, nameOccName,
- getName, extendNameEnv_C )
-import VarEnv ( emptyVarEnv )
+import OccName ( OccName )
+import Name ( Name, nameModule, nameOccName, getName )
+import NameEnv ( emptyNameEnv, mkNameEnv )
+import NameSet ( emptyNameSet )
+import Module ( Module, ModLocation(..), showModMsg )
+import FastString
+import Maybes ( expectJust )
+
+import DATA_IOREF ( newIORef, readIORef, writeIORef )
+import UNSAFE_IO ( unsafePerformIO )
+
+import Monad ( when )
+import Maybe ( isJust, fromJust )
+import IO
\end{code}
\begin{code}
data HscResult
- = HscOK ModDetails -- new details (HomeSymbolTable additions)
- (Maybe ModIface) -- new iface (if any compilation was done)
- (Maybe String) -- generated stub_h filename (in /tmp)
- (Maybe String) -- generated stub_c filename (in /tmp)
- (Maybe ([UnlinkedIBind],ItblEnv)) -- interpreted code, if any
- PersistentCompilerState -- updated PCS
-
- | HscFail PersistentCompilerState -- updated PCS
+ -- compilation failed
+ = HscFail PersistentCompilerState -- updated PCS
+ -- concluded that it wasn't necessary
+ | HscNoRecomp PersistentCompilerState -- updated PCS
+ ModDetails -- new details (HomeSymbolTable additions)
+ ModIface -- new iface (if any compilation was done)
+ -- did recompilation
+ | HscRecomp PersistentCompilerState -- updated PCS
+ ModDetails -- new details (HomeSymbolTable additions)
+ ModIface -- new iface (if any compilation was done)
+ Bool -- stub_h exists
+ Bool -- stub_c exists
+ (Maybe CompiledByteCode)
+
-- no errors or warnings; the individual passes
-- (parse/rename/typecheck) print messages themselves
hscMain
- :: DynFlags
- -> Finder
- -> ModSummary -- summary, including source filename
- -> Maybe ModIface -- old interface, if available
- -> String -- file in which to put the output (.s, .hc, .java etc.)
- -> [CoreToDo]
- -> [StgToDo]
- -> HomeSymbolTable -- for home module ModDetails
- -> HomeIfaceTable
- -> PackageIfaceTable
+ :: HscEnv
-> PersistentCompilerState -- IN: persistent compiler state
+ -> Module
+ -> ModLocation -- location info
+ -> Bool -- True <=> source unchanged
+ -> Bool -- True <=> have an object file (for msgs only)
+ -> Maybe ModIface -- old interface, if available
-> IO HscResult
-hscMain dflags finder summary maybe_old_iface output_filename
- core_cmds stg_cmds hst hit pit pcs
+hscMain hsc_env pcs mod location
+ source_unchanged have_object maybe_old_iface
= do {
- -- ????? source_unchanged :: Bool -- extracted from summary?
- let source_unchanged = trace "WARNING: source_unchanged?!" False
- ;
- (pcs_ch, check_errs, (recomp_reqd, maybe_checked_iface))
- <- checkOldIface dflags finder hit hst pcs (ms_mod summary)
- source_unchanged maybe_old_iface;
- if check_errs then
- return (HscFail pcs_ch)
- else do {
+ (pcs_ch, maybe_chk_result) <- _scc_ "checkOldIface"
+ checkOldIface hsc_env pcs mod
+ (ml_hi_file location)
+ source_unchanged maybe_old_iface;
+ case maybe_chk_result of {
+ Nothing -> return (HscFail pcs_ch) ;
+ Just (recomp_reqd, maybe_checked_iface) -> do {
let no_old_iface = not (isJust maybe_checked_iface)
what_next | recomp_reqd || no_old_iface = hscRecomp
| otherwise = hscNoRecomp
- ;
- what_next dflags finder summary maybe_checked_iface output_filename
- core_cmds stg_cmds hst hit pit pcs_ch
- }}
+
+ ; what_next hsc_env pcs_ch have_object
+ mod location maybe_checked_iface
+ }}}
-hscNoRecomp dflags finder summary maybe_checked_iface output_filename
- core_cmds stg_cmds hst hit pit pcs_ch
+-- hscNoRecomp definitely expects to have the old interface available
+hscNoRecomp hsc_env pcs_ch have_object
+ mod location (Just old_iface)
+ | hsc_mode hsc_env == OneShot
= do {
- -- we definitely expect to have the old interface available
- let old_iface = case maybe_checked_iface of
- Just old_if -> old_if
- Nothing -> panic "hscNoRecomp:old_iface"
- ;
- -- CLOSURE
- (pcs_cl, closure_errs, cl_hs_decls)
- <- closeIfaceDecls dflags finder hit hst pcs_ch old_iface ;
- if closure_errs then
- return (HscFail pcs_cl)
- else do {
-
- -- TYPECHECK
- maybe_tc_result
- <- typecheckModule dflags (ms_mod summary) pcs_cl hst hit cl_hs_decls;
- case maybe_tc_result of {
- Nothing -> return (HscFail pcs_cl);
- Just tc_result -> do {
-
- let pcs_tc = tc_pcs tc_result
- env_tc = tc_env tc_result
- binds_tc = tc_binds tc_result
- local_insts = tc_insts tc_result
- local_rules = tc_rules tc_result
- ;
- -- create a new details from the closed, typechecked, old iface
- let new_details = mkModDetailsFromIface env_tc local_insts local_rules
- ;
- return (HscOK new_details
- Nothing -- tells CM to use old iface and linkables
- Nothing Nothing -- foreign export stuff
- Nothing -- ibinds
- pcs_tc)
- }}}}
-
-
-hscRecomp dflags finder summary maybe_checked_iface output_filename
- core_cmds stg_cmds hst hit pit pcs_ch
+ when (verbosity (hsc_dflags hsc_env) > 0) $
+ hPutStrLn stderr "compilation IS NOT required";
+ let { bomb = panic "hscNoRecomp:OneShot" };
+ return (HscNoRecomp pcs_ch bomb bomb)
+ }
+ | otherwise
= do {
- -- what target are we shooting for?
- let toInterp = dopt_HscLang dflags == HscInterpreted
- this_mod = ms_mod summary
- ;
- -- PARSE
- maybe_parsed <- myParseModule dflags summary;
- case maybe_parsed of {
- Nothing -> return (HscFail pcs_ch);
- Just rdr_module -> do {
-
- -- RENAME
- show_pass dflags "Renamer";
- (pcs_rn, maybe_rn_result)
- <- renameModule dflags finder hit hst pcs_ch this_mod rdr_module;
- case maybe_rn_result of {
- Nothing -> return (HscFail pcs_rn);
- Just (new_iface, rn_hs_decls) -> do {
-
- -- TYPECHECK
- show_pass dflags "Typechecker";
- maybe_tc_result
- <- typecheckModule dflags this_mod pcs_rn hst hit rn_hs_decls;
+ when (verbosity (hsc_dflags hsc_env) >= 1) $
+ hPutStrLn stderr ("Skipping " ++
+ showModMsg have_object mod location);
+
+ -- Typecheck
+ (pcs_tc, maybe_tc_result) <- tcRnIface hsc_env pcs_ch old_iface ;
+
case maybe_tc_result of {
- Nothing -> return (HscFail pcs_rn);
- Just tc_result -> do {
-
- let pcs_tc = tc_pcs tc_result
- env_tc = tc_env tc_result
- binds_tc = tc_binds tc_result
- local_insts = tc_insts tc_result
- ;
- -- DESUGAR, SIMPLIFY, TIDY-CORE
- -- We grab the the unfoldings at this point.
- (tidy_binds, orphan_rules, foreign_stuff)
- <- dsThenSimplThenTidy dflags this_mod tc_result core_cmds
- ;
- -- CONVERT TO STG
- (stg_binds, oa_tidy_binds, cost_centre_info, top_level_ids)
- <- myCoreToStg dflags this_mod tidy_binds stg_cmds
- ;
- -- cook up a new ModDetails now we (finally) have all the bits
- let new_details = mkModDetails env_tc local_insts tidy_binds
- top_level_ids orphan_rules
- ;
- -- and possibly create a new ModIface
- let maybe_final_iface
- = completeIface maybe_checked_iface new_iface new_details
- ;
-
- -- Write the interface file
- writeIface finder maybe_final_iface
- ;
-
- -- do the rest of code generation/emission
- (maybe_ibinds, maybe_stub_h_filename, maybe_stub_c_filename)
- <- restOfCodeGeneration dflags toInterp summary
- cost_centre_info foreign_stuff tc_env stg_binds oa_tidy_binds
- ;
- -- and the answer is ...
- return (HscOK new_details maybe_final_iface
- maybe_stub_h_filename maybe_stub_c_filename
- maybe_ibinds pcs_tc)
- }}}}}}}
-
-
-myParseModule dflags summary
- = do -------------------------- Parser ----------------
- show_pass dflags "Parser"
- -- _scc_ "Parser"
+ Nothing -> return (HscFail pcs_tc);
+ Just new_details ->
- let src_filename -- name of the preprocessed source file
- = case ms_ppsource summary of
- Just (filename, fingerprint) -> filename
- Nothing -> pprPanic
- "myParseModule:summary is not of a source module"
- (ppr summary)
+ return (HscNoRecomp pcs_tc new_details old_iface)
+ }}
- buf <- hGetStringBuffer True{-expand tabs-} src_filename
+hscRecomp hsc_env pcs_ch have_object
+ mod location maybe_checked_iface
+ = do {
+ -- what target are we shooting for?
+ ; let one_shot = hsc_mode hsc_env == OneShot
+ ; let dflags = hsc_dflags hsc_env
+ ; let toInterp = dopt_HscLang dflags == HscInterpreted
+ ; let toCore = isJust (ml_hs_file location) &&
+ isExtCore_file (fromJust (ml_hs_file location))
+
+ ; when (not one_shot && verbosity dflags >= 1) $
+ hPutStrLn stderr ("Compiling " ++
+ showModMsg (not toInterp) mod location);
+
+ ; front_res <- if toCore then
+ hscCoreFrontEnd hsc_env pcs_ch location
+ else
+ hscFrontEnd hsc_env pcs_ch location
+
+ ; case front_res of
+ Left flure -> return flure;
+ Right (pcs_tc, ds_result) -> do {
+
+
+ -- OMITTED:
+ -- ; seqList imported_modules (return ())
+
+ -------------------
+ -- FLATTENING
+ -------------------
+ ; flat_result <- _scc_ "Flattening"
+ flatten hsc_env pcs_tc ds_result
+
+ ; let pcs_middle = pcs_tc
+
+{- Again, omit this because it loses the usage info
+ which is needed in mkIface. Maybe we should compute
+ usage info earlier.
+
+ ; pcs_middle
+ <- _scc_ "pcs_middle"
+ if one_shot then
+ do init_pcs <- initPersistentCompilerState
+ init_prs <- initPersistentRenamerState
+ let
+ rules = pcs_rules pcs_tc
+ orig_tc = prsOrig (pcs_PRS pcs_tc)
+ new_prs = init_prs{ prsOrig=orig_tc }
+
+ orig_tc `seq` rules `seq` new_prs `seq`
+ return init_pcs{ pcs_PRS = new_prs,
+ pcs_rules = rules }
+ else return pcs_tc
+-}
+
+-- Should we remove bits of flat_result at this point?
+-- ; flat_result <- case flat_result of
+-- ModResult { md_binds = binds } ->
+-- return ModDetails { md_binds = binds,
+-- md_rules = [],
+-- md_types = emptyTypeEnv,
+-- md_insts = [] }
+
+ -- alive at this point:
+ -- pcs_middle
+ -- flat_result
+
+ -------------------
+ -- SIMPLIFY
+ -------------------
+ ; simpl_result <- _scc_ "Core2Core"
+ core2core hsc_env pcs_middle flat_result
+
+ -------------------
+ -- TIDY
+ -------------------
+ ; cg_info_ref <- newIORef Nothing ;
+ ; let cg_info :: CgInfoEnv
+ cg_info = unsafePerformIO $ do {
+ maybe_cg_env <- readIORef cg_info_ref ;
+ case maybe_cg_env of
+ Just env -> return env
+ Nothing -> do { printError "Urk! Looked at CgInfo too early!";
+ return emptyNameEnv } }
+ -- cg_info_ref will be filled in just after restOfCodeGeneration
+ -- Meanwhile, tidyCorePgm is careful not to look at cg_info!
+
+ ; (pcs_simpl, tidy_result)
+ <- _scc_ "CoreTidy"
+ tidyCorePgm dflags pcs_middle cg_info simpl_result
+
+-- Space-saving ploy doesn't work so well now
+-- because mkIface needs the populated PIT to
+-- generate usage info. Maybe we should re-visit this.
+-- ; pcs_final <- if one_shot then initPersistentCompilerState
+-- else return pcs_simpl
+ ; let pcs_final = pcs_simpl
+
+ -- Alive at this point:
+ -- tidy_result, pcs_final
+
+ -------------------
+ -- PREPARE FOR CODE GENERATION
+ -- Do saturation and convert to A-normal form
+ ; prepd_result <- _scc_ "CorePrep"
+ corePrepPgm dflags tidy_result
+
+ -------------------
+ -- CONVERT TO STG and COMPLETE CODE GENERATION
+ ; (stub_h_exists, stub_c_exists, maybe_bcos)
+ <- hscBackEnd dflags cg_info_ref prepd_result
+
+ -------------------
+ -- BUILD THE NEW ModIface and ModDetails
+ -- and emit external core if necessary
+ -- This has to happen *after* code gen so that the back-end
+ -- info has been set. Not yet clear if it matters waiting
+ -- until after code output
+ ; final_iface <- _scc_ "MkFinalIface"
+ mkIface hsc_env location
+ maybe_checked_iface tidy_result
+ ; let final_details = ModDetails { md_types = mg_types tidy_result,
+ md_insts = mg_insts tidy_result,
+ md_rules = mg_rules tidy_result }
+ ; emitExternalCore dflags tidy_result
+
+ -- and the answer is ...
+ ; return (HscRecomp pcs_final
+ final_details
+ final_iface
+ stub_h_exists stub_c_exists
+ maybe_bcos)
+ }}
+
+hscCoreFrontEnd hsc_env pcs_ch location = do {
+ -------------------
+ -- PARSE
+ -------------------
+ ; inp <- readFile (expectJust "hscCoreFrontEnd:hspp" (ml_hspp_file location))
+ ; case parseCore inp 1 of
+ FailP s -> hPutStrLn stderr s >> return (Left (HscFail pcs_ch));
+ OkP rdr_module -> do {
+
+ -------------------
+ -- RENAME and TYPECHECK
+ -------------------
+ ; (pcs_tc, maybe_tc_result) <- _scc_ "TypeCheck"
+ tcRnExtCore hsc_env pcs_ch rdr_module
+ ; case maybe_tc_result of {
+ Nothing -> return (Left (HscFail pcs_tc));
+ Just mod_guts -> return (Right (pcs_tc, mod_guts))
+ -- No desugaring to do!
+ }}}
+
+
+hscFrontEnd hsc_env pcs_ch location = do {
+ -------------------
+ -- PARSE
+ -------------------
+ ; maybe_parsed <- myParseModule (hsc_dflags hsc_env)
+ (expectJust "hscRecomp:hspp" (ml_hspp_file location))
+
+ ; case maybe_parsed of {
+ Nothing -> return (Left (HscFail pcs_ch));
+ Just rdr_module -> do {
+
+ -------------------
+ -- RENAME and TYPECHECK
+ -------------------
+ ; (pcs_tc, maybe_tc_result) <- _scc_ "Typecheck and Rename"
+ tcRnModule hsc_env pcs_ch rdr_module
+ ; case maybe_tc_result of {
+ Nothing -> return (Left (HscFail pcs_ch));
+ Just tc_result -> do {
+
+ -------------------
+ -- DESUGAR
+ -------------------
+ ; ds_result <- _scc_ "DeSugar"
+ deSugar hsc_env pcs_tc tc_result
+ ; return (Right (pcs_tc, ds_result))
+ }}}}}
+
+
+hscBackEnd dflags cg_info_ref prepd_result
+ = case dopt_HscLang dflags of
+ HscNothing -> return (False, False, Nothing)
+
+ HscInterpreted ->
+#ifdef GHCI
+ do ----------------- Generate byte code ------------------
+ comp_bc <- byteCodeGen dflags prepd_result
+
+ -- Fill in the code-gen info
+ writeIORef cg_info_ref (Just emptyNameEnv)
+
+ ------------------ Create f-x-dynamic C-side stuff ---
+ (istub_h_exists, istub_c_exists)
+ <- outputForeignStubs dflags (mg_foreign prepd_result)
+
+ return ( istub_h_exists, istub_c_exists,
+ Just comp_bc )
+#else
+ panic "GHC not compiled with interpreter"
+#endif
+
+ other ->
+ do
+ ----------------- Convert to STG ------------------
+ (stg_binds, cost_centre_info, stg_back_end_info)
+ <- _scc_ "CoreToStg"
+ myCoreToStg dflags prepd_result
+
+ -- Fill in the code-gen info for the earlier tidyCorePgm
+ writeIORef cg_info_ref (Just stg_back_end_info)
+
+ ------------------ Code generation ------------------
+ abstractC <- _scc_ "CodeGen"
+ codeGen dflags prepd_result
+ cost_centre_info stg_binds
+
+ ------------------ Code output -----------------------
+ (stub_h_exists, stub_c_exists)
+ <- codeOutput dflags prepd_result
+ stg_binds abstractC
+
+ return (stub_h_exists, stub_c_exists, Nothing)
+
+
+myParseModule dflags src_filename
+ = do -------------------------- Parser ----------------
+ showPass dflags "Parser"
+ _scc_ "Parser" do
+ buf <- hGetStringBuffer src_filename
- let glaexts | dopt Opt_GlasgowExts dflags = 1#
- | otherwise = 0#
+ let exts = ExtFlags {glasgowExtsEF = dopt Opt_GlasgowExts dflags,
+ ffiEF = dopt Opt_FFI dflags,
+ withEF = dopt Opt_With dflags,
+ parrEF = dopt Opt_PArr dflags}
+ loc = mkSrcLoc (mkFastString src_filename) 1
- case parse buf PState{ bol = 0#, atbol = 1#,
- context = [], glasgow_exts = glaexts,
- loc = mkSrcLoc (_PK_ src_filename) 1 } of {
+ case parseModule buf (mkPState loc exts) of {
PFailed err -> do { hPutStrLn stderr (showSDoc err);
+ freeStringBuffer buf;
return Nothing };
- POk _ rdr_module@(HsModule mod_name _ _ _ _ _ _) -> do {
+
+ POk _ rdr_module -> do {
dumpIfSet_dyn dflags Opt_D_dump_parsed "Parser" (ppr rdr_module) ;
(ppSourceStats False rdr_module) ;
return (Just rdr_module)
+ -- ToDo: free the string buffer later.
}}
-restOfCodeGeneration dflags toInterp summary cost_centre_info
- foreign_stuff tc_env stg_binds oa_tidy_binds
- | toInterp
- = return (Nothing, Nothing,
- Just (stgToInterpSyn stg_binds local_tycons local_classes))
- | otherwise
- = do -------------------------- Code generation -------------------------------
- show_pass dflags "CodeGen"
- -- _scc_ "CodeGen"
- abstractC <- codeGen this_mod imported_modules
- cost_centre_info fe_binders
- local_tycons local_classes stg_binds
-
- -------------------------- Code output -------------------------------
- show_pass dflags "CodeOutput"
- -- _scc_ "CodeOutput"
- ncg_uniqs <- mkSplitUniqSupply 'n'
- (maybe_stub_h_name, maybe_stub_c_name)
- <- codeOutput this_mod local_tycons local_classes
- oa_tidy_binds stg_binds
- c_code h_code abstractC ncg_uniqs
-
- return (maybe_stub_h_name, maybe_stub_c_name, Nothing)
- where
- local_tycons = tcEnvTyCons tc_env
- local_classes = tcEnvClasses tc_env
- this_mod = ms_mod summary
- imported_modules = ms_get_imports summary
- (fe_binders,h_code,c_code) = foreign_stuff
-
-
-dsThenSimplThenTidy dflags this_mod tc_result core_cmds
--- make up ds_uniqs here
- = do -------------------------- Desugaring ----------------
- -- _scc_ "DeSugar"
- ds_uniqs <- mkSplitUniqSupply 'd'
- (desugared, rules, h_code, c_code, fe_binders)
- <- deSugar this_mod ds_uniqs tc_result
-
- -------------------------- Main Core-language transformations ----------------
- -- _scc_ "Core2Core"
- (simplified, orphan_rules) <- core2core core_cmds desugared rules
-
- -- Do the final tidy-up
- (tidy_binds, tidy_orphan_rules)
- <- tidyCorePgm this_mod simplified orphan_rules
-
- return (tidy_binds, tidy_orphan_rules, (fe_binders,h_code,c_code))
-
-
-myCoreToStg dflags this_mod tidy_binds stg_cmds
+myCoreToStg dflags (ModGuts {mg_module = this_mod, mg_binds = tidy_binds})
= do
- c2s_uniqs <- mkSplitUniqSupply 'c'
- st_uniqs <- mkSplitUniqSupply 'g'
- let occ_anal_tidy_binds = occurAnalyseBinds tidy_binds
-
- () <- coreBindsSize occ_anal_tidy_binds `seq` return ()
+ () <- coreBindsSize tidy_binds `seq` return ()
-- TEMP: the above call zaps some space usage allocated by the
-- simplifier, which for reasons I don't understand, persists
- -- thoroughout code generation
+ -- thoroughout code generation -- JRS
+ --
+ -- This is still necessary. -- SDM (10 Dec 2001)
+
+ stg_binds <- _scc_ "Core2Stg"
+ coreToStg dflags tidy_binds
+
+ (stg_binds2, cost_centre_info) <- _scc_ "Core2Stg"
+ stg2stg dflags this_mod stg_binds
+
+ let env_rhs :: CgInfoEnv
+ env_rhs = mkNameEnv [ caf_info `seq` (idName bndr, CgInfo caf_info)
+ | (bind,_) <- stg_binds2,
+ let caf_info
+ | stgBindHasCafRefs bind = MayHaveCafRefs
+ | otherwise = NoCafRefs,
+ bndr <- stgBinders bind ]
+
+ return (stg_binds2, cost_centre_info, env_rhs)
+\end{code}
+
+
+%************************************************************************
+%* *
+\subsection{Compiling a do-statement}
+%* *
+%************************************************************************
+
+When the UnlinkedBCOExpr is linked you get an HValue of type
+ IO [HValue]
+When you run it you get a list of HValues that should be
+the same length as the list of names; add them to the ClosureEnv.
+
+A naked expression returns a singleton Name [it].
+
+ What you type The IO [HValue] that hscStmt returns
+ ------------- ------------------------------------
+ let pat = expr ==> let pat = expr in return [coerce HVal x, coerce HVal y, ...]
+ bindings: [x,y,...]
+
+ pat <- expr ==> expr >>= \ pat -> return [coerce HVal x, coerce HVal y, ...]
+ bindings: [x,y,...]
- show_pass dflags "Core2Stg"
- -- _scc_ "Core2Stg"
- let stg_binds = topCoreBindsToStg c2s_uniqs occ_anal_tidy_binds
+ expr (of IO type) ==> expr >>= \ v -> return [v]
+ [NB: result not printed] bindings: [it]
+
- show_pass dflags "Stg2Stg"
- -- _scc_ "Stg2Stg"
- (stg_binds2, cost_centre_info) <- stg2stg stg_cmds this_mod st_uniqs stg_binds
- let final_ids = collectFinalStgBinders (map fst stg_binds2)
+ expr (of non-IO type,
+ result showable) ==> let v = expr in print v >> return [v]
+ bindings: [it]
- return (stg_binds2, occ_anal_tidy_binds, cost_centre_info, final_ids)
+ expr (of non-IO type,
+ result not showable) ==> error
+\begin{code}
+#ifdef GHCI
+hscStmt -- Compile a stmt all the way to an HValue, but don't run it
+ :: HscEnv
+ -> PersistentCompilerState -- IN: persistent compiler state
+ -> InteractiveContext -- Context for compiling
+ -> String -- The statement
+ -> IO ( PersistentCompilerState,
+ Maybe (InteractiveContext, [Name], HValue) )
+
+hscStmt hsc_env pcs icontext stmt
+ = do { maybe_stmt <- hscParseStmt (hsc_dflags hsc_env) stmt
+ ; case maybe_stmt of {
+ Nothing -> return (pcs, Nothing) ;
+ Just parsed_stmt -> do {
+
+ -- Rename and typecheck it
+ (pcs1, maybe_tc_result)
+ <- tcRnStmt hsc_env pcs icontext parsed_stmt
+
+ ; case maybe_tc_result of {
+ Nothing -> return (pcs1, Nothing) ;
+ Just (new_ic, bound_names, tc_expr) -> do {
+
+ -- Then desugar, code gen, and link it
+ ; hval <- compileExpr hsc_env pcs1 iNTERACTIVE
+ (icPrintUnqual new_ic) tc_expr
+
+ ; return (pcs1, Just (new_ic, bound_names, hval))
+ }}}}}
+
+hscTcExpr -- Typecheck an expression (but don't run it)
+ :: HscEnv
+ -> PersistentCompilerState -- IN: persistent compiler state
+ -> InteractiveContext -- Context for compiling
+ -> String -- The expression
+ -> IO (PersistentCompilerState, Maybe Type)
+
+hscTcExpr hsc_env pcs icontext expr
+ = do { maybe_stmt <- hscParseStmt (hsc_dflags hsc_env) expr
+ ; case maybe_stmt of {
+ Just (ExprStmt expr _ _)
+ -> tcRnExpr hsc_env pcs icontext expr ;
+ Just other -> do { hPutStrLn stderr ("not an expression: `" ++ expr ++ "'") ;
+ return (pcs, Nothing) } ;
+ Nothing -> return (pcs, Nothing) } }
+\end{code}
+
+\begin{code}
+hscParseStmt :: DynFlags -> String -> IO (Maybe RdrNameStmt)
+hscParseStmt dflags str
+ = do showPass dflags "Parser"
+ _scc_ "Parser" do
-show_pass dflags what
- = if dopt Opt_D_show_passes dflags
- then hPutStr stderr ("*** "++what++":\n")
- else return ()
+ buf <- stringToStringBuffer str
+
+ let exts = ExtFlags {glasgowExtsEF = dopt Opt_GlasgowExts dflags,
+ ffiEF = dopt Opt_FFI dflags,
+ withEF = dopt Opt_With dflags,
+ parrEF = dopt Opt_PArr dflags}
+ loc = mkSrcLoc FSLIT("<interactive>") 1
+
+ case parseStmt buf (mkPState loc exts) of {
+
+ PFailed err -> do { hPutStrLn stderr (showSDoc err);
+-- Not yet implemented in <4.11 freeStringBuffer buf;
+ return Nothing };
+
+ -- no stmt: the line consisted of just space or comments
+ POk _ Nothing -> return Nothing;
+
+ POk _ (Just rdr_stmt) -> do {
+
+ --ToDo: can't free the string buffer until we've finished this
+ -- compilation sweep and all the identifiers have gone away.
+ --freeStringBuffer buf;
+ dumpIfSet_dyn dflags Opt_D_dump_parsed "Parser" (ppr rdr_stmt);
+ return (Just rdr_stmt)
+ }}
+#endif
+\end{code}
+
+%************************************************************************
+%* *
+\subsection{Getting information about an identifer}
+%* *
+%************************************************************************
+
+\begin{code}
+#ifdef GHCI
+hscThing -- like hscStmt, but deals with a single identifier
+ :: HscEnv
+ -> PersistentCompilerState -- IN: persistent compiler state
+ -> InteractiveContext -- Context for compiling
+ -> String -- The identifier
+ -> IO ( PersistentCompilerState,
+ [TyThing] )
+
+hscThing hsc_env pcs0 ic str
+ = do let dflags = hsc_dflags hsc_env
+
+ maybe_rdr_name <- myParseIdentifier dflags str
+ case maybe_rdr_name of {
+ Nothing -> return (pcs0, []);
+ Just rdr_name -> do
+
+ (pcs1, maybe_tc_result) <-
+ tcRnThing hsc_env pcs0 ic rdr_name
+
+ case maybe_tc_result of {
+ Nothing -> return (pcs1, []) ;
+ Just things -> return (pcs1, things)
+ }}
+
+myParseIdentifier dflags str
+ = do buf <- stringToStringBuffer str
+
+ let exts = ExtFlags {glasgowExtsEF = dopt Opt_GlasgowExts dflags,
+ ffiEF = dopt Opt_FFI dflags,
+ withEF = dopt Opt_With dflags,
+ parrEF = dopt Opt_PArr dflags}
+ loc = mkSrcLoc FSLIT("<interactive>") 1
+
+ case parseIdentifier buf (mkPState loc exts) of
+
+ PFailed err -> do { hPutStrLn stderr (showSDoc err);
+ freeStringBuffer buf;
+ return Nothing }
+
+ POk _ rdr_name -> do { --should, but can't: freeStringBuffer buf;
+ return (Just rdr_name) }
+#endif
+\end{code}
+
+%************************************************************************
+%* *
+ Desugar, simplify, convert to bytecode, and link an expression
+%* *
+%************************************************************************
+
+\begin{code}
+#ifdef GHCI
+compileExpr :: HscEnv
+ -> PersistentCompilerState
+ -> Module -> PrintUnqualified
+ -> TypecheckedHsExpr
+ -> IO HValue
+
+compileExpr hsc_env pcs this_mod print_unqual tc_expr
+ = do { let dflags = hsc_dflags hsc_env
+
+ -- Desugar it
+ ; ds_expr <- deSugarExpr hsc_env pcs this_mod print_unqual tc_expr
+
+ -- Flatten it
+ ; flat_expr <- flattenExpr hsc_env pcs ds_expr
+
+ -- Simplify it
+ ; simpl_expr <- simplifyExpr dflags flat_expr
+
+ -- Tidy it (temporary, until coreSat does cloning)
+ ; tidy_expr <- tidyCoreExpr simpl_expr
+
+ -- Prepare for codegen
+ ; prepd_expr <- corePrepExpr dflags tidy_expr
+
+ -- Convert to BCOs
+ ; bcos <- coreExprToBCOs dflags prepd_expr
+
+ -- link it
+ ; hval <- linkExpr hsc_env pcs bcos
+
+ ; return hval
+ }
+#endif
\end{code}
\begin{code}
initPersistentCompilerState :: IO PersistentCompilerState
initPersistentCompilerState
- = do prs <- initPersistentRenamerState
- return (
- PCS { pcs_PST = initPackageDetails,
- pcs_insts = emptyInstEnv,
- pcs_rules = emptyRuleBase,
- pcs_PRS = prs
- }
- )
-
-initPackageDetails :: PackageSymbolTable
-initPackageDetails = extendTypeEnv emptyModuleEnv wiredInThings
-
-initPersistentRenamerState :: IO PersistentRenamerState
- = do ns <- mkSplitUniqSupply 'r'
+ = do nc <- initNameCache
return (
- PRS { prsOrig = Orig { origNames = initOrigNames,
- origIParam = emptyFM },
- prsDecls = emptyNameEnv,
- prsInsts = emptyBag,
- prsRules = emptyBag,
- prsNS = ns
- }
- )
+ PCS { pcs_EPS = initExternalPackageState,
+ pcs_nc = nc })
+
+initNameCache :: IO NameCache
+ = do us <- mkSplitUniqSupply 'r'
+ return (NameCache { nsUniqs = us,
+ nsNames = initOrigNames,
+ nsIPs = emptyFM })
+
+initExternalPackageState :: ExternalPackageState
+initExternalPackageState
+ = EPS {
+ eps_decls = (emptyNameEnv, 0),
+ eps_insts = (emptyBag, 0),
+ eps_inst_gates = emptyNameSet,
+ eps_rules = foldr add_rule (emptyBag, 0) builtinRules,
+ eps_imp_mods = emptyFM,
+
+ eps_PIT = emptyPackageIfaceTable,
+ eps_PTE = wiredInThingEnv,
+ eps_inst_env = emptyInstEnv,
+ eps_rule_base = emptyRuleBase }
+
+ where
+ add_rule (name,rule) (rules, n_slurped)
+ = (gated_decl `consBag` rules, n_slurped)
+ where
+ gated_decl = (gate_fn, (mod, IfaceRuleOut rdr_name rule))
+ mod = nameModule name
+ rdr_name = nameRdrName name
+ gate_fn vis_fn = vis_fn name -- Load the rule whenever name is visible
initOrigNames :: FiniteMap (ModuleName,OccName) Name
-initOrigNames = grab knownKeyNames `plusFM` grab (map getName wiredInThings)
- where
- grab names = foldl add emptyFM names
- add env name = addToFM env (moduleName (nameModule name), nameOccName name) name
-
-
-initRules :: PackageRuleBase
-initRules = foldl add emptyVarEnv builtinRules
- where
- add env (name,rule)
- = extendNameEnv_C (\rules _ -> rule:rules)
- env name [rule]
+initOrigNames
+ = grab knownKeyNames `plusFM` grab (map getName wiredInThings)
+ where
+ grab names = foldl add emptyFM names
+ add env name
+ = addToFM env (moduleName (nameModule name), nameOccName name) name
\end{code}