Hapstone.Capstone

This module wraps all the complex and unsafe details of the capstone API to provide a simple interface to a disassembler, while retaining a reasonable level of versatility.

TODO: write a proper user guide here.

Documentation

disasmIO :: Disassembler a -> IO (Either CsErr [(CsInsn, a)])

run a Disassembler, keeping the results of the custom action

disasmSimpleIO :: Disassembler a -> IO (Either CsErr [CsInsn])

run a disassembler, throwing away the results of the custom action

data Disassembler a

a structure holding settings for a disassembling action

Constructors

Disassembler

Fields

arch :: CsArch

architecture

modes :: [CsMode]

disassembling modes

buffer :: [Word8]

buffer to disassemble

addr :: Word64

address of first byte in the buffer

num :: Int

number of instructions to disassemble (0 for maximum)

detail :: Bool

include detailed information?

skip :: Maybe CsSkipdataStruct

setup SKIPDATA options

action :: Csh -> CsInsn -> IO a

action to run on each instruction

defaultSkipdataStruct :: CsSkipdataStruct

default setup for skipdata: ".db" string and no callback

defaultAction :: Csh -> CsInsn -> IO ()

default action to run on each instruction (does nothing)

mkCallback :: Storable a => (Storable a => ([Word8], [Word8]) -> a -> IO CSize) -> IO CsSkipdataCallback

wrap a relatively safe function to get a callback "safe" in this context means that the buffer remains unmodified