Mercurial > ecos
annotate packages/hal/common/current/include/generic-stub.h @ 317:4882695334f2
HW watch/breakpoint support change
| author | msalter |
|---|---|
| date | Thu, 29 Aug 2002 16:15:32 +0000 |
| parents | d2c90368aeef |
| children | 4747af8ef0ef |
| rev | line source |
|---|---|
|
64
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
1 //======================================================================== |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
2 // |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
3 // generic-stub.h |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
4 // |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
5 // Definitions for the generic GDB remote stub |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
6 // |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
7 //======================================================================== |
|
208
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
8 //####ECOSGPLCOPYRIGHTBEGIN#### |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
9 // ------------------------------------------- |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
10 // This file is part of eCos, the Embedded Configurable Operating System. |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
11 // Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc. |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
12 // |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
13 // eCos is free software; you can redistribute it and/or modify it under |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
14 // the terms of the GNU General Public License as published by the Free |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
15 // Software Foundation; either version 2 or (at your option) any later version. |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
16 // |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
17 // eCos is distributed in the hope that it will be useful, but WITHOUT ANY |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
18 // WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
19 // FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
20 // for more details. |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
21 // |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
22 // You should have received a copy of the GNU General Public License along |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
23 // with eCos; if not, write to the Free Software Foundation, Inc., |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
24 // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
25 // |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
26 // As a special exception, if other files instantiate templates or use macros |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
27 // or inline functions from this file, or you compile this file and link it |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
28 // with other works to produce a work based on this file, this file does not |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
29 // by itself cause the resulting work to be covered by the GNU General Public |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
30 // License. However the source code for this file must still be made available |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
31 // in accordance with section (3) of the GNU General Public License. |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
32 // |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
33 // This exception does not invalidate any other reasons why a work based on |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
34 // this file might be covered by the GNU General Public License. |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
35 // |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
36 // Alternative licenses for eCos may be arranged by contacting Red Hat, Inc. |
|
210
d2c90368aeef
Merge from eCos master repository on 2002-05-23-21:39:14-BST
jlarmour
parents:
208
diff
changeset
|
37 // at http://sources.redhat.com/ecos/ecos-license/ |
|
208
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
38 // ------------------------------------------- |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
39 //####ECOSGPLCOPYRIGHTEND#### |
|
64
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
40 //======================================================================== |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
41 //#####DESCRIPTIONBEGIN#### |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
42 // |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
43 // Author(s): Red Hat, nickg |
|
115
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
112
diff
changeset
|
44 // Contributors: Red Hat, nickg, dmoseley |
|
64
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
45 // Date: 1998-06-08 |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
46 // Purpose: |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
47 // Description: Definitions for the generic GDB remote stub |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
48 // Usage: This header is not to be included by user code, and is |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
49 // only placed in a publically accessible directory so |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
50 // that platform stub packages are able to include it |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
51 // if required. |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
52 // |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
53 //####DESCRIPTIONEND#### |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
54 // |
|
c38311975d4f
Merge from eCos master repository on 2000-01-28-04:28:11-GMT
jlarmour
parents:
54
diff
changeset
|
55 //======================================================================== |
|
54
f10165814f1e
Merge from eCos master repository on 1999-11-19-22:24:39-GMT
jlarmour
parents:
34
diff
changeset
|
56 |
|
f10165814f1e
Merge from eCos master repository on 1999-11-19-22:24:39-GMT
jlarmour
parents:
34
diff
changeset
|
57 |
| 0 | 58 #ifndef GENERIC_STUB_H |
| 59 #define GENERIC_STUB_H | |
| 60 | |
|
76
435cced73e2f
eCos v1.3.1 merged from eCos master repository on 2000-03-27-23:22:51-BST
jlarmour
parents:
66
diff
changeset
|
61 #ifdef __cplusplus |
|
435cced73e2f
eCos v1.3.1 merged from eCos master repository on 2000-03-27-23:22:51-BST
jlarmour
parents:
66
diff
changeset
|
62 extern "C" { |
|
435cced73e2f
eCos v1.3.1 merged from eCos master repository on 2000-03-27-23:22:51-BST
jlarmour
parents:
66
diff
changeset
|
63 #endif |
|
435cced73e2f
eCos v1.3.1 merged from eCos master repository on 2000-03-27-23:22:51-BST
jlarmour
parents:
66
diff
changeset
|
64 |
| 2 | 65 /* Three typedefs must be provided before including this file. |
| 0 | 66 target_register_t should correspond to the largest register value on |
| 67 this target processor. | |
| 2 | 68 regnames_t corresponds to a type representing a register number. |
| 69 uint32 must correspond to at least a 32-bit unsigned integer type | |
| 70 (it may be larger). */ | |
| 0 | 71 |
| 72 #ifndef ASM | |
| 73 | |
| 2 | 74 #ifndef __ECOS__ |
| 75 #include "dbg-serial.h" | |
| 76 #endif // __ECOS__ | |
| 0 | 77 |
| 2 | 78 struct gdb_packet |
| 79 { | |
| 80 /* The checksum calculated so far. */ | |
| 81 uint32 checksum; | |
| 82 /* The checksum we've received from the remote side. */ | |
| 83 uint32 xmitcsum; | |
| 84 /* Contents of the accumulated packet. */ | |
| 85 char *contents; | |
| 86 /* Number of characters received. */ | |
| 87 uint32 length; | |
| 88 /* | |
| 89 * state is the current state: | |
| 90 * 0 = looking for start of packet | |
| 91 * 1 = got start of packet, looking for # terminator | |
| 92 * 2 = looking for first byte of checksum | |
| 93 * 3 = looking for second byte of checksum (indicating end of packet) | |
| 94 */ | |
| 95 char state; | |
|
191
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
96 char err; // This is set if the packet should be tossed because of overflow |
| 2 | 97 }; |
| 0 | 98 |
| 99 /* Return the currently-saved value corresponding to register REG. */ | |
| 100 extern target_register_t get_register (regnames_t reg); | |
| 101 | |
|
191
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
102 /* Write the contents of register WHICH into VALUE as raw bytes */ |
|
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
103 extern int get_register_as_bytes (regnames_t which, char *value); |
|
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
104 |
|
115
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
112
diff
changeset
|
105 #ifdef CYGHWR_REGISTER_VALIDITY_CHECKING |
|
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
112
diff
changeset
|
106 // Return the validity of register REG. |
|
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
112
diff
changeset
|
107 extern int get_register_valid (regnames_t reg); |
|
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
112
diff
changeset
|
108 #endif |
|
6ed91473a1cd
Merge from eCos master repository on 2000-08-21-22:40:54-BST
jlarmour
parents:
112
diff
changeset
|
109 |
| 0 | 110 /* Store VALUE in the register corresponding to WHICH. */ |
| 111 extern void put_register (regnames_t which, target_register_t value); | |
| 112 | |
|
191
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
113 extern int put_register_as_bytes (regnames_t which, char *value); |
|
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
114 |
| 0 | 115 /* Set the next instruction to be executed when the user program resumes |
| 116 execution to PC. */ | |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
117 #if !defined(SET_PC_PROTOTYPE_EXISTS) && !defined(set_pc) |
|
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
118 #define SET_PC_PROTOTYPE_EXISTS |
| 0 | 119 extern void set_pc (target_register_t pc); |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
120 #endif |
| 0 | 121 |
| 122 /* Set the return value of the currently-pending syscall to VALUE. */ | |
| 123 extern void set_syscall_value (target_register_t value); | |
| 124 | |
| 125 /* Return the Nth argument to the currently-pending syscall (starting from | |
| 126 0). */ | |
| 127 extern target_register_t get_syscall_arg (int n); | |
| 128 | |
| 129 /* Initialize the stub. This will also install any trap handlers needed by | |
| 130 the stub. */ | |
| 131 extern void initialize_stub (void); | |
| 132 | |
| 133 /* Initialize the hardware. */ | |
| 134 extern void initHardware (void); | |
| 135 | |
| 136 /* Skip the current instruction. */ | |
| 137 extern void __skipinst (void); | |
| 138 | |
| 2 | 139 /* If the address in the PC register corresponds to the breakpoint() |
| 140 instruction, return a non-zero value. */ | |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
141 #ifndef __is_breakpoint_function |
| 0 | 142 extern int __is_breakpoint_function (void); |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
143 #endif |
| 0 | 144 |
| 145 /* Execute a breakpoint instruction. Restarting will cause the instruction | |
| 146 to be skipped. */ | |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
147 #ifndef breakpoint |
| 0 | 148 extern void breakpoint (void); |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
149 #endif |
| 0 | 150 |
| 151 /* Return the syscall # corresponding to this system call. */ | |
| 152 extern int __get_syscall_num (void); | |
| 153 | |
| 154 /* Transfer exception event processing to the stub. */ | |
| 155 extern void __switch_to_stub (void); | |
| 156 | |
| 157 /* Send an exit packet containing the specified status. */ | |
| 158 extern void __send_exit_status (int status); | |
| 159 | |
| 2 | 160 /* Copy COUNT bytes of memory from ADDR to BUF. |
| 161 ADDR is assumed to live in the user program's space. | |
| 162 Returns number of bytes successfully read | |
| 163 (caller must check to see if less than requested). */ | |
|
34
29bc183297e1
Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents:
2
diff
changeset
|
164 extern int __read_mem_safe (void *buf, |
|
29bc183297e1
Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents:
2
diff
changeset
|
165 void *addr, |
| 2 | 166 int count); |
| 0 | 167 |
|
156
b939e9cada46
Merge from eCos master repository on 2001-03-29-21:44:39-BST
jlarmour
parents:
115
diff
changeset
|
168 extern int __read_progmem_safe (void *buf, |
|
b939e9cada46
Merge from eCos master repository on 2001-03-29-21:44:39-BST
jlarmour
parents:
115
diff
changeset
|
169 void *addr, |
|
b939e9cada46
Merge from eCos master repository on 2001-03-29-21:44:39-BST
jlarmour
parents:
115
diff
changeset
|
170 int count); |
|
b939e9cada46
Merge from eCos master repository on 2001-03-29-21:44:39-BST
jlarmour
parents:
115
diff
changeset
|
171 |
| 2 | 172 /* Copy COUNT bytes of memory from BUF to ADDR. |
| 173 ADDR is assumed to live in the user program's space. | |
| 174 Returns number of bytes successfully read | |
| 175 (caller must check to see if less than requested). */ | |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
176 #ifndef __write_mem_safe |
|
34
29bc183297e1
Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents:
2
diff
changeset
|
177 extern int __write_mem_safe (void *buf, |
|
29bc183297e1
Merge from eCos master repository on 1999-09-02-16:26:10-BST
jlarmour
parents:
2
diff
changeset
|
178 void *addr, |
| 2 | 179 int count); |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
180 #endif |
| 0 | 181 |
|
156
b939e9cada46
Merge from eCos master repository on 2001-03-29-21:44:39-BST
jlarmour
parents:
115
diff
changeset
|
182 extern int __write_progmem_safe (void *buf, |
|
b939e9cada46
Merge from eCos master repository on 2001-03-29-21:44:39-BST
jlarmour
parents:
115
diff
changeset
|
183 void *addr, |
|
b939e9cada46
Merge from eCos master repository on 2001-03-29-21:44:39-BST
jlarmour
parents:
115
diff
changeset
|
184 int count); |
|
b939e9cada46
Merge from eCos master repository on 2001-03-29-21:44:39-BST
jlarmour
parents:
115
diff
changeset
|
185 |
| 2 | 186 /* Set to a non-zero value if a memory fault occurs while |
| 187 __set_mem_fault_trap () is running. */ | |
| 188 extern volatile int __mem_fault; | |
| 189 | |
| 190 #ifndef __ECOS__ | |
| 191 #if 1 | |
| 192 #include "stub-tservice.h" /* target dependent stub services */ | |
| 193 #else | |
| 0 | 194 /* Flush the instruction cache. */ |
| 195 extern void flush_i_cache (void); | |
| 196 | |
| 197 /* Flush the data cache. */ | |
| 198 extern void __flush_d_cache (void); | |
| 199 | |
| 200 typedef enum { | |
| 201 CACHE_NOOP, CACHE_ENABLE, CACHE_DISABLE, CACHE_FLUSH | |
| 202 } cache_control_t; | |
| 203 | |
| 204 /* Perform the specified operation on the instruction cache. | |
| 205 Returns 1 if the cache is enabled, 0 otherwise. */ | |
| 206 extern int __instruction_cache (cache_control_t request); | |
| 207 /* Perform the specified operation on the data cache. | |
| 208 Returns 1 if the cache is enabled, 0 otherwise. */ | |
| 209 extern int __data_cache (cache_control_t request); | |
| 2 | 210 #endif |
| 211 #endif // __ECOS__ | |
| 0 | 212 |
| 213 /* Write the 'T' packet in BUFFER. SIGVAL is the signal the program | |
| 214 received. */ | |
| 215 extern void __build_t_packet (int sigval, char *buffer); | |
| 216 | |
| 217 /* Return 1 when a complete packet has been received, 0 if the packet | |
| 218 is not yet complete, or -1 if an erroneous packet was NAKed. */ | |
| 2 | 219 int __add_char_to_packet (unsigned character, struct gdb_packet *packet); |
| 0 | 220 |
| 221 typedef int (*__PFI)(int); | |
| 222 typedef void (*__PFV)(void); | |
| 223 | |
| 224 /* When an exception occurs, __process_exception_vec will be invoked with | |
| 225 the signal number corresponding to the trap/exception. The function | |
| 226 should return zero if it wishes execution to resume from the saved | |
| 227 register values; a non-zero value indicates that the exception handler | |
| 228 should be reinvoked. */ | |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
229 #if !defined(PROCESS_EXCEPTION_VEC_PROTOTYPE_EXISTS) |
|
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
230 #define PROCESS_EXCEPTION_VEC_PROTOTYPE_EXISTS |
| 0 | 231 extern volatile __PFI __process_exception_vec; |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
232 #endif |
| 2 | 233 |
| 234 /* __process_exit_vec is invoked when a 'k' kill packet is received | |
| 235 from GDB. */ | |
| 0 | 236 extern volatile __PFV __process_exit_vec; |
| 2 | 237 |
| 238 /* If SIGSYSCALL is defined, and such a signal value is returned from | |
| 239 __computeSignal (), the function pointed to by this vector will | |
| 240 be invoked. | |
| 241 | |
| 242 If the return value is negative, the user program is assumed to | |
| 243 have received the corresponding positive signal value, and an | |
| 244 exception will be processed. Otherwise, the user program is | |
| 245 restarted from the next instruction. */ | |
| 0 | 246 extern volatile __PFI __process_syscall_vec; |
| 2 | 247 |
| 248 /* A continue packet was received from GDB with a signal value. The function | |
| 249 pointed to by __process_signal_vec will be invoked with this signal | |
| 250 value. | |
| 251 | |
| 252 If a zero value is returned, we will ignore the signal, and proceed | |
| 253 with the continue request. Otherwise, the program will be killed | |
| 254 with the signal. */ | |
| 0 | 255 extern volatile __PFI __process_signal_vec; |
| 2 | 256 |
| 257 /* If non-NULL, __init_vec is called right before the user program is | |
| 258 resumed. */ | |
| 259 extern volatile __PFV __init_vec; | |
| 260 /* if non-NULL, __cleanup_vec is called after the user program takes | |
| 261 an exception. */ | |
| 262 extern volatile __PFV __cleanup_vec; | |
| 0 | 263 |
| 264 /* Send an 'O' packet to GDB containing STR. */ | |
| 2 | 265 extern int __output_gdb_string (target_register_t addr, int string_len); |
| 0 | 266 |
| 267 /* Request MAXLEN bytes of input from GDB to be stored in DEST. If BLOCK | |
| 268 is set, GDB should block until MAXLEN bytes are available to be | |
| 269 read; otherwise, it will return immediately with whatever data is | |
| 270 available. | |
| 271 The return value is the number of bytes written into DEST. */ | |
| 2 | 272 extern int __get_gdb_input (target_register_t dest, int maxlen, int block); |
| 0 | 273 |
| 2 | 274 /* Return the ASCII equivalent of C (C>=0 && C<=15). The result will be |
| 275 lower-case. */ | |
| 0 | 276 extern char __tohex (int c); |
| 277 | |
| 2 | 278 /* Convert COUNT bytes of the memory region in MEM to a hexadecimal |
| 279 string in DEST. | |
| 280 The resulting string will contain 2*COUNT characters. | |
| 281 If MAY_FAULT is non-zero, memory faults are trapped; if a fault occurs, | |
| 282 a NULL value will be returned. | |
| 283 The value returned is one byte past the end of the string written. */ | |
| 284 extern char *__mem2hex (char *mem, char *dest, int count, int may_fault); | |
| 285 | |
| 286 /* Given a hexadecimal string in MEM, write the equivalent bytes to DEST. | |
| 287 The string is assumed to contain 2*COUNT characters. | |
| 288 If MAY_FAULT is non-zero, memory faults are trapped; if a fault occurs, | |
| 289 a NULL value will be returned. | |
| 290 Otherwise, the value returned is one byte past the last byte written. */ | |
| 291 extern char *__hex2mem (char *buf, char *mem, int count, int may_fault); | |
| 292 | |
| 293 /* Set the program arguments passed into the user program's main */ | |
| 294 extern void __set_program_args (int argc, char **argv); | |
| 295 | |
| 296 /* Return the user program arguments passed in from GDB (via an 'A' | |
| 297 packet). argcPtr is a pointer into the user program, which will hold | |
| 298 the number of arguments; the strings are returned. */ | |
| 299 extern char **__get_program_args (target_register_t argcPtr); | |
| 300 | |
| 301 /* Encode PACKET as a remote protocol packet and send it to GDB; this takes | |
| 302 care of sending the initial '$' character, as well as the trailing '#' | |
| 303 and checksum, and also waits for an ACK from the remote side, resending | |
| 304 as necessary. */ | |
| 305 extern void __putpacket (char *packet); | |
| 306 | |
|
208
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
307 /* Retrieve the next remote protocol packet from GDB, taking care of verifying |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
308 the checksum and sending an ACK when necessary. */ |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
309 extern void __getpacket (char *buffer); |
|
e0c0827131d1
Merge from eCos master repository on 2002-05-20-20:11:54-BST
jlarmour
parents:
191
diff
changeset
|
310 |
| 2 | 311 /* Convert the hexadecimal string pointed to by *PTR into an integer, |
| 312 and store it in the value pointed to by INTVALUE. The number of | |
| 313 characters read from *PTR will be returned; *PTR will point to the first | |
| 314 non-hexadecmial character encountered. */ | |
| 315 extern unsigned int __hexToInt (char **ptr, target_register_t *intValue); | |
| 316 | |
| 317 /* Convert the value in INTVALUE into a string of hexadecimal | |
| 318 characters stored in PTR. NUMBITS are the number of bits to use | |
| 319 in INTVALUE. The number of characters written to PTR will be returned. */ | |
| 320 extern unsigned int __intToHex (char *ptr, | |
| 321 target_register_t intValue, | |
| 322 int numBits); | |
| 323 | |
| 324 /* Handle an exception, usually some sort of hardware or software trap. | |
| 325 This is responsible for communicating the exception to GDB. */ | |
| 326 extern void __handle_exception (void); | |
| 327 | |
| 328 /* Send a 'X' packet with signal SIGVAL to GDB. */ | |
| 329 extern void __kill_program (int sigval); | |
| 330 | |
| 331 /* Given a packet pointed to by PACKETCONTENTS, decode it and respond to | |
| 332 GDB appropriately. */ | |
| 333 extern int __process_packet (char *packetContents); | |
| 334 | |
| 335 /* Write the C-style string pointed to by STR to the GDB comm port. | |
| 336 Used for printing debug messages. */ | |
| 337 extern void __putDebugStr (char *str); | |
| 338 | |
|
112
02ea4320376c
Merge from eCos master repository on 2000-07-21-21:01:39-BST
jlarmour
parents:
76
diff
changeset
|
339 #if defined(NO_MALLOC) && !defined(MAX_BP_NUM) |
| 2 | 340 #define MAX_BP_NUM 64 /* Maximum allowed # of breakpoints */ |
| 0 | 341 #endif |
| 342 | |
|
191
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
343 extern int hal_syscall_handler(void); |
|
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
344 extern int __is_bsp_syscall(void); |
|
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
345 |
|
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
346 extern void __install_breakpoint_list (void); |
|
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
347 extern void __clear_breakpoint_list (void); |
|
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
348 extern int __display_breakpoint_list (void (*print_func)(target_register_t)); |
|
678094f34118
Merge from eCos master repository on 2001-10-19-06:43:02-BST
jlarmour
parents:
156
diff
changeset
|
349 |
| 317 | 350 /* 'Z' packet types */ |
| 351 #define ZTYPE_SW_BREAKPOINT 0 | |
| 352 #define ZTYPE_HW_BREAKPOINT 1 | |
| 353 #define ZTYPE_HW_WATCHPOINT_WRITE 2 | |
| 354 #define ZTYPE_HW_WATCHPOINT_READ 3 | |
| 355 #define ZTYPE_HW_WATCHPOINT_ACCESS 4 | |
| 356 | |
| 2 | 357 #endif /* ASM */ |
| 358 | |
|
76
435cced73e2f
eCos v1.3.1 merged from eCos master repository on 2000-03-27-23:22:51-BST
jlarmour
parents:
66
diff
changeset
|
359 #ifdef __cplusplus |
|
435cced73e2f
eCos v1.3.1 merged from eCos master repository on 2000-03-27-23:22:51-BST
jlarmour
parents:
66
diff
changeset
|
360 } /* extern "C" */ |
|
435cced73e2f
eCos v1.3.1 merged from eCos master repository on 2000-03-27-23:22:51-BST
jlarmour
parents:
66
diff
changeset
|
361 #endif |
|
435cced73e2f
eCos v1.3.1 merged from eCos master repository on 2000-03-27-23:22:51-BST
jlarmour
parents:
66
diff
changeset
|
362 |
| 2 | 363 #endif /* GENERIC_STUB_H */ |
