1 /* Work with executable files, for GDB.
2 Copyright 1988, 1989, 1991, 1992, 1993, 1994, 1997, 1998
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. */
32 #include <sys/types.h>
36 #include "gdb_string.h"
46 #include "xcoffsolib.h"
48 struct vmap
*map_vmap (bfd
*, bfd
*);
50 void (*file_changed_hook
) (char *);
52 /* Prototypes for local functions */
54 static void add_to_section_table (bfd
*, sec_ptr
, PTR
);
56 static void exec_close (int);
58 static void file_command (char *, int);
60 static void set_section_command (char *, int);
62 static void exec_files_info (struct target_ops
*);
64 static void bfdsec_to_vmap (bfd
*, sec_ptr
, PTR
);
66 static int ignore (CORE_ADDR
, char *);
68 static void init_exec_ops (void);
70 void _initialize_exec (void);
72 extern int info_verbose
;
74 /* The target vector for executable files. */
76 struct target_ops exec_ops
;
78 /* The Binary File Descriptor handle for the executable file. */
82 /* Whether to open exec and core files read-only or read-write. */
86 /* Text start and end addresses (KLUDGE) if needed */
88 #ifndef NEED_TEXT_START_END
89 #define NEED_TEXT_START_END (0)
91 CORE_ADDR text_start
= 0;
92 CORE_ADDR text_end
= 0;
98 exec_close (int quitting
)
100 int need_symtab_cleanup
= 0;
101 struct vmap
*vp
, *nxt
;
103 for (nxt
= vmap
; nxt
!= NULL
;)
108 /* if there is an objfile associated with this bfd,
109 free_objfile() will do proper cleanup of objfile *and* bfd. */
113 free_objfile (vp
->objfile
);
114 need_symtab_cleanup
= 1;
116 else if (vp
->bfd
!= exec_bfd
)
117 /* FIXME-leak: We should be freeing vp->name too, I think. */
118 if (!bfd_close (vp
->bfd
))
119 warning ("cannot close \"%s\": %s",
120 vp
->name
, bfd_errmsg (bfd_get_error ()));
122 /* FIXME: This routine is #if 0'd in symfile.c. What should we
123 be doing here? Should we just free everything in
124 vp->objfile->symtabs? Should free_objfile do that?
125 FIXME-as-well: free_objfile already free'd vp->name, so it isn't
127 free_named_symtabs (vp
->name
);
135 char *name
= bfd_get_filename (exec_bfd
);
137 if (!bfd_close (exec_bfd
))
138 warning ("cannot close \"%s\": %s",
139 name
, bfd_errmsg (bfd_get_error ()));
144 if (exec_ops
.to_sections
)
146 free ((PTR
) exec_ops
.to_sections
);
147 exec_ops
.to_sections
= NULL
;
148 exec_ops
.to_sections_end
= NULL
;
152 /* Process the first arg in ARGS as the new exec file.
154 This function is intended to be behave essentially the same
155 as exec_file_command, except that the latter will detect when
156 a target is being debugged, and will ask the user whether it
157 should be shut down first. (If the answer is "no", then the
158 new file is ignored.)
160 This file is used by exec_file_command, to do the work of opening
161 and processing the exec file after any prompting has happened.
163 And, it is used by child_attach, when the attach command was
164 given a pid but not a exec pathname, and the attach command could
165 figure out the pathname from the pid. (In this case, we shouldn't
166 ask the user whether the current target should be shut down --
167 we're supplying the exec pathname late for good reason.) */
170 exec_file_attach (char *args
, int from_tty
)
175 /* Remove any previous exec file. */
176 unpush_target (&exec_ops
);
178 /* Now open and digest the file the user requested, if any. */
182 char *scratch_pathname
;
185 /* Scan through the args and pick up the first non option arg
188 argv
= buildargv (args
);
192 make_cleanup_freeargv (argv
);
194 for (; (*argv
!= NULL
) && (**argv
== '-'); argv
++)
198 error ("No executable file name was specified");
200 filename
= tilde_expand (*argv
);
201 make_cleanup (free
, filename
);
203 scratch_chan
= openp (getenv ("PATH"), 1, filename
,
204 write_files
? O_RDWR
| O_BINARY
: O_RDONLY
| O_BINARY
, 0,
206 #if defined(__GO32__) || defined(_WIN32) || defined(__CYGWIN__)
207 if (scratch_chan
< 0)
209 char *exename
= alloca (strlen (filename
) + 5);
210 strcat (strcpy (exename
, filename
), ".exe");
211 scratch_chan
= openp (getenv ("PATH"), 1, exename
, write_files
?
212 O_RDWR
| O_BINARY
: O_RDONLY
| O_BINARY
, 0, &scratch_pathname
);
215 if (scratch_chan
< 0)
216 perror_with_name (filename
);
217 exec_bfd
= bfd_fdopenr (scratch_pathname
, gnutarget
, scratch_chan
);
220 error ("\"%s\": could not open as an executable file: %s",
221 scratch_pathname
, bfd_errmsg (bfd_get_error ()));
223 /* At this point, scratch_pathname and exec_bfd->name both point to the
224 same malloc'd string. However exec_close() will attempt to free it
225 via the exec_bfd->name pointer, so we need to make another copy and
226 leave exec_bfd as the new owner of the original copy. */
227 scratch_pathname
= xstrdup (scratch_pathname
);
228 make_cleanup (free
, scratch_pathname
);
230 if (!bfd_check_format (exec_bfd
, bfd_object
))
232 /* Make sure to close exec_bfd, or else "run" might try to use
235 error ("\"%s\": not in executable format: %s",
236 scratch_pathname
, bfd_errmsg (bfd_get_error ()));
239 /* FIXME - This should only be run for RS6000, but the ifdef is a poor
240 way to accomplish. */
241 #ifdef IBM6000_TARGET
242 /* Setup initial vmap. */
244 map_vmap (exec_bfd
, 0);
247 /* Make sure to close exec_bfd, or else "run" might try to use
250 error ("\"%s\": can't find the file sections: %s",
251 scratch_pathname
, bfd_errmsg (bfd_get_error ()));
253 #endif /* IBM6000_TARGET */
255 if (build_section_table (exec_bfd
, &exec_ops
.to_sections
,
256 &exec_ops
.to_sections_end
))
258 /* Make sure to close exec_bfd, or else "run" might try to use
261 error ("\"%s\": can't find the file sections: %s",
262 scratch_pathname
, bfd_errmsg (bfd_get_error ()));
265 /* text_end is sometimes used for where to put call dummies. A
266 few ports use these for other purposes too. */
267 if (NEED_TEXT_START_END
)
269 struct section_table
*p
;
271 /* Set text_start to the lowest address of the start of any
272 readonly code section and set text_end to the highest
273 address of the end of any readonly code section. */
274 /* FIXME: The comment above does not match the code. The
275 code checks for sections with are either code *or*
277 text_start
= ~(CORE_ADDR
) 0;
278 text_end
= (CORE_ADDR
) 0;
279 for (p
= exec_ops
.to_sections
; p
< exec_ops
.to_sections_end
; p
++)
280 if (bfd_get_section_flags (p
->bfd
, p
->the_bfd_section
)
281 & (SEC_CODE
| SEC_READONLY
))
283 if (text_start
> p
->addr
)
284 text_start
= p
->addr
;
285 if (text_end
< p
->endaddr
)
286 text_end
= p
->endaddr
;
292 set_gdbarch_from_file (exec_bfd
);
294 push_target (&exec_ops
);
296 /* Tell display code (if any) about the changed file name. */
297 if (exec_file_display_hook
)
298 (*exec_file_display_hook
) (filename
);
301 printf_unfiltered ("No executable file now.\n");
304 /* Process the first arg in ARGS as the new exec file.
306 Note that we have to explicitly ignore additional args, since we can
307 be called from file_command(), which also calls symbol_file_command()
308 which can take multiple args. */
311 exec_file_command (char *args
, int from_tty
)
313 target_preopen (from_tty
);
314 exec_file_attach (args
, from_tty
);
317 /* Set both the exec file and the symbol file, in one command.
318 What a novelty. Why did GDB go through four major releases before this
319 command was added? */
322 file_command (char *arg
, int from_tty
)
324 /* FIXME, if we lose on reading the symbol file, we should revert
325 the exec file, but that's rough. */
326 exec_file_command (arg
, from_tty
);
327 symbol_file_command (arg
, from_tty
);
328 if (file_changed_hook
)
329 file_changed_hook (arg
);
333 /* Locate all mappable sections of a BFD file.
334 table_pp_char is a char * to get it through bfd_map_over_sections;
335 we cast it back to its proper type. */
338 add_to_section_table (bfd
*abfd
, sec_ptr asect
, PTR table_pp_char
)
340 struct section_table
**table_pp
= (struct section_table
**) table_pp_char
;
343 aflag
= bfd_get_section_flags (abfd
, asect
);
344 if (!(aflag
& SEC_ALLOC
))
346 if (0 == bfd_section_size (abfd
, asect
))
348 (*table_pp
)->bfd
= abfd
;
349 (*table_pp
)->the_bfd_section
= asect
;
350 (*table_pp
)->addr
= bfd_section_vma (abfd
, asect
);
351 (*table_pp
)->endaddr
= (*table_pp
)->addr
+ bfd_section_size (abfd
, asect
);
355 /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR.
356 Returns 0 if OK, 1 on error. */
359 build_section_table (bfd
*some_bfd
, struct section_table
**start
,
360 struct section_table
**end
)
364 count
= bfd_count_sections (some_bfd
);
366 free ((PTR
) * start
);
367 *start
= (struct section_table
*) xmalloc (count
* sizeof (**start
));
369 bfd_map_over_sections (some_bfd
, add_to_section_table
, (char *) end
);
370 if (*end
> *start
+ count
)
372 /* We could realloc the table, but it probably loses for most files. */
377 bfdsec_to_vmap (bfd
*abfd
, sec_ptr sect
, PTR arg3
)
379 struct vmap_and_bfd
*vmap_bfd
= (struct vmap_and_bfd
*) arg3
;
382 vp
= vmap_bfd
->pvmap
;
384 if ((bfd_get_section_flags (abfd
, sect
) & SEC_LOAD
) == 0)
387 if (STREQ (bfd_section_name (abfd
, sect
), ".text"))
389 vp
->tstart
= bfd_section_vma (abfd
, sect
);
390 vp
->tend
= vp
->tstart
+ bfd_section_size (abfd
, sect
);
391 vp
->tvma
= bfd_section_vma (abfd
, sect
);
392 vp
->toffs
= sect
->filepos
;
394 else if (STREQ (bfd_section_name (abfd
, sect
), ".data"))
396 vp
->dstart
= bfd_section_vma (abfd
, sect
);
397 vp
->dend
= vp
->dstart
+ bfd_section_size (abfd
, sect
);
398 vp
->dvma
= bfd_section_vma (abfd
, sect
);
400 /* Silently ignore other types of sections. (FIXME?) */
403 /* Make a vmap for ABFD which might be a member of the archive ARCH.
404 Return the new vmap. */
407 map_vmap (bfd
*abfd
, bfd
*arch
)
409 struct vmap_and_bfd vmap_bfd
;
410 struct vmap
*vp
, **vpp
;
412 vp
= (struct vmap
*) xmalloc (sizeof (*vp
));
413 memset ((char *) vp
, '\0', sizeof (*vp
));
416 vp
->name
= bfd_get_filename (arch
? arch
: abfd
);
417 vp
->member
= arch
? bfd_get_filename (abfd
) : "";
419 vmap_bfd
.pbfd
= arch
;
421 bfd_map_over_sections (abfd
, bfdsec_to_vmap
, &vmap_bfd
);
423 /* Find the end of the list and append. */
424 for (vpp
= &vmap
; *vpp
; vpp
= &(*vpp
)->nxt
)
431 /* Read or write the exec file.
433 Args are address within a BFD file, address within gdb address-space,
434 length, and a flag indicating whether to read or write.
438 0: We cannot handle this address and length.
439 > 0: We have handled N bytes starting at this address.
440 (If N == length, we did it all.) We might be able
441 to handle more bytes beyond this length, but no
443 < 0: We cannot handle this address, but if somebody
444 else handles (-N) bytes, we can start from there.
446 The same routine is used to handle both core and exec files;
447 we just tail-call it with more arguments to select between them. */
450 xfer_memory (CORE_ADDR memaddr
, char *myaddr
, int len
, int write
,
451 struct target_ops
*target
)
454 struct section_table
*p
;
455 CORE_ADDR nextsectaddr
, memend
;
456 boolean (*xfer_fn
) (bfd
*, sec_ptr
, PTR
, file_ptr
, bfd_size_type
);
462 if (overlay_debugging
)
464 section
= find_pc_overlay (memaddr
);
465 if (pc_in_unmapped_range (memaddr
, section
))
466 memaddr
= overlay_mapped_address (memaddr
, section
);
469 memend
= memaddr
+ len
;
470 xfer_fn
= write
? bfd_set_section_contents
: bfd_get_section_contents
;
471 nextsectaddr
= memend
;
473 for (p
= target
->to_sections
; p
< target
->to_sections_end
; p
++)
475 if (overlay_debugging
&& section
&& p
->the_bfd_section
&&
476 strcmp (section
->name
, p
->the_bfd_section
->name
) != 0)
477 continue; /* not the section we need */
478 if (memaddr
>= p
->addr
)
479 if (memend
<= p
->endaddr
)
481 /* Entire transfer is within this section. */
482 res
= xfer_fn (p
->bfd
, p
->the_bfd_section
, myaddr
,
483 memaddr
- p
->addr
, len
);
484 return (res
!= 0) ? len
: 0;
486 else if (memaddr
>= p
->endaddr
)
488 /* This section ends before the transfer starts. */
493 /* This section overlaps the transfer. Just do half. */
494 len
= p
->endaddr
- memaddr
;
495 res
= xfer_fn (p
->bfd
, p
->the_bfd_section
, myaddr
,
496 memaddr
- p
->addr
, len
);
497 return (res
!= 0) ? len
: 0;
500 nextsectaddr
= min (nextsectaddr
, p
->addr
);
503 if (nextsectaddr
>= memend
)
504 return 0; /* We can't help */
506 return -(nextsectaddr
- memaddr
); /* Next boundary where we can help */
511 print_section_info (struct target_ops
*t
, bfd
*abfd
)
513 struct section_table
*p
;
515 printf_filtered ("\t`%s', ", bfd_get_filename (abfd
));
517 printf_filtered ("file type %s.\n", bfd_get_target (abfd
));
518 if (abfd
== exec_bfd
)
520 printf_filtered ("\tEntry point: ");
521 print_address_numeric (bfd_get_start_address (abfd
), 1, gdb_stdout
);
522 printf_filtered ("\n");
524 for (p
= t
->to_sections
; p
< t
->to_sections_end
; p
++)
526 /* FIXME-32x64 need a print_address_numeric with field width */
527 printf_filtered ("\t%s", local_hex_string_custom ((unsigned long) p
->addr
, "08l"));
528 printf_filtered (" - %s", local_hex_string_custom ((unsigned long) p
->endaddr
, "08l"));
530 printf_filtered (" @ %s",
531 local_hex_string_custom ((unsigned long) p
->the_bfd_section
->filepos
, "08l"));
532 printf_filtered (" is %s", bfd_section_name (p
->bfd
, p
->the_bfd_section
));
535 printf_filtered (" in %s", bfd_get_filename (p
->bfd
));
537 printf_filtered ("\n");
542 exec_files_info (struct target_ops
*t
)
544 print_section_info (t
, exec_bfd
);
550 printf_unfiltered ("\tMapping info for file `%s'.\n", vmap
->name
);
551 printf_unfiltered ("\t %*s %*s %*s %*s %8.8s %s\n",
552 strlen_paddr (), "tstart",
553 strlen_paddr (), "tend",
554 strlen_paddr (), "dstart",
555 strlen_paddr (), "dend",
559 for (vp
= vmap
; vp
; vp
= vp
->nxt
)
560 printf_unfiltered ("\t0x%s 0x%s 0x%s 0x%s %s%s%s%s\n",
566 *vp
->member
? "(" : "", vp
->member
,
567 *vp
->member
? ")" : "");
572 exec_set_section_offsets sets the offsets of all the sections
573 in the exec objfile. */
576 exec_set_section_offsets (bfd_signed_vma text_off
, bfd_signed_vma data_off
,
577 bfd_signed_vma bss_off
)
579 struct section_table
*sect
;
581 for (sect
= exec_ops
.to_sections
;
582 sect
< exec_ops
.to_sections_end
;
587 flags
= bfd_get_section_flags (exec_bfd
, sect
->the_bfd_section
);
589 if (flags
& SEC_CODE
)
591 sect
->addr
+= text_off
;
592 sect
->endaddr
+= text_off
;
594 else if (flags
& (SEC_DATA
| SEC_LOAD
))
596 sect
->addr
+= data_off
;
597 sect
->endaddr
+= data_off
;
599 else if (flags
& SEC_ALLOC
)
601 sect
->addr
+= bss_off
;
602 sect
->endaddr
+= bss_off
;
608 set_section_command (char *args
, int from_tty
)
610 struct section_table
*p
;
613 unsigned long secaddr
;
618 error ("Must specify section name and its virtual address");
620 /* Parse out section name */
621 for (secname
= args
; !isspace (*args
); args
++);
622 seclen
= args
- secname
;
624 /* Parse out new virtual address */
625 secaddr
= parse_and_eval_address (args
);
627 for (p
= exec_ops
.to_sections
; p
< exec_ops
.to_sections_end
; p
++)
629 if (!strncmp (secname
, bfd_section_name (exec_bfd
, p
->the_bfd_section
), seclen
)
630 && bfd_section_name (exec_bfd
, p
->the_bfd_section
)[seclen
] == '\0')
632 offset
= secaddr
- p
->addr
;
634 p
->endaddr
+= offset
;
636 exec_files_info (&exec_ops
);
640 if (seclen
>= sizeof (secprint
))
641 seclen
= sizeof (secprint
) - 1;
642 strncpy (secprint
, secname
, seclen
);
643 secprint
[seclen
] = '\0';
644 error ("Section %s not found", secprint
);
647 /* If mourn is being called in all the right places, this could be say
648 `gdb internal error' (since generic_mourn calls
649 breakpoint_init_inferior). */
652 ignore (CORE_ADDR addr
, char *contents
)
657 /* Fill in the exec file target vector. Very few entries need to be
663 exec_ops
.to_shortname
= "exec";
664 exec_ops
.to_longname
= "Local exec file";
665 exec_ops
.to_doc
= "Use an executable file as a target.\n\
666 Specify the filename of the executable file.";
667 exec_ops
.to_open
= exec_file_command
;
668 exec_ops
.to_close
= exec_close
;
669 exec_ops
.to_attach
= find_default_attach
;
670 exec_ops
.to_require_attach
= find_default_require_attach
;
671 exec_ops
.to_require_detach
= find_default_require_detach
;
672 exec_ops
.to_xfer_memory
= xfer_memory
;
673 exec_ops
.to_files_info
= exec_files_info
;
674 exec_ops
.to_insert_breakpoint
= ignore
;
675 exec_ops
.to_remove_breakpoint
= ignore
;
676 exec_ops
.to_create_inferior
= find_default_create_inferior
;
677 exec_ops
.to_clone_and_follow_inferior
= find_default_clone_and_follow_inferior
;
678 exec_ops
.to_stratum
= file_stratum
;
679 exec_ops
.to_has_memory
= 1;
680 exec_ops
.to_magic
= OPS_MAGIC
;
684 _initialize_exec (void)
686 struct cmd_list_element
*c
;
692 c
= add_cmd ("file", class_files
, file_command
,
693 "Use FILE as program to be debugged.\n\
694 It is read for its symbols, for getting the contents of pure memory,\n\
695 and it is the program executed when you use the `run' command.\n\
696 If FILE cannot be found as specified, your execution directory path\n\
697 ($PATH) is searched for a command of that name.\n\
698 No arg means to have no executable file and no symbols.", &cmdlist
);
699 c
->completer
= filename_completer
;
702 c
= add_cmd ("exec-file", class_files
, exec_file_command
,
703 "Use FILE as program for getting contents of pure memory.\n\
704 If FILE cannot be found as specified, your execution directory path\n\
705 is searched for a command of that name.\n\
706 No arg means have no executable file.", &cmdlist
);
707 c
->completer
= filename_completer
;
709 add_com ("section", class_files
, set_section_command
,
710 "Change the base address of section SECTION of the exec file to ADDR.\n\
711 This can be used if the exec file does not contain section addresses,\n\
712 (such as in the a.out format), or when the addresses specified in the\n\
713 file itself are wrong. Each section must be changed separately. The\n\
714 ``info files'' command lists all the sections and their addresses.");
717 (add_set_cmd ("write", class_support
, var_boolean
, (char *) &write_files
,
718 "Set writing into executable and core files.",
722 add_target (&exec_ops
);