Cabal- A framework for packaging Haskell software

Safe HaskellNone




data GhcOptions

A structured set of GHC options/flags




ghcOptMode :: Flag GhcMode

The major mode for the ghc invocation.

ghcOptExtra :: [String]

Any extra options to pass directly to ghc. These go at the end and hence override other stuff.

ghcOptExtraDefault :: [String]

Extra default flags to pass directly to ghc. These go at the beginning and so can be overridden by other stuff.

ghcOptInputFiles :: [FilePath]

The main input files; could be .hs, .hi, .c, .o, depending on mode.

ghcOptInputModules :: [ModuleName]

The names of input Haskell modules, mainly for --make mode.

ghcOptOutputFile :: Flag FilePath

Location for output file; the ghc -o flag.

ghcOptOutputDynFile :: Flag FilePath

Location for dynamic output file in GhcStaticAndDynamic mode; the ghc -dyno flag.

ghcOptSourcePathClear :: Flag Bool

Start with an empty search path for Haskell source files; the ghc -i flag (-i on it's own with no path argument).

ghcOptSourcePath :: [FilePath]

Search path for Haskell source files; the ghc -i flag.

ghcOptPackageName :: Flag PackageId

The package name the modules will belong to; the ghc -package-name flag

ghcOptPackageDBs :: PackageDBStack

GHC package databases to use, the ghc -package-conf flag

ghcOptPackages :: [(InstalledPackageId, PackageId)]

The GHC packages to use. For compatability with old and new ghc, this requires both the short and long form of the package id; the ghc -package or ghc -package-id flags.

ghcOptHideAllPackages :: Flag Bool

Start with a clean package set; the ghc -hide-all-packages flag

ghcOptNoAutoLinkPackages :: Flag Bool

Don't automatically link in Haskell98 etc; the ghc -no-auto-link-packages flag.

ghcOptLinkLibs :: [FilePath]

Names of libraries to link in; the ghc -l flag.

ghcOptLinkLibPath :: [FilePath]

Search path for libraries to link in; the ghc -L flag.

ghcOptLinkOptions :: [String]

Options to pass through to the linker; the ghc -optl flag.

ghcOptLinkFrameworks :: [String]

OSX only: frameworks to link in; the ghc -framework flag.

ghcOptNoLink :: Flag Bool

Don't do the link step, useful in make mode; the ghc -no-link flag.

ghcOptLinkNoHsMain :: Flag Bool

Don't link in the normal RTS main entry point; the ghc -no-hs-main flag.

ghcOptCcOptions :: [String]

Options to pass through to the C compiler; the ghc -optc flag.

ghcOptCppOptions :: [String]

Options to pass through to CPP; the ghc -optP flag.

ghcOptCppIncludePath :: [FilePath]

Search path for CPP includes like header files; the ghc -I flag.

ghcOptCppIncludes :: [FilePath]

Extra header files to include at CPP stage; the ghc -optP-include flag.

ghcOptFfiIncludes :: [FilePath]

Extra header files to include for old-style FFI; the ghc -#include flag.

ghcOptLanguage :: Flag Language

The base language; the ghc -XHaskell98 or -XHaskell2010 flag.

ghcOptExtensions :: [Extension]

The language extensions; the ghc -X flag.

ghcOptExtensionMap :: [(Extension, String)]

A GHC version-dependent mapping of extensions to flags. This must be set to be able to make use of the ghcOptExtensions.

ghcOptOptimisation :: Flag GhcOptimisation

What optimisation level to use; the ghc -O flag.

ghcOptProfilingMode :: Flag Bool

Compile in profiling mode; the ghc -prof flag.

ghcOptSplitObjs :: Flag Bool

Use the "split object files" feature; the ghc -split-objs flag.

ghcOptGHCiScripts :: [FilePath]

Extra GHCi startup scripts; the -ghci-script flag

ghcOptHiSuffix :: Flag String
ghcOptObjSuffix :: Flag String
ghcOptDynHiSuffix :: Flag String

only in GhcStaticAndDynamic mode

ghcOptDynObjSuffix :: Flag String

only in GhcStaticAndDynamic mode

ghcOptHiDir :: Flag FilePath
ghcOptObjDir :: Flag FilePath
ghcOptOutputDir :: Flag FilePath
ghcOptStubDir :: Flag FilePath
ghcOptDynLinkMode :: Flag GhcDynLinkMode
ghcOptShared :: Flag Bool
ghcOptFPic :: Flag Bool
ghcOptDylibName :: Flag String
ghcOptVerbosity :: Flag Verbosity

Get GHC to be quiet or verbose with what it's doing; the ghc -v flag.

ghcOptCabal :: Flag Bool

Let GHC know that it is Cabal that's calling it. Modifies some of the GHC error messages.

data GhcMode


ghc -c
ghc --make

ghci / ghc --interactive


ghc --abi-hash | GhcModeDepAnalysis -- ^ ghc -M | GhcModeEvaluate -- ^ ghc -e


data GhcDynLinkMode


-static -dynamic-too