ghc-9.4.7: The GHC API

Safe Haskell	Safe-Inferred
Language	Haskell2010

GHC.SysTools.Tasks

Contents

Tracing utility

Synopsis

runUnlit :: Logger -> DynFlags -> [Option] -> IO ()
augmentImports :: DynFlags -> [FilePath] -> [FilePath]
runCpp :: Logger -> DynFlags -> [Option] -> IO ()
runPp :: Logger -> DynFlags -> [Option] -> IO ()
runCc :: Maybe ForeignSrcLang -> Logger -> TmpFs -> DynFlags -> [Option] -> IO ()
isContainedIn :: String -> String -> Bool
askLd :: Logger -> DynFlags -> [Option] -> IO String
runAs :: Logger -> DynFlags -> [Option] -> IO ()
runLlvmOpt :: Logger -> DynFlags -> [Option] -> IO ()
runLlvmLlc :: Logger -> DynFlags -> [Option] -> IO ()
runClang :: Logger -> DynFlags -> [Option] -> IO ()
figureLlvmVersion :: Logger -> DynFlags -> IO (Maybe LlvmVersion)
runLink :: Logger -> TmpFs -> DynFlags -> [Option] -> IO ()
runMergeObjects :: Logger -> TmpFs -> DynFlags -> [Option] -> IO ()
runLibtool :: Logger -> DynFlags -> [Option] -> IO ()
runAr :: Logger -> DynFlags -> Maybe FilePath -> [Option] -> IO ()
askOtool :: Logger -> DynFlags -> Maybe FilePath -> [Option] -> IO String
runInstallNameTool :: Logger -> DynFlags -> [Option] -> IO ()
runRanlib :: Logger -> DynFlags -> [Option] -> IO ()
runWindres :: Logger -> DynFlags -> [Option] -> IO ()
touch :: Logger -> DynFlags -> String -> String -> IO ()
traceToolCommand :: Logger -> String -> IO a -> IO a

Documentation

runUnlit :: Logger -> DynFlags -> [Option] -> IO () Source #

augmentImports :: DynFlags -> [FilePath] -> [FilePath] Source #

Prepend the working directory to the search path. Note [Filepaths and Multiple Home Units]

runCpp :: Logger -> DynFlags -> [Option] -> IO () Source #

runPp :: Logger -> DynFlags -> [Option] -> IO () Source #

runCc :: Maybe ForeignSrcLang -> Logger -> TmpFs -> DynFlags -> [Option] -> IO () Source #

Run compiler of C-like languages and raw objects (such as gcc or clang).

isContainedIn :: String -> String -> Bool Source #

askLd :: Logger -> DynFlags -> [Option] -> IO String Source #

Run the linker with some arguments and return the output

runAs :: Logger -> DynFlags -> [Option] -> IO () Source #

runLlvmOpt :: Logger -> DynFlags -> [Option] -> IO () Source #

Run the LLVM Optimiser

runLlvmLlc :: Logger -> DynFlags -> [Option] -> IO () Source #

Run the LLVM Compiler

runClang :: Logger -> DynFlags -> [Option] -> IO () Source #

Run the clang compiler (used as an assembler for the LLVM backend on OS X as LLVM doesn't support the OS X system assembler)

figureLlvmVersion :: Logger -> DynFlags -> IO (Maybe LlvmVersion) Source #

Figure out which version of LLVM we are running this session

runLink :: Logger -> TmpFs -> DynFlags -> [Option] -> IO () Source #

runMergeObjects :: Logger -> TmpFs -> DynFlags -> [Option] -> IO () Source #

runLibtool :: Logger -> DynFlags -> [Option] -> IO () Source #

runAr :: Logger -> DynFlags -> Maybe FilePath -> [Option] -> IO () Source #

askOtool :: Logger -> DynFlags -> Maybe FilePath -> [Option] -> IO String Source #

runInstallNameTool :: Logger -> DynFlags -> [Option] -> IO () Source #

runRanlib :: Logger -> DynFlags -> [Option] -> IO () Source #

runWindres :: Logger -> DynFlags -> [Option] -> IO () Source #

touch :: Logger -> DynFlags -> String -> String -> IO () Source #

Tracing utility

traceToolCommand :: Logger -> String -> IO a -> IO a Source #

Record in the eventlog when the given tool command starts and finishes, prepending the given String with "systool:", to easily be able to collect and process all the systool events.

For those events to show up in the eventlog, you need to run GHC with -v2 or -ddump-timings.