| 1 | /* Machine independent variables that describe the core file under GDB. |
| 2 | |
| 3 | Copyright (C) 1986-2020 Free Software Foundation, Inc. |
| 4 | |
| 5 | This file is part of GDB. |
| 6 | |
| 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 |
| 9 | the Free Software Foundation; either version 3 of the License, or |
| 10 | (at your option) any later version. |
| 11 | |
| 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. |
| 16 | |
| 17 | You should have received a copy of the GNU General Public License |
| 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
| 19 | |
| 20 | /* Interface routines for core, executable, etc. */ |
| 21 | |
| 22 | #if !defined (GDBCORE_H) |
| 23 | #define GDBCORE_H 1 |
| 24 | |
| 25 | struct type; |
| 26 | struct regcache; |
| 27 | |
| 28 | #include "bfd.h" |
| 29 | #include "exec.h" |
| 30 | #include "target.h" |
| 31 | |
| 32 | /* Nonzero if there is a core file. */ |
| 33 | |
| 34 | extern int have_core_file_p (void); |
| 35 | |
| 36 | /* Report a memory error with error(). */ |
| 37 | |
| 38 | extern void memory_error (enum target_xfer_status status, CORE_ADDR memaddr); |
| 39 | |
| 40 | /* The string 'memory_error' would use as exception message. */ |
| 41 | |
| 42 | extern std::string memory_error_message (enum target_xfer_status err, |
| 43 | struct gdbarch *gdbarch, |
| 44 | CORE_ADDR memaddr); |
| 45 | |
| 46 | /* Like target_read_memory, but report an error if can't read. */ |
| 47 | |
| 48 | extern void read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
| 49 | |
| 50 | /* Like target_read_stack, but report an error if can't read. */ |
| 51 | |
| 52 | extern void read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
| 53 | |
| 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 | |
| 58 | /* Read an integer from debugged memory, given address and number of |
| 59 | bytes. */ |
| 60 | |
| 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, |
| 64 | enum bfd_endian byte_order, |
| 65 | LONGEST *return_value); |
| 66 | |
| 67 | /* Read an unsigned integer from debugged memory, given address and |
| 68 | number of bytes. */ |
| 69 | |
| 70 | extern ULONGEST read_memory_unsigned_integer (CORE_ADDR memaddr, |
| 71 | int len, |
| 72 | enum bfd_endian byte_order); |
| 73 | extern int safe_read_memory_unsigned_integer (CORE_ADDR memaddr, int len, |
| 74 | enum bfd_endian byte_order, |
| 75 | ULONGEST *return_value); |
| 76 | |
| 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 | |
| 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. */ |
| 93 | |
| 94 | extern void read_memory_string (CORE_ADDR, char *, int); |
| 95 | |
| 96 | /* Read the pointer of type TYPE at ADDR, and return the address it |
| 97 | represents. */ |
| 98 | |
| 99 | CORE_ADDR read_memory_typed_address (CORE_ADDR addr, struct type *type); |
| 100 | |
| 101 | /* Same as target_write_memory, but report an error if can't |
| 102 | write. */ |
| 103 | |
| 104 | extern void write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, |
| 105 | ssize_t len); |
| 106 | |
| 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 | |
| 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, |
| 115 | enum bfd_endian byte_order, |
| 116 | ULONGEST value); |
| 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, |
| 120 | enum bfd_endian byte_order, |
| 121 | LONGEST value); |
| 122 | \f |
| 123 | /* Hook for `exec_file_command' command to call. */ |
| 124 | |
| 125 | extern void (*deprecated_exec_file_display_hook) (const char *filename); |
| 126 | |
| 127 | /* Hook for "file_command", which is more useful than above |
| 128 | (because it is invoked AFTER symbols are read, not before). */ |
| 129 | |
| 130 | extern void (*deprecated_file_changed_hook) (const char *filename); |
| 131 | |
| 132 | extern void specify_exec_file_hook (void (*hook) (const char *filename)); |
| 133 | |
| 134 | /* Binary File Diddler for the core file. */ |
| 135 | |
| 136 | #define core_bfd (current_program_space->cbfd.get ()) |
| 137 | |
| 138 | /* Whether to open exec and core files read-only or read-write. */ |
| 139 | |
| 140 | extern bool write_files; |
| 141 | |
| 142 | /* Open and set up the core file bfd. */ |
| 143 | |
| 144 | extern void core_target_open (const char *arg, int from_tty); |
| 145 | |
| 146 | extern void core_file_command (const char *filename, int from_tty); |
| 147 | |
| 148 | extern void exec_file_attach (const char *filename, int from_tty); |
| 149 | |
| 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 |
| 153 | the filename of the main executable is already known. |
| 154 | DEFER_BP_RESET uses SYMFILE_DEFER_BP_RESET for the main symbol file. */ |
| 155 | |
| 156 | extern void exec_file_locate_attach (int pid, int defer_bp_reset, int from_tty); |
| 157 | |
| 158 | extern void validate_files (void); |
| 159 | |
| 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 | |
| 165 | /* The current default bfd target. */ |
| 166 | |
| 167 | extern const char *gnutarget; |
| 168 | |
| 169 | extern void set_gnutarget (const char *); |
| 170 | |
| 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 | |
| 203 | DISABLE_COPY_AND_ASSIGN (thread_section_name); |
| 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 | |
| 214 | #endif /* !defined (GDBCORE_H) */ |