GHC.StgToCmm.Closure

ghc-8.10.4: The GHC API

Safe Haskell | None
Language | Haskell2010

GHC.StgToCmm.Closure

Contents

- LambdaFormInfo
- Used by other modules
- ClosureInfo
  - Inspection
  - Labels
  - Predicates
- InfoTables

Synopsis

- type DynTag = Int
- tagForCon :: DynFlags -> DataCon -> DynTag
- isSmallFamily :: DynFlags -> Int -> Bool
- idPrimRep :: Id -> PrimRep
- isVoidRep :: PrimRep -> Bool
- isGcPtrRep :: PrimRep -> Bool
- addIdReps :: [NonVoid Id] -> [NonVoid (PrimRep, Id)]
- addArgReps :: [NonVoid StgArg] -> [NonVoid (PrimRep, StgArg)]
- argPrimRep :: StgArg -> PrimRep
- newtype NonVoid a = NonVoid a
- fromNonVoid :: NonVoid a -> a
- nonVoidIds :: [Id] -> [NonVoid Id]
- nonVoidStgArgs :: [StgArg] -> [NonVoid StgArg]
- assertNonVoidIds :: [Id] -> [NonVoid Id]
- assertNonVoidStgArgs :: [StgArg] -> [NonVoid StgArg]
- data LambdaFormInfo
- data StandardFormInfo
- mkLFThunk :: Type -> TopLevelFlag -> [Id] -> UpdateFlag -> LambdaFormInfo
- mkLFReEntrant :: TopLevelFlag -> [Id] -> [Id] -> ArgDescr -> LambdaFormInfo
- mkConLFInfo :: DataCon -> LambdaFormInfo
- mkSelectorLFInfo :: Id -> Int -> Bool -> LambdaFormInfo
- mkApLFInfo :: Id -> UpdateFlag -> Arity -> LambdaFormInfo
- mkLFImported :: Id -> LambdaFormInfo
- mkLFArgument :: Id -> LambdaFormInfo
- mkLFLetNoEscape :: LambdaFormInfo
- mkLFStringLit :: LambdaFormInfo
- lfDynTag :: DynFlags -> LambdaFormInfo -> DynTag
- isLFThunk :: LambdaFormInfo -> Bool
- isLFReEntrant :: LambdaFormInfo -> Bool
- lfUpdatable :: LambdaFormInfo -> Bool
- data CgLoc
  - = CmmLoc CmmExpr
  - | LneLoc BlockId [LocalReg]
- type SelfLoopInfo = (Id, BlockId, [LocalReg])
- data CallMethod
  - = EnterIt
  - | JumpToIt BlockId [LocalReg]
  - | ReturnIt
  - | SlowCall
  - | DirectEntry CLabel RepArity
- nodeMustPointToIt :: DynFlags -> LambdaFormInfo -> Bool
- isKnownFun :: LambdaFormInfo -> Bool
- funTag :: DynFlags -> ClosureInfo -> DynTag
- tagForArity :: DynFlags -> RepArity -> DynTag
- getCallMethod :: DynFlags -> Name -> Id -> LambdaFormInfo -> RepArity -> RepArity -> CgLoc -> Maybe SelfLoopInfo -> CallMethod
- data ClosureInfo
- mkClosureInfo :: DynFlags -> Bool -> Id -> LambdaFormInfo -> Int -> Int -> String -> ClosureInfo
- mkCmmInfo :: ClosureInfo -> Id -> CostCentreStack -> CmmInfoTable
- closureLFInfo :: ClosureInfo -> LambdaFormInfo
- closureName :: ClosureInfo -> Name
- closureInfoLabel :: ClosureInfo -> CLabel
- staticClosureLabel :: ClosureInfo -> CLabel
- closureSlowEntryLabel :: ClosureInfo -> CLabel
- closureLocalEntryLabel :: DynFlags -> ClosureInfo -> CLabel
- closureUpdReqd :: ClosureInfo -> Bool
- closureSingleEntry :: ClosureInfo -> Bool
- closureReEntrant :: ClosureInfo -> Bool
- closureFunInfo :: ClosureInfo -> Maybe (RepArity, ArgDescr)
- isToplevClosure :: ClosureInfo -> Bool
- blackHoleOnEntry :: ClosureInfo -> Bool
- isStaticClosure :: ClosureInfo -> Bool
- mkDataConInfoTable :: DynFlags -> DataCon -> Bool -> Int -> Int -> CmmInfoTable
- cafBlackHoleInfoTable :: CmmInfoTable
- indStaticInfoTable :: CmmInfoTable
- staticClosureNeedsLink :: Bool -> CmmInfoTable -> Bool

# Documentation

type DynTag = Int Source #

tagForCon :: DynFlags -> DataCon -> DynTag Source #

isSmallFamily :: DynFlags -> Int -> Bool Source #

idPrimRep :: Id -> PrimRep Source #

Assumes that there is precisely one `PrimRep` of the type. This assumption holds after unarise. See Note [Post-unarisation invariants]

isVoidRep :: PrimRep -> Bool Source #

isGcPtrRep :: PrimRep -> Bool Source #

addIdReps :: [NonVoid Id] -> [NonVoid (PrimRep, Id)] Source #

Assumes that Ids have one PrimRep, which holds after unarisation. See Note [Post-unarisation invariants]

addArgReps :: [NonVoid StgArg] -> [NonVoid (PrimRep, StgArg)] Source #

Assumes that arguments have one PrimRep, which holds after unarisation. See Note [Post-unarisation invariants]

argPrimRep :: StgArg -> PrimRep Source #

Assumes that the argument has one PrimRep, which holds after unarisation. See Note [Post-unarisation invariants]

newtype NonVoid a Source #

Constructors

NonVoid a |

#### Instances

Instances details

Eq a => Eq (NonVoid a) # |
Instance details Defined in GHC.StgToCmm.Closure Methods (==) :: NonVoid a -> NonVoid a -> Bool # (/=) :: NonVoid a -> NonVoid a -> Bool #
Show a => Show (NonVoid a) # |
Instance details Defined in GHC.StgToCmm.Closure Methods showsPrec :: Int -> NonVoid a -> ShowS Source # show :: NonVoid a -> String Source # showList :: [NonVoid a] -> ShowS Source #
Outputable a => Outputable (NonVoid a) # |
Instance details Defined in GHC.StgToCmm.Closure Methods ppr :: NonVoid a -> SDoc Source # pprPrec :: Rational -> NonVoid a -> SDoc Source #

fromNonVoid :: NonVoid a -> a Source #

nonVoidIds :: [Id] -> [NonVoid Id] Source #

nonVoidStgArgs :: [StgArg] -> [NonVoid StgArg] Source #

assertNonVoidIds :: [Id] -> [NonVoid Id] Source #

Used in places where some invariant ensures that all these Ids are non-void; e.g. constructor field binders in case expressions. See Note [Post-unarisation invariants] in UnariseStg.

assertNonVoidStgArgs :: [StgArg] -> [NonVoid StgArg] Source #

Used in places where some invariant ensures that all these arguments are non-void; e.g. constructor arguments. See Note [Post-unarisation invariants] in UnariseStg.

# LambdaFormInfo

data LambdaFormInfo Source #

data StandardFormInfo Source #

mkLFThunk :: Type -> TopLevelFlag -> [Id] -> UpdateFlag -> LambdaFormInfo Source #

mkLFReEntrant :: TopLevelFlag -> [Id] -> [Id] -> ArgDescr -> LambdaFormInfo Source #

mkConLFInfo :: DataCon -> LambdaFormInfo Source #

mkSelectorLFInfo :: Id -> Int -> Bool -> LambdaFormInfo Source #

mkApLFInfo :: Id -> UpdateFlag -> Arity -> LambdaFormInfo Source #

mkLFImported :: Id -> LambdaFormInfo Source #

mkLFArgument :: Id -> LambdaFormInfo Source #

mkLFLetNoEscape :: LambdaFormInfo Source #

mkLFStringLit :: LambdaFormInfo Source #

lfDynTag :: DynFlags -> LambdaFormInfo -> DynTag Source #

isLFThunk :: LambdaFormInfo -> Bool Source #

isLFReEntrant :: LambdaFormInfo -> Bool Source #

lfUpdatable :: LambdaFormInfo -> Bool Source #

# Used by other modules

data CgLoc Source #

Constructors

CmmLoc CmmExpr |
LneLoc BlockId [LocalReg] |

#### Instances

Instances details

Outputable CgLoc # |
Instance details Defined in GHC.StgToCmm.Closure Methods ppr :: CgLoc -> SDoc Source # pprPrec :: Rational -> CgLoc -> SDoc Source #

type SelfLoopInfo = (Id, BlockId, [LocalReg]) Source #

data CallMethod Source #

Constructors

EnterIt |
JumpToIt BlockId [LocalReg] |
ReturnIt |
SlowCall |
DirectEntry CLabel RepArity |

nodeMustPointToIt :: DynFlags -> LambdaFormInfo -> Bool Source #

isKnownFun :: LambdaFormInfo -> Bool Source #

funTag :: DynFlags -> ClosureInfo -> DynTag Source #

tagForArity :: DynFlags -> RepArity -> DynTag Source #

getCallMethod :: DynFlags -> Name -> Id -> LambdaFormInfo -> RepArity -> RepArity -> CgLoc -> Maybe SelfLoopInfo -> CallMethod Source #

# ClosureInfo

data ClosureInfo Source #

mkClosureInfo :: DynFlags -> Bool -> Id -> LambdaFormInfo -> Int -> Int -> String -> ClosureInfo Source #

mkCmmInfo :: ClosureInfo -> Id -> CostCentreStack -> CmmInfoTable Source #

Convert from `ClosureInfo` to `CmmInfoTable`.

## Inspection

closureLFInfo :: ClosureInfo -> LambdaFormInfo Source #

closureName :: ClosureInfo -> Name Source #

## Labels

closureInfoLabel :: ClosureInfo -> CLabel Source #

staticClosureLabel :: ClosureInfo -> CLabel Source #

closureSlowEntryLabel :: ClosureInfo -> CLabel Source #

closureLocalEntryLabel :: DynFlags -> ClosureInfo -> CLabel Source #

## Predicates

closureUpdReqd :: ClosureInfo -> Bool Source #

closureSingleEntry :: ClosureInfo -> Bool Source #

closureReEntrant :: ClosureInfo -> Bool Source #

closureFunInfo :: ClosureInfo -> Maybe (RepArity, ArgDescr) Source #

isToplevClosure :: ClosureInfo -> Bool Source #

blackHoleOnEntry :: ClosureInfo -> Bool Source #

isStaticClosure :: ClosureInfo -> Bool Source #

# InfoTables

mkDataConInfoTable :: DynFlags -> DataCon -> Bool -> Int -> Int -> CmmInfoTable Source #

cafBlackHoleInfoTable :: CmmInfoTable Source #

indStaticInfoTable :: CmmInfoTable Source #

staticClosureNeedsLink :: Bool -> CmmInfoTable -> Bool Source #