gdb/exec.c

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