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