gdb/exec.c

   1 /* Work with executable files, for GDB.
   2
   3    Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
   4    1997, 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation,
   5    Inc.
   6
   7    This file is part of GDB.
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 2 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program; if not, write to the Free Software
  21    Foundation, Inc., 51 Franklin Street, Fifth Floor,
  22    Boston, MA 02110-1301, USA.  */
  23
  24 #include "defs.h"
  25 #include "frame.h"
  26 #include "inferior.h"
  27 #include "target.h"
  28 #include "gdbcmd.h"
  29 #include "language.h"
  30 #include "symfile.h"
  31 #include "objfiles.h"
  32 #include "completer.h"
  33 #include "value.h"
  34 #include "exec.h"
  35 #include "observer.h"
  36
  37 #include <fcntl.h>
  38 #include "readline/readline.h"
  39 #include "gdb_string.h"
  40
  41 #include "gdbcore.h"
  42
  43 #include <ctype.h>
  44 #include "gdb_stat.h"
  45
  46 #include "xcoffsolib.h"
  47
  48 struct vmap *map_vmap (bfd *, bfd *);
  49
  50 void (*deprecated_file_changed_hook) (char *);
  51
  52 /* Prototypes for local functions */
  53
  54 static void exec_close (int);
  55
  56 static void file_command (char *, int);
  57
  58 static void set_section_command (char *, int);
  59
  60 static void exec_files_info (struct target_ops *);
  61
  62 static int ignore (CORE_ADDR, bfd_byte *);
  63
  64 static void init_exec_ops (void);
  65
  66 void _initialize_exec (void);
  67
  68 /* The target vector for executable files.  */
  69
  70 struct target_ops exec_ops;
  71
  72 /* The Binary File Descriptor handle for the executable file.  */
  73
  74 bfd *exec_bfd = NULL;
  75
  76 /* Whether to open exec and core files read-only or read-write.  */
  77
  78 int write_files = 0;
  79 static void
  80 show_write_files (struct ui_file *file, int from_tty,
  81                   struct cmd_list_element *c, const char *value)
  82 {
  83   fprintf_filtered (file, _("Writing into executable and core files is %s.\n"),
  84                     value);
  85 }
  86
  87
  88 struct vmap *vmap;
  89
  90 void
  91 exec_open (char *args, int from_tty)
  92 {
  93   target_preopen (from_tty);
  94   exec_file_attach (args, from_tty);
  95 }
  96
  97 static void
  98 exec_close (int quitting)
  99 {
 100   int need_symtab_cleanup = 0;
 101   struct vmap *vp, *nxt;
 102
 103   for (nxt = vmap; nxt != NULL;)
 104     {
 105       vp = nxt;
 106       nxt = vp->nxt;
 107
 108       /* if there is an objfile associated with this bfd,
 109          free_objfile() will do proper cleanup of objfile *and* bfd. */
 110
 111       if (vp->objfile)
 112         {
 113           free_objfile (vp->objfile);
 114           need_symtab_cleanup = 1;
 115         }
 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 ()));
 121
 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
 126          valid here.  */
 127       free_named_symtabs (vp->name);
 128       xfree (vp);
 129     }
 130
 131   vmap = NULL;
 132
 133   if (exec_bfd)
 134     {
 135       char *name = bfd_get_filename (exec_bfd);
 136
 137       if (!bfd_close (exec_bfd))
 138         warning (_("cannot close \"%s\": %s"),
 139                  name, bfd_errmsg (bfd_get_error ()));
 140       xfree (name);
 141       exec_bfd = NULL;
 142     }
 143
 144   if (exec_ops.to_sections)
 145     {
 146       xfree (exec_ops.to_sections);
 147       exec_ops.to_sections = NULL;
 148       exec_ops.to_sections_end = NULL;
 149     }
 150 }
 151
 152 void
 153 exec_file_clear (int from_tty)
 154 {
 155   /* Remove exec file.  */
 156   unpush_target (&exec_ops);
 157
 158   if (from_tty)
 159     printf_unfiltered (_("No executable file now.\n"));
 160 }
 161
 162 /*  Process the first arg in ARGS as the new exec file.
 163
 164    This function is intended to be behave essentially the same
 165    as exec_file_command, except that the latter will detect when
 166    a target is being debugged, and will ask the user whether it
 167    should be shut down first.  (If the answer is "no", then the
 168    new file is ignored.)
 169
 170    This file is used by exec_file_command, to do the work of opening
 171    and processing the exec file after any prompting has happened.
 172
 173    And, it is used by child_attach, when the attach command was
 174    given a pid but not a exec pathname, and the attach command could
 175    figure out the pathname from the pid.  (In this case, we shouldn't
 176    ask the user whether the current target should be shut down --
 177    we're supplying the exec pathname late for good reason.)
 178
 179    ARGS is assumed to be the filename. */
 180
 181 void
 182 exec_file_attach (char *filename, int from_tty)
 183 {
 184   /* Remove any previous exec file.  */
 185   unpush_target (&exec_ops);
 186
 187   /* Now open and digest the file the user requested, if any.  */
 188
 189   if (!filename)
 190     {
 191       if (from_tty)
 192         printf_unfiltered (_("No executable file now.\n"));
 193     }
 194   else
 195     {
 196       char *scratch_pathname;
 197       int scratch_chan;
 198
 199       scratch_chan = openp (getenv ("PATH"), OPF_TRY_CWD_FIRST, filename,
 200                    write_files ? O_RDWR | O_BINARY : O_RDONLY | O_BINARY, 0,
 201                             &scratch_pathname);
 202 #if defined(__GO32__) || defined(_WIN32) || defined(__CYGWIN__)
 203       if (scratch_chan < 0)
 204         {
 205           char *exename = alloca (strlen (filename) + 5);
 206           strcat (strcpy (exename, filename), ".exe");
 207           scratch_chan = openp (getenv ("PATH"), OPF_TRY_CWD_FIRST, exename,
 208              write_files ? O_RDWR | O_BINARY : O_RDONLY | O_BINARY, 0,
 209              &scratch_pathname);
 210         }
 211 #endif
 212       if (scratch_chan < 0)
 213         perror_with_name (filename);
 214       exec_bfd = bfd_fopen (scratch_pathname, gnutarget,
 215                             write_files ? FOPEN_RUB : FOPEN_RB,
 216                             scratch_chan);
 217
 218       if (!exec_bfd)
 219         error (_("\"%s\": could not open as an executable file: %s"),
 220                scratch_pathname, bfd_errmsg (bfd_get_error ()));
 221
 222       /* At this point, scratch_pathname and exec_bfd->name both point to the
 223          same malloc'd string.  However exec_close() will attempt to free it
 224          via the exec_bfd->name pointer, so we need to make another copy and
 225          leave exec_bfd as the new owner of the original copy. */
 226       scratch_pathname = xstrdup (scratch_pathname);
 227       make_cleanup (xfree, scratch_pathname);
 228
 229       if (!bfd_check_format (exec_bfd, bfd_object))
 230         {
 231           /* Make sure to close exec_bfd, or else "run" might try to use
 232              it.  */
 233           exec_close (0);
 234           error (_("\"%s\": not in executable format: %s"),
 235                  scratch_pathname, bfd_errmsg (bfd_get_error ()));
 236         }
 237
 238       /* FIXME - This should only be run for RS6000, but the ifdef is a poor
 239          way to accomplish.  */
 240 #ifdef DEPRECATED_IBM6000_TARGET
 241       /* Setup initial vmap. */
 242
 243       map_vmap (exec_bfd, 0);
 244       if (vmap == NULL)
 245         {
 246           /* Make sure to close exec_bfd, or else "run" might try to use
 247              it.  */
 248           exec_close (0);
 249           error (_("\"%s\": can't find the file sections: %s"),
 250                  scratch_pathname, bfd_errmsg (bfd_get_error ()));
 251         }
 252 #endif /* DEPRECATED_IBM6000_TARGET */
 253
 254       if (build_section_table (exec_bfd, &exec_ops.to_sections,
 255                                &exec_ops.to_sections_end))
 256         {
 257           /* Make sure to close exec_bfd, or else "run" might try to use
 258              it.  */
 259           exec_close (0);
 260           error (_("\"%s\": can't find the file sections: %s"),
 261                  scratch_pathname, bfd_errmsg (bfd_get_error ()));
 262         }
 263
 264       validate_files ();
 265
 266       set_gdbarch_from_file (exec_bfd);
 267
 268       push_target (&exec_ops);
 269
 270       /* Tell display code (if any) about the changed file name.  */
 271       if (deprecated_exec_file_display_hook)
 272         (*deprecated_exec_file_display_hook) (filename);
 273     }
 274   bfd_cache_close_all ();
 275   observer_notify_executable_changed (NULL);
 276 }
 277
 278 /*  Process the first arg in ARGS as the new exec file.
 279
 280    Note that we have to explicitly ignore additional args, since we can
 281    be called from file_command(), which also calls symbol_file_command()
 282    which can take multiple args.
 283
 284    If ARGS is NULL, we just want to close the exec file. */
 285
 286 static void
 287 exec_file_command (char *args, int from_tty)
 288 {
 289   char **argv;
 290   char *filename;
 291
 292   target_preopen (from_tty);
 293
 294   if (args)
 295     {
 296       /* Scan through the args and pick up the first non option arg
 297          as the filename.  */
 298
 299       argv = buildargv (args);
 300       if (argv == NULL)
 301         nomem (0);
 302
 303       make_cleanup_freeargv (argv);
 304
 305       for (; (*argv != NULL) && (**argv == '-'); argv++)
 306         {;
 307         }
 308       if (*argv == NULL)
 309         error (_("No executable file name was specified"));
 310
 311       filename = tilde_expand (*argv);
 312       make_cleanup (xfree, filename);
 313       exec_file_attach (filename, from_tty);
 314     }
 315   else
 316     exec_file_attach (NULL, from_tty);
 317 }
 318
 319 /* Set both the exec file and the symbol file, in one command.
 320    What a novelty.  Why did GDB go through four major releases before this
 321    command was added?  */
 322
 323 static void
 324 file_command (char *arg, int from_tty)
 325 {
 326   /* FIXME, if we lose on reading the symbol file, we should revert
 327      the exec file, but that's rough.  */
 328   exec_file_command (arg, from_tty);
 329   symbol_file_command (arg, from_tty);
 330   if (deprecated_file_changed_hook)
 331     deprecated_file_changed_hook (arg);
 332 }
 333 \f
 334
 335 /* Locate all mappable sections of a BFD file.
 336    table_pp_char is a char * to get it through bfd_map_over_sections;
 337    we cast it back to its proper type.  */
 338
 339 static void
 340 add_to_section_table (bfd *abfd, struct bfd_section *asect,
 341                       void *table_pp_char)
 342 {
 343   struct section_table **table_pp = (struct section_table **) table_pp_char;
 344   flagword aflag;
 345
 346   aflag = bfd_get_section_flags (abfd, asect);
 347   if (!(aflag & SEC_ALLOC))
 348     return;
 349   if (0 == bfd_section_size (abfd, asect))
 350     return;
 351   (*table_pp)->bfd = abfd;
 352   (*table_pp)->the_bfd_section = asect;
 353   (*table_pp)->addr = bfd_section_vma (abfd, asect);
 354   (*table_pp)->endaddr = (*table_pp)->addr + bfd_section_size (abfd, asect);
 355   (*table_pp)++;
 356 }
 357
 358 /* Builds a section table, given args BFD, SECTABLE_PTR, SECEND_PTR.
 359    Returns 0 if OK, 1 on error.  */
 360
 361 int
 362 build_section_table (struct bfd *some_bfd, struct section_table **start,
 363                      struct section_table **end)
 364 {
 365   unsigned count;
 366
 367   count = bfd_count_sections (some_bfd);
 368   if (*start)
 369     xfree (* start);
 370   *start = (struct section_table *) xmalloc (count * sizeof (**start));
 371   *end = *start;
 372   bfd_map_over_sections (some_bfd, add_to_section_table, (char *) end);
 373   if (*end > *start + count)
 374     internal_error (__FILE__, __LINE__, _("failed internal consistency check"));
 375   /* We could realloc the table, but it probably loses for most files.  */
 376   return 0;
 377 }
 378 \f
 379 static void
 380 bfdsec_to_vmap (struct bfd *abfd, struct bfd_section *sect, void *arg3)
 381 {
 382   struct vmap_and_bfd *vmap_bfd = (struct vmap_and_bfd *) arg3;
 383   struct vmap *vp;
 384
 385   vp = vmap_bfd->pvmap;
 386
 387   if ((bfd_get_section_flags (abfd, sect) & SEC_LOAD) == 0)
 388     return;
 389
 390   if (strcmp (bfd_section_name (abfd, sect), ".text") == 0)
 391     {
 392       vp->tstart = bfd_section_vma (abfd, sect);
 393       vp->tend = vp->tstart + bfd_section_size (abfd, sect);
 394       vp->tvma = bfd_section_vma (abfd, sect);
 395       vp->toffs = sect->filepos;
 396     }
 397   else if (strcmp (bfd_section_name (abfd, sect), ".data") == 0)
 398     {
 399       vp->dstart = bfd_section_vma (abfd, sect);
 400       vp->dend = vp->dstart + bfd_section_size (abfd, sect);
 401       vp->dvma = bfd_section_vma (abfd, sect);
 402     }
 403   /* Silently ignore other types of sections. (FIXME?)  */
 404 }
 405
 406 /* Make a vmap for ABFD which might be a member of the archive ARCH.
 407    Return the new vmap.  */
 408
 409 struct vmap *
 410 map_vmap (bfd *abfd, bfd *arch)
 411 {
 412   struct vmap_and_bfd vmap_bfd;
 413   struct vmap *vp, **vpp;
 414
 415   vp = (struct vmap *) xmalloc (sizeof (*vp));
 416   memset ((char *) vp, '\0', sizeof (*vp));
 417   vp->nxt = 0;
 418   vp->bfd = abfd;
 419   vp->name = bfd_get_filename (arch ? arch : abfd);
 420   vp->member = arch ? bfd_get_filename (abfd) : "";
 421
 422   vmap_bfd.pbfd = arch;
 423   vmap_bfd.pvmap = vp;
 424   bfd_map_over_sections (abfd, bfdsec_to_vmap, &vmap_bfd);
 425
 426   /* Find the end of the list and append. */
 427   for (vpp = &vmap; *vpp; vpp = &(*vpp)->nxt)
 428     ;
 429   *vpp = vp;
 430
 431   return vp;
 432 }
 433 \f
 434 /* Read or write the exec file.
 435
 436    Args are address within a BFD file, address within gdb address-space,
 437    length, and a flag indicating whether to read or write.
 438
 439    Result is a length:
 440
 441    0:    We cannot handle this address and length.
 442    > 0:  We have handled N bytes starting at this address.
 443    (If N == length, we did it all.)  We might be able
 444    to handle more bytes beyond this length, but no
 445    promises.
 446    < 0:  We cannot handle this address, but if somebody
 447    else handles (-N) bytes, we can start from there.
 448
 449    The same routine is used to handle both core and exec files;
 450    we just tail-call it with more arguments to select between them.  */
 451
 452 int
 453 xfer_memory (CORE_ADDR memaddr, gdb_byte *myaddr, int len, int write,
 454              struct mem_attrib *attrib, struct target_ops *target)
 455 {
 456   int res;
 457   struct section_table *p;
 458   CORE_ADDR nextsectaddr, memend;
 459   asection *section = NULL;
 460
 461   if (len <= 0)
 462     internal_error (__FILE__, __LINE__, _("failed internal consistency check"));
 463
 464   if (overlay_debugging)
 465     {
 466       section = find_pc_overlay (memaddr);
 467       if (pc_in_unmapped_range (memaddr, section))
 468         memaddr = overlay_mapped_address (memaddr, section);
 469     }
 470
 471   memend = memaddr + len;
 472   nextsectaddr = memend;
 473
 474   for (p = target->to_sections; p < target->to_sections_end; p++)
 475     {
 476       if (overlay_debugging && section && p->the_bfd_section &&
 477           strcmp (section->name, p->the_bfd_section->name) != 0)
 478         continue;               /* not the section we need */
 479       if (memaddr >= p->addr)
 480         {
 481           if (memend <= p->endaddr)
 482             {
 483               /* Entire transfer is within this section.  */
 484               if (write)
 485                 res = bfd_set_section_contents (p->bfd, p->the_bfd_section,
 486                                                 myaddr, memaddr - p->addr,
 487                                                 len);
 488               else
 489                 res = bfd_get_section_contents (p->bfd, p->the_bfd_section,
 490                                                 myaddr, memaddr - p->addr,
 491                                                 len);
 492               return (res != 0) ? len : 0;
 493             }
 494           else if (memaddr >= p->endaddr)
 495             {
 496               /* This section ends before the transfer starts.  */
 497               continue;
 498             }
 499           else
 500             {
 501               /* This section overlaps the transfer.  Just do half.  */
 502               len = p->endaddr - memaddr;
 503               if (write)
 504                 res = bfd_set_section_contents (p->bfd, p->the_bfd_section,
 505                                                 myaddr, memaddr - p->addr,
 506                                                 len);
 507               else
 508                 res = bfd_get_section_contents (p->bfd, p->the_bfd_section,
 509                                                 myaddr, memaddr - p->addr,
 510                                                 len);
 511               return (res != 0) ? len : 0;
 512             }
 513         }
 514       else
 515         nextsectaddr = min (nextsectaddr, p->addr);
 516     }
 517
 518   if (nextsectaddr >= memend)
 519     return 0;                   /* We can't help */
 520   else
 521     return -(nextsectaddr - memaddr);   /* Next boundary where we can help */
 522 }
 523 \f
 524
 525 void
 526 print_section_info (struct target_ops *t, bfd *abfd)
 527 {
 528   struct section_table *p;
 529   /* FIXME: 16 is not wide enough when TARGET_ADDR_BIT > 64.  */
 530   int wid = TARGET_ADDR_BIT <= 32 ? 8 : 16;
 531
 532   printf_filtered ("\t`%s', ", bfd_get_filename (abfd));
 533   wrap_here ("        ");
 534   printf_filtered (_("file type %s.\n"), bfd_get_target (abfd));
 535   if (abfd == exec_bfd)
 536     {
 537       printf_filtered (_("\tEntry point: "));
 538       deprecated_print_address_numeric (bfd_get_start_address (abfd), 1, gdb_stdout);
 539       printf_filtered ("\n");
 540     }
 541   for (p = t->to_sections; p < t->to_sections_end; p++)
 542     {
 543       printf_filtered ("\t%s", hex_string_custom (p->addr, wid));
 544       printf_filtered (" - %s", hex_string_custom (p->endaddr, wid));
 545
 546       /* FIXME: A format of "08l" is not wide enough for file offsets
 547          larger than 4GB.  OTOH, making it "016l" isn't desirable either
 548          since most output will then be much wider than necessary.  It
 549          may make sense to test the size of the file and choose the
 550          format string accordingly.  */
 551       /* FIXME: i18n: Need to rewrite this sentence.  */
 552       if (info_verbose)
 553         printf_filtered (" @ %s",
 554                          hex_string_custom (p->the_bfd_section->filepos, 8));
 555       printf_filtered (" is %s", bfd_section_name (p->bfd, p->the_bfd_section));
 556       if (p->bfd != abfd)
 557         printf_filtered (" in %s", bfd_get_filename (p->bfd));
 558       printf_filtered ("\n");
 559     }
 560 }
 561
 562 static void
 563 exec_files_info (struct target_ops *t)
 564 {
 565   print_section_info (t, exec_bfd);
 566
 567   if (vmap)
 568     {
 569       struct vmap *vp;
 570
 571       printf_unfiltered (_("\tMapping info for file `%s'.\n"), vmap->name);
 572       printf_unfiltered ("\t  %*s   %*s   %*s   %*s %8.8s %s\n",
 573                          strlen_paddr (), "tstart",
 574                          strlen_paddr (), "tend",
 575                          strlen_paddr (), "dstart",
 576                          strlen_paddr (), "dend",
 577                          "section",
 578                          "file(member)");
 579
 580       for (vp = vmap; vp; vp = vp->nxt)
 581         printf_unfiltered ("\t0x%s 0x%s 0x%s 0x%s %s%s%s%s\n",
 582                            paddr (vp->tstart),
 583                            paddr (vp->tend),
 584                            paddr (vp->dstart),
 585                            paddr (vp->dend),
 586                            vp->name,
 587                            *vp->member ? "(" : "", vp->member,
 588                            *vp->member ? ")" : "");
 589     }
 590 }
 591
 592 /* msnyder 5/21/99:
 593    exec_set_section_offsets sets the offsets of all the sections
 594    in the exec objfile.  */
 595
 596 void
 597 exec_set_section_offsets (bfd_signed_vma text_off, bfd_signed_vma data_off,
 598                           bfd_signed_vma bss_off)
 599 {
 600   struct section_table *sect;
 601
 602   for (sect = exec_ops.to_sections;
 603        sect < exec_ops.to_sections_end;
 604        sect++)
 605     {
 606       flagword flags;
 607
 608       flags = bfd_get_section_flags (exec_bfd, sect->the_bfd_section);
 609
 610       if (flags & SEC_CODE)
 611         {
 612           sect->addr += text_off;
 613           sect->endaddr += text_off;
 614         }
 615       else if (flags & (SEC_DATA | SEC_LOAD))
 616         {
 617           sect->addr += data_off;
 618           sect->endaddr += data_off;
 619         }
 620       else if (flags & SEC_ALLOC)
 621         {
 622           sect->addr += bss_off;
 623           sect->endaddr += bss_off;
 624         }
 625     }
 626 }
 627
 628 static void
 629 set_section_command (char *args, int from_tty)
 630 {
 631   struct section_table *p;
 632   char *secname;
 633   unsigned seclen;
 634   unsigned long secaddr;
 635   char secprint[100];
 636   long offset;
 637
 638   if (args == 0)
 639     error (_("Must specify section name and its virtual address"));
 640
 641   /* Parse out section name */
 642   for (secname = args; !isspace (*args); args++);
 643   seclen = args - secname;
 644
 645   /* Parse out new virtual address */
 646   secaddr = parse_and_eval_address (args);
 647
 648   for (p = exec_ops.to_sections; p < exec_ops.to_sections_end; p++)
 649     {
 650       if (!strncmp (secname, bfd_section_name (exec_bfd, p->the_bfd_section), seclen)
 651           && bfd_section_name (exec_bfd, p->the_bfd_section)[seclen] == '\0')
 652         {
 653           offset = secaddr - p->addr;
 654           p->addr += offset;
 655           p->endaddr += offset;
 656           if (from_tty)
 657             exec_files_info (&exec_ops);
 658           return;
 659         }
 660     }
 661   if (seclen >= sizeof (secprint))
 662     seclen = sizeof (secprint) - 1;
 663   strncpy (secprint, secname, seclen);
 664   secprint[seclen] = '\0';
 665   error (_("Section %s not found"), secprint);
 666 }
 667
 668 /* If we can find a section in FILENAME with BFD index INDEX, and the
 669    user has not assigned an address to it yet (via "set section"), adjust it
 670    to ADDRESS.  */
 671
 672 void
 673 exec_set_section_address (const char *filename, int index, CORE_ADDR address)
 674 {
 675   struct section_table *p;
 676
 677   for (p = exec_ops.to_sections; p < exec_ops.to_sections_end; p++)
 678     {
 679       if (strcmp (filename, p->bfd->filename) == 0
 680           && index == p->the_bfd_section->index
 681           && p->addr == 0)
 682         {
 683           p->addr = address;
 684           p->endaddr += address;
 685         }
 686     }
 687 }
 688
 689 /* If mourn is being called in all the right places, this could be say
 690    `gdb internal error' (since generic_mourn calls
 691    breakpoint_init_inferior).  */
 692
 693 static int
 694 ignore (CORE_ADDR addr, bfd_byte *contents)
 695 {
 696   return 0;
 697 }
 698
 699 /* Find mapped memory. */
 700
 701 extern void
 702 exec_set_find_memory_regions (int (*func) (int (*) (CORE_ADDR,
 703                                                     unsigned long,
 704                                                     int, int, int,
 705                                                     void *),
 706                                            void *))
 707 {
 708   exec_ops.to_find_memory_regions = func;
 709 }
 710
 711 static char *exec_make_note_section (bfd *, int *);
 712
 713 /* Fill in the exec file target vector.  Very few entries need to be
 714    defined.  */
 715
 716 static void
 717 init_exec_ops (void)
 718 {
 719   exec_ops.to_shortname = "exec";
 720   exec_ops.to_longname = "Local exec file";
 721   exec_ops.to_doc = "Use an executable file as a target.\n\
 722 Specify the filename of the executable file.";
 723   exec_ops.to_open = exec_open;
 724   exec_ops.to_close = exec_close;
 725   exec_ops.to_attach = find_default_attach;
 726   exec_ops.deprecated_xfer_memory = xfer_memory;
 727   exec_ops.to_files_info = exec_files_info;
 728   exec_ops.to_insert_breakpoint = ignore;
 729   exec_ops.to_remove_breakpoint = ignore;
 730   exec_ops.to_create_inferior = find_default_create_inferior;
 731   exec_ops.to_stratum = file_stratum;
 732   exec_ops.to_has_memory = 1;
 733   exec_ops.to_make_corefile_notes = exec_make_note_section;
 734   exec_ops.to_magic = OPS_MAGIC;
 735 }
 736
 737 void
 738 _initialize_exec (void)
 739 {
 740   struct cmd_list_element *c;
 741
 742   init_exec_ops ();
 743
 744   if (!dbx_commands)
 745     {
 746       c = add_cmd ("file", class_files, file_command, _("\
 747 Use FILE as program to be debugged.\n\
 748 It is read for its symbols, for getting the contents of pure memory,\n\
 749 and it is the program executed when you use the `run' command.\n\
 750 If FILE cannot be found as specified, your execution directory path\n\
 751 ($PATH) is searched for a command of that name.\n\
 752 No arg means to have no executable file and no symbols."), &cmdlist);
 753       set_cmd_completer (c, filename_completer);
 754     }
 755
 756   c = add_cmd ("exec-file", class_files, exec_file_command, _("\
 757 Use FILE as program for getting contents of pure memory.\n\
 758 If FILE cannot be found as specified, your execution directory path\n\
 759 is searched for a command of that name.\n\
 760 No arg means have no executable file."), &cmdlist);
 761   set_cmd_completer (c, filename_completer);
 762
 763   add_com ("section", class_files, set_section_command, _("\
 764 Change the base address of section SECTION of the exec file to ADDR.\n\
 765 This can be used if the exec file does not contain section addresses,\n\
 766 (such as in the a.out format), or when the addresses specified in the\n\
 767 file itself are wrong.  Each section must be changed separately.  The\n\
 768 ``info files'' command lists all the sections and their addresses."));
 769
 770   add_setshow_boolean_cmd ("write", class_support, &write_files, _("\
 771 Set writing into executable and core files."), _("\
 772 Show writing into executable and core files."), NULL,
 773                            NULL,
 774                            show_write_files,
 775                            &setlist, &showlist);
 776
 777   add_target (&exec_ops);
 778 }
 779
 780 static char *
 781 exec_make_note_section (bfd *obfd, int *note_size)
 782 {
 783   error (_("Can't create a corefile"));
 784 }