1 /* Target operations for the remote server for GDB.
2 Copyright (C) 2002-2020 Free Software Foundation, Inc.
4 Contributed by MontaVista Software.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
21 #ifndef GDBSERVER_TARGET_H
22 #define GDBSERVER_TARGET_H
24 #include <sys/types.h> /* for mode_t */
25 #include "target/target.h"
26 #include "target/resume.h"
27 #include "target/wait.h"
28 #include "target/waitstatus.h"
29 #include "mem-break.h"
30 #include "gdbsupport/btrace-common.h"
37 /* This structure describes how to resume a particular thread (or all
38 threads) based on the client's request. If thread is -1, then this
39 entry applies to all threads. These are passed around as an
46 /* How to "resume". */
47 enum resume_kind kind
;
49 /* If non-zero, send this signal when we resume, or to stop the
50 thread. If stopping a thread, and this is 0, the target should
51 stop the thread however it best decides to (e.g., SIGSTOP on
52 linux; SuspendThread on win32). This is a host signal value (not
56 /* Range to single step within. Valid only iff KIND is resume_step.
58 Single-step once, and then continuing stepping as long as the
59 thread stops in this range. (If the range is empty
60 [STEP_RANGE_START == STEP_RANGE_END], then this is a single-step
62 CORE_ADDR step_range_start
; /* Inclusive */
63 CORE_ADDR step_range_end
; /* Exclusive */
68 /* GDBserver doesn't have a concept of strata like GDB, but we call
69 its target vector "process_stratum" anyway for the benefit of
71 struct process_stratum_target
73 /* Wait for process PID to exit. */
75 void (*join
) (int pid
);
77 /* Return 1 iff the thread with process ID PID is alive. */
79 int (*thread_alive
) (ptid_t pid
);
81 /* Resume the inferior process. */
83 void (*resume
) (struct thread_resume
*resume_info
, size_t n
);
85 /* Wait for the inferior process or thread to change state. Store
86 status through argument pointer STATUS.
88 PTID = -1 to wait for any pid to do something, PTID(pid,0,0) to
89 wait for any thread of process pid to do something. Return ptid
90 of child, or -1 in case of error; store status through argument
91 pointer STATUS. OPTIONS is a bit set of options defined as
92 TARGET_W* above. If options contains TARGET_WNOHANG and there's
93 no child stop to report, return is
94 null_ptid/TARGET_WAITKIND_IGNORE. */
96 ptid_t (*wait
) (ptid_t ptid
, struct target_waitstatus
*status
, int options
);
98 /* Fetch registers from the inferior process.
100 If REGNO is -1, fetch all registers; otherwise, fetch at least REGNO. */
102 void (*fetch_registers
) (struct regcache
*regcache
, int regno
);
104 /* Store registers to the inferior process.
106 If REGNO is -1, store all registers; otherwise, store at least REGNO. */
108 void (*store_registers
) (struct regcache
*regcache
, int regno
);
110 /* Prepare to read or write memory from the inferior process.
111 Targets use this to do what is necessary to get the state of the
112 inferior such that it is possible to access memory.
114 This should generally only be called from client facing routines,
115 such as gdb_read_memory/gdb_write_memory, or the GDB breakpoint
118 Like `read_memory' and `write_memory' below, returns 0 on success
119 and errno on failure. */
121 int (*prepare_to_access_memory
) (void);
123 /* Undo the effects of prepare_to_access_memory. */
125 void (*done_accessing_memory
) (void);
127 /* Read memory from the inferior process. This should generally be
128 called through read_inferior_memory, which handles breakpoint shadowing.
130 Read LEN bytes at MEMADDR into a buffer at MYADDR.
132 Returns 0 on success and errno on failure. */
134 int (*read_memory
) (CORE_ADDR memaddr
, unsigned char *myaddr
, int len
);
136 /* Write memory to the inferior process. This should generally be
137 called through target_write_memory, which handles breakpoint shadowing.
139 Write LEN bytes from the buffer at MYADDR to MEMADDR.
141 Returns 0 on success and errno on failure. */
143 int (*write_memory
) (CORE_ADDR memaddr
, const unsigned char *myaddr
,
146 /* Query GDB for the values of any symbols we're interested in.
147 This function is called whenever we receive a "qSymbols::"
148 query, which corresponds to every time more symbols (might)
149 become available. NULL if we aren't interested in any
152 void (*look_up_symbols
) (void);
154 /* Send an interrupt request to the inferior process,
155 however is appropriate. */
157 void (*request_interrupt
) (void);
159 /* Read auxiliary vector data from the inferior process.
161 Read LEN bytes at OFFSET into a buffer at MYADDR. */
163 int (*read_auxv
) (CORE_ADDR offset
, unsigned char *myaddr
,
166 /* Returns true if GDB Z breakpoint type TYPE is supported, false
167 otherwise. The type is coded as follows:
168 '0' - software-breakpoint
169 '1' - hardware-breakpoint
170 '2' - write watchpoint
171 '3' - read watchpoint
172 '4' - access watchpoint
174 int (*supports_z_point_type
) (char z_type
);
176 /* Insert and remove a break or watchpoint.
177 Returns 0 on success, -1 on failure and 1 on unsupported. */
179 int (*insert_point
) (enum raw_bkpt_type type
, CORE_ADDR addr
,
180 int size
, struct raw_breakpoint
*bp
);
181 int (*remove_point
) (enum raw_bkpt_type type
, CORE_ADDR addr
,
182 int size
, struct raw_breakpoint
*bp
);
184 /* Returns 1 if the target stopped because it executed a software
185 breakpoint instruction, 0 otherwise. */
186 int (*stopped_by_sw_breakpoint
) (void);
188 /* Returns true if the target knows whether a trap was caused by a
189 SW breakpoint triggering. */
190 int (*supports_stopped_by_sw_breakpoint
) (void);
192 /* Returns 1 if the target stopped for a hardware breakpoint. */
193 int (*stopped_by_hw_breakpoint
) (void);
195 /* Returns true if the target knows whether a trap was caused by a
196 HW breakpoint triggering. */
197 int (*supports_stopped_by_hw_breakpoint
) (void);
199 /* Returns true if the target can do hardware single step. */
200 int (*supports_hardware_single_step
) (void);
202 /* Returns 1 if target was stopped due to a watchpoint hit, 0 otherwise. */
204 int (*stopped_by_watchpoint
) (void);
206 /* Returns the address associated with the watchpoint that hit, if any;
207 returns 0 otherwise. */
209 CORE_ADDR (*stopped_data_address
) (void);
211 /* Reports the text, data offsets of the executable. This is
212 needed for uclinux where the executable is relocated during load
215 int (*read_offsets
) (CORE_ADDR
*text
, CORE_ADDR
*data
);
217 /* Fetch the address associated with a specific thread local storage
218 area, determined by the specified THREAD, OFFSET, and LOAD_MODULE.
219 Stores it in *ADDRESS and returns zero on success; otherwise returns
220 an error code. A return value of -1 means this system does not
221 support the operation. */
223 int (*get_tls_address
) (struct thread_info
*thread
, CORE_ADDR offset
,
224 CORE_ADDR load_module
, CORE_ADDR
*address
);
226 /* Fill BUF with an hostio error packet representing the last hostio
228 void (*hostio_last_error
) (char *buf
);
230 /* Read/Write OS data using qXfer packets. */
231 int (*qxfer_osdata
) (const char *annex
, unsigned char *readbuf
,
232 unsigned const char *writebuf
, CORE_ADDR offset
,
235 /* Read/Write extra signal info. */
236 int (*qxfer_siginfo
) (const char *annex
, unsigned char *readbuf
,
237 unsigned const char *writebuf
,
238 CORE_ADDR offset
, int len
);
240 int (*supports_non_stop
) (void);
242 /* Enables async target events. Returns the previous enable
244 int (*async
) (int enable
);
246 /* Switch to non-stop (1) or all-stop (0) mode. Return 0 on
247 success, -1 otherwise. */
248 int (*start_non_stop
) (int);
250 /* Returns true if the target supports multi-process debugging. */
251 int (*supports_multi_process
) (void);
253 /* Returns true if fork events are supported. */
254 int (*supports_fork_events
) (void);
256 /* Returns true if vfork events are supported. */
257 int (*supports_vfork_events
) (void);
259 /* Returns true if exec events are supported. */
260 int (*supports_exec_events
) (void);
262 /* Allows target to re-initialize connection-specific settings. */
263 void (*handle_new_gdb_connection
) (void);
265 /* If not NULL, target-specific routine to process monitor command.
266 Returns 1 if handled, or 0 to perform default processing. */
267 int (*handle_monitor_command
) (char *);
269 /* Returns the core given a thread, or -1 if not known. */
270 int (*core_of_thread
) (ptid_t
);
272 /* Read loadmaps. Read LEN bytes at OFFSET into a buffer at MYADDR. */
273 int (*read_loadmap
) (const char *annex
, CORE_ADDR offset
,
274 unsigned char *myaddr
, unsigned int len
);
276 /* Target specific qSupported support. FEATURES is an array of
277 features with COUNT elements. */
278 void (*process_qsupported
) (char **features
, int count
);
280 /* Return 1 if the target supports tracepoints, 0 (or leave the
281 callback NULL) otherwise. */
282 int (*supports_tracepoints
) (void);
284 /* Read PC from REGCACHE. */
285 CORE_ADDR (*read_pc
) (struct regcache
*regcache
);
287 /* Write PC to REGCACHE. */
288 void (*write_pc
) (struct regcache
*regcache
, CORE_ADDR pc
);
290 /* Return true if THREAD is known to be stopped now. */
291 int (*thread_stopped
) (struct thread_info
*thread
);
293 /* Read Thread Information Block address. */
294 int (*get_tib_address
) (ptid_t ptid
, CORE_ADDR
*address
);
296 /* Pause all threads. If FREEZE, arrange for any resume attempt to
297 be ignored until an unpause_all call unfreezes threads again.
298 There can be nested calls to pause_all, so a freeze counter
299 should be maintained. */
300 void (*pause_all
) (int freeze
);
302 /* Unpause all threads. Threads that hadn't been resumed by the
303 client should be left stopped. Basically a pause/unpause call
304 pair should not end up resuming threads that were stopped before
306 void (*unpause_all
) (int unfreeze
);
308 /* Stabilize all threads. That is, force them out of jump pads. */
309 void (*stabilize_threads
) (void);
311 /* Install a fast tracepoint jump pad. TPOINT is the address of the
312 tracepoint internal object as used by the IPA agent. TPADDR is
313 the address of tracepoint. COLLECTOR is address of the function
314 the jump pad redirects to. LOCKADDR is the address of the jump
315 pad lock object. ORIG_SIZE is the size in bytes of the
316 instruction at TPADDR. JUMP_ENTRY points to the address of the
317 jump pad entry, and on return holds the address past the end of
318 the created jump pad. If a trampoline is created by the function,
319 then TRAMPOLINE and TRAMPOLINE_SIZE return the address and size of
320 the trampoline, else they remain unchanged. JJUMP_PAD_INSN is a
321 buffer containing a copy of the instruction at TPADDR.
322 ADJUST_INSN_ADDR and ADJUST_INSN_ADDR_END are output parameters that
323 return the address range where the instruction at TPADDR was relocated
324 to. If an error occurs, the ERR may be used to pass on an error
326 int (*install_fast_tracepoint_jump_pad
) (CORE_ADDR tpoint
, CORE_ADDR tpaddr
,
330 CORE_ADDR
*jump_entry
,
331 CORE_ADDR
*trampoline
,
332 ULONGEST
*trampoline_size
,
333 unsigned char *jjump_pad_insn
,
334 ULONGEST
*jjump_pad_insn_size
,
335 CORE_ADDR
*adjusted_insn_addr
,
336 CORE_ADDR
*adjusted_insn_addr_end
,
339 /* Return the bytecode operations vector for the current inferior.
340 Returns NULL if bytecode compilation is not supported. */
341 struct emit_ops
*(*emit_ops
) (void);
343 /* Returns true if the target supports disabling randomization. */
344 int (*supports_disable_randomization
) (void);
346 /* Return the minimum length of an instruction that can be safely overwritten
347 for use as a fast tracepoint. */
348 int (*get_min_fast_tracepoint_insn_len
) (void);
350 /* Read solib info on SVR4 platforms. */
351 int (*qxfer_libraries_svr4
) (const char *annex
, unsigned char *readbuf
,
352 unsigned const char *writebuf
,
353 CORE_ADDR offset
, int len
);
355 /* Return true if target supports debugging agent. */
356 int (*supports_agent
) (void);
358 /* Enable branch tracing for PTID based on CONF and allocate a branch trace
359 target information struct for reading and for disabling branch trace. */
360 struct btrace_target_info
*(*enable_btrace
)
361 (ptid_t ptid
, const struct btrace_config
*conf
);
363 /* Disable branch tracing.
364 Returns zero on success, non-zero otherwise. */
365 int (*disable_btrace
) (struct btrace_target_info
*tinfo
);
367 /* Read branch trace data into buffer.
368 Return 0 on success; print an error message into BUFFER and return -1,
370 int (*read_btrace
) (struct btrace_target_info
*, struct buffer
*,
371 enum btrace_read_type type
);
373 /* Read the branch trace configuration into BUFFER.
374 Return 0 on success; print an error message into BUFFER and return -1
376 int (*read_btrace_conf
) (const struct btrace_target_info
*, struct buffer
*);
378 /* Return true if target supports range stepping. */
379 int (*supports_range_stepping
) (void);
381 /* Return the full absolute name of the executable file that was
382 run to create the process PID. If the executable file cannot
383 be determined, NULL is returned. Otherwise, a pointer to a
384 character string containing the pathname is returned. This
385 string should be copied into a buffer by the client if the string
386 will not be immediately used, or if it must persist. */
387 char *(*pid_to_exec_file
) (int pid
);
389 /* Multiple-filesystem-aware open. Like open(2), but operating in
390 the filesystem as it appears to process PID. Systems where all
391 processes share a common filesystem should set this to NULL.
392 If NULL, the caller should fall back to open(2). */
393 int (*multifs_open
) (int pid
, const char *filename
,
394 int flags
, mode_t mode
);
396 /* Multiple-filesystem-aware unlink. Like unlink(2), but operates
397 in the filesystem as it appears to process PID. Systems where
398 all processes share a common filesystem should set this to NULL.
399 If NULL, the caller should fall back to unlink(2). */
400 int (*multifs_unlink
) (int pid
, const char *filename
);
402 /* Multiple-filesystem-aware readlink. Like readlink(2), but
403 operating in the filesystem as it appears to process PID.
404 Systems where all processes share a common filesystem should
405 set this to NULL. If NULL, the caller should fall back to
407 ssize_t (*multifs_readlink
) (int pid
, const char *filename
,
408 char *buf
, size_t bufsiz
);
410 /* Return the breakpoint kind for this target based on PC. The PCPTR is
411 adjusted to the real memory location in case a flag (e.g., the Thumb bit on
412 ARM) was present in the PC. */
413 int (*breakpoint_kind_from_pc
) (CORE_ADDR
*pcptr
);
415 /* Return the software breakpoint from KIND. KIND can have target
416 specific meaning like the Z0 kind parameter.
417 SIZE is set to the software breakpoint's length in memory. */
418 const gdb_byte
*(*sw_breakpoint_from_kind
) (int kind
, int *size
);
420 /* Return the thread's name, or NULL if the target is unable to determine it.
421 The returned value must not be freed by the caller. */
422 const char *(*thread_name
) (ptid_t thread
);
424 /* Return the breakpoint kind for this target based on the current
425 processor state (e.g. the current instruction mode on ARM) and the
426 PC. The PCPTR is adjusted to the real memory location in case a flag
427 (e.g., the Thumb bit on ARM) is present in the PC. */
428 int (*breakpoint_kind_from_current_state
) (CORE_ADDR
*pcptr
);
430 /* Returns true if the target can software single step. */
431 int (*supports_software_single_step
) (void);
433 /* Return 1 if the target supports catch syscall, 0 (or leave the
434 callback NULL) otherwise. */
435 int (*supports_catch_syscall
) (void);
437 /* Return tdesc index for IPA. */
438 int (*get_ipa_tdesc_idx
) (void);
440 /* Thread ID to (numeric) thread handle: Return true on success and
441 false for failure. Return pointer to thread handle via HANDLE
442 and the handle's length via HANDLE_LEN. */
443 bool (*thread_handle
) (ptid_t ptid
, gdb_byte
**handle
, int *handle_len
);
445 /* The object that will gradually replace this struct. */
453 virtual ~process_target () = default;
455 /* Start a new process.
457 PROGRAM is a path to the program to execute.
458 PROGRAM_ARGS is a standard NULL-terminated array of arguments,
459 to be passed to the inferior as ``argv'' (along with PROGRAM).
461 Returns the new PID on success, -1 on failure. Registers the new
462 process with the process list. */
463 virtual int create_inferior (const char *program
,
464 const std::vector
<char *> &program_args
) = 0;
466 /* Do additional setup after a new process is created, including
467 exec-wrapper completion. */
468 virtual void post_create_inferior ();
470 /* Attach to a running process.
472 PID is the process ID to attach to, specified by the user
475 Returns -1 if attaching is unsupported, 0 on success, and calls
476 error() otherwise. */
477 virtual int attach (unsigned long pid
) = 0;
479 /* Kill process PROC. Return -1 on failure, and 0 on success. */
480 virtual int kill (process_info
*proc
) = 0;
482 /* Detach from process PROC. Return -1 on failure, and 0 on
484 virtual int detach (process_info
*proc
) = 0;
486 /* The inferior process has died. Do what is right. */
487 virtual void mourn (process_info
*proc
) = 0;
490 extern process_stratum_target
*the_target
;
492 void set_target_ops (process_stratum_target
*);
494 #define target_create_inferior(program, program_args) \
495 the_target->pt->create_inferior (program, program_args)
497 #define target_post_create_inferior() \
498 the_target->pt->post_create_inferior ()
500 #define myattach(pid) \
501 the_target->pt->attach (pid)
503 int kill_inferior (process_info
*proc
);
505 #define target_supports_fork_events() \
506 (the_target->supports_fork_events ? \
507 (*the_target->supports_fork_events) () : 0)
509 #define target_supports_vfork_events() \
510 (the_target->supports_vfork_events ? \
511 (*the_target->supports_vfork_events) () : 0)
513 #define target_supports_exec_events() \
514 (the_target->supports_exec_events ? \
515 (*the_target->supports_exec_events) () : 0)
517 #define target_handle_new_gdb_connection() \
520 if (the_target->handle_new_gdb_connection != NULL) \
521 (*the_target->handle_new_gdb_connection) (); \
524 #define detach_inferior(proc) \
525 the_target->pt->detach (proc)
527 #define mythread_alive(pid) \
528 (*the_target->thread_alive) (pid)
530 #define fetch_inferior_registers(regcache, regno) \
531 (*the_target->fetch_registers) (regcache, regno)
533 #define store_inferior_registers(regcache, regno) \
534 (*the_target->store_registers) (regcache, regno)
536 #define join_inferior(pid) \
537 (*the_target->join) (pid)
539 #define target_supports_non_stop() \
540 (the_target->supports_non_stop ? (*the_target->supports_non_stop ) () : 0)
542 #define target_async(enable) \
543 (the_target->async ? (*the_target->async) (enable) : 0)
545 #define target_process_qsupported(features, count) \
548 if (the_target->process_qsupported) \
549 the_target->process_qsupported (features, count); \
552 #define target_supports_catch_syscall() \
553 (the_target->supports_catch_syscall ? \
554 (*the_target->supports_catch_syscall) () : 0)
556 #define target_get_ipa_tdesc_idx() \
557 (the_target->get_ipa_tdesc_idx \
558 ? (*the_target->get_ipa_tdesc_idx) () : 0)
560 #define target_supports_tracepoints() \
561 (the_target->supports_tracepoints \
562 ? (*the_target->supports_tracepoints) () : 0)
564 #define target_supports_fast_tracepoints() \
565 (the_target->install_fast_tracepoint_jump_pad != NULL)
567 #define target_get_min_fast_tracepoint_insn_len() \
568 (the_target->get_min_fast_tracepoint_insn_len \
569 ? (*the_target->get_min_fast_tracepoint_insn_len) () : 0)
571 #define thread_stopped(thread) \
572 (*the_target->thread_stopped) (thread)
574 #define pause_all(freeze) \
577 if (the_target->pause_all) \
578 (*the_target->pause_all) (freeze); \
581 #define unpause_all(unfreeze) \
584 if (the_target->unpause_all) \
585 (*the_target->unpause_all) (unfreeze); \
588 #define stabilize_threads() \
591 if (the_target->stabilize_threads) \
592 (*the_target->stabilize_threads) (); \
595 #define install_fast_tracepoint_jump_pad(tpoint, tpaddr, \
596 collector, lockaddr, \
599 trampoline, trampoline_size, \
601 jjump_pad_insn_size, \
602 adjusted_insn_addr, \
603 adjusted_insn_addr_end, \
605 (*the_target->install_fast_tracepoint_jump_pad) (tpoint, tpaddr, \
606 collector,lockaddr, \
607 orig_size, jump_entry, \
611 jjump_pad_insn_size, \
612 adjusted_insn_addr, \
613 adjusted_insn_addr_end, \
616 #define target_emit_ops() \
617 (the_target->emit_ops ? (*the_target->emit_ops) () : NULL)
619 #define target_supports_disable_randomization() \
620 (the_target->supports_disable_randomization ? \
621 (*the_target->supports_disable_randomization) () : 0)
623 #define target_supports_agent() \
624 (the_target->supports_agent ? \
625 (*the_target->supports_agent) () : 0)
627 static inline struct btrace_target_info
*
628 target_enable_btrace (ptid_t ptid
, const struct btrace_config
*conf
)
630 if (the_target
->enable_btrace
== nullptr)
631 error (_("Target does not support branch tracing."));
633 return (*the_target
->enable_btrace
) (ptid
, conf
);
637 target_disable_btrace (struct btrace_target_info
*tinfo
)
639 if (the_target
->disable_btrace
== nullptr)
640 error (_("Target does not support branch tracing."));
642 return (*the_target
->disable_btrace
) (tinfo
);
646 target_read_btrace (struct btrace_target_info
*tinfo
,
647 struct buffer
*buffer
,
648 enum btrace_read_type type
)
650 if (the_target
->read_btrace
== nullptr)
651 error (_("Target does not support branch tracing."));
653 return (*the_target
->read_btrace
) (tinfo
, buffer
, type
);
657 target_read_btrace_conf (struct btrace_target_info
*tinfo
,
658 struct buffer
*buffer
)
660 if (the_target
->read_btrace_conf
== nullptr)
661 error (_("Target does not support branch tracing."));
663 return (*the_target
->read_btrace_conf
) (tinfo
, buffer
);
666 #define target_supports_range_stepping() \
667 (the_target->supports_range_stepping ? \
668 (*the_target->supports_range_stepping) () : 0)
670 #define target_supports_stopped_by_sw_breakpoint() \
671 (the_target->supports_stopped_by_sw_breakpoint ? \
672 (*the_target->supports_stopped_by_sw_breakpoint) () : 0)
674 #define target_stopped_by_sw_breakpoint() \
675 (the_target->stopped_by_sw_breakpoint ? \
676 (*the_target->stopped_by_sw_breakpoint) () : 0)
678 #define target_supports_stopped_by_hw_breakpoint() \
679 (the_target->supports_stopped_by_hw_breakpoint ? \
680 (*the_target->supports_stopped_by_hw_breakpoint) () : 0)
682 #define target_supports_hardware_single_step() \
683 (the_target->supports_hardware_single_step ? \
684 (*the_target->supports_hardware_single_step) () : 0)
686 #define target_stopped_by_hw_breakpoint() \
687 (the_target->stopped_by_hw_breakpoint ? \
688 (*the_target->stopped_by_hw_breakpoint) () : 0)
690 #define target_breakpoint_kind_from_pc(pcptr) \
691 (the_target->breakpoint_kind_from_pc \
692 ? (*the_target->breakpoint_kind_from_pc) (pcptr) \
693 : default_breakpoint_kind_from_pc (pcptr))
695 #define target_breakpoint_kind_from_current_state(pcptr) \
696 (the_target->breakpoint_kind_from_current_state \
697 ? (*the_target->breakpoint_kind_from_current_state) (pcptr) \
698 : target_breakpoint_kind_from_pc (pcptr))
700 #define target_supports_software_single_step() \
701 (the_target->supports_software_single_step ? \
702 (*the_target->supports_software_single_step) () : 0)
704 /* Start non-stop mode, returns 0 on success, -1 on failure. */
706 int start_non_stop (int nonstop
);
708 ptid_t
mywait (ptid_t ptid
, struct target_waitstatus
*ourstatus
, int options
,
711 /* Prepare to read or write memory from the inferior process. See the
712 corresponding process_stratum_target methods for more details. */
714 int prepare_to_access_memory (void);
715 void done_accessing_memory (void);
717 #define target_core_of_thread(ptid) \
718 (the_target->core_of_thread ? (*the_target->core_of_thread) (ptid) \
721 #define target_thread_name(ptid) \
722 (the_target->thread_name ? (*the_target->thread_name) (ptid) \
725 #define target_thread_handle(ptid, handle, handle_len) \
726 (the_target->thread_handle ? (*the_target->thread_handle) \
727 (ptid, handle, handle_len) \
730 int read_inferior_memory (CORE_ADDR memaddr
, unsigned char *myaddr
, int len
);
732 int set_desired_thread ();
734 const char *target_pid_to_str (ptid_t
);
736 int target_can_do_hardware_single_step (void);
738 int default_breakpoint_kind_from_pc (CORE_ADDR
*pcptr
);
740 #endif /* GDBSERVER_TARGET_H */