1651 lines
48 KiB
C
Executable File
1651 lines
48 KiB
C
Executable File
/* This file has been modified by Data General Corporation, November 1989. */
|
|
|
|
/*
|
|
This file provides an abstract interface to "tdesc" information.
|
|
It is designed to be used in a uniform manner by several kinds
|
|
of debuggers:
|
|
(1) code in live debugged process (e.g., a traceback routine)
|
|
(2) a separate-process debugger debugging a live process
|
|
(3) a separate-process debugger debugging a memory dump
|
|
|
|
Dcontext model notes
|
|
* captures machine context
|
|
* partial: excludes memory
|
|
* frames
|
|
* kinds
|
|
* make one for starters, chain in reverse order to previous ones
|
|
* representation: pointer to opaque
|
|
* alloc/free protocol
|
|
|
|
Overall model
|
|
* access functions
|
|
* handle
|
|
* error handling
|
|
*/
|
|
|
|
|
|
|
|
typedef int dc_boolean_t; /* range 0 .. 1 */
|
|
#define DC_FALSE 0
|
|
#define DC_TRUE 1
|
|
|
|
|
|
typedef int dc_tristate_t; /* range 0 .. 2 */
|
|
#define DC_NO 0
|
|
#define DC_YES 1
|
|
#define DC_MAYBE 2
|
|
|
|
|
|
/*
|
|
A word is 32 bits of information. In memory, a word is word-aligned.
|
|
|
|
A common and important use of dc_word_t is to represent values in the
|
|
target process, including (byte) addresses in the target process.
|
|
In this case, C arithmetic can be used to simulate machine address
|
|
arithmetic on the target. (Unsigned arithmetic is actually modulus
|
|
arithmetic.)
|
|
*/
|
|
typedef unsigned int dc_word_t;
|
|
|
|
|
|
/* These bit operations number bits from 0 at the least significant end. */
|
|
#define bit_test(word,bit) ((word) & (1 << (bit))) /* returns 0 or other */
|
|
#define bit_value(word,bit) (((word) >> (bit)) & 1) /* returns 0 or 1 */
|
|
#define bit_set(word,bit) ((word) |= (1 << (bit)))
|
|
#define bit_clear(word,bit) ((word) &= ~(1 << (bit)))
|
|
#define bit_assign(word, bit, bool) \
|
|
if (bool) bit_set(word, bit); else bit_clear(word, bit)
|
|
|
|
|
|
/*----------------*/
|
|
|
|
|
|
/* The exactness of locations may not be certainly known. */
|
|
typedef dc_tristate_t dc_exactness_t;
|
|
|
|
|
|
/*
|
|
The model includes five kinds of contexts. Because each context
|
|
has an associated region and frame, these describe region kinds
|
|
and frame kinds as well.
|
|
[more description needed]
|
|
Currently, only call contexts exist.
|
|
*/
|
|
|
|
typedef int dc_kind_t; /* range 0 .. 4 */
|
|
#define DC_CALL_KIND 0
|
|
#define DC_SAVE_KIND 1
|
|
#define DC_EXCEPTION_KIND 2
|
|
#define DC_PROTECTION_KIND 3
|
|
#define DC_SPECIAL_KIND 4
|
|
#define DC_NUM_KINDS 5
|
|
|
|
#define DC_MIO_ENTRY_POINT (1<< 0)
|
|
#define DC_MIO_PROLOGUE_END (1<< 1)
|
|
#define DC_MIO_EPILOGUE_START (1<< 2)
|
|
#define DC_MIO_IMPLICIT_PROLOGUE_END (1<<16)
|
|
#define DC_MIO_LITERAL_ENTRY_POINT (1<<17)
|
|
#define DC_MIO_LITERAL_EPILOGUE_START (1<<18)
|
|
|
|
#define DC_MII_PRECEDING_TDESC_END (1<<0)
|
|
#define DC_MII_FOLLOWING_TDESC_START (1<<1)
|
|
|
|
typedef struct dc_debug_info {
|
|
unsigned int protocol; /* 1 for this structure */
|
|
dc_word_t tdesc_ptr;
|
|
unsigned int text_words_count;
|
|
dc_word_t text_words_ptr;
|
|
unsigned int data_words_count;
|
|
dc_word_t data_words_ptr;
|
|
} dc_debug_info_t;
|
|
|
|
|
|
typedef struct tdesc_hdr {
|
|
unsigned int map_protocol; /* 1 for this structure */
|
|
unsigned int end; /* address beyond end */
|
|
} tdesc_hdr_t;
|
|
|
|
|
|
typedef struct tdesc_chunk_hdr {
|
|
int zeroes : 8;
|
|
int info_length : 22;
|
|
int info_alignment : 2;
|
|
unsigned int info_protocol;
|
|
dc_word_t start_address;
|
|
dc_word_t end_address;
|
|
} tdesc_chunk_hdr_t;
|
|
|
|
|
|
typedef struct tdesc_chunk_info1 {
|
|
int variant : 8; /* 1 for this structure */
|
|
int register_save_mask : 17;
|
|
int pad1 : 1;
|
|
int return_address_info_discriminant : 1;
|
|
int frame_address_register : 5;
|
|
unsigned int frame_address_offset;
|
|
unsigned int return_address_info;
|
|
unsigned int register_save_offset;
|
|
} tdesc_chunk_info1_t;
|
|
|
|
|
|
typedef struct tdesc_chunk1 {
|
|
tdesc_chunk_hdr_t hdr;
|
|
tdesc_chunk_info1_t info;
|
|
} tdesc_chunk1_t;
|
|
|
|
|
|
typedef struct dc_mstate {
|
|
dc_word_t reg[32]; /* general registers */
|
|
dc_word_t xip;
|
|
dc_word_t nip;
|
|
dc_word_t fip;
|
|
dc_word_t fpsr;
|
|
dc_word_t fpcr;
|
|
dc_word_t psr;
|
|
} dc_mstate_t;
|
|
|
|
|
|
typedef struct dc_map_info_in {
|
|
dc_word_t flags;
|
|
dc_word_t preceding_tdesc_end;
|
|
dc_word_t following_tdesc_start;
|
|
} dc_map_info_in_t;
|
|
|
|
|
|
typedef struct dc_map_info_out {
|
|
dc_word_t flags;
|
|
dc_word_t entry_point;
|
|
dc_word_t prologue_end;
|
|
dc_word_t epilogue_start;
|
|
} dc_map_info_out_t;
|
|
|
|
|
|
#if 0
|
|
|
|
void error_fcn (env, continuable, message)
|
|
dc_word_t env; /* environment (arbitrary datum) */
|
|
dc_boolean_t continuable; /* whether error function may return */
|
|
char *message; /* string (no trailing newline) */
|
|
|
|
/* In the future, we probably want the error_fcn to be: */
|
|
void error_fcn (env, continuable, code, ...)
|
|
dc_word_t env; /* environment (arbitrary datum) */
|
|
dc_boolean_t continuable; /* whether error function may return */
|
|
int code; /* error code */
|
|
... /* parameters to message associated
|
|
with the code */
|
|
|
|
void read_fcn (env, memory, length, buffer)
|
|
dc_word_t env; /* environment (arbitrary datum) */
|
|
dc_word_t memory; /* start address in image */
|
|
int length; /* in bytes */
|
|
char *buffer; /* start address of buffer */
|
|
/* There are no alignment assumptions for the read function. */
|
|
|
|
void write_fcn (env, memory, length, buffer)
|
|
dc_word_t env; /* environment (arbitrary datum) */
|
|
dc_word_t memory; /* start address in image */
|
|
int length; /* in bytes */
|
|
char *buffer; /* start address of buffer */
|
|
/* There are no alignment assumptions for the write function. */
|
|
/* The write function is optional. It must be provided if changes
|
|
to writable registers are to be made. */
|
|
|
|
void exec_fcn (env, mstate)
|
|
dc_word_t env; /* environment (arbitrary datum) */
|
|
dc_mstate_t *mstate; /* machine state (read-write) */
|
|
/* The execute function is optional. It would be used (in the future)
|
|
by the implementation of a procedurally specified tdesc mechanism. */
|
|
|
|
#endif
|
|
|
|
/*----------------*/
|
|
|
|
|
|
#ifndef NULL
|
|
#define NULL ((void *) 0)
|
|
#endif
|
|
|
|
extern char *malloc();
|
|
extern char *calloc();
|
|
extern void qsort();
|
|
|
|
|
|
/*
|
|
At initialization, create a tdesc table from the tdesc info.
|
|
A tdesc table is simply a sorted array of tdesc elements.
|
|
A tdesc element is the last 6 words of the tdesc chunk.
|
|
We require that all tdesc chunks have info protocol 1.
|
|
*/
|
|
|
|
typedef struct tdesc_elem {
|
|
dc_word_t start_address;
|
|
dc_word_t end_address;
|
|
tdesc_chunk_info1_t info;
|
|
} tdesc_elem_t;
|
|
|
|
typedef tdesc_elem_t *tdesc_table_t;
|
|
|
|
void dc_correct_cr_data();
|
|
|
|
int dc_compare_tdesc_elems (elem1, elem2)
|
|
char *elem1, *elem2;
|
|
{
|
|
dc_word_t s1, s2, e1, e2;
|
|
s1 = ((tdesc_elem_t *) elem1)->start_address;
|
|
s2 = ((tdesc_elem_t *) elem2)->start_address;
|
|
if (s1 < s2) return -1;
|
|
if (s1 > s2) return +1;
|
|
e1 = ((tdesc_elem_t *) elem1)->end_address;
|
|
e2 = ((tdesc_elem_t *) elem2)->end_address;
|
|
if (e1 < e2) return -1;
|
|
if (e1 > e2) return +1;
|
|
return 0;
|
|
}
|
|
|
|
|
|
typedef struct handle_info {
|
|
dc_word_t debug_info_ptr;
|
|
void (*error_fcn)();
|
|
dc_word_t error_env;
|
|
void (*read_fcn)();
|
|
dc_word_t read_env;
|
|
void (*write_fcn)(); /* NULL => absent */
|
|
dc_word_t write_env;
|
|
void (*exec_fcn)(); /* NULL => absent */
|
|
dc_word_t exec_env;
|
|
void (*map_fcn)(); /* NULL => absent */
|
|
dc_word_t map_env;
|
|
tdesc_table_t tdesc_table;
|
|
int tdesc_table_size;
|
|
} handle_info_t;
|
|
|
|
typedef handle_info_t *dc_handle_t;
|
|
|
|
|
|
/*
|
|
Errors detected in this module are funnelled through dc_error or dc_warn,
|
|
as appropriate. Both routines call dc_exception, which invokes the error
|
|
handler supplied by the user.
|
|
|
|
Currently, dc_exception substitutes parameters into the message given
|
|
it and passes the resulting string to the user error handler.
|
|
In the future, dc_exception should simply pass an error code and
|
|
the parameters on to the user error handler.
|
|
*/
|
|
|
|
#include <varargs.h>
|
|
extern int vsprintf();
|
|
|
|
/* Exit status for exception-processing machinery failure */
|
|
#define DC_EXCEPTION_FAILURE 250
|
|
|
|
void dc_exception(continuable, args)
|
|
dc_boolean_t continuable;
|
|
va_list args;
|
|
{
|
|
dc_handle_t handle;
|
|
char *format;
|
|
char buffer[1024];
|
|
|
|
handle = va_arg(args, dc_handle_t);
|
|
format = va_arg(args, char *);
|
|
(void) vsprintf(buffer, format, args);
|
|
(*(handle->error_fcn)) (handle->error_env, continuable, buffer);
|
|
if (!continuable)
|
|
exit(DC_EXCEPTION_FAILURE); /* User error handler should never return in this case. */
|
|
}
|
|
|
|
|
|
void dc_error(va_alist) /* (handle, format, args... ) */
|
|
va_dcl
|
|
{
|
|
va_list args;
|
|
|
|
va_start(args);
|
|
dc_exception(DC_FALSE, args);
|
|
va_end(args);
|
|
}
|
|
|
|
|
|
void dc_warn(va_alist) /* (handle, format, args... ) */
|
|
va_dcl
|
|
{
|
|
va_list args;
|
|
|
|
va_start(args);
|
|
dc_exception(DC_TRUE, args);
|
|
va_end(args);
|
|
}
|
|
|
|
|
|
|
|
#define MALLOC_FAILURE_MESSAGE "Heap space exhausted (malloc failed)."
|
|
#define CALLOC_FAILURE_MESSAGE "Heap space exhausted (Calloc failed)."
|
|
|
|
|
|
/* Commonize memory allocation call so failure diagnosis is easier */
|
|
|
|
char* dc_malloc( handle, size )
|
|
dc_handle_t handle;
|
|
int size;
|
|
{
|
|
char* space = malloc( size );
|
|
if (space == (char *)NULL)
|
|
dc_error( handle, MALLOC_FAILURE_MESSAGE );
|
|
|
|
return space;
|
|
}
|
|
|
|
|
|
/* Commonize memory allocation call so failure diagnosis is easier */
|
|
|
|
char* dc_calloc( handle,nelem, size )
|
|
dc_handle_t handle;
|
|
int nelem;
|
|
int size;
|
|
{
|
|
char* space = calloc( nelem, size );
|
|
if (space == (char *)NULL)
|
|
dc_error( handle, CALLOC_FAILURE_MESSAGE );
|
|
|
|
return space;
|
|
}
|
|
|
|
|
|
dc_word_t dc_read_word (handle, address)
|
|
dc_handle_t handle;
|
|
dc_word_t address;
|
|
{
|
|
dc_word_t word;
|
|
(*(handle->read_fcn)) (handle->read_env, address,
|
|
sizeof(dc_word_t), (char *)(&(word)));
|
|
return word;
|
|
}
|
|
|
|
|
|
void dc_write_word (handle, address, value)
|
|
dc_handle_t handle;
|
|
dc_word_t address;
|
|
dc_word_t value;
|
|
{
|
|
dc_word_t word;
|
|
word = value;
|
|
if (handle->write_fcn) {
|
|
(*(handle->write_fcn)) (handle->write_env, address,
|
|
sizeof(dc_word_t), (char *)(&(word)));
|
|
} else {
|
|
dc_error (handle, "Writing is disabled.");
|
|
}
|
|
}
|
|
|
|
|
|
void dc_write_masked_word (handle, address, mask, value)
|
|
dc_handle_t handle;
|
|
dc_word_t address;
|
|
dc_word_t mask;
|
|
dc_word_t value;
|
|
{
|
|
dc_write_word (handle, address,
|
|
(value & mask) | (dc_read_word(handle, address) & ~mask));
|
|
}
|
|
|
|
|
|
dc_handle_t dc_initiate (debug_info_ptr,
|
|
error_fcn, error_env,
|
|
read_fcn, read_env,
|
|
write_fcn, write_env,
|
|
exec_fcn, exec_env,
|
|
map_fcn, map_env)
|
|
dc_word_t debug_info_ptr;
|
|
void (*error_fcn)();
|
|
dc_word_t error_env;
|
|
void (*read_fcn)();
|
|
dc_word_t read_env;
|
|
void (*write_fcn)(); /* NULL => absent */
|
|
dc_word_t write_env;
|
|
void (*exec_fcn)(); /* NULL => absent */
|
|
dc_word_t exec_env;
|
|
void (*map_fcn)(); /* NULL => absent */
|
|
dc_word_t map_env;
|
|
/* write_fcn may be given as NULL if no writing is required. */
|
|
/* exec_fcn may be given as NULL if no execution is required.
|
|
Currently, no execution is required. It would be if the
|
|
implementation needed to invoke procedures in the debugged process. */
|
|
{
|
|
dc_handle_t handle;
|
|
unsigned int debug_info_protocol;
|
|
dc_debug_info_t debug_info;
|
|
unsigned int tdesc_map_protocol;
|
|
tdesc_hdr_t tdesc_hdr;
|
|
dc_word_t tdesc_info_start;
|
|
dc_word_t tdesc_info_end;
|
|
dc_word_t tdesc_info_length;
|
|
|
|
/* Set up handle enough for dc_error. */
|
|
handle = (dc_handle_t) malloc(sizeof(handle_info_t));
|
|
/* Cant use dc_malloc() as handle is being created ... */
|
|
/* if (handle == NULL) (*error_fcn)( error_env, MALLOC_FAILURE_MESSAGE ) */
|
|
handle->error_fcn = error_fcn;
|
|
handle->error_env = error_env;
|
|
handle->read_fcn = read_fcn;
|
|
handle->read_env = read_env;
|
|
handle->write_fcn = write_fcn;
|
|
handle->write_env = write_env;
|
|
handle->exec_fcn = exec_fcn;
|
|
handle->exec_env = exec_env;
|
|
/****************************************************************/
|
|
/* BUG 9/19/89 Found by hls. Map functions not initialized. */
|
|
/****************************************************************/
|
|
handle->map_fcn = map_fcn;
|
|
handle->map_env = map_env;
|
|
handle->debug_info_ptr = debug_info_ptr;
|
|
handle->tdesc_table = (tdesc_table_t)NULL;
|
|
|
|
/* Find tdesc info. */
|
|
if (debug_info_ptr) {
|
|
(*read_fcn) (read_env, debug_info_ptr, sizeof(unsigned int),
|
|
(char *)(&debug_info_protocol));
|
|
if (debug_info_protocol != 1)
|
|
dc_error (handle, "Unrecognized debug info protocol: %d",
|
|
debug_info_protocol);
|
|
(*read_fcn) (read_env, debug_info_ptr, sizeof(dc_debug_info_t),
|
|
(char *)(&debug_info));
|
|
(*read_fcn) (read_env, debug_info.tdesc_ptr, sizeof(unsigned int),
|
|
(char *)(&tdesc_map_protocol));
|
|
if (tdesc_map_protocol != 1)
|
|
dc_error (handle, "Unrecognized tdesc map protocol: %d",
|
|
tdesc_map_protocol);
|
|
(*read_fcn) (read_env, debug_info.tdesc_ptr, sizeof(tdesc_hdr_t),
|
|
(char *)(&tdesc_hdr));
|
|
tdesc_info_start = debug_info.tdesc_ptr + sizeof(tdesc_hdr_t);
|
|
tdesc_info_end = tdesc_hdr.end;
|
|
tdesc_info_length = tdesc_info_end - tdesc_info_start;
|
|
|
|
/* Create tdesc table from tdesc info. */
|
|
{
|
|
/* Over-allocate in order to avoid second pass over tdesc info. */
|
|
tdesc_table_t tt = (tdesc_table_t) dc_malloc(handle, tdesc_info_length);
|
|
dc_word_t p = tdesc_info_start;
|
|
dc_word_t q = tdesc_info_end - sizeof(tdesc_chunk1_t);
|
|
int n = 0;
|
|
tdesc_chunk1_t chunk;
|
|
dc_word_t start_address, end_address;
|
|
int i;
|
|
|
|
for (; p <= q; ) {
|
|
(*read_fcn) (read_env, p, sizeof(tdesc_chunk1_t), (char *)(&chunk));
|
|
if (chunk.hdr.zeroes != 0) {
|
|
/* Skip padding. */
|
|
p += sizeof(dc_word_t);
|
|
continue;
|
|
}
|
|
if (chunk.hdr.info_protocol != 1) {
|
|
dc_warn (handle, "Unrecognized tdesc info protocol: %d",
|
|
chunk.hdr.info_protocol);
|
|
goto next_chunk;
|
|
}
|
|
if (chunk.hdr.info_length != 16) {
|
|
dc_warn (handle, "Incorrect tdesc info length: %d",
|
|
chunk.hdr.info_length);
|
|
goto next_chunk;
|
|
}
|
|
if (chunk.hdr.info_alignment > 2) {
|
|
dc_warn (handle, "Incorrect tdesc info alignment: %d",
|
|
chunk.hdr.info_alignment);
|
|
goto next_chunk;
|
|
}
|
|
start_address = chunk.hdr.start_address;
|
|
end_address = chunk.hdr.end_address;
|
|
if ((start_address&3)!=0) {
|
|
dc_warn (handle,
|
|
"Tdesc start address is not word-aligned: %#.8X",
|
|
start_address);
|
|
goto next_chunk;
|
|
}
|
|
if ((end_address&3)!=0) {
|
|
dc_warn (handle,
|
|
"Tdesc end address is not word-aligned: %#.8X",
|
|
end_address);
|
|
goto next_chunk;
|
|
}
|
|
if (start_address > end_address) {
|
|
/* Note that the range may be null. */
|
|
dc_warn (handle,
|
|
"Tdesc start address (%#.8X) follows end address (%#.8X).",
|
|
start_address, end_address);
|
|
goto next_chunk;
|
|
}
|
|
if (chunk.info.variant != 1) {
|
|
dc_warn (handle, "Invalid tdesc chunk variant: %d",
|
|
chunk.info.variant);
|
|
goto next_chunk;
|
|
}
|
|
if (chunk.info.pad1 != 0) {
|
|
dc_warn (handle, "Tdesc chunk padding is not zero.");
|
|
goto next_chunk;
|
|
}
|
|
if (chunk.info.return_address_info_discriminant != 0) {
|
|
if ((chunk.info.return_address_info & 3) != 0) {
|
|
dc_warn (handle,
|
|
"Tdesc return address offset is not word-aligned: %#.8X",
|
|
chunk.info.return_address_info);
|
|
goto next_chunk;
|
|
}
|
|
} else {
|
|
if ((chunk.info.return_address_info & ~31) != 0) {
|
|
dc_warn (handle,
|
|
"Invalid tdesc return address register: %d",
|
|
chunk.info.return_address_info);
|
|
goto next_chunk;
|
|
}
|
|
}
|
|
if ((chunk.info.register_save_offset & 3) != 0) {
|
|
dc_warn (handle,
|
|
"Tdesc register save offset is not word-aligned: %#.8X",
|
|
chunk.info.register_save_offset);
|
|
goto next_chunk;
|
|
}
|
|
|
|
tt[n].start_address = start_address;
|
|
tt[n].end_address = end_address;
|
|
tt[n].info = chunk.info;
|
|
n++;
|
|
|
|
next_chunk:
|
|
p += sizeof(tdesc_chunk1_t);
|
|
}
|
|
/* Leftover (less than a tdesc_chunk1_t in size) is padding or
|
|
in error. Ignore it in either case. */
|
|
|
|
if (n != 0) {
|
|
|
|
/* Sort table by start address. */
|
|
qsort ((char *)tt, n, sizeof(tdesc_elem_t), dc_compare_tdesc_elems);
|
|
|
|
/* Check for overlap among tdesc chunks. */
|
|
for (i=0; i<(n-1); i++) {
|
|
if (tt[i].end_address > tt[i+1].start_address)
|
|
dc_error (handle, "Text chunks overlap.");
|
|
}
|
|
}
|
|
|
|
/* Finish setting up handle. */
|
|
handle->tdesc_table = tt;
|
|
handle->tdesc_table_size = n;
|
|
}
|
|
} else {
|
|
handle->tdesc_table_size = 0;
|
|
}
|
|
|
|
return (dc_handle_t) handle;
|
|
}
|
|
|
|
|
|
void dc_terminate (handle)
|
|
dc_handle_t handle;
|
|
{
|
|
if (((dc_handle_t)handle)->tdesc_table) {
|
|
free((char *)(((dc_handle_t)handle)->tdesc_table));
|
|
}
|
|
free((char *)handle);
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
Dcontext Model
|
|
|
|
For each interesting register (word-sized piece of machine state),
|
|
a word of value information is kept. This word may
|
|
be either the value of the register, or the address in
|
|
subject memory where the value can be found (and changed). In
|
|
addition, the register may be invalid (in which case the value
|
|
information is undefined). These three cases are encoded for
|
|
a given register in the same-numbered bit of two words of flags:
|
|
|
|
flags[0] bit flags[1] bit meaning
|
|
------------ ------------ -------
|
|
0 0 register is invalid; info is undefined
|
|
0 1 register is readable; info is value
|
|
1 0 register is writable; info is address
|
|
1 1 (reserved)
|
|
|
|
The general registers (r0-r31) are handled by reg_info and
|
|
reg_flags. The bit number for a register is that register's number.
|
|
The other registers are grouped together for convenience and are
|
|
handled by aux_info and aux_flags. The bit numbers for these
|
|
registers are:
|
|
|
|
bit number register
|
|
---------- --------
|
|
0 location
|
|
1 SXIP
|
|
2 SNIP
|
|
3 SFIP
|
|
4 FPSR
|
|
5 FPCR
|
|
|
|
The SXIP, SNIP, and SFIP are the exception-time values of the
|
|
XIP, NIP, and FIP registers. They are valid only in the topmost frame.
|
|
(That is, in any context obtained from dc_previous_context, they
|
|
are invalid.)
|
|
|
|
"location" is a pseudo-register of this model and represents the
|
|
location of the context. It is always valid. It also has an
|
|
exactness associated with it. The location and its exactness of a
|
|
context obtained from dc_previous_context are taken from the
|
|
return address and its exactness of the context given as an argument
|
|
to dc_previous_context.
|
|
|
|
The following model is recommended for dealing with the partial
|
|
redundancy between location and the SXIP, SNIP, and SFIP values
|
|
in the topmost frame. The location should be set to either the
|
|
SNIP or SXIP value, and its exactness should be set to DC_NO. A
|
|
change to the register whose value the location is set to should
|
|
be accompanied by an identical change to the location.
|
|
|
|
The PSR is handled separately, because it is a diverse collection
|
|
of flags. The PSR, as a whole, is always valid. A separate
|
|
psr_ind flag tells whether the psr_info data is a value or
|
|
an address. Each bit of the PSR has its own pair of flag bits to
|
|
mark validity and writability.
|
|
|
|
*/
|
|
|
|
|
|
/* The following value means "other", because state is stored in 2 bits. */
|
|
#define DC_RESERVED 3
|
|
|
|
|
|
#define RSTATE(flags, bit) \
|
|
((bit_value((flags)[0], bit) << 1) + bit_value((flags)[1], bit))
|
|
|
|
#define REG_STATE(dcontext, reg) RSTATE(dcontext->reg_flags, reg)
|
|
#define AUX_STATE(dcontext, reg) RSTATE(dcontext->aux_flags, reg)
|
|
#define PSR_STATE(dcontext, reg) RSTATE(dcontext->psr_flags, reg)
|
|
|
|
|
|
#define SET_INVALID(flags, bit) \
|
|
{ bit_clear ((flags)[0], bit); bit_clear ((flags)[1], bit); }
|
|
|
|
#define SET_READABLE(flags, bit) \
|
|
{ bit_clear ((flags)[0], bit); bit_set ((flags)[1], bit); }
|
|
|
|
#define SET_WRITABLE(flags, bit) \
|
|
{ bit_set ((flags)[0], bit); bit_clear ((flags)[1], bit); }
|
|
|
|
#define ASSIGN_RSTATE(to_flags, to_bit, from_flags, from_bit) \
|
|
{ bit_assign ((to_flags)[0], to_bit, bit_value((from_flags)[0], from_bit));\
|
|
bit_assign ((to_flags)[1], to_bit, bit_value((from_flags)[1], from_bit));}
|
|
|
|
|
|
#define CHECK_REG_READ(dcontext, reg) \
|
|
if (REG_STATE(dcontext, reg) == DC_INVALID) \
|
|
dc_error (dcontext->handle, \
|
|
"General register %d is not readable.", reg)
|
|
|
|
#define CHECK_REG_WRITE(dcontext, reg) \
|
|
if (REG_STATE(dcontext, reg) != DC_WRITABLE) \
|
|
dc_error (dcontext->handle, \
|
|
"General register %d is not writable.", reg)
|
|
|
|
#define CHECK_AUX_READ(dcontext, reg) \
|
|
if (AUX_STATE(dcontext, reg) == DC_INVALID) \
|
|
dc_error (dcontext->handle, \
|
|
"Auxiliary register %d is not readable.", reg)
|
|
|
|
#define CHECK_AUX_WRITE(dcontext, reg) \
|
|
if (AUX_STATE(dcontext, reg) != DC_WRITABLE) \
|
|
dc_error (dcontext->handle, \
|
|
"Auxiliary register %d is not writable.", reg)
|
|
|
|
|
|
|
|
#define DC_REG_RA 1
|
|
#define DC_REG_FP 30
|
|
#define DC_REG_SP 31
|
|
#define DC_NUM_REG 32
|
|
|
|
#define DC_AUX_LOC 0
|
|
/* DC_AUX_LOC must be first, with value 0 */
|
|
#define DC_AUX_SXIP 1
|
|
#define DC_AUX_SNIP 2
|
|
#define DC_AUX_SFIP 3
|
|
#define DC_AUX_FPSR 4
|
|
#define DC_AUX_FPCR 5
|
|
#define DC_NUM_AUX 6
|
|
|
|
|
|
|
|
#define CHECK_REG(dcontext, reg) \
|
|
if ((reg < 0) || (reg >= DC_NUM_REG)) \
|
|
dc_error (dcontext->handle, \
|
|
"Bad general register number: %d", reg)
|
|
|
|
#define CHECK_AUX(dcontext, reg) \
|
|
if ((reg < 1) || (reg >= DC_NUM_AUX)) \
|
|
dc_error (dcontext->handle, \
|
|
"Bad auxiliary register number: %d", reg)
|
|
/* CHECK_AUX is not used for location pseudo-register. */
|
|
|
|
#define CHECK_BIT(dcontext, bit) \
|
|
if ((bit < 0) || (bit >= 32)) \
|
|
dc_error (dcontext->handle, \
|
|
"Bad bit number: %d", bit)
|
|
|
|
|
|
|
|
typedef struct cr_value {
|
|
int reg;
|
|
unsigned int off;
|
|
} dc_cr_value_t;
|
|
|
|
#define DC_UNDEF 32
|
|
|
|
/*
|
|
A "dc_cr_value" represents an execution-time value symbolically, in
|
|
terms of the initial value of a register (the value on entry to
|
|
the procedure being analyzed) and a known offset. A value with
|
|
a 'reg' field value of 0 through 31 represents the value obtained
|
|
by summing (using 32-bit modulus arithmetic) the initial value of
|
|
register 'reg' and the value 'off'. Note that the value (0,k)
|
|
represents the constant value k, that (31,0) represents the CFA, and
|
|
that (1,0) represents the return address. A value with a 'reg' field
|
|
of DC_UNDEF represents an indeterminable value; in this case the
|
|
'off' field is undefined. Other values of 'reg' are erroneous.
|
|
*/
|
|
|
|
typedef struct cr_data {
|
|
dc_cr_value_t reg_val[DC_NUM_REG];
|
|
dc_word_t saved;
|
|
dc_word_t how;
|
|
unsigned int where[DC_NUM_REG];
|
|
} dc_cr_data_t;
|
|
|
|
/*
|
|
'cr_data' collects all the information needed to represent the
|
|
symbolic machine state during code reading.
|
|
|
|
The 'reg_val' array gives the current dc_cr_value for each register.
|
|
|
|
The 'saved', 'how', and 'where' fields combine to describe what
|
|
registers have been saved, and where. The 'saved' and 'how' fields
|
|
are implicitly bit arrays over 0..31, where the numbering is from
|
|
0 on the right. (Hence, 1<<r gives the mask for register r.)
|
|
If saved[r] is 0, the register is not saved, and how[r] and where[r]
|
|
are undefined. If saved[r] is 1, then how[r] tells whether register r
|
|
was saved in another register (how[r]==0) or in the frame (how[r]==1).
|
|
In the former case, where[r] gives the register number; in the latter
|
|
case, where[r] gives the frame position.
|
|
*/
|
|
|
|
|
|
typedef int dc_register_state_t; /* range 0 to 2 */
|
|
|
|
#define DC_INVALID 0
|
|
#define DC_READABLE 1
|
|
#define DC_WRITABLE 2
|
|
|
|
|
|
|
|
|
|
typedef struct dcontext_info {
|
|
dc_handle_t handle; /* environment of context */
|
|
dc_word_t reg_info[DC_NUM_REG];
|
|
dc_word_t reg_flags[2];
|
|
dc_word_t aux_info[DC_NUM_AUX];
|
|
dc_word_t aux_flags[2];
|
|
dc_exactness_t loc_exact;
|
|
dc_word_t psr_info; /* value or address */
|
|
dc_word_t psr_ind; /* DC_TRUE iff address */
|
|
dc_word_t psr_flags[2]; /* per-PSR-bit flags */
|
|
unsigned int code_reading; /* no tdesc therefore must read code*/
|
|
union {
|
|
tdesc_elem_t *tdesc_elem_ptr; /* locates tdesc chunk */
|
|
dc_cr_data_t *cr_data_ptr; /* or code reading data */
|
|
} info_ptr;
|
|
} dcontext_info_t;
|
|
|
|
typedef dcontext_info_t *dc_dcontext_t;
|
|
|
|
dc_word_t dc_get_value (handle, info, flags, pos)
|
|
dc_handle_t handle;
|
|
dc_word_t info[];
|
|
dc_word_t flags[2];
|
|
int pos;
|
|
/* Assumes either DC_READABLE or DC_WRITABLE. */
|
|
{
|
|
if (bit_test(flags[0], pos)) {
|
|
/* DC_WRITABLE case */
|
|
return dc_read_word(handle, info[pos]);
|
|
} else {
|
|
/* DC_READABLE case */
|
|
return info[pos];
|
|
}
|
|
}
|
|
|
|
void dc_set_value (handle, info, flags, pos, value)
|
|
dc_handle_t handle;
|
|
dc_word_t info[];
|
|
dc_word_t flags[2];
|
|
int pos;
|
|
dc_word_t value;
|
|
/* Assumes DC_WRITABLE. */
|
|
{
|
|
dc_write_word(handle, info[pos], value);
|
|
}
|
|
|
|
|
|
#define GET_REG_VALUE(dcontext, reg) \
|
|
dc_get_value(dcontext->handle, dcontext->reg_info, dcontext->reg_flags, reg)
|
|
|
|
#define SET_REG_VALUE(dcontext, reg, value) \
|
|
dc_set_value(dcontext->handle, dcontext->reg_info, dcontext->reg_flags, reg, \
|
|
value)
|
|
|
|
#define GET_AUX_VALUE(dcontext, reg) \
|
|
dc_get_value(dcontext->handle, dcontext->aux_info, dcontext->aux_flags, reg)
|
|
|
|
#define SET_AUX_VALUE(dcontext, reg, value) \
|
|
dc_set_value(dcontext->handle, dcontext->aux_info, dcontext->aux_flags, reg, \
|
|
value)
|
|
|
|
|
|
|
|
void dc_check_dcontext (dc)
|
|
dc_dcontext_t dc;
|
|
/* Check consistency of information supplied to make a dcontext. */
|
|
{
|
|
int i;
|
|
|
|
if ((REG_STATE(dc, 0) != DC_READABLE) || (dc->reg_info[0] != 0))
|
|
dc_error (dc->handle, "Register 0 is misspecified");
|
|
for (i = 1; i < DC_NUM_REG; i++)
|
|
if (REG_STATE(dc, i) == DC_RESERVED)
|
|
dc_error (dc->handle,
|
|
"State for general register %d is incorrect", i);
|
|
for (i = 0; i < DC_NUM_AUX; i++)
|
|
if (AUX_STATE(dc, i) == DC_RESERVED)
|
|
dc_error (dc->handle,
|
|
"State for auxiliary register %d is incorrect", i);
|
|
if (AUX_STATE(dc, DC_AUX_LOC) == DC_INVALID)
|
|
dc_error (dc->handle, "Location is specified as invalid");
|
|
if (GET_AUX_VALUE(dc, DC_AUX_LOC) == 0)
|
|
dc_error (dc->handle, "Location is zero.");
|
|
if (dc->loc_exact >= 3)
|
|
dc_error (dc->handle, "Location exactness is incorrectly specified: %d",
|
|
dc->loc_exact);
|
|
if (dc->psr_ind >= 2)
|
|
dc_error (dc->handle,
|
|
"PSR indirection flag is incorrectly specified: %d",
|
|
dc->psr_ind);
|
|
for (i = 0; i < 32; i++)
|
|
if (PSR_STATE(dc, i) == DC_RESERVED)
|
|
dc_error (dc->handle, "State for PSR bit %d is incorrect", i);
|
|
}
|
|
|
|
|
|
|
|
tdesc_elem_t * dc_tdesc_lookup (loc, tt, tt_size, map_info_in_ptr)
|
|
dc_word_t loc;
|
|
tdesc_table_t tt;
|
|
int tt_size;
|
|
dc_map_info_in_t *map_info_in_ptr;
|
|
/* Return address of tdesc_elem_t for given location, or NULL if
|
|
there is no tdesc chunk for the location.
|
|
*/
|
|
{
|
|
int l = 0;
|
|
int h = tt_size;
|
|
int m;
|
|
|
|
if (tt_size == 0) {
|
|
map_info_in_ptr->flags = 0;
|
|
return (tdesc_elem_t *)NULL;
|
|
}
|
|
for (;;) {
|
|
m = (l + h) / 2;
|
|
if (m == l) break;
|
|
if (loc >= tt[m].start_address)
|
|
l = m;
|
|
else
|
|
h = m;
|
|
}
|
|
if (loc >= tt[m].end_address) {
|
|
map_info_in_ptr->preceding_tdesc_end = tt[m].end_address;
|
|
if (m+1 < tt_size) {
|
|
map_info_in_ptr->following_tdesc_start = tt[m+1].start_address;
|
|
map_info_in_ptr->flags = DC_MII_PRECEDING_TDESC_END |
|
|
DC_MII_FOLLOWING_TDESC_START;
|
|
} else {
|
|
map_info_in_ptr->flags = DC_MII_PRECEDING_TDESC_END;
|
|
}
|
|
return (tdesc_elem_t *)NULL;
|
|
} else if (loc < tt[m].start_address) {
|
|
map_info_in_ptr->following_tdesc_start = tt[m].start_address;
|
|
map_info_in_ptr->flags = DC_MII_FOLLOWING_TDESC_START;
|
|
return (tdesc_elem_t *)NULL;
|
|
} else {
|
|
return (&tt[m]);
|
|
}
|
|
}
|
|
|
|
|
|
|
|
dc_dcontext_t dc_make_dcontext (handle,
|
|
reg_info, reg_flags,
|
|
aux_info, aux_flags, loc_exact,
|
|
psr_info, psr_ind, psr_flags)
|
|
dc_handle_t handle;
|
|
dc_word_t reg_info[DC_NUM_REG];
|
|
dc_word_t reg_flags[2];
|
|
dc_word_t aux_info[DC_NUM_AUX];
|
|
dc_word_t aux_flags[2];
|
|
dc_exactness_t loc_exact;
|
|
dc_word_t psr_info;
|
|
dc_boolean_t psr_ind;
|
|
dc_word_t psr_flags[2];
|
|
{
|
|
dc_dcontext_t dc = (dc_dcontext_t) dc_malloc (handle, sizeof(dcontext_info_t));
|
|
int i;
|
|
dc_map_info_in_t map_info_in;
|
|
|
|
/* Fill in supplied content. */
|
|
dc->handle = ((dc_handle_t)handle);
|
|
for (i = 0; i < DC_NUM_REG; i++) dc->reg_info[i] = reg_info[i];
|
|
for (i = 0; i < 2; i++) dc->reg_flags[i] = reg_flags[i];
|
|
for (i = 0; i < DC_NUM_AUX; i++) dc->aux_info[i] = aux_info[i];
|
|
for (i = 0; i < 2; i++) dc->aux_flags[i] = aux_flags[i];
|
|
dc->loc_exact = loc_exact;
|
|
dc->psr_info = psr_info;
|
|
dc->psr_ind = psr_ind;
|
|
for (i = 0; i < 2; i++) dc->psr_flags[i] = psr_flags[i];
|
|
|
|
dc_check_dcontext(dc);
|
|
|
|
/* Find tdesc information for the text chunk. */
|
|
{
|
|
/***************************************************************/
|
|
/* BUG 8/16/89 Found by hls. Not zeroing EV bits of location. */
|
|
/* SHOULD USE dc_location()! */
|
|
/* dc_word_t loc = GET_AUX_VALUE(dc, DC_AUX_LOC); */
|
|
/***************************************************************/
|
|
dc_word_t loc = GET_AUX_VALUE(dc, DC_AUX_LOC) & ~3;
|
|
tdesc_elem_t *tep =
|
|
dc_tdesc_lookup(loc, ((dc_handle_t)handle)->tdesc_table,
|
|
((dc_handle_t)handle)->tdesc_table_size,&map_info_in);
|
|
if (tep) {
|
|
dc->code_reading = 0;
|
|
dc->info_ptr.tdesc_elem_ptr = tep;
|
|
} else {
|
|
dc->code_reading = 1;
|
|
if (!dc->handle->map_fcn) {
|
|
dc_error (dc->handle, "No tdesc information for %#.8X and no map function supplied.",loc);
|
|
}
|
|
/****************************************************************/
|
|
/* BUG 9/18/89 Found by hls. Not using dc_malloc() */
|
|
/* dc->info_ptr.cr_data_ptr= (dc_cr_data_t *)malloc(sizeof(dc_cr_data_t )); */
|
|
/****************************************************************/
|
|
dc->info_ptr.cr_data_ptr= (dc_cr_data_t *)dc_calloc(dc->handle,1,sizeof(dc_cr_data_t ));
|
|
dc_read_code(loc,dc,map_info_in,dc->info_ptr.cr_data_ptr);
|
|
}
|
|
}
|
|
|
|
return (dc_dcontext_t) dc;
|
|
}
|
|
|
|
|
|
|
|
void dc_free_dcontext (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
{
|
|
/****************************************************************/
|
|
/* BUG 9/19/89 Found by hls. Freeing non-pointer value. */
|
|
/* free((char *)dcontext->code_reading); */
|
|
/****************************************************************/
|
|
if (dcontext->code_reading)
|
|
free((char *)dcontext->info_ptr.cr_data_ptr);
|
|
free((char *)dcontext);
|
|
}
|
|
|
|
|
|
|
|
dc_register_state_t dc_location_state (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
{
|
|
return AUX_STATE(((dc_dcontext_t)dcontext), DC_AUX_LOC);
|
|
}
|
|
|
|
|
|
dc_exactness_t dc_location_exactness (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
{
|
|
return ((dc_dcontext_t)dcontext)->loc_exact;
|
|
}
|
|
|
|
|
|
dc_word_t dc_location (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
/* Return high 30 bits only. */
|
|
{
|
|
/* Don't need: CHECK_AUX_READ (((dc_dcontext_t)dcontext), DC_AUX_LOC); */
|
|
return GET_AUX_VALUE (((dc_dcontext_t)dcontext), DC_AUX_LOC) & ~3;
|
|
}
|
|
|
|
|
|
dc_boolean_t dc_location_in_text_chunk( dcontext, value )
|
|
dc_dcontext_t dcontext;
|
|
dc_word_t value;
|
|
{
|
|
/* Check that new location is still within same text chunk. */
|
|
tdesc_elem_t *tep = ((dc_dcontext_t)dcontext)->info_ptr.tdesc_elem_ptr;
|
|
/********************************************************************/
|
|
/* Bug in predicate -- LS adjusted according to OCS documentation.. */
|
|
/* if ((value < tep->start_address) || (value >= tep->end_address))*/
|
|
/********************************************************************/
|
|
if ((value >= tep->start_address) && (value < tep->end_address))
|
|
return DC_TRUE;
|
|
else
|
|
return DC_FALSE;
|
|
|
|
}
|
|
|
|
|
|
void dc_set_location (dcontext, value)
|
|
dc_dcontext_t dcontext;
|
|
dc_word_t value;
|
|
/* Set high 30 bits only. */
|
|
{
|
|
if (dc_location_in_text_chunk( dcontext, value ) != DC_TRUE)
|
|
dc_warn (((dc_dcontext_t)dcontext)->handle,
|
|
"New location is not in same text chunk.");
|
|
|
|
CHECK_AUX_WRITE (((dc_dcontext_t)dcontext), DC_AUX_LOC);
|
|
dc_write_masked_word (((dc_dcontext_t)dcontext)->handle,
|
|
((dc_dcontext_t)dcontext)->aux_info[DC_AUX_LOC], ~3, value);
|
|
}
|
|
|
|
|
|
|
|
dc_register_state_t dc_general_register_state (dcontext, reg)
|
|
dc_dcontext_t dcontext;
|
|
int reg;
|
|
{
|
|
CHECK_REG (((dc_dcontext_t)dcontext), reg);
|
|
return REG_STATE(((dc_dcontext_t)dcontext), reg);
|
|
}
|
|
|
|
|
|
dc_word_t dc_general_register (dcontext, reg)
|
|
dc_dcontext_t dcontext;
|
|
int reg;
|
|
{
|
|
CHECK_REG (((dc_dcontext_t)dcontext), reg);
|
|
CHECK_REG_READ (((dc_dcontext_t)dcontext), reg);
|
|
return GET_REG_VALUE(((dc_dcontext_t)dcontext), reg);
|
|
}
|
|
|
|
|
|
void dc_set_general_register (dcontext, reg, value)
|
|
dc_dcontext_t dcontext;
|
|
int reg;
|
|
dc_word_t value;
|
|
{
|
|
CHECK_REG (((dc_dcontext_t)dcontext), reg);
|
|
CHECK_REG_WRITE (((dc_dcontext_t)dcontext), reg);
|
|
SET_REG_VALUE (((dc_dcontext_t)dcontext), reg, value);
|
|
}
|
|
|
|
|
|
|
|
dc_register_state_t dc_auxiliary_register_state (dcontext, reg)
|
|
dc_dcontext_t dcontext;
|
|
int reg;
|
|
{
|
|
CHECK_AUX (((dc_dcontext_t)dcontext), reg);
|
|
return AUX_STATE(((dc_dcontext_t)dcontext), reg);
|
|
}
|
|
|
|
|
|
dc_word_t dc_auxiliary_register (dcontext, reg)
|
|
dc_dcontext_t dcontext;
|
|
int reg;
|
|
{
|
|
CHECK_AUX (((dc_dcontext_t)dcontext), reg);
|
|
CHECK_AUX_READ (((dc_dcontext_t)dcontext), reg);
|
|
return GET_AUX_VALUE(((dc_dcontext_t)dcontext), reg);
|
|
}
|
|
|
|
|
|
void dc_set_auxiliary_register (dcontext, reg, value)
|
|
dc_dcontext_t dcontext;
|
|
int reg;
|
|
dc_word_t value;
|
|
{
|
|
CHECK_AUX (((dc_dcontext_t)dcontext), reg);
|
|
CHECK_AUX_WRITE (((dc_dcontext_t)dcontext), reg);
|
|
SET_AUX_VALUE (((dc_dcontext_t)dcontext), reg, value);
|
|
}
|
|
|
|
|
|
|
|
dc_register_state_t dc_psr_register_bit_state (dcontext, bit)
|
|
dc_dcontext_t dcontext;
|
|
int bit;
|
|
{
|
|
CHECK_BIT (((dc_dcontext_t)dcontext), bit);
|
|
return PSR_STATE(((dc_dcontext_t)dcontext), bit);
|
|
}
|
|
|
|
|
|
dc_word_t dc_psr_register (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
{
|
|
if (((dc_dcontext_t)dcontext)->psr_ind) {
|
|
return dc_read_word(((dc_dcontext_t)dcontext)->handle,
|
|
((dc_dcontext_t)dcontext)->psr_info);
|
|
} else {
|
|
return ((dc_dcontext_t)dcontext)->psr_info;
|
|
}
|
|
}
|
|
|
|
|
|
void dc_set_psr_register (dcontext, mask, value)
|
|
dc_dcontext_t dcontext;
|
|
dc_word_t mask;
|
|
dc_word_t value;
|
|
/* Set bits of PSR corresponding to 1 bits in mask. */
|
|
{
|
|
if (((dc_dcontext_t)dcontext)->psr_ind) {
|
|
if (((((dc_dcontext_t)dcontext)->psr_flags[0] & mask) != mask) ||
|
|
((((dc_dcontext_t)dcontext)->psr_flags[1] & mask) != 0))
|
|
dc_error (((dc_dcontext_t)dcontext)->handle,
|
|
"Some PSR bits specified are not writable.");
|
|
dc_write_masked_word (((dc_dcontext_t)dcontext)->handle,
|
|
((dc_dcontext_t)dcontext)->psr_info, mask, value);
|
|
} else {
|
|
dc_error (((dc_dcontext_t)dcontext)->handle, "PSR is not writable.");
|
|
}
|
|
}
|
|
|
|
|
|
|
|
dc_word_t dc_frame_address (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
{
|
|
if (!dcontext->code_reading) {
|
|
tdesc_elem_t *tep = ((dc_dcontext_t)dcontext)->info_ptr.tdesc_elem_ptr;
|
|
return dc_general_register(dcontext,
|
|
tep->info.frame_address_register) + tep->info.frame_address_offset;
|
|
} else {
|
|
if (dcontext->info_ptr.cr_data_ptr->reg_val[DC_REG_FP].reg == DC_REG_SP) {
|
|
return (dc_general_register(dcontext,DC_REG_FP)
|
|
- dcontext->info_ptr.cr_data_ptr->reg_val[DC_REG_FP].off);
|
|
}
|
|
if (dcontext->info_ptr.cr_data_ptr->reg_val[DC_REG_SP].reg == DC_REG_SP) {
|
|
return (dc_general_register(dcontext,DC_REG_SP)
|
|
- dcontext->info_ptr.cr_data_ptr->reg_val[DC_REG_SP].off);
|
|
}
|
|
dc_error (((dc_dcontext_t)dcontext)->handle, "Cannot locate frame pointer.");
|
|
}
|
|
}
|
|
|
|
|
|
|
|
dc_kind_t dc_context_kind (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
{
|
|
return DC_CALL_KIND;
|
|
}
|
|
|
|
|
|
|
|
|
|
/* operations valid for call contexts only */
|
|
|
|
|
|
dc_register_state_t dc_return_address_state (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
{
|
|
tdesc_elem_t *tep = ((dc_dcontext_t)dcontext)->info_ptr.tdesc_elem_ptr;
|
|
int reg;
|
|
|
|
if (!dcontext->code_reading) {
|
|
if (tep->info.return_address_info_discriminant) {
|
|
return DC_WRITABLE;
|
|
} else {
|
|
return REG_STATE(((dc_dcontext_t)dcontext), tep->info.return_address_info);
|
|
}
|
|
} else {
|
|
reg= DC_REG_RA;
|
|
if (bit_test(dcontext->info_ptr.cr_data_ptr->saved,DC_REG_RA)) {
|
|
if (bit_test(dcontext->info_ptr.cr_data_ptr->how,DC_REG_RA)) {
|
|
return DC_WRITABLE;
|
|
} else {
|
|
reg= dcontext->info_ptr.cr_data_ptr->where[DC_REG_RA];
|
|
}
|
|
}
|
|
return REG_STATE(((dc_dcontext_t)dcontext),reg);
|
|
|
|
|
|
}
|
|
}
|
|
|
|
|
|
dc_exactness_t dc_return_address_exactness (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
{
|
|
return DC_MAYBE;
|
|
}
|
|
|
|
|
|
dc_word_t dc_return_address (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
/* Return high 30 bits only. */
|
|
{
|
|
tdesc_elem_t *tep = ((dc_dcontext_t)dcontext)->info_ptr.tdesc_elem_ptr;
|
|
dc_word_t rai = tep->info.return_address_info;
|
|
dc_word_t val;
|
|
int reg;
|
|
|
|
if (!dcontext->code_reading) {
|
|
if (tep->info.return_address_info_discriminant) {
|
|
val = dc_read_word (((dc_dcontext_t)dcontext)->handle,
|
|
dc_frame_address(dcontext) + rai);
|
|
} else {
|
|
val = dc_general_register (dcontext, rai);
|
|
}
|
|
} else {
|
|
reg=DC_REG_RA;
|
|
if (bit_test(dcontext->info_ptr.cr_data_ptr->saved,reg)) {
|
|
if (bit_test(dcontext->info_ptr.cr_data_ptr->how,reg)) {
|
|
val = dc_read_word (((dc_dcontext_t)dcontext)->handle,
|
|
dc_frame_address(dcontext) +
|
|
(dcontext->info_ptr.cr_data_ptr->where[reg]));
|
|
} else {
|
|
reg= dcontext->info_ptr.cr_data_ptr->where[DC_REG_RA];
|
|
val = dc_general_register (dcontext, reg);
|
|
}
|
|
} else {
|
|
val = dc_general_register (dcontext, reg);
|
|
}
|
|
}
|
|
return val & ~3;
|
|
}
|
|
|
|
|
|
void dc_set_return_address (dcontext, value)
|
|
dc_dcontext_t dcontext;
|
|
dc_word_t value;
|
|
/* Set high 30 bits only. */
|
|
{
|
|
if (!dcontext->code_reading) {
|
|
tdesc_elem_t *tep = ((dc_dcontext_t)dcontext)->info_ptr.tdesc_elem_ptr;
|
|
dc_word_t rai = tep->info.return_address_info;
|
|
|
|
if (tep->info.return_address_info_discriminant) {
|
|
dc_write_masked_word (((dc_dcontext_t)dcontext)->handle,
|
|
dc_frame_address(dcontext) + rai, ~3, value);
|
|
} else {
|
|
dc_set_general_register (dcontext, rai,
|
|
(value & ~3) | (dc_general_register(dcontext, rai) & 3));
|
|
}
|
|
} else {
|
|
if (bit_test(dcontext->info_ptr.cr_data_ptr->saved,DC_REG_RA)) {
|
|
if (bit_test(dcontext->info_ptr.cr_data_ptr->how,DC_REG_RA)) {
|
|
dc_write_masked_word (((dc_dcontext_t)dcontext)->handle,
|
|
dc_frame_address(dcontext)
|
|
+ dcontext->info_ptr.cr_data_ptr->where[DC_REG_RA], ~3, value);
|
|
} else {
|
|
dc_set_general_register( dcontext,
|
|
dcontext->info_ptr.cr_data_ptr->where[DC_REG_RA]);
|
|
}
|
|
} else {
|
|
dc_set_general_register( dcontext,
|
|
dcontext->info_ptr.cr_data_ptr->where[DC_REG_RA]);
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
|
|
/* operations valid for save contexts only */
|
|
|
|
/* (none) */
|
|
|
|
|
|
|
|
/* operations valid for exception contexts only */
|
|
|
|
|
|
void dc_get_exception_info (dcontext, handler, datum)
|
|
dc_dcontext_t dcontext;
|
|
dc_word_t *handler;
|
|
dc_word_t *datum;
|
|
{
|
|
dc_error (((dc_dcontext_t)dcontext)->handle,
|
|
"dc_get_exception_info is not yet implemented.");
|
|
}
|
|
|
|
|
|
|
|
/* operations valid for protection contexts only */
|
|
|
|
|
|
void dc_get_protection_info (dcontext, handler, datum)
|
|
dc_dcontext_t dcontext;
|
|
dc_word_t *handler;
|
|
dc_word_t *datum;
|
|
{
|
|
dc_error (((dc_dcontext_t)dcontext)->handle,
|
|
"dc_get_protection_info is not yet implemented.");
|
|
}
|
|
|
|
|
|
|
|
/* operations valid for special contexts only */
|
|
|
|
|
|
void dc_get_special_info (dcontext, kind, datum)
|
|
dc_dcontext_t dcontext;
|
|
dc_word_t *kind;
|
|
dc_word_t *datum;
|
|
{
|
|
dc_error (((dc_dcontext_t)dcontext)->handle,
|
|
"dc_get_special_info is not yet implemented.");
|
|
}
|
|
|
|
|
|
|
|
/* operations valid for all contexts (again) */
|
|
|
|
|
|
dc_dcontext_t dc_previous_dcontext (dcontext)
|
|
dc_dcontext_t dcontext;
|
|
/* Return NULL if there is no previous context. */
|
|
{
|
|
dc_dcontext_t old = (dc_dcontext_t) dcontext;
|
|
dcontext_info_t new; /* to serve as temporary storage only */
|
|
tdesc_elem_t *tep;
|
|
dc_cr_data_t *cdp;
|
|
dc_word_t cfa;
|
|
int rsm;
|
|
dc_word_t offset;
|
|
dc_word_t rai;
|
|
int r;
|
|
|
|
if (dc_return_address_state((dc_dcontext_t)old) == DC_INVALID)
|
|
dc_error (old->handle, "Return address is invalid.");
|
|
|
|
if (dc_return_address((dc_dcontext_t)old) == 0)
|
|
return (dc_dcontext_t)NULL; /* end of the chain */
|
|
|
|
/* Copy over old contents. */
|
|
new = *old;
|
|
|
|
cfa = dc_frame_address(old);
|
|
/* Restore stack pointer. */
|
|
new.reg_info[DC_REG_SP] = cfa;
|
|
SET_READABLE (new.reg_flags, DC_REG_SP);
|
|
|
|
/* Invalidate temporary registers. */
|
|
for (r = 1; r <= 13; r++) SET_INVALID (new.reg_flags, r);
|
|
|
|
if (!old->code_reading) {
|
|
tep = old->info_ptr.tdesc_elem_ptr;
|
|
/* Restore preserved registers. */
|
|
rsm = tep->info.register_save_mask;
|
|
offset = cfa + tep->info.register_save_offset;
|
|
for (r = 14; r <= 30; r++) {
|
|
if (bit_test(rsm, 30-r)) {
|
|
new.reg_info[r] = offset;
|
|
SET_WRITABLE (new.reg_flags, r);
|
|
offset += sizeof(dc_word_t);
|
|
}
|
|
}
|
|
|
|
/* Set location from old return address. */
|
|
rai = tep->info.return_address_info;
|
|
if (tep->info.return_address_info_discriminant) {
|
|
new.aux_info[DC_AUX_LOC] = cfa + rai;
|
|
SET_WRITABLE (new.aux_flags, DC_AUX_LOC);
|
|
} else {
|
|
new.aux_info[DC_AUX_LOC] = old->reg_info[rai];
|
|
ASSIGN_RSTATE (new.aux_flags, DC_AUX_LOC, old->reg_flags, rai);
|
|
}
|
|
} else {
|
|
cdp = old->info_ptr.cr_data_ptr;
|
|
|
|
/* Restore preserved registers. */
|
|
for (r = 14; r <= 30; r++) {
|
|
if (bit_test(cdp->saved,r)) {
|
|
if (bit_test(cdp->how,r)){ /* saved in the frame */
|
|
new.reg_info[r] = cfa+cdp->where[r];
|
|
SET_WRITABLE (new.reg_flags, r);
|
|
} else { /* saved in the in a register */
|
|
new.reg_info[r] = dc_general_register(old,cdp->where[r]);
|
|
ASSIGN_RSTATE (new.aux_flags, r, old->reg_flags, cdp->where[r]);
|
|
}
|
|
} /* not saved, therefore, already valid , no else*/
|
|
}
|
|
|
|
/* Set location from old return address. */
|
|
if (bit_test(cdp->saved,DC_REG_RA)) {
|
|
if (bit_test(cdp->how,DC_REG_RA)){ /* saved in the frame */
|
|
new.aux_info[DC_AUX_LOC] =
|
|
new.reg_info[DC_REG_RA] = cfa+cdp->where[DC_REG_RA];
|
|
SET_WRITABLE (new.reg_flags, DC_REG_RA);
|
|
SET_WRITABLE (new.aux_flags, DC_AUX_LOC);
|
|
} else { /* saved in the in a register */
|
|
new.reg_info[DC_REG_RA] =
|
|
new.aux_info[DC_AUX_LOC] =
|
|
dc_general_register(old,cdp->where[DC_REG_RA]);
|
|
ASSIGN_RSTATE (new.aux_flags, DC_AUX_LOC,
|
|
old->reg_flags, cdp->where[DC_REG_RA]);
|
|
}
|
|
} else { /* not saved, therefore, already valid , set DC_AUX_LOC only*/
|
|
new.aux_info[DC_AUX_LOC] =
|
|
dc_general_register(old,DC_REG_RA);
|
|
ASSIGN_RSTATE (new.aux_flags, DC_AUX_LOC,
|
|
old->reg_flags, DC_REG_RA);
|
|
}
|
|
}
|
|
|
|
/* Invalidate instruction pointers. */
|
|
SET_INVALID (new.aux_flags, DC_AUX_SXIP);
|
|
SET_INVALID (new.aux_flags, DC_AUX_SNIP);
|
|
SET_INVALID (new.aux_flags, DC_AUX_SFIP);
|
|
|
|
/* No change to FCR registers. */
|
|
|
|
/* No change to PSR register. */
|
|
|
|
return dc_make_dcontext ((dc_handle_t)new.handle,
|
|
new.reg_info, new.reg_flags,
|
|
new.aux_info, new.aux_flags, new.loc_exact,
|
|
new.psr_info, new.psr_ind, new.psr_flags);
|
|
}
|
|
|
|
|
|
|
|
/* extensions for nonlocal goto */
|
|
|
|
#if 0
|
|
|
|
typedef
|
|
struct label {
|
|
???
|
|
} label_t;
|
|
|
|
|
|
label_t dc_make_label (dcontext, location)
|
|
dc_dcontext_t dcontext;
|
|
dc_word_t location;
|
|
{
|
|
}
|
|
|
|
#endif
|
|
|
|
/* procedure for reading code */
|
|
|
|
dc_read_code(loc,dc,map_info_in,cdp)
|
|
dc_word_t loc;
|
|
dc_dcontext_t dc;
|
|
dc_cr_data_t *cdp;
|
|
dc_map_info_in_t map_info_in;
|
|
{
|
|
dc_map_info_out_t map_info_out;
|
|
dc_word_t pc;
|
|
dc_boolean_t found_branch=DC_FALSE;
|
|
dc_word_t instr;
|
|
|
|
(*dc->handle->map_fcn)(dc->handle->map_env,loc,map_info_in,&map_info_out);
|
|
if (map_info_out.flags & DC_MIO_ENTRY_POINT
|
|
&& (!(map_info_in.flags & DC_MII_PRECEDING_TDESC_END)
|
|
|| map_info_out.entry_point >= map_info_in.preceding_tdesc_end
|
|
|| map_info_out.flags & DC_MIO_LITERAL_ENTRY_POINT)) {
|
|
dc_init_cr_data(cdp,(tdesc_elem_t *)NULL);
|
|
pc= map_info_out.entry_point;
|
|
} else if (map_info_in.flags & DC_MII_PRECEDING_TDESC_END) {
|
|
/**/
|
|
/* tdesc_lookup gets the tep for the preceeding tdesc information
|
|
/* so we call it with one less than the preceding tdesc end since
|
|
/* tdesc information is exclusive of the ending address
|
|
/**/
|
|
dc_init_cr_data(cdp,
|
|
dc_tdesc_lookup(map_info_in.preceding_tdesc_end-1,
|
|
((dc_handle_t)dc->handle)->tdesc_table,
|
|
((dc_handle_t)dc->handle)->tdesc_table_size,
|
|
&map_info_in));
|
|
pc= map_info_in.preceding_tdesc_end;
|
|
} else {
|
|
dc_error (dc->handle, "Insufficient information for code reading.");
|
|
}
|
|
for (;;pc+=4) {
|
|
if (pc==loc) {
|
|
return (DC_TRUE);
|
|
}
|
|
instr= dc_read_word(dc->handle,pc);
|
|
found_branch= dc_decode_finds_branch(dc,instr);
|
|
if ((map_info_out.flags & DC_MIO_PROLOGUE_END)
|
|
&& (pc==map_info_out.prologue_end)) {
|
|
break;
|
|
}
|
|
if (found_branch) {
|
|
if (DC_MIO_IMPLICIT_PROLOGUE_END & map_info_out.flags) {
|
|
break;
|
|
} else {
|
|
dc_error (dc->handle, "Found branch before end of prologue.");
|
|
}
|
|
}
|
|
}
|
|
if (!(map_info_out.flags & DC_MIO_LITERAL_EPILOGUE_START)
|
|
&& (map_info_out.epilogue_start >= loc
|
|
|| !(map_info_out.flags & DC_MIO_EPILOGUE_START))) {
|
|
return (DC_TRUE);
|
|
}
|
|
dc_correct_cr_data(cdp,dc->handle);
|
|
for (pc=map_info_out.epilogue_start;pc<loc;pc+=4) {
|
|
instr= dc_read_word(dc->handle,pc);
|
|
if (dc_decode_finds_branch(dc,instr)) {
|
|
return (DC_FALSE);
|
|
}
|
|
}
|
|
return (DC_TRUE);
|
|
|
|
}
|
|
|
|
|
|
|
|
dc_init_cr_data(cdp,tep)
|
|
dc_cr_data_t *cdp;
|
|
tdesc_elem_t *tep;
|
|
{
|
|
int reg;
|
|
dc_word_t rai;
|
|
dc_word_t raid;
|
|
dc_word_t rsm;
|
|
dc_word_t frpos;
|
|
|
|
if (tep){
|
|
|
|
/* Start off with all registers undefined and none saved. */
|
|
for (reg = 0; reg < DC_NUM_REG; reg++) {
|
|
cdp->reg_val[reg].reg = DC_UNDEF;
|
|
}
|
|
cdp->saved = 0;
|
|
|
|
/* Overwrite with what tdesc element says. */
|
|
|
|
cdp->reg_val[tep->info.frame_address_register].reg = DC_REG_SP;
|
|
cdp->reg_val[tep->info.frame_address_register].off =
|
|
- tep->info.frame_address_offset;
|
|
|
|
rai = tep->info.return_address_info;
|
|
raid = tep->info.return_address_info_discriminant;
|
|
if (raid || rai != DC_REG_RA) {
|
|
bit_set(cdp->saved,DC_REG_RA);
|
|
bit_assign(cdp->how,DC_REG_RA,raid);
|
|
cdp->where[DC_REG_RA] = rai;
|
|
}
|
|
|
|
rsm = tep->info.register_save_mask;
|
|
frpos = tep->info.register_save_offset;
|
|
for (reg = 14; reg <= 30; reg++) {
|
|
if (bit_test(rsm, 30-reg)) {
|
|
bit_set(cdp->saved,reg);
|
|
bit_set(cdp->how,reg);
|
|
cdp->where[reg] = frpos;
|
|
frpos += sizeof(dc_word_t);
|
|
} else {
|
|
cdp->reg_val[reg].reg = reg;
|
|
cdp->reg_val[reg].off = 0;
|
|
}
|
|
}
|
|
|
|
cdp->reg_val[0].reg = 0; /* guarantee what hardware does */
|
|
cdp->reg_val[0].off = 0;
|
|
|
|
} else {
|
|
/* Each register has its own initial value. */
|
|
for (reg = 0; reg < DC_NUM_REG; reg++) {
|
|
cdp->reg_val[reg].reg = reg;
|
|
cdp->reg_val[reg].off = 0;
|
|
}
|
|
/* No register is yet saved. */
|
|
cdp->saved = 0;
|
|
cdp->how = 0;
|
|
}
|
|
}
|
|
void dc_correct_cr_data(cdp,handle)
|
|
dc_cr_data_t *cdp;
|
|
dc_handle_t handle;
|
|
{
|
|
long sr,r;
|
|
dc_word_t save_regs = 0; /* registers used to save others */
|
|
for (r = 1; r < DC_REG_SP; r++) {
|
|
if (bit_test(cdp->saved,r) && !bit_test(cdp->how,r)) {
|
|
sr = cdp->where[r];
|
|
if (bit_test(save_regs,sr)) {
|
|
dc_error(handle, "Same register used to save two others.");
|
|
}
|
|
bit_set(save_regs,sr);
|
|
}
|
|
}
|
|
for (r = 1; r < DC_REG_FP; r++) {
|
|
if ((r < 14 || bit_test(cdp->saved,r)) && !bit_test(save_regs,r)) {
|
|
cdp->reg_val[r].reg = DC_UNDEF;
|
|
}
|
|
}
|
|
if (bit_test(cdp->saved,DC_REG_FP) &&
|
|
cdp->reg_val[DC_REG_FP].reg == DC_REG_SP) { /* is r30 the far? */
|
|
cdp->reg_val[DC_REG_SP].reg = DC_UNDEF; /* trash sp */
|
|
} else if (cdp->reg_val[DC_REG_SP].reg == DC_REG_SP) { /* is r31 the far? */
|
|
if (bit_test(cdp->saved,DC_REG_FP) && !bit_test(save_regs,DC_REG_FP)) {
|
|
cdp->reg_val[DC_REG_FP].reg = DC_UNDEF; /* trash r30 */
|
|
}
|
|
}
|
|
}
|