Commit | Line | Data |
---|---|---|
c906108c | 1 | /* Machine independent variables that describe the core file under GDB. |
00e32a35 | 2 | |
b811d2c2 | 3 | Copyright (C) 1986-2020 Free Software Foundation, Inc. |
c906108c | 4 | |
c5aa993b | 5 | This file is part of GDB. |
c906108c | 6 | |
c5aa993b JM |
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 | |
a9762ec7 | 9 | the Free Software Foundation; either version 3 of the License, or |
c5aa993b | 10 | (at your option) any later version. |
c906108c | 11 | |
c5aa993b JM |
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. | |
c906108c | 16 | |
c5aa993b | 17 | You should have received a copy of the GNU General Public License |
a9762ec7 | 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
c906108c SS |
19 | |
20 | /* Interface routines for core, executable, etc. */ | |
21 | ||
22 | #if !defined (GDBCORE_H) | |
23 | #define GDBCORE_H 1 | |
24 | ||
da3331ec | 25 | struct type; |
9eefc95f | 26 | struct regcache; |
da3331ec | 27 | |
c906108c | 28 | #include "bfd.h" |
6c95b8df | 29 | #include "exec.h" |
578d3588 | 30 | #include "target.h" |
c906108c | 31 | |
c906108c SS |
32 | /* Nonzero if there is a core file. */ |
33 | ||
a14ed312 | 34 | extern int have_core_file_p (void); |
c906108c | 35 | |
c906108c SS |
36 | /* Report a memory error with error(). */ |
37 | ||
9b409511 | 38 | extern void memory_error (enum target_xfer_status status, CORE_ADDR memaddr); |
578d3588 | 39 | |
1ccbe998 | 40 | /* The string 'memory_error' would use as exception message. */ |
578d3588 | 41 | |
1ccbe998 TT |
42 | extern std::string memory_error_message (enum target_xfer_status err, |
43 | struct gdbarch *gdbarch, | |
44 | CORE_ADDR memaddr); | |
c906108c SS |
45 | |
46 | /* Like target_read_memory, but report an error if can't read. */ | |
47 | ||
45aa4659 | 48 | extern void read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
c906108c | 49 | |
4e5d721f DE |
50 | /* Like target_read_stack, but report an error if can't read. */ |
51 | ||
45aa4659 | 52 | extern void read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
4e5d721f | 53 | |
0865b04a YQ |
54 | /* Like target_read_code, but report an error if can't read. */ |
55 | ||
56 | extern void read_code (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); | |
57 | ||
c906108c SS |
58 | /* Read an integer from debugged memory, given address and number of |
59 | bytes. */ | |
60 | ||
e17a4113 UW |
61 | extern LONGEST read_memory_integer (CORE_ADDR memaddr, |
62 | int len, enum bfd_endian byte_order); | |
63 | extern int safe_read_memory_integer (CORE_ADDR memaddr, int len, | |
3e43a32a MS |
64 | enum bfd_endian byte_order, |
65 | LONGEST *return_value); | |
c906108c SS |
66 | |
67 | /* Read an unsigned integer from debugged memory, given address and | |
68 | number of bytes. */ | |
69 | ||
e17a4113 | 70 | extern ULONGEST read_memory_unsigned_integer (CORE_ADDR memaddr, |
3e43a32a MS |
71 | int len, |
72 | enum bfd_endian byte_order); | |
cc2c4da8 MK |
73 | extern int safe_read_memory_unsigned_integer (CORE_ADDR memaddr, int len, |
74 | enum bfd_endian byte_order, | |
75 | ULONGEST *return_value); | |
c906108c | 76 | |
0865b04a YQ |
77 | /* Read an integer from debugged code memory, given address, |
78 | number of bytes, and byte order for code. */ | |
79 | ||
80 | extern LONGEST read_code_integer (CORE_ADDR memaddr, int len, | |
81 | enum bfd_endian byte_order); | |
82 | ||
83 | /* Read an unsigned integer from debugged code memory, given address, | |
84 | number of bytes, and byte order for code. */ | |
85 | ||
86 | extern ULONGEST read_code_unsigned_integer (CORE_ADDR memaddr, | |
87 | int len, | |
88 | enum bfd_endian byte_order); | |
89 | ||
0963b4bd MS |
90 | /* Read a null-terminated string from the debuggee's memory, given |
91 | address, a buffer into which to place the string, and the maximum | |
92 | available space. */ | |
0d540cdf | 93 | |
a14ed312 | 94 | extern void read_memory_string (CORE_ADDR, char *, int); |
c906108c | 95 | |
0d540cdf | 96 | /* Read the pointer of type TYPE at ADDR, and return the address it |
0963b4bd | 97 | represents. */ |
0d540cdf | 98 | |
570b8f7c | 99 | CORE_ADDR read_memory_typed_address (CORE_ADDR addr, struct type *type); |
0d540cdf | 100 | |
cb6f16cf SM |
101 | /* Same as target_write_memory, but report an error if can't |
102 | write. */ | |
c906108c | 103 | |
45aa4659 JK |
104 | extern void write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, |
105 | ssize_t len); | |
c906108c | 106 | |
972daa01 YQ |
107 | /* Same as write_memory, but notify 'memory_changed' observers. */ |
108 | ||
109 | extern void write_memory_with_notification (CORE_ADDR memaddr, | |
110 | const bfd_byte *myaddr, | |
111 | ssize_t len); | |
112 | ||
c26e4683 JB |
113 | /* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */ |
114 | extern void write_memory_unsigned_integer (CORE_ADDR addr, int len, | |
e17a4113 UW |
115 | enum bfd_endian byte_order, |
116 | ULONGEST value); | |
c26e4683 JB |
117 | |
118 | /* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */ | |
119 | extern void write_memory_signed_integer (CORE_ADDR addr, int len, | |
e17a4113 | 120 | enum bfd_endian byte_order, |
c26e4683 | 121 | LONGEST value); |
c906108c SS |
122 | \f |
123 | /* Hook for `exec_file_command' command to call. */ | |
124 | ||
5f08566b | 125 | extern void (*deprecated_exec_file_display_hook) (const char *filename); |
c906108c SS |
126 | |
127 | /* Hook for "file_command", which is more useful than above | |
3a9a986f | 128 | (because it is invoked AFTER symbols are read, not before). */ |
c906108c | 129 | |
1d8b34a7 | 130 | extern void (*deprecated_file_changed_hook) (const char *filename); |
c906108c | 131 | |
5f08566b | 132 | extern void specify_exec_file_hook (void (*hook) (const char *filename)); |
c906108c | 133 | |
6c95b8df | 134 | /* Binary File Diddler for the core file. */ |
c906108c | 135 | |
06333fea | 136 | #define core_bfd (current_program_space->cbfd.get ()) |
c04ea773 | 137 | |
c906108c SS |
138 | /* Whether to open exec and core files read-only or read-write. */ |
139 | ||
491144b5 | 140 | extern bool write_files; |
c906108c | 141 | |
d9f719f1 PA |
142 | /* Open and set up the core file bfd. */ |
143 | ||
144 | extern void core_target_open (const char *arg, int from_tty); | |
145 | ||
d64097b1 | 146 | extern void core_file_command (const char *filename, int from_tty); |
c906108c | 147 | |
5f08566b | 148 | extern void exec_file_attach (const char *filename, int from_tty); |
c906108c | 149 | |
a10de604 GB |
150 | /* If the filename of the main executable is unknown, attempt to |
151 | determine it. If a filename is determined, proceed as though | |
152 | it was just specified with the "file" command. Do nothing if | |
bb805577 JK |
153 | the filename of the main executable is already known. |
154 | DEFER_BP_RESET uses SYMFILE_DEFER_BP_RESET for the main symbol file. */ | |
a10de604 | 155 | |
bb805577 | 156 | extern void exec_file_locate_attach (int pid, int defer_bp_reset, int from_tty); |
a10de604 | 157 | |
a14ed312 | 158 | extern void validate_files (void); |
c906108c | 159 | |
a2fedca9 PW |
160 | /* Give the user a message if the current exec file does not match the exec |
161 | file determined from the target. In case of mismatch, ask the user | |
162 | if the exec file determined from target must be loaded. */ | |
163 | extern void validate_exec_file (int from_tty); | |
164 | ||
c906108c SS |
165 | /* The current default bfd target. */ |
166 | ||
4e7625fd | 167 | extern const char *gnutarget; |
c906108c | 168 | |
a121b7c1 | 169 | extern void set_gnutarget (const char *); |
c906108c | 170 | |
6e5eab33 JB |
171 | /* Build either a single-thread or multi-threaded section name for |
172 | PTID. | |
173 | ||
174 | If ptid's lwp member is zero, we want to do the single-threaded | |
175 | thing: look for a section named NAME (as passed to the | |
176 | constructor). If ptid's lwp member is non-zero, we'll want do the | |
177 | multi-threaded thing: look for a section named "NAME/LWP", where | |
178 | LWP is the shortest ASCII decimal representation of ptid's lwp | |
179 | member. */ | |
180 | ||
181 | class thread_section_name | |
182 | { | |
183 | public: | |
184 | /* NAME is the single-threaded section name. If PTID represents an | |
185 | LWP, then the build section name is "NAME/LWP", otherwise it's | |
186 | just "NAME" unmodified. */ | |
187 | thread_section_name (const char *name, ptid_t ptid) | |
188 | { | |
189 | if (ptid.lwp_p ()) | |
190 | { | |
191 | m_storage = string_printf ("%s/%ld", name, ptid.lwp ()); | |
192 | m_section_name = m_storage.c_str (); | |
193 | } | |
194 | else | |
195 | m_section_name = name; | |
196 | } | |
197 | ||
198 | /* Return the computed section name. The result is valid as long as | |
199 | this thread_section_name object is live. */ | |
200 | const char *c_str () const | |
201 | { return m_section_name; } | |
202 | ||
d6541620 | 203 | DISABLE_COPY_AND_ASSIGN (thread_section_name); |
6e5eab33 JB |
204 | |
205 | private: | |
206 | /* Either a pointer into M_STORAGE, or a pointer to the name passed | |
207 | as parameter to the constructor. */ | |
208 | const char *m_section_name; | |
209 | /* If we need to build a new section name, this is where we store | |
210 | it. */ | |
211 | std::string m_storage; | |
212 | }; | |
213 | ||
c5aa993b | 214 | #endif /* !defined (GDBCORE_H) */ |