Copyright	[2009..2018] Trevor L. McDonell
License	BSD
Safe Haskell	None
Language	Haskell98

Foreign.CUDA.Driver.Module.Base

Contents

Module Management
- Loading and unloading modules

Description

Module loading for low-level driver interface

Synopsis

newtype Module = Module {
- useModule :: Ptr ()
}
data JITOption
- = MaxRegisters !Int
- | ThreadsPerBlock !Int
- | OptimisationLevel !Int
- | Target !Compute
- | FallbackStrategy !JITFallback
- | GenerateDebugInfo
- | GenerateLineInfo
- | Verbose
data JITTarget
- = Compute20
- | Compute21
- | Compute30
- | Compute32
- | Compute35
- | Compute37
- | Compute50
- | Compute52
- | Compute53
- | Compute60
- | Compute61
- | Compute62
- | Compute70
- | Compute75
data JITResult = JITResult {
- jitTime :: !Float
- jitInfoLog :: !ByteString
- jitModule :: !Module
}
data JITFallback
- = PreferPTX
- | PreferBinary
data JITInputType
- = Cubin
- | PTX
- | Fatbinary
- | Object
- | Library
- | CuJitNumInputTypes
loadFile :: FilePath -> IO Module
loadData :: ByteString -> IO Module
loadDataFromPtr :: Ptr Word8 -> IO Module
loadDataEx :: ByteString -> [JITOption] -> IO JITResult
loadDataFromPtrEx :: Ptr Word8 -> [JITOption] -> IO JITResult
unload :: Module -> IO ()

Module Management

newtype Module Source #

A reference to a Module object, containing collections of device functions

Constructors

Module
Fields useModule :: Ptr ()

Instances

Eq Module Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods (==) :: Module -> Module -> Bool # (/=) :: Module -> Module -> Bool #
Show Module Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods showsPrec :: Int -> Module -> ShowS # show :: Module -> String # showList :: [Module] -> ShowS #

data JITOption Source #

Just-in-time compilation and linking options

Constructors

MaxRegisters !Int	maximum number of registers per thread
ThreadsPerBlock !Int	number of threads per block to target for
OptimisationLevel !Int	level of optimisation to apply (1-4, default 4)
Target !Compute	compilation target, otherwise determined from context
FallbackStrategy !JITFallback	fallback strategy if matching cubin not found
GenerateDebugInfo	generate debug info (-g) (requires cuda >= 5.5)
GenerateLineInfo	generate line number information (-lineinfo) (requires cuda >= 5.5)
Verbose	verbose log messages (requires cuda >= 5.5)

Instances

Show JITOption Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods showsPrec :: Int -> JITOption -> ShowS # show :: JITOption -> String # showList :: [JITOption] -> ShowS #

data JITTarget Source #

Online compilation target architecture

Constructors

Compute20
Compute21
Compute30
Compute32
Compute35
Compute37
Compute50
Compute52
Compute53
Compute60
Compute61
Compute62
Compute70
Compute75

Instances

Enum JITTarget Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods succ :: JITTarget -> JITTarget # pred :: JITTarget -> JITTarget # toEnum :: Int -> JITTarget # fromEnum :: JITTarget -> Int # enumFrom :: JITTarget -> [JITTarget] # enumFromThen :: JITTarget -> JITTarget -> [JITTarget] # enumFromTo :: JITTarget -> JITTarget -> [JITTarget] # enumFromThenTo :: JITTarget -> JITTarget -> JITTarget -> [JITTarget] #
Eq JITTarget Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods (==) :: JITTarget -> JITTarget -> Bool # (/=) :: JITTarget -> JITTarget -> Bool #
Show JITTarget Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods showsPrec :: Int -> JITTarget -> ShowS # show :: JITTarget -> String # showList :: [JITTarget] -> ShowS #

data JITResult Source #

Results of online compilation

Constructors

JITResult
Fields jitTime :: !Float milliseconds spent compiling PTX jitInfoLog :: !ByteString information about PTX assembly jitModule :: !Module the compiled module

Instances

Show JITResult Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods showsPrec :: Int -> JITResult -> ShowS # show :: JITResult -> String # showList :: [JITResult] -> ShowS #

data JITFallback Source #

Online compilation fallback strategy

Constructors

PreferPTX
PreferBinary

Instances

Enum JITFallback Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods succ :: JITFallback -> JITFallback # pred :: JITFallback -> JITFallback # toEnum :: Int -> JITFallback # fromEnum :: JITFallback -> Int # enumFrom :: JITFallback -> [JITFallback] # enumFromThen :: JITFallback -> JITFallback -> [JITFallback] # enumFromTo :: JITFallback -> JITFallback -> [JITFallback] # enumFromThenTo :: JITFallback -> JITFallback -> JITFallback -> [JITFallback] #
Eq JITFallback Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods (==) :: JITFallback -> JITFallback -> Bool # (/=) :: JITFallback -> JITFallback -> Bool #
Show JITFallback Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods showsPrec :: Int -> JITFallback -> ShowS # show :: JITFallback -> String # showList :: [JITFallback] -> ShowS #

data JITInputType Source #

Device code formats that can be used for online linking

Constructors

Cubin
PTX
Fatbinary
Object
Library
CuJitNumInputTypes

Instances

Enum JITInputType Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods succ :: JITInputType -> JITInputType # pred :: JITInputType -> JITInputType # toEnum :: Int -> JITInputType # fromEnum :: JITInputType -> Int # enumFrom :: JITInputType -> [JITInputType] # enumFromThen :: JITInputType -> JITInputType -> [JITInputType] # enumFromTo :: JITInputType -> JITInputType -> [JITInputType] # enumFromThenTo :: JITInputType -> JITInputType -> JITInputType -> [JITInputType] #
Eq JITInputType Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods (==) :: JITInputType -> JITInputType -> Bool # (/=) :: JITInputType -> JITInputType -> Bool #
Show JITInputType Source #
Instance details Defined in Foreign.CUDA.Driver.Module.Base Methods showsPrec :: Int -> JITInputType -> ShowS # show :: JITInputType -> String # showList :: [JITInputType] -> ShowS #

Loading and unloading modules

loadFile :: FilePath -> IO Module Source #

Load the contents of the specified file (either a ptx or cubin file) to create a new module, and load that module into the current context.

http://docs.nvidia.com/cuda/cuda-driver-api/group__CUDA__MODULE.html#group__CUDA__MODULE_1g366093bd269dafd0af21f1c7d18115d3

loadData :: ByteString -> IO Module Source #

Load the contents of the given image into a new module, and load that module into the current context. The image is (typically) the contents of a cubin or PTX file.

Note that the ByteString will be copied into a temporary staging area so that it can be passed to C.

http://docs.nvidia.com/cuda/cuda-driver-api/group__CUDA__MODULE.html#group__CUDA__MODULE_1g04ce266ce03720f479eab76136b90c0b

loadDataFromPtr :: Ptr Word8 -> IO Module Source #

As loadData, but read the image data from the given pointer. The image is a NULL-terminated sequence of bytes.

loadDataEx :: ByteString -> [JITOption] -> IO JITResult Source #

Load the contents of the given image into a module with online compiler options, and load the module into the current context. The image is (typically) the contents of a cubin or PTX file. The actual attributes of the compiled kernel can be probed using requires.

Note that the ByteString will be copied into a temporary staging area so that it can be passed to C.

http://docs.nvidia.com/cuda/cuda-driver-api/group__CUDA__MODULE.html#group__CUDA__MODULE_1g9e8047e9dbf725f0cd7cafd18bfd4d12

loadDataFromPtrEx :: Ptr Word8 -> [JITOption] -> IO JITResult Source #

As loadDataEx, but read the image data from the given pointer. The image is a NULL-terminated sequence of bytes.

unload :: Module -> IO () Source #

Unload a module from the current context.

http://docs.nvidia.com/cuda/cuda-driver-api/group__CUDA__MODULE.html#group__CUDA__MODULE_1g8ea3d716524369de3763104ced4ea57b