#ifndef __DNBDefs_h__
#define __DNBDefs_h__
#include <stdint.h>
#include <signal.h>
#include <stdio.h>
#include <sys/syslimits.h>
#include <unistd.h>
#if defined (__x86_64__) || defined (__ppc64__)
typedef uint64_t nub_addr_t;
#define INVALID_NUB_ADDRESS ((nub_addr_t)~0ull)
#elif defined (__i386__) || defined (__powerpc__) || defined (__ppc__) || defined (__arm__)
typedef uint32_t nub_addr_t;
#define INVALID_NUB_ADDRESS ((nub_addr_t)~0ul)
#else
#warning undefined architecture, defaulting to 8 byte addresses
typedef uint64_t nub_addr_t;
#define INVALID_NUB_ADDRESS ((nub_addr_t)~0ull)
#endif
typedef size_t nub_size_t;
typedef ssize_t nub_ssize_t;
typedef uint32_t nub_break_t;
typedef uint32_t nub_watch_t;
typedef uint32_t nub_index_t;
typedef pid_t nub_process_t;
typedef unsigned int nub_thread_t;
typedef uint32_t nub_event_t;
typedef uint32_t nub_bool_t;
#define INVALID_NUB_BREAK_ID ((nub_break_t)0)
#define INVALID_NUB_PROCESS ((nub_process_t)0)
#define INVALID_NUB_THREAD ((nub_thread_t)0)
#define INVALID_NUB_WATCH_ID ((nub_watch_t)0)
#define INVALID_NUB_HW_INDEX UINT32_MAX
#define INVALID_NUB_REGNUM UINT32_MAX
#define NUB_GENERIC_ERROR UINT32_MAX
#define NUB_BREAK_ID_IS_VALID(breakID) ((breakID) != (INVALID_NUB_BREAK_ID))
#define NUB_WATCH_ID_IS_VALID(watchID) ((watchID) != (INVALID_NUB_WATCH_ID))
#define WATCH_TYPE_READ (1u << 0)
#define WATCH_TYPE_WRITE (1u << 1)
typedef enum
{
eStateInvalid = 0,
eStateUnloaded,
eStateAttaching,
eStateLaunching,
eStateStopped,
eStateRunning,
eStateStepping,
eStateCrashed,
eStateDetached,
eStateExited,
eStateSuspended
} nub_state_t;
typedef enum
{
eLaunchFlavorDefault = 0,
eLaunchFlavorPosixSpawn,
eLaunchFlavorForkExec,
#if defined (__arm__)
eLaunchFlavorSpringBoard,
#endif
} nub_launch_flavor_t;
#define NUB_STATE_IS_RUNNING(s) ((s) == eStateAttaching ||\
(s) == eStateLaunching ||\
(s) == eStateRunning ||\
(s) == eStateStepping ||\
(s) == eStateDetached)
#define NUB_STATE_IS_STOPPED(s) ((s) == eStateUnloaded ||\
(s) == eStateStopped ||\
(s) == eStateCrashed ||\
(s) == eStateExited)
enum
{
eEventProcessRunningStateChanged = 1 << 0, eEventProcessStoppedStateChanged = 1 << 1, eEventSharedLibsStateChange = 1 << 2, eEventStdioAvailable = 1 << 3, eEventProcessAsyncInterrupt = 1 << 4, kAllEventsMask = eEventProcessRunningStateChanged |
eEventProcessStoppedStateChanged |
eEventSharedLibsStateChange |
eEventStdioAvailable |
eEventProcessAsyncInterrupt
};
#define LOG_VERBOSE (1u << 0)
#define LOG_PROCESS (1u << 1)
#define LOG_THREAD (1u << 2)
#define LOG_EXCEPTIONS (1u << 3)
#define LOG_SHLIB (1u << 4)
#define LOG_MEMORY (1u << 5) // Log memory reads/writes calls
#define LOG_MEMORY_DATA_SHORT (1u << 6) // Log short memory reads/writes bytes
#define LOG_MEMORY_DATA_LONG (1u << 7) // Log all memory reads/writes bytes
#define LOG_MEMORY_PROTECTIONS (1u << 8) // Log memory protection changes
#define LOG_BREAKPOINTS (1u << 9)
#define LOG_EVENTS (1u << 10)
#define LOG_WATCHPOINTS (1u << 11)
#define LOG_STEP (1u << 12)
#define LOG_TASK (1u << 13)
#define LOG_LO_USER (1u << 16)
#define LOG_HI_USER (1u << 31)
#define LOG_ALL 0xFFFFFFFFu
#define LOG_DEFAULT ((LOG_PROCESS) |\
(LOG_TASK) |\
(LOG_THREAD) |\
(LOG_EXCEPTIONS) |\
(LOG_SHLIB) |\
(LOG_MEMORY) |\
(LOG_BREAKPOINTS) |\
(LOG_WATCHPOINTS) |\
(LOG_STEP))
#define REGISTER_SET_ALL 0
#define REGISTER_SET_GENERIC ((uint32_t)0xFFFFFFFFu)
#define GENERIC_REGNUM_PC 0 // Program Counter
#define GENERIC_REGNUM_SP 1 // Stack Pointer
#define GENERIC_REGNUM_FP 2 // Frame Pointer
#define GENERIC_REGNUM_RA 3 // Return Address
#define GENERIC_REGNUM_FLAGS 4 // Processor flags register
#define GENERIC_REGNUM_ARG1 5 // The register that would contain pointer size or less argument 1 (if any)
#define GENERIC_REGNUM_ARG2 6 // The register that would contain pointer size or less argument 2 (if any)
#define GENERIC_REGNUM_ARG3 7 // The register that would contain pointer size or less argument 3 (if any)
#define GENERIC_REGNUM_ARG4 8 // The register that would contain pointer size or less argument 4 (if any)
#define GENERIC_REGNUM_ARG5 9 // The register that would contain pointer size or less argument 5 (if any)
#define GENERIC_REGNUM_ARG6 10 // The register that would contain pointer size or less argument 6 (if any)
#define GENERIC_REGNUM_ARG7 11 // The register that would contain pointer size or less argument 7 (if any)
#define GENERIC_REGNUM_ARG8 12 // The register that would contain pointer size or less argument 8 (if any)
enum DNBRegisterType
{
InvalidRegType = 0,
Uint, Sint, IEEE754, Vector };
enum DNBRegisterFormat
{
InvalidRegFormat = 0,
Binary,
Decimal,
Hex,
Float,
VectorOfSInt8,
VectorOfUInt8,
VectorOfSInt16,
VectorOfUInt16,
VectorOfSInt32,
VectorOfUInt32,
VectorOfFloat32,
VectorOfUInt128
};
struct DNBRegisterInfo
{
uint32_t set; uint32_t reg; const char *name; const char *alt; uint16_t type; uint16_t format; uint32_t size; uint32_t offset; uint32_t reg_gcc; uint32_t reg_dwarf; uint32_t reg_generic; uint32_t reg_gdb; };
struct DNBRegisterSetInfo
{
const char *name; const struct DNBRegisterInfo *registers; nub_size_t num_registers; };
struct DNBThreadResumeAction
{
nub_thread_t tid; nub_state_t state; int signal; nub_addr_t addr; };
enum DNBThreadStopType
{
eStopTypeInvalid = 0,
eStopTypeSignal,
eStopTypeException
};
enum DNBMemoryPermissions
{
eMemoryPermissionsWritable = (1 << 0),
eMemoryPermissionsReadable = (1 << 1),
eMemoryPermissionsExecutable = (1 << 2)
};
#define DNB_THREAD_STOP_INFO_MAX_DESC_LENGTH 256
#define DNB_THREAD_STOP_INFO_MAX_EXC_DATA 8
struct DNBThreadStopInfo
{
DNBThreadStopType reason;
char description[DNB_THREAD_STOP_INFO_MAX_DESC_LENGTH];
union
{
struct
{
uint32_t signo;
} signal;
struct
{
uint32_t type;
nub_size_t data_count;
nub_addr_t data[DNB_THREAD_STOP_INFO_MAX_EXC_DATA];
} exception;
} details;
};
struct DNBRegisterValue
{
struct DNBRegisterInfo info; union
{
int8_t sint8;
int16_t sint16;
int32_t sint32;
int64_t sint64;
uint8_t uint8;
uint16_t uint16;
uint32_t uint32;
uint64_t uint64;
float float32;
double float64;
int8_t v_sint8[32];
int16_t v_sint16[16];
int32_t v_sint32[8];
int64_t v_sint64[4];
uint8_t v_uint8[32];
uint16_t v_uint16[16];
uint32_t v_uint32[8];
uint64_t v_uint64[4];
float v_float32[8];
double v_float64[4];
void *pointer;
char *c_str;
} value;
};
enum DNBSharedLibraryState
{
eShlibStateUnloaded = 0,
eShlibStateLoaded = 1
};
#ifndef DNB_MAX_SEGMENT_NAME_LENGTH
#define DNB_MAX_SEGMENT_NAME_LENGTH 32
#endif
struct DNBSegment
{
char name[DNB_MAX_SEGMENT_NAME_LENGTH];
nub_addr_t addr;
nub_addr_t size;
};
struct DNBExecutableImageInfo
{
char name[PATH_MAX]; uint32_t state; nub_addr_t header_addr; uuid_t uuid; uint32_t num_segments; DNBSegment *segments; };
struct DNBRegionInfo
{
nub_addr_t addr;
nub_addr_t size;
uint32_t permissions;
};
typedef nub_bool_t (*DNBCallbackBreakpointHit)(nub_process_t pid, nub_thread_t tid, nub_break_t breakID, void *baton);
typedef nub_addr_t (*DNBCallbackNameToAddress)(nub_process_t pid, const char *name, const char *shlib_regex, void *baton);
typedef nub_size_t (*DNBCallbackCopyExecutableImageInfos)(nub_process_t pid, struct DNBExecutableImageInfo **image_infos, nub_bool_t only_changed, void *baton);
typedef void (*DNBCallbackLog)(void *baton, uint32_t flags, const char *format, va_list args);
#endif // #ifndef __DNBDefs_h__