1 /* Common definitions for remote server for GDB.
2 Copyright (C) 1993, 1995, 1997-2000, 2002-2012 Free Software
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 *);
62 #if !HAVE_DECL_VASPRINTF
63 extern int vasprintf(char **strp
, const char *fmt
, va_list ap
);
65 #if !HAVE_DECL_VSNPRINTF
66 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
70 #if defined(__GNUC__) && (__GNUC__ > 2 \
71 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7))
72 #define ATTR_NORETURN __attribute__ ((noreturn))
74 #define ATTR_NORETURN /* nothing */
79 #if defined(__GNUC__) && (__GNUC__ > 2 \
80 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 4))
81 #define ATTR_FORMAT(type, x, y) __attribute__ ((format(type, x, y)))
83 #define ATTR_FORMAT(type, x, y) /* nothing */
88 #if defined(__GNUC__) && (__GNUC__ >= 3)
89 #define ATTR_MALLOC __attribute__ ((__malloc__))
91 #define ATTR_MALLOC /* nothing */
95 /* Define underscore macro, if not available, to be able to use it inside
96 code shared with gdb in common directory. */
98 #define _(String) (String)
101 #ifdef IN_PROCESS_AGENT
104 # define PROG "gdbserver"
107 /* A type used for binary buffers. */
108 typedef unsigned char gdb_byte
;
112 #include "xml-utils.h"
113 #include "gdb_locale.h"
115 /* FIXME: This should probably be autoconf'd for. It's an integer type at
116 least the size of a (void *). */
117 typedef long long CORE_ADDR
;
119 typedef long long LONGEST
;
120 typedef unsigned long long ULONGEST
;
122 /* Generic information for tracking a list of ``inferiors'' - threads,
126 struct inferior_list_entry
*head
;
127 struct inferior_list_entry
*tail
;
129 struct inferior_list_entry
132 struct inferior_list_entry
*next
;
139 #include "regcache.h"
140 #include "gdb/signals.h"
141 #include "gdb_signals.h"
143 #include "mem-break.h"
144 #include "gdbthread.h"
148 struct inferior_list_entry entry
;
155 struct raw_breakpoint
;
156 struct fast_tracepoint_jump
;
157 struct process_info_private
;
161 struct inferior_list_entry head
;
163 /* Nonzero if this child process was attached rather than
167 /* True if GDB asked us to detach from this process, but we remained
171 /* The symbol cache. */
172 struct sym_cache
*symbol_cache
;
174 /* The list of memory breakpoints. */
175 struct breakpoint
*breakpoints
;
177 /* The list of raw memory breakpoints. */
178 struct raw_breakpoint
*raw_breakpoints
;
180 /* The list of installed fast tracepoints. */
181 struct fast_tracepoint_jump
*fast_tracepoint_jumps
;
183 /* Private target data. */
184 struct process_info_private
*private;
187 /* Return a pointer to the process that corresponds to the current
188 thread (current_inferior). It is an error to call this if there is
189 no current thread selected. */
191 struct process_info
*current_process (void);
192 struct process_info
*get_thread_process (struct thread_info
*);
194 /* Target-specific functions */
196 void initialize_low ();
198 /* From inferiors.c. */
200 extern struct inferior_list all_processes
;
201 extern struct inferior_list all_dlls
;
202 extern int dlls_changed
;
203 extern void clear_dlls (void);
205 void add_inferior_to_list (struct inferior_list
*list
,
206 struct inferior_list_entry
*new_inferior
);
207 void for_each_inferior (struct inferior_list
*list
,
208 void (*action
) (struct inferior_list_entry
*));
210 extern struct thread_info
*current_inferior
;
211 void remove_inferior (struct inferior_list
*list
,
212 struct inferior_list_entry
*entry
);
214 struct process_info
*add_process (int pid
, int attached
);
215 void remove_process (struct process_info
*process
);
216 struct process_info
*find_process_pid (int pid
);
217 int have_started_inferiors_p (void);
218 int have_attached_inferiors_p (void);
220 ptid_t
thread_id_to_gdb_id (ptid_t
);
221 ptid_t
thread_to_gdb_id (struct thread_info
*);
222 ptid_t
gdb_id_to_thread_id (ptid_t
);
224 void clear_inferiors (void);
225 struct inferior_list_entry
*find_inferior
226 (struct inferior_list
*,
227 int (*func
) (struct inferior_list_entry
*,
230 struct inferior_list_entry
*find_inferior_id (struct inferior_list
*list
,
232 void *inferior_target_data (struct thread_info
*);
233 void set_inferior_target_data (struct thread_info
*, void *);
234 void *inferior_regcache_data (struct thread_info
*);
235 void set_inferior_regcache_data (struct thread_info
*, void *);
237 void loaded_dll (const char *name
, CORE_ADDR base_addr
);
238 void unloaded_dll (const char *name
, CORE_ADDR base_addr
);
240 /* Public variables in server.c */
242 extern ptid_t cont_thread
;
243 extern ptid_t general_thread
;
245 extern int server_waiting
;
246 extern int debug_threads
;
247 extern int debug_hw_points
;
248 extern int pass_signals
[];
249 extern int program_signals
[];
250 extern int program_signals_p
;
252 extern jmp_buf toplevel
;
254 extern int disable_packet_vCont
;
255 extern int disable_packet_Tthread
;
256 extern int disable_packet_qC
;
257 extern int disable_packet_qfThreadInfo
;
260 extern int multi_process
;
263 extern int disable_randomization
;
266 #include <winsock2.h>
267 typedef SOCKET gdb_fildes_t
;
269 typedef int gdb_fildes_t
;
272 /* Functions from event-loop.c. */
273 typedef void *gdb_client_data
;
274 typedef int (handler_func
) (int, gdb_client_data
);
275 typedef int (callback_handler_func
) (gdb_client_data
);
277 extern void delete_file_handler (gdb_fildes_t fd
);
278 extern void add_file_handler (gdb_fildes_t fd
, handler_func
*proc
,
279 gdb_client_data client_data
);
280 extern int append_callback_event (callback_handler_func
*proc
,
281 gdb_client_data client_data
);
282 extern void delete_callback_event (int id
);
284 extern void start_event_loop (void);
286 /* Functions from server.c. */
287 extern int handle_serial_event (int err
, gdb_client_data client_data
);
288 extern int handle_target_event (int err
, gdb_client_data client_data
);
290 extern void push_event (ptid_t ptid
, struct target_waitstatus
*status
);
292 /* Functions from hostio.c. */
293 extern int handle_vFile (char *, int, int *);
295 /* Functions from hostio-errno.c. */
296 extern void hostio_last_error_from_errno (char *own_buf
);
298 /* From remote-utils.c */
300 extern int remote_debug
;
301 extern int noack_mode
;
302 extern int transport_is_reliable
;
304 int gdb_connected (void);
306 #define STDIO_CONNECTION_NAME "stdio"
307 int remote_connection_is_stdio (void);
309 ptid_t
read_ptid (char *buf
, char **obuf
);
310 char *write_ptid (char *buf
, ptid_t ptid
);
312 int putpkt (char *buf
);
313 int putpkt_binary (char *buf
, int len
);
314 int putpkt_notif (char *buf
);
315 int getpkt (char *buf
);
316 void remote_prepare (char *name
);
317 void remote_open (char *name
);
318 void remote_close (void);
319 void write_ok (char *buf
);
320 void write_enn (char *buf
);
321 void initialize_async_io (void);
322 void enable_async_io (void);
323 void disable_async_io (void);
324 void check_remote_input_interrupt_request (void);
325 void convert_ascii_to_int (const char *from
, unsigned char *to
, int n
);
326 void convert_int_to_ascii (const unsigned char *from
, char *to
, int n
);
327 void new_thread_notify (int id
);
328 void dead_thread_notify (int id
);
329 void prepare_resume_reply (char *buf
, ptid_t ptid
,
330 struct target_waitstatus
*status
);
332 const char *decode_address_to_semicolon (CORE_ADDR
*addrp
, const char *start
);
333 void decode_address (CORE_ADDR
*addrp
, const char *start
, int len
);
334 void decode_m_packet (char *from
, CORE_ADDR
* mem_addr_ptr
,
335 unsigned int *len_ptr
);
336 void decode_M_packet (char *from
, CORE_ADDR
* mem_addr_ptr
,
337 unsigned int *len_ptr
, unsigned char **to_p
);
338 int decode_X_packet (char *from
, int packet_len
, CORE_ADDR
* mem_addr_ptr
,
339 unsigned int *len_ptr
, unsigned char **to_p
);
340 int decode_xfer_write (char *buf
, int packet_len
,
341 CORE_ADDR
*offset
, unsigned int *len
,
342 unsigned char *data
);
343 int decode_search_memory_packet (const char *buf
, int packet_len
,
344 CORE_ADDR
*start_addrp
,
345 CORE_ADDR
*search_space_lenp
,
347 unsigned int *pattern_lenp
);
349 int unhexify (char *bin
, const char *hex
, int count
);
350 int hexify (char *hex
, const char *bin
, int count
);
351 int remote_escape_output (const gdb_byte
*buffer
, int len
,
352 gdb_byte
*out_buf
, int *out_len
,
354 char *unpack_varlen_hex (char *buff
, ULONGEST
*result
);
356 void clear_symbol_cache (struct sym_cache
**symcache_p
);
357 int look_up_one_symbol (const char *name
, CORE_ADDR
*addrp
, int may_ask_gdb
);
359 int relocate_instruction (CORE_ADDR
*to
, CORE_ADDR oldloc
);
361 void monitor_output (const char *msg
);
363 /* Functions from utils.c */
364 #include "common-utils.h"
366 void *xmalloc (size_t) ATTR_MALLOC
;
367 void *xrealloc (void *, size_t);
368 void *xcalloc (size_t, size_t) ATTR_MALLOC
;
369 char *xstrdup (const char *) ATTR_MALLOC
;
370 int xsnprintf (char *str
, size_t size
, const char *format
, ...)
371 ATTR_FORMAT (printf
, 3, 4);;
372 void freeargv (char **argv
);
373 void perror_with_name (const char *string
);
374 void error (const char *string
,...) ATTR_NORETURN
ATTR_FORMAT (printf
, 1, 2);
375 void fatal (const char *string
,...) ATTR_NORETURN
ATTR_FORMAT (printf
, 1, 2);
376 void warning (const char *string
,...) ATTR_FORMAT (printf
, 1, 2);
377 char *paddress (CORE_ADDR addr
);
378 char *pulongest (ULONGEST u
);
379 char *plongest (LONGEST l
);
380 char *phex_nz (ULONGEST l
, int sizeof_l
);
381 char *pfildes (gdb_fildes_t fd
);
383 #include "gdb_assert.h"
385 /* Maximum number of bytes to read/write at once. The value here
386 is chosen to fill up a packet (the headers account for the 32). */
387 #define MAXBUFBYTES(N) (((N)-32)/2)
389 /* Buffer sizes for transferring memory, registers, etc. Set to a constant
390 value to accomodate multiple register formats. This value must be at least
391 as large as the largest register set supported by gdbserver. */
392 #define PBUFSIZ 16384
394 /* Functions from tracepoint.c */
396 /* Size for a small buffer to report problems from the in-process
397 agent back to GDBserver. */
398 #define IPA_BUFSIZ 100
400 void initialize_tracepoint (void);
403 extern int disconnected_tracing
;
405 void tracepoint_look_up_symbols (void);
407 void stop_tracing (void);
409 int handle_tracepoint_general_set (char *own_buf
);
410 int handle_tracepoint_query (char *own_buf
);
412 int tracepoint_finished_step (struct thread_info
*tinfo
, CORE_ADDR stop_pc
);
413 int tracepoint_was_hit (struct thread_info
*tinfo
, CORE_ADDR stop_pc
);
415 void release_while_stepping_state_list (struct thread_info
*tinfo
);
417 extern int current_traceframe
;
419 int in_readonly_region (CORE_ADDR addr
, ULONGEST length
);
420 int traceframe_read_mem (int tfnum
, CORE_ADDR addr
,
421 unsigned char *buf
, ULONGEST length
,
423 int fetch_traceframe_registers (int tfnum
,
424 struct regcache
*regcache
,
427 int traceframe_read_sdata (int tfnum
, ULONGEST offset
,
428 unsigned char *buf
, ULONGEST length
,
431 int traceframe_read_info (int tfnum
, struct buffer
*buffer
);
433 /* If a thread is determined to be collecting a fast tracepoint, this
434 structure holds the collect status. */
436 struct fast_tpoint_collect_status
438 /* The tracepoint that is presently being collected. */
440 CORE_ADDR tpoint_addr
;
442 /* The address range in the jump pad of where the original
443 instruction the tracepoint jump was inserted was relocated
445 CORE_ADDR adjusted_insn_addr
;
446 CORE_ADDR adjusted_insn_addr_end
;
449 int fast_tracepoint_collecting (CORE_ADDR thread_area
,
451 struct fast_tpoint_collect_status
*status
);
452 void force_unlock_trace_buffer (void);
454 int handle_tracepoint_bkpts (struct thread_info
*tinfo
, CORE_ADDR stop_pc
);
456 #ifdef IN_PROCESS_AGENT
457 void initialize_low_tracepoint (void);
458 void supply_fast_tracepoint_registers (struct regcache
*regcache
,
459 const unsigned char *regs
);
460 void supply_static_tracepoint_registers (struct regcache
*regcache
,
461 const unsigned char *regs
,
463 void set_trampoline_buffer_space (CORE_ADDR begin
, CORE_ADDR end
,
466 void stop_tracing (void);
468 int claim_trampoline_space (ULONGEST used
, CORE_ADDR
*trampoline
);
469 int have_fast_tracepoint_trampoline_buffer (char *msgbuf
);
474 /* Do memory copies for bytecodes. */
475 /* Do the recording of memory blocks for actions and bytecodes. */
477 int agent_mem_read (struct traceframe
*tframe
,
478 unsigned char *to
, CORE_ADDR from
,
481 LONGEST
agent_get_trace_state_variable_value (int num
);
482 void agent_set_trace_state_variable_value (int num
, LONGEST val
);
484 /* Record the value of a trace state variable. */
486 int agent_tsv_read (struct traceframe
*tframe
, int n
);
487 int agent_mem_read_string (struct traceframe
*tframe
,
492 /* Bytecode compilation function vector. */
496 void (*emit_prologue
) (void);
497 void (*emit_epilogue
) (void);
498 void (*emit_add
) (void);
499 void (*emit_sub
) (void);
500 void (*emit_mul
) (void);
501 void (*emit_lsh
) (void);
502 void (*emit_rsh_signed
) (void);
503 void (*emit_rsh_unsigned
) (void);
504 void (*emit_ext
) (int arg
);
505 void (*emit_log_not
) (void);
506 void (*emit_bit_and
) (void);
507 void (*emit_bit_or
) (void);
508 void (*emit_bit_xor
) (void);
509 void (*emit_bit_not
) (void);
510 void (*emit_equal
) (void);
511 void (*emit_less_signed
) (void);
512 void (*emit_less_unsigned
) (void);
513 void (*emit_ref
) (int size
);
514 void (*emit_if_goto
) (int *offset_p
, int *size_p
);
515 void (*emit_goto
) (int *offset_p
, int *size_p
);
516 void (*write_goto_address
) (CORE_ADDR from
, CORE_ADDR to
, int size
);
517 void (*emit_const
) (LONGEST num
);
518 void (*emit_call
) (CORE_ADDR fn
);
519 void (*emit_reg
) (int reg
);
520 void (*emit_pop
) (void);
521 void (*emit_stack_flush
) (void);
522 void (*emit_zero_ext
) (int arg
);
523 void (*emit_swap
) (void);
524 void (*emit_stack_adjust
) (int n
);
526 /* Emit code for a generic function that takes one fixed integer
527 argument and returns a 64-bit int (for instance, tsv getter). */
528 void (*emit_int_call_1
) (CORE_ADDR fn
, int arg1
);
530 /* Emit code for a generic function that takes one fixed integer
531 argument and a 64-bit int from the top of the stack, and returns
532 nothing (for instance, tsv setter). */
533 void (*emit_void_call_2
) (CORE_ADDR fn
, int arg1
);
535 /* Emit code specialized for common combinations of compare followed
537 void (*emit_eq_goto
) (int *offset_p
, int *size_p
);
538 void (*emit_ne_goto
) (int *offset_p
, int *size_p
);
539 void (*emit_lt_goto
) (int *offset_p
, int *size_p
);
540 void (*emit_le_goto
) (int *offset_p
, int *size_p
);
541 void (*emit_gt_goto
) (int *offset_p
, int *size_p
);
542 void (*emit_ge_goto
) (int *offset_p
, int *size_p
);
545 /* Returns the address of the get_raw_reg function in the IPA. */
546 CORE_ADDR
get_raw_reg_func_addr (void);
547 /* Returns the address of the get_trace_state_variable_value
548 function in the IPA. */
549 CORE_ADDR
get_get_tsv_func_addr (void);
550 /* Returns the address of the set_trace_state_variable_value
551 function in the IPA. */
552 CORE_ADDR
get_set_tsv_func_addr (void);
554 CORE_ADDR current_insn_ptr
;
557 /* Version information, from version.c. */
558 extern const char version
[];
559 extern const char host_name
[];
561 #endif /* SERVER_H */