/* Machine independent variables that describe the core file under GDB.
- Copyright (C) 1986, 1987, 1989 Free Software Foundation, Inc.
-GDB is distributed in the hope that it will be useful, but WITHOUT ANY
-WARRANTY. No author or distributor accepts responsibility to anyone
-for the consequences of using it or for whether it serves any
-particular purpose or works at all, unless he says so in writing.
-Refer to the GDB General Public License for full details.
+ Copyright (C) 1986, 1987, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
+ 1997, 1998, 1999, 2000, 2001, 2004, 2007, 2008, 2009
+ Free Software Foundation, Inc.
-Everyone is granted permission to copy, modify and redistribute GDB,
-but only under the conditions described in the GDB General Public
-License. A copy of this license is supposed to have been given to you
-along with GDB so you can know your rights and responsibilities. It
-should be in a file named COPYING. Among other things, the copyright
-notice and this notice must be preserved on all copies.
+ This file is part of GDB.
-In other words, go ahead and share GDB, but don't try to stop
-anyone else from sharing it farther. Help stamp out software hoarding!
-*/
+ 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.
-/* File names of core file and executable file. */
+ 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.
-extern char *corefile;
-extern char *execfile;
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>. */
-/* Descriptors on which core file and executable file are open.
- Note that the execchan is closed when an inferior is created
- and reopened if the inferior dies or is killed. */
+/* Interface routines for core, executable, etc. */
-extern int corechan;
-extern int execchan;
+#if !defined (GDBCORE_H)
+#define GDBCORE_H 1
-/* Last modification time of executable file.
- Also used in source.c to compare against mtime of a source file. */
+struct type;
+struct regcache;
-extern int exec_mtime;
+#include "bfd.h"
-/* Virtual addresses of bounds of the two areas of memory in the core file. */
+/* 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 CORE_ADDR data_start;
-extern CORE_ADDR data_end;
-extern CORE_ADDR stack_start;
-extern CORE_ADDR stack_end;
+extern char *get_exec_file (int err);
-/* Virtual addresses of bounds of two areas of memory in the exec file.
- Note that the data area in the exec file is used only when there is no core file. */
+/* Nonzero if there is a core file. */
-extern CORE_ADDR text_start;
-extern CORE_ADDR text_end;
+extern int have_core_file_p (void);
-extern CORE_ADDR exec_data_start;
-extern CORE_ADDR exec_data_end;
+/* Report a memory error with error(). */
-/* Address in executable file of start of text area data. */
+extern void memory_error (int status, CORE_ADDR memaddr);
-extern int text_offset;
+/* Like target_read_memory, but report an error if can't read. */
-/* Address in executable file of start of data area data. */
+extern void read_memory (CORE_ADDR memaddr, gdb_byte *myaddr, int len);
-extern int exec_data_offset;
+/* Read an integer from debugged memory, given address and number of
+ bytes. */
-/* Address in core file of start of data area data. */
+extern LONGEST read_memory_integer (CORE_ADDR memaddr, int len);
+extern int safe_read_memory_integer (CORE_ADDR memaddr, int len, LONGEST *return_value);
-extern int data_offset;
+/* Read an unsigned integer from debugged memory, given address and
+ number of bytes. */
-/* Address in core file of start of stack area data. */
+extern ULONGEST read_memory_unsigned_integer (CORE_ADDR memaddr, int len);
-extern int stack_offset;
+/* 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);
+
+/* 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 (CORE_ADDR memaddr, const gdb_byte *myaddr, int 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,
+ 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,
+ LONGEST value);
+\f
+/* Hook for `exec_file_command' command to call. */
+
+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). */
+
+extern void (*deprecated_file_changed_hook) (char *filename);
+
+extern void specify_exec_file_hook (void (*hook) (char *filename));
+
+/* Binary File Diddlers for the exec and core files. */
+
+extern bfd *core_bfd;
+extern bfd *exec_bfd;
+
+/* The mtime when we last opened exec_bfd. */
+extern long exec_bfd_mtime;
+
+/* Whether to open exec and core files read-only or read-write. */
+
+extern int write_files;
+
+extern void core_file_command (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 validate_files (void);
+
+/* The current default bfd target. */
+
+extern char *gnutarget;
+
+extern void set_gnutarget (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;
+
+ };
+
+/* 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) */