gdb/core.c

   1 /* Core dump and executable file functions above target vector, for GDB.
   2    Copyright 1986, 1987, 1989, 1991, 1992 Free Software Foundation, Inc.
   3
   4 This file is part of GDB.
   5
   6 This program is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2 of the License, or
   9 (at your option) any later version.
  10
  11 This program is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 GNU General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with this program; if not, write to the Free Software
  18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  19
  20 #include "defs.h"
  21 #include <errno.h>
  22 #include <signal.h>
  23 #include <fcntl.h>
  24 #include "frame.h"  /* required by inferior.h */
  25 #include "inferior.h"
  26 #include "symtab.h"
  27 #include "command.h"
  28 #include "gdbcmd.h"
  29 #include "bfd.h"
  30 #include "target.h"
  31 #include "gdbcore.h"
  32 #include "dis-asm.h"
  33
  34 extern char registers[];
  35
  36 /* Hook for `exec_file_command' command to call.  */
  37
  38 void (*exec_file_display_hook) PARAMS ((char *)) = NULL;
  39
  40 /* Binary file diddling handle for the core file.  */
  41
  42 bfd *core_bfd = NULL;
  43
  44 \f
  45 /* Backward compatability with old way of specifying core files.  */
  46
  47 void
  48 core_file_command (filename, from_tty)
  49      char *filename;
  50      int from_tty;
  51 {
  52   struct target_ops *t;
  53
  54   dont_repeat ();                       /* Either way, seems bogus. */
  55
  56   t = find_core_target ();
  57   if (t != NULL)
  58     if (!filename)
  59       (t->to_detach) (filename, from_tty);
  60     else
  61       (t->to_open) (filename, from_tty);
  62   else
  63     error ("GDB can't read core files on this machine.");
  64 }
  65
  66 \f
  67 /* Call this to specify the hook for exec_file_command to call back.
  68    This is called from the x-window display code.  */
  69
  70 void
  71 specify_exec_file_hook (hook)
  72      void (*hook) PARAMS ((char *));
  73 {
  74   exec_file_display_hook = hook;
  75 }
  76
  77 /* The exec file must be closed before running an inferior.
  78    If it is needed again after the inferior dies, it must
  79    be reopened.  */
  80
  81 void
  82 close_exec_file ()
  83 {
  84 #ifdef FIXME
  85   if (exec_bfd)
  86     bfd_tempclose (exec_bfd);
  87 #endif
  88 }
  89
  90 void
  91 reopen_exec_file ()
  92 {
  93 #ifdef FIXME
  94   if (exec_bfd)
  95     bfd_reopen (exec_bfd);
  96 #endif
  97 }
  98 \f
  99 /* If we have both a core file and an exec file,
 100    print a warning if they don't go together.  */
 101
 102 void
 103 validate_files ()
 104 {
 105   if (exec_bfd && core_bfd)
 106     {
 107       if (!core_file_matches_executable_p (core_bfd, exec_bfd))
 108         warning ("core file may not match specified executable file.");
 109       else if (bfd_get_mtime(exec_bfd) > bfd_get_mtime(core_bfd))
 110         warning ("exec file is newer than core file.");
 111     }
 112 }
 113
 114 /* Return the name of the executable file as a string.
 115    ERR nonzero means get error if there is none specified;
 116    otherwise return 0 in that case.  */
 117
 118 char *
 119 get_exec_file (err)
 120      int err;
 121 {
 122   if (exec_bfd) return bfd_get_filename(exec_bfd);
 123   if (!err)     return NULL;
 124
 125   error ("No executable file specified.\n\
 126 Use the \"file\" or \"exec-file\" command.");
 127   return NULL;
 128 }
 129
 130 \f
 131 /* Report a memory error with error().  */
 132
 133 void
 134 memory_error (status, memaddr)
 135      int status;
 136      CORE_ADDR memaddr;
 137 {
 138
 139   if (status == EIO)
 140     {
 141       /* Actually, address between memaddr and memaddr + len
 142          was out of bounds. */
 143       error ("Cannot access memory at address %s.", local_hex_string(memaddr));
 144     }
 145   else
 146     {
 147       error ("Error accessing memory address %s: %s.",
 148              local_hex_string (memaddr), safe_strerror (status));
 149     }
 150 }
 151
 152 /* Same as target_read_memory, but report an error if can't read.  */
 153 void
 154 read_memory (memaddr, myaddr, len)
 155      CORE_ADDR memaddr;
 156      char *myaddr;
 157      int len;
 158 {
 159   int status;
 160   status = target_read_memory (memaddr, myaddr, len);
 161   if (status != 0)
 162     memory_error (status, memaddr);
 163 }
 164
 165 /* Like target_read_memory, but slightly different parameters.  */
 166
 167 int
 168 dis_asm_read_memory (memaddr, myaddr, len, info)
 169      bfd_vma memaddr;
 170      bfd_byte *myaddr;
 171      int len;
 172      disassemble_info *info;
 173 {
 174   return target_read_memory (memaddr, (char *) myaddr, len);
 175 }
 176
 177 /* Like memory_error with slightly different parameters.  */
 178 void
 179 dis_asm_memory_error (status, memaddr, info)
 180      int status;
 181      bfd_vma memaddr;
 182      disassemble_info *info;
 183 {
 184   memory_error (status, memaddr);
 185 }
 186
 187 /* Like print_address with slightly different parameters.  */
 188 void
 189 dis_asm_print_address (addr, info)
 190      bfd_vma addr;
 191      struct disassemble_info *info;
 192 {
 193   print_address (addr, info->stream);
 194 }
 195
 196 /* Same as target_write_memory, but report an error if can't write.  */
 197 void
 198 write_memory (memaddr, myaddr, len)
 199      CORE_ADDR memaddr;
 200      char *myaddr;
 201      int len;
 202 {
 203   int status;
 204
 205   status = target_write_memory (memaddr, myaddr, len);
 206   if (status != 0)
 207     memory_error (status, memaddr);
 208 }
 209
 210 /* Read an integer from debugged memory, given address and number of bytes.  */
 211
 212 LONGEST
 213 read_memory_integer (memaddr, len)
 214      CORE_ADDR memaddr;
 215      int len;
 216 {
 217   char buf[sizeof (LONGEST)];
 218
 219   read_memory (memaddr, buf, len);
 220   return extract_signed_integer (buf, len);
 221 }
 222
 223 unsigned LONGEST
 224 read_memory_unsigned_integer (memaddr, len)
 225      CORE_ADDR memaddr;
 226      int len;
 227 {
 228   char buf[sizeof (unsigned LONGEST)];
 229
 230   read_memory (memaddr, buf, len);
 231   return extract_unsigned_integer (buf, len);
 232 }
 233 \f
 234 void
 235 _initialize_core()
 236 {
 237   struct cmd_list_element *c;
 238   c = add_cmd ("core-file", class_files, core_file_command,
 239                "Use FILE as core dump for examining memory and registers.\n\
 240 No arg means have no core file.  This command has been superseded by the\n\
 241 `target core' and `detach' commands.", &cmdlist);
 242   c->completer = filename_completer;
 243 }