1 /* Work with core dump and executable files, for GDB.
2 Copyright (C) 1986, 1987, 1989 Free Software Foundation, Inc.
4 This file is part of GDB.
6 GDB 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 1, or (at your option)
11 GDB 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.
16 You should have received a copy of the GNU General Public License
17 along with GDB; see the file COPYING. If not, write to
18 the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. */
25 #include "frame.h" /* required by inferior.h */
33 extern int xfer_memory ();
34 extern void child_attach (), child_create_inferior ();
37 extern char *sys_errlist
[];
38 extern char *sys_siglist
[];
40 extern char registers
[];
42 /* Hook for `exec_file_command' command to call. */
44 void (*exec_file_display_hook
) () = NULL
;
46 struct section_table
*core_sections
, *core_sections_end
;
48 /* Binary file diddling handle for the core file. */
53 extern struct target_ops core_ops
;
56 /* Discard all vestiges of any previous core file
57 and mark data and stack spaces as empty. */
64 free (bfd_get_filename (core_bfd
));
73 /* This routine opens and sets up the core file bfd */
76 core_open (filename
, from_tty
)
82 struct cleanup
*old_chain
;
87 target_preopen (from_tty
);
91 "No core file specified. (Use `detach' to stop debugging a core file.)"
92 : "No core file specified.");
95 filename
= tilde_expand (filename
);
96 if (filename
[0] != '/') {
97 temp
= concat (current_directory
, "/", filename
);
102 old_chain
= make_cleanup (free
, filename
);
103 temp_bfd
= bfd_openr (filename
, NULL
);
104 if (temp_bfd
== NULL
)
106 perror_with_name (filename
);
109 if (!bfd_check_format (temp_bfd
, bfd_core
))
111 bfd_close (temp_bfd
);
112 error ("\"%s\" does not appear to be a core dump", filename
);
115 /* Looks semi-reasonable. Toss the old core file and work on the new. */
117 discard_cleanups (old_chain
); /* Don't free filename any more */
118 unpush_target (&core_ops
);
120 old_chain
= make_cleanup (core_close
, core_bfd
);
124 /* Find the data section */
125 if (build_section_table (core_bfd
, &core_sections
, &core_sections_end
))
126 error ("Can't find sections in `%s': %s", bfd_get_filename(core_bfd
),
127 bfd_errmsg (bfd_error
));
129 ontop
= !push_target (&core_ops
);
131 p
= bfd_core_file_failing_command (core_bfd
);
133 printf ("Core file invoked as `%s'.\n", p
);
135 siggy
= bfd_core_file_failing_signal (core_bfd
);
137 printf ("Program terminated with signal %d, %s.\n", siggy
,
138 siggy
< NSIG
? sys_siglist
[siggy
] : "(undocumented)");
141 /* Fetch all registers from core file */
142 target_fetch_registers (-1);
143 set_current_frame ( create_new_frame (read_register (FP_REGNUM
),
145 select_frame (get_current_frame (), 0);
147 /* Shouldn't be necessary to read in symbols. */
149 SOLIB_ADD (NULL
, from_tty
);
152 print_sel_frame (0); /* Print the top frame and source line */
155 "Warning: you won't be able to access this core file until you terminate\n\
156 your %s; do ``info files''\n", current_target
->to_longname
);
159 discard_cleanups (old_chain
);
163 core_detach (args
, from_tty
)
168 error ("Too many arguments");
169 unpush_target (&core_ops
);
171 printf ("No core file now.\n");
174 /* Backward compatability with old way of specifying core files. */
177 core_file_command (filename
, from_tty
)
181 dont_repeat (); /* Either way, seems bogus. */
183 core_detach (filename
, from_tty
);
185 core_open (filename
, from_tty
);
189 /* Call this to specify the hook for exec_file_command to call back.
190 This is called from the x-window display code. */
193 specify_exec_file_hook (hook
)
196 exec_file_display_hook
= hook
;
199 /* The exec file must be closed before running an inferior.
200 If it is needed again after the inferior dies, it must
208 bfd_tempclose (exec_bfd
);
217 bfd_reopen (exec_bfd
);
221 /* If we have both a core file and an exec file,
222 print a warning if they don't go together.
223 This should really check that the core file came
224 from that exec file, but I don't know how to do it. */
229 if (exec_bfd
&& core_bfd
)
231 if (core_file_matches_executable_p (core_bfd
, exec_bfd
))
232 printf ("Warning: core file does not match specified executable file.\n");
233 else if (bfd_get_mtime(exec_bfd
) > bfd_get_mtime(core_bfd
))
234 printf ("Warning: exec file is newer than core file.\n");
238 /* Return the name of the executable file as a string.
239 ERR nonzero means get error if there is none specified;
240 otherwise return 0 in that case. */
246 if (exec_bfd
) return bfd_get_filename(exec_bfd
);
247 if (!err
) return NULL
;
249 error ("No executable file specified.\n\
250 Use the \"file\" or \"exec-file\" command.");
257 struct section_table
*p
;
259 printf ("\tCore file `%s'.\n", bfd_get_filename(core_bfd
));
261 for (p
= core_sections
; p
< core_sections_end
; p
++)
262 printf("\tcore file from 0x%08x to 0x%08x is %s\n",
264 bfd_section_name (core_bfd
, p
->sec_ptr
));
268 memory_error (status
, memaddr
)
275 /* Actually, address between memaddr and memaddr + len
276 was out of bounds. */
277 error ("Cannot access memory: address 0x%x out of bounds.", memaddr
);
281 if (status
>= sys_nerr
|| status
< 0)
282 error ("Error accessing memory address 0x%x: unknown error (%d).",
285 error ("Error accessing memory address 0x%x: %s.",
286 memaddr
, sys_errlist
[status
]);
290 /* Same as target_read_memory, but report an error if can't read. */
292 read_memory (memaddr
, myaddr
, len
)
298 status
= target_read_memory (memaddr
, myaddr
, len
);
300 memory_error (status
, memaddr
);
303 /* Same as target_write_memory, but report an error if can't write. */
305 write_memory (memaddr
, myaddr
, len
)
312 status
= target_write_memory (memaddr
, myaddr
, len
);
314 memory_error (status
, memaddr
);
317 /* Read an integer from debugged memory, given address and number of bytes. */
320 read_memory_integer (memaddr
, len
)
329 if (len
== sizeof (char))
331 read_memory (memaddr
, &cbuf
, len
);
334 if (len
== sizeof (short))
336 read_memory (memaddr
, (char *)&sbuf
, len
);
337 SWAP_TARGET_AND_HOST (&sbuf
, sizeof (short));
340 if (len
== sizeof (int))
342 read_memory (memaddr
, (char *)&ibuf
, len
);
343 SWAP_TARGET_AND_HOST (&ibuf
, sizeof (int));
346 if (len
== sizeof (lbuf
))
348 read_memory (memaddr
, (char *)&lbuf
, len
);
349 SWAP_TARGET_AND_HOST (&lbuf
, sizeof (lbuf
));
352 error ("Cannot handle integers of %d bytes.", len
);
353 return -1; /* for lint */
356 /* Read or write the core file.
358 Args are address within core file, address within gdb address-space,
359 length, and a flag indicating whether to read or write.
363 0: We cannot handle this address and length.
364 > 0: We have handled N bytes starting at this address.
365 (If N == length, we did it all.) We might be able
366 to handle more bytes beyond this length, but no
368 < 0: We cannot handle this address, but if somebody
369 else handles (-N) bytes, we can start from there.
371 The actual work is done by xfer_memory in exec.c, which we share
372 in common with exec_xfer_memory(). */
375 core_xfer_memory (memaddr
, myaddr
, len
, write
)
382 res
= xfer_memory (memaddr
, myaddr
, len
, write
,
383 core_bfd
, core_sections
, core_sections_end
);
384 #ifdef SOLIB_XFER_MEMORY
386 res
= SOLIB_XFER_MEMORY (memaddr
, myaddr
, len
, write
);
391 /* Get the registers out of a core file. This is the machine-
392 independent part. Fetch_core_registers is the machine-dependent
393 part, typically implemented in the xm-file for each architecture. */
396 get_core_registers (regno
)
403 reg_sec
= bfd_get_section_by_name (core_bfd
, ".reg");
404 size
= bfd_section_size (core_bfd
, reg_sec
);
405 the_regs
= alloca (size
);
406 if (bfd_get_section_contents (core_bfd
, reg_sec
, the_regs
,
409 fetch_core_registers (the_regs
, size
, 0);
413 fprintf (stderr
, "Couldn't fetch registers from core file: %s\n",
414 bfd_errmsg (bfd_error
));
417 /* Now do it again for the float registers, if they exist. */
418 reg_sec
= bfd_get_section_by_name (core_bfd
, ".reg2");
420 size
= bfd_section_size (core_bfd
, reg_sec
);
421 the_regs
= alloca (size
);
422 if (bfd_get_section_contents (core_bfd
, reg_sec
, the_regs
,
425 fetch_core_registers (the_regs
, size
, 2);
429 fprintf (stderr
, "Couldn't fetch register set 2 from core file: %s\n",
430 bfd_errmsg (bfd_error
));
434 return 0; /* FIXME, what result goes here? */
437 struct target_ops core_ops
= {
438 "core", "Local core dump file",
439 "Use a core file as a target. Specify the filename of the core file.",
440 core_open
, core_close
,
441 child_attach
, core_detach
, 0, 0, /* resume, wait */
443 0, 0, 0, 0, /* store_regs, prepare_to_store, conv_to, conv_from */
444 core_xfer_memory
, core_files_info
,
445 0, 0, /* core_insert_breakpoint, core_remove_breakpoint, */
446 0, 0, 0, 0, 0, /* terminal stuff */
447 0, 0, 0, 0, 0, /* kill, load, add_syms, call fn, lookup sym */
448 child_create_inferior
, 0, /* mourn_inferior */
449 core_stratum
, 0, /* next */
450 0, 1, 1, 1, 0, /* all mem, mem, stack, regs, exec */
451 OPS_MAGIC
, /* Always the last thing */
458 add_com ("core-file", class_files
, core_file_command
,
459 "Use FILE as core dump for examining memory and registers.\n\
460 No arg means have no core file. This command has been superseded by the\n\
461 `target core' and `detach' commands.");
462 add_target (&core_ops
);