X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=gdb%2Fgdbcore.h;h=7b18e5e93f8f32900176876cbd81c4a0c4637a58;hb=387e00f3b3e6ea3719f144d7090c1a242174be4d;hp=b083d56e8dcd1de583a3bef449b3acff714ca1f3;hpb=ed288bb597072176e84fc8279707a3f2f475779b;p=binutils-gdb.git diff --git a/gdb/gdbcore.h b/gdb/gdbcore.h index b083d56e8dc..7b18e5e93f8 100644 --- a/gdb/gdbcore.h +++ b/gdb/gdbcore.h @@ -1,11 +1,12 @@ /* Machine independent variables that describe the core file under GDB. - Copyright 1986, 1987, 1989, 1990, 1992, 1995 Free Software Foundation, Inc. + + Copyright (C) 1986-2022 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 2 of the License, or + 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, @@ -14,158 +15,194 @@ 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, write to the Free Software - Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. */ + along with this program. If not, see . */ /* Interface routines for core, executable, etc. */ #if !defined (GDBCORE_H) #define GDBCORE_H 1 -#include "bfd.h" - -/* Return the name of the executable file as a string. - ERR nonzero means get error if there is none specified; - otherwise return 0 in that case. */ +struct type; +struct regcache; -extern char *get_exec_file PARAMS ((int err)); +#include "bfd.h" +#include "exec.h" +#include "target.h" /* Nonzero if there is a core file. */ -extern int have_core_file_p PARAMS ((void)); +extern int have_core_file_p (void); -/* Read "memory data" from whatever target or inferior we have. - Returns zero if successful, errno value if not. EIO is used for - address out of bounds. If breakpoints are inserted, returns shadow - contents, not the breakpoints themselves. From breakpoint.c. */ +/* Report a memory error with error(). */ -extern int read_memory_nobpt PARAMS ((CORE_ADDR memaddr, char *myaddr, - unsigned len)); +extern void memory_error (enum target_xfer_status status, CORE_ADDR memaddr); -/* Report a memory error with error(). */ +/* The string 'memory_error' would use as exception message. */ -extern void memory_error PARAMS ((int status, CORE_ADDR memaddr)); +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 PARAMS ((CORE_ADDR memaddr, char *myaddr, int len)); +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_memory_section PARAMS ((CORE_ADDR memaddr, char *myaddr, - int len, asection * bfd_section)); +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 PARAMS ((CORE_ADDR memaddr, int len)); +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 PARAMS ((CORE_ADDR memaddr, int len)); +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 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 PARAMS ((CORE_ADDR, char *, int)); +/* Read an integer from debugged code memory, given address, + number of bytes, and byte order for code. */ -/* This takes a char *, not void *. This is probably right, because - passing in an int * or whatever is wrong with respect to - byteswapping, alignment, different sizes for host vs. target types, - etc. */ +extern LONGEST read_code_integer (CORE_ADDR memaddr, int len, + enum bfd_endian byte_order); -extern void write_memory PARAMS ((CORE_ADDR memaddr, char *myaddr, int len)); +/* Read an unsigned integer from debugged code memory, given address, + number of bytes, and byte order for code. */ -extern void generic_search PARAMS ((int len, char *data, char *mask, - CORE_ADDR startaddr, int increment, - CORE_ADDR lorange, CORE_ADDR hirange, - CORE_ADDR * addr_found, char *data_found)); - -/* Hook for `exec_file_command' command to call. */ +extern ULONGEST read_code_unsigned_integer (CORE_ADDR memaddr, + int len, + enum bfd_endian byte_order); -extern void (*exec_file_display_hook) PARAMS ((char *filename)); +/* Read the pointer of type TYPE at ADDR, and return the address it + represents. */ -/* Hook for "file_command", which is more useful than above - (because it is invoked AFTER symbols are read, not before) */ +CORE_ADDR read_memory_typed_address (CORE_ADDR addr, struct type *type); -extern void (*file_changed_hook) PARAMS ((char *filename)); +/* Same as target_write_memory, but report an error if can't + write. */ -extern void specify_exec_file_hook PARAMS ((void (*hook) (char *filename))); +extern void write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, + ssize_t len); -/* Binary File Diddlers for the exec and core files */ +/* Same as write_memory, but notify 'memory_changed' observers. */ -extern bfd *core_bfd; -extern bfd *exec_bfd; +extern void write_memory_with_notification (CORE_ADDR memaddr, + const bfd_byte *myaddr, + ssize_t len); -/* Whether to open exec and core files read-only or read-write. */ +/* 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); -extern int write_files; - -extern void core_file_command PARAMS ((char *filename, int from_tty)); - -extern void exec_file_attach PARAMS ((char *filename, int from_tty)); - -extern void exec_file_command PARAMS ((char *filename, int from_tty)); - -extern void validate_files PARAMS ((void)); +/* 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 CORE_ADDR register_addr PARAMS ((int regno, CORE_ADDR blockend)); +extern void (*deprecated_exec_file_display_hook) (const char *filename); -extern void registers_fetched PARAMS ((void)); +/* Hook for "file_command", which is more useful than above + (because it is invoked AFTER symbols are read, not before). */ -#if !defined (KERNEL_U_ADDR) -extern CORE_ADDR kernel_u_addr; -#define KERNEL_U_ADDR kernel_u_addr -#endif +extern void (*deprecated_file_changed_hook) (const char *filename); -/* The target vector for core files. */ +extern void specify_exec_file_hook (void (*hook) (const char *filename)); -extern struct target_ops core_ops; +/* Binary File Diddler for the core file. */ -/* The current default bfd target. */ +#define core_bfd (current_program_space->cbfd.get ()) -extern char *gnutarget; +/* Whether to open exec and core files read-only or read-write. */ -extern void set_gnutarget PARAMS ((char *)); +extern bool write_files; -/* Structure to keep track of core register reading functions for - various core file types. */ +/* Open and set up the core file bfd. */ -struct core_fns - { +extern void core_target_open (const char *arg, int from_tty); - /* BFD flavour that we handle. Note that bfd_target_unknown_flavour matches - anything, and if there is no better match, this function will be called - as the default. */ +extern void core_file_command (const char *filename, int from_tty); - enum bfd_flavour core_flavour; +extern void exec_file_attach (const char *filename, int from_tty); - /* Extract the register values out of the core file and store them where - `read_register' will find them. +/* 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. */ - CORE_REG_SECT points to the register values themselves, read into - memory. +extern void exec_file_locate_attach (int pid, int defer_bp_reset, int from_tty); - CORE_REG_SIZE is the size of that area. +extern void validate_files (void); - WHICH says which set of registers we are handling (0 = int, 2 = float on - machines where they are discontiguous). +/* Give the user a message if the current exec file does not match the exec + file determined from the target. In case of mismatch, ask the user + if the exec file determined from target must be loaded. */ +extern void validate_exec_file (int from_tty); - 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. */ +/* The current default bfd target. */ - void (*core_read_registers) PARAMS ((char *core_reg_sect, unsigned core_reg_size, - int which, CORE_ADDR reg_addr)); +extern const char *gnutarget; - /* Finds the next struct core_fns. They are allocated and initialized - in whatever module implements the functions pointed to; an - initializer calls add_core_fns to add them to the global chain. */ +extern void set_gnutarget (const char *); - 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. */ -extern void add_core_fns PARAMS ((struct core_fns * cf)); +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; +}; #endif /* !defined (GDBCORE_H) */