GHC.Cmm

ghc-9.2.0.20210331: The GHC API

Safe Haskell | Safe-Inferred
Language | Haskell2010

GHC.Cmm

Contents

- Cmm top-level datatypes
  - Blocks containing lists
- Info Tables
- Statements, expressions and types

Synopsis

- type CmmProgram = [CmmGroup]
- type CmmGroup = GenCmmGroup CmmStatics CmmTopInfo CmmGraph
- type CmmGroupSRTs = GenCmmGroup RawCmmStatics CmmTopInfo CmmGraph
- type RawCmmGroup = GenCmmGroup RawCmmStatics (LabelMap RawCmmStatics) CmmGraph
- type GenCmmGroup d h g = [GenCmmDecl d h g]
- type CmmDecl = GenCmmDecl CmmStatics CmmTopInfo CmmGraph
- type CmmDeclSRTs = GenCmmDecl RawCmmStatics CmmTopInfo CmmGraph
- data GenCmmDecl d h g
  - = CmmProc h CLabel [GlobalReg] g
  - | CmmData Section d
- type CmmGraph = GenCmmGraph CmmNode
- data GenCmmGraph n = CmmGraph {
  - g_entry :: BlockId
  - g_graph :: Graph n C C
  }
- type CmmBlock = Block CmmNode C C
- type RawCmmDecl = GenCmmDecl RawCmmStatics (LabelMap RawCmmStatics) CmmGraph
- data Section = Section SectionType CLabel
- data SectionType
  - = Text
  - | Data
  - | ReadOnlyData
  - | RelocatableReadOnlyData
  - | UninitialisedData
  - | ReadOnlyData16
  - | CString
  - | OtherSection String
- data GenCmmStatics (rawOnly :: Bool) where
  - CmmStatics :: CLabel -> CmmInfoTable -> CostCentreStack -> [CmmLit] -> GenCmmStatics 'False
  - CmmStaticsRaw :: CLabel -> [CmmStatic] -> GenCmmStatics a
- type CmmStatics = GenCmmStatics 'False
- type RawCmmStatics = GenCmmStatics 'True
- data CmmStatic
  - = CmmStaticLit CmmLit
  - | CmmUninitialised Int
  - | CmmString ByteString
  - | CmmFileEmbed FilePath
- data SectionProtection
  - = ReadWriteSection
  - | ReadOnlySection
  - | WriteProtectedSection
- sectionProtection :: Section -> SectionProtection
- data GenBasicBlock i = BasicBlock BlockId [i]
- blockId :: GenBasicBlock i -> BlockId
- newtype ListGraph i = ListGraph [GenBasicBlock i]
- pprBBlock :: Outputable stmt => GenBasicBlock stmt -> SDoc
- data CmmTopInfo = TopInfo {
  - info_tbls :: LabelMap CmmInfoTable
  - stack_info :: CmmStackInfo
  }
- data CmmStackInfo = StackInfo {
  - arg_space :: ByteOff
  - do_layout :: Bool
  }
- data CmmInfoTable = CmmInfoTable {
  - cit_lbl :: CLabel
  - cit_rep :: SMRep
  - cit_prof :: ProfilingInfo
  - cit_srt :: Maybe CLabel
  - cit_clo :: Maybe (Id, CostCentreStack)
  }
- topInfoTable :: GenCmmDecl a CmmTopInfo (GenCmmGraph n) -> Maybe CmmInfoTable
- data ClosureTypeInfo
  - = Constr ConTagZ ConstrDescription
  - | Fun FunArity ArgDescr
  - | Thunk
  - | ThunkSelector SelectorOffset
  - | BlackHole
  - | IndStatic
- data ProfilingInfo
  - = NoProfilingInfo
  - | ProfilingInfo ByteString ByteString
- type ConstrDescription = ByteString
- module GHC.Cmm.Node
- module GHC.Cmm.Expr

# Cmm top-level datatypes

type CmmProgram = [CmmGroup] Source #

type CmmGroup = GenCmmGroup CmmStatics CmmTopInfo CmmGraph Source #

Cmm group before SRT generation

type CmmGroupSRTs = GenCmmGroup RawCmmStatics CmmTopInfo CmmGraph Source #

Cmm group with SRTs

type RawCmmGroup = GenCmmGroup RawCmmStatics (LabelMap RawCmmStatics) CmmGraph Source #

Raw cmm group (TODO (osa): not sure what that means)

type GenCmmGroup d h g = [GenCmmDecl d h g] Source #

type CmmDecl = GenCmmDecl CmmStatics CmmTopInfo CmmGraph Source #

type CmmDeclSRTs = GenCmmDecl RawCmmStatics CmmTopInfo CmmGraph Source #

data GenCmmDecl d h g Source #

A top-level chunk, abstracted over the type of the contents of the basic blocks (Cmm or instructions are the likely instantiations).

Constructors

CmmProc h CLabel [GlobalReg] g |
CmmData Section d |

#### Instances

Instances details

(OutputableP Platform d, OutputableP Platform info, OutputableP Platform i) => OutputableP Platform (GenCmmDecl d info i) # |
Instance details Defined in GHC.Cmm.Ppr.Decl Methods pdoc :: Platform -> GenCmmDecl d info i -> SDoc Source #
Functor (GenCmmDecl d h) # |
Instance details Defined in GHC.Cmm Methods fmap :: (a -> b) -> GenCmmDecl d h a -> GenCmmDecl d h b Source # (<$) :: a -> GenCmmDecl d h b -> GenCmmDecl d h a Source #

type CmmGraph = GenCmmGraph CmmNode Source #

data GenCmmGraph n Source #

Constructors

CmmGraph |
Fields g_entry :: BlockId g_graph :: Graph n C C

#### Instances

Instances details

OutputableP Platform CmmGraph # |
Instance details Defined in GHC.Cmm.Ppr Methods pdoc :: Platform -> CmmGraph -> SDoc Source #

type CmmBlock = Block CmmNode C C Source #

type RawCmmDecl = GenCmmDecl RawCmmStatics (LabelMap RawCmmStatics) CmmGraph Source #

data Section Source #

Constructors

Section SectionType CLabel |

data SectionType Source #

Constructors

Text |
Data |
ReadOnlyData |
RelocatableReadOnlyData |
UninitialisedData |
ReadOnlyData16 |
CString |
OtherSection String |

#### Instances

Instances details

Show SectionType # |
Instance details Defined in GHC.Cmm Methods showsPrec :: Int -> SectionType -> ShowS Source # show :: SectionType -> String Source # showList :: [SectionType] -> ShowS Source #

data GenCmmStatics (rawOnly :: Bool) where Source #

Constructors

CmmStatics :: CLabel -> CmmInfoTable -> CostCentreStack -> [CmmLit] -> GenCmmStatics 'False |
CmmStaticsRaw :: CLabel -> [CmmStatic] -> GenCmmStatics a | Static data, after SRTs are generated

#### Instances

Instances details

OutputableP Platform (GenCmmStatics a) # |
Instance details Defined in GHC.Cmm.Ppr.Decl Methods pdoc :: Platform -> GenCmmStatics a -> SDoc Source #

type CmmStatics = GenCmmStatics 'False Source #

type RawCmmStatics = GenCmmStatics 'True Source #

data CmmStatic Source #

Constructors

CmmStaticLit CmmLit | a literal value, size given by cmmLitRep of the literal.
CmmUninitialised Int | uninitialised data, N bytes long
CmmString ByteString | string of 8-bit values only, not zero terminated.
CmmFileEmbed FilePath | an embedded binary file

#### Instances

Instances details

Outputable CmmStatic # |
Instance details Defined in GHC.Cmm Methods ppr :: CmmStatic -> SDoc Source #
OutputableP Platform CmmStatic # |
Instance details Defined in GHC.Cmm.Ppr.Decl Methods pdoc :: Platform -> CmmStatic -> SDoc Source #

data SectionProtection Source #

Constructors

ReadWriteSection |
ReadOnlySection |
WriteProtectedSection |

#### Instances

Instances details

Eq SectionProtection # |
Instance details Defined in GHC.Cmm Methods (==) :: SectionProtection -> SectionProtection -> Bool # (/=) :: SectionProtection -> SectionProtection -> Bool #

sectionProtection :: Section -> SectionProtection Source #

Should a data in this section be considered constant at runtime

## Blocks containing lists

data GenBasicBlock i Source #

Constructors

BasicBlock BlockId [i] |

#### Instances

Instances details

Functor GenBasicBlock # |
Instance details Defined in GHC.Cmm Methods fmap :: (a -> b) -> GenBasicBlock a -> GenBasicBlock b Source # (<$) :: a -> GenBasicBlock b -> GenBasicBlock a Source #
OutputableP env instr => OutputableP env (GenBasicBlock instr) # |
Instance details Defined in GHC.Cmm Methods pdoc :: env -> GenBasicBlock instr -> SDoc Source #
Outputable instr => Outputable (GenBasicBlock instr) # |
Instance details Defined in GHC.Cmm Methods ppr :: GenBasicBlock instr -> SDoc Source #

blockId :: GenBasicBlock i -> BlockId Source #

The branch block id is that of the first block in the branch, which is that branch's entry point

newtype ListGraph i Source #

Constructors

ListGraph [GenBasicBlock i] |

#### Instances

Instances details

Functor ListGraph # |
Instance details Defined in GHC.Cmm Methods fmap :: (a -> b) -> ListGraph a -> ListGraph b Source # (<$) :: a -> ListGraph b -> ListGraph a Source #
OutputableP env instr => OutputableP env (ListGraph instr) # |
Instance details Defined in GHC.Cmm Methods pdoc :: env -> ListGraph instr -> SDoc Source #
Outputable instr => Outputable (ListGraph instr) # |
Instance details Defined in GHC.Cmm Methods ppr :: ListGraph instr -> SDoc Source #

pprBBlock :: Outputable stmt => GenBasicBlock stmt -> SDoc Source #

# Info Tables

data CmmTopInfo Source #

CmmTopInfo is attached to each CmmDecl (see defn of CmmGroup), and contains the extra info (beyond the executable code) that belongs to that CmmDecl.

Constructors

TopInfo |
Fields info_tbls :: LabelMap CmmInfoTable stack_info :: CmmStackInfo

#### Instances

Instances details

OutputableP Platform CmmTopInfo # |
Instance details Defined in GHC.Cmm.Ppr Methods pdoc :: Platform -> CmmTopInfo -> SDoc Source #

data CmmStackInfo Source #

Constructors

StackInfo |
Fields arg_space :: ByteOff do_layout :: Bool

#### Instances

Instances details

Outputable CmmStackInfo # |
Instance details Defined in GHC.Cmm.Ppr Methods ppr :: CmmStackInfo -> SDoc Source #

data CmmInfoTable Source #

Info table as a haskell data type

Constructors

CmmInfoTable |
Fields cit_lbl :: CLabel cit_rep :: SMRep cit_prof :: ProfilingInfo cit_srt :: Maybe CLabel cit_clo :: Maybe (Id, CostCentreStack)

#### Instances

Instances details

OutputableP Platform CmmInfoTable # |
Instance details Defined in GHC.Cmm.Ppr.Decl Methods pdoc :: Platform -> CmmInfoTable -> SDoc Source #

topInfoTable :: GenCmmDecl a CmmTopInfo (GenCmmGraph n) -> Maybe CmmInfoTable Source #

data ClosureTypeInfo Source #

Constructors

Constr ConTagZ ConstrDescription |
Fun FunArity ArgDescr |
Thunk |
ThunkSelector SelectorOffset |
BlackHole |
IndStatic |

#### Instances

Instances details

Outputable ClosureTypeInfo # |
Instance details Defined in GHC.Runtime.Heap.Layout Methods ppr :: ClosureTypeInfo -> SDoc Source #

data ProfilingInfo Source #

Constructors

NoProfilingInfo |
ProfilingInfo ByteString ByteString |

type ConstrDescription = ByteString Source #

# Statements, expressions and types

module GHC.Cmm.Node

module GHC.Cmm.Expr