1 /* Core dump and executable file functions below target vector, for GDB.
2 Copyright 1986, 1987, 1989, 1991, 1992, 1993, 1994, 1995, 1996, 1997,
4 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
24 #include "gdb_string.h"
28 #ifdef HAVE_SYS_FILE_H
29 #include <sys/file.h> /* needed for F_OK and friends */
31 #include "frame.h" /* required by inferior.h */
38 #include "gdbthread.h"
46 /* List of all available core_fns. On gdb startup, each core file register
47 reader calls add_core_fns() to register information on each core format it
48 is prepared to read. */
50 static struct core_fns *core_file_fns = NULL;
52 /* The core_fns for a core file handler that is prepared to read the core
53 file currently open on core_bfd. */
55 static struct core_fns *core_vec = NULL;
57 static void core_files_info (struct target_ops *);
60 static int solib_add_stub (PTR);
63 static struct core_fns *sniff_core_bfd (bfd *);
65 static boolean gdb_check_format (bfd *);
67 static void core_open (char *, int);
69 static void core_detach (char *, int);
71 static void core_close (int);
73 static void core_close_cleanup (void *ignore);
75 static void get_core_registers (int);
77 static void add_to_thread_list (bfd *, asection *, PTR);
79 static int ignore (CORE_ADDR, char *);
81 static int core_file_thread_alive (ptid_t tid);
83 static void init_core_ops (void);
85 void _initialize_corelow (void);
87 struct target_ops core_ops;
89 /* Link a new core_fns into the global core_file_fns list. Called on gdb
90 startup by the _initialize routine in each core file register reader, to
91 register information about each format the the reader is prepared to
95 add_core_fns (struct core_fns *cf)
97 cf->next = core_file_fns;
101 /* The default function that core file handlers can use to examine a
102 core file BFD and decide whether or not to accept the job of
103 reading the core file. */
106 default_core_sniffer (struct core_fns *our_fns, bfd *abfd)
110 result = (bfd_get_flavour (abfd) == our_fns -> core_flavour);
114 /* Walk through the list of core functions to find a set that can
115 handle the core file open on ABFD. Default to the first one in the
116 list if nothing matches. Returns pointer to set that is
119 static struct core_fns *
120 sniff_core_bfd (bfd *abfd)
123 struct core_fns *yummy = NULL;
126 for (cf = core_file_fns; cf != NULL; cf = cf->next)
128 if (cf->core_sniffer (cf, abfd))
136 warning ("\"%s\": ambiguous core format, %d handlers match",
137 bfd_get_filename (abfd), matches);
139 else if (matches == 0)
141 warning ("\"%s\": no core file handler recognizes format, using default",
142 bfd_get_filename (abfd));
146 yummy = core_file_fns;
151 /* The default is to reject every core file format we see. Either
152 BFD has to recognize it, or we have to provide a function in the
153 core file handler that recognizes it. */
156 default_check_format (bfd *abfd)
161 /* Attempt to recognize core file formats that BFD rejects. */
164 gdb_check_format (bfd *abfd)
168 for (cf = core_file_fns; cf != NULL; cf = cf->next)
170 if (cf->check_format (abfd))
178 /* Discard all vestiges of any previous core file and mark data and stack
183 core_close (int quitting)
189 inferior_ptid = null_ptid; /* Avoid confusion from thread stuff */
191 /* Clear out solib state while the bfd is still open. See
192 comments in clear_solib in solib.c. */
197 name = bfd_get_filename (core_bfd);
198 if (!bfd_close (core_bfd))
199 warning ("cannot close \"%s\": %s",
200 name, bfd_errmsg (bfd_get_error ()));
203 if (core_ops.to_sections)
205 xfree (core_ops.to_sections);
206 core_ops.to_sections = NULL;
207 core_ops.to_sections_end = NULL;
214 core_close_cleanup (void *ignore)
216 core_close (0/*ignored*/);
220 /* Stub function for catch_errors around shared library hacking. FROM_TTYP
221 is really an int * which points to from_tty. */
224 solib_add_stub (PTR from_ttyp)
226 SOLIB_ADD (NULL, *(int *) from_ttyp, ¤t_target, auto_solib_add);
227 re_enable_breakpoints_in_shlibs ();
230 #endif /* SOLIB_ADD */
232 /* Look for sections whose names start with `.reg/' so that we can extract the
233 list of threads in a core file. */
236 add_to_thread_list (bfd *abfd, asection *asect, PTR reg_sect_arg)
239 asection *reg_sect = (asection *) reg_sect_arg;
241 if (strncmp (bfd_section_name (abfd, asect), ".reg/", 5) != 0)
244 thread_id = atoi (bfd_section_name (abfd, asect) + 5);
246 add_thread (pid_to_ptid (thread_id));
248 /* Warning, Will Robinson, looking at BFD private data! */
251 && asect->filepos == reg_sect->filepos) /* Did we find .reg? */
252 inferior_ptid = pid_to_ptid (thread_id); /* Yes, make it current */
255 /* This routine opens and sets up the core file bfd. */
258 core_open (char *filename, int from_tty)
262 struct cleanup *old_chain;
268 target_preopen (from_tty);
272 "No core file specified. (Use `detach' to stop debugging a core file.)"
273 : "No core file specified.");
276 filename = tilde_expand (filename);
277 if (filename[0] != '/')
279 temp = concat (current_directory, "/", filename, NULL);
284 old_chain = make_cleanup (xfree, filename);
286 scratch_chan = open (filename, O_BINARY | ( write_files ? O_RDWR : O_RDONLY ), 0);
287 if (scratch_chan < 0)
288 perror_with_name (filename);
290 temp_bfd = bfd_fdopenr (filename, gnutarget, scratch_chan);
291 if (temp_bfd == NULL)
292 perror_with_name (filename);
294 if (!bfd_check_format (temp_bfd, bfd_core) &&
295 !gdb_check_format (temp_bfd))
297 /* Do it after the err msg */
298 /* FIXME: should be checking for errors from bfd_close (for one thing,
299 on error it does not free all the storage associated with the
301 make_cleanup_bfd_close (temp_bfd);
302 error ("\"%s\" is not a core dump: %s",
303 filename, bfd_errmsg (bfd_get_error ()));
306 /* Looks semi-reasonable. Toss the old core file and work on the new. */
308 discard_cleanups (old_chain); /* Don't free filename any more */
309 unpush_target (&core_ops);
311 old_chain = make_cleanup (core_close_cleanup, 0 /*ignore*/);
313 /* Find a suitable core file handler to munch on core_bfd */
314 core_vec = sniff_core_bfd (core_bfd);
318 /* Find the data section */
319 if (build_section_table (core_bfd, &core_ops.to_sections,
320 &core_ops.to_sections_end))
321 error ("\"%s\": Can't find sections: %s",
322 bfd_get_filename (core_bfd), bfd_errmsg (bfd_get_error ()));
324 /* If we have no exec file, try to set the architecture from the
325 core file. We don't do this unconditionally since an exec file
326 typically contains more information that helps us determine the
327 architecture than a core file. */
329 set_gdbarch_from_file (core_bfd);
331 ontop = !push_target (&core_ops);
332 discard_cleanups (old_chain);
334 p = bfd_core_file_failing_command (core_bfd);
336 printf_filtered ("Core was generated by `%s'.\n", p);
338 siggy = bfd_core_file_failing_signal (core_bfd);
340 /* NOTE: target_signal_from_host() converts a target signal value
341 into gdb's internal signal value. Unfortunately gdb's internal
342 value is called ``target_signal'' and this function got the
343 name ..._from_host(). */
344 printf_filtered ("Program terminated with signal %d, %s.\n", siggy,
345 target_signal_to_string (target_signal_from_host (siggy)));
347 /* Build up thread list from BFD sections. */
350 bfd_map_over_sections (core_bfd, add_to_thread_list,
351 bfd_get_section_by_name (core_bfd, ".reg"));
355 /* Fetch all registers from core file. */
356 target_fetch_registers (-1);
358 /* Add symbols and section mappings for any shared libraries. */
360 catch_errors (solib_add_stub, &from_tty, (char *) 0,
364 /* Now, set up the frame cache, and print the top of stack. */
365 flush_cached_frames ();
366 select_frame (get_current_frame ());
367 print_stack_frame (selected_frame,
368 frame_relative_level (selected_frame), 1);
373 "you won't be able to access this core file until you terminate\n\
374 your %s; do ``info files''", target_longname);
379 core_detach (char *args, int from_tty)
382 error ("Too many arguments");
383 unpush_target (&core_ops);
384 reinit_frame_cache ();
386 printf_filtered ("No core file now.\n");
390 /* Try to retrieve registers from a section in core_bfd, and supply
391 them to core_vec->core_read_registers, as the register set numbered
394 If inferior_ptid is zero, do the single-threaded thing: look for a
395 section named NAME. If inferior_ptid is non-zero, do the
396 multi-threaded thing: look for a section named "NAME/PID", where
397 PID is the shortest ASCII decimal representation of inferior_ptid.
399 HUMAN_NAME is a human-readable name for the kind of registers the
400 NAME section contains, for use in error messages.
402 If REQUIRED is non-zero, print an error if the core file doesn't
403 have a section by the appropriate name. Otherwise, just do nothing. */
406 get_core_register_section (char *name,
411 char section_name[100];
416 if (PIDGET (inferior_ptid))
417 sprintf (section_name, "%s/%d", name, PIDGET (inferior_ptid));
419 strcpy (section_name, name);
421 section = bfd_get_section_by_name (core_bfd, section_name);
425 warning ("Couldn't find %s registers in core file.\n", human_name);
429 size = bfd_section_size (core_bfd, section);
430 contents = alloca (size);
431 if (! bfd_get_section_contents (core_bfd, section, contents,
434 warning ("Couldn't read %s registers from `%s' section in core file.\n",
439 core_vec->core_read_registers (contents, size, which,
441 bfd_section_vma (core_bfd, section)));
445 /* Get the registers out of a core file. This is the machine-
446 independent part. Fetch_core_registers is the machine-dependent
447 part, typically implemented in the xm-file for each architecture. */
449 /* We just get all the registers, so we don't use regno. */
453 get_core_registers (int regno)
458 || core_vec->core_read_registers == NULL)
460 fprintf_filtered (gdb_stderr,
461 "Can't fetch registers from this type of core file\n");
465 get_core_register_section (".reg", 0, "general-purpose", 1);
466 get_core_register_section (".reg2", 2, "floating-point", 0);
467 get_core_register_section (".reg-xfp", 3, "extended floating-point", 0);
469 deprecated_registers_fetched ();
473 core_files_info (struct target_ops *t)
475 print_section_info (t, core_bfd);
478 /* If mourn is being called in all the right places, this could be say
479 `gdb internal error' (since generic_mourn calls breakpoint_init_inferior). */
482 ignore (CORE_ADDR addr, char *contents)
488 /* Okay, let's be honest: threads gleaned from a core file aren't
489 exactly lively, are they? On the other hand, if we don't claim
490 that each & every one is alive, then we don't get any of them
491 to appear in an "info thread" command, which is quite a useful
495 core_file_thread_alive (ptid_t tid)
500 /* Fill in core_ops with its defined operations and properties. */
505 core_ops.to_shortname = "core";
506 core_ops.to_longname = "Local core dump file";
508 "Use a core file as a target. Specify the filename of the core file.";
509 core_ops.to_open = core_open;
510 core_ops.to_close = core_close;
511 core_ops.to_attach = find_default_attach;
512 core_ops.to_require_attach = find_default_require_attach;
513 core_ops.to_detach = core_detach;
514 core_ops.to_require_detach = find_default_require_detach;
515 core_ops.to_fetch_registers = get_core_registers;
516 core_ops.to_xfer_memory = xfer_memory;
517 core_ops.to_files_info = core_files_info;
518 core_ops.to_insert_breakpoint = ignore;
519 core_ops.to_remove_breakpoint = ignore;
520 core_ops.to_create_inferior = find_default_create_inferior;
521 core_ops.to_thread_alive = core_file_thread_alive;
522 core_ops.to_stratum = core_stratum;
523 core_ops.to_has_memory = 1;
524 core_ops.to_has_stack = 1;
525 core_ops.to_has_registers = 1;
526 core_ops.to_magic = OPS_MAGIC;
529 /* non-zero if we should not do the add_target call in
530 _initialize_corelow; not initialized (i.e., bss) so that
531 the target can initialize it (i.e., data) if appropriate.
532 This needs to be set at compile time because we don't know
533 for sure whether the target's initialize routine is called
534 before us or after us. */
535 int coreops_suppress_target;
538 _initialize_corelow (void)
542 if (!coreops_suppress_target)
543 add_target (&core_ops);