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;
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 */
int disable_packet_qfThreadInfo
Definition: server.c:132
int swbreak_feature
Definition: server.c:99
int program_signals_p
Definition: server.c:117
target_waitstatus last_status
Definition: server.c:135
bfd_vma CORE_ADDR
Definition: common-types.h:41
int report_exec_events
Definition: server.c:92
int program_signals[]
Definition: server.c:116
int disable_packet_qC
Definition: server.c:131
unsigned long signal_pid
Definition: server.c:124
int non_stop
Definition: server.c:98
gdb_static_assert(sizeof(CORE_ADDR) >=sizeof(void *))
int run_once
Definition: server.c:87
gdb_environ * get_environ()
Definition: server.c:277
int disable_randomization
Definition: server.c:109
void perror(const char *)
Definition: wincecompat.c:24
void initialize_low()
Definition: linux-low.c:7567
int report_thread_events
Definition: server.c:93
int vasprintf(char **strp, const char *fmt, va_list ap)
int report_vfork_events
Definition: server.c:91
void handle_v_requests(char *own_buf, int packet_len, int *new_packet_len)
Definition: server.c:3093
int disable_packet_Tthread
Definition: server.c:130
int server_waiting
Definition: server.c:80
Definition: ptid.h:35
int report_fork_events
Definition: server.c:90
ptid_t last_ptid
Definition: server.c:136
int vsnprintf(char *str, size_t size, const char *format, va_list ap)
int pass_signals[]
Definition: server.c:115
void * gdb_client_data
Definition: event-loop.h:22
int handle_serial_event(int err, gdb_client_data client_data)
Definition: server.c:4365
void post_fork_inferior(int pid, const char *program)
Definition: fork-child.c:97
int hwbreak_feature
Definition: server.c:100
int multi_process
Definition: server.c:89
ptid_t cont_thread
Definition: server.c:75
ptid_t general_thread
Definition: server.c:78
int in_queued_stop_replies(ptid_t ptid)
Definition: server.c:238
void discard_queued_stop_replies(ptid_t ptid)
Definition: server.c:198
int gdb_fildes_t
Definition: server.h:113
int handle_target_event(int err, gdb_client_data client_data)
Definition: server.c:4397
int disable_packet_vCont
Definition: server.c:129
char * strerror(int)
char * own_buf
Definition: server.c:138