target.c File Reference

Include dependency graph for target.c:

Go to the source code of this file.

Data Structures
struct	fast_load

Macros
#define	DEFAULT_HALT_TIMEOUT   5000

Typedefs
typedef int(*	target_write_fn) (struct target *target, target_addr_t address, uint32_t size, uint32_t count, const uint8_t *buffer)
typedef unsigned char	UNIT[2]

Enumerations
enum	nvp_assert { NVP_DEASSERT , NVP_ASSERT }
enum	target_cfg_param {   TCFG_TYPE , TCFG_EVENT , TCFG_WORK_AREA_VIRT , TCFG_WORK_AREA_PHYS ,   TCFG_WORK_AREA_SIZE , TCFG_WORK_AREA_BACKUP , TCFG_ENDIAN , TCFG_COREID ,   TCFG_CHAIN_POSITION , TCFG_DBGBASE , TCFG_RTOS , TCFG_DEFER_EXAMINE ,   TCFG_GDB_PORT , TCFG_GDB_MAX_CONNECTIONS }
enum	verify_mode { IMAGE_TEST = 0 , IMAGE_VERIFY = 1 , IMAGE_CHECKSUM_ONLY = 2 }

Functions
static struct target_list *	__attribute__ ((warn_unused_result))
static void	append_to_list_all_targets (struct target *target)
static void	binprint (struct command_invocation *cmd, const char *text, const uint8_t *buf, int size)
	COMMAND_HANDLER (handle_bp_command)
	COMMAND_HANDLER (handle_dump_image_command)
	COMMAND_HANDLER (handle_fast_load_command)
	COMMAND_HANDLER (handle_fast_load_image_command)
	COMMAND_HANDLER (handle_halt_command)
	COMMAND_HANDLER (handle_load_image_command)
	COMMAND_HANDLER (handle_md_command)
	COMMAND_HANDLER (handle_mw_command)
	COMMAND_HANDLER (handle_poll_command)
	COMMAND_HANDLER (handle_profile_command)
	COMMAND_HANDLER (handle_ps_command)
	COMMAND_HANDLER (handle_rbp_command)
	COMMAND_HANDLER (handle_reg_command)
	COMMAND_HANDLER (handle_reset_command)
	COMMAND_HANDLER (handle_resume_command)
	COMMAND_HANDLER (handle_rwp_command)
	COMMAND_HANDLER (handle_set_reg_command)
	COMMAND_HANDLER (handle_soft_reset_halt_command)
	COMMAND_HANDLER (handle_step_command)
	COMMAND_HANDLER (handle_target_current)
	COMMAND_HANDLER (handle_target_current_state)
	COMMAND_HANDLER (handle_target_debug_reason)
	COMMAND_HANDLER (handle_target_event_list)
	COMMAND_HANDLER (handle_target_examine)
	COMMAND_HANDLER (handle_target_examine_deferred)
	COMMAND_HANDLER (handle_target_halt)
	COMMAND_HANDLER (handle_target_halt_gdb)
	COMMAND_HANDLER (handle_target_init_command)
	COMMAND_HANDLER (handle_target_names)
	COMMAND_HANDLER (handle_target_poll)
	COMMAND_HANDLER (handle_target_read_memory)
	COMMAND_HANDLER (handle_target_reset)
	COMMAND_HANDLER (handle_target_reset_nag)
	COMMAND_HANDLER (handle_target_smp)
	COMMAND_HANDLER (handle_target_types)
	COMMAND_HANDLER (handle_target_wait_state)
	COMMAND_HANDLER (handle_target_was_examined)
	COMMAND_HANDLER (handle_targets_command)
	COMMAND_HANDLER (handle_test_image_command)
	COMMAND_HANDLER (handle_test_mem_access_command)
	COMMAND_HANDLER (handle_verify_image_checksum_command)
	COMMAND_HANDLER (handle_verify_image_command)
	COMMAND_HANDLER (handle_virt2phys_command)
	Translate a virtual address to a physical address. More...
	COMMAND_HANDLER (handle_wait_halt_command)
	COMMAND_HANDLER (handle_wp_command)
static	COMMAND_HELPER (handle_verify_image_command_internal, enum verify_mode verify)
static	COMMAND_HELPER (parse_load_image_command, struct image *image, target_addr_t *min_address, target_addr_t *max_address)
const char *	debug_reason_name (const struct target *t)
static int	default_check_reset (struct target *target)
static int	default_examine (struct target *target)
static int	find_target (struct command_invocation *cmd, const char *name)
static void	free_fastload (void)
struct target *	get_current_target (struct command_context *cmd_ctx)
struct target *	get_current_target_or_null (struct command_context *cmd_ctx)
struct target *	get_target (const char *id)
bool	get_target_reset_nag (void)
static int	get_target_with_common_rtos_type (struct command_invocation *cmd, struct list_head *lh, struct target **result)
static int	handle_bp_command_list (struct command_invocation *cmd)
static int	handle_bp_command_set (struct command_invocation *cmd, target_addr_t addr, uint32_t asid, unsigned int length, int hw)
static int	handle_target (void *priv)
static int	identity_virt2phys (struct target *target, target_addr_t virtual, target_addr_t *physical)
static int	jim_target_configure (Jim_Interp *interp, int argc, Jim_Obj *const *argv)
static int	jim_target_create (Jim_Interp *interp, int argc, Jim_Obj *const *argv)
static int	jim_target_invoke_event (Jim_Interp *interp, int argc, Jim_Obj *const *argv)
static int	jtag_enable_callback (enum jtag_event event, void *priv)
static	LIST_HEAD (empty_smp_targets)
static	LIST_HEAD (target_reset_callback_list)
static	LIST_HEAD (target_trace_callback_list)
static int	no_mmu (struct target *target, int *enabled)
static void	print_wa_layout (struct target *target)
static int	sense_handler (void)
int	target_add_breakpoint (struct target *target, struct breakpoint *breakpoint)
	Add the breakpoint for target. More...
int	target_add_context_breakpoint (struct target *target, struct breakpoint *breakpoint)
	Add the ContextID breakpoint for target. More...
int	target_add_hybrid_breakpoint (struct target *target, struct breakpoint *breakpoint)
	Add the ContextID & IVA breakpoint for target. More...
int	target_add_watchpoint (struct target *target, struct watchpoint *watchpoint)
	Add the watchpoint for target. More...
unsigned int	target_address_bits (struct target *target)
	Return the number of address bits this target supports. More...
target_addr_t	target_address_max (struct target *target)
	Return the highest accessible address for this target. More...
int	target_alloc_working_area (struct target *target, uint32_t size, struct working_area **area)
int	target_alloc_working_area_try (struct target *target, uint32_t size, struct working_area **area)
int	target_arch_state (struct target *target)
int	target_blank_check_memory (struct target *target, struct target_memory_check_block *blocks, int num_blocks, uint8_t erased_value)
uint16_t	target_buffer_get_u16 (struct target *target, const uint8_t *buffer)
void	target_buffer_get_u16_array (struct target *target, const uint8_t *buffer, uint32_t count, uint16_t *dstbuf)
uint32_t	target_buffer_get_u24 (struct target *target, const uint8_t *buffer)
uint32_t	target_buffer_get_u32 (struct target *target, const uint8_t *buffer)
void	target_buffer_get_u32_array (struct target *target, const uint8_t *buffer, uint32_t count, uint32_t *dstbuf)
uint64_t	target_buffer_get_u64 (struct target *target, const uint8_t *buffer)
void	target_buffer_get_u64_array (struct target *target, const uint8_t *buffer, uint32_t count, uint64_t *dstbuf)
void	target_buffer_set_u16 (struct target *target, uint8_t *buffer, uint16_t value)
void	target_buffer_set_u16_array (struct target *target, uint8_t *buffer, uint32_t count, const uint16_t *srcbuf)
void	target_buffer_set_u24 (struct target *target, uint8_t *buffer, uint32_t value)
void	target_buffer_set_u32 (struct target *target, uint8_t *buffer, uint32_t value)
void	target_buffer_set_u32_array (struct target *target, uint8_t *buffer, uint32_t count, const uint32_t *srcbuf)
void	target_buffer_set_u64 (struct target *target, uint8_t *buffer, uint64_t value)
void	target_buffer_set_u64_array (struct target *target, uint8_t *buffer, uint32_t count, const uint64_t *srcbuf)
static void	target_buffer_set_u8 (struct target *target, uint8_t *buffer, uint8_t value)
int	target_call_event_callbacks (struct target *target, enum target_event event)
int	target_call_reset_callbacks (struct target *target, enum target_reset_mode reset_mode)
static int	target_call_timer_callback (struct target_timer_callback *cb, int64_t *now)
int	target_call_timer_callbacks (void)
static int	target_call_timer_callbacks_check_time (int checktime)
int	target_call_timer_callbacks_now (void)
	Invoke this to ensure that e.g. More...
int	target_call_trace_callbacks (struct target *target, size_t len, uint8_t *data)
int	target_checksum_memory (struct target *target, target_addr_t address, uint32_t size, uint32_t *crc)
static int	target_configure (struct jim_getopt_info *goi, struct target *target)
static int	target_create (struct jim_getopt_info *goi)
unsigned int	target_data_bits (struct target *target)
	Return the number of data bits this target supports. More...
const char *	target_debug_reason_str (enum target_debug_reason reason)
static void	target_destroy (struct target *target)
const char *	target_event_name (enum target_event event)
	Return the name of a target event enumeration value. More...
int	target_examine (void)
int	target_examine_one (struct target *target)
	Examine the specified target, letting it perform any Initialisation that requires JTAG access. More...
static int	target_fill_mem (struct target *target, target_addr_t address, target_write_fn fn, unsigned int data_size, uint64_t b, unsigned int c)
void	target_free_all_working_areas (struct target *target)
static void	target_free_all_working_areas_restore (struct target *target, int restore)
int	target_free_working_area (struct target *target, struct working_area *area)
	Free a working area. More...
static int	target_free_working_area_restore (struct target *target, struct working_area *area, int restore)
int	target_gdb_fileio_end (struct target *target, int retcode, int fileio_errno, bool ctrl_c)
	Pass GDB file-I/O response to target after finishing host syscall. More...
static int	target_gdb_fileio_end_default (struct target *target, int retcode, int fileio_errno, bool ctrl_c)
const char *	target_get_gdb_arch (const struct target *target)
	Obtain the architecture for GDB. More...
int	target_get_gdb_fileio_info (struct target *target, struct gdb_fileio_info *fileio_info)
	Obtain file-I/O information from target for GDB to do syscall. More...
static int	target_get_gdb_fileio_info_default (struct target *target, struct gdb_fileio_info *fileio_info)
int	target_get_gdb_reg_list (struct target *target, struct reg **reg_list[], int *reg_list_size, enum target_register_class reg_class)
	Obtain the registers for GDB. More...
int	target_get_gdb_reg_list_noread (struct target *target, struct reg **reg_list[], int *reg_list_size, enum target_register_class reg_class)
	Obtain the registers for GDB, but don't read register values from the target. More...
uint32_t	target_get_working_area_avail (struct target *target)
int	target_halt (struct target *target)
void	target_handle_event (struct target *target, enum target_event e)
void	target_handle_md_output (struct command_invocation *cmd, struct target *target, target_addr_t address, unsigned int size, unsigned int count, const uint8_t *buffer)
bool	target_has_event_action (const struct target *target, enum target_event event)
	Returns true only if the target has a handler for the specified event. More...
int	target_hit_watchpoint (struct target *target, struct watchpoint **hit_watchpoint)
	Find out the just hit watchpoint for target. More...
static int	target_init (struct command_context *cmd_ctx)
static int	target_init_one (struct command_context *cmd_ctx, struct target *target)
static int	target_jim_get_reg (Jim_Interp *interp, int argc, Jim_Obj *const *argv)
static int	target_jim_write_memory (Jim_Interp *interp, int argc, Jim_Obj *const *argv)
static void	target_merge_working_areas (struct target *target)
int	target_poll (struct target *target)
static int	target_process_reset (struct command_invocation *cmd, enum target_reset_mode reset_mode)
static int	target_profiling (struct target *target, uint32_t *samples, uint32_t max_num_samples, uint32_t *num_samples, uint32_t seconds)
int	target_profiling_default (struct target *target, uint32_t *samples, uint32_t max_num_samples, uint32_t *num_samples, uint32_t seconds)
void	target_quit (void)
	Free all the resources allocated by targets and the target layer. More...
int	target_read_buffer (struct target *target, target_addr_t address, uint32_t size, uint8_t *buffer)
static int	target_read_buffer_default (struct target *target, target_addr_t address, uint32_t count, uint8_t *buffer)
int	target_read_memory (struct target *target, target_addr_t address, uint32_t size, uint32_t count, uint8_t *buffer)
	Read count items of size bytes from the memory of target at the address given. More...
int	target_read_phys_memory (struct target *target, target_addr_t address, uint32_t size, uint32_t count, uint8_t *buffer)
int	target_read_u16 (struct target *target, target_addr_t address, uint16_t *value)
int	target_read_u32 (struct target *target, target_addr_t address, uint32_t *value)
int	target_read_u64 (struct target *target, target_addr_t address, uint64_t *value)
int	target_read_u8 (struct target *target, target_addr_t address, uint8_t *value)
int	target_register_commands (struct command_context *cmd_ctx)
int	target_register_event_callback (int(*callback)(struct target *target, enum target_event event, void *priv), void *priv)
int	target_register_reset_callback (int(*callback)(struct target *target, enum target_reset_mode reset_mode, void *priv), void *priv)
int	target_register_timer_callback (int(*callback)(void *priv), unsigned int time_ms, enum target_timer_type type, void *priv)
	The period is very approximate, the callback can happen much more often or much more rarely than specified. More...
int	target_register_trace_callback (int(*callback)(struct target *target, size_t len, uint8_t *data, void *priv), void *priv)
static int	target_register_user_commands (struct command_context *cmd_ctx)
int	target_remove_breakpoint (struct target *target, struct breakpoint *breakpoint)
	Remove the breakpoint for target. More...
int	target_remove_watchpoint (struct target *target, struct watchpoint *watchpoint)
	Remove the watchpoint for target. More...
static void	target_reset_examined (struct target *target)
	Reset the examined flag for the given target. More...
const char *	target_reset_mode_name (enum target_reset_mode reset_mode)
	Return the name of a target reset reason enumeration value. More...
static int	target_restore_working_area (struct target *target, struct working_area *area)
int	target_resume (struct target *target, int current, target_addr_t address, int handle_breakpoints, int debug_execution)
	Make the target (re)start executing using its saved execution context (possibly with some modifications). More...
int	target_run_algorithm (struct target *target, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_param, target_addr_t entry_point, target_addr_t exit_point, unsigned int timeout_ms, void *arch_info)
	Downloads a target-specific native code algorithm to the target, and executes it. More...
int	target_run_flash_async_algorithm (struct target *target, const uint8_t *buffer, uint32_t count, int block_size, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_params, uint32_t buffer_start, uint32_t buffer_size, uint32_t entry_point, uint32_t exit_point, void *arch_info)
	Streams data to a circular buffer on target intended for consumption by code running asynchronously on target. More...
int	target_run_read_async_algorithm (struct target *target, uint8_t *buffer, uint32_t count, int block_size, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_params, uint32_t buffer_start, uint32_t buffer_size, uint32_t entry_point, uint32_t exit_point, void *arch_info)
	This routine is a wrapper for asynchronous algorithms. More...
static int	target_soft_reset_halt (struct target *target)
static void	target_split_working_area (struct working_area *area, uint32_t size)
int	target_start_algorithm (struct target *target, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_params, target_addr_t entry_point, target_addr_t exit_point, void *arch_info)
	Executes a target-specific native code algorithm and leaves it running. More...
const char *	target_state_name (const struct target *t)
	Return the name of this targets current state. More...
int	target_step (struct target *target, int current, target_addr_t address, int handle_breakpoints)
	Step the target. More...
static const char *	target_strerror_safe (int err)
bool	target_supports_gdb_connection (const struct target *target)
	Check if target allows GDB connections. More...
static int	target_timer_callback_periodic_restart (struct target_timer_callback *cb, int64_t *now)
int64_t	target_timer_next_event (void)
	Returns when the next registered event will take place. More...
const char *	target_type_name (const struct target *target)
	Get the target type name. More...
int	target_unregister_event_callback (int(*callback)(struct target *target, enum target_event event, void *priv), void *priv)
int	target_unregister_reset_callback (int(*callback)(struct target *target, enum target_reset_mode reset_mode, void *priv), void *priv)
int	target_unregister_timer_callback (int(*callback)(void *priv), void *priv)
int	target_unregister_trace_callback (int(*callback)(struct target *target, size_t len, uint8_t *data, void *priv), void *priv)
int	target_wait_algorithm (struct target *target, int num_mem_params, struct mem_param *mem_params, int num_reg_params, struct reg_param *reg_params, target_addr_t exit_point, unsigned int timeout_ms, void *arch_info)
	Waits for an algorithm started with target_start_algorithm() to complete. More...
int	target_wait_state (struct target *target, enum target_state state, unsigned int ms)
int	target_write_buffer (struct target *target, target_addr_t address, uint32_t size, const uint8_t *buffer)
static int	target_write_buffer_default (struct target *target, target_addr_t address, uint32_t count, const uint8_t *buffer)
int	target_write_memory (struct target *target, target_addr_t address, uint32_t size, uint32_t count, const uint8_t *buffer)
	Write count items of size bytes to the memory of target at the address given. More...
int	target_write_phys_memory (struct target *target, target_addr_t address, uint32_t size, uint32_t count, const uint8_t *buffer)
int	target_write_phys_u16 (struct target *target, target_addr_t address, uint16_t value)
int	target_write_phys_u32 (struct target *target, target_addr_t address, uint32_t value)
int	target_write_phys_u64 (struct target *target, target_addr_t address, uint64_t value)
int	target_write_phys_u8 (struct target *target, target_addr_t address, uint8_t value)
int	target_write_u16 (struct target *target, target_addr_t address, uint16_t value)
int	target_write_u32 (struct target *target, target_addr_t address, uint32_t value)
int	target_write_u64 (struct target *target, target_addr_t address, uint64_t value)
int	target_write_u8 (struct target *target, target_addr_t address, uint8_t value)
static void	write_data (FILE *f, const void *data, size_t len)
static void	write_gmon (uint32_t *samples, uint32_t sample_num, const char *filename, bool with_range, uint32_t start_address, uint32_t end_address, struct target *target, uint32_t duration_ms)
static void	write_long (FILE *f, int l, struct target *target)
static void	write_string (FILE *f, char *s)

Variables
struct target *	all_targets
static struct fast_load *	fastload
static int	fastload_num
static const struct nvp	nvp_assert []
static struct jim_nvp	nvp_config_opts []
static const struct nvp	nvp_error_target []
static const struct nvp	nvp_reset_modes []
static const struct nvp	nvp_target_debug_reason []
static const struct jim_nvp	nvp_target_endian []
static const struct jim_nvp	nvp_target_event []
static const struct nvp	nvp_target_state []
static const int	polling_interval = TARGET_DEFAULT_POLLING_INTERVAL
static int	power_dropout
static int	run_power_dropout
static int	run_power_restore
static int	run_srst_asserted
static int	run_srst_deasserted
static int	srst_asserted
static const struct command_registration	target_command_handlers []
static struct target_event_callback *	target_event_callbacks
static const struct command_registration	target_exec_command_handlers []
static const struct command_registration	target_instance_command_handlers []
static bool	target_reset_nag = true
static const struct command_registration	target_subcommand_handlers []
static struct target_timer_callback *	target_timer_callbacks
static int64_t	target_timer_next_event_value
static struct target_type *	target_types []

Macro Definition Documentation

DEFAULT_HALT_TIMEOUT

#define DEFAULT_HALT_TIMEOUT   5000

Definition at line 53 of file target.c.

Typedef Documentation

target_write_fn

typedef int(* target_write_fn) (struct target *target, target_addr_t address, uint32_t size, uint32_t count, const uint8_t *buffer)

Definition at line 3468 of file target.c.

UNIT

typedef unsigned char UNIT[2]

Definition at line 4205 of file target.c.

Enumeration Type Documentation

nvp_assert

enum nvp_assert

Enumerator
NVP_DEASSERT
NVP_ASSERT

Definition at line 116 of file target.c.

target_cfg_param

enum target_cfg_param

Enumerator
TCFG_TYPE
TCFG_EVENT
TCFG_WORK_AREA_VIRT
TCFG_WORK_AREA_PHYS
TCFG_WORK_AREA_SIZE
TCFG_WORK_AREA_BACKUP
TCFG_ENDIAN
TCFG_COREID
TCFG_CHAIN_POSITION
TCFG_DBGBASE
TCFG_RTOS
TCFG_DEFER_EXAMINE
TCFG_GDB_PORT
TCFG_GDB_MAX_CONNECTIONS

Definition at line 4871 of file target.c.

verify_mode

enum verify_mode

Enumerator
IMAGE_TEST
IMAGE_VERIFY
IMAGE_CHECKSUM_ONLY

Definition at line 3757 of file target.c.

Function Documentation

__attribute__()

static struct target_list* __attribute__ ( (warn_unused_result)  )

static

Definition at line 5971 of file target.c.

References get_target(), LOG_DEBUG, LOG_ERROR, NULL, and target.

append_to_list_all_targets()

static void append_to_list_all_targets ( struct target *  target )

static

Definition at line 297 of file target.c.

References all_targets, and target.

Referenced by target_create().

binprint()

static void binprint ( struct command_invocation *  cmd, const char *  text, const uint8_t *  buf, int  size  )

static

Definition at line 6321 of file target.c.

References cmd, command_print(), command_print_sameline(), and size.

Referenced by COMMAND_HANDLER().

COMMAND_HANDLER() [1/45]

COMMAND_HANDLER

(

handle_bp_command

)

Definition at line 3987 of file target.c.

References addr, BKPT_HARD, BKPT_SOFT, CMD, CMD_ARGC, CMD_ARGV, COMMAND_PARSE_ADDRESS, COMMAND_PARSE_NUMBER, ERROR_COMMAND_SYNTAX_ERROR, handle_bp_command_list(), handle_bp_command_set(), and length.

COMMAND_HANDLER() [2/45]

COMMAND_HANDLER

(

handle_dump_image_command

)

Definition at line 3695 of file target.c.

References buffer, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ADDRESS, command_print(), duration_elapsed(), duration_kbps(), duration_measure(), duration_start(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, FILEIO_BINARY, fileio_close(), fileio_open(), fileio_size(), fileio_write(), FILEIO_WRITE, get_current_target(), size, and target_read_buffer().

COMMAND_HANDLER() [3/45]

COMMAND_HANDLER

(

handle_fast_load_command

)

Definition at line 6233 of file target.c.

References CMD, CMD_ARGC, CMD_CTX, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, fastload, fastload_num, get_current_target(), length, fast_load::length, LOG_ERROR, size, target_write_buffer(), and timeval_ms().

COMMAND_HANDLER() [4/45]

COMMAND_HANDLER

(

handle_fast_load_image_command

)

Definition at line 6131 of file target.c.

References fast_load::address, imagesection::base_address, buffer, CALL_COMMAND_HANDLER, CMD, CMD_ARGC, CMD_ARGV, command_print(), fast_load::data, duration_elapsed(), duration_kbps(), duration_measure(), duration_start(), ERROR_FAIL, ERROR_OK, fastload, fastload_num, free_fastload(), image_close(), image_open(), image_read_section(), length, fast_load::length, NULL, image::num_sections, offset, image::sections, and imagesection::size.

COMMAND_HANDLER() [5/45]

COMMAND_HANDLER

(

handle_halt_command

)

Definition at line 3250 of file target.c.

References CALL_COMMAND_HANDLER, CMD_ARGC, CMD_ARGV, CMD_CTX, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), LOG_DEBUG, target_halt(), and target::verbose_halt_msg.

COMMAND_HANDLER() [6/45]

COMMAND_HANDLER

(

handle_load_image_command

)

Definition at line 3611 of file target.c.

References imagesection::base_address, buffer, CALL_COMMAND_HANDLER, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, command_print(), duration_elapsed(), duration_kbps(), duration_measure(), duration_start(), ERROR_FAIL, ERROR_OK, get_current_target(), image_close(), image_open(), image_read_section(), length, NULL, image::num_sections, offset, image::sections, imagesection::size, TARGET_ADDR_FMT, and target_write_buffer().

COMMAND_HANDLER() [7/45]

COMMAND_HANDLER

(

handle_md_command

)

Definition at line 3410 of file target.c.

References buffer, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, CMD_NAME, COMMAND_PARSE_ADDRESS, COMMAND_PARSE_NUMBER, count, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, get_current_target(), LOG_ERROR, size, target, target_handle_md_output(), target_read_memory(), and target_read_phys_memory().

COMMAND_HANDLER() [8/45]

COMMAND_HANDLER

(

handle_mw_command

)

Definition at line 3532 of file target.c.

References CMD_ARGC, CMD_ARGV, CMD_CTX, CMD_NAME, COMMAND_PARSE_ADDRESS, COMMAND_PARSE_NUMBER, count, ERROR_COMMAND_SYNTAX_ERROR, get_current_target(), target_fill_mem(), target_write_memory(), and target_write_phys_memory().

COMMAND_HANDLER() [9/45]

COMMAND_HANDLER

(

handle_poll_command

)

Definition at line 3163 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ON_OFF, command_print(), jtag_tap::dotted_name, jtag_tap::enabled, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), jtag_poll_get_enabled(), jtag_poll_set_enabled(), target::tap, target_arch_state(), and target_poll().

COMMAND_HANDLER() [10/45]

COMMAND_HANDLER

(

handle_profile_command

)

Some cores let us sample the PC without the annoying halt/resume step; for example, ARMv7 PCSR. Provide a way to use that more efficient mechanism.

Definition at line 4315 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_NUMBER, command_print(), ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, get_current_target(), LOG_ERROR, offset, target::state, target_halt(), TARGET_HALTED, target_poll(), target_profiling(), target_resume(), TARGET_RUNNING, timeval_ms(), and write_gmon().

COMMAND_HANDLER() [11/45]

COMMAND_HANDLER

(

handle_ps_command

)

Definition at line 6300 of file target.c.

References CMD, CMD_CTX, command_print(), ERROR_OK, ERROR_TARGET_FAILURE, ERROR_TARGET_NOT_HALTED, get_current_target(), LOG_INFO, rtos_type::ps_command, target::rtos, target::state, TARGET_HALTED, target_name(), and rtos::type.

COMMAND_HANDLER() [12/45]

COMMAND_HANDLER

(

handle_rbp_command

)

Definition at line 4031 of file target.c.

References addr, breakpoint_remove(), breakpoint_remove_all(), CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ADDRESS, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), and TARGET_ADDR_FMT.

COMMAND_HANDLER() [13/45]

COMMAND_HANDLER

(

handle_reg_command

)

Definition at line 3021 of file target.c.

References buf_to_hex_str(), CALL_COMMAND_HANDLER, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_NUMBER, command_print(), count, reg::dirty, DIV_ROUND_UP, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, ERROR_TARGET_NOT_EXAMINED, reg::exist, reg_arch_type::get, get_current_target(), reg::hidden, LOG_DEBUG, LOG_ERROR, reg::name, reg_cache::name, reg_cache::next, NULL, reg_cache::num_regs, target::reg_cache, reg_cache::reg_list, register_get_by_name(), reg_arch_type::set, reg::size, target_was_examined(), reg::type, reg::valid, and reg::value.

COMMAND_HANDLER() [14/45]

COMMAND_HANDLER

(

handle_reset_command

)

Definition at line 3285 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, ERROR_COMMAND_SYNTAX_ERROR, nvp::name, nvp_name2value(), nvp_reset_modes, RESET_RUN, RESET_UNKNOWN, target_process_reset(), and nvp::value.

COMMAND_HANDLER() [15/45]

COMMAND_HANDLER

(

handle_resume_command

)

Definition at line 3304 of file target.c.

References addr, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ADDRESS, ERROR_COMMAND_SYNTAX_ERROR, get_current_target(), and target_resume().

COMMAND_HANDLER() [16/45]

COMMAND_HANDLER

(

handle_rwp_command

)

Definition at line 4134 of file target.c.

References addr, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ADDRESS, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), TARGET_ADDR_FMT, watchpoint_remove(), and watchpoint_remove_all().

COMMAND_HANDLER() [17/45]

COMMAND_HANDLER

(

handle_set_reg_command

)

Definition at line 4798 of file target.c.

References CALL_COMMAND_HANDLER, CMD, CMD_ARGC, CMD_CTX, CMD_JIMTCL_ARGV, command_print(), DIV_ROUND_UP, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, reg::exist, get_current_target(), length, LOG_ERROR, target::reg_cache, register_get_by_name(), reg_arch_type::set, reg::size, and reg::type.

COMMAND_HANDLER() [18/45]

COMMAND_HANDLER

(

handle_soft_reset_halt_command

)

Definition at line 3274 of file target.c.

References CMD_CTX, ERROR_OK, get_current_target(), LOG_TARGET_INFO, and target_soft_reset_halt().

COMMAND_HANDLER() [19/45]

COMMAND_HANDLER

(

handle_step_command

)

Definition at line 3324 of file target.c.

References addr, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ADDRESS, ERROR_COMMAND_SYNTAX_ERROR, get_current_target(), LOG_DEBUG, and target_step().

COMMAND_HANDLER() [20/45]

COMMAND_HANDLER

(

handle_target_current

)

Definition at line 5933 of file target.c.

References CMD, CMD_ARGC, CMD_CTX, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target_or_null(), and target_name().

COMMAND_HANDLER() [21/45]

COMMAND_HANDLER

(

handle_target_current_state

)

Definition at line 5457 of file target.c.

References CMD, CMD_ARGC, CMD_CTX, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), and target_state_name().

COMMAND_HANDLER() [22/45]

COMMAND_HANDLER

(

handle_target_debug_reason

)

Definition at line 5469 of file target.c.

References CMD, CMD_ARGC, CMD_CTX, command_print(), target::debug_reason, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, get_current_target(), nvp::name, nvp_target_debug_reason, and nvp_value2name().

COMMAND_HANDLER() [23/45]

COMMAND_HANDLER

(

handle_target_event_list

)

Definition at line 5437 of file target.c.

References target_event_action::body, CMD, CMD_CTX, command_print(), ERROR_OK, target_event_action::event, target::event_action, get_current_target(), target_event_action::next, NULL, target_event_name(), and target_name().

COMMAND_HANDLER() [24/45]

COMMAND_HANDLER

(

handle_target_examine

)

Definition at line 5261 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, command_print(), target::defer_examine, jtag_tap::enabled, ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, target_type::examine, get_current_target(), LOG_INFO, target::tap, target_name(), target_reset_examined(), target_set_examined(), and target::type.

COMMAND_HANDLER() [25/45]

COMMAND_HANDLER

(

handle_target_examine_deferred

)

Definition at line 5309 of file target.c.

References CMD, CMD_ARGC, CMD_CTX, command_print(), target::defer_examine, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, and get_current_target().

COMMAND_HANDLER() [26/45]

COMMAND_HANDLER

(

handle_target_halt

)

Definition at line 5390 of file target.c.

References CMD, CMD_ARGC, CMD_CTX, command_print(), jtag_tap::enabled, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, get_current_target(), target_type::halt, target::tap, and target::type.

COMMAND_HANDLER() [27/45]

COMMAND_HANDLER

(

handle_target_halt_gdb

)

Definition at line 5321 of file target.c.

References CMD_ARGC, CMD_CTX, ERROR_COMMAND_SYNTAX_ERROR, get_current_target(), target_call_event_callbacks(), and TARGET_EVENT_GDB_HALT.

COMMAND_HANDLER() [28/45]

COMMAND_HANDLER

(

handle_target_init_command

)

Definition at line 1562 of file target.c.

References CMD_ARGC, CMD_CTX, command_run_line(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, LOG_DEBUG, LOG_INFO, and target_init().

COMMAND_HANDLER() [29/45]

COMMAND_HANDLER

(

handle_target_names

)

Definition at line 5956 of file target.c.

References all_targets, CMD, CMD_ARGC, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, target::next, and target_name().

COMMAND_HANDLER() [30/45]

COMMAND_HANDLER

(

handle_target_poll

)

Definition at line 5331 of file target.c.

References CMD, CMD_ARGC, CMD_CTX, command_print(), jtag_tap::enabled, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_TARGET_NOT_EXAMINED, get_current_target(), target_type::poll, target::tap, target_was_examined(), and target::type.

COMMAND_HANDLER() [31/45]

COMMAND_HANDLER

(

handle_target_read_memory

)

Definition at line 4403 of file target.c.

References addr, buffer, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_NUMBER, command_print(), command_print_sameline(), count, ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, get_current_target(), LOG_DEBUG, LOG_ERROR, MIN, TARGET_ADDR_FMT, target_buffer_get_u16(), target_buffer_get_u32(), target_buffer_get_u64(), target_read_memory(), target_read_phys_memory(), and width.

COMMAND_HANDLER() [32/45]

COMMAND_HANDLER

(

handle_target_reset

)

Definition at line 5348 of file target.c.

References target_type::assert_reset, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_NUMBER, command_print(), target_type::deassert_reset, target::defer_examine, jtag_tap::enabled, ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, get_current_target(), nvp::name, NULL, NVP_ASSERT, nvp_name2value(), nvp_unknown_command_print(), target::reset_halt, target::tap, target_free_all_working_areas_restore(), target_name(), target_reset_examined(), target::type, and nvp::value.

COMMAND_HANDLER() [33/45]

COMMAND_HANDLER

(

handle_target_reset_nag

)

Definition at line 6293 of file target.c.

References CALL_COMMAND_HANDLER, and target_reset_nag.

COMMAND_HANDLER() [34/45]

COMMAND_HANDLER

(

handle_target_smp

)

Definition at line 6008 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, ERROR_FAIL, ERROR_OK, foreach_smp_target, get_target_with_common_rtos_type(), INIT_LIST_HEAD(), lh(), list_add_tail(), LOG_DEBUG, LOG_ERROR, rtos_smp_init(), target::smp, target::smp_targets, and target_list::target.

COMMAND_HANDLER() [35/45]

COMMAND_HANDLER

(

handle_target_types

)

Definition at line 5945 of file target.c.

References CMD, CMD_ARGC, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, name, and target_types.

COMMAND_HANDLER() [36/45]

COMMAND_HANDLER

(

handle_target_wait_state

)

Definition at line 5404 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_NUMBER, command_print(), jtag_tap::enabled, ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, get_current_target(), nvp::name, NULL, nvp_name2value(), nvp_target_state, nvp_unknown_command_print(), target::tap, target_name(), target_strerror_safe(), target_wait_state(), and nvp::value.

COMMAND_HANDLER() [37/45]

COMMAND_HANDLER

(

handle_target_was_examined

)

Definition at line 5297 of file target.c.

References CMD, CMD_ARGC, CMD_CTX, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), and target_was_examined().

COMMAND_HANDLER() [38/45]

COMMAND_HANDLER

(

handle_targets_command

)

Definition at line 2804 of file target.c.

References all_targets, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, command_print(), jtag_tap::dotted_name, jtag_tap::enabled, target::endianness, ERROR_OK, find_target(), jim_nvp_value2name_simple(), jim_nvp::name, target::next, nvp_target_endian, state, target::tap, target, target_name(), target_state_name(), and target_type_name().

COMMAND_HANDLER() [39/45]

COMMAND_HANDLER

(

handle_test_image_command

)

Definition at line 3912 of file target.c.

References CALL_COMMAND_HANDLER, and IMAGE_TEST.

COMMAND_HANDLER() [40/45]

COMMAND_HANDLER

(

handle_test_mem_access_command

)

Definition at line 6330 of file target.c.

References working_area::address, binprint(), CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_NUMBER, command_print(), command_print_sameline(), count, duration_elapsed(), duration_kbps(), duration_measure(), duration_start(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, ERROR_TARGET_NOT_HALTED, ERROR_TARGET_UNALIGNED_ACCESS, get_current_target(), LOG_ERROR, NULL, offset, size, target::state, target_alloc_working_area(), target_free_working_area(), TARGET_HALTED, target_name(), target_read_memory(), and target_write_memory().

COMMAND_HANDLER() [41/45]

COMMAND_HANDLER

(

handle_verify_image_checksum_command

)

Definition at line 3902 of file target.c.

References CALL_COMMAND_HANDLER, and IMAGE_CHECKSUM_ONLY.

COMMAND_HANDLER() [42/45]

COMMAND_HANDLER

(

handle_verify_image_command

)

Definition at line 3907 of file target.c.

References CALL_COMMAND_HANDLER, and IMAGE_VERIFY.

COMMAND_HANDLER() [43/45]

COMMAND_HANDLER

(

handle_virt2phys_command

)

Translate a virtual address to a physical address.

The low-level target implementation must have logged a detailed error which is forwarded to telnet/GDB session.

Definition at line 4168 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ADDRESS, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), TARGET_ADDR_FMT, target::type, and target_type::virt2phys.

COMMAND_HANDLER() [44/45]

COMMAND_HANDLER

(

handle_wait_halt_command

)

Definition at line 3192 of file target.c.

References CMD_ARGC, CMD_ARGV, CMD_CTX, DEFAULT_HALT_TIMEOUT, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), TARGET_HALTED, and target_wait_state().

COMMAND_HANDLER() [45/45]

COMMAND_HANDLER

(

handle_wp_command

)

Definition at line 4060 of file target.c.

References addr, watchpoint::address, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ADDRESS, COMMAND_PARSE_NUMBER, command_print(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), length, watchpoint::length, LOG_TARGET_ERROR, watchpoint::mask, watchpoint::next, watchpoint::rw, TARGET_ADDR_FMT, type, watchpoint::value, watchpoint_add(), WATCHPOINT_IGNORE_DATA_VALUE_MASK, target::watchpoints, WPT_ACCESS, WPT_READ, and WPT_WRITE.

COMMAND_HELPER() [1/2]

static COMMAND_HELPER ( handle_verify_image_command_internal  , enum verify_mode  verify  )

static

Definition at line 3763 of file target.c.

References addr, imagesection::base_address, image::base_address, image::base_address_set, buffer, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ADDRESS, command_print(), duration_elapsed(), duration_kbps(), duration_measure(), duration_start(), ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, ERROR_SERVER_INTERRUPTED, get_current_target(), image_calculate_checksum(), IMAGE_CHECKSUM_ONLY, image_close(), image_open(), image_read_section(), IMAGE_VERIFY, keep_alive(), LOG_ERROR, NULL, image::num_sections, openocd_is_shutdown_pending(), image::sections, imagesection::size, image::start_address_set, TARGET_ADDR_FMT, target_checksum_memory(), and target_read_buffer().

COMMAND_HELPER() [2/2]

static COMMAND_HELPER ( parse_load_image_command  , struct image *  image, target_addr_t *  min_address, target_addr_t *  max_address  )

static

Definition at line 3579 of file target.c.

References addr, image::base_address, image::base_address_set, CMD_ARGC, CMD_ARGV, COMMAND_PARSE_ADDRESS, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, and image::start_address_set.

debug_reason_name()

const char* debug_reason_name

(

const struct target *

t

)

Definition at line 247 of file target.c.

References target::debug_reason, LOG_ERROR, nvp::name, nvp_target_debug_reason, and nvp_value2name().

Referenced by arm_arch_state(), armv7m_arch_state(), armv8_aarch64_state(), avr32_ap7k_arch_state(), esirisc_arch_state(), hwthread_fill_thread(), lakemont_arch_state(), mips32_arch_state(), mips64_arch_state(), and stm8_arch_state().

default_check_reset()

static int default_check_reset ( struct target *  target )

static

Definition at line 665 of file target.c.

References ERROR_OK.

Referenced by target_init_one().

default_examine()

static int default_examine ( struct target *  target )

static

Definition at line 658 of file target.c.

References ERROR_OK, and target_set_examined().

Referenced by target_init_one().

find_target()

static int find_target ( struct command_invocation *  cmd, const char *  name  )

static

Definition at line 2782 of file target.c.

References cmd, command_print(), jtag_tap::dotted_name, jtag_tap::enabled, ERROR_FAIL, ERROR_OK, get_target(), name, target::tap, and target.

Referenced by COMMAND_HANDLER().

free_fastload()

static void free_fastload ( void  )

static

Definition at line 6121 of file target.c.

References fast_load::data, fastload, fastload_num, and NULL.

Referenced by COMMAND_HANDLER().

get_current_target()

struct target* get_current_target

(

struct command_context *

cmd_ctx

)

Definition at line 458 of file target.c.

References get_current_target_or_null(), LOG_ERROR, and target.

Referenced by COMMAND_HANDLER(), COMMAND_HELPER(), esirisc_trace_analyze(), esirisc_trace_analyze_buffer(), esirisc_trace_analyze_full(), esirisc_trace_analyze_memory(), esirisc_trace_analyze_simple(), esirisc_trace_dump_buffer(), esirisc_trace_dump_memory(), esp32_apptrace_cmd_ctx_init(), esp32_cmd_apptrace_generic(), esp_semihosting_basedir_command(), handle_bp_command_list(), handle_bp_command_set(), hl_transport_init(), jim_target_configure(), jim_target_invoke_event(), target_jim_get_reg(), and target_jim_write_memory().

get_current_target_or_null()

struct target* get_current_target_or_null

(

struct command_context *

cmd_ctx

)

Definition at line 470 of file target.c.

References command_context::current_target, and command_context::current_target_override.

Referenced by COMMAND_HANDLER(), get_current_target(), and tcl_new_connection().

get_target()

struct target* get_target

(

const char *

id

)

Definition at line 433 of file target.c.

References all_targets, ERROR_OK, target::next, NULL, target, and target_name().

Referenced by __attribute__(), COMMAND_HANDLER(), COMMAND_HELPER(), find_target(), FLASH_BANK_COMMAND_HANDLER(), and image_open().

get_target_reset_nag()

bool get_target_reset_nag

(

void

)

Definition at line 6288 of file target.c.

References target_reset_nag.

Referenced by arm7_9_check_reset().

get_target_with_common_rtos_type()

static int get_target_with_common_rtos_type ( struct command_invocation *  cmd, struct list_head *  lh, struct target **  result  )

static

Definition at line 5989 of file target.c.

References cmd, command_print(), ERROR_FAIL, ERROR_OK, foreach_smp_target, lh(), NULL, target::rtos, target, target_list::target, and rtos::type.

Referenced by COMMAND_HANDLER().

handle_bp_command_list()

static int handle_bp_command_list ( struct command_invocation *  cmd )

static

Definition at line 3917 of file target.c.

References breakpoint::address, breakpoint::asid, BKPT_SOFT, target::breakpoints, buf_to_hex_str(), cmd, command_print(), ERROR_OK, get_current_target(), breakpoint::length, breakpoint::next, breakpoint::number, breakpoint::orig_instr, TARGET_ADDR_FMT, and breakpoint::type.

Referenced by COMMAND_HANDLER().

handle_bp_command_set()

static int handle_bp_command_set ( struct command_invocation *  cmd, target_addr_t  addr, uint32_t  asid, unsigned int  length, int  hw  )

static

Definition at line 3952 of file target.c.

References target_type::add_context_breakpoint, target_type::add_hybrid_breakpoint, addr, breakpoint_add(), cmd, command_print(), context_breakpoint_add(), ERROR_OK, ERROR_TARGET_RESOURCE_NOT_AVAILABLE, get_current_target(), hybrid_breakpoint_add(), length, LOG_TARGET_ERROR, TARGET_ADDR_FMT, and target::type.

Referenced by COMMAND_HANDLER().

handle_target()

static int handle_target ( void *  priv )

static

Definition at line 2909 of file target.c.

References all_targets, target::backoff, backoff_timer::count, jtag_tap::enabled, ERROR_OK, is_jtag_poll_safe(), LOG_INFO, LOG_TARGET_ERROR, target::next, polling_interval, power_dropout, priv, run_power_dropout, run_power_restore, run_srst_asserted, run_srst_deasserted, sense_handler(), srst_asserted, target::tap, target, target_call_event_callbacks(), TARGET_EVENT_GDB_HALT, target_examine_one(), target_poll(), target_reset_examined(), target_set_examined(), target_was_examined(), and backoff_timer::times.

Referenced by target_init().

identity_virt2phys()

static int identity_virt2phys ( struct target *  target, target_addr_t  virtual, target_addr_t *  physical  )

static

Definition at line 636 of file target.c.

References ERROR_OK.

Referenced by target_init_one().

jim_target_configure()

static int jim_target_configure ( Jim_Interp *  interp, int  argc, Jim_Obj *const *  argv  )

static

Definition at line 5243 of file target.c.

References jim_getopt_info::argc, jim_getopt_info::argv, current_command_context(), get_current_target(), command_context::interp, jim_getopt_info::interp, jim_getopt_info::is_configure, jim_getopt_setup(), jim_to_command(), command::name, and target_configure().

jim_target_create()

static int jim_target_create ( Jim_Interp *  interp, int  argc, Jim_Obj *const *  argv  )

static

Definition at line 6051 of file target.c.

References jim_getopt_info::argc, jim_getopt_info::argv, jim_getopt_info::interp, jim_getopt_setup(), and target_create().

jim_target_invoke_event()

static int jim_target_invoke_event ( Jim_Interp *  interp, int  argc, Jim_Obj *const *  argv  )

static

Definition at line 5491 of file target.c.

References jim_getopt_info::argc, jim_getopt_info::argv, current_command_context(), get_current_target(), command_context::interp, jim_getopt_info::interp, jim_getopt_nvp(), jim_getopt_nvp_unknown(), jim_getopt_setup(), NULL, nvp_target_event, target_handle_event(), and jim_nvp::value.

jtag_enable_callback()

static int jtag_enable_callback ( enum jtag_event  event, void *  priv  )

static

Definition at line 694 of file target.c.

References jtag_tap::enabled, ERROR_OK, JTAG_TAP_EVENT_ENABLE, jtag_unregister_event_callback(), priv, target::tap, and target_examine_one().

Referenced by target_destroy(), and target_examine().

LIST_HEAD() [1/3]

static LIST_HEAD ( empty_smp_targets  )

static

LIST_HEAD() [2/3]

static LIST_HEAD ( target_reset_callback_list  )

static

LIST_HEAD() [3/3]

static LIST_HEAD ( target_trace_callback_list  )

static

no_mmu()

static int no_mmu ( struct target *  target, int *  enabled  )

static

Definition at line 643 of file target.c.

References ERROR_OK.

Referenced by target_init_one().

print_wa_layout()

static void print_wa_layout ( struct target *  target )

static

Definition at line 1895 of file target.c.

References working_area::address, working_area::backup, working_area::free, LOG_DEBUG, working_area::next, working_area::size, TARGET_ADDR_FMT, and target::working_areas.

Referenced by target_alloc_working_area_try(), target_free_all_working_areas_restore(), and target_free_working_area_restore().

sense_handler()

static int sense_handler ( void  )

static

Definition at line 2856 of file target.c.

References ERROR_OK, jtag_power_dropout(), jtag_srst_asserted(), power_dropout, run_power_dropout, run_power_restore, run_srst_asserted, run_srst_deasserted, srst_asserted, and timeval_ms().

Referenced by handle_target().

target_add_breakpoint()

int target_add_breakpoint	(	struct target *	target,
		struct breakpoint *	breakpoint
	)

Add the breakpoint for target.

This routine is a wrapper for target->type->add_breakpoint.

Definition at line 1293 of file target.c.

References target_type::add_breakpoint, BKPT_HARD, ERROR_TARGET_NOT_HALTED, LOG_TARGET_ERROR, target::state, TARGET_HALTED, breakpoint::type, and target::type.

Referenced by breakpoint_add_internal().

target_add_context_breakpoint()

int target_add_context_breakpoint	(	struct target *	target,
		struct breakpoint *	breakpoint
	)

Add the ContextID breakpoint for target.

This routine is a wrapper for target->type->add_context_breakpoint.

Definition at line 1303 of file target.c.

References target_type::add_context_breakpoint, ERROR_TARGET_NOT_HALTED, LOG_TARGET_ERROR, target::state, TARGET_HALTED, and target::type.

Referenced by context_breakpoint_add_internal().

target_add_hybrid_breakpoint()

int target_add_hybrid_breakpoint	(	struct target *	target,
		struct breakpoint *	breakpoint
	)

Add the ContextID & IVA breakpoint for target.

This routine is a wrapper for target->type->add_hybrid_breakpoint.

Definition at line 1313 of file target.c.

References target_type::add_hybrid_breakpoint, ERROR_TARGET_NOT_HALTED, LOG_TARGET_ERROR, target::state, TARGET_HALTED, and target::type.

Referenced by hybrid_breakpoint_add_internal().

target_add_watchpoint()

int target_add_watchpoint	(	struct target *	target,
		struct watchpoint *	watchpoint
	)

Add the watchpoint for target.

This routine is a wrapper for target->type->add_watchpoint.

Definition at line 1329 of file target.c.

References target_type::add_watchpoint, ERROR_TARGET_NOT_HALTED, LOG_TARGET_ERROR, target::state, TARGET_HALTED, and target::type.

Referenced by watchpoint_add_internal().

target_address_bits()

unsigned int target_address_bits

(

struct target *

target

)

Return the number of address bits this target supports.

This routine is a wrapper for target->type->address_bits.

Definition at line 1453 of file target.c.

References target_type::address_bits, and target::type.

Referenced by stm32x_get_property_addr(), and target_address_max().

target_address_max()

target_addr_t target_address_max

(

struct target *

target

)

Return the highest accessible address for this target.

Definition at line 1444 of file target.c.

References bits, and target_address_bits().

Referenced by gdb_memory_map().

target_alloc_working_area()

int target_alloc_working_area	(	struct target *	target,
		uint32_t	size,
		struct working_area **	area
	)

Definition at line 2060 of file target.c.

References ERROR_TARGET_RESOURCE_NOT_AVAILABLE, LOG_WARNING, size, and target_alloc_working_area_try().

Referenced by aduc702x_write_block(), aducm360_write_block_async(), aducm360_write_block_sync(), arm7_9_bulk_write_memory(), arm_blank_check_memory(), arm_checksum_memory(), arm_code_to_working_area(), armv7m_blank_check_memory(), armv7m_checksum_memory(), bluenrgx_write(), cc26xx_init(), cc3220sf_write(), cfi_intel_write_block(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), COMMAND_HANDLER(), efm32x_write_block(), em357_write_block(), esp_algorithm_load_func_image(), esp_algorithm_run_image(), feroceon_bulk_write_memory(), fespi_write(), fm3_chip_erase(), fm3_erase(), fm3_write_block(), fm4_flash_erase(), fm4_flash_write(), kinetis_disable_wdog_algo(), kinetis_ke_stop_watchdog(), kinetis_ke_write_words(), kinetis_write_block(), lpc2000_iap_working_area_init(), lpc2000_write(), lpc3180_read_page(), lpc3180_write_page(), lpc32xx_read_page(), lpc32xx_write_page(), lpcspifi_erase(), lpcspifi_set_hw_mode(), lpcspifi_write(), max32xxx_write_block(), mdr_write_block(), mips32_blank_check_memory(), mips32_checksum_memory(), mips_m4k_bulk_read_memory(), mips_m4k_bulk_write_memory(), mips_mips64_bulk_write_memory(), mrvlqspi_flash_write(), msp432_init(), niietcm4_write_block(), npcx_init(), nrf5_ll_flash_write(), numicro_writeblock(), pic32mx_write_block(), psoc4_sysreq(), psoc5lp_write(), psoc6_erase(), psoc6_program_row(), riscv_checksum_memory(), rp2040_flash_write(), rp2040_stack_grab_and_prep(), rsl10_ll_flash_erase(), rsl10_ll_flash_write(), rsl10_mass_erase(), scratch_reserve(), sh_qspi_upload_helper(), sim3x_write_block(), sromalgo_prepare(), stellaris_write_block(), stm32l4_write_block(), stm32lx_write_half_pages(), stm32x_write_block(), stm32x_write_block_async(), stm32x_write_block_riscv(), stm8_blank_check_memory(), str9x_write_block(), xmc1xxx_erase(), xmc1xxx_erase_check(), and xmc1xxx_write().

target_alloc_working_area_try()

int target_alloc_working_area_try	(	struct target *	target,
		uint32_t	size,
		struct working_area **	area
	)

Definition at line 1966 of file target.c.

References working_area::address, ALIGN_DOWN, ALIGN_UP, working_area::backup, target::backup_working_area, ERROR_FAIL, ERROR_OK, ERROR_TARGET_RESOURCE_NOT_AVAILABLE, working_area::free, LOG_DEBUG, LOG_ERROR, target_type::mmu, working_area::next, NULL, print_wa_layout(), size, working_area::size, TARGET_ADDR_FMT, target_read_memory(), target_split_working_area(), target::type, working_area::user, target::working_area, target::working_area_phys, target::working_area_phys_spec, target::working_area_size, target::working_area_virt, target::working_area_virt_spec, and target::working_areas.

Referenced by aduc702x_write_block(), aducm360_write_block_async(), aducm360_write_block_sync(), cfi_intel_write_block(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), efm32x_write_block(), em357_write_block(), lpc2900_write(), max32xxx_write_block(), mdr_write_block(), niietcm4_write_block(), pic32mx_write_block(), qspi_read_write_block(), qspi_verify(), sh_qspi_upload_helper(), sim3x_write_block(), stellaris_write_block(), stm32l4_write_block(), stm32lx_write_half_pages(), stm32x_write_block(), stmqspi_blank_check(), str7x_write_block(), str9x_write_block(), and target_alloc_working_area().

target_arch_state()

int target_arch_state

(

struct target *

target

)

Definition at line 2259 of file target.c.

References target_type::arch_state, ERROR_OK, LOG_WARNING, target::state, TARGET_HALTED, and target::type.

Referenced by COMMAND_HANDLER(), and log_target_callback_event_handler().

target_blank_check_memory()

int target_blank_check_memory	(	struct target *	target,
		struct target_memory_check_block *	blocks,
		int	num_blocks,
		uint8_t	erased_value
	)

Definition at line 2511 of file target.c.

References target_type::blank_check_memory, ERROR_FAIL, ERROR_NOT_IMPLEMENTED, LOG_ERROR, target_was_examined(), and target::type.

Referenced by default_flash_blank_check().

target_buffer_get_u16()

uint16_t target_buffer_get_u16	(	struct target *	target,
		const uint8_t *	buffer
	)

Definition at line 334 of file target.c.

References be_to_h_u16(), buffer, target::endianness, le_to_h_u16(), and TARGET_LITTLE_ENDIAN.

Referenced by aarch64_write_cpu_memory_slow(), arm7_9_unset_breakpoint(), arm7_9_write_memory(), arm_semihosting(), cfi_command_val(), cfi_probe(), chibios_update_memory_signature(), COMMAND_HANDLER(), cortex_a_write_cpu_memory_slow(), cortex_m_dcc_read(), esp32_apptrace_core_id_get(), esp32_apptrace_usr_block_len_get(), etm_read_instruction(), etmv1_data(), handle_iod_output(), mips_m4k_unset_breakpoint(), mips_mips16_unset_sdbbp(), nuttx_update_threads(), target_buffer_get_u16_array(), target_handle_md_output(), target_read_u16(), xscale_read_instruction(), and xscale_write_memory().

target_buffer_get_u16_array()

void target_buffer_get_u16_array	(	struct target *	target,
		const uint8_t *	buffer,
		uint32_t	count,
		uint16_t *	dstbuf
	)

Definition at line 401 of file target.c.

References buffer, count, and target_buffer_get_u16().

Referenced by arc_mem_write(), mips_m4k_write_memory(), and mips_mips64_write_memory().

target_buffer_get_u24()

uint32_t target_buffer_get_u24	(	struct target *	target,
		const uint8_t *	buffer
	)

Definition at line 325 of file target.c.

References be_to_h_u24(), buffer, target::endianness, le_to_h_u24(), and TARGET_LITTLE_ENDIAN.

target_buffer_get_u32()

uint32_t target_buffer_get_u32	(	struct target *	target,
		const uint8_t *	buffer
	)

Definition at line 316 of file target.c.

References be_to_h_u32(), buffer, target::endianness, le_to_h_u32(), and TARGET_LITTLE_ENDIAN.

Referenced by aarch64_write_cpu_memory_slow(), arc_get_register(), arc_get_register_value(), arc_mem_write_block16(), arc_mem_write_block8(), arc_restore_context(), arc_resume(), arm7_9_unset_breakpoint(), arm7_9_write_memory(), arm_semihosting(), armv4_5_mmu_translate_va(), armv7m_blank_check_memory(), calcaddr_physfromlin(), cfi_command_val(), cfi_probe(), COMMAND_HANDLER(), cortex_a_write_cpu_memory_slow(), cpu_context_read(), dsp563xx_write_memory_core(), esp_dbgstubs_table_read(), esp_xtensa_apptrace_ctrl_reg_read(), esp_xtensa_apptrace_queue_normal_write(), esp_xtensa_apptrace_queue_reverse_write(), etm_read_instruction(), etmv1_data(), feroceon_bulk_write_memory(), get_buffer(), get_name(), handle_iod_output(), lpc2000_iap_call(), mips_m4k_set_breakpoint(), mips_m4k_unset_breakpoint(), mips_mips64_unset_sdbbp(), nuttx_cortex_m_tcbinfo_stack_read(), nuttx_update_threads(), psoc4_get_family(), qn908x_probe(), rtos_cortex_m_stack_align(), semihosting_get_field(), target_buffer_get_addr(), target_buffer_get_u32_array(), target_checksum_memory(), target_handle_md_output(), target_read_u32(), xmc4xxx_write_page(), xscale_read_instruction(), xscale_write_memory(), xtensa_queue_exec_ins_wide(), and zephyr_get_arm_state().

target_buffer_get_u32_array()

void target_buffer_get_u32_array	(	struct target *	target,
		const uint8_t *	buffer,
		uint32_t	count,
		uint32_t *	dstbuf
	)

Definition at line 393 of file target.c.

References buffer, count, and target_buffer_get_u32().

Referenced by arc_mem_write(), lpc2900_run_bist128(), mips_m4k_bulk_write_memory(), mips_m4k_write_memory(), and mips_mips64_write_memory().

target_buffer_get_u64()

uint64_t target_buffer_get_u64	(	struct target *	target,
		const uint8_t *	buffer
	)

Definition at line 307 of file target.c.

References be_to_h_u64(), buffer, target::endianness, le_to_h_u64(), and TARGET_LITTLE_ENDIAN.

Referenced by aarch64_write_cpu_memory_slow(), calcaddr_physfromlin(), chromium_ec_update_threads(), COMMAND_HANDLER(), read_userrow(), semihosting_get_field(), target_buffer_get_addr(), target_buffer_get_u64_array(), target_handle_md_output(), and target_read_u64().

target_buffer_get_u64_array()

void target_buffer_get_u64_array	(	struct target *	target,
		const uint8_t *	buffer,
		uint32_t	count,
		uint64_t *	dstbuf
	)

Definition at line 385 of file target.c.

References buffer, count, and target_buffer_get_u64().

Referenced by mips_mips64_bulk_write_memory(), and mips_mips64_write_memory().

target_buffer_set_u16()

void target_buffer_set_u16	(	struct target *	target,
		uint8_t *	buffer,
		uint16_t	value
	)

Definition at line 370 of file target.c.

References buffer, target::endianness, h_u16_to_be(), h_u16_to_le(), and TARGET_LITTLE_ENDIAN.

Referenced by aarch64_read_cpu_memory_slow(), arc_mem_write_block16(), COMMAND_HANDLER(), cortex_a_read_cpu_memory_slow(), cortex_m_dcc_read(), stm32x_write_options(), target_buffer_set_u16_array(), target_fill_io(), target_fill_mem(), target_jim_write_memory(), target_write_phys_u16(), target_write_u16(), and xscale_read_memory().

target_buffer_set_u16_array()

void target_buffer_set_u16_array	(	struct target *	target,
		uint8_t *	buffer,
		uint32_t	count,
		const uint16_t *	srcbuf
	)

Definition at line 425 of file target.c.

References buffer, count, and target_buffer_set_u16().

Referenced by mips_m4k_read_memory(), and mips_mips64_read_memory().

target_buffer_set_u24()

void target_buffer_set_u24	(	struct target *	target,
		uint8_t *	buffer,
		uint32_t	value
	)

Definition at line 361 of file target.c.

References buffer, target::endianness, h_u24_to_be(), h_u24_to_le(), and TARGET_LITTLE_ENDIAN.

target_buffer_set_u32()

void target_buffer_set_u32	(	struct target *	target,
		uint8_t *	buffer,
		uint32_t	value
	)

Definition at line 352 of file target.c.

References buffer, target::endianness, h_u32_to_be(), h_u32_to_le(), and TARGET_LITTLE_ENDIAN.

Referenced by aarch64_read_cpu_memory_fast(), aarch64_read_cpu_memory_slow(), arc_get_register(), arc_mem_write_block16(), arc_mem_write_block8(), arc_resume(), arc_save_context(), armv7m_blank_check_memory(), COMMAND_HANDLER(), cortex_a_read_cpu_memory_fast(), cortex_a_read_cpu_memory_slow(), dsp563xx_read_memory_core(), kinetis_fill_fcf(), lpc2000_iap_call(), lpc2000_iap_working_area_init(), mips_m4k_set_breakpoint(), npcx_chip_erase(), npcx_erase(), npcx_write(), nuttx_cortex_m_tcbinfo_stack_read(), or1k_add_breakpoint(), psoc4_protect(), psoc4_sysreq(), psoc4_write(), semihosting_set_field(), sim3x_flash_protect(), stm32l4_write_block(), target_buffer_set_u32_array(), target_checksum_memory(), target_fill_io(), target_fill_mem(), target_jim_write_memory(), target_write_phys_u32(), target_write_u32(), write_long(), xmc4xxx_flash_protect(), and xscale_read_memory().

target_buffer_set_u32_array()

void target_buffer_set_u32_array	(	struct target *	target,
		uint8_t *	buffer,
		uint32_t	count,
		const uint32_t *	srcbuf
	)

Definition at line 417 of file target.c.

References buffer, count, and target_buffer_set_u32().

Referenced by aduc702x_write_block(), aducm360_write_block_async(), aducm360_write_block_sync(), arc_mem_read(), arm7_9_bulk_write_memory(), arm_code_to_working_area(), ath79_spi_bitbang_chunk(), cfi_intel_write_block(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), COMMAND_HANDLER(), feroceon_bulk_write_memory(), lpc2900_write(), mips32_blank_check_memory(), mips32_checksum_memory(), mips_m4k_bulk_read_memory(), mips_m4k_read_memory(), mips_mips64_read_memory(), pic32mx_write_block(), str7x_write_block(), and str9x_write_block().

target_buffer_set_u64()

void target_buffer_set_u64	(	struct target *	target,
		uint8_t *	buffer,
		uint64_t	value
	)

Definition at line 343 of file target.c.

References buffer, target::endianness, h_u64_to_be(), h_u64_to_le(), and TARGET_LITTLE_ENDIAN.

Referenced by aarch64_read_cpu_memory_slow(), COMMAND_HANDLER(), samd_modify_user_row_masked(), semihosting_set_field(), target_buffer_set_u64_array(), target_fill_mem(), target_jim_write_memory(), target_write_phys_u64(), and target_write_u64().

target_buffer_set_u64_array()

void target_buffer_set_u64_array	(	struct target *	target,
		uint8_t *	buffer,
		uint32_t	count,
		const uint64_t *	srcbuf
	)

Definition at line 409 of file target.c.

References buffer, count, and target_buffer_set_u64().

Referenced by mips_mips64_read_memory().

target_buffer_set_u8()

static void target_buffer_set_u8 ( struct target *  target, uint8_t *  buffer, uint8_t  value  )

static

Definition at line 379 of file target.c.

References buffer.

Referenced by target_fill_mem().

target_call_event_callbacks()

int target_call_event_callbacks	(	struct target *	target,
		enum target_event	event
	)

Definition at line 1764 of file target.c.

References target_event_callback::callback, ERROR_OK, LOG_DEBUG, target_event_callbacks, TARGET_EVENT_GDB_HALT, TARGET_EVENT_HALTED, target_event_name(), target_handle_event(), and target_name().

Referenced by aarch64_poll(), aarch64_resume(), aarch64_step(), aarch64_step_restart_smp(), adapter_poll(), adapter_resume(), adapter_step(), arc_exit_debug(), arc_halt(), arc_poll(), arc_resume(), arc_step(), arm11_halt(), arm11_poll(), arm11_resume(), arm11_step(), arm720t_soft_reset_halt(), arm7_9_poll(), arm7_9_resume(), arm7_9_soft_reset_halt(), arm7_9_step(), arm920t_soft_reset_halt(), arm926ejs_soft_reset_halt(), avr32_ap7k_poll(), avr32_ap7k_resume(), COMMAND_HANDLER(), cortex_a_poll(), cortex_a_resume(), cortex_m_poll_one(), cortex_m_poll_smp(), cortex_m_restart_one(), cortex_m_step(), do_resume(), dsp563xx_poll(), dsp563xx_resume(), dsp563xx_step(), esirisc_poll(), esirisc_resume_or_step(), esp32s2_poll(), esp32s2_step(), esp_xtensa_smp_poll(), esp_xtensa_smp_resume(), esp_xtensa_smp_step(), gdb_connection_closed(), gdb_handle_vcont_packet(), gdb_input_inner(), gdb_new_connection(), gdb_target_callback_event_handler(), gdb_v_packet(), halt_finish(), handle_halt(), handle_target(), lakemont_poll(), lakemont_step(), lakemont_update_after_probemode_entry(), mem_ap_deassert_reset(), mem_ap_halt(), mem_ap_step(), mips_m4k_internal_restore(), mips_m4k_poll(), mips_m4k_resume(), mips_m4k_step(), mips_mips64_poll(), mips_mips64_resume(), mips_mips64_step(), or1k_poll(), or1k_resume_or_step(), resume_finish(), riscv_openocd_poll(), riscv_openocd_step(), semihosting_common(), stm8_poll(), stm8_resume(), stm8_step(), target_examine_one(), target_poll(), target_resume(), target_step(), xscale_poll(), xscale_resume(), xscale_step(), xscale_step_inner(), xtensa_chip_poll(), xtensa_resume(), and xtensa_step().

target_call_reset_callbacks()

int target_call_reset_callbacks	(	struct target *	target,
		enum target_reset_mode	reset_mode
	)

Definition at line 1789 of file target.c.

References target_reset_callback::callback, ERROR_OK, target_reset_callback::list, list_for_each_entry, LOG_DEBUG, name, nvp_reset_modes, and nvp_value2name().

Referenced by psoc5lp_nvl_write(), and target_process_reset().

target_call_timer_callback()

static int target_call_timer_callback ( struct target_timer_callback *  cb, int64_t *  now  )

static

Definition at line 1819 of file target.c.

References target_timer_callback::callback, target_timer_callback::priv, target_timer_callback_periodic_restart(), TARGET_TIMER_TYPE_PERIODIC, target_unregister_timer_callback(), and target_timer_callback::type.

Referenced by target_call_timer_callbacks_check_time().

target_call_timer_callbacks()

int target_call_timer_callbacks

(

void

)

Definition at line 1878 of file target.c.

References target_call_timer_callbacks_check_time().

Referenced by esp32_cmd_apptrace_generic(), jim_command_dispatch(), and server_loop().

target_call_timer_callbacks_check_time()

static int target_call_timer_callbacks_check_time ( int  checktime )

static

Definition at line 1830 of file target.c.

References target_timer_callback::callback, ERROR_OK, keep_alive(), target_call_timer_callback(), target_timer_callbacks, target_timer_next_event_value, TARGET_TIMER_TYPE_PERIODIC, and timeval_ms().

Referenced by target_call_timer_callbacks(), and target_call_timer_callbacks_now().

target_call_timer_callbacks_now()

int target_call_timer_callbacks_now

(

void

)

Invoke this to ensure that e.g.

polling timer callbacks happen before a synchronous command completes.

Definition at line 1884 of file target.c.

References target_call_timer_callbacks_check_time().

Referenced by gdb_query_packet(), and target_process_reset().

target_call_trace_callbacks()

int target_call_trace_callbacks	(	struct target *	target,
		size_t	len,
		uint8_t *	data
	)

Definition at line 1802 of file target.c.

References target_trace_callback::callback, ERROR_OK, target_trace_callback::list, and list_for_each_entry.

Referenced by arm_tpiu_swo_poll_trace().

target_checksum_memory()

int target_checksum_memory	(	struct target *	target,
		target_addr_t	address,
		uint32_t	size,
		uint32_t *	crc
	)

Definition at line 2467 of file target.c.

References buffer, target_type::checksum_memory, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, image_calculate_checksum(), LOG_ERROR, size, target_buffer_get_u32(), target_buffer_set_u32(), target_name(), target_read_buffer(), target_was_examined(), and target::type.

Referenced by COMMAND_HELPER(), default_flash_verify(), gdb_query_packet(), and mdr_write().

target_configure()

static int target_configure ( struct jim_getopt_info *  goi, struct target *  target  )

static

Definition at line 4906 of file target.c.

References jim_getopt_info::argc, jim_getopt_info::argv, target::backup_working_area, target_event_action::body, COMMAND_CONFIG, CONNECTION_LIMIT_UNLIMITED, target::coreid, current_command_context(), target::dbgbase, target::dbgbase_set, target::defer_examine, jtag_tap::dotted_name, target::endianness, target_event_action::event, target::event_action, target::gdb_max_connections, target::gdb_port_override, target::has_dap, jim_getopt_info::interp, target_event_action::interp, jim_getopt_info::is_configure, jim_getopt_nvp(), jim_getopt_nvp_unknown(), jim_getopt_obj(), jim_getopt_string(), jim_getopt_wide(), jim_nvp_value2name_simple(), jtag_tap_by_jim_obj(), LOG_INFO, command_context::mode, jim_nvp::name, target_event_action::next, NULL, nvp_config_opts, nvp_target_endian, nvp_target_event, rtos_create(), target::tap, target::tap_configured, target, TARGET_EVENT_TRACE_CONFIG, target_free_all_working_areas(), target_type::target_jim_configure, TARGET_LITTLE_ENDIAN, target_type_name(), TCFG_CHAIN_POSITION, TCFG_COREID, TCFG_DBGBASE, TCFG_DEFER_EXAMINE, TCFG_ENDIAN, TCFG_EVENT, TCFG_GDB_MAX_CONNECTIONS, TCFG_GDB_PORT, TCFG_RTOS, TCFG_TYPE, TCFG_WORK_AREA_BACKUP, TCFG_WORK_AREA_PHYS, TCFG_WORK_AREA_SIZE, TCFG_WORK_AREA_VIRT, target::type, jim_nvp::value, target::working_area_phys, target::working_area_phys_spec, target::working_area_size, target::working_area_virt, and target::working_area_virt_spec.

Referenced by jim_target_configure(), and target_create().

target_create()

static int target_create ( struct jim_getopt_info *  goi )

static

Definition at line 5699 of file target.c.

References append_to_list_all_targets(), target::arch_info, jim_getopt_info::argc, jim_getopt_info::argv, target::backup_working_area, target::breakpoints, command_registration::chain, cmd, target::cmd_name, COMMAND_ANY, COMMAND_REGISTRATION_DONE, target_type::commands, target::coreid, current_command_context(), command_context::current_target, target::dap_configured, target::dbg_msg_enabled, DBG_REASON_UNDEFINED, target::dbgmsg, target::debug_reason, target_type::deinit_target, target::endianness, ERROR_OK, target::gdb_max_connections, target::gdb_port_override, get_current_transport(), target::halt_issued, target::has_dap, jim_getopt_info::interp, jim_getopt_info::is_configure, jim_getopt_obj(), jim_getopt_string(), LOG_DEBUG, LOG_ERROR, LOG_INFO, command_registration::name, name, target_type::name, target::next, NULL, transport::override_target, target::reg_cache, register_commands(), register_commands_override_target(), target::rtos, target::rtos_auto_detect, rtos_destroy(), target::smp_targets, target::state, target::tap, target::tap_configured, target, target_configure(), target_type::target_create, TARGET_ENDIAN_UNKNOWN, target_instance_command_handlers, TARGET_LITTLE_ENDIAN, target_types, TARGET_UNKNOWN, target::trace_info, target::type, target::verbose_halt_msg, target::watchpoints, target::working_area, target::working_area_size, and target::working_areas.

Referenced by jim_target_create().

target_data_bits()

unsigned int target_data_bits

(

struct target *

target

)

Return the number of data bits this target supports.

This routine is a wrapper for target->type->data_bits.

Definition at line 1460 of file target.c.

References target_type::data_bits, and target::type.

Referenced by target_read_buffer_default(), and target_write_buffer_default().

target_debug_reason_str()

const char* target_debug_reason_str

(

enum target_debug_reason

reason

)

Definition at line 6794 of file target.c.

References DBG_REASON_BREAKPOINT, DBG_REASON_DBGRQ, DBG_REASON_EXC_CATCH, DBG_REASON_EXIT, DBG_REASON_NOTHALTED, DBG_REASON_SINGLESTEP, DBG_REASON_UNDEFINED, DBG_REASON_WATCHPOINT, and DBG_REASON_WPTANDBKPT.

Referenced by gdb_last_signal().

target_destroy()

static void target_destroy ( struct target *  target )

static

Definition at line 2182 of file target.c.

References semihosting::basedir, target_event_action::body, breakpoint_remove_all(), target::cmd_name, target_type::deinit_target, target::event_action, target::fileio_info, working_area::free, target::gdb_port_override, target_event_action::interp, jtag_enable_callback(), jtag_unregister_event_callback(), lh(), target_list::lh, list_del(), list_for_each_entry_safe, target_event_action::next, rtos_destroy(), target::semihosting, target::smp, target::smp_targets, target_list::target, target_free_all_working_areas(), target::trace_info, target::type, and watchpoint_remove_all().

Referenced by target_quit().

target_event_name()

const char* target_event_name

(

enum target_event

event

)

Return the name of a target event enumeration value.

Definition at line 275 of file target.c.

References jim_nvp_value2name_simple(), LOG_ERROR, jim_nvp::name, and nvp_target_event.

Referenced by COMMAND_HANDLER(), target_call_event_callbacks(), target_handle_event(), and tcl_target_callback_event_handler().

target_examine()

int target_examine

(

void

)

Definition at line 711 of file target.c.

References all_targets, target::defer_examine, jtag_tap::enabled, ERROR_OK, jtag_enable_callback(), jtag_register_event_callback(), LOG_WARNING, target::next, target::tap, target, target_examine_one(), and target_name().

Referenced by COMMAND_HANDLER().

target_examine_one()

int target_examine_one

(

struct target *

target

)

Examine the specified target, letting it perform any Initialisation that requires JTAG access.

This routine is a wrapper for target->type->examine.

Definition at line 672 of file target.c.

References ERROR_OK, target_type::examine, LOG_TARGET_DEBUG, LOG_TARGET_ERROR, LOG_TARGET_INFO, target_call_event_callbacks(), TARGET_EVENT_EXAMINE_END, TARGET_EVENT_EXAMINE_FAIL, TARGET_EVENT_EXAMINE_START, target_reset_examined(), target_set_examined(), and target::type.

Referenced by arm7_9_deassert_reset(), cortex_m_assert_reset(), esp_xtensa_smp_poll(), handle_target(), hl_assert_reset(), jtag_enable_callback(), and target_examine().

target_fill_mem()

static int target_fill_mem ( struct target *  target, target_addr_t  address, target_write_fn  fn, unsigned int  data_size, uint64_t  b, unsigned int  c  )

static

Definition at line 3471 of file target.c.

References ERROR_FAIL, ERROR_OK, ERROR_SERVER_INTERRUPTED, keep_alive(), LOG_ERROR, openocd_is_shutdown_pending(), target_buffer_set_u16(), target_buffer_set_u32(), target_buffer_set_u64(), and target_buffer_set_u8().

Referenced by COMMAND_HANDLER().

target_free_all_working_areas()

void target_free_all_working_areas

(

struct target *

target

)

Definition at line 2150 of file target.c.

References working_area::backup, working_area::free, NULL, target_free_all_working_areas_restore(), and target::working_areas.

Referenced by aarch64_restore_one(), adapter_resume(), arc_resume(), arm11_resume(), arm7_9_resume(), avr32_ap7k_resume(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), cortex_a_internal_restore(), cortex_m_restore_one(), esirisc_resume_or_step(), esp_algorithm_unload_func_image(), lpc2900_write(), mips_m4k_internal_restore(), mips_mips64_resume(), or1k_resume_or_step(), stm8_resume(), target_configure(), target_destroy(), and xscale_resume().

target_free_all_working_areas_restore()

static void target_free_all_working_areas_restore ( struct target *  target, int  restore  )

static

Definition at line 2126 of file target.c.

References working_area::free, LOG_DEBUG, working_area::next, NULL, print_wa_layout(), target_merge_working_areas(), target_restore_working_area(), working_area::user, and target::working_areas.

Referenced by COMMAND_HANDLER(), and target_free_all_working_areas().

target_free_working_area()

int target_free_working_area	(	struct target *	target,
		struct working_area *	area
	)

Free a working area.

Restore target data if area backup is configured.

Parameters

target
area	Pointer to the area to be freed or NULL

Returns

ERROR_OK if successful; error code if restore failed

Definition at line 2118 of file target.c.

References target_free_working_area_restore().

Referenced by aduc702x_write_block(), aducm360_write_block_async(), aducm360_write_block_sync(), arm_blank_check_memory(), arm_checksum_memory(), armv7m_blank_check_memory(), armv7m_checksum_memory(), bluenrgx_write(), cc26xx_init(), cc26xx_quit(), cc3220sf_write(), cfi_intel_write_block(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), COMMAND_HANDLER(), efm32x_write_block(), em357_write_block(), esp_algorithm_run_image(), fespi_write(), fm3_chip_erase(), fm3_erase(), fm3_write_block(), fm4_flash_erase(), fm4_flash_write(), get_lpc2000_part_id(), kinetis_disable_wdog_algo(), kinetis_ke_stop_watchdog(), kinetis_ke_write_words(), kinetis_write_block(), lpc2000_erase(), lpc2000_iap_blank_check(), lpc2000_iap_working_area_init(), lpc2000_write(), lpc3180_read_page(), lpc3180_write_page(), lpc32xx_read_page(), lpc32xx_write_page(), lpcspifi_erase(), lpcspifi_set_hw_mode(), lpcspifi_write(), max32xxx_write_block(), mdr_write_block(), mips32_blank_check_memory(), mips32_checksum_memory(), mrvlqspi_flash_write(), msp432_init(), msp432_quit(), niietcm4_write_block(), npcx_init(), npcx_quit(), nrf5_ll_flash_write(), numicro_writeblock(), pic32mx_write_block(), psoc4_sysreq(), psoc5lp_write(), psoc6_erase(), psoc6_program_row(), qspi_read_write_block(), qspi_verify(), riscv_checksum_memory(), rp2040_finalize_stack_free(), rp2040_flash_write(), rsl10_ll_flash_erase(), rsl10_ll_flash_write(), rsl10_mass_erase(), scratch_release(), sh_qspi_upload_helper(), sim3x_write_block(), sromalgo_prepare(), sromalgo_release(), stellaris_write_block(), stm32l4_write_block(), stm32lx_write_half_pages(), stm32x_write_block(), stm32x_write_block_async(), stm32x_write_block_riscv(), stm8_blank_check_memory(), stmqspi_blank_check(), str7x_write_block(), str9x_write_block(), xmc1xxx_erase(), xmc1xxx_erase_check(), and xmc1xxx_write().

target_free_working_area_restore()

static int target_free_working_area_restore ( struct target *  target, struct working_area *  area, int  restore  )

static

Definition at line 2086 of file target.c.

References working_area::address, ERROR_OK, working_area::free, LOG_DEBUG, NULL, print_wa_layout(), working_area::size, TARGET_ADDR_FMT, target_merge_working_areas(), target_restore_working_area(), and working_area::user.

Referenced by target_free_working_area().

target_gdb_fileio_end()

int target_gdb_fileio_end	(	struct target *	target,
		int	retcode,
		int	fileio_errno,
		bool	ctrl_c
	)

Pass GDB file-I/O response to target after finishing host syscall.

This routine is a wrapper for target->type->gdb_fileio_end.

Definition at line 1435 of file target.c.

References ERROR_TARGET_NOT_HALTED, target_type::gdb_fileio_end, LOG_TARGET_ERROR, target::state, TARGET_HALTED, and target::type.

Referenced by gdb_fileio_response_packet().

target_gdb_fileio_end_default()

static int target_gdb_fileio_end_default ( struct target *  target, int  retcode, int  fileio_errno, bool  ctrl_c  )

static

Definition at line 2284 of file target.c.

References ERROR_OK.

Referenced by target_init_one().

target_get_gdb_arch()

const char* target_get_gdb_arch

(

const struct target *

target

)

Obtain the architecture for GDB.

This routine is a wrapper for target->type->get_gdb_arch.

Definition at line 1361 of file target.c.

References target_type::get_gdb_arch, NULL, and target::type.

Referenced by gdb_generate_target_description(), and gdb_target_description_supported().

target_get_gdb_fileio_info()

int target_get_gdb_fileio_info	(	struct target *	target,
		struct gdb_fileio_info *	fileio_info
	)

Obtain file-I/O information from target for GDB to do syscall.

This routine is a wrapper for target->type->get_gdb_fileio_info.

Definition at line 1426 of file target.c.

References ERROR_TARGET_NOT_HALTED, target::fileio_info, target_type::get_gdb_fileio_info, LOG_TARGET_ERROR, target::state, TARGET_HALTED, and target::type.

Referenced by gdb_frontend_halted().

target_get_gdb_fileio_info_default()

static int target_get_gdb_fileio_info_default ( struct target *  target, struct gdb_fileio_info *  fileio_info  )

static

Definition at line 2274 of file target.c.

References ERROR_FAIL.

Referenced by target_init_one().

target_get_gdb_reg_list()

int target_get_gdb_reg_list	(	struct target *	target,
		struct reg **	reg_list[],
		int *	reg_list_size,
		enum target_register_class	reg_class
	)

Obtain the registers for GDB.

This routine is a wrapper for target->type->get_gdb_reg_list.

Definition at line 1368 of file target.c.

References ERROR_FAIL, ERROR_OK, target_type::get_gdb_reg_list, LOG_ERROR, NULL, target_was_examined(), and target::type.

Referenced by gdb_get_registers_packet(), gdb_set_registers_packet(), get_current(), hwthread_get_thread_reg_list(), nuttx_getreg_current_thread(), and target_get_gdb_reg_list_noread().

target_get_gdb_reg_list_noread()

int target_get_gdb_reg_list_noread	(	struct target *	target,
		struct reg **	reg_list[],
		int *	reg_list_size,
		enum target_register_class	reg_class
	)

Obtain the registers for GDB, but don't read register values from the target.

This routine is a wrapper for target->type->get_gdb_reg_list_noread.

Definition at line 1390 of file target.c.

References ERROR_OK, target_type::get_gdb_reg_list_noread, target_get_gdb_reg_list(), and target::type.

Referenced by gdb_get_register_packet(), gdb_set_register_packet(), gdb_target_description_supported(), and smp_reg_list_noread().

target_get_working_area_avail()

uint32_t target_get_working_area_avail

(

struct target *

target

)

Definition at line 2164 of file target.c.

References ALIGN_DOWN, working_area::free, working_area::next, size, working_area::size, target::working_area_size, and target::working_areas.

Referenced by armv7m_blank_check_memory(), cc3220sf_write(), fespi_write(), fm4_flash_write(), kinetis_write_block(), lpcspifi_write(), mrvlqspi_flash_write(), psoc5lp_write(), qspi_read_write_block(), rp2040_flash_write(), rsl10_ll_flash_write(), stm32l4_write_block(), stm32x_write_block_async(), stm32x_write_block_riscv(), stmqspi_blank_check(), and xmc1xxx_write().

target_halt()

int target_halt

(

struct target *

target

)

Definition at line 507 of file target.c.

References ERROR_FAIL, ERROR_OK, target_type::halt, target::halt_issued, target::halt_issued_time, LOG_ERROR, target_was_examined(), timeval_ms(), and target::type.

Referenced by arc_assert_reset(), arm11_deassert_reset(), arm720t_soft_reset_halt(), arm7_9_dcc_completion(), arm7_9_deassert_reset(), arm7_9_soft_reset_halt(), arm920t_soft_reset_halt(), arm926ejs_soft_reset_halt(), armv4_5_run_algorithm_completion(), armv7m_wait_algorithm(), cc26xx_quit(), COMMAND_HANDLER(), dsp563xx_assert_reset(), esp32_apptrace_safe_halt_targets(), feroceon_bulk_write_memory(), gdb_input_inner(), handle_reset_halt(), lakemont_reset_deassert(), mips32_run_and_wait(), mips_m4k_assert_reset(), mips_mips64_assert_reset(), msp432_quit(), npcx_quit(), sromalgo_release(), stm32lx_obl_launch(), stm8_reset_assert(), stm8_run_and_wait(), target_profiling_default(), xscale_assert_reset(), and xtensa_wait_algorithm().

target_handle_event()

void target_handle_event	(	struct target *	target,
		enum target_event	e
	)

Definition at line 4667 of file target.c.

References target_event_action::body, current_command_context(), command_context::current_target_override, ERROR_COMMAND_CLOSE_CONNECTION, target_event_action::event, target::event_action, target_event_action::interp, LOG_DEBUG, LOG_TARGET_ERROR, target_event_action::next, NULL, target, target_event_name(), target_name(), and target_type_name().

Referenced by aarch64_assert_reset(), arc_assert_reset(), arm11_assert_reset(), arm7_9_assert_reset(), assert_reset(), COMMAND_HANDLER(), cortex_a_assert_reset(), cortex_m_assert_reset(), jim_target_invoke_event(), mips_m4k_assert_reset(), semihosting_common(), and target_call_event_callbacks().

target_handle_md_output()

void target_handle_md_output	(	struct command_invocation *	cmd,
		struct target *	target,
		target_addr_t	address,
		unsigned int	size,
		unsigned int	count,
		const uint8_t *	buffer
	)

Definition at line 3346 of file target.c.

References buffer, cmd, command_print(), count, LOG_ERROR, output, size, TARGET_ADDR_FMT, target_buffer_get_u16(), target_buffer_get_u32(), and target_buffer_get_u64().

Referenced by COMMAND_HANDLER().

target_has_event_action()

bool target_has_event_action	(	const struct target *	target,
		enum target_event	event
	)

Returns true only if the target has a handler for the specified event.

Definition at line 4860 of file target.c.

Referenced by aarch64_assert_reset(), arc_assert_reset(), arm11_assert_reset(), arm7_9_assert_reset(), assert_reset(), cortex_a_assert_reset(), cortex_m_assert_reset(), and mips_m4k_assert_reset().

target_hit_watchpoint()

int target_hit_watchpoint	(	struct target *	target,
		struct watchpoint **	watchpoint
	)

Find out the just hit watchpoint for target.

This routine is a wrapper for target->type->hit_watchpoint.

Definition at line 1343 of file target.c.

References ERROR_FAIL, ERROR_TARGET_NOT_HALTED, target_type::hit_watchpoint, LOG_TARGET_ERROR, target::state, TARGET_HALTED, and target::type.

Referenced by watchpoint_hit().

target_init()

static int target_init ( struct command_context *  cmd_ctx )

static

Definition at line 1536 of file target.c.

References all_targets, ERROR_OK, handle_target(), command_context::interp, target::next, polling_interval, target, target_init_one(), target_register_timer_callback(), target_register_user_commands(), and TARGET_TIMER_TYPE_PERIODIC.

Referenced by COMMAND_HANDLER().

target_init_one()

static int target_init_one ( struct command_context *  cmd_ctx, struct target *  target  )

static

Definition at line 1476 of file target.c.

References default_check_reset(), default_examine(), ERROR_OK, target_type::gdb_fileio_end, target_type::get_gdb_fileio_info, identity_virt2phys(), LOG_ERROR, LOG_WARNING, no_mmu(), target_type::profiling, target_type::read_buffer, target_gdb_fileio_end_default(), target_get_gdb_fileio_info_default(), target_name(), target_profiling_default(), target_read_buffer_default(), target_reset_examined(), target_write_buffer_default(), type, target::type, and target_type::write_buffer.

Referenced by target_init().

target_jim_get_reg()

static int target_jim_get_reg ( Jim_Interp *  interp, int  argc, Jim_Obj *const *  argv  )

static

Definition at line 4711 of file target.c.

References alloc_printf(), buf_to_hex_str(), current_command_context(), ERROR_OK, reg::exist, reg_arch_type::get, get_current_target(), command_context::interp, length, LOG_ERROR, NULL, target::reg_cache, register_get_by_name(), reg::size, reg::type, reg::valid, and reg::value.

target_jim_write_memory()

static int target_jim_write_memory ( Jim_Interp *  interp, int  argc, Jim_Obj *const *  argv  )

static

Definition at line 4526 of file target.c.

References addr, buffer, count, current_command_context(), ERROR_OK, get_current_target(), command_context::interp, LOG_ERROR, MIN, NULL, TARGET_ADDR_FMT, target_buffer_set_u16(), target_buffer_set_u32(), target_buffer_set_u64(), target_write_memory(), target_write_phys_memory(), and width.

target_merge_working_areas()

static void target_merge_working_areas ( struct target *  target )

static

Definition at line 1938 of file target.c.

References working_area::address, working_area::backup, working_area::free, working_area::next, NULL, working_area::size, and target::working_areas.

Referenced by target_free_all_working_areas_restore(), and target_free_working_area_restore().

target_poll()

int target_poll

(

struct target *

target

)

Definition at line 477 of file target.c.

References DEFAULT_HALT_TIMEOUT, ERROR_FAIL, ERROR_OK, target::halt_issued, target::halt_issued_time, LOG_INFO, target_type::poll, target::state, target_call_event_callbacks(), TARGET_EVENT_GDB_HALT, TARGET_HALTED, target_was_examined(), timeval_ms(), and target::type.

Referenced by ambiqmicro_exec_command(), arm7_9_deassert_reset(), COMMAND_HANDLER(), cortex_m_profiling(), esp32_apptrace_wait4halt(), esp_xtensa_profiling(), gdb_handle_vcont_packet(), gdb_input_inner(), handle_target(), or1k_profiling(), stm32lx_obl_launch(), target_profiling_default(), and target_wait_state().

target_process_reset()

static int target_process_reset ( struct command_invocation *  cmd, enum target_reset_mode  reset_mode  )

static

Definition at line 593 of file target.c.

References all_targets, target_type::check_reset, cmd, command_print(), ERROR_FAIL, jtag_poll_mask(), jtag_poll_unmask(), LOG_ERROR, nvp::name, target::next, NULL, nvp_reset_modes, nvp_value2name(), target::running_alg, target, target_call_reset_callbacks(), target_call_timer_callbacks_now(), and target::type.

Referenced by COMMAND_HANDLER().

target_profiling()

static int target_profiling ( struct target *  target, uint32_t *  samples, uint32_t  max_num_samples, uint32_t *  num_samples, uint32_t  seconds  )

static

Definition at line 1467 of file target.c.

References target_type::profiling, and target::type.

Referenced by COMMAND_HANDLER().

target_profiling_default()

int target_profiling_default	(	struct target *	target,
		uint32_t *	samples,
		uint32_t	max_num_samples,
		uint32_t *	num_samples,
		uint32_t	seconds
	)

Definition at line 2290 of file target.c.

References alive_sleep(), buf_get_u32(), ERROR_OK, gettimeofday(), LOG_INFO, NULL, target::reg_cache, register_get_by_name(), target::state, target_halt(), TARGET_HALTED, target_poll(), target_resume(), TARGET_RUNNING, timeval_add_time(), timeval_compare(), and reg::value.

Referenced by cortex_m_profiling(), esp_xtensa_profiling(), and target_init_one().

target_quit()

void target_quit

(

void

)

Free all the resources allocated by targets and the target layer.

Definition at line 2230 of file target.c.

References all_targets, target::next, target_event_callback::next, target_timer_callback::next, NULL, target, target_destroy(), target_event_callbacks, and target_timer_callbacks.

Referenced by server_quit().

target_read_buffer()

int target_read_buffer	(	struct target *	target,
		target_addr_t	address,
		uint32_t	size,
		uint8_t *	buffer
	)

Definition at line 2407 of file target.c.

References buffer, ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, target_type::read_buffer, size, TARGET_ADDR_FMT, target_was_examined(), and target::type.

Referenced by arc_read_instruction_u32(), arc_set_breakpoint(), arm_nandread(), armv4_5_run_algorithm_inner(), armv7m_blank_check_memory(), armv7m_wait_algorithm(), cc3220sf_write(), chibios_update_memory_signature(), chibios_update_threads(), chromium_ec_detect_rtos(), chromium_ec_update_threads(), COMMAND_HANDLER(), COMMAND_HELPER(), default_flash_read(), dsp563xx_run_algorithm(), ecos_get_thread_reg_list(), ecos_update_threads(), efm32x_write_lock_data(), embkernel_get_tasks_details(), embkernel_get_thread_reg_list(), embkernel_update_threads(), eneispif_read_flash_id(), esp32_soc_reset(), esp32s3_soc_reset(), esp_dbgstubs_table_read(), esp_xtensa_dbgstubs_info_update(), freertos_update_threads(), gdb_read_memory_packet(), get_stacking_info_arm926ejs(), hwthread_read_buffer(), image_read_section(), imx31_read_page(), mips32_run_algorithm(), mqx_target_read_buffer(), mxc_read_page(), nuttx_cortex_m_tcbinfo_stack_read(), nuttx_update_threads(), read_channel_name(), read_from_channel(), read_rtt_channel(), riot_update_threads(), riscv_hit_watchpoint(), rtkernel_add_task(), rtos_generic_stack_read(), semihosting_common(), sh_qspi_read(), stm8_run_algorithm(), stmqspi_blank_check(), target_checksum_memory(), target_rtt_find_control_block(), target_rtt_read_control_block(), target_run_read_async_algorithm(), threadx_get_thread_reg_list(), threadx_update_threads(), tms470_erase_check(), ucos_iii_update_threads(), xtensa_sw_breakpoint_add(), xtensa_wait_algorithm(), and zephyr_fetch_thread().

target_read_buffer_default()

static int target_read_buffer_default ( struct target *  target, target_addr_t  address, uint32_t  count, uint8_t *  buffer  )

static

Definition at line 2431 of file target.c.

References buffer, count, ERROR_OK, size, target_data_bits(), and target_read_memory().

Referenced by target_init_one().

target_read_memory()

int target_read_memory	(	struct target *	target,
		target_addr_t	address,
		uint32_t	size,
		uint32_t	count,
		uint8_t *	buffer
	)

Read count items of size bytes from the memory of target at the address given.

This routine is a wrapper for target->type->read_memory.

Definition at line 1237 of file target.c.

References buffer, count, ERROR_FAIL, LOG_ERROR, target_type::read_memory, size, target_name(), target_was_examined(), and target::type.

Referenced by aarch64_set_breakpoint(), arm7_9_set_breakpoint(), arm7_9_unset_breakpoint(), arm920t_write_memory(), arm_semihosting(), cfi_target_read_memory(), COMMAND_HANDLER(), cortex_a_read_buffer(), cortex_a_set_breakpoint(), cortex_m_set_breakpoint(), default_flash_mem_blank_check(), esirisc_trace_read_memory(), esp_algorithm_read_stub_logs(), esp_xtensa_semihosting(), kinetis_write(), linux_read_memory(), lpc2900_read_security_status(), lpc2900_run_bist128(), lpc3180_read_page(), lpc32xx_read_page_mlc(), lpc32xx_read_page_slc(), lpc32xx_write_page_slc(), mips_m4k_set_breakpoint(), mips_m4k_unset_breakpoint(), mips_mips16_set_sdbbp(), mips_mips16_unset_sdbbp(), mips_mips64_set_sdbbp(), mips_mips64_unset_sdbbp(), psoc4_get_family(), psoc4_protect_check(), qn908x_get_info(), qn908x_probe(), qn908x_read_page_lock(), read_by_given_size(), read_userrow(), sam3_page_read(), sam4_page_read(), sam4l_write_page_partial(), samd_modify_user_row_masked(), same5_modify_user_row_masked(), samv_page_read(), semihosting_common(), semihosting_read_fields(), stm8_unset_breakpoint(), target_alloc_working_area_try(), target_read_buffer_default(), target_read_u16(), target_read_u32(), target_read_u64(), target_read_u8(), ucos_iii_find_last_thread_address(), ucos_iii_get_thread_reg_list(), ucos_iii_update_thread_offsets(), ucos_iii_update_threads(), write_by_given_size(), xscale_set_breakpoint(), and xtensa_fileio_detect_proc().

target_read_phys_memory()

int target_read_phys_memory	(	struct target *	target,
		target_addr_t	address,
		uint32_t	size,
		uint32_t	count,
		uint8_t *	buffer
	)

Definition at line 1251 of file target.c.

References buffer, count, ERROR_FAIL, LOG_ERROR, target_type::read_phys_memory, size, target_name(), target_was_examined(), and target::type.

Referenced by COMMAND_HANDLER(), and linux_read_memory().

target_read_u16()

int target_read_u16	(	struct target *	target,
		target_addr_t	address,
		uint16_t *	value
	)

Definition at line 2574 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_buffer_get_u16(), target_read_memory(), target_was_examined(), and reg::value.

Referenced by arc_set_breakpoint(), arc_unset_breakpoint(), arm7_9_set_breakpoint(), arm_semihosting(), arm_simulate_step_core(), COMMAND_HANDLER(), cortex_m_erratum_check_breakpoint(), do_data_output(), ecc_status_v1(), ecc_status_v2(), efm32x_get_flash_size(), efm32x_get_part_num(), efm32x_get_ram_size(), get_next_byte_from_sram_buffer(), get_next_halfword_from_sram_buffer(), imx31_init(), imx31_nand_ready(), imx31_write_page(), initialize_nf_controller(), kinetis_disable_wdog_kx(), lpc3180_read_data(), mips_m4k_set_breakpoint(), mips_mips16_set_sdbbp(), mxc_init(), mxc_nand_ready(), mxc_read_page(), mxc_write_page(), nuttx_cortex_m_tcbinfo_stack_read(), nuttx_getregs_fromstack(), nuttx_update_threads(), poll_for_complete_op(), riot_update_threads(), rp2040_lookup_symbol(), rtkernel_add_task(), samd_check_error(), samd_protect_check(), same5_wait_and_check_error(), stm32l4_probe(), stm32lx_probe(), stm32x_get_flash_size(), stm32x_probe(), str9x_protect_check(), ucos_iii_update_threads(), xmc1xxx_erase_check(), and xmc1xxx_nvm_check_idle().

target_read_u32()

int target_read_u32	(	struct target *	target,
		target_addr_t	address,
		uint32_t *	value
	)

Definition at line 2550 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_buffer_get_u32(), target_read_memory(), target_was_examined(), and reg::value.

Referenced by adapter_debug_entry(), aducm360_check_flash_completion(), aducm360_mass_erase(), aducm360_page_erase(), aducm360_set_write_enable(), aducm360_write_modified(), ambiqmicro_read_part_info(), arm7_9_resume(), arm7_9_set_breakpoint(), arm7_9_step(), arm_semihosting(), arm_simulate_step_core(), armv7m_trace_itm_config(), at91sam7_get_flash_status(), at91sam7_read_clock_info(), at91sam7_read_part_info(), at91sam9_nand_ready(), at91sam9_read_page(), at91sam9_write_page(), bluenrgx_probe(), bluenrgx_read_flash_reg(), bluenrgx_write(), call_sromapi(), cc26xx_probe(), cc26xx_wait_algo_done(), cc3220sf_erase(), cc3220sf_mass_erase(), check_flash_status(), chibios_get_thread_reg_list(), chibios_update_stacking(), chibios_update_threads(), chromium_ec_get_current_task_ptr(), chromium_ec_get_num_tasks(), chromium_ec_get_thread_reg_list(), chromium_ec_update_threads(), clrsetbits_u32(), COMMAND_HANDLER(), cortex_m_dwt_get_reg(), cortex_m_dwt_setup(), cortex_m_enable_fpb(), cortex_m_examine(), cortex_m_has_tz(), cortex_m_hit_watchpoint(), cortex_m_profiling(), davinci_init(), davinci_nand_ready(), davinci_read_block_data(), davinci_write_page_ecc1(), davinci_write_page_ecc4(), davinci_write_page_ecc4infix(), efc_get_result(), efc_get_status(), efm32x_read_lock_data(), efm32x_read_reg_u32(), em357_get_flash_status(), em357_protect(), em357_protect_check(), em357_read_options(), eneispif_read_reg(), esirisc_flash_check_status(), esirisc_flash_disable_protect(), esirisc_flash_enable_protect(), esirisc_flash_wait(), esp32s2_disable_wdts(), esp32s2_set_peri_reg_mask(), esp32s3_disable_wdts(), esp_algorithm_read_stub_logs(), fespi_read_reg(), flashd_read_uid(), fm3_chip_erase(), fm3_erase(), fm4_enter_flash_cpu_programming_mode(), fm4_enter_flash_cpu_rom_mode(), freertos_get_thread_reg_list(), freertos_update_threads(), handle_reset_halt(), imx31_init(), ipc_acquire(), ipc_poll_lock_stat(), is_flash_protected(), kinetis_disable_wdog32(), kinetis_ke_probe(), kinetis_probe_chip(), kinetis_probe_chip_s32k(), kinetis_protect_check(), kinetis_read_pmstat(), lpc2000_iap_call(), lpc2900_probe(), lpc2900_wait_status(), lpc3180_controller_ready(), lpc3180_cycle_time(), lpc3180_nand_ready(), lpc3180_read_data(), lpc3180_read_page(), lpc3180_tc_ready(), lpc32xx_controller_ready(), lpc32xx_cycle_time(), lpc32xx_dma_ready(), lpc32xx_nand_ready(), lpc32xx_read_data(), lpc32xx_read_page_mlc(), lpc32xx_tc_ready(), max32xxx_erase(), max32xxx_flash_op_post(), max32xxx_flash_op_pre(), max32xxx_mass_erase(), max32xxx_probe(), max32xxx_protect(), max32xxx_protect_check(), max32xxx_write(), mdr_erase(), mdr_mass_erase(), mdr_read(), mdr_write(), mips32_configure_break_unit(), mips32_configure_dbs(), mips32_configure_ibs(), mips32_enable_interrupts(), mips32_read_config_regs(), mips_m4k_examine_debug_reason(), mips_m4k_set_breakpoint(), mips_mips64_set_sdbbp(), mrvlqspi_fifo_flush(), mrvlqspi_read_byte(), mrvlqspi_set_conf(), mrvlqspi_set_ss_state(), mrvlqspi_start_transfer(), mrvlqspi_stop_transfer(), msp432_probe(), msp432_wait_inactive(), msp432_wait_return_code(), mxc_init(), niietcm4_dump_uflash_page(), niietcm4_opstatus_check(), niietcm4_probe(), niietcm4_probe_k1921vk01t(), niietcm4_protect_check(), niietcm4_uopstatus_check(), npcx_get_flash_id(), nrf51_get_ram_size(), nrf51_protect_check_clenr0(), nrf51_protect_clenr0(), nrf52_protect_check_bprot(), nrf5_erase_page(), nrf5_nvmc_read_u32(), nrf5_probe_chip(), nrf5_read_ficr_info_part(), nrf5_read_ficr_more_info(), nuc910_nand_ready(), numicro_erase(), numicro_fmc_cmd(), numicro_get_cpu_type(), numicro_init_isp(), numicro_reg_unlock(), numicro_write(), nuttx_getregs_fromstack(), nuttx_update_threads(), pic32mx_get_flash_status(), pic32mx_probe(), pic32mx_protect_check(), poll_busy(), psoc4_get_silicon_id(), psoc4_probe(), psoc4_sysreq(), psoc4_test_flash_wounding(), psoc5lp_eeprom_probe(), psoc5lp_get_device_id(), psoc6_probe(), qn908x_busy_check(), qn908x_get_info(), qn908x_init_flash(), qn908x_load_lock_stat(), qn908x_probe(), qn908x_status_check(), qn908x_update_reg(), read_flash_id(), read_sfdp_block(), read_status_reg(), riot_get_thread_reg_list(), riot_update_threads(), rp2040_lookup_symbol(), rp2040_spi_read_flash_id(), rp2040_ssel_active(), rpc_hf_mode(), rpc_hf_wait_tend(), rpc_hf_xfer(), rsl10_check_device(), rsl10_ll_flash_erase(), rsl10_ll_flash_write(), rsl10_mass_erase(), rsl10_protect(), rsl10_protect_check(), rtkernel_add_task(), rtkernel_get_thread_reg_list(), rtkernel_update_threads(), rtkernel_verify_task(), s3c2440_read_block_data(), s6e2cc_probe(), sam3_page_write(), sam3_read_this_reg(), sam4_read_this_reg(), sam4_set_wait(), sam4l_check_page_erased(), sam4l_flash_check_error(), sam4l_flash_command(), sam4l_flash_wait_until_ready(), sam4l_probe(), sam4l_protect_check(), samd_get_flash_page_info(), samd_get_reservedmask(), samd_modify_user_row_masked(), samd_probe(), samd_write(), same5_pre_write_check(), same5_probe(), same5_protect_check(), samv_efc_get_result(), samv_efc_get_status(), samv_get_device_id(), sim3x_erase_page(), sim3x_flash_erase(), sim3x_flash_lock_check(), sim3x_read_deviceid(), sim3x_read_info(), ssp_read_reg(), stellaris_erase(), stellaris_mass_erase(), stellaris_protect(), stellaris_protect_check(), stellaris_read_clock_info(), stellaris_read_part_info(), stellaris_write(), stm32l4_read_flash_reg(), stm32l4_read_idcode(), stm32lx_enable_write_half_page(), stm32lx_get_flash_status(), stm32lx_lock_program_memory(), stm32lx_mass_erase(), stm32lx_protect_check(), stm32lx_read_id_code(), stm32lx_unlock_options_bytes(), stm32lx_unlock_program_memory(), stm32x_get_device_id(), stm32x_get_flash_status(), stm32x_probe(), stm32x_protect_check(), stm32x_read_flash_reg(), stm32x_read_id_code(), stm32x_read_options(), stm32x_unlock_option_reg(), stm32x_unlock_reg(), stmqspi_abort(), stmqspi_probe(), str7x_protect_check(), str7x_result(), str7x_waitbusy(), str9x_protect_check(), target_run_flash_async_algorithm(), target_run_read_async_algorithm(), test_iomux_settings(), tms470_check_flash_unlocked(), tms470_erase_check(), tms470_flash_initialize_internal_state_machine(), tms470_flash_status(), tms470_protect(), tms470_protect_check(), tms470_read_part_info(), tms470_try_flash_keys(), tms470_write(), w600_get_flash_id(), w600_start_do(), xmc1xxx_get_info_command(), xmc1xxx_probe(), xmc1xxx_protect_check(), xmc4xxx_erase_sector(), xmc4xxx_get_flash_status(), xmc4xxx_get_info_command(), xmc4xxx_probe(), xmc4xxx_protect_check(), xscale_resume(), xscale_step_inner(), xscale_update_vectors(), zephyr_fetch_thread(), zephyr_fetch_thread_list(), zephyr_get_arc_state(), and zephyr_update_threads().

target_read_u64()

int target_read_u64	(	struct target *	target,
		target_addr_t	address,
		uint64_t *	value
	)

Definition at line 2526 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_buffer_get_u64(), target_read_memory(), target_was_examined(), and reg::value.

Referenced by mips64_configure_break_unit(), mips64_configure_d_break_unit(), mips64_configure_i_break_unit(), and mips64_enable_interrupts().

target_read_u8()

int target_read_u8	(	struct target *	target,
		target_addr_t	address,
		uint8_t *	value
	)

Definition at line 2598 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_read_memory(), target_was_examined(), and reg::value.

Referenced by aduc702x_check_flash_completion(), aduc702x_write_single(), at91sam9_read_data(), chibios_update_threads(), COMMAND_HANDLER(), davinci_read_block_data(), davinci_read_data(), efm32x_get_part_family(), efm32x_get_prod_rev(), efm32x_read_info(), find_sfdp_dummy(), fm3_busy_wait(), kinetis_disable_wdog(), kinetis_ftfx_command(), kinetis_ftfx_prepare(), kinetis_ke_ftmrx_command(), kinetis_ke_prepare_flash(), kinetis_ke_protect_check(), kinetis_ke_stop_watchdog(), kinetis_make_ram_ready(), kinetis_protect_check(), kinetis_read_pmstat(), kinetis_write_block(), lpc3180_controller_ready(), lpc3180_nand_ready(), lpc3180_read_data(), lpc32xx_controller_ready(), lpc32xx_nand_ready(), lpc32xx_read_data(), nuc910_nand_read(), nuttx_update_threads(), orion_nand_read(), psoc5lp_nvl_write(), psoc5lp_spc_busy_wait_data(), psoc5lp_spc_busy_wait_idle(), psoc5lp_spc_enable_clock(), psoc5lp_spc_get_temp(), psoc5lp_spc_read_byte(), psoc5lp_spc_read_hidden_row(), psoc5lp_spc_read_volatile_byte(), read_flash_id(), read_sfdp_block(), read_status_reg(), riot_update_threads(), s3c2410_read_data(), s3c2440_nand_ready(), s3c2440_read_block_data(), s3c24xx_read_data(), samd_check_error(), sh_qspi_cs_activate(), sh_qspi_cs_deactivate(), sh_qspi_init(), sh_qspi_wait_for_bit(), sh_qspi_xfer_common(), stm32x_otp_protect(), stm32x_otp_read_protect(), stm8_set_breakpoint(), str9x_erase(), str9x_protect(), str9x_write(), ucos_iii_update_threads(), zephyr_fetch_thread(), and zephyr_update_threads().

target_register_commands()

int target_register_commands

(

struct command_context *

cmd_ctx

)

Definition at line 6281 of file target.c.

References NULL, register_commands(), and target_command_handlers.

Referenced by setup_command_handler().

target_register_event_callback()

int target_register_event_callback	(	int(*)(struct target *target, enum target_event event, void *priv)	callback,
		void *	priv
	)

Definition at line 1592 of file target.c.

References target_event_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, NULL, priv, and target_event_callbacks.

Referenced by COMMAND_HANDLER(), gdb_new_connection(), and tcl_new_connection().

target_register_reset_callback()

int target_register_reset_callback	(	int(*)(struct target *target, enum target_reset_mode reset_mode, void *priv)	callback,
		void *	priv
	)

Definition at line 1614 of file target.c.

References target_reset_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, target_reset_callback::list, list_add(), LOG_ERROR, priv, and target_reset_callback::priv.

Referenced by tcl_new_connection(), and ucos_iii_create().

target_register_timer_callback()

int target_register_timer_callback	(	int(*)(void *priv)	callback,
		unsigned int	time_ms,
		enum target_timer_type	type,
		void *	priv
	)

The period is very approximate, the callback can happen much more often or much more rarely than specified.

Definition at line 1658 of file target.c.

References target_timer_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, MIN, NULL, priv, target_timer_callbacks, target_timer_next_event_value, target_timer_callback::time_ms, timeval_ms(), and type.

Referenced by aarch64_init_arch_info(), adapter_init_arch_info(), COMMAND_HANDLER(), cortex_a_init_arch_info(), cortex_m_init_arch_info(), esp32_apptrace_cmd_ctx_init(), esp32_cmd_apptrace_generic(), ipdbg_start_polling(), jsp_new_connection(), rtt_set_polling_interval(), rtt_start(), and target_init().

target_register_trace_callback()

int target_register_trace_callback	(	int(*)(struct target *target, size_t len, uint8_t *data, void *priv)	callback,
		void *	priv
	)

Definition at line 1636 of file target.c.

References target_trace_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, target_trace_callback::list, list_add(), LOG_ERROR, priv, and target_trace_callback::priv.

Referenced by tcl_new_connection().

target_register_user_commands()

static int target_register_user_commands ( struct command_context *  cmd_ctx )

static

Definition at line 6779 of file target.c.

References ERROR_OK, NULL, register_commands(), target_exec_command_handlers, target_request_register_commands(), and trace_register_commands().

Referenced by target_init().

target_remove_breakpoint()

int target_remove_breakpoint	(	struct target *	target,
		struct breakpoint *	breakpoint
	)

Remove the breakpoint for target.

This routine is a wrapper for target->type->remove_breakpoint.

Definition at line 1323 of file target.c.

References target_type::remove_breakpoint, and target::type.

Referenced by breakpoint_free().

target_remove_watchpoint()

int target_remove_watchpoint	(	struct target *	target,
		struct watchpoint *	watchpoint
	)

Remove the watchpoint for target.

This routine is a wrapper for target->type->remove_watchpoint.

Definition at line 1338 of file target.c.

References target_type::remove_watchpoint, and target::type.

Referenced by watchpoint_free().

target_reset_examined()

static void target_reset_examined ( struct target *  target )

inlinestatic

Reset the examined flag for the given target.

Pure paranoia – targets are zeroed on allocation.

Definition at line 653 of file target.c.

References target::examined.

Referenced by COMMAND_HANDLER(), handle_target(), target_examine_one(), and target_init_one().

target_reset_mode_name()

const char* target_reset_mode_name

(

enum target_reset_mode

reset_mode

)

Return the name of a target reset reason enumeration value.

Definition at line 286 of file target.c.

References LOG_ERROR, nvp::name, nvp_reset_modes, and nvp_value2name().

Referenced by tcl_target_callback_reset_handler().

target_restore_working_area()

static int target_restore_working_area ( struct target *  target, struct working_area *  area  )

static

Definition at line 2071 of file target.c.

References working_area::address, working_area::backup, target::backup_working_area, ERROR_OK, LOG_ERROR, working_area::size, TARGET_ADDR_FMT, and target_write_memory().

Referenced by target_free_all_working_areas_restore(), and target_free_working_area_restore().

target_resume()

int target_resume	(	struct target *	target,
		int	current,
		target_addr_t	address,
		int	handle_breakpoints,
		int	debug_execution
	)

Make the target (re)start executing using its saved execution context (possibly with some modifications).

Parameters

target	Which target should start executing.
current	True to use the target's saved program counter instead of the address parameter
address	Optionally used as the program counter.
handle_breakpoints	True iff breakpoints at the resumption PC should be skipped. (For example, maybe execution was stopped by such a breakpoint, in which case it would be counterproductive to let it re-trigger.
debug_execution	False if all working areas allocated by OpenOCD should be released and/or restored to their original contents. (This would for example be true to run some downloaded "helper" algorithm code, which resides in one such working buffer and uses another for data storage.)

Todo:

Resolve the ambiguity about what the "debug_execution" flag signifies. For example, Target implementations don't agree on how it relates to invalidation of the register cache, or to whether breakpoints and watchpoints should be enabled. (It would seem wrong to enable breakpoints when running downloaded "helper" algorithms (debug_execution true), since the breakpoints would be set to match target firmware being debugged, not the helper algorithm.... and enabling them could cause such helpers to malfunction (for example, by overwriting data with a breakpoint instruction. On the other hand the infrastructure for running such helpers might use this procedure but rely on hardware breakpoint to detect termination.)

Definition at line 556 of file target.c.

References ERROR_FAIL, ERROR_OK, jtag_poll_mask(), jtag_poll_unmask(), LOG_ERROR, target_type::resume, target_call_event_callbacks(), TARGET_EVENT_RESUME_END, TARGET_EVENT_RESUME_START, target_was_examined(), and target::type.

Referenced by ambiqmicro_exec_command(), arc_assert_reset(), arm_semihosting_resume(), armv4_5_run_algorithm_inner(), armv7m_start_algorithm(), COMMAND_HANDLER(), cortex_m_profiling(), dsp563xx_run_algorithm(), esp32_apptrace_connect_targets(), esp32_apptrace_safe_halt_targets(), esp32_sysview_stop(), esp32s2_poll(), esp_xtensa_profiling(), esp_xtensa_smp_poll(), gdb_fileio_reply(), gdb_fileio_response_packet(), gdb_handle_vcont_packet(), gdb_step_continue_packet(), hl_deassert_reset(), mips32_run_and_wait(), or1k_profiling(), stm8_run_and_wait(), and target_profiling_default().

target_run_algorithm()

int target_run_algorithm	(	struct target *	target,
		int	num_mem_params,
		struct mem_param *	mem_params,
		int	num_reg_params,
		struct reg_param *	reg_param,
		target_addr_t	entry_point,
		target_addr_t	exit_point,
		unsigned int	timeout_ms,
		void *	arch_info
	)

Downloads a target-specific native code algorithm to the target, and executes it.

Run an algorithm on the target given.

• Note that some targets may need to set up, enable, and tear down a breakpoint (hard or * soft) to detect algorithm termination, while others may support lower overhead schemes where soft breakpoints embedded in the algorithm automatically terminate the algorithm.

Parameters

target	used to run the algorithm
num_mem_params
mem_params
num_reg_params
reg_param
entry_point
exit_point
timeout_ms
arch_info	target-specific description of the algorithm.

Definition at line 773 of file target.c.

References target::arch_info, ERROR_FAIL, LOG_ERROR, target_type::run_algorithm, target::running_alg, target_type_name(), target_was_examined(), and target::type.

Referenced by aduc702x_write_block(), aducm360_write_block_sync(), arm_blank_check_memory(), arm_checksum_memory(), arm_nandread(), arm_nandwrite(), armv7m_blank_check_memory(), armv7m_checksum_memory(), cc3220sf_write(), cfi_intel_write_block(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), em357_write_block(), fespi_write(), fm3_chip_erase(), fm3_erase(), fm3_write_block(), fm4_flash_erase(), fm4_flash_write(), kinetis_disable_wdog_algo(), kinetis_ke_stop_watchdog(), lpc2000_iap_call(), lpc2900_write(), lpcspifi_erase(), lpcspifi_set_hw_mode(), mips32_blank_check_memory(), mips32_checksum_memory(), numicro_writeblock(), pic32mx_write_block(), psoc4_sysreq(), qspi_verify(), riscv_checksum_memory(), rp2040_call_rom_func(), rsl10_ll_flash_erase(), rsl10_ll_flash_write(), rsl10_mass_erase(), sh_qspi_read(), sh_qspi_write(), stm32lx_write_half_pages(), stm32x_write_block_riscv(), stm8_blank_check_memory(), stmqspi_blank_check(), str7x_write_block(), str9x_write_block(), xmc1xxx_erase(), xmc1xxx_erase_check(), and xmc1xxx_write().

target_run_flash_async_algorithm()

int target_run_flash_async_algorithm	(	struct target *	target,
		const uint8_t *	buffer,
		uint32_t	count,
		int	block_size,
		int	num_mem_params,
		struct mem_param *	mem_params,
		int	num_reg_params,
		struct reg_param *	reg_params,
		uint32_t	buffer_start,
		uint32_t	buffer_size,
		uint32_t	entry_point,
		uint32_t	exit_point,
		void *	arch_info
	)

Streams data to a circular buffer on target intended for consumption by code running asynchronously on target.

This routine is a wrapper for asynchronous algorithms.

This is intended for applications where target-specific native code runs on the target, receives data from the circular buffer, does something with it (most likely writing it to a flash memory), and advances the circular buffer pointer.

This assumes that the helper algorithm has already been loaded to the target, but has not been started yet. Given memory and register parameters are passed to the algorithm.

The buffer is defined by (buffer_start, buffer_size) arguments and has the following format:

[buffer_start + 0, buffer_start + 4):
    Write Pointer address (aka head). Written and updated by this
    routine when new data is written to the circular buffer.
[buffer_start + 4, buffer_start + 8):
    Read Pointer address (aka tail). Updated by code running on the
    target after it consumes data.
[buffer_start + 8, buffer_start + buffer_size):
    Circular buffer contents.

See contrib/loaders/flash/stm32f1x.S for an example.

Parameters

target	used to run the algorithm
buffer	address on the host where data to be sent is located
count	number of blocks to send
block_size	size in bytes of each block
num_mem_params	count of memory-based params to pass to algorithm
mem_params	memory-based params to pass to algorithm
num_reg_params	count of register-based params to pass to algorithm
reg_params	memory-based params to pass to algorithm
buffer_start	address on the target of the circular buffer structure
buffer_size	size of the circular buffer structure
entry_point	address on the target to execute to start the algorithm
exit_point	address at which to set a breakpoint to catch the end of the algorithm; can be 0 if target triggers a breakpoint itself
arch_info

Definition at line 930 of file target.c.

References alive_sleep(), target::arch_info, buffer, count, ERROR_FLASH_OPERATION_FAILED, ERROR_OK, IS_ALIGNED, IS_PWR_OF_2, keep_alive(), LOG_DEBUG, LOG_ERROR, target_read_u32(), target_start_algorithm(), target_wait_algorithm(), target_write_buffer(), and target_write_u32().

Referenced by aducm360_write_block_async(), bluenrgx_write(), efm32x_write_block(), kinetis_ke_write_words(), kinetis_write_block(), lpcspifi_write(), max32xxx_write_block(), mdr_write_block(), mrvlqspi_flash_write(), niietcm4_write_block(), nrf5_ll_flash_write(), qspi_read_write_block(), sim3x_write_block(), stellaris_write_block(), stm32l4_write_block(), stm32x_write_block(), and stm32x_write_block_async().

target_run_read_async_algorithm()

int target_run_read_async_algorithm	(	struct target *	target,
		uint8_t *	buffer,
		uint32_t	count,
		int	block_size,
		int	num_mem_params,
		struct mem_param *	mem_params,
		int	num_reg_params,
		struct reg_param *	reg_params,
		uint32_t	buffer_start,
		uint32_t	buffer_size,
		uint32_t	entry_point,
		uint32_t	exit_point,
		void *	arch_info
	)

This routine is a wrapper for asynchronous algorithms.

Definition at line 1083 of file target.c.

References alive_sleep(), target::arch_info, buffer, count, ERROR_FLASH_OPERATION_FAILED, ERROR_OK, ERROR_SERVER_INTERRUPTED, IS_ALIGNED, IS_PWR_OF_2, keep_alive(), LOG_DEBUG, LOG_ERROR, openocd_is_shutdown_pending(), target_read_buffer(), target_read_u32(), target_start_algorithm(), target_wait_algorithm(), and target_write_u32().

Referenced by qspi_read_write_block().

target_soft_reset_halt()

static int target_soft_reset_halt ( struct target *  target )

static

Definition at line 741 of file target.c.

References ERROR_FAIL, LOG_ERROR, target_type::soft_reset_halt, target_name(), target_was_examined(), and target::type.

Referenced by COMMAND_HANDLER().

target_split_working_area()

static void target_split_working_area ( struct working_area *  area, uint32_t  size  )

static

Definition at line 1908 of file target.c.

References working_area::address, working_area::backup, working_area::free, working_area::next, NULL, size, working_area::size, and working_area::user.

Referenced by target_alloc_working_area_try().

target_start_algorithm()

int target_start_algorithm	(	struct target *	target,
		int	num_mem_params,
		struct mem_param *	mem_params,
		int	num_reg_params,
		struct reg_param *	reg_params,
		target_addr_t	entry_point,
		target_addr_t	exit_point,
		void *	arch_info
	)

Executes a target-specific native code algorithm and leaves it running.

Starts an algorithm in the background on the target given.

Parameters

target	used to run the algorithm
num_mem_params
mem_params
num_reg_params
reg_params
entry_point
exit_point
arch_info	target-specific description of the algorithm.

Definition at line 814 of file target.c.

References target::arch_info, ERROR_FAIL, LOG_ERROR, target::running_alg, target_type::start_algorithm, target_type_name(), target_was_examined(), and target::type.

Referenced by cc26xx_init(), esp_algorithm_run_debug_stub(), esp_algorithm_run_image(), msp432_init(), npcx_init(), sromalgo_prepare(), target_run_flash_async_algorithm(), and target_run_read_async_algorithm().

target_state_name()

const char* target_state_name

(

const struct target *

t

)

Return the name of this targets current state.

Definition at line 260 of file target.c.

References target::defer_examine, LOG_ERROR, nvp::name, nvp_target_state, nvp_value2name(), target::state, and target_was_examined().

Referenced by adapter_debug_entry(), arc_arch_state(), arc_assert_reset(), arc_deassert_reset(), arc_halt(), arm11_halt(), arm11_resume(), arm11_step(), arm7_9_assert_reset(), arm7_9_deassert_reset(), arm7_9_halt(), avr32_ap7k_halt(), COMMAND_HANDLER(), cortex_m_assert_reset(), cortex_m_deassert_reset(), cortex_m_debug_entry(), cortex_m_halt_one(), dsp563xx_poll(), gdb_connection_closed(), gdb_new_connection(), mips_m4k_assert_reset(), mips_m4k_deassert_reset(), mips_m4k_debug_entry(), mips_m4k_halt(), mips_mips64_assert_reset(), mips_mips64_deassert_reset(), mips_mips64_debug_entry(), mips_mips64_halt(), or1k_halt(), stm8_debug_entry(), stm8_halt(), tcl_target_callback_event_handler(), xscale_assert_reset(), and xscale_halt().

target_step()

int target_step	(	struct target *	target,
		int	current,
		target_addr_t	address,
		int	handle_breakpoints
	)

Step the target.

This routine is a wrapper for target->type->step.

Definition at line 1410 of file target.c.

References ERROR_OK, target_type::step, target_call_event_callbacks(), TARGET_EVENT_STEP_END, TARGET_EVENT_STEP_START, and target::type.

Referenced by COMMAND_HANDLER(), gdb_fileio_response_packet(), gdb_handle_vcont_packet(), and gdb_step_continue_packet().

target_strerror_safe()

static const char* target_strerror_safe ( int  err )

static

Definition at line 146 of file target.c.

Referenced by COMMAND_HANDLER().

target_supports_gdb_connection()

bool target_supports_gdb_connection

(

const struct target *

target

)

Check if target allows GDB connections.

Some target do not implement the necessary code required by GDB.

Definition at line 1401 of file target.c.

References target::gdb_max_connections, target_type::get_gdb_reg_list, and target::type.

Referenced by gdb_target_add_one().

target_timer_callback_periodic_restart()

static int target_timer_callback_periodic_restart ( struct target_timer_callback *  cb, int64_t *  now  )

static

Definition at line 1812 of file target.c.

References ERROR_OK, target_timer_callback::time_ms, and target_timer_callback::when.

Referenced by target_call_timer_callback().

target_timer_next_event()

int64_t target_timer_next_event

(

void

)

Returns when the next registered event will take place.

Callers can use this to go to sleep until that time occurs.

Definition at line 1889 of file target.c.

References target_timer_next_event_value.

Referenced by server_loop().

target_type_name()

const char* target_type_name

(

const struct target *

target

)

Get the target type name.

This routine is a wrapper for the target->type->name field. Note that this is not an instance-specific name for his target.

Definition at line 736 of file target.c.

References target_type::name, and target::type.

Referenced by arm_default_mcr(), arm_default_mcrr(), arm_default_mrc(), arm_default_mrrc(), cfi_spansion_write_block(), chibios_create(), chibios_get_thread_reg_list(), chromium_ec_create(), COMMAND_HANDLER(), ecos_create(), embeddedice_build_reg_cache(), embkernel_create(), freertos_create(), mqx_create(), nuttx_create(), riot_create(), rtkernel_create(), stm32x_get_property_addr(), target_configure(), target_handle_event(), target_run_algorithm(), target_start_algorithm(), target_wait_algorithm(), threadx_create(), ucos_iii_create(), and zephyr_create().

target_unregister_event_callback()

int target_unregister_event_callback	(	int(*)(struct target *target, enum target_event event, void *priv)	callback,
		void *	priv
	)

Definition at line 1687 of file target.c.

References target_event_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, target_event_callback::next, priv, target_event_callback::priv, and target_event_callbacks.

Referenced by gdb_connection_closed(), and tcl_closed().

target_unregister_reset_callback()

int target_unregister_reset_callback	(	int(*)(struct target *target, enum target_reset_mode reset_mode, void *priv)	callback,
		void *	priv
	)

Definition at line 1710 of file target.c.

References target_reset_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, target_reset_callback::list, list_del(), list_for_each_entry, priv, and target_reset_callback::priv.

Referenced by tcl_closed().

target_unregister_timer_callback()

int target_unregister_timer_callback	(	int(*)(void *priv)	callback,
		void *	priv
	)

Definition at line 1748 of file target.c.

References target_trace_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, target_timer_callback::next, priv, and target_timer_callbacks.

Referenced by arm_tpiu_swo_cleanup_all(), COMMAND_HANDLER(), esp32_apptrace_cmd_stop(), esp32_apptrace_wait_tracing_finished(), ipdbg_stop_polling(), jsp_connection_closed(), read_channel_callback(), rtt_set_polling_interval(), rtt_stop(), and target_call_timer_callback().

target_unregister_trace_callback()

int target_unregister_trace_callback	(	int(*)(struct target *target, size_t len, uint8_t *data, void *priv)	callback,
		void *	priv
	)

Definition at line 1729 of file target.c.

References target_trace_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, target_trace_callback::list, list_del(), list_for_each_entry, priv, and target_trace_callback::priv.

Referenced by tcl_closed().

target_wait_algorithm()

int target_wait_algorithm	(	struct target *	target,
		int	num_mem_params,
		struct mem_param *	mem_params,
		int	num_reg_params,
		struct reg_param *	reg_params,
		target_addr_t	exit_point,
		unsigned int	timeout_ms,
		void *	arch_info
	)

Waits for an algorithm started with target_start_algorithm() to complete.

Wait for an algorithm on the target given.

Parameters

target	used to run the algorithm
num_mem_params
mem_params
num_reg_params
reg_params
exit_point
timeout_ms
arch_info	target-specific description of the algorithm.

Definition at line 858 of file target.c.

References target::arch_info, ERROR_FAIL, ERROR_TARGET_TIMEOUT, LOG_ERROR, target::running_alg, target_type_name(), target::type, and target_type::wait_algorithm.

Referenced by cc26xx_quit(), esp_algorithm_run_debug_stub(), esp_algorithm_run_image(), msp432_quit(), npcx_quit(), sromalgo_release(), target_run_flash_async_algorithm(), and target_run_read_async_algorithm().

target_wait_state()

int target_wait_state	(	struct target *	target,
		enum target_state	state,
		unsigned int	ms
	)

Definition at line 3214 of file target.c.

References ERROR_FAIL, ERROR_OK, ERROR_SERVER_INTERRUPTED, keep_alive(), LOG_DEBUG, LOG_ERROR, name, nvp_target_state, nvp_value2name(), openocd_is_shutdown_pending(), state, target::state, target_poll(), and timeval_ms().

Referenced by arm7_9_dcc_completion(), armv4_5_run_algorithm_completion(), armv7m_wait_algorithm(), COMMAND_HANDLER(), dsp563xx_run_algorithm(), esp32_apptrace_safe_halt_targets(), esp32_soc_reset(), esp32s2_soc_reset(), esp32s3_soc_reset(), feroceon_bulk_write_memory(), handle_reset_halt(), mips32_run_and_wait(), stm8_run_and_wait(), and xtensa_wait_algorithm().

target_write_buffer()

int target_write_buffer	(	struct target *	target,
		target_addr_t	address,
		uint32_t	size,
		const uint8_t *	buffer
	)

Definition at line 2342 of file target.c.

References buffer, ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, size, TARGET_ADDR_FMT, target_was_examined(), target::type, and target_type::write_buffer.

Referenced by aduc702x_write_block(), aducm360_write_block_async(), aducm360_write_block_sync(), ambiqmicro_write_block(), arc_unset_breakpoint(), arc_write_instruction_u32(), arm_nandwrite(), armv4_5_run_algorithm_inner(), armv7m_blank_check_memory(), armv7m_checksum_memory(), armv7m_start_algorithm(), bluenrgx_write(), cc26xx_erase(), cc26xx_init(), cc26xx_mass_erase(), cc26xx_write(), cc3220sf_write(), cfi_intel_write_block(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), COMMAND_HANDLER(), dsp563xx_run_algorithm(), efm32x_write_block(), em357_write_block(), eneispif_write(), esirisc_flash_fill_pb(), esp32_soc_reset(), esp32s3_soc_reset(), esp_algorithm_load_func_image(), esp_algorithm_load_onboard_func(), fespi_write(), fm3_chip_erase(), fm3_erase(), fm3_write_block(), fm4_flash_erase(), fm4_flash_write(), gdb_write_memory_binary_packet(), gdb_write_memory_packet(), hwthread_write_buffer(), imx31_write_page(), kinetis_disable_wdog_algo(), kinetis_ke_stop_watchdog(), kinetis_ke_write_words(), kinetis_write_block(), load_section_from_image(), lpc2000_write(), lpc2900_write(), lpcspifi_erase(), lpcspifi_set_hw_mode(), lpcspifi_write(), max32xxx_write(), max32xxx_write_block(), mdr_write_block(), mips32_blank_check_memory(), mips32_checksum_memory(), mips32_run_algorithm(), mrvlqspi_flash_write(), msp432_exec_cmd(), msp432_init(), msp432_write(), mxc_write_page(), niietcm4_write_block(), npcx_chip_erase(), npcx_erase(), npcx_init(), npcx_write(), nrf5_ll_flash_write(), numicro_writeblock(), pic32mx_write_block(), psoc4_sysreq(), psoc5lp_write(), psoc6_program_row(), qn908x_write(), qspi_read_write_block(), qspi_verify(), riscv_checksum_memory(), rp2040_flash_write(), rsl10_ll_flash_erase(), rsl10_ll_flash_write(), rsl10_mass_erase(), semihosting_common(), sh_qspi_upload_helper(), sh_qspi_write(), sim3x_write_block(), smi_write_buffer(), stellaris_write(), stellaris_write_block(), stm32l4_write_block(), stm32lx_write(), stm32lx_write_half_pages(), stm32x_write(), stm32x_write_block(), stm32x_write_block_async(), stm32x_write_block_riscv(), stm8_blank_check_memory(), stm8_run_algorithm(), stmqspi_blank_check(), str7x_write_block(), str9x_write_block(), target_run_flash_async_algorithm(), w600_write(), write_to_channel(), xmc1xxx_erase(), xmc1xxx_erase_check(), xmc1xxx_write(), xtensa_start_algorithm(), and xtensa_update_instruction().

target_write_buffer_default()

static int target_write_buffer_default ( struct target *  target, target_addr_t  address, uint32_t  count, const uint8_t *  buffer  )

static

Definition at line 2366 of file target.c.

References buffer, count, ERROR_OK, size, target_data_bits(), and target_write_memory().

Referenced by target_init_one().

target_write_memory()

int target_write_memory	(	struct target *	target,
		target_addr_t	address,
		uint32_t	size,
		uint32_t	count,
		const uint8_t *	buffer
	)

Write count items of size bytes to the memory of target at the address given.

address must be aligned to size in target memory.

The endianness is the same in the host and target memory for this function.

Todo:

TODO: Really buffer should have been defined as "const void *" and buffer should have been aligned to size in the host memory.

This is not enforced via e.g. assert's today and e.g. the target_write_buffer fn breaks this assumption.

This routine is wrapper for target->type->write_memory.

Definition at line 1265 of file target.c.

References buffer, count, ERROR_FAIL, LOG_ERROR, size, target_name(), target_was_examined(), target::type, and target_type::write_memory.

Referenced by aarch64_set_breakpoint(), aarch64_unset_breakpoint(), arm7_9_unset_breakpoint(), arm_code_to_working_area(), at91sam7_write(), cfi_target_write_memory(), COMMAND_HANDLER(), cortex_a_set_breakpoint(), cortex_a_unset_breakpoint(), cortex_a_write_buffer(), cortex_m_set_breakpoint(), cortex_m_unset_breakpoint(), kinetis_ftfx_command(), kinetis_write_sections(), lpc2000_iap_working_area_init(), lpc2900_write(), lpc2900_write_index_page(), lpc3180_write_page(), lpc32xx_read_page_slc(), lpc32xx_write_page_mlc(), lpc32xx_write_page_slc(), mips_m4k_set_breakpoint(), mips_m4k_unset_breakpoint(), mips_mips16_unset_sdbbp(), mips_mips64_unset_sdbbp(), nrf5_ll_flash_write(), numicro_write(), rpc_hf_xfer(), sam3_page_write(), sam4_page_write(), sam4l_write_page(), samd_modify_user_row_masked(), samd_write(), same5_modify_user_row_masked(), same5_write(), samv_page_write(), semihosting_common(), semihosting_write_fields(), stm32l4_write_block_without_loader(), stm32x_write(), stm32x_write_block(), stm8_unset_breakpoint(), str7x_write(), str9x_write(), swm050_write(), target_jim_write_memory(), target_restore_working_area(), target_write_buffer_default(), target_write_u16(), target_write_u32(), target_write_u64(), target_write_u8(), write_by_given_size(), xmc1xxx_write(), and xscale_unset_breakpoint().

target_write_phys_memory()

int target_write_phys_memory	(	struct target *	target,
		target_addr_t	address,
		uint32_t	size,
		uint32_t	count,
		const uint8_t *	buffer
	)

Definition at line 1279 of file target.c.

References buffer, count, ERROR_FAIL, LOG_ERROR, size, target_name(), target_was_examined(), target::type, and target_type::write_phys_memory.

Referenced by COMMAND_HANDLER(), target_jim_write_memory(), target_write_phys_u16(), target_write_phys_u32(), target_write_phys_u64(), and target_write_phys_u8().

target_write_phys_u16()

int target_write_phys_u16	(	struct target *	target,
		target_addr_t	address,
		uint16_t	value
	)

Definition at line 2743 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_buffer_set_u16(), target_was_examined(), target_write_phys_memory(), and reg::value.

target_write_phys_u32()

int target_write_phys_u32	(	struct target *	target,
		target_addr_t	address,
		uint32_t	value
	)

Definition at line 2722 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_buffer_set_u32(), target_was_examined(), target_write_phys_memory(), and reg::value.

Referenced by arm7a_l2x_flush_all_data(), armv7a_l2x_cache_clean_virt(), armv7a_l2x_cache_flush_virt(), and armv7a_l2x_cache_inval_virt().

target_write_phys_u64()

int target_write_phys_u64	(	struct target *	target,
		target_addr_t	address,
		uint64_t	value
	)

Definition at line 2701 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_buffer_set_u64(), target_was_examined(), target_write_phys_memory(), and reg::value.

target_write_phys_u8()

int target_write_phys_u8	(	struct target *	target,
		target_addr_t	address,
		uint8_t	value
	)

Definition at line 2764 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_was_examined(), target_write_phys_memory(), and reg::value.

target_write_u16()

int target_write_u16	(	struct target *	target,
		target_addr_t	address,
		uint16_t	value
	)

Definition at line 2662 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_buffer_set_u16(), target_was_examined(), target_write_memory(), and reg::value.

Referenced by aduc702x_erase(), aduc702x_set_write_enable(), aduc702x_write_single(), arc_set_breakpoint(), arm7_9_set_breakpoint(), do_data_output(), em357_write(), em357_write_options(), imx31_address(), imx31_command(), imx31_write_page(), initialize_nf_controller(), mips_m4k_set_breakpoint(), mips_mips16_set_sdbbp(), mxc_address(), mxc_command(), mxc_read_page(), mxc_write_page(), s3c24xx_address(), s3c24xx_command(), samd_check_error(), same5_wait_and_check_error(), sh_qspi_cs_activate(), sh_qspi_init(), str9x_erase(), str9x_protect(), str9x_protect_check(), str9x_write(), tms470_write(), xmc1xxx_nvm_set_idle(), and xscale_set_breakpoint().

target_write_u32()

int target_write_u32	(	struct target *	target,
		target_addr_t	address,
		uint32_t	value
	)

Definition at line 2641 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_buffer_set_u32(), target_was_examined(), target_write_memory(), and reg::value.

Referenced by adapter_resume(), adapter_step(), aducm360_mass_erase(), aducm360_page_erase(), aducm360_set_write_enable(), aducm360_write_modified(), ambiqmicro_erase(), ambiqmicro_mass_erase(), ambiqmicro_otp_program(), ambiqmicro_write_block(), arm7_9_set_breakpoint(), arm_blank_check_memory(), arm_checksum_memory(), arm_simulate_step_core(), armv7m_trace_itm_config(), at91sam7_flash_command(), at91sam7_set_flash_mode(), at91sam9_disable(), at91sam9_ecc_init(), at91sam9_enable(), bluenrgx_erase(), bluenrgx_write_flash_reg(), call_sromapi(), cc3220sf_erase(), cc3220sf_mass_erase(), clrsetbits_u32(), COMMAND_HANDLER(), cortex_m_dwt_set_reg(), cortex_m_dwt_setup(), cortex_m_enable_fpb(), cortex_m_endreset_event(), cortex_m_examine(), cortex_m_set_breakpoint(), cortex_m_set_watchpoint(), cortex_m_unset_breakpoint(), cortex_m_unset_watchpoint(), davinci_write_block_data(), davinci_write_page_ecc1(), davinci_write_page_ecc4(), davinci_write_page_ecc4infix(), efc_start_command(), efm32x_write_reg_u32(), em357_erase(), em357_erase_options(), em357_mass_erase(), em357_probe(), em357_wait_status_busy(), em357_write(), em357_write_block(), em357_write_options(), eneispif_write_reg(), esirisc_flash_clear_status(), esirisc_flash_control(), esirisc_flash_disable_protect(), esirisc_flash_enable_protect(), esirisc_flash_erase(), esirisc_flash_fill_pb(), esirisc_flash_init(), esirisc_flash_mass_erase(), esirisc_flash_unlock(), esirisc_flash_write(), esp32_disable_wdts(), esp32_soc_reset(), esp32s2_disable_wdts(), esp32s2_set_peri_reg_mask(), esp32s2_soc_reset(), esp32s3_disable_wdts(), esp32s3_soc_reset(), fespi_write_reg(), find_sfdp_dummy(), fm3_chip_erase(), fm3_erase(), fm3_write_block(), fm4_disable_hw_watchdog(), fm4_enter_flash_cpu_programming_mode(), fm4_enter_flash_cpu_rom_mode(), imx31_init(), io_write_reg(), ioconfig_write_reg(), ipc_acquire(), kinetis_check_run_mode(), kinetis_invalidate_flash_cache(), kinetis_ke_prepare_flash(), lpc288x_load_timer(), lpc288x_set_flash_clk(), lpc2900_erase(), lpc2900_read_security_status(), lpc2900_run_bist128(), lpc2900_setup(), lpc2900_write(), lpc2900_write_index_page(), lpc3180_address(), lpc3180_command(), lpc3180_init(), lpc3180_read_page(), lpc3180_reset(), lpc3180_write_data(), lpc3180_write_page(), lpc32xx_address(), lpc32xx_command(), lpc32xx_init(), lpc32xx_read_page_mlc(), lpc32xx_read_page_slc(), lpc32xx_reset(), lpc32xx_start_slc_dma(), lpc32xx_write_data(), lpc32xx_write_page_mlc(), lpc32xx_write_page_slc(), max32xxx_erase(), max32xxx_flash_op_post(), max32xxx_flash_op_pre(), max32xxx_mass_erase(), max32xxx_protect(), max32xxx_write(), mdr_erase(), mdr_mass_erase(), mdr_read(), mdr_write(), mips32_configure_dbs(), mips32_configure_ibs(), mips32_enable_interrupts(), mips_m4k_examine_debug_reason(), mips_m4k_set_breakpoint(), mips_m4k_set_watchpoint(), mips_m4k_unset_breakpoint(), mips_m4k_unset_watchpoint(), mips_mips64_set_sdbbp(), mrvlqspi_fifo_flush(), mrvlqspi_set_addr(), mrvlqspi_set_conf(), mrvlqspi_set_din_cnt(), mrvlqspi_set_hdr_cnt(), mrvlqspi_set_instr(), mrvlqspi_set_ss_state(), mrvlqspi_start_transfer(), mrvlqspi_stop_transfer(), msp432_exec_cmd(), msp432_write(), mxc_init(), niietcm4_dump_uflash_page(), niietcm4_erase(), niietcm4_load_uflash_page(), niietcm4_mass_erase(), niietcm4_opstatus_check(), niietcm4_probe_k1921vk01t(), niietcm4_protect_check(), niietcm4_uflash_page_erase(), niietcm4_uopstatus_check(), niietcm4_write(), nrf51_protect_clenr0(), nrf5_erase_page(), nrf5_nvmc_write_u32(), nuc910_nand_address(), numicro_erase(), numicro_fmc_cmd(), numicro_init_isp(), numicro_reg_unlock(), numicro_write(), octospi_cmd(), pic32mx_erase(), pic32mx_nvm_exec(), pic32mx_write_word(), poll_busy(), psoc4_sysreq(), psoc5lp_eeprom_probe(), psoc5lp_write(), psoc6_erase_row(), psoc6_erase_sector(), psoc6_program_row(), qn908x_erase(), qn908x_init_flash(), qn908x_load_lock_stat(), qn908x_setup_erase(), qn908x_update_reg(), qn908x_write(), qspi_erase_sector(), qspi_write_enable(), read_flash_id(), read_from_channel(), read_sfdp_block(), read_status_reg(), rp2040_spi_read_flash_id(), rp2040_ssel_active(), rpc_hf_mode(), rpc_hf_xfer(), rsl10_protect(), s3c2410_init(), s3c2410_write_data(), s3c2412_init(), s3c2440_init(), s3c2443_init(), s3c24xx_reset(), s3c6400_init(), sam3_page_write(), sam4_set_wait(), sam4l_flash_command(), samd_erase_row(), samd_issue_nvmctrl_command(), samd_protect(), same5_erase_block(), same5_issue_nvmctrl_command(), same5_protect(), samv_efc_start_command(), set_mm_mode(), sh_qspi_xfer_common(), sim3x_erase_page(), sim3x_flash_erase(), sim3x_init(), sromalgo_prepare(), ssp_write_reg(), stellaris_erase(), stellaris_mass_erase(), stellaris_protect(), stellaris_set_flash_timing(), stellaris_write(), stm32l4_write_flash_reg(), stm32lx_enable_write_half_page(), stm32lx_erase_sector(), stm32lx_lock(), stm32lx_lock_program_memory(), stm32lx_mass_erase(), stm32lx_obl_launch(), stm32lx_unlock(), stm32lx_unlock_options_bytes(), stm32lx_unlock_program_memory(), stm32lx_wait_until_bsy_clear_timeout(), stm32x_erase(), stm32x_erase_options(), stm32x_mass_erase(), stm32x_unlock_option_reg(), stm32x_unlock_reg(), stm32x_wait_status_busy(), stm32x_write(), stm32x_write_block(), stm32x_write_flash_reg(), stm32x_write_options(), stmqspi_abort(), stmqspi_probe(), str7x_erase(), str7x_protect(), str7x_write(), swm050_erase(), swm050_mass_erase(), swm050_write(), target_run_flash_async_algorithm(), target_run_read_async_algorithm(), tms470_erase_check(), tms470_flash_initialize_internal_state_machine(), tms470_protect(), tms470_protect_check(), tms470_read_part_info(), tms470_try_flash_keys(), tms470_write(), w600_start_do(), wrap_write_u32(), write_to_channel(), xmc4xxx_clear_flash_status(), xmc4xxx_enter_page_mode(), xmc4xxx_write_command_sequence(), xmc4xxx_write_page(), and xscale_set_breakpoint().

target_write_u64()

int target_write_u64	(	struct target *	target,
		target_addr_t	address,
		uint64_t	value
	)

Definition at line 2620 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_buffer_set_u64(), target_was_examined(), target_write_memory(), and reg::value.

Referenced by mips64_configure_d_break_unit(), mips64_configure_i_break_unit(), mips64_enable_interrupts(), mips_mips64_set_hwbp(), mips_mips64_set_watchpoint(), mips_mips64_unset_hwbp(), and mips_mips64_unset_watchpoint().

target_write_u8()

int target_write_u8	(	struct target *	target,
		target_addr_t	address,
		uint8_t	value
	)

Definition at line 2683 of file target.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, TARGET_ADDR_FMT, target_was_examined(), target_write_memory(), and reg::value.

Referenced by aduc702x_erase(), aduc702x_write_single(), at91sam9_address(), at91sam9_command(), at91sam9_write_data(), COMMAND_HANDLER(), davinci_address(), davinci_command(), davinci_seek_column(), davinci_write_block_data(), davinci_write_data(), davinci_write_pagecmd(), davinci_writepage_tail(), kinetis_check_run_mode(), kinetis_disable_wdog(), kinetis_ftfx_clear_error(), kinetis_ftfx_command(), kinetis_invalidate_flash_cache(), kinetis_ke_ftmrx_command(), kinetis_ke_prepare_flash(), kinetis_write_block(), nuc910_nand_command(), nuc910_nand_write(), orion_nand_address(), orion_nand_command(), orion_nand_write(), psoc5lp_nvl_write(), psoc5lp_spc_enable_clock(), psoc5lp_spc_erase_sector(), psoc5lp_spc_get_temp(), psoc5lp_spc_load_byte(), psoc5lp_spc_load_row(), psoc5lp_spc_read_byte(), psoc5lp_spc_read_hidden_row(), psoc5lp_spc_read_volatile_byte(), psoc5lp_spc_write_opcode(), psoc5lp_spc_write_row(), psoc5lp_spc_write_user_nvl(), s3c24xx_write_data(), sh_qspi_cs_activate(), sh_qspi_cs_deactivate(), sh_qspi_init(), sh_qspi_xfer_common(), stm32x_otp_protect(), stm32x_write(), and stm8_set_breakpoint().

write_data()

static void write_data ( FILE *  f, const void *  data, size_t  len  )

static

Definition at line 4185 of file target.c.

References LOG_ERROR.

Referenced by nand_write_data_page(), write_gmon(), write_long(), and write_string().

write_gmon()

static void write_gmon ( uint32_t *  samples, uint32_t  sample_num, const char *  filename, bool  with_range, uint32_t  start_address, uint32_t  end_address, struct target *  target, uint32_t  duration_ms  )

static

Definition at line 4208 of file target.c.

References write_data(), write_long(), write_string(), and zero.

Referenced by COMMAND_HANDLER().

write_long()

static void write_long ( FILE *  f, int  l, struct target *  target  )

static

Definition at line 4192 of file target.c.

References target_buffer_set_u32(), and write_data().

Referenced by write_gmon().

write_string()

static void write_string ( FILE *  f, char *  s  )

static

Definition at line 4200 of file target.c.

References write_data().

Referenced by write_gmon().

Variable Documentation

all_targets

struct target* all_targets

Definition at line 107 of file target.c.

Referenced by append_to_list_all_targets(), COMMAND_HANDLER(), delete_debug_msg_receiver(), find_debug_msg_receiver(), gdb_new_connection(), get_target(), handle_target(), target_examine(), target_init(), target_process_reset(), and target_quit().

fastload

struct fast_load* fastload

static

Definition at line 6119 of file target.c.

Referenced by COMMAND_HANDLER(), and free_fastload().

fastload_num

int fastload_num

static

Definition at line 6118 of file target.c.

Referenced by COMMAND_HANDLER(), and free_fastload().

nvp_assert

const struct nvp nvp_assert[]

static

Initial value:

= {
    { .name = "assert", NVP_ASSERT },
    { .name = "deassert", NVP_DEASSERT },
    { .name = "T", NVP_ASSERT },
    { .name = "F", NVP_DEASSERT },
    { .name = "t", NVP_ASSERT },
    { .name = "f", NVP_DEASSERT },
    { .name = NULL, .value = -1 }
}

Definition at line 114 of file target.c.

nvp_config_opts

struct jim_nvp nvp_config_opts[]

static

Initial value:

= {
    { .name = "-type",             .value = TCFG_TYPE },
    { .name = "-event",            .value = TCFG_EVENT },
    { .name = "-work-area-virt",   .value = TCFG_WORK_AREA_VIRT },
    { .name = "-work-area-phys",   .value = TCFG_WORK_AREA_PHYS },
    { .name = "-work-area-size",   .value = TCFG_WORK_AREA_SIZE },
    { .name = "-work-area-backup", .value = TCFG_WORK_AREA_BACKUP },
    { .name = "-endian",           .value = TCFG_ENDIAN },
    { .name = "-coreid",           .value = TCFG_COREID },
    { .name = "-chain-position",   .value = TCFG_CHAIN_POSITION },
    { .name = "-dbgbase",          .value = TCFG_DBGBASE },
    { .name = "-rtos",             .value = TCFG_RTOS },
    { .name = "-defer-examine",    .value = TCFG_DEFER_EXAMINE },
    { .name = "-gdb-port",         .value = TCFG_GDB_PORT },
    { .name = "-gdb-max-connections",   .value = TCFG_GDB_MAX_CONNECTIONS },
    { .name = NULL, .value = -1 }
}

Definition at line 4860 of file target.c.

Referenced by target_configure().

nvp_error_target

const struct nvp nvp_error_target[]

static

Initial value:

= {
    { .value = ERROR_TARGET_INVALID, .name = "err-invalid" },
    { .value = ERROR_TARGET_INIT_FAILED, .name = "err-init-failed" },
    { .value = ERROR_TARGET_TIMEOUT, .name = "err-timeout" },
    { .value = ERROR_TARGET_NOT_HALTED, .name = "err-not-halted" },
    { .value = ERROR_TARGET_FAILURE, .name = "err-failure" },
    { .value = ERROR_TARGET_UNALIGNED_ACCESS, .name = "err-unaligned-access" },
    { .value = ERROR_TARGET_DATA_ABORT, .name = "err-data-abort" },
    { .value = ERROR_TARGET_RESOURCE_NOT_AVAILABLE, .name = "err-resource-not-available" },
    { .value = ERROR_TARGET_TRANSLATION_FAULT, .name = "err-translation-fault" },
    { .value = ERROR_TARGET_NOT_RUNNING, .name = "err-not-running" },
    { .value = ERROR_TARGET_NOT_EXAMINED, .name = "err-not-examined" },
    { .value = -1, .name = NULL }
}

Definition at line 114 of file target.c.

nvp_reset_modes

const struct nvp nvp_reset_modes[]

static

Initial value:

= {
    { .name = "unknown", .value = RESET_UNKNOWN },
    { .name = "run",     .value = RESET_RUN },
    { .name = "halt",    .value = RESET_HALT },
    { .name = "init",    .value = RESET_INIT },
    { .name = NULL,      .value = -1 },
}

Definition at line 146 of file target.c.

Referenced by COMMAND_HANDLER(), target_call_reset_callbacks(), target_process_reset(), and target_reset_mode_name().

nvp_target_debug_reason

const struct nvp nvp_target_debug_reason[]

static

Initial value:

= {
    { .name = "debug-request",             .value = DBG_REASON_DBGRQ },
    { .name = "breakpoint",                .value = DBG_REASON_BREAKPOINT },
    { .name = "watchpoint",                .value = DBG_REASON_WATCHPOINT },
    { .name = "watchpoint-and-breakpoint", .value = DBG_REASON_WPTANDBKPT },
    { .name = "single-step",               .value = DBG_REASON_SINGLESTEP },
    { .name = "target-not-halted",         .value = DBG_REASON_NOTHALTED  },
    { .name = "program-exit",              .value = DBG_REASON_EXIT },
    { .name = "exception-catch",           .value = DBG_REASON_EXC_CATCH },
    { .name = "undefined",                 .value = DBG_REASON_UNDEFINED },
    { .name = NULL, .value = -1 },
}

Definition at line 146 of file target.c.

Referenced by COMMAND_HANDLER(), and debug_reason_name().

nvp_target_endian

const struct jim_nvp nvp_target_endian[]

static

Initial value:

= {
    { .name = "big",    .value = TARGET_BIG_ENDIAN },
    { .name = "little", .value = TARGET_LITTLE_ENDIAN },
    { .name = "be",     .value = TARGET_BIG_ENDIAN },
    { .name = "le",     .value = TARGET_LITTLE_ENDIAN },
    { .name = NULL,     .value = -1 },
}

Definition at line 146 of file target.c.

Referenced by COMMAND_HANDLER(), and target_configure().

nvp_target_event

const struct jim_nvp nvp_target_event[]

static

Definition at line 146 of file target.c.

Referenced by jim_target_invoke_event(), target_configure(), and target_event_name().

nvp_target_state

const struct nvp nvp_target_state[]

static

Initial value:

= {
    { .name = "unknown", .value = TARGET_UNKNOWN },
    { .name = "running", .value = TARGET_RUNNING },
    { .name = "halted",  .value = TARGET_HALTED },
    { .name = "reset",   .value = TARGET_RESET },
    { .name = "debug-running", .value = TARGET_DEBUG_RUNNING },
    { .name = NULL, .value = -1 },
}

Definition at line 146 of file target.c.

Referenced by COMMAND_HANDLER(), target_state_name(), and target_wait_state().

polling_interval

const int polling_interval = TARGET_DEFAULT_POLLING_INTERVAL

static

Definition at line 113 of file target.c.

Referenced by handle_target(), and target_init().

power_dropout

int power_dropout

static

Definition at line 2848 of file target.c.

Referenced by handle_target(), and sense_handler().

run_power_dropout

int run_power_dropout

static

Definition at line 2852 of file target.c.

Referenced by handle_target(), and sense_handler().

run_power_restore

int run_power_restore

static

Definition at line 2851 of file target.c.

Referenced by handle_target(), and sense_handler().

run_srst_asserted

int run_srst_asserted

static

Definition at line 2853 of file target.c.

Referenced by handle_target(), and sense_handler().

run_srst_deasserted

int run_srst_deasserted

static

Definition at line 2854 of file target.c.

Referenced by handle_target(), and sense_handler().

srst_asserted

int srst_asserted

static

Definition at line 2849 of file target.c.

Referenced by aarch64_assert_reset(), arc_assert_reset(), arm7_9_assert_reset(), cortex_m_assert_reset(), handle_target(), hl_assert_reset(), jtag_get_reset_config(), mips_m4k_assert_reset(), and sense_handler().

target_command_handlers

const struct command_registration target_command_handlers[]

static

Initial value:

= {
    {
        .name = "targets",
        .handler = handle_targets_command,
        .mode = COMMAND_ANY,
        .help = "change current default target (one parameter) "
            "or prints table of all targets (no parameters)",
        .usage = "[target]",
    },
    {
        .name = "target",
        .mode = COMMAND_CONFIG,
        .help = "configure target",
        .chain = target_subcommand_handlers,
        .usage = "",
    },
    COMMAND_REGISTRATION_DONE
}

Definition at line 6233 of file target.c.

Referenced by target_register_commands().

target_event_callbacks

struct target_event_callback* target_event_callbacks

static

Definition at line 108 of file target.c.

Referenced by target_call_event_callbacks(), target_quit(), target_register_event_callback(), and target_unregister_event_callback().

target_exec_command_handlers

const struct command_registration target_exec_command_handlers[]

static

Definition at line 6330 of file target.c.

Referenced by target_register_user_commands().

target_instance_command_handlers

const struct command_registration target_instance_command_handlers[]

static

Definition at line 5491 of file target.c.

Referenced by target_create().

target_reset_nag

bool target_reset_nag = true

static

Definition at line 6286 of file target.c.

Referenced by COMMAND_HANDLER(), and get_target_reset_nag().

target_subcommand_handlers

const struct command_registration target_subcommand_handlers[]

static

Definition at line 6051 of file target.c.

target_timer_callbacks

struct target_timer_callback* target_timer_callbacks

static

Definition at line 109 of file target.c.

Referenced by target_call_timer_callbacks_check_time(), target_quit(), target_register_timer_callback(), and target_unregister_timer_callback().

target_timer_next_event_value

int64_t target_timer_next_event_value

static

Definition at line 110 of file target.c.

Referenced by target_call_timer_callbacks_check_time(), target_register_timer_callback(), and target_timer_next_event().

target_types

struct target_type* target_types[]

static

Definition at line 65 of file target.c.

Referenced by COMMAND_HANDLER(), and target_create().