/* Machine independent variables that describe the core file under GDB.
|
/* Machine independent variables that describe the core file under GDB.
|
|
|
Copyright (C) 1986, 1987, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
|
Copyright (C) 1986, 1987, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
|
1997, 1998, 1999, 2000, 2001, 2004, 2007, 2008, 2009, 2010
|
1997, 1998, 1999, 2000, 2001, 2004, 2007, 2008, 2009, 2010
|
Free Software Foundation, Inc.
|
Free Software Foundation, Inc.
|
|
|
This file is part of GDB.
|
This file is part of GDB.
|
|
|
This program is free software; you can redistribute it and/or modify
|
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
|
it under the terms of the GNU General Public License as published by
|
the Free Software Foundation; either version 3 of the License, or
|
the Free Software Foundation; either version 3 of the License, or
|
(at your option) any later version.
|
(at your option) any later version.
|
|
|
This program is distributed in the hope that it will be useful,
|
This program is distributed in the hope that it will be useful,
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
GNU General Public License for more details.
|
GNU General Public License for more details.
|
|
|
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU General Public License
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
|
/* Interface routines for core, executable, etc. */
|
/* Interface routines for core, executable, etc. */
|
|
|
#if !defined (GDBCORE_H)
|
#if !defined (GDBCORE_H)
|
#define GDBCORE_H 1
|
#define GDBCORE_H 1
|
|
|
struct type;
|
struct type;
|
struct regcache;
|
struct regcache;
|
|
|
#include "bfd.h"
|
#include "bfd.h"
|
#include "exec.h"
|
#include "exec.h"
|
|
|
/* Return the name of the executable file as a string.
|
/* Return the name of the executable file as a string.
|
ERR nonzero means get error if there is none specified;
|
ERR nonzero means get error if there is none specified;
|
otherwise return 0 in that case. */
|
otherwise return 0 in that case. */
|
|
|
extern char *get_exec_file (int err);
|
extern char *get_exec_file (int err);
|
|
|
/* Nonzero if there is a core file. */
|
/* Nonzero if there is a core file. */
|
|
|
extern int have_core_file_p (void);
|
extern int have_core_file_p (void);
|
|
|
/* Report a memory error with error(). */
|
/* Report a memory error with error(). */
|
|
|
extern void memory_error (int status, CORE_ADDR memaddr);
|
extern void memory_error (int status, CORE_ADDR memaddr);
|
|
|
/* Like target_read_memory, but report an error if can't read. */
|
/* Like target_read_memory, but report an error if can't read. */
|
|
|
extern void read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, int len);
|
extern void read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, int len);
|
|
|
/* Like target_read_stack, but report an error if can't read. */
|
/* Like target_read_stack, but report an error if can't read. */
|
|
|
extern void read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, int len);
|
extern void read_stack (CORE_ADDR memaddr, gdb_byte *myaddr, int len);
|
|
|
/* Read an integer from debugged memory, given address and number of
|
/* Read an integer from debugged memory, given address and number of
|
bytes. */
|
bytes. */
|
|
|
extern LONGEST read_memory_integer (CORE_ADDR memaddr,
|
extern LONGEST read_memory_integer (CORE_ADDR memaddr,
|
int len, enum bfd_endian byte_order);
|
int len, enum bfd_endian byte_order);
|
extern int safe_read_memory_integer (CORE_ADDR memaddr, int len,
|
extern int safe_read_memory_integer (CORE_ADDR memaddr, int len,
|
enum bfd_endian byte_order, LONGEST *return_value);
|
enum bfd_endian byte_order, LONGEST *return_value);
|
|
|
/* Read an unsigned integer from debugged memory, given address and
|
/* Read an unsigned integer from debugged memory, given address and
|
number of bytes. */
|
number of bytes. */
|
|
|
extern ULONGEST read_memory_unsigned_integer (CORE_ADDR memaddr,
|
extern ULONGEST read_memory_unsigned_integer (CORE_ADDR memaddr,
|
int len, enum bfd_endian byte_order);
|
int len, enum bfd_endian byte_order);
|
|
|
/* Read a null-terminated string from the debuggee's memory, given address,
|
/* 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 */
|
* a buffer into which to place the string, and the maximum available space */
|
|
|
extern void read_memory_string (CORE_ADDR, char *, int);
|
extern void read_memory_string (CORE_ADDR, char *, int);
|
|
|
/* Read the pointer of type TYPE at ADDR, and return the address it
|
/* Read the pointer of type TYPE at ADDR, and return the address it
|
represents. */
|
represents. */
|
|
|
CORE_ADDR read_memory_typed_address (CORE_ADDR addr, struct type *type);
|
CORE_ADDR read_memory_typed_address (CORE_ADDR addr, struct type *type);
|
|
|
/* This takes a char *, not void *. This is probably right, because
|
/* This takes a char *, not void *. This is probably right, because
|
passing in an int * or whatever is wrong with respect to
|
passing in an int * or whatever is wrong with respect to
|
byteswapping, alignment, different sizes for host vs. target types,
|
byteswapping, alignment, different sizes for host vs. target types,
|
etc. */
|
etc. */
|
|
|
extern void write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, int len);
|
extern void write_memory (CORE_ADDR memaddr, const gdb_byte *myaddr, int len);
|
|
|
/* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */
|
/* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */
|
extern void write_memory_unsigned_integer (CORE_ADDR addr, int len,
|
extern void write_memory_unsigned_integer (CORE_ADDR addr, int len,
|
enum bfd_endian byte_order,
|
enum bfd_endian byte_order,
|
ULONGEST value);
|
ULONGEST value);
|
|
|
/* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */
|
/* Store VALUE at ADDR in the inferior as a LEN-byte unsigned integer. */
|
extern void write_memory_signed_integer (CORE_ADDR addr, int len,
|
extern void write_memory_signed_integer (CORE_ADDR addr, int len,
|
enum bfd_endian byte_order,
|
enum bfd_endian byte_order,
|
LONGEST value);
|
LONGEST value);
|
|
|
/* Hook for `exec_file_command' command to call. */
|
/* Hook for `exec_file_command' command to call. */
|
|
|
extern void (*deprecated_exec_file_display_hook) (char *filename);
|
extern void (*deprecated_exec_file_display_hook) (char *filename);
|
|
|
/* Hook for "file_command", which is more useful than above
|
/* 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 (*deprecated_file_changed_hook) (char *filename);
|
extern void (*deprecated_file_changed_hook) (char *filename);
|
|
|
extern void specify_exec_file_hook (void (*hook) (char *filename));
|
extern void specify_exec_file_hook (void (*hook) (char *filename));
|
|
|
/* Binary File Diddler for the core file. */
|
/* Binary File Diddler for the core file. */
|
|
|
extern bfd *core_bfd;
|
extern bfd *core_bfd;
|
|
|
/* Whether to open exec and core files read-only or read-write. */
|
/* Whether to open exec and core files read-only or read-write. */
|
|
|
extern int write_files;
|
extern int write_files;
|
|
|
extern void core_file_command (char *filename, int from_tty);
|
extern void core_file_command (char *filename, int from_tty);
|
|
|
extern void exec_file_attach (char *filename, int from_tty);
|
extern void exec_file_attach (char *filename, int from_tty);
|
|
|
extern void exec_file_clear (int from_tty);
|
extern void exec_file_clear (int from_tty);
|
|
|
extern void validate_files (void);
|
extern void validate_files (void);
|
|
|
/* The current default bfd target. */
|
/* The current default bfd target. */
|
|
|
extern char *gnutarget;
|
extern char *gnutarget;
|
|
|
extern void set_gnutarget (char *);
|
extern void set_gnutarget (char *);
|
|
|
/* Structure to keep track of core register reading functions for
|
/* Structure to keep track of core register reading functions for
|
various core file types. */
|
various core file types. */
|
|
|
struct core_fns
|
struct core_fns
|
{
|
{
|
|
|
/* BFD flavour that a core file handler is prepared to read. This
|
/* 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
|
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
|
level filter to reject BFD's that don't have the right
|
flavour. */
|
flavour. */
|
|
|
enum bfd_flavour core_flavour;
|
enum bfd_flavour core_flavour;
|
|
|
/* Core file handler function to call to recognize corefile
|
/* Core file handler function to call to recognize corefile
|
formats that BFD rejects. Some core file format just don't fit
|
formats that BFD rejects. Some core file format just don't fit
|
into the BFD model, or may require other resources to identify
|
into the BFD model, or may require other resources to identify
|
them, that simply aren't available to BFD (such as symbols from
|
them, that simply aren't available to BFD (such as symbols from
|
another file). Returns nonzero if the handler recognizes the
|
another file). Returns nonzero if the handler recognizes the
|
format, zero otherwise. */
|
format, zero otherwise. */
|
|
|
int (*check_format) (bfd *);
|
int (*check_format) (bfd *);
|
|
|
/* Core file handler function to call to ask if it can handle a
|
/* 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,
|
given core file format or not. Returns zero if it can't,
|
nonzero otherwise. */
|
nonzero otherwise. */
|
|
|
int (*core_sniffer) (struct core_fns *, bfd *);
|
int (*core_sniffer) (struct core_fns *, bfd *);
|
|
|
/* Extract the register values out of the core file and supply them
|
/* Extract the register values out of the core file and supply them
|
into REGCACHE.
|
into REGCACHE.
|
|
|
CORE_REG_SECT points to the register values themselves, read into
|
CORE_REG_SECT points to the register values themselves, read into
|
memory.
|
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:
|
WHICH says which set of registers we are handling:
|
0 --- integer registers
|
0 --- integer registers
|
2 --- floating-point registers, on machines where they are
|
2 --- floating-point registers, on machines where they are
|
discontiguous
|
discontiguous
|
3 --- extended floating-point registers, on machines where
|
3 --- extended floating-point registers, on machines where
|
these are present in yet a third area. (GNU/Linux uses
|
these are present in yet a third area. (GNU/Linux uses
|
this to get at the SSE registers.)
|
this to get at the SSE registers.)
|
|
|
REG_ADDR is the offset from u.u_ar0 to the register values relative to
|
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
|
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
|
registers in a large upage-plus-stack ".reg" section. Original upage
|
address X is at location core_reg_sect+x+reg_addr. */
|
address X is at location core_reg_sect+x+reg_addr. */
|
|
|
void (*core_read_registers) (struct regcache *regcache,
|
void (*core_read_registers) (struct regcache *regcache,
|
char *core_reg_sect,
|
char *core_reg_sect,
|
unsigned core_reg_size,
|
unsigned core_reg_size,
|
int which, CORE_ADDR reg_addr);
|
int which, CORE_ADDR reg_addr);
|
|
|
/* Finds the next struct core_fns. They are allocated and
|
/* Finds the next struct core_fns. They are allocated and
|
initialized in whatever module implements the functions pointed
|
initialized in whatever module implements the functions pointed
|
to; an initializer calls deprecated_add_core_fns to add them to
|
to; an initializer calls deprecated_add_core_fns to add them to
|
the global chain. */
|
the global chain. */
|
|
|
struct core_fns *next;
|
struct core_fns *next;
|
|
|
};
|
};
|
|
|
/* NOTE: cagney/2004-04-05: Replaced by "regset.h" and
|
/* NOTE: cagney/2004-04-05: Replaced by "regset.h" and
|
regset_from_core_section(). */
|
regset_from_core_section(). */
|
extern void deprecated_add_core_fns (struct core_fns *cf);
|
extern void deprecated_add_core_fns (struct core_fns *cf);
|
extern int default_core_sniffer (struct core_fns *cf, bfd * abfd);
|
extern int default_core_sniffer (struct core_fns *cf, bfd * abfd);
|
extern int default_check_format (bfd * abfd);
|
extern int default_check_format (bfd * abfd);
|
|
|
struct target_section *deprecated_core_resize_section_table (int num_added);
|
struct target_section *deprecated_core_resize_section_table (int num_added);
|
|
|
#endif /* !defined (GDBCORE_H) */
|
#endif /* !defined (GDBCORE_H) */
|
|
|
