Command Handler: Symbol name and address resolver support

Overview

// global functions

te_errno rcf_ch_register_symbol_table(const rcf_symbol_entry* entries);
void* rcf_ch_symbol_addr(const char* name, bool is_func);
const char* rcf_ch_symbol_name(const void* addr);

Detailed Documentation

Global Functions

te_errno rcf_ch_register_symbol_table(const rcf_symbol_entry* entries)

Register symbol table

The entries must point to a static memory, as it is not copied by the function

Parameters:

entries

An array of symbol entries, the last element must have NULL name

void* rcf_ch_symbol_addr(const char* name, bool is_func)

This function may be used by Portable Commands Handler to resolve name of the variable or function to its address if rcf_ch_vread, rcf_ch_vwrite or rcf_ch_call function returns -1. In this case default command processing is performed by caller: it is assumed that variable or function are in TA address space and variable is unsigned 32 bit integer.

Parameters:

name	symbol name
is_func	if `true`, function name is required

Returns:

symbol address or NULL

const char* rcf_ch_symbol_name(const void* addr)

This function may be used by Portable Commands Handler to symbol address to its name.

Parameters:

addr	symbol address

Returns:

symbol name or NULL