| Safe Haskell | None |
|---|---|
| Language | Haskell98 |
Development.Shake.Language.C
Description
- data OS
- data Platform = Platform {}
- data ArmVersion
- data X86Version
- data Arch
- data Target = Target {
- targetOS :: OS
- targetPlatform :: Platform
- targetArch :: Arch
- class ToBuildPrefix a where
- data Linkage
- module Development.Shake.Language.C.BuildFlags
- executable :: Action ToolChain -> FilePath -> Action (BuildFlags -> BuildFlags) -> Action [FilePath] -> Rules FilePath
- staticLibrary :: Action ToolChain -> FilePath -> Action (BuildFlags -> BuildFlags) -> Action [FilePath] -> Rules FilePath
- sharedLibrary :: Action ToolChain -> FilePath -> Action (BuildFlags -> BuildFlags) -> Action [FilePath] -> Rules FilePath
- loadableLibrary :: Action ToolChain -> FilePath -> Action (BuildFlags -> BuildFlags) -> Action [FilePath] -> Rules FilePath
- data ToolChain
- data ToolChainVariant
- applyEnv :: ToolChain -> Action ToolChain
- toEnv :: ToolChain -> Action [(String, String)]
Build targets
This library's focus is on cross compilation. Here's a list of modules that provide support for targeting specific platforms:
Target operating system.
Target platform.
Basically just a platform identifier string. Use toBuildPrefix to convert a platform to a file path prefix that can be used in Shake rules.
Constructors
| Platform | |
Fields | |
data X86Version Source #
X86 architecture version.
Constructors
| I386 |
|
| I686 |
|
| X86_64 |
|
Instances
Target architecture.
Use toBuildPrefix to convert an architecture to a short, more or less canonical file path prefix that can be used in Shake rules.
Constructors
| X86 X86Version | Intel |
| Arm ArmVersion | Arm architecture |
| LLVM_IR | LLVM intermediate representation, used by |
Compilation target triple consisting of operating system, platform and architecture.
Use toBuildPrefix to convert a target to a file path prefix that can be used in Shake rules. The prefix is of the form
<platform>/<architecture>
For example:
>>>import qualified Development.Shake.Language.C.Target.OSX as OSX>>>toBuildPrefix $ OSX.target OSX.iPhoneOS (Arm Armv7)"iphoneos/armv7"
Constructors
| Target | |
Fields
| |
class ToBuildPrefix a where Source #
Convert a value to a build directory prefix.
The idea is that several such values can be combined to form more complex build directory hierarchies. This can be important for disambiguating build product paths in Shake rules.
Minimal complete definition
Instances
High-level build rules
Linkage type, static or shared.
Arguments
| :: Action ToolChain | Action returning a target |
| -> FilePath | Output file |
| -> Action (BuildFlags -> BuildFlags) | Action returning a |
| -> Action [FilePath] | Action returning a list of input source files |
| -> Rules FilePath | Rule returning the output file path |
Shake rule for building an executable.
Arguments
| :: Action ToolChain | Action returning a target |
| -> FilePath | Output file |
| -> Action (BuildFlags -> BuildFlags) | Action returning a |
| -> Action [FilePath] | Action returning a list of input source files |
| -> Rules FilePath | Rule returning the output file path |
Shake rule for building a static library.
Arguments
| :: Action ToolChain | Action returning a target |
| -> FilePath | Output file |
| -> Action (BuildFlags -> BuildFlags) | Action returning a |
| -> Action [FilePath] | Action returning a list of input source files |
| -> Rules FilePath | Rule returning the output file path |
Shake rule for building a shared (dynamically linked) library.
Arguments
| :: Action ToolChain | Action returning a target |
| -> FilePath | Output file |
| -> Action (BuildFlags -> BuildFlags) | Action returning a |
| -> Action [FilePath] | Action returning a list of input source files |
| -> Rules FilePath | Rule returning the output file path |
Shake rule for building a dynamically loadable library.
Toolchain types and utilities
data ToolChainVariant Source #
Toolchain variant.
Constructors
| Generic | Unspecified toolchain |
| GCC | GNU Compiler Collection (gcc) toolchain |
| LLVM | Low-Level Virtual Machine (LLVM) toolchain |
Instances
applyEnv :: ToolChain -> Action ToolChain Source #
Apply the current environment and return a modified toolchain.
This function is experimental and subject to change!
Currently recognised environment variables are
CC- Path to
Ccompiler. LD- Path to linker.
SHAKE_TOOLCHAIN_VARIANT- One of the values of
ToolChainVariant(case insensitive). If this variable is not present, an attempt is made to determine the toolchain variant from theCcompiler command.