GDBserver
tracepoint.h
Go to the documentation of this file.
1 /* Tracepoint code for remote server for GDB.
2  Copyright (C) 1993-2015 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 TRACEPOINT_H
20 #define TRACEPOINT_H
21 
22 /* Size for a small buffer to report problems from the in-process
23  agent back to GDBserver. */
24 #define IPA_BUFSIZ 100
25 
26 void initialize_tracepoint (void);
27 
28 #if defined(__GNUC__)
29 # define ATTR_USED __attribute__((used))
30 # define ATTR_NOINLINE __attribute__((noinline))
31 #else
32 # define ATTR_USED
33 # define ATTR_NOINLINE
34 #endif
35 
36 /* How to make symbol public/exported. */
37 
38 #if defined _WIN32 || defined __CYGWIN__
39 # define EXPORTED_SYMBOL __declspec (dllexport)
40 #else
41 # if __GNUC__ >= 4
42 # define EXPORTED_SYMBOL __attribute__ ((visibility ("default")))
43 # else
44 # define EXPORTED_SYMBOL
45 # endif
46 #endif
47 
48 /* Use these to make sure the functions and variables the IPA needs to
49  export (symbols GDBserver needs to query GDB about) are visible and
50  have C linkage.
51 
52  Tag exported functions with IP_AGENT_EXPORT_FUNC, tag the
53  definitions of exported variables with IP_AGENT_EXPORT_VAR, and
54  variable declarations with IP_AGENT_EXPORT_VAR_DECL. Variables
55  must also be exported with C linkage. As we can't both use extern
56  "C" and initialize a variable in the same statement, variables that
57  don't have a separate declaration must use
58  EXTERN_C_PUSH/EXTERN_C_POP around their definition. */
59 
60 #ifdef IN_PROCESS_AGENT
61 # define IP_AGENT_EXPORT_FUNC EXTERN_C EXPORTED_SYMBOL ATTR_NOINLINE ATTR_USED
62 # define IP_AGENT_EXPORT_VAR EXPORTED_SYMBOL ATTR_USED
63 # define IP_AGENT_EXPORT_VAR_DECL EXTERN_C EXPORTED_SYMBOL
64 #else
65 # define IP_AGENT_EXPORT_FUNC
66 # define IP_AGENT_EXPORT_VAR
67 # define IP_AGENT_EXPORT_VAR_DECL extern
68 #endif
69 
71 
72 extern int disconnected_tracing;
73 
74 void tracepoint_look_up_symbols (void);
75 
76 void stop_tracing (void);
77 
80 
81 int tracepoint_finished_step (struct thread_info *tinfo, CORE_ADDR stop_pc);
82 int tracepoint_was_hit (struct thread_info *tinfo, CORE_ADDR stop_pc);
83 
85 
86 extern int current_traceframe;
87 
88 int in_readonly_region (CORE_ADDR addr, ULONGEST length);
89 int traceframe_read_mem (int tfnum, CORE_ADDR addr,
90  unsigned char *buf, ULONGEST length,
91  ULONGEST *nbytes);
92 int fetch_traceframe_registers (int tfnum,
93  struct regcache *regcache,
94  int regnum);
95 
96 int traceframe_read_sdata (int tfnum, ULONGEST offset,
97  unsigned char *buf, ULONGEST length,
98  ULONGEST *nbytes);
99 
100 int traceframe_read_info (int tfnum, struct buffer *buffer);
101 
102 /* If a thread is determined to be collecting a fast tracepoint, this
103  structure holds the collect status. */
104 
106 {
107  /* The tracepoint that is presently being collected. */
110 
111  /* The address range in the jump pad of where the original
112  instruction the tracepoint jump was inserted was relocated
113  to. */
116 };
117 
118 int fast_tracepoint_collecting (CORE_ADDR thread_area,
119  CORE_ADDR stop_pc,
120  struct fast_tpoint_collect_status *status);
121 void force_unlock_trace_buffer (void);
122 
123 int handle_tracepoint_bkpts (struct thread_info *tinfo, CORE_ADDR stop_pc);
124 
125 #ifdef IN_PROCESS_AGENT
126 void initialize_low_tracepoint (void);
128  const unsigned char *regs);
129 void supply_static_tracepoint_registers (struct regcache *regcache,
130  const unsigned char *regs,
131  CORE_ADDR pc);
132 void set_trampoline_buffer_space (CORE_ADDR begin, CORE_ADDR end,
133  char *errmsg);
134 
135 extern const struct target_desc *ipa_tdesc;
136 
137 #else
138 void stop_tracing (void);
139 
140 int claim_trampoline_space (ULONGEST used, CORE_ADDR *trampoline);
141 int have_fast_tracepoint_trampoline_buffer (char *msgbuf);
142 void gdb_agent_about_to_close (int pid);
143 #endif
144 
145 struct traceframe;
147 
148 /* Do memory copies for bytecodes. */
149 /* Do the recording of memory blocks for actions and bytecodes. */
150 
151 int agent_mem_read (struct eval_agent_expr_context *ctx,
152  unsigned char *to, CORE_ADDR from,
153  ULONGEST len);
154 
157 
158 /* Record the value of a trace state variable. */
159 
160 int agent_tsv_read (struct eval_agent_expr_context *ctx, int n);
162  unsigned char *to,
163  CORE_ADDR from,
164  ULONGEST len);
165 
166 /* The prototype the get_raw_reg function in the IPA. Each arch's
167  bytecode compiler emits calls to this function. */
169  (const unsigned char *raw_regs, int regnum);
170 
171 /* Returns the address of the get_raw_reg function in the IPA. */
173 /* Returns the address of the get_trace_state_variable_value
174  function in the IPA. */
176 /* Returns the address of the set_trace_state_variable_value
177  function in the IPA. */
179 
180 #endif /* TRACEPOINT_H */
#define IP_AGENT_EXPORT_FUNC
Definition: tracepoint.h:65
void stop_tracing(void)
Definition: tracepoint.c:3403
bfd_vma CORE_ADDR
Definition: common-types.h:41
int tracepoint_finished_step(struct thread_info *tinfo, CORE_ADDR stop_pc)
Definition: tracepoint.c:4369
int handle_tracepoint_bkpts(struct thread_info *tinfo, CORE_ADDR stop_pc)
Definition: tracepoint.c:4474
int handle_tracepoint_query(char *own_buf)
Definition: tracepoint.c:4235
int disconnected_tracing
Definition: tracepoint.c:1256
CORE_ADDR adjusted_insn_addr_end
Definition: tracepoint.h:115
int in_readonly_region(CORE_ADDR addr, ULONGEST length)
Definition: tracepoint.c:2906
regnum
void tracepoint_look_up_symbols(void)
Definition: tracepoint.c:312
int traceframe_read_info(int tfnum, struct buffer *buffer)
Definition: tracepoint.c:5460
LONGEST agent_get_trace_state_variable_value(int num)
Definition: tracepoint.c:2153
int offset
Definition: tracepoint.c:179
void force_unlock_trace_buffer(void)
Definition: tracepoint.c:5553
int handle_tracepoint_general_set(char *own_buf)
Definition: tracepoint.c:4158
int tracepoint_was_hit(struct thread_info *tinfo, CORE_ADDR stop_pc)
Definition: tracepoint.c:4556
int agent_tsv_read(struct eval_agent_expr_context *ctx, int n)
Definition: tracepoint.c:5042
CORE_ADDR get_set_tsv_func_addr(void)
Definition: tracepoint.c:5872
int agent_mem_read_string(struct eval_agent_expr_context *ctx, unsigned char *to, CORE_ADDR from, ULONGEST len)
Definition: tracepoint.c:4980
int fetch_traceframe_registers(int tfnum, struct regcache *regcache, int regnum)
Definition: tracepoint.c:5183
CORE_ADDR get_get_tsv_func_addr(void)
Definition: tracepoint.c:5866
void gdb_agent_about_to_close(int pid)
Definition: tracepoint.c:3960
int traceframe_read_sdata(int tfnum, ULONGEST offset, unsigned char *buf, ULONGEST length, ULONGEST *nbytes)
Definition: tracepoint.c:5359
int current_traceframe
Definition: tracepoint.c:984
int traceframe_read_mem(int tfnum, CORE_ADDR addr, unsigned char *buf, ULONGEST length, ULONGEST *nbytes)
Definition: tracepoint.c:5234
int have_fast_tracepoint_trampoline_buffer(char *msgbuf)
Definition: tracepoint.c:3001
static char * own_buf
Definition: server.c:111
Definition: buffer.h:23
void initialize_tracepoint(void)
Definition: tracepoint.c:7345
void initialize_low_tracepoint(void)
int fast_tracepoint_collecting(CORE_ADDR thread_area, CORE_ADDR stop_pc, struct fast_tpoint_collect_status *status)
Definition: tracepoint.c:5569
void release_while_stepping_state_list(struct thread_info *tinfo)
Definition: tracepoint.c:4351
unsigned long long ULONGEST
Definition: common-types.h:53
IP_AGENT_EXPORT_FUNC ULONGEST gdb_agent_get_raw_reg(const unsigned char *raw_regs, int regnum)
void agent_set_trace_state_variable_value(int num, LONGEST val)
Definition: tracepoint.c:2159
#define IP_AGENT_EXPORT_VAR_DECL
Definition: tracepoint.h:67
IP_AGENT_EXPORT_VAR_DECL int tracing
Definition: tracepoint.h:70
int claim_trampoline_space(ULONGEST used, CORE_ADDR *trampoline)
Definition: tracepoint.c:2958
void supply_fast_tracepoint_registers(struct regcache *regcache, const unsigned char *buf)
long long LONGEST
Definition: common-types.h:52
CORE_ADDR get_raw_reg_func_addr(void)
Definition: tracepoint.c:5860
int agent_mem_read(struct eval_agent_expr_context *ctx, unsigned char *to, CORE_ADDR from, ULONGEST len)
Definition: tracepoint.c:4938