1 /* Core dump and executable file functions below target vector, for GDB.
2 Copyright 1986, 87, 89, 91, 92, 93, 94, 95, 96, 97, 1998, 2000
3 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
23 #include "gdb_string.h"
27 #include "frame.h" /* required by inferior.h */
34 #include "gdbthread.h"
36 /* List of all available core_fns. On gdb startup, each core file register
37 reader calls add_core_fns() to register information on each core format it
38 is prepared to read. */
40 static struct core_fns *core_file_fns = NULL;
42 /* The core_fns for a core file handler that is prepared to read the core
43 file currently open on core_bfd. */
45 static struct core_fns *core_vec = NULL;
47 static void core_files_info (struct target_ops *);
50 static int solib_add_stub (PTR);
53 static struct core_fns *sniff_core_bfd (bfd *);
55 static boolean gdb_check_format (bfd *);
57 static void core_open (char *, int);
59 static void core_detach (char *, int);
61 static void core_close (int);
63 static void core_close_cleanup (void *ignore);
65 static void get_core_registers (int);
67 static void add_to_thread_list (bfd *, asection *, PTR);
69 static int ignore (CORE_ADDR, char *);
71 static char *core_file_to_sym_file (char *);
73 static int core_file_thread_alive (int tid);
75 static void init_core_ops (void);
77 void _initialize_corelow (void);
79 struct target_ops core_ops;
81 /* Link a new core_fns into the global core_file_fns list. Called on gdb
82 startup by the _initialize routine in each core file register reader, to
83 register information about each format the the reader is prepared to
90 cf->next = core_file_fns;
94 /* The default function that core file handlers can use to examine a
95 core file BFD and decide whether or not to accept the job of
96 reading the core file. */
99 default_core_sniffer (our_fns, abfd)
100 struct core_fns *our_fns;
105 result = (bfd_get_flavour (abfd) == our_fns -> core_flavour);
109 /* Walk through the list of core functions to find a set that can
110 handle the core file open on ABFD. Default to the first one in the
111 list of nothing matches. Returns pointer to set that is
114 static struct core_fns *
115 sniff_core_bfd (abfd)
119 struct core_fns *yummy = NULL;
122 for (cf = core_file_fns; cf != NULL; cf = cf->next)
124 if (cf->core_sniffer (cf, abfd))
132 warning ("\"%s\": ambiguous core format, %d handlers match",
133 bfd_get_filename (abfd), matches);
135 else if (matches == 0)
137 warning ("\"%s\": no core file handler recognizes format, using default",
138 bfd_get_filename (abfd));
142 yummy = core_file_fns;
147 /* The default is to reject every core file format we see. Either
148 BFD has to recognize it, or we have to provide a function in the
149 core file handler that recognizes it. */
152 default_check_format (abfd)
158 /* Attempt to recognize core file formats that BFD rejects. */
161 gdb_check_format (abfd)
166 for (cf = core_file_fns; cf != NULL; cf = cf->next)
168 if (cf->check_format (abfd))
176 /* Discard all vestiges of any previous core file and mark data and stack
181 core_close (quitting)
188 inferior_pid = 0; /* Avoid confusion from thread stuff */
190 /* Clear out solib state while the bfd is still open. See
191 comments in clear_solib in solib.c. */
196 name = bfd_get_filename (core_bfd);
197 if (!bfd_close (core_bfd))
198 warning ("cannot close \"%s\": %s",
199 name, bfd_errmsg (bfd_get_error ()));
202 if (core_ops.to_sections)
204 free ((PTR) core_ops.to_sections);
205 core_ops.to_sections = NULL;
206 core_ops.to_sections_end = NULL;
213 core_close_cleanup (void *ignore)
215 core_close (0/*ignored*/);
219 /* Stub function for catch_errors around shared library hacking. FROM_TTYP
220 is really an int * which points to from_tty. */
223 solib_add_stub (from_ttyp)
226 SOLIB_ADD (NULL, *(int *) from_ttyp, ¤t_target);
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 (abfd, asect, reg_sect_arg)
242 asection *reg_sect = (asection *) reg_sect_arg;
244 if (strncmp (bfd_section_name (abfd, asect), ".reg/", 5) != 0)
247 thread_id = atoi (bfd_section_name (abfd, asect) + 5);
249 add_thread (thread_id);
251 /* Warning, Will Robinson, looking at BFD private data! */
254 && asect->filepos == reg_sect->filepos) /* Did we find .reg? */
255 inferior_pid = thread_id; /* Yes, make it current */
258 /* This routine opens and sets up the core file bfd. */
261 core_open (filename, from_tty)
267 struct cleanup *old_chain;
273 target_preopen (from_tty);
277 "No core file specified. (Use `detach' to stop debugging a core file.)"
278 : "No core file specified.");
281 filename = tilde_expand (filename);
282 if (filename[0] != '/')
284 temp = concat (current_directory, "/", filename, NULL);
289 old_chain = make_cleanup (free, filename);
291 scratch_chan = open (filename, write_files ? O_RDWR : O_RDONLY, 0);
292 if (scratch_chan < 0)
293 perror_with_name (filename);
295 temp_bfd = bfd_fdopenr (filename, gnutarget, scratch_chan);
296 if (temp_bfd == NULL)
297 perror_with_name (filename);
299 if (!bfd_check_format (temp_bfd, bfd_core) &&
300 !gdb_check_format (temp_bfd))
302 /* Do it after the err msg */
303 /* FIXME: should be checking for errors from bfd_close (for one thing,
304 on error it does not free all the storage associated with the
306 make_cleanup_bfd_close (temp_bfd);
307 error ("\"%s\" is not a core dump: %s",
308 filename, bfd_errmsg (bfd_get_error ()));
311 /* Looks semi-reasonable. Toss the old core file and work on the new. */
313 discard_cleanups (old_chain); /* Don't free filename any more */
314 unpush_target (&core_ops);
316 old_chain = make_cleanup (core_close_cleanup, 0 /*ignore*/);
318 /* Find a suitable core file handler to munch on core_bfd */
319 core_vec = sniff_core_bfd (core_bfd);
323 /* Find the data section */
324 if (build_section_table (core_bfd, &core_ops.to_sections,
325 &core_ops.to_sections_end))
326 error ("\"%s\": Can't find sections: %s",
327 bfd_get_filename (core_bfd), bfd_errmsg (bfd_get_error ()));
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. Unfortunatly 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 (), 0);
367 print_stack_frame (selected_frame, selected_frame_level, 1);
372 "you won't be able to access this core file until you terminate\n\
373 your %s; do ``info files''", target_longname);
378 core_detach (args, from_tty)
383 error ("Too many arguments");
384 unpush_target (&core_ops);
385 reinit_frame_cache ();
387 printf_filtered ("No core file now.\n");
391 /* Try to retrieve registers from a section in core_bfd, and supply
392 them to core_vec->core_read_registers, as the register set numbered
395 If inferior_pid is zero, do the single-threaded thing: look for a
396 section named NAME. If inferior_pid is non-zero, do the
397 multi-threaded thing: look for a section named "NAME/PID", where
398 PID is the shortest ASCII decimal representation of inferior_pid.
400 HUMAN_NAME is a human-readable name for the kind of registers the
401 NAME section contains, for use in error messages.
403 If REQUIRED is non-zero, print an error if the core file doesn't
404 have a section by the appropriate name. Otherwise, just do nothing. */
407 get_core_register_section (char *name,
412 char section_name[100];
418 sprintf (section_name, "%s/%d", name, inferior_pid);
420 strcpy (section_name, name);
422 section = bfd_get_section_by_name (core_bfd, section_name);
426 warning ("Couldn't find %s registers in core file.\n", human_name);
430 size = bfd_section_size (core_bfd, section);
431 contents = alloca (size);
432 if (! bfd_get_section_contents (core_bfd, section, contents,
435 warning ("Couldn't read %s registers from `%s' section in core file.\n",
440 core_vec->core_read_registers (contents, size, which,
442 bfd_section_vma (core_bfd, section)));
446 /* Get the registers out of a core file. This is the machine-
447 independent part. Fetch_core_registers is the machine-dependent
448 part, typically implemented in the xm-file for each architecture. */
450 /* We just get all the registers, so we don't use regno. */
454 get_core_registers (regno)
460 || core_vec->core_read_registers == NULL)
462 fprintf_filtered (gdb_stderr,
463 "Can't fetch registers from this type of core file\n");
467 get_core_register_section (".reg", 0, "general-purpose", 1);
468 get_core_register_section (".reg2", 2, "floating-point", 0);
469 get_core_register_section (".reg-xfp", 3, "extended floating-point", 0);
471 registers_fetched ();
475 core_file_to_sym_file (core)
478 CONST char *failing_command;
485 error ("No core file specified.");
487 core = tilde_expand (core);
490 temp = concat (current_directory, "/", core, NULL);
494 scratch_chan = open (core, write_files ? O_RDWR : O_RDONLY, 0);
495 if (scratch_chan < 0)
496 perror_with_name (core);
498 temp_bfd = bfd_fdopenr (core, gnutarget, scratch_chan);
499 if (temp_bfd == NULL)
500 perror_with_name (core);
502 if (!bfd_check_format (temp_bfd, bfd_core))
504 /* Do it after the err msg */
505 /* FIXME: should be checking for errors from bfd_close (for one thing,
506 on error it does not free all the storage associated with the
508 make_cleanup_bfd_close (temp_bfd);
509 error ("\"%s\" is not a core dump: %s",
510 core, bfd_errmsg (bfd_get_error ()));
513 /* Find the data section */
514 if (build_section_table (temp_bfd, &core_ops.to_sections,
515 &core_ops.to_sections_end))
516 error ("\"%s\": Can't find sections: %s",
517 bfd_get_filename (temp_bfd), bfd_errmsg (bfd_get_error ()));
519 failing_command = bfd_core_file_failing_command (temp_bfd);
521 bfd_close (temp_bfd);
523 /* If we found a filename, remember that it is probably saved
524 relative to the executable that created it. If working directory
525 isn't there now, we may not be able to find the executable. Rather
526 than trying to be sauve about finding it, just check if the file
527 exists where we are now. If not, then punt and tell our client
528 we couldn't find the sym file.
530 p = (char *) failing_command;
531 if ((p != NULL) && (access (p, F_OK) != 0))
539 struct target_ops *t;
541 print_section_info (t, core_bfd);
544 /* If mourn is being called in all the right places, this could be say
545 `gdb internal error' (since generic_mourn calls breakpoint_init_inferior). */
548 ignore (addr, contents)
556 /* Okay, let's be honest: threads gleaned from a core file aren't
557 exactly lively, are they? On the other hand, if we don't claim
558 that each & every one is alive, then we don't get any of them
559 to appear in an "info thread" command, which is quite a useful
563 core_file_thread_alive (tid)
569 /* Fill in core_ops with its defined operations and properties. */
574 core_ops.to_shortname = "core";
575 core_ops.to_longname = "Local core dump file";
577 "Use a core file as a target. Specify the filename of the core file.";
578 core_ops.to_open = core_open;
579 core_ops.to_close = core_close;
580 core_ops.to_attach = find_default_attach;
581 core_ops.to_require_attach = find_default_require_attach;
582 core_ops.to_detach = core_detach;
583 core_ops.to_require_detach = find_default_require_detach;
584 core_ops.to_fetch_registers = get_core_registers;
585 core_ops.to_xfer_memory = xfer_memory;
586 core_ops.to_files_info = core_files_info;
587 core_ops.to_insert_breakpoint = ignore;
588 core_ops.to_remove_breakpoint = ignore;
589 core_ops.to_create_inferior = find_default_create_inferior;
590 core_ops.to_clone_and_follow_inferior = find_default_clone_and_follow_inferior;
591 core_ops.to_thread_alive = core_file_thread_alive;
592 core_ops.to_core_file_to_sym_file = core_file_to_sym_file;
593 core_ops.to_stratum = core_stratum;
594 core_ops.to_has_memory = 1;
595 core_ops.to_has_stack = 1;
596 core_ops.to_has_registers = 1;
597 core_ops.to_magic = OPS_MAGIC;
600 /* non-zero if we should not do the add_target call in
601 _initialize_corelow; not initialized (i.e., bss) so that
602 the target can initialize it (i.e., data) if appropriate.
603 This needs to be set at compile time because we don't know
604 for sure whether the target's initialize routine is called
605 before us or after us. */
606 int coreops_suppress_target;
609 _initialize_corelow ()
613 if (!coreops_suppress_target)
614 add_target (&core_ops);