Include dependency graph for target.c:

Data Structures
struct	fast_load

struct	target_event_action

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_poll_interval_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_configure)

	COMMAND_HANDLER (handle_target_create)

	COMMAND_HANDLER (handle_target_current)

	COMMAND_HANDLER (handle_target_current_state)

	COMMAND_HANDLER (handle_target_debug_reason)

	COMMAND_HANDLER (handle_target_disassemble)

	COMMAND_HANDLER (handle_target_event_list)

	COMMAND_HANDLER (handle_target_examine)

	COMMAND_HANDLER (handle_target_examine_deferred)

	COMMAND_HANDLER (handle_target_get_reg)

	COMMAND_HANDLER (handle_target_halt)

	COMMAND_HANDLER (handle_target_halt_gdb)

	COMMAND_HANDLER (handle_target_init_command)

	COMMAND_HANDLER (handle_target_invoke_event)

	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_target_write_memory)

	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)

static	COMMAND_HELPER (target_configure, struct target *target, unsigned int index, bool is_configure)

static int	compare_pc32 (const void p1, const void p2)

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_one_target (struct target *target)

static int	handle_target (void *priv)

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

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

static int	no_mmu (struct target target, bool enabled)

static	OOCD_LIST_HEAD (empty_smp_targets)

static	OOCD_LIST_HEAD (target_reset_callback_list)

static	OOCD_LIST_HEAD (target_trace_callback_list)

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, unsigned int num_blocks, uint8_t erased_value, unsigned int *checked)

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)

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)

static struct target_timer_callback *	target_find_timer_callback (int(callback)(void priv), void *priv)

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 include_address)

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_insn_set (struct command_invocation cmd, struct target target, const char **insn_set)

bool	target_memory_ready (struct target *target)
	Returns true if target memory is ready to read/write. More...

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_active_polled (struct target *target)

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, bool current, target_addr_t address, bool handle_breakpoints, bool 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, bool current, target_addr_t address, bool 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)

static int	target_timer_callback_set_period (struct target_timer_callback *cb, unsigned int time_ms)

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 (const uint32_t samples, uint32_t sample_num, const char filename, struct target *target, uint32_t duration_ms)

static void	write_gmon_hist (FILE f, const uint32_t samples, uint32_t sample_num, float sample_rate, struct target *target)

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 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 nvp	nvp_target_endian []

static const struct nvp	nvp_target_event []

static const struct nvp	nvp_target_state []

static unsigned int	polling_interval = TARGET_DEFAULT_POLLING_INTERVAL

static int	run_power_dropout

static int	run_power_restore

static int	run_srst_asserted

static int	run_srst_deasserted

static int	sensed_power_dropout

static int	sensed_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 56 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 3485 of file target.c.

◆ UNIT

typedef unsigned char UNIT[2]

Definition at line 4222 of file target.c.

Enumeration Type Documentation

◆ nvp_assert

enum nvp_assert

Enumerator
NVP_DEASSERT
NVP_ASSERT

Definition at line 126 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 4888 of file target.c.

◆ verify_mode

enum verify_mode

Enumerator
IMAGE_TEST
IMAGE_VERIFY
IMAGE_CHECKSUM_ONLY

Definition at line 3774 of file target.c.

Function Documentation

◆ attribute()

static struct target_list* __attribute__ ( (warn_unused_result) )

static

Definition at line 6049 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 308 of file target.c.

References all_targets, and target.

Referenced by COMMAND_HANDLER().

◆ binprint()

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

static

Definition at line 6394 of file target.c.

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

Referenced by COMMAND_HANDLER().

◆ COMMAND_HANDLER() [1/52]

COMMAND_HANDLER ( handle_bp_command )

Definition at line 4004 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/52]

COMMAND_HANDLER ( handle_dump_image_command )

Definition at line 3712 of file target.c.

References address, 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/52]

COMMAND_HANDLER ( handle_fast_load_command )

Definition at line 6299 of file target.c.

References address, 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/52]

COMMAND_HANDLER ( handle_fast_load_image_command )

Definition at line 6197 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/52]

COMMAND_HANDLER ( handle_halt_command )

Definition at line 3267 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/52]

COMMAND_HANDLER ( handle_load_image_command )

Definition at line 3628 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/52]

COMMAND_HANDLER ( handle_md_command )

Definition at line 3427 of file target.c.

References address, 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/52]

COMMAND_HANDLER ( handle_mw_command )

Definition at line 3549 of file target.c.

References address, 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/52]

COMMAND_HANDLER ( handle_poll_command )

Definition at line 3154 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/52]

COMMAND_HANDLER ( handle_poll_interval_command )

Definition at line 3183 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, command_print(), ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, handle_target(), polling_interval, target_find_timer_callback(), and target_timer_callback_set_period().

◆ COMMAND_HANDLER() [11/52]

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 4320 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_NUMBER, command_print(), compare_pc32(), 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() [12/52]

COMMAND_HANDLER ( handle_ps_command )

Definition at line 6373 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() [13/52]

COMMAND_HANDLER ( handle_rbp_command )

Definition at line 4048 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() [14/52]

COMMAND_HANDLER ( handle_reg_command )

◆ COMMAND_HANDLER() [15/52]

COMMAND_HANDLER ( handle_reset_command )

Definition at line 3302 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() [16/52]

COMMAND_HANDLER ( handle_resume_command )

Definition at line 3321 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() [17/52]

COMMAND_HANDLER ( handle_rwp_command )

Definition at line 4151 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() [18/52]

COMMAND_HANDLER ( handle_set_reg_command )

Definition at line 4810 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, ERROR_TARGET_NOT_HALTED, reg::exist, get_current_target(), length, LOG_ERROR, target::reg_cache, register_get_by_name(), reg_arch_type::set, reg::size, target::state, TARGET_HALTED, target_name(), and reg::type.

◆ COMMAND_HANDLER() [19/52]

COMMAND_HANDLER ( handle_soft_reset_halt_command )

Definition at line 3291 of file target.c.

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

◆ COMMAND_HANDLER() [20/52]

COMMAND_HANDLER ( handle_step_command )

Definition at line 3341 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() [21/52]

COMMAND_HANDLER ( handle_target_configure )

Definition at line 5308 of file target.c.

References CALL_COMMAND_HANDLER, CMD_ARGC, CMD_CTX, CMD_NAME, ERROR_COMMAND_SYNTAX_ERROR, and get_current_target().

◆ COMMAND_HANDLER() [22/52]

COMMAND_HANDLER ( handle_target_create )

Definition at line 5791 of file target.c.

References alloc_printf(), append_to_list_all_targets(), target::arch_info, ARRAY_SIZE, target::backup_working_area, target::breakpoints, CALL_COMMAND_HANDLER, command_registration::chain, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, CMD_JIMTCL_ARGV, target::cmd_name, COMMAND_ANY, command_print(), COMMAND_REGISTRATION_DONE, target_type::commands, target::coreid, target::dap_configured, target::dbg_msg_enabled, DBG_REASON_UNDEFINED, target::dbgmsg, target::debug_reason, target_type::deinit_target, target::endianness, ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, target::events_action, target::gdb_max_connections, target::gdb_port_override, get_current_transport(), target::halt_issued, target::has_dap, INIT_LIST_HEAD(), LOG_DEBUG, LOG_ERROR, LOG_INFO, command_registration::name, name, target::next, NULL, transport::override_target, target::private_config, 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_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.

◆ COMMAND_HANDLER() [23/52]

COMMAND_HANDLER ( handle_target_current )

Definition at line 6011 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() [24/52]

COMMAND_HANDLER ( handle_target_current_state )

Definition at line 5518 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() [25/52]

COMMAND_HANDLER ( handle_target_debug_reason )

Definition at line 5530 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() [26/52]

COMMAND_HANDLER ( handle_target_disassemble )

Definition at line 5568 of file target.c.

References address, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, COMMAND_PARSE_ADDRESS, COMMAND_PARSE_NUMBER, count, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), LOG_TARGET_DEBUG, oocd_cs_disassemble(), oocd_cs_list_insn_types(), and target_insn_set().

◆ COMMAND_HANDLER() [27/52]

COMMAND_HANDLER ( handle_target_event_list )

Definition at line 5498 of file target.c.

References target_event_action::body, CMD, CMD_CTX, command_print(), ERROR_OK, target_event_action::event, target::events_action, get_current_target(), target_event_action::list, list_for_each_entry, NULL, target_event_name(), and target_name().

◆ COMMAND_HANDLER() [28/52]

COMMAND_HANDLER ( handle_target_examine )

Definition at line 5320 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() [29/52]

COMMAND_HANDLER ( handle_target_examine_deferred )

Definition at line 5368 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() [30/52]

COMMAND_HANDLER ( handle_target_get_reg )

Definition at line 4748 of file target.c.

References buf_to_hex_str(), CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, CMD_JIMTCL_ARGV, command_print(), ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, ERROR_TARGET_NOT_HALTED, reg::exist, reg_arch_type::get, get_current_target(), length, LOG_ERROR, target::reg_cache, register_get_by_name(), reg::size, target::state, TARGET_HALTED, target_name(), reg::type, reg::valid, and reg::value.

◆ COMMAND_HANDLER() [31/52]

COMMAND_HANDLER ( handle_target_halt )

Definition at line 5451 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() [32/52]

COMMAND_HANDLER ( handle_target_halt_gdb )

Definition at line 5380 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() [33/52]

COMMAND_HANDLER ( handle_target_init_command )

Definition at line 1593 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() [34/52]

COMMAND_HANDLER ( handle_target_invoke_event )

Definition at line 5552 of file target.c.

References CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_OK, get_current_target(), nvp::name, NULL, nvp_name2value(), nvp_target_event, nvp_unknown_command_print(), target_handle_event(), and nvp::value.

◆ COMMAND_HANDLER() [35/52]

COMMAND_HANDLER ( handle_target_names )

Definition at line 6034 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() [36/52]

COMMAND_HANDLER ( handle_target_poll )

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, ERROR_TARGET_NOT_EXAMINED, get_current_target(), target_type::poll, target::tap, target_was_examined(), and target::type.

◆ COMMAND_HANDLER() [37/52]

COMMAND_HANDLER ( handle_target_read_memory )

Definition at line 4434 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() [38/52]

COMMAND_HANDLER ( handle_target_reset )

◆ COMMAND_HANDLER() [39/52]

COMMAND_HANDLER ( handle_target_reset_nag )

Definition at line 6366 of file target.c.

References CALL_COMMAND_HANDLER, and target_reset_nag.

◆ COMMAND_HANDLER() [40/52]

COMMAND_HANDLER ( handle_target_smp )

Definition at line 6086 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() [41/52]

COMMAND_HANDLER ( handle_target_types )

Definition at line 6023 of file target.c.

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

◆ COMMAND_HANDLER() [42/52]

COMMAND_HANDLER ( handle_target_wait_state )

Definition at line 5465 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() [43/52]

COMMAND_HANDLER ( handle_target_was_examined )

Definition at line 5356 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() [44/52]

COMMAND_HANDLER ( handle_target_write_memory )

Definition at line 4559 of file target.c.

References addr, buffer, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, CMD_JIMTCL_ARGV, COMMAND_PARSE_NUMBER, command_print(), count, ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, get_current_target(), LOG_DEBUG, 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.

◆ COMMAND_HANDLER() [45/52]

COMMAND_HANDLER ( handle_targets_command )

Definition at line 2806 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(), nvp::name, target::next, nvp_target_endian, nvp_value2name(), state, target::tap, target, target_name(), target_state_name(), and target_type_name().

◆ COMMAND_HANDLER() [46/52]

COMMAND_HANDLER ( handle_test_image_command )

Definition at line 3929 of file target.c.

References CALL_COMMAND_HANDLER, and IMAGE_TEST.

◆ COMMAND_HANDLER() [47/52]

COMMAND_HANDLER ( handle_test_mem_access_command )

◆ COMMAND_HANDLER() [48/52]

COMMAND_HANDLER ( handle_verify_image_checksum_command )

Definition at line 3919 of file target.c.

References CALL_COMMAND_HANDLER, and IMAGE_CHECKSUM_ONLY.

◆ COMMAND_HANDLER() [49/52]

COMMAND_HANDLER ( handle_verify_image_command )

Definition at line 3924 of file target.c.

References CALL_COMMAND_HANDLER, and IMAGE_VERIFY.

◆ COMMAND_HANDLER() [50/52]

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 4185 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() [51/52]

COMMAND_HANDLER ( handle_wait_halt_command )

Definition at line 3213 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() [52/52]

COMMAND_HANDLER ( handle_wp_command )

Definition at line 4077 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/3]

static COMMAND_HELPER	(	handle_verify_image_command_internal	,
		enum verify_mode	verify
	)

static

◆ COMMAND_HELPER() [2/3]

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

static

Definition at line 3596 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.

◆ COMMAND_HELPER() [3/3]

static COMMAND_HELPER	(	target_configure	,
		struct target *	target,
		unsigned int	index,
		bool	is_configure
	)

static

Definition at line 4923 of file target.c.

References jim_getopt_info::argc, target::backup_working_area, target_event_action::body, CMD, CMD_ARGC, CMD_ARGV, CMD_CTX, CMD_JIMTCL_ARGV, COMMAND_CONFIG, command_parse_bool_arg(), COMMAND_PARSE_NUMBER, command_print(), CONNECTION_LIMIT_UNLIMITED, target::coreid, target::dbgbase, target::dbgbase_set, target::defer_examine, jtag_tap::dotted_name, target::endianness, ERROR_COMMAND_ARGUMENT_INVALID, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, target_event_action::event, target::events_action, target::gdb_max_connections, target::gdb_port_override, target::has_dap, target_event_action::interp, jim_getopt_info::is_configure, jim_getopt_setup(), jtag_tap_by_string(), target_event_action::list, list_add(), list_del(), list_for_each_entry, LOG_ERROR, LOG_INFO, nvp::name, rtos_type::name, NULL, nvp_config_opts, nvp_name2value(), nvp_target_endian, nvp_target_event, nvp_unknown_command_print(), nvp_value2name(), target::rtos, rtos_create(), target::tap, target::tap_configured, TARGET_ADDR_FMT, 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, rtos::type, target::type, 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.

◆ compare_pc32()

static int compare_pc32	(	const void *	p1,
		const void *	p2
	)

static

Definition at line 4311 of file target.c.

Referenced by COMMAND_HANDLER().

◆ debug_reason_name()

const char* debug_reason_name ( const struct target * t )

Definition at line 258 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(), riscv_arch_state(), and stm8_arch_state().

◆ default_check_reset()

static int default_check_reset ( struct target * target )

static

Definition at line 679 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 673 of file target.c.

References ERROR_OK.

Referenced by target_init_one().

◆ find_target()

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

static

Definition at line 2784 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 6187 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 )

◆ get_current_target_or_null()

struct target* get_current_target_or_null ( struct command_context * cmd_ctx )

Definition at line 481 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 444 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 6361 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 6067 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 3934 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 3969 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_one_target()

static int handle_one_target ( struct target * target )

static

Definition at line 2909 of file target.c.

References jtag_tap::enabled, ERROR_OK, LOG_TARGET_ERROR, target::tap, target_active_polled(), target_examine_one(), target_poll(), and target_reset_examined().

Referenced by handle_target().

◆ handle_target()

static int handle_target ( void * priv )

static

Definition at line 2924 of file target.c.

References all_targets, target::backoff, ERROR_OK, handle_one_target(), backoff_timer::interval, is_jtag_poll_safe(), LOG_INFO, LOG_TARGET_DEBUG_IO, MAX, MIN, target::next, backoff_timer::next_attempt, polling_interval, priv, run_power_dropout, run_power_restore, run_srst_asserted, run_srst_deasserted, sense_handler(), sensed_power_dropout, sensed_srst_asserted, target, TARGET_MAX_POLLING_INTERVAL_MS, and timeval_ms().

Referenced by COMMAND_HANDLER(), and target_init().

◆ identity_virt2phys()

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

static

Definition at line 647 of file target.c.

References ERROR_OK.

Referenced by target_init_one().

◆ jtag_enable_callback()

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

static

Definition at line 708 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().

◆ no_mmu()

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

static

Definition at line 654 of file target.c.

References ERROR_OK.

Referenced by target_init_one().

◆ OOCD_LIST_HEAD() [1/3]

static OOCD_LIST_HEAD ( empty_smp_targets )

static

◆ OOCD_LIST_HEAD() [2/3]

static OOCD_LIST_HEAD ( target_reset_callback_list )

static

◆ OOCD_LIST_HEAD() [3/3]

static OOCD_LIST_HEAD ( target_trace_callback_list )

static

◆ print_wa_layout()

static void print_wa_layout ( struct target * target )

static

Definition at line 1947 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 2857 of file target.c.

References ERROR_OK, jtag_power_dropout(), jtag_srst_asserted(), run_power_dropout, run_power_restore, run_srst_asserted, run_srst_deasserted, sensed_power_dropout, sensed_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 1317 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 1327 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 1337 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 1353 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 1483 of file target.c.

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

Referenced by get_rtt_params(), read_rtt_channel(), 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 1474 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 2112 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(), bl602_alloc_bounce_buffer(), bl602_alloc_sflash_cfg(), bl602_call_func(), bl602_flash_init(), bl602_flash_read_id(), bluenrgx_write_with_loader(), cc26xx_init(), cc3220sf_write(), cfi_intel_write_block(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), COMMAND_HANDLER(), dw_spi_ctrl_check_sectors_fill(), dw_spi_ctrl_erase_sectors(), dw_spi_ctrl_program(), dw_spi_ctrl_read(), dw_spi_ctrl_transaction(), efm32_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(), hpm_xpi_erase(), hpm_xpi_erase_chip(), hpm_xpi_probe(), hpm_xpi_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(), rp2xxx_flash_write(), rsl10_ll_flash_erase(), rsl10_ll_flash_write(), rsl10_mass_erase(), scratch_reserve(), setup_for_raw_flash_cmd(), sh_qspi_upload_helper(), sim3x_write_block(), sromalgo_prepare(), stellaris_write_block(), stm32h7_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 2018 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(), 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(), stm32h7_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 2310 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,
		unsigned int	num_blocks,
		uint8_t	erased_value,
		unsigned int *	checked
	)

Definition at line 2561 of file target.c.

References target_type::blank_check_memory, ERROR_NOT_IMPLEMENTED, ERROR_TARGET_NOT_EXAMINED, LOG_TARGET_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
	)

◆ 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 412 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 336 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 327 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(), fill_task(), get_current(), get_name(), handle_iod_output(), lpc2000_iap_call(), mips_m4k_set_breakpoint(), mips_m4k_unset_breakpoint(), mips_mips64_unset_sdbbp(), next_task(), nuttx_cortex_m_tcbinfo_stack_read(), nuttx_update_threads(), psoc4_get_family(), qn908x_probe(), read_rtt_channel(), rp2350_restore_accessctrl(), rtos_cortex_m_stack_align(), semihosting_get_field(), target_buffer_get_addr(), target_buffer_get_u32_array(), target_handle_md_output(), target_read_u32(), target_rtt_read_control_block(), 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 404 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 318 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_rtt_channel(), 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 396 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 381 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_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 436 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 372 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 363 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(), dw_spi_ctrl_check_sectors_fill(), dw_spi_ctrl_erase_sectors(), dw_spi_ctrl_program(), dw_spi_ctrl_read(), dw_spi_ctrl_transaction(), 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(), rp2350_restore_accessctrl(), rp2xxx_call_rom_func_batch(), semihosting_set_field(), sim3x_flash_protect(), stm32l4_write_block(), target_buffer_set_u32_array(), target_fill_io(), target_fill_mem(), 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
	)

◆ target_buffer_set_u64()

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

Definition at line 354 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_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 420 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 390 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 1816 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_smp(), aarch64_resume(), aarch64_smp_postponed_halt_events(), 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_restore_smp(), 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(), 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_impl(), 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 1841 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 1871 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 1930 of file target.c.

References target_call_timer_callbacks_check_time().

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

◆ target_call_timer_callbacks_check_time()

static int target_call_timer_callbacks_check_time ( int checktime )

static

Definition at line 1882 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 1936 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 1854 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 2530 of file target.c.

References address, buffer, target_type::checksum_memory, ERROR_FAIL, ERROR_OK, ERROR_TARGET_NOT_EXAMINED, image_calculate_checksum(), LOG_ERROR, LOG_TARGET_ERROR, LOG_TARGET_INFO, size, target_read_buffer(), target_was_examined(), and target::type.

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

◆ 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 1490 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 6874 of file target.c.

Referenced by gdb_last_signal().

◆ target_destroy()

static void target_destroy ( struct target * target )

static

◆ target_event_name()

const char* target_event_name ( enum target_event event )

Return the name of a target event enumeration value.

Definition at line 286 of file target.c.

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

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 725 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 686 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_one_target(), hl_assert_reset(), jtag_enable_callback(), riscv013_authdata_write(), 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 3488 of file target.c.

References address, 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_find_timer_callback()

static struct target_timer_callback* target_find_timer_callback	(	int()(void priv)	callback,
		void *	priv
	)

static

Definition at line 1787 of file target.c.

References target_timer_callback::callback, target_timer_callback::next, NULL, priv, and target_timer_callbacks.

Referenced by COMMAND_HANDLER(), and target_unregister_timer_callback().

◆ target_free_all_working_areas()

void target_free_all_working_areas ( struct target * target )

◆ target_free_all_working_areas_restore()

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

static

Definition at line 2178 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 2170 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(), bl602_alloc_sflash_cfg(), bl602_call_func(), bl602_erase(), bl602_flash_init(), bl602_flash_read_id(), bl602_read(), bl602_write(), bluenrgx_write_with_loader(), cc26xx_init(), cc26xx_quit(), cc3220sf_write(), cfi_intel_write_block(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), cleanup_after_raw_flash_cmd(), COMMAND_HANDLER(), dw_spi_ctrl_check_sectors_fill(), dw_spi_ctrl_erase_sectors(), dw_spi_ctrl_program(), dw_spi_ctrl_read(), dw_spi_ctrl_transaction(), efm32_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(), hpm_xpi_erase(), hpm_xpi_erase_chip(), hpm_xpi_probe(), hpm_xpi_write(), 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(), rp2xxx_flash_write(), rsl10_ll_flash_erase(), rsl10_ll_flash_write(), rsl10_mass_erase(), scratch_release(), setup_for_raw_flash_cmd(), sh_qspi_upload_helper(), sim3x_write_block(), sromalgo_prepare(), sromalgo_release(), stellaris_write_block(), stm32h7_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 2138 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 1465 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 2333 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 1385 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 1456 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 2323 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 1392 of file target.c.

References ERROR_FAIL, ERROR_OK, ERROR_TARGET_NOT_EXAMINED, target_type::get_gdb_reg_list, LOG_TARGET_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 1415 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 )

◆ target_halt()

int target_halt ( struct target * target )

Definition at line 518 of file target.c.

References ERROR_OK, ERROR_TARGET_NOT_EXAMINED, target_type::halt, target::halt_issued, target::halt_issued_time, LOG_TARGET_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
	)

◆ 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,
		bool	include_address
	)

Definition at line 3363 of file target.c.

References address, 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 4877 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 1367 of file target.c.

References ERROR_NOT_IMPLEMENTED, 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 1567 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

◆ target_insn_set()

static int target_insn_set	(	struct command_invocation *	cmd,
		struct target *	target,
		const char **	insn_set
	)

static

Definition at line 2387 of file target.c.

References cmd, command_print(), ERROR_NOT_IMPLEMENTED, target_type::insn_set, oocd_cs_list_insn_types(), target_name(), and target::type.

Referenced by COMMAND_HANDLER().

◆ target_memory_ready()

bool target_memory_ready ( struct target * target )

Returns true if target memory is ready to read/write.

This routine is a wrapper for target->type->memory_ready. If the target specific check is not implemented, returns target_was_examined()

Definition at line 1253 of file target.c.

References target_type::memory_ready, target_was_examined(), and target::type.

Referenced by target_read_buffer(), target_read_memory(), target_read_phys_memory(), target_write_buffer(), target_write_memory(), and target_write_phys_memory().

◆ target_merge_working_areas()

static void target_merge_working_areas ( struct target * target )

static

Definition at line 1990 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 )

◆ target_process_reset()

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

static

Definition at line 604 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 1497 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 2339 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 2281 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 2470 of file target.c.

References address, buffer, ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, LOG_TARGET_ERROR, target_type::read_buffer, size, TARGET_ADDR_FMT, target_memory_ready(), 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(), artery_usd_read(), bl602_read(), 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(), dw_spi_ctrl_check_sectors_fill(), dw_spi_ctrl_read(), dw_spi_ctrl_transaction(), ecos_get_thread_reg_list(), ecos_update_threads(), efm32_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(), oocd_cs_disassemble(), read_channel_name(), read_from_channel(), read_rtt_channel(), riot_update_threads(), riscv_hit_watchpoint(), riscv_run_algorithm(), 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 2494 of file target.c.

References address, 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 1261 of file target.c.

References address, buffer, count, ERROR_FAIL, LOG_TARGET_ERROR, target_type::read_memory, size, target_memory_ready(), 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(), rp2350_save_accessctrl(), sam3_page_read(), sam4_page_read(), sam4l_write_page_partial(), samd_modify_user_row_masked(), same5_modify_user_row_masked(), samv_efc_read_sequence(), samv_read(), samv_read_standard_page(), 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 1275 of file target.c.

References address, buffer, count, ERROR_FAIL, LOG_TARGET_ERROR, target_type::read_phys_memory, size, target_memory_ready(), 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 2617 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_buffer_get_u16(), target_read_memory(), 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(), efm32_read_info(), 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_rom_symbol(), rp2350_a0_lookup_symbol(), rp2350_lookup_rom_symbol(), rp2xxx_lookup_rom_symbol(), rtkernel_add_task(), samd_check_error(), samd_protect_check(), same5_wait_and_check_error(), stm32h7_probe(), 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 2597 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_buffer_get_u32(), target_read_memory(), 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(), artery_enable_hiclk(), artery_probe(), artery_read_flash_register(), at91sam7_get_flash_status(), at91sam7_read_clock_info(), at91sam7_read_part_info(), at91sam9_nand_ready(), at91sam9_read_page(), at91sam9_write_page(), bl602_call_romapi_func(), bl602_flash_gpio_init(), bl602_flash_read_id(), bluenrgx_probe(), bluenrgx_read_flash_reg(), bluenrgx_write_with_loader(), 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(), cortex_m_set_secure(), davinci_init(), davinci_nand_ready(), davinci_read_block_data(), davinci_write_page_ecc1(), davinci_write_page_ecc4(), davinci_write_page_ecc4infix(), dw_spi_ctrl_mode(), dw_spi_ctrl_mode_configure(), efc_get_result(), efc_get_status(), efm32_read_info(), efm32_read_lock_data(), efm32_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(), hpm_xpi_probe(), 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(), mspm0_erase(), mspm0_fctl_get_sector_reg(), mspm0_fctl_wait_cmd_ok(), mspm0_read_part_info(), mspm0_write(), 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_spi_tx_rx(), rp2040_ssel_active(), rp2350_init_accessctrl(), rp2350_spi_tx_rx(), rp2xxx_flash_probe(), rp2xxx_lookup_rom_symbol(), 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_mode(), 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(), stm32h7_read_flash_reg(), stm32h7_read_id_code(), 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_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 2577 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_buffer_get_u64(), target_read_memory(), 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 2637 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_read_memory(), 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(), efm32_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 6354 of file target.c.

References NULL, register_commands(), and target_command_handlers.

◆ 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 1623 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 1645 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 1701 of file target.c.

References target_timer_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, NULL, priv, target_timer_callback_set_period(), target_timer_callbacks, target_timer_callback::time_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(), target_init(), and vdebug_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 1667 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 6859 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 1347 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 1362 of file target.c.

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

Referenced by watchpoint_free().

◆ target_reset_active_polled()

static void target_reset_active_polled ( struct target * target )

inlinestatic

Definition at line 668 of file target.c.

References target::active_polled.

Referenced by COMMAND_HANDLER(), and target_init_one().

◆ target_reset_examined()

static void target_reset_examined ( struct target * target )

inlinestatic

Reset the examined flag for the given target.

Definition at line 663 of file target.c.

References target::examined.

Referenced by COMMAND_HANDLER(), handle_one_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 297 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 2123 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,
		bool	current,
		target_addr_t	address,
		bool	handle_breakpoints,
		bool	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 567 of file target.c.

References address, ERROR_OK, ERROR_TARGET_NOT_EXAMINED, jtag_poll_mask(), jtag_poll_unmask(), LOG_TARGET_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 787 of file target.c.

References target::arch_info, ERROR_FAIL, ERROR_TARGET_NOT_EXAMINED, LOG_ERROR, LOG_TARGET_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(), bl602_call_func(), cc3220sf_write(), cfi_intel_write_block(), cfi_spansion_write_block(), cfi_spansion_write_block_mips(), dw_spi_ctrl_check_sectors_fill(), dw_spi_ctrl_erase_sectors(), dw_spi_ctrl_program(), dw_spi_ctrl_read(), dw_spi_ctrl_transaction(), em357_write_block(), fespi_write(), fm3_chip_erase(), fm3_erase(), fm3_write_block(), fm4_flash_erase(), fm4_flash_write(), hpm_xpi_erase(), hpm_xpi_erase_chip(), hpm_xpi_probe(), hpm_xpi_run_algo_flash_init(), hpm_xpi_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(), rp2350_init_arm_core0(), rp2xxx_call_rom_func_batch(), 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 946 of file target.c.

References alive_sleep(), target::arch_info, buffer, buffer_size, 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_with_loader(), efm32_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(), stm32h7_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 1099 of file target.c.

References alive_sleep(), target::arch_info, buffer, buffer_size, 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 755 of file target.c.

References ERROR_FAIL, ERROR_TARGET_NOT_EXAMINED, LOG_ERROR, LOG_TARGET_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 1960 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 829 of file target.c.

References target::arch_info, ERROR_FAIL, ERROR_TARGET_NOT_EXAMINED, LOG_ERROR, LOG_TARGET_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 271 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(), ambiqmicro_exec_command(), 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(), esp32_soc_reset(), esp32s2_soc_reset(), esp32s3_soc_reset(), 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(), riscv_resume(), stm8_debug_entry(), stm8_halt(), stm8_poll(), tcl_target_callback_event_handler(), xscale_assert_reset(), xscale_halt(), and xtensa_smpbreak_set().

◆ target_step()

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

Step the target.

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

Definition at line 1435 of file target.c.

References address, ERROR_OK, ERROR_TARGET_NOT_EXAMINED, LOG_TARGET_ERROR, target_type::step, target_call_event_callbacks(), TARGET_EVENT_STEP_END, TARGET_EVENT_STEP_START, target_was_examined(), 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 156 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 1426 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 1864 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_callback_set_period()

static int target_timer_callback_set_period	(	struct target_timer_callback *	cb,
		unsigned int	time_ms
	)

static

Definition at line 1689 of file target.c.

References ERROR_FAIL, ERROR_OK, MIN, target_timer_next_event_value, target_timer_callback::time_ms, timeval_ms(), and target_timer_callback::when.

Referenced by COMMAND_HANDLER(), and target_register_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 1941 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 750 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(), COMMAND_HELPER(), ecos_create(), embeddedice_build_reg_cache(), embkernel_create(), freertos_create(), max32xxx_write_block(), mqx_create(), nuttx_create(), riot_create(), rtkernel_create(), stm32x_get_property_addr(), 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 1726 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 1749 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 1802 of file target.c.

References target_timer_callback::callback, ERROR_COMMAND_SYNTAX_ERROR, ERROR_FAIL, ERROR_OK, priv, target_timer_callback::removed, and target_find_timer_callback().

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(), target_call_timer_callback(), and vdebug_quit().

◆ 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 1768 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 874 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
	)

◆ target_write_buffer()

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

Definition at line 2405 of file target.c.

References address, buffer, ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, LOG_TARGET_ERROR, size, TARGET_ADDR_FMT, target_memory_ready(), 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(), bl602_alloc_sflash_cfg(), bl602_call_func(), bl602_flash_init(), bl602_flash_read_id(), bl602_write(), bluenrgx_write_with_loader(), 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(), dw_spi_ctrl_check_sectors_fill(), dw_spi_ctrl_erase_sectors(), dw_spi_ctrl_program(), dw_spi_ctrl_read(), dw_spi_ctrl_transaction(), efm32_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(), hpm_xpi_erase(), hpm_xpi_erase_chip(), hpm_xpi_probe(), hpm_xpi_write(), 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(), mspm0_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(), riscv_run_algorithm(), rp2xxx_call_rom_func_batch(), rp2xxx_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(), stm32h7_write(), stm32h7_write_block(), stm32l4_write_block(), stm32lx_write(), stm32lx_write_half_pages(), 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 2429 of file target.c.

References address, 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 1289 of file target.c.

References address, buffer, count, ERROR_FAIL, LOG_TARGET_ERROR, size, target_memory_ready(), target::type, and target_type::write_memory.

Referenced by aarch64_set_breakpoint(), aarch64_unset_breakpoint(), arm7_9_unset_breakpoint(), arm_code_to_working_area(), artery_write_without_loader(), at91sam7_write(), bluenrgx_write_without_loader(), 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(), rp2350_init_arm_core0(), rp2350_restore_accessctrl(), 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_write_standard_page(), samv_write_user_signature(), 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_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 1303 of file target.c.

References address, buffer, count, ERROR_FAIL, LOG_TARGET_ERROR, size, target_memory_ready(), target::type, and target_type::write_phys_memory.

Referenced by COMMAND_HANDLER(), 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 2753 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_buffer_set_u16(), 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 2736 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_buffer_set_u32(), 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 2719 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_buffer_set_u64(), 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 2770 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, 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 2688 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_buffer_set_u16(), target_write_memory(), and reg::value.

Referenced by aduc702x_erase(), aduc702x_set_write_enable(), aduc702x_write_single(), arc_set_breakpoint(), arm7_9_set_breakpoint(), artery_disable_fap(), 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 2671 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_buffer_set_u32(), 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(), artery_enable_hiclk(), artery_usd_write(), artery_write_flash_register(), 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_security_restore(), cortex_m_set_breakpoint(), cortex_m_set_secure(), 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(), dw_spi_ctrl_configure_si(), dw_spi_ctrl_configure_speed(), dw_spi_ctrl_disable_interrupts(), dw_spi_ctrl_mode(), dw_spi_master_ctrl_enable(), efc_start_command(), efm32_msc_clock_enable(), efm32_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(), mspm0_erase(), mspm0_fctl_cfg_command(), mspm0_fctl_sector_erase(), mspm0_fctl_unprotect_sector(), mspm0_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_tx_rx(), rp2040_ssel_active(), rp2350_init_accessctrl(), rp2350_spi_tx_rx(), 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_set_mode(), samv_efc_start_command(), set_mm_mode(), setup_for_raw_flash_cmd(), 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(), stm32h7_write_flash_reg(), 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_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 2654 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, target_buffer_set_u64(), 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 2705 of file target.c.

References address, ERROR_OK, LOG_DEBUG, TARGET_ADDR_FMT, 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 4202 of file target.c.

References LOG_ERROR.

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

◆ write_gmon()

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

static

Definition at line 4278 of file target.c.

References write_gmon_hist(), write_long(), and write_string().

Referenced by COMMAND_HANDLER().

◆ write_gmon_hist()

static void write_gmon_hist	(	FILE *	f,
		const uint32_t *	samples,
		uint32_t	sample_num,
		float	sample_rate,
		struct target *	target
	)

static

Definition at line 4224 of file target.c.

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

Referenced by write_gmon().

◆ write_long()

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

static

Definition at line 4209 of file target.c.

References target_buffer_set_u32(), and write_data().

Referenced by write_gmon(), and write_gmon_hist().

◆ write_string()

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

static

Definition at line 4217 of file target.c.

References write_data().

Referenced by write_gmon(), and write_gmon_hist().

Variable Documentation

◆ all_targets

struct target* all_targets

Definition at line 117 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 6185 of file target.c.

Referenced by COMMAND_HANDLER(), and free_fastload().

◆ fastload_num

int fastload_num

static

Definition at line 6184 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 124 of file target.c.

◆ nvp_config_opts

struct 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 4877 of file target.c.

Referenced by COMMAND_HELPER().

◆ 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 124 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 156 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 156 of file target.c.

Referenced by COMMAND_HANDLER(), and debug_reason_name().

◆ nvp_target_endian

const struct 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 156 of file target.c.

Referenced by COMMAND_HANDLER(), and COMMAND_HELPER().

◆ nvp_target_event

const struct nvp nvp_target_event[]

static

Definition at line 156 of file target.c.

Referenced by COMMAND_HANDLER(), COMMAND_HELPER(), 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 = "unavailable", .value = TARGET_UNAVAILABLE },
    { .name = NULL, .value = -1 },
}

Definition at line 156 of file target.c.

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

◆ polling_interval

unsigned int polling_interval = TARGET_DEFAULT_POLLING_INTERVAL

static

Definition at line 123 of file target.c.

Referenced by COMMAND_HANDLER(), handle_target(), and target_init().

◆ run_power_dropout

int run_power_dropout

static

Definition at line 2853 of file target.c.

Referenced by handle_target(), and sense_handler().

◆ run_power_restore

int run_power_restore

static

Definition at line 2852 of file target.c.

Referenced by handle_target(), and sense_handler().

◆ run_srst_asserted

int run_srst_asserted

static

Definition at line 2854 of file target.c.

Referenced by handle_target(), and sense_handler().

◆ run_srst_deasserted

int run_srst_deasserted

static

Definition at line 2855 of file target.c.

Referenced by handle_target(), and sense_handler().

◆ sensed_power_dropout

int sensed_power_dropout

static

Definition at line 2849 of file target.c.

Referenced by handle_target(), and sense_handler().

◆ sensed_srst_asserted

int sensed_srst_asserted

static

Definition at line 2850 of file target.c.

Referenced by handle_target(), 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 = "",
    },
    {
        .name = "poll_interval",
        .handler = handle_poll_interval_command,
        .mode = COMMAND_ANY,
        .help = "print or set the target state polling interval",
        .usage = "[milliseconds]",
    },
    COMMAND_REGISTRATION_DONE
}

Definition at line 6299 of file target.c.

Referenced by target_register_commands().

◆ target_event_callbacks

struct target_event_callback* target_event_callbacks

static

Definition at line 118 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 6403 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 5568 of file target.c.

Referenced by COMMAND_HANDLER().

◆ target_reset_nag

bool target_reset_nag = true

static

Definition at line 6359 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 6086 of file target.c.

◆ target_timer_callbacks

struct target_timer_callback* target_timer_callbacks

static

Definition at line 119 of file target.c.

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

◆ target_timer_next_event_value

int64_t target_timer_next_event_value

static

Definition at line 120 of file target.c.

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

◆ target_types

struct target_type* target_types[]

static

Definition at line 75 of file target.c.

Referenced by COMMAND_HANDLER().

Data Structures

Macros

Typedefs

Enumerations

Functions

Variables

Macro Definition Documentation

◆ DEFAULT_HALT_TIMEOUT

Typedef Documentation

◆ target_write_fn

◆ UNIT

Enumeration Type Documentation

◆ nvp_assert

◆ target_cfg_param

◆ verify_mode

Function Documentation

◆ __attribute__()

◆ append_to_list_all_targets()

◆ binprint()

◆ COMMAND_HANDLER() [1/52]

◆ COMMAND_HANDLER() [2/52]

◆ COMMAND_HANDLER() [3/52]

◆ COMMAND_HANDLER() [4/52]

◆ COMMAND_HANDLER() [5/52]

◆ COMMAND_HANDLER() [6/52]

◆ COMMAND_HANDLER() [7/52]

◆ COMMAND_HANDLER() [8/52]

◆ COMMAND_HANDLER() [9/52]

◆ COMMAND_HANDLER() [10/52]

◆ COMMAND_HANDLER() [11/52]

◆ COMMAND_HANDLER() [12/52]

◆ COMMAND_HANDLER() [13/52]

◆ COMMAND_HANDLER() [14/52]

◆ COMMAND_HANDLER() [15/52]

◆ COMMAND_HANDLER() [16/52]

◆ COMMAND_HANDLER() [17/52]

◆ COMMAND_HANDLER() [18/52]

◆ COMMAND_HANDLER() [19/52]

◆ COMMAND_HANDLER() [20/52]

◆ COMMAND_HANDLER() [21/52]

◆ COMMAND_HANDLER() [22/52]

◆ COMMAND_HANDLER() [23/52]

◆ COMMAND_HANDLER() [24/52]

◆ COMMAND_HANDLER() [25/52]

◆ COMMAND_HANDLER() [26/52]

◆ COMMAND_HANDLER() [27/52]

◆ COMMAND_HANDLER() [28/52]

◆ COMMAND_HANDLER() [29/52]

◆ COMMAND_HANDLER() [30/52]

◆ COMMAND_HANDLER() [31/52]

◆ COMMAND_HANDLER() [32/52]

◆ COMMAND_HANDLER() [33/52]

◆ COMMAND_HANDLER() [34/52]

◆ COMMAND_HANDLER() [35/52]

◆ COMMAND_HANDLER() [36/52]

◆ COMMAND_HANDLER() [37/52]

◆ COMMAND_HANDLER() [38/52]

◆ COMMAND_HANDLER() [39/52]

◆ COMMAND_HANDLER() [40/52]

◆ COMMAND_HANDLER() [41/52]

◆ COMMAND_HANDLER() [42/52]

◆ COMMAND_HANDLER() [43/52]

◆ COMMAND_HANDLER() [44/52]

◆ COMMAND_HANDLER() [45/52]

◆ COMMAND_HANDLER() [46/52]

◆ COMMAND_HANDLER() [47/52]

◆ COMMAND_HANDLER() [48/52]

◆ COMMAND_HANDLER() [49/52]

◆ COMMAND_HANDLER() [50/52]

◆ COMMAND_HANDLER() [51/52]

◆ COMMAND_HANDLER() [52/52]

◆ COMMAND_HELPER() [1/3]

◆ COMMAND_HELPER() [2/3]

◆ COMMAND_HELPER() [3/3]

◆ compare_pc32()

◆ debug_reason_name()

◆ default_check_reset()

◆ default_examine()

◆ find_target()

◆ free_fastload()

◆ attribute()