break.h

// break.h - Emulation activity control
// ------
// Author: Nmlgc

#ifdef __cplusplus
extern "C" {
#endif

enum {
	NP2BREAK_RESUME		= 0x00,
	NP2BREAK_MAIN		= 0x01,
	NP2BREAK_DEBUG		= 0x02
};

typedef enum {
	NP2BP_NONE		= 0x00,
	NP2BP_READ		= 0x01,
	NP2BP_WRITE		= 0x02,
	NP2BP_EXECUTE		= 0x04,
	NP2BP_ONESHOT		= 0x08
} np2break_t;

/// Globals
/// -------
extern	UINT8	np2stopemulate;
extern	BOOL 	np2singlestep;

// Dense list of flags for every possible address, used for quickly halting
// execution if necessary without having to traverse a linked list.
extern	np2break_t	np2breakflags[];
// Sparse linked list of all addresses with active breakpoints, used in the UI
// or for more naive checks.
extern	LISTARRAY	np2breakaddrs;
/// -------

/// Activity
/// --------
void np2active_renewal(UINT8 breakflag);
void np2active_set(int active);
// Sets the single-step flag and resumes emulation.
// Next CPU loop will perform one instruction only, then pause the emulation again
void np2active_step();
void np2active_step_over();
/// --------

/// Breakpoints
/// -----------
void np2break_create();

// These are guaranteed to return a valid, non-NULL pointer.
np2break_t* np2break_lookup_real(UINT32 addr);
np2break_t* np2break_lookup(UINT32 *addr_if_hit, UINT16 seg, UINT16 off);

BOOL np2break_toggle_real(UINT32 addr, np2break_t flag);
BOOL np2break_toggle(UINT16 seg, UINT16 off, np2break_t flag);

// Returns the address of the breakpoint hit at the next instruction, or 0 for none
UINT32 np2break_is_next();

void np2break_reset();
void np2break_destroy();
/// -----------

/// Helper
/// ------
typedef struct _UNASM_t _UNASM, *UNASM;

// Disassembles the instruction at CS:IP
UINT unasm_next(UNASM una);
/// ------

#ifdef __cplusplus
}
#endif