* gdbint.texinfo (POP_FRAME): Document use by return_command.
[deliverable/binutils-gdb.git] / gdb / corelow.c
index 0cff040127237723567c100b1c3b290ef8e6da30..78e50ae4430ca8391ef09a972e7d16c7287d6ca2 100644 (file)
@@ -1,30 +1,30 @@
 /* Core dump and executable file functions below target vector, for GDB.
-   Copyright 1986, 87, 89, 91, 92, 93, 94, 95, 96, 97, 1998
+   Copyright 1986, 87, 89, 91, 92, 93, 94, 95, 96, 97, 1998, 2000
    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
-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 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 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 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, write to the Free Software
-Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
+   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.  */
 
 #include "defs.h"
 #include "gdb_string.h"
 #include <errno.h>
 #include <signal.h>
 #include <fcntl.h>
-#include <unistd.h>
-#include "frame.h"  /* required by inferior.h */
+#include "frame.h"             /* required by inferior.h */
 #include "inferior.h"
 #include "symtab.h"
 #include "command.h"
@@ -33,37 +33,52 @@ Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
 #include "gdbcore.h"
 #include "gdbthread.h"
 
+#ifndef O_BINARY
+#define O_BINARY 0
+#endif
+
 /* List of all available core_fns.  On gdb startup, each core file register
    reader calls add_core_fns() to register information on each core format it
    is prepared to read. */
 
 static struct core_fns *core_file_fns = NULL;
 
-static void core_files_info PARAMS ((struct target_ops *));
+/* The core_fns for a core file handler that is prepared to read the core
+   file currently open on core_bfd. */
+
+static struct core_fns *core_vec = NULL;
+
+static void core_files_info (struct target_ops *);
 
 #ifdef SOLIB_ADD
-static int solib_add_stub PARAMS ((PTR));
+static int solib_add_stub (PTR);
 #endif
 
-static void core_open PARAMS ((char *, int));
+static struct core_fns *sniff_core_bfd (bfd *);
+
+static boolean gdb_check_format (bfd *);
+
+static void core_open (char *, int);
+
+static void core_detach (char *, int);
 
-static void core_detach PARAMS ((char *, int));
+static void core_close (int);
 
-static void core_close PARAMS ((int));
+static void core_close_cleanup (void *ignore);
 
-static void get_core_registers PARAMS ((int));
+static void get_core_registers (int);
 
-static void add_to_thread_list PARAMS ((bfd *, asection *, PTR));
+static void add_to_thread_list (bfd *, asection *, PTR);
 
-static int ignore PARAMS ((CORE_ADDR, char *));
+static int ignore (CORE_ADDR, char *);
 
-static char *core_file_to_sym_file PARAMS ((char *));
+static char *core_file_to_sym_file (char *);
 
-static int core_file_thread_alive PARAMS ((int tid));
+static int core_file_thread_alive (int tid);
 
-static void init_core_ops PARAMS ((void));
+static void init_core_ops (void);
 
-void _initialize_corelow PARAMS ((void));
+void _initialize_corelow (void);
 
 struct target_ops core_ops;
 
@@ -73,21 +88,95 @@ struct target_ops core_ops;
    handle. */
 
 void
-add_core_fns (cf)
-     struct core_fns *cf;
+add_core_fns (struct core_fns *cf)
 {
-  cf -> next = core_file_fns;
+  cf->next = core_file_fns;
   core_file_fns = cf;
 }
 
+/* The default function that core file handlers can use to examine a
+   core file BFD and decide whether or not to accept the job of
+   reading the core file. */
+
+int
+default_core_sniffer (struct core_fns *our_fns, bfd *abfd)
+{
+  int result;
+
+  result = (bfd_get_flavour (abfd) == our_fns -> core_flavour);
+  return (result);
+}
+
+/* Walk through the list of core functions to find a set that can
+   handle the core file open on ABFD.  Default to the first one in the
+   list if nothing matches.  Returns pointer to set that is
+   selected. */
+
+static struct core_fns *
+sniff_core_bfd (bfd *abfd)
+{
+  struct core_fns *cf;
+  struct core_fns *yummy = NULL;
+  int matches = 0;;
+
+  for (cf = core_file_fns; cf != NULL; cf = cf->next)
+    {
+      if (cf->core_sniffer (cf, abfd))
+       {
+         yummy = cf;
+         matches++;
+       }
+    }
+  if (matches > 1)
+    {
+      warning ("\"%s\": ambiguous core format, %d handlers match",
+              bfd_get_filename (abfd), matches);
+    }
+  else if (matches == 0)
+    {
+      warning ("\"%s\": no core file handler recognizes format, using default",
+              bfd_get_filename (abfd));
+    }
+  if (yummy == NULL)
+    {
+      yummy = core_file_fns;
+    }
+  return (yummy);
+}
+
+/* The default is to reject every core file format we see.  Either
+   BFD has to recognize it, or we have to provide a function in the
+   core file handler that recognizes it. */
+
+int
+default_check_format (bfd *abfd)
+{
+  return (0);
+}
+
+/* Attempt to recognize core file formats that BFD rejects. */
+
+static boolean 
+gdb_check_format (bfd *abfd)
+{
+  struct core_fns *cf;
+
+  for (cf = core_file_fns; cf != NULL; cf = cf->next)
+    {
+      if (cf->check_format (abfd))
+       {
+         return (true);
+       }
+    }
+  return (false);
+}
 
 /* Discard all vestiges of any previous core file and mark data and stack
    spaces as empty.  */
 
 /* ARGSUSED */
 static void
-core_close (quitting)
-     int quitting;
+core_close (int quitting)
 {
   char *name;
 
@@ -96,7 +185,7 @@ core_close (quitting)
       inferior_pid = 0;                /* Avoid confusion from thread stuff */
 
       /* Clear out solib state while the bfd is still open. See
-        comments in clear_solib in solib.c. */
+         comments in clear_solib in solib.c. */
 #ifdef CLEAR_SOLIB
       CLEAR_SOLIB ();
 #endif
@@ -105,26 +194,32 @@ core_close (quitting)
       if (!bfd_close (core_bfd))
        warning ("cannot close \"%s\": %s",
                 name, bfd_errmsg (bfd_get_error ()));
-      free (name);
+      xfree (name);
       core_bfd = NULL;
       if (core_ops.to_sections)
        {
-         free ((PTR)core_ops.to_sections);
+         xfree (core_ops.to_sections);
          core_ops.to_sections = NULL;
          core_ops.to_sections_end = NULL;
        }
     }
+  core_vec = NULL;
+}
+
+static void
+core_close_cleanup (void *ignore)
+{
+  core_close (0/*ignored*/);
 }
 
 #ifdef SOLIB_ADD
 /* Stub function for catch_errors around shared library hacking.  FROM_TTYP
    is really an int * which points to from_tty.  */
 
-static int 
-solib_add_stub (from_ttyp)
-     PTR from_ttyp;
+static int
+solib_add_stub (PTR from_ttyp)
 {
-  SOLIB_ADD (NULL, *(int *)from_ttyp, &current_target);
+  SOLIB_ADD (NULL, *(int *) from_ttyp, &current_target);
   re_enable_breakpoints_in_shlibs ();
   return 0;
 }
@@ -134,10 +229,7 @@ solib_add_stub (from_ttyp)
    list of threads in a core file.  */
 
 static void
-add_to_thread_list (abfd, asect, reg_sect_arg)
-     bfd *abfd;
-     asection *asect;
-     PTR reg_sect_arg;
+add_to_thread_list (bfd *abfd, asection *asect, PTR reg_sect_arg)
 {
   int thread_id;
   asection *reg_sect = (asection *) reg_sect_arg;
@@ -152,16 +244,14 @@ add_to_thread_list (abfd, asect, reg_sect_arg)
 /* Warning, Will Robinson, looking at BFD private data! */
 
   if (reg_sect != NULL
-      && asect->filepos == reg_sect->filepos) /* Did we find .reg? */
+      && asect->filepos == reg_sect->filepos)  /* Did we find .reg? */
     inferior_pid = thread_id;  /* Yes, make it current */
 }
 
 /* This routine opens and sets up the core file bfd.  */
 
 static void
-core_open (filename, from_tty)
-     char *filename;
-     int from_tty;
+core_open (char *filename, int from_tty)
 {
   const char *p;
   int siggy;
@@ -174,22 +264,22 @@ core_open (filename, from_tty)
   target_preopen (from_tty);
   if (!filename)
     {
-      error (core_bfd ? 
-       "No core file specified.  (Use `detach' to stop debugging a core file.)"
-     : "No core file specified.");
+      error (core_bfd ?
+            "No core file specified.  (Use `detach' to stop debugging a core file.)"
+            : "No core file specified.");
     }
 
   filename = tilde_expand (filename);
   if (filename[0] != '/')
     {
       temp = concat (current_directory, "/", filename, NULL);
-      free (filename);
+      xfree (filename);
       filename = temp;
     }
 
-  old_chain = make_cleanup (free, filename);
+  old_chain = make_cleanup (xfree, filename);
 
-  scratch_chan = open (filename, write_files ? O_RDWR : O_RDONLY, 0);
+  scratch_chan = open (filename, O_BINARY | ( write_files ? O_RDWR : O_RDONLY ), 0);
   if (scratch_chan < 0)
     perror_with_name (filename);
 
@@ -197,23 +287,27 @@ core_open (filename, from_tty)
   if (temp_bfd == NULL)
     perror_with_name (filename);
 
-  if (!bfd_check_format (temp_bfd, bfd_core))
+  if (!bfd_check_format (temp_bfd, bfd_core) &&
+      !gdb_check_format (temp_bfd))
     {
       /* Do it after the err msg */
       /* FIXME: should be checking for errors from bfd_close (for one thing,
-        on error it does not free all the storage associated with the
-        bfd).  */
-      make_cleanup ((make_cleanup_func) bfd_close, temp_bfd);
+         on error it does not free all the storage associated with the
+         bfd).  */
+      make_cleanup_bfd_close (temp_bfd);
       error ("\"%s\" is not a core dump: %s",
             filename, bfd_errmsg (bfd_get_error ()));
     }
 
   /* Looks semi-reasonable.  Toss the old core file and work on the new.  */
 
-  discard_cleanups (old_chain);                /* Don't free filename any more */
+  discard_cleanups (old_chain);        /* Don't free filename any more */
   unpush_target (&core_ops);
   core_bfd = temp_bfd;
-  old_chain = make_cleanup ((make_cleanup_func) core_close, core_bfd);
+  old_chain = make_cleanup (core_close_cleanup, 0 /*ignore*/);
+
+  /* Find a suitable core file handler to munch on core_bfd */
+  core_vec = sniff_core_bfd (core_bfd);
 
   validate_files ();
 
@@ -223,6 +317,8 @@ core_open (filename, from_tty)
     error ("\"%s\": Can't find sections: %s",
           bfd_get_filename (core_bfd), bfd_errmsg (bfd_get_error ()));
 
+  set_gdbarch_from_file (core_bfd);
+
   ontop = !push_target (&core_ops);
   discard_cleanups (old_chain);
 
@@ -232,8 +328,12 @@ core_open (filename, from_tty)
 
   siggy = bfd_core_file_failing_signal (core_bfd);
   if (siggy > 0)
+    /* NOTE: target_signal_from_host() converts a target signal value
+       into gdb's internal signal value.  Unfortunately gdb's internal
+       value is called ``target_signal'' and this function got the
+       name ..._from_host(). */
     printf_filtered ("Program terminated with signal %d, %s.\n", siggy,
-                    safe_strsignal (siggy));
+                    target_signal_to_string (target_signal_from_host (siggy)));
 
   /* Build up thread list from BFD sections. */
 
@@ -248,7 +348,7 @@ core_open (filename, from_tty)
 
       /* Add symbols and section mappings for any shared libraries.  */
 #ifdef SOLIB_ADD
-      catch_errors (solib_add_stub, &from_tty, (char *)0,
+      catch_errors (solib_add_stub, &from_tty, (char *) 0,
                    RETURN_MASK_ALL);
 #endif
 
@@ -260,15 +360,13 @@ core_open (filename, from_tty)
   else
     {
       warning (
-"you won't be able to access this core file until you terminate\n\
+               "you won't be able to access this core file until you terminate\n\
 your %s; do ``info files''", target_longname);
     }
 }
 
 static void
-core_detach (args, from_tty)
-     char *args;
-     int from_tty;
+core_detach (char *args, int from_tty)
 {
   if (args)
     error ("Too many arguments");
@@ -278,109 +376,99 @@ core_detach (args, from_tty)
     printf_filtered ("No core file now.\n");
 }
 
-/* Get the registers out of a core file.  This is the machine-
-   independent part.  Fetch_core_registers is the machine-dependent
-   part, typically implemented in the xm-file for each architecture.  */
 
-/* We just get all the registers, so we don't use regno.  */
+/* Try to retrieve registers from a section in core_bfd, and supply
+   them to core_vec->core_read_registers, as the register set numbered
+   WHICH.
 
-/* ARGSUSED */
-static void
-get_core_registers (regno)
-     int regno;
-{
-  sec_ptr reg_sec;
-  unsigned size;
-  char *the_regs;
-  char secname[30];
-  enum bfd_flavour our_flavour = bfd_get_flavour (core_bfd);
-  struct core_fns *cf = NULL;
-
-  if (core_file_fns == NULL)
-    {
-      fprintf_filtered (gdb_stderr,
-                       "Can't fetch registers from this type of core file\n");
-      return;
-    }
+   If inferior_pid is zero, do the single-threaded thing: look for a
+   section named NAME.  If inferior_pid is non-zero, do the
+   multi-threaded thing: look for a section named "NAME/PID", where
+   PID is the shortest ASCII decimal representation of inferior_pid.
 
-  /* Thread support.  If inferior_pid is non-zero, then we have found a core
-     file with threads (or multiple processes).  In that case, we need to
-     use the appropriate register section, else we just use `.reg'. */
+   HUMAN_NAME is a human-readable name for the kind of registers the
+   NAME section contains, for use in error messages.
 
-  /* XXX - same thing needs to be done for floating-point (.reg2) sections. */
+   If REQUIRED is non-zero, print an error if the core file doesn't
+   have a section by the appropriate name.  Otherwise, just do nothing.  */
+
+static void
+get_core_register_section (char *name,
+                          int which,
+                          char *human_name,
+                          int required)
+{
+  char section_name[100];
+  sec_ptr section;
+  bfd_size_type size;
+  char *contents;
 
   if (inferior_pid)
-    sprintf (secname, ".reg/%d", inferior_pid);
+    sprintf (section_name, "%s/%d", name, inferior_pid);
   else
-    strcpy (secname, ".reg");
-
-  reg_sec = bfd_get_section_by_name (core_bfd, secname);
-  if (!reg_sec)
-    goto cant;
-  size = bfd_section_size (core_bfd, reg_sec);
-  the_regs = alloca (size);
-  /* Look for the core functions that match this flavor.  Default to the
-     first one if nothing matches. */
-  for (cf = core_file_fns; cf != NULL; cf = cf -> next)
-    {
-      if (our_flavour == cf -> core_flavour)
-       {
-         break;
-       }
-    }
-  if (cf == NULL)
+    strcpy (section_name, name);
+
+  section = bfd_get_section_by_name (core_bfd, section_name);
+  if (! section)
     {
-      cf = core_file_fns;
+      if (required)
+       warning ("Couldn't find %s registers in core file.\n", human_name);
+      return;
     }
-  if (cf != NULL &&
-      bfd_get_section_contents (core_bfd, reg_sec, the_regs, (file_ptr)0, size) &&
-      cf -> core_read_registers != NULL)
+
+  size = bfd_section_size (core_bfd, section);
+  contents = alloca (size);
+  if (! bfd_get_section_contents (core_bfd, section, contents,
+                                 (file_ptr) 0, size))
     {
-      (cf -> core_read_registers (the_regs, size, 0,
-                                 (unsigned) bfd_section_vma (abfd,reg_sec)));
+      warning ("Couldn't read %s registers from `%s' section in core file.\n",
+              human_name, name);
+      return;
     }
-  else
+
+  core_vec->core_read_registers (contents, size, which, 
+                                ((CORE_ADDR)
+                                 bfd_section_vma (core_bfd, section)));
+}
+
+
+/* Get the registers out of a core file.  This is the machine-
+   independent part.  Fetch_core_registers is the machine-dependent
+   part, typically implemented in the xm-file for each architecture.  */
+
+/* We just get all the registers, so we don't use regno.  */
+
+/* ARGSUSED */
+static void
+get_core_registers (int regno)
+{
+  int status;
+
+  if (core_vec == NULL
+      || core_vec->core_read_registers == NULL)
     {
-cant:
       fprintf_filtered (gdb_stderr,
-                       "Couldn't fetch registers from core file: %s\n",
-                       bfd_errmsg (bfd_get_error ()));
+                    "Can't fetch registers from this type of core file\n");
+      return;
     }
 
-  /* Now do it again for the float registers, if they exist.  */
-  reg_sec = bfd_get_section_by_name (core_bfd, ".reg2");
-  if (reg_sec)
-    {
-      size = bfd_section_size (core_bfd, reg_sec);
-      the_regs = alloca (size);
-      if (cf != NULL &&
-         bfd_get_section_contents (core_bfd, reg_sec, the_regs, (file_ptr)0, size) &&
-         cf -> core_read_registers != NULL)
-       {
-         (cf -> core_read_registers (the_regs, size, 2,
-                                     (unsigned) bfd_section_vma (abfd,reg_sec)));
-       }
-      else
-       {
-         fprintf_filtered (gdb_stderr, 
-                           "Couldn't fetch register set 2 from core file: %s\n",
-                           bfd_errmsg (bfd_get_error ()));
-       }
-    }
+  get_core_register_section (".reg", 0, "general-purpose", 1);
+  get_core_register_section (".reg2", 2, "floating-point", 0);
+  get_core_register_section (".reg-xfp", 3, "extended floating-point", 0);
+
   registers_fetched ();
 }
 
 static char *
-core_file_to_sym_file (core)
-  char *  core;
+core_file_to_sym_file (char *core)
 {
-  CONST char *  failing_command;
-  char *  p;
-  char *  temp;
-  bfd *  temp_bfd;
-  int  scratch_chan;
+  CONST char *failing_command;
+  char *p;
+  char *temp;
+  bfd *temp_bfd;
+  int scratch_chan;
 
-  if (! core)
+  if (!core)
     error ("No core file specified.");
 
   core = tilde_expand (core);
@@ -402,9 +490,9 @@ core_file_to_sym_file (core)
     {
       /* Do it after the err msg */
       /* FIXME: should be checking for errors from bfd_close (for one thing,
-        on error it does not free all the storage associated with the
-        bfd).  */
-      make_cleanup ((make_cleanup_func) bfd_close, temp_bfd);
+         on error it does not free all the storage associated with the
+         bfd).  */
+      make_cleanup_bfd_close (temp_bfd);
       error ("\"%s\" is not a core dump: %s",
             core, bfd_errmsg (bfd_get_error ()));
     }
@@ -425,7 +513,7 @@ core_file_to_sym_file (core)
      than trying to be sauve about finding it, just check if the file
      exists where we are now.  If not, then punt and tell our client
      we couldn't find the sym file.
-     */
+   */
   p = (char *) failing_command;
   if ((p != NULL) && (access (p, F_OK) != 0))
     p = NULL;
@@ -434,8 +522,7 @@ core_file_to_sym_file (core)
 }
 
 static void
-core_files_info (t)
-  struct target_ops *t;
+core_files_info (struct target_ops *t)
 {
   print_section_info (t, core_bfd);
 }
@@ -444,9 +531,7 @@ core_files_info (t)
    `gdb internal error' (since generic_mourn calls breakpoint_init_inferior).  */
 
 static int
-ignore (addr, contents)
-     CORE_ADDR addr;
-     char *contents;
+ignore (CORE_ADDR addr, char *contents)
 {
   return 0;
 }
@@ -457,10 +542,9 @@ ignore (addr, contents)
    that each & every one is alive, then we don't get any of them
    to appear in an "info thread" command, which is quite a useful
    behaviour.
  */
+ */
 static int
-core_file_thread_alive (tid)
-  int  tid;
+core_file_thread_alive (int tid)
 {
   return 1;
 }
@@ -468,7 +552,7 @@ core_file_thread_alive (tid)
 /* Fill in core_ops with its defined operations and properties.  */
 
 static void
-init_core_ops ()
+init_core_ops (void)
 {
   core_ops.to_shortname = "core";
   core_ops.to_longname = "Local core dump file";
@@ -493,7 +577,7 @@ init_core_ops ()
   core_ops.to_has_memory = 1;
   core_ops.to_has_stack = 1;
   core_ops.to_has_registers = 1;
-  core_ops.to_magic = OPS_MAGIC;       
+  core_ops.to_magic = OPS_MAGIC;
 }
 
 /* non-zero if we should not do the add_target call in
@@ -505,7 +589,7 @@ init_core_ops ()
 int coreops_suppress_target;
 
 void
-_initialize_corelow ()
+_initialize_corelow (void)
 {
   init_core_ops ();
 
This page took 0.030778 seconds and 4 git commands to generate.