X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gdb%2Fgdbcore.h;h=6f9b4d88ecdb858567d778543ff0e5ef49fb23af;hb=34dafe9f39e61de970c36ed636daa58e1caa386c;hp=991ce64ebdb44e9bb8ac78dff09738bcab3f035b;hpb=bd5635a1e2b38ee8432fcdaa6456079191375277;p=external%2Fbinutils.git diff --git a/gdb/gdbcore.h b/gdb/gdbcore.h index 991ce64..6f9b4d8 100644 --- a/gdb/gdbcore.h +++ b/gdb/gdbcore.h @@ -1,82 +1,278 @@ /* Machine independent variables that describe the core file under GDB. - Copyright (C) 1986, 1987, 1989, 1990 Free Software Foundation, Inc. -This file is part of GDB. + Copyright (C) 1986-2019 Free Software Foundation, Inc. -GDB 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 1, or (at your option) -any later version. + This file is part of GDB. -GDB 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. + 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. -You should have received a copy of the GNU General Public License -along with GDB; see the file COPYING. If not, write to -the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */ + 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 . */ /* Interface routines for core, executable, etc. */ -#include "bfd.h" /* Binary File Description */ +#if !defined (GDBCORE_H) +#define GDBCORE_H 1 + +struct type; +struct regcache; -/* 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. */ -char *get_exec_file (); +#include "bfd.h" +#include "exec.h" +#include "target.h" /* Nonzero if there is a core file. */ -int have_core_file_p (); -/* 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. */ -int read_memory_nobpt (); +extern int have_core_file_p (void); /* Report a memory error with error(). */ -void memory_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. */ -void read_memory (); -/* Read an integer from debugged memory, given address and number of bytes. */ -long read_memory_integer (); +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 (*exec_file_display_hook) (); - -/* Binary File Diddlers for the exec and core files */ -extern bfd *core_bfd; -extern bfd *exec_bfd; - -void core_file_command (); -void exec_file_command (); -void validate_files (); -unsigned int register_addr (); -int xfer_core_file (); -void fetch_core_registers (); -void registers_fetched (); - -#if !defined (KERNEL_U_ADDR) -extern CORE_ADDR kernel_u_addr; -#define KERNEL_U_ADDR kernel_u_addr -#endif - -/* Struct section_table maps address ranges to file sections. It is - mostly used with BFD files, but can be used without (e.g. for handling - raw disks, or files not in formats handled by BFD). */ - -struct section_table { - CORE_ADDR addr; /* Lowest address in section */ - CORE_ADDR endaddr; /* 1+highest address in section */ - sec_ptr sec_ptr; /* BFD section pointer */ +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; }; -/* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR. - Returns 0 if OK, 1 on error. */ +/* 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); -int build_section_table (); +#endif /* !defined (GDBCORE_H) */