| /* Machine independent variables that describe the core file under GDB. |
| |
| Copyright (C) 1986-2019 Free Software Foundation, Inc. |
| |
| This file is part of GDB. |
| |
| This program is free software; you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation; either version 3 of the License, or |
| (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
| |
| /* Interface routines for core, executable, etc. */ |
| |
| #if !defined (GDBCORE_H) |
| #define GDBCORE_H 1 |
| |
| struct type; |
| struct regcache; |
| |
| #include "bfd.h" |
| #include "exec.h" |
| #include "target.h" |
| |
| /* Nonzero if there is a core file. */ |
| |
| extern int have_core_file_p (void); |
| |
| /* Report a memory error with error(). */ |
| |
| extern void memory_error (enum target_xfer_status status, CORE_ADDR memaddr); |
| |
| /* The string 'memory_error' would use as exception message. */ |
| |
| extern std::string memory_error_message (enum target_xfer_status err, |
| struct gdbarch *gdbarch, |
| CORE_ADDR memaddr); |
| |
| /* Like target_read_memory, but report an error if can't read. */ |
| |
| extern void read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
| |
| /* Like target_read_stack, but report an error if can't read. */ |
| |
| extern void read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
| |
| /* Like target_read_code, but report an error if can't read. */ |
| |
| extern void read_code (CORE_ADDR memaddr, gdb_byte *myaddr, ssize_t len); |
| |
| /* Read an integer from debugged memory, given address and number of |
| bytes. */ |
| |
| extern LONGEST read_memory_integer (CORE_ADDR memaddr, |
| int len, enum bfd_endian byte_order); |
| extern int safe_read_memory_integer (CORE_ADDR memaddr, int len, |
| enum bfd_endian byte_order, |
| LONGEST *return_value); |
| |
| /* Read an unsigned integer from debugged memory, given address and |
| number of bytes. */ |
| |
| extern ULONGEST read_memory_unsigned_integer (CORE_ADDR memaddr, |
| int len, |
| enum bfd_endian byte_order); |
| extern int safe_read_memory_unsigned_integer (CORE_ADDR memaddr, int len, |
| enum bfd_endian byte_order, |
| ULONGEST *return_value); |
| |
| /* Read an integer from debugged code memory, given address, |
| number of bytes, and byte order for code. */ |
| |
| extern LONGEST read_code_integer (CORE_ADDR memaddr, int len, |
| enum bfd_endian byte_order); |
| |
| /* Read an unsigned integer from debugged code memory, given address, |
| number of bytes, and byte order for code. */ |
| |
| extern ULONGEST read_code_unsigned_integer (CORE_ADDR memaddr, |
| int len, |
| enum bfd_endian byte_order); |
| |
| /* Read a null-terminated string from the debuggee's memory, given |
| address, a buffer into which to place the string, and the maximum |
| available space. */ |
| |
| extern void read_memory_string (CORE_ADDR, char *, int); |
| |
| /* Read the pointer of type TYPE at ADDR, and return the address it |
| represents. */ |
| |
| CORE_ADDR read_memory_typed_address (CORE_ADDR addr, struct type *type); |
| |
| /* Same as target_write_memory, but report an error if can't |
| write. */ |
| |
| extern void write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, |
| ssize_t len); |
| |
| /* Same as write_memory, but notify 'memory_changed' observers. */ |
| |
| extern void write_memory_with_notification (CORE_ADDR memaddr, |
| const bfd_byte *myaddr, |
| ssize_t len); |
| |
| /* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */ |
| extern void write_memory_unsigned_integer (CORE_ADDR addr, int len, |
| enum bfd_endian byte_order, |
| ULONGEST value); |
| |
| /* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */ |
| extern void write_memory_signed_integer (CORE_ADDR addr, int len, |
| enum bfd_endian byte_order, |
| LONGEST value); |
| |
| /* Hook for `exec_file_command' command to call. */ |
| |
| extern void (*deprecated_exec_file_display_hook) (const char *filename); |
| |
| /* Hook for "file_command", which is more useful than above |
| (because it is invoked AFTER symbols are read, not before). */ |
| |
| extern void (*deprecated_file_changed_hook) (const char *filename); |
| |
| extern void specify_exec_file_hook (void (*hook) (const char *filename)); |
| |
| /* Binary File Diddler for the core file. */ |
| |
| #define core_bfd (current_program_space->cbfd.get ()) |
| |
| /* Whether to open exec and core files read-only or read-write. */ |
| |
| extern int write_files; |
| |
| /* Open and set up the core file bfd. */ |
| |
| extern void core_target_open (const char *arg, int from_tty); |
| |
| extern void core_file_command (const char *filename, int from_tty); |
| |
| extern void exec_file_attach (const char *filename, int from_tty); |
| |
| /* If the filename of the main executable is unknown, attempt to |
| determine it. If a filename is determined, proceed as though |
| it was just specified with the "file" command. Do nothing if |
| the filename of the main executable is already known. |
| DEFER_BP_RESET uses SYMFILE_DEFER_BP_RESET for the main symbol file. */ |
| |
| extern void exec_file_locate_attach (int pid, int defer_bp_reset, int from_tty); |
| |
| extern void validate_files (void); |
| |
| /* The current default bfd target. */ |
| |
| extern char *gnutarget; |
| |
| extern void set_gnutarget (const char *); |
| |
| /* Structure to keep track of core register reading functions for |
| various core file types. */ |
| |
| struct core_fns |
| { |
| |
| /* BFD flavour that a core file handler is prepared to read. This |
| can be used by the handler's core tasting function as a first |
| level filter to reject BFD's that don't have the right |
| flavour. */ |
| |
| enum bfd_flavour core_flavour; |
| |
| /* Core file handler function to call to recognize corefile |
| formats that BFD rejects. Some core file format just don't fit |
| into the BFD model, or may require other resources to identify |
| them, that simply aren't available to BFD (such as symbols from |
| another file). Returns nonzero if the handler recognizes the |
| format, zero otherwise. */ |
| |
| int (*check_format) (bfd *); |
| |
| /* Core file handler function to call to ask if it can handle a |
| given core file format or not. Returns zero if it can't, |
| nonzero otherwise. */ |
| |
| int (*core_sniffer) (struct core_fns *, bfd *); |
| |
| /* Extract the register values out of the core file and supply them |
| into REGCACHE. |
| |
| CORE_REG_SECT points to the register values themselves, read into |
| memory. |
| |
| CORE_REG_SIZE is the size of that area. |
| |
| WHICH says which set of registers we are handling: |
| 0 --- integer registers |
| 2 --- floating-point registers, on machines where they are |
| discontiguous |
| 3 --- extended floating-point registers, on machines where |
| these are present in yet a third area. (GNU/Linux uses |
| this to get at the SSE registers.) |
| |
| REG_ADDR is the offset from u.u_ar0 to the register values relative to |
| core_reg_sect. This is used with old-fashioned core files to locate the |
| registers in a large upage-plus-stack ".reg" section. Original upage |
| address X is at location core_reg_sect+x+reg_addr. */ |
| |
| void (*core_read_registers) (struct regcache *regcache, |
| char *core_reg_sect, |
| unsigned core_reg_size, |
| int which, CORE_ADDR reg_addr); |
| |
| /* Finds the next struct core_fns. They are allocated and |
| initialized in whatever module implements the functions pointed |
| to; an initializer calls deprecated_add_core_fns to add them to |
| the global chain. */ |
| |
| struct core_fns *next; |
| |
| }; |
| |
| /* Build either a single-thread or multi-threaded section name for |
| PTID. |
| |
| If ptid's lwp member is zero, we want to do the single-threaded |
| thing: look for a section named NAME (as passed to the |
| constructor). If ptid's lwp member is non-zero, we'll want do the |
| multi-threaded thing: look for a section named "NAME/LWP", where |
| LWP is the shortest ASCII decimal representation of ptid's lwp |
| member. */ |
| |
| class thread_section_name |
| { |
| public: |
| /* NAME is the single-threaded section name. If PTID represents an |
| LWP, then the build section name is "NAME/LWP", otherwise it's |
| just "NAME" unmodified. */ |
| thread_section_name (const char *name, ptid_t ptid) |
| { |
| if (ptid.lwp_p ()) |
| { |
| m_storage = string_printf ("%s/%ld", name, ptid.lwp ()); |
| m_section_name = m_storage.c_str (); |
| } |
| else |
| m_section_name = name; |
| } |
| |
| /* Return the computed section name. The result is valid as long as |
| this thread_section_name object is live. */ |
| const char *c_str () const |
| { return m_section_name; } |
| |
| DISABLE_COPY_AND_ASSIGN (thread_section_name); |
| |
| private: |
| /* Either a pointer into M_STORAGE, or a pointer to the name passed |
| as parameter to the constructor. */ |
| const char *m_section_name; |
| /* If we need to build a new section name, this is where we store |
| it. */ |
| std::string m_storage; |
| }; |
| |
| /* NOTE: cagney/2004-04-05: Replaced by "regset.h" and |
| regset_from_core_section(). */ |
| extern void deprecated_add_core_fns (struct core_fns *cf); |
| extern int default_core_sniffer (struct core_fns *cf, bfd * abfd); |
| extern int default_check_format (bfd * abfd); |
| |
| #endif /* !defined (GDBCORE_H) */ |