GDBserver

server.h
Go to the documentation of this file.
1 /* Common definitions for remote server for GDB.
2 Copyright (C) 1993-2018 Free Software Foundation, Inc.
3
4 This file is part of GDB.
5
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
10
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>. */
18
19 #ifndef SERVER_H
20 #define SERVER_H
21
22 #include "common-defs.h"
23
24 gdb_static_assert (sizeof (CORE_ADDR) >= sizeof (void *));
25
26 #ifdef __MINGW32CE__
27 #include "wincecompat.h"
28 #endif
29
30 #include "version.h"
31
32 #if !HAVE_DECL_STRERROR
33 #ifndef strerror
34 extern char *strerror (int); /* X3.159-1989 4.11.6.2 */
35 #endif
36 #endif
37
38 #if !HAVE_DECL_PERROR
39 #ifndef perror
40 extern void perror (const char *);
41 #endif
42 #endif
43
44 #if !HAVE_DECL_VASPRINTF
45 extern int vasprintf(char **strp, const char *fmt, va_list ap);
46 #endif
47 #if !HAVE_DECL_VSNPRINTF
48 int vsnprintf(char *str, size_t size, const char *format, va_list ap);
49 #endif
50
51 #ifdef IN_PROCESS_AGENT
52 # define PROG "ipa"
53 #else
54 # define PROG "gdbserver"
55 #endif
56
57 #include "buffer.h"
58 #include "xml-utils.h"
59 #include "regcache.h"
60 #include "gdb_signals.h"
61 #include "target.h"
62 #include "mem-break.h"
63 #include "gdbthread.h"
64 #include "inferiors.h"
65 #include "environ.h"
66
67 /* Target-specific functions */
68
69 void initialize_low ();
70
71 /* Public variables in server.c */
72
73 extern ptid_t cont_thread;
74 extern ptid_t general_thread;
75
76 extern int server_waiting;
77 extern int pass_signals[];
78 extern int program_signals[];
79 extern int program_signals_p;
80
81 extern int disable_packet_vCont;
82 extern int disable_packet_Tthread;
83 extern int disable_packet_qC;
84 extern int disable_packet_qfThreadInfo;
85
86 extern char *own_buf;
87
88 extern int run_once;
89 extern int multi_process;
90 extern int report_fork_events;
91 extern int report_vfork_events;
92 extern int report_exec_events;
93 extern int report_thread_events;
94 extern int non_stop;
95
96 /* True if the "swbreak+" feature is active. In that case, GDB wants
97 us to report whether a trap is explained by a software breakpoint
98 and for the server to handle PC adjustment if necessary on this
99 target. Only enabled if the target supports it. */
100 extern int swbreak_feature;
101
102 /* True if the "hwbreak+" feature is active. In that case, GDB wants
103 us to report whether a trap is explained by a hardware breakpoint.
104 Only enabled if the target supports it. */
105 extern int hwbreak_feature;
106
107 extern int disable_randomization;
108
109 #if USE_WIN32API
110 #include <winsock2.h>
111 typedef SOCKET gdb_fildes_t;
112 #else
113 typedef int gdb_fildes_t;
114 #endif
115
116 #include "event-loop.h"
117
118 /* Functions from server.c. */
119 extern void handle_v_requests (char *own_buf, int packet_len,
120 int *new_packet_len);
121 extern int handle_serial_event (int err, gdb_client_data client_data);
122 extern int handle_target_event (int err, gdb_client_data client_data);
123
124 /* Get rid of the currently pending stop replies that match PTID. */
125 extern void discard_queued_stop_replies (ptid_t ptid);
126
127 /* Returns true if there's a pending stop reply that matches PTID in
128 the vStopped notifications queue. */
129 extern int in_queued_stop_replies (ptid_t ptid);
130
131 #include "remote-utils.h"
132
133 #include "utils.h"
134 #include "debug.h"
135 #include "gdb_vecs.h"
136
137 /* Maximum number of bytes to read/write at once. The value here
138 is chosen to fill up a packet (the headers account for the 32). */
139 #define MAXBUFBYTES(N) (((N)-32)/2)
140
141 /* Buffer sizes for transferring memory, registers, etc. Set to a constant
142 value to accomodate multiple register formats. This value must be at least
143 as large as the largest register set supported by gdbserver. */
144 #define PBUFSIZ 16384
145
146 /* Definition for an unknown syscall, used basically in error-cases. */
147 #define UNKNOWN_SYSCALL (-1)
148
149 /* Definition for any syscall, used for unfiltered syscall reporting. */
150 #define ANY_SYSCALL (-2)
151
152 /* After fork_inferior has been called, we need to adjust a few
153 signals and call startup_inferior to start the inferior and consume
154 its first events. This is done here. PID is the pid of the new
155 inferior and PROGRAM is its name. */
156 extern void post_fork_inferior (int pid, const char *program);
157
158 /* Get the gdb_environ being used in the current session. */
159 extern gdb_environ *get_environ ();
160
161 extern target_waitstatus last_status;
162 extern ptid_t last_ptid;
163 extern unsigned long signal_pid;
164
165 #endif /* SERVER_H */
gdb_environ
Definition: environ.h:26
disable_packet_qfThreadInfo
int disable_packet_qfThreadInfo
Definition: server.c:132
swbreak_feature
int swbreak_feature
Definition: server.c:99
program_signals_p
int program_signals_p
Definition: server.c:117
last_status
target_waitstatus last_status
Definition: server.c:135
CORE_ADDR
bfd_vma CORE_ADDR
Definition: common-types.h:41
report_exec_events
int report_exec_events
Definition: server.c:92
inferiors.h
program_signals
int program_signals[]
Definition: server.c:116
debug.h
disable_packet_qC
int disable_packet_qC
Definition: server.c:131
signal_pid
unsigned long signal_pid
Definition: server.c:124
non_stop
int non_stop
Definition: server.c:98
gdb_static_assert
gdb_static_assert(sizeof(CORE_ADDR) >=sizeof(void *))
run_once
int run_once
Definition: server.c:87
get_environ
gdb_environ * get_environ()
Definition: server.c:277
disable_randomization
int disable_randomization
Definition: server.c:109
perror
void perror(const char *)
Definition: wincecompat.c:24
initialize_low
void initialize_low()
Definition: linux-low.c:7567
xml-utils.h
report_thread_events
int report_thread_events
Definition: server.c:93
gdb_signals.h
event-loop.h
vasprintf
int vasprintf(char **strp, const char *fmt, va_list ap)
utils.h
report_vfork_events
int report_vfork_events
Definition: server.c:91
handle_v_requests
void handle_v_requests(char *own_buf, int packet_len, int *new_packet_len)
Definition: server.c:3093
disable_packet_Tthread
int disable_packet_Tthread
Definition: server.c:130
server_waiting
int server_waiting
Definition: server.c:80
regcache.h
ptid_t
Definition: ptid.h:35
gdbthread.h
report_fork_events
int report_fork_events
Definition: server.c:90
common-defs.h
remote-utils.h
last_ptid
ptid_t last_ptid
Definition: server.c:136
vsnprintf
int vsnprintf(char *str, size_t size, const char *format, va_list ap)
pass_signals
int pass_signals[]
Definition: server.c:115
environ.h
gdb_client_data
void * gdb_client_data
Definition: event-loop.h:22
handle_serial_event
int handle_serial_event(int err, gdb_client_data client_data)
Definition: server.c:4365
post_fork_inferior
void post_fork_inferior(int pid, const char *program)
Definition: fork-child.c:97
version.h
hwbreak_feature
int hwbreak_feature
Definition: server.c:100
multi_process
int multi_process
Definition: server.c:89
cont_thread
ptid_t cont_thread
Definition: server.c:75
buffer.h
general_thread
ptid_t general_thread
Definition: server.c:78
gdb_vecs.h
target.h
in_queued_stop_replies
int in_queued_stop_replies(ptid_t ptid)
Definition: server.c:238
wincecompat.h
discard_queued_stop_replies
void discard_queued_stop_replies(ptid_t ptid)
Definition: server.c:198
gdb_fildes_t
int gdb_fildes_t
Definition: server.h:113
mem-break.h
handle_target_event
int handle_target_event(int err, gdb_client_data client_data)
Definition: server.c:4397
disable_packet_vCont
int disable_packet_vCont
Definition: server.c:129
strerror
char * strerror(int)
own_buf
char * own_buf
Definition: server.c:138