gdb/exec.c

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