1 /* Common definitions for remote server for GDB.
2 Copyright (C) 1993, 1995, 1997, 1998, 1999, 2000, 2002, 2003, 2004, 2005,
3 2006, 2007, 2008, 2009, 2010, 2011 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
26 #include "wincecompat.h"
44 /* On some systems such as MinGW, alloca is declared in malloc.h
45 (there is no alloca.h). */
50 #if !HAVE_DECL_STRERROR
52 extern char *strerror (int); /* X3.159-1989 4.11.6.2 */
58 extern void perror (const char *);
63 extern void *memmem (const void *, size_t , const void *, size_t);
66 #if !HAVE_DECL_VASPRINTF
67 extern int vasprintf(char **strp
, const char *fmt
, va_list ap
);
69 #if !HAVE_DECL_VSNPRINTF
70 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
74 #if defined(__GNUC__) && (__GNUC__ > 2 \
75 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7))
76 #define ATTR_NORETURN __attribute__ ((noreturn))
78 #define ATTR_NORETURN /* nothing */
83 #if defined(__GNUC__) && (__GNUC__ > 2 \
84 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 4))
85 #define ATTR_FORMAT(type, x, y) __attribute__ ((format(type, x, y)))
87 #define ATTR_FORMAT(type, x, y) /* nothing */
92 #if defined(__GNUC__) && (__GNUC__ >= 3)
93 #define ATTR_MALLOC __attribute__ ((__malloc__))
95 #define ATTR_MALLOC /* nothing */
99 /* Define underscore macro, if not available, to be able to use it inside
100 code shared with gdb in common directory. */
102 #define _(String) (String)
105 /* A type used for binary buffers. */
106 typedef unsigned char gdb_byte
;
110 #include "xml-utils.h"
111 #include "gdb_locale.h"
113 /* FIXME: This should probably be autoconf'd for. It's an integer type at
114 least the size of a (void *). */
115 typedef long long CORE_ADDR
;
117 typedef long long LONGEST
;
118 typedef unsigned long long ULONGEST
;
120 /* Generic information for tracking a list of ``inferiors'' - threads,
124 struct inferior_list_entry
*head
;
125 struct inferior_list_entry
*tail
;
127 struct inferior_list_entry
130 struct inferior_list_entry
*next
;
137 #include "regcache.h"
138 #include "gdb/signals.h"
139 #include "gdb_signals.h"
141 #include "mem-break.h"
145 struct inferior_list_entry entry
;
149 /* The last resume GDB requested on this thread. */
150 enum resume_kind last_resume_kind
;
152 /* The last wait status reported for this thread. */
153 struct target_waitstatus last_status
;
155 /* Given `while-stepping', a thread may be collecting data for more
156 than one tracepoint simultaneously. E.g.:
158 ff0001 INSN1 <-- TP1, while-stepping 10 collect $regs
160 ff0003 INSN3 <-- TP2, collect $regs
161 ff0004 INSN4 <-- TP3, while-stepping 10 collect $regs
164 Notice that when instruction INSN5 is reached, the while-stepping
165 actions of both TP1 and TP3 are still being collected, and that TP2
166 had been collected meanwhile. The whole range of ff0001-ff0005
167 should be single-stepped, due to at least TP1's while-stepping
168 action covering the whole range.
170 On the other hand, the same tracepoint with a while-stepping action
171 may be hit by more than one thread simultaneously, hence we can't
172 keep the current step count in the tracepoint itself.
174 This is the head of the list of the states of `while-stepping'
175 tracepoint actions this thread is now collecting; NULL if empty.
176 Each item in the list holds the current step of the while-stepping
178 struct wstep_state
*while_stepping
;
183 struct inferior_list_entry entry
;
190 struct raw_breakpoint
;
191 struct fast_tracepoint_jump
;
192 struct process_info_private
;
196 struct inferior_list_entry head
;
198 /* Nonzero if this child process was attached rather than
202 /* True if GDB asked us to detach from this process, but we remained
206 /* The symbol cache. */
207 struct sym_cache
*symbol_cache
;
209 /* The list of memory breakpoints. */
210 struct breakpoint
*breakpoints
;
212 /* The list of raw memory breakpoints. */
213 struct raw_breakpoint
*raw_breakpoints
;
215 /* The list of installed fast tracepoints. */
216 struct fast_tracepoint_jump
*fast_tracepoint_jumps
;
218 /* Private target data. */
219 struct process_info_private
*private;
222 /* Return a pointer to the process that corresponds to the current
223 thread (current_inferior). It is an error to call this if there is
224 no current thread selected. */
226 struct process_info
*current_process (void);
227 struct process_info
*get_thread_process (struct thread_info
*);
229 /* Target-specific functions */
231 void initialize_low ();
233 /* From inferiors.c. */
235 extern struct inferior_list all_processes
;
236 extern struct inferior_list all_threads
;
237 extern struct inferior_list all_dlls
;
238 extern int dlls_changed
;
240 void add_inferior_to_list (struct inferior_list
*list
,
241 struct inferior_list_entry
*new_inferior
);
242 void for_each_inferior (struct inferior_list
*list
,
243 void (*action
) (struct inferior_list_entry
*));
245 extern struct thread_info
*current_inferior
;
246 void remove_inferior (struct inferior_list
*list
,
247 struct inferior_list_entry
*entry
);
248 void remove_thread (struct thread_info
*thread
);
249 void add_thread (ptid_t ptid
, void *target_data
);
251 struct process_info
*add_process (int pid
, int attached
);
252 void remove_process (struct process_info
*process
);
253 struct process_info
*find_process_pid (int pid
);
254 int have_started_inferiors_p (void);
255 int have_attached_inferiors_p (void);
257 struct thread_info
*find_thread_ptid (ptid_t ptid
);
259 ptid_t
thread_id_to_gdb_id (ptid_t
);
260 ptid_t
thread_to_gdb_id (struct thread_info
*);
261 ptid_t
gdb_id_to_thread_id (ptid_t
);
262 struct thread_info
*gdb_id_to_thread (unsigned int);
263 void clear_inferiors (void);
264 struct inferior_list_entry
*find_inferior
265 (struct inferior_list
*,
266 int (*func
) (struct inferior_list_entry
*,
269 struct inferior_list_entry
*find_inferior_id (struct inferior_list
*list
,
271 void *inferior_target_data (struct thread_info
*);
272 void set_inferior_target_data (struct thread_info
*, void *);
273 void *inferior_regcache_data (struct thread_info
*);
274 void set_inferior_regcache_data (struct thread_info
*, void *);
275 void add_pid_to_list (struct inferior_list
*list
, unsigned long pid
);
276 int pull_pid_from_list (struct inferior_list
*list
, unsigned long pid
);
278 void loaded_dll (const char *name
, CORE_ADDR base_addr
);
279 void unloaded_dll (const char *name
, CORE_ADDR base_addr
);
281 /* Public variables in server.c */
283 extern ptid_t cont_thread
;
284 extern ptid_t general_thread
;
286 extern int server_waiting
;
287 extern int debug_threads
;
288 extern int debug_hw_points
;
289 extern int pass_signals
[];
291 extern jmp_buf toplevel
;
293 extern int disable_packet_vCont
;
294 extern int disable_packet_Tthread
;
295 extern int disable_packet_qC
;
296 extern int disable_packet_qfThreadInfo
;
299 extern int multi_process
;
302 extern int disable_randomization
;
305 #include <winsock2.h>
306 typedef SOCKET gdb_fildes_t
;
308 typedef int gdb_fildes_t
;
311 /* Functions from event-loop.c. */
312 typedef void *gdb_client_data
;
313 typedef int (handler_func
) (int, gdb_client_data
);
314 typedef int (callback_handler_func
) (gdb_client_data
);
316 extern void delete_file_handler (gdb_fildes_t fd
);
317 extern void add_file_handler (gdb_fildes_t fd
, handler_func
*proc
,
318 gdb_client_data client_data
);
319 extern int append_callback_event (callback_handler_func
*proc
,
320 gdb_client_data client_data
);
321 extern void delete_callback_event (int id
);
323 extern void start_event_loop (void);
325 /* Functions from server.c. */
326 extern int handle_serial_event (int err
, gdb_client_data client_data
);
327 extern int handle_target_event (int err
, gdb_client_data client_data
);
329 extern void push_event (ptid_t ptid
, struct target_waitstatus
*status
);
331 /* Functions from hostio.c. */
332 extern int handle_vFile (char *, int, int *);
334 /* Functions from hostio-errno.c. */
335 extern void hostio_last_error_from_errno (char *own_buf
);
337 /* From remote-utils.c */
339 extern int remote_debug
;
340 extern int noack_mode
;
341 extern int transport_is_reliable
;
343 int gdb_connected (void);
345 ptid_t
read_ptid (char *buf
, char **obuf
);
346 char *write_ptid (char *buf
, ptid_t ptid
);
348 int putpkt (char *buf
);
349 int putpkt_binary (char *buf
, int len
);
350 int putpkt_notif (char *buf
);
351 int getpkt (char *buf
);
352 void remote_prepare (char *name
);
353 void remote_open (char *name
);
354 void remote_close (void);
355 void write_ok (char *buf
);
356 void write_enn (char *buf
);
357 void initialize_async_io (void);
358 void enable_async_io (void);
359 void disable_async_io (void);
360 void check_remote_input_interrupt_request (void);
361 void convert_ascii_to_int (const char *from
, unsigned char *to
, int n
);
362 void convert_int_to_ascii (const unsigned char *from
, char *to
, int n
);
363 void new_thread_notify (int id
);
364 void dead_thread_notify (int id
);
365 void prepare_resume_reply (char *buf
, ptid_t ptid
,
366 struct target_waitstatus
*status
);
368 const char *decode_address_to_semicolon (CORE_ADDR
*addrp
, const char *start
);
369 void decode_address (CORE_ADDR
*addrp
, const char *start
, int len
);
370 void decode_m_packet (char *from
, CORE_ADDR
* mem_addr_ptr
,
371 unsigned int *len_ptr
);
372 void decode_M_packet (char *from
, CORE_ADDR
* mem_addr_ptr
,
373 unsigned int *len_ptr
, unsigned char **to_p
);
374 int decode_X_packet (char *from
, int packet_len
, CORE_ADDR
* mem_addr_ptr
,
375 unsigned int *len_ptr
, unsigned char **to_p
);
376 int decode_xfer_write (char *buf
, int packet_len
,
377 CORE_ADDR
*offset
, unsigned int *len
,
378 unsigned char *data
);
379 int decode_search_memory_packet (const char *buf
, int packet_len
,
380 CORE_ADDR
*start_addrp
,
381 CORE_ADDR
*search_space_lenp
,
383 unsigned int *pattern_lenp
);
385 int unhexify (char *bin
, const char *hex
, int count
);
386 int hexify (char *hex
, const char *bin
, int count
);
387 int remote_escape_output (const gdb_byte
*buffer
, int len
,
388 gdb_byte
*out_buf
, int *out_len
,
390 char *unpack_varlen_hex (char *buff
, ULONGEST
*result
);
392 void clear_symbol_cache (struct sym_cache
**symcache_p
);
393 int look_up_one_symbol (const char *name
, CORE_ADDR
*addrp
, int may_ask_gdb
);
395 int relocate_instruction (CORE_ADDR
*to
, CORE_ADDR oldloc
);
397 void monitor_output (const char *msg
);
399 /* Functions from utils.c */
400 #include "common-utils.h"
402 void *xmalloc (size_t) ATTR_MALLOC
;
403 void *xrealloc (void *, size_t);
404 void *xcalloc (size_t, size_t) ATTR_MALLOC
;
405 char *xstrdup (const char *) ATTR_MALLOC
;
406 int xsnprintf (char *str
, size_t size
, const char *format
, ...)
407 ATTR_FORMAT (printf
, 3, 4);;
408 void freeargv (char **argv
);
409 void perror_with_name (const char *string
);
410 void error (const char *string
,...) ATTR_NORETURN
ATTR_FORMAT (printf
, 1, 2);
411 void fatal (const char *string
,...) ATTR_NORETURN
ATTR_FORMAT (printf
, 1, 2);
412 void warning (const char *string
,...) ATTR_FORMAT (printf
, 1, 2);
413 char *paddress (CORE_ADDR addr
);
414 char *pulongest (ULONGEST u
);
415 char *plongest (LONGEST l
);
416 char *phex_nz (ULONGEST l
, int sizeof_l
);
417 char *pfildes (gdb_fildes_t fd
);
419 #include "gdb_assert.h"
421 /* Maximum number of bytes to read/write at once. The value here
422 is chosen to fill up a packet (the headers account for the 32). */
423 #define MAXBUFBYTES(N) (((N)-32)/2)
425 /* Buffer sizes for transferring memory, registers, etc. Set to a constant
426 value to accomodate multiple register formats. This value must be at least
427 as large as the largest register set supported by gdbserver. */
428 #define PBUFSIZ 16384
430 /* Functions from tracepoint.c */
432 /* Size for a small buffer to report problems from the in-process
433 agent back to GDBserver. */
434 #define IPA_BUFSIZ 100
436 int in_process_agent_loaded (void);
438 void initialize_tracepoint (void);
441 extern int disconnected_tracing
;
443 void tracepoint_look_up_symbols (void);
445 void stop_tracing (void);
447 int handle_tracepoint_general_set (char *own_buf
);
448 int handle_tracepoint_query (char *own_buf
);
450 int tracepoint_finished_step (struct thread_info
*tinfo
, CORE_ADDR stop_pc
);
451 int tracepoint_was_hit (struct thread_info
*tinfo
, CORE_ADDR stop_pc
);
453 void release_while_stepping_state_list (struct thread_info
*tinfo
);
455 extern int current_traceframe
;
457 int in_readonly_region (CORE_ADDR addr
, ULONGEST length
);
458 int traceframe_read_mem (int tfnum
, CORE_ADDR addr
,
459 unsigned char *buf
, ULONGEST length
,
461 int fetch_traceframe_registers (int tfnum
,
462 struct regcache
*regcache
,
465 int traceframe_read_sdata (int tfnum
, ULONGEST offset
,
466 unsigned char *buf
, ULONGEST length
,
469 int traceframe_read_info (int tfnum
, struct buffer
*buffer
);
471 /* If a thread is determined to be collecting a fast tracepoint, this
472 structure holds the collect status. */
474 struct fast_tpoint_collect_status
476 /* The tracepoint that is presently being collected. */
478 CORE_ADDR tpoint_addr
;
480 /* The address range in the jump pad of where the original
481 instruction the tracepoint jump was inserted was relocated
483 CORE_ADDR adjusted_insn_addr
;
484 CORE_ADDR adjusted_insn_addr_end
;
487 int fast_tracepoint_collecting (CORE_ADDR thread_area
,
489 struct fast_tpoint_collect_status
*status
);
490 void force_unlock_trace_buffer (void);
492 int handle_tracepoint_bkpts (struct thread_info
*tinfo
, CORE_ADDR stop_pc
);
494 #ifdef IN_PROCESS_AGENT
495 void initialize_low_tracepoint (void);
496 void supply_fast_tracepoint_registers (struct regcache
*regcache
,
497 const unsigned char *regs
);
498 void supply_static_tracepoint_registers (struct regcache
*regcache
,
499 const unsigned char *regs
,
501 void set_trampoline_buffer_space (CORE_ADDR begin
, CORE_ADDR end
,
504 void stop_tracing (void);
506 int claim_trampoline_space (ULONGEST used
, CORE_ADDR
*trampoline
);
507 int have_fast_tracepoint_trampoline_buffer (char *msgbuf
);
510 /* Bytecode compilation function vector. */
514 void (*emit_prologue
) (void);
515 void (*emit_epilogue
) (void);
516 void (*emit_add
) (void);
517 void (*emit_sub
) (void);
518 void (*emit_mul
) (void);
519 void (*emit_lsh
) (void);
520 void (*emit_rsh_signed
) (void);
521 void (*emit_rsh_unsigned
) (void);
522 void (*emit_ext
) (int arg
);
523 void (*emit_log_not
) (void);
524 void (*emit_bit_and
) (void);
525 void (*emit_bit_or
) (void);
526 void (*emit_bit_xor
) (void);
527 void (*emit_bit_not
) (void);
528 void (*emit_equal
) (void);
529 void (*emit_less_signed
) (void);
530 void (*emit_less_unsigned
) (void);
531 void (*emit_ref
) (int size
);
532 void (*emit_if_goto
) (int *offset_p
, int *size_p
);
533 void (*emit_goto
) (int *offset_p
, int *size_p
);
534 void (*write_goto_address
) (CORE_ADDR from
, CORE_ADDR to
, int size
);
535 void (*emit_const
) (LONGEST num
);
536 void (*emit_call
) (CORE_ADDR fn
);
537 void (*emit_reg
) (int reg
);
538 void (*emit_pop
) (void);
539 void (*emit_stack_flush
) (void);
540 void (*emit_zero_ext
) (int arg
);
541 void (*emit_swap
) (void);
542 void (*emit_stack_adjust
) (int n
);
544 /* Emit code for a generic function that takes one fixed integer
545 argument and returns a 64-bit int (for instance, tsv getter). */
546 void (*emit_int_call_1
) (CORE_ADDR fn
, int arg1
);
548 /* Emit code for a generic function that takes one fixed integer
549 argument and a 64-bit int from the top of the stack, and returns
550 nothing (for instance, tsv setter). */
551 void (*emit_void_call_2
) (CORE_ADDR fn
, int arg1
);
553 /* Emit code specialized for common combinations of compare followed
555 void (*emit_eq_goto
) (int *offset_p
, int *size_p
);
556 void (*emit_ne_goto
) (int *offset_p
, int *size_p
);
557 void (*emit_lt_goto
) (int *offset_p
, int *size_p
);
558 void (*emit_le_goto
) (int *offset_p
, int *size_p
);
559 void (*emit_gt_goto
) (int *offset_p
, int *size_p
);
560 void (*emit_ge_goto
) (int *offset_p
, int *size_p
);
563 /* Returns the address of the get_raw_reg function in the IPA. */
564 CORE_ADDR
get_raw_reg_func_addr (void);
566 CORE_ADDR current_insn_ptr
;
569 /* Version information, from version.c. */
570 extern const char version
[];
571 extern const char host_name
[];
573 #endif /* SERVER_H */