ghci-8.4.0.20171214: The library supporting GHC's interactive interpreter

Safe HaskellNone
LanguageHaskell2010

GHCi.RemoteTypes

Description

Types for referring to remote objects in Remote GHCi. For more details, see Note [External GHCi pointers] in compilerghciGHCi.hs

For details on Remote GHCi, see Note [Remote GHCi] in compilerghciGHCi.hs.

Synopsis

Documentation

newtype RemotePtr a Source #

Constructors

RemotePtr Word64 
Instances
Show (RemotePtr a) # 
Instance details
Binary (RemotePtr a) # 
Instance details
NFData (RemotePtr a) # 
Instance details

Methods

rnf :: RemotePtr a -> () Source #

newtype HValue Source #

Constructors

HValue Any 
Instances
Show HValue # 
Instance details

data RemoteRef a Source #

A reference to a remote value. These are allocated and freed explicitly.

Instances
Show (RemoteRef a) # 
Instance details
Binary (RemoteRef a) # 
Instance details

mkRemoteRef :: a -> IO (RemoteRef a) Source #

Make a reference to a local value that we can send remotely. This reference will keep the value that it refers to alive until freeRemoteRef is called.

localRef :: RemoteRef a -> IO a Source #

Convert an HValueRef to an HValue. Should only be used if the HValue originated in this process.

freeRemoteRef :: RemoteRef a -> IO () Source #

Release an HValueRef that originated in this process

data ForeignRef a Source #

An HValueRef with a finalizer

Instances
NFData (ForeignRef a) # 
Instance details

Methods

rnf :: ForeignRef a -> () Source #

mkForeignRef :: RemoteRef a -> IO () -> IO (ForeignRef a) Source #

Create a ForeignRef from a RemoteRef. The finalizer should arrange to call freeHValueRef on the HValueRef. (since this function needs to be called in the process that created the HValueRef, it cannot be called directly from the finalizer).