X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gdb%2Fgdbcore.h;h=3f8179144b685a5bbdd566eefb19fd58ac4ff85a;hb=2117c711ae07700adb57ea5b5ca61e4c32d7e3d2;hp=6501e3098b969fa37cbb1bb63546c1473f7382da;hpb=5b64ad42d36e6d487e1f7287d37fbc243a178e72;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/gdbcore.h b/gdb/gdbcore.h index 6501e3098b..3f8179144b 100644 --- a/gdb/gdbcore.h +++ b/gdb/gdbcore.h @@ -1,169 +1,232 @@ /* Machine independent variables that describe the core file under GDB. - Copyright 1986, 1987, 1989, 1990, 1992, 1995 Free Software Foundation, Inc. -This file is part of GDB. + Copyright (C) 1986-2014 Free Software Foundation, Inc. -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 -(at your option) any later version. + This file is part of GDB. -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. + 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 this program; if not, write to the Free Software -Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, 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. */ #if !defined (GDBCORE_H) #define GDBCORE_H 1 +struct type; +struct regcache; + #include "bfd.h" +#include "exec.h" +#include "target.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. */ -extern char *get_exec_file PARAMS ((int err)); +extern char *get_exec_file (int err); /* 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. Space + for the result is malloc'd, caller must free. */ -extern void memory_error PARAMS ((int status, CORE_ADDR memaddr)); +extern char *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_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_memory_section PARAMS ((CORE_ADDR memaddr, char *myaddr, - int len, asection *bfd_section)); +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); + +/* 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. */ -/* 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)); +CORE_ADDR read_memory_typed_address (CORE_ADDR addr, struct type *type); /* 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 void write_memory PARAMS ((CORE_ADDR memaddr, char *myaddr, int len)); +extern void write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, + ssize_t len); -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)); +/* 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) PARAMS ((char *filename)); +extern void (*deprecated_exec_file_display_hook) (char *filename); /* Hook for "file_command", which is more useful than above - (because it is invoked AFTER symbols are read, not before) */ + (because it is invoked AFTER symbols are read, not before). */ -extern void (*file_changed_hook) PARAMS ((char *filename)); +extern void (*deprecated_file_changed_hook) (char *filename); -extern void specify_exec_file_hook PARAMS ((void (*hook) (char *filename))); +extern void specify_exec_file_hook (void (*hook) (char *filename)); -/* Binary File Diddlers for the exec and core files */ +/* Binary File Diddler for the core file. */ extern bfd *core_bfd; -extern bfd *exec_bfd; + +extern struct target_ops *core_target; /* Whether to open exec and core files read-only or read-write. */ 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)); +extern void core_file_command (char *filename, int from_tty); -extern CORE_ADDR register_addr PARAMS ((int regno, CORE_ADDR blockend)); +extern void exec_file_attach (char *filename, int from_tty); -extern void registers_fetched PARAMS ((void)); +extern void exec_file_clear (int from_tty); -#if !defined (KERNEL_U_ADDR) -extern CORE_ADDR kernel_u_addr; -#define KERNEL_U_ADDR kernel_u_addr -#endif - -/* The target vector for core files. */ - -extern struct target_ops core_ops; +extern void validate_files (void); /* The current default bfd target. */ extern char *gnutarget; -extern void set_gnutarget PARAMS ((char *)); +extern void set_gnutarget (char *); /* Structure to keep track of core register reading functions for various core file types. */ -struct core_fns { +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 *); - /* 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. */ + /* 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. */ - enum bfd_flavour core_flavour; + int (*core_sniffer) (struct core_fns *, bfd *); - /* Extract the register values out of the core file and store them where - `read_register' will find them. + /* 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_SECT points to the register values themselves, read into + memory. - CORE_REG_SIZE is the size of that area. + CORE_REG_SIZE is the size of that area. - WHICH says which set of registers we are handling (0 = int, 2 = float on - machines where they are discontiguous). + 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. */ + 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) PARAMS ((char *core_reg_sect, unsigned core_reg_size, - int which, CORE_ADDR 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 add_core_fns to add them to the global chain. */ + /* 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; + struct core_fns *next; -}; + }; -extern void add_core_fns PARAMS ((struct core_fns *cf)); +/* 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) */ +#endif /* !defined (GDBCORE_H) */