1 /* Work with executable files, for GDB.
2 Copyright (C) 1988, 1989 Free Software Foundation, Inc.
4 This file is part of GDB.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */
29 #include <sys/types.h>
32 #include <sys/param.h>
38 #ifdef STILL_NEEDED_FOR_DECSTATION
39 #include <sys/dir.h> /* For DECstations */
40 #include <sys/user.h> /* After a.out.h */
47 extern char *getenv();
48 extern void child_create_inferior (), child_attach ();
49 extern void symbol_file_command ();
51 /* The Binary File Descriptor handle for the executable file. */
55 /* Whether to open exec and core files read-only or read-write. */
61 extern struct target_ops exec_ops
;
72 if (exec_ops
.sections
) {
73 free (exec_ops
.sections
);
74 exec_ops
.sections
= NULL
;
75 exec_ops
.sections_end
= NULL
;
80 exec_file_command (filename
, from_tty
)
84 target_preopen (from_tty
);
86 /* Remove any previous exec file. */
87 unpush_target (&exec_ops
);
89 /* Now open and digest the file the user requested, if any. */
93 char *scratch_pathname
;
96 filename
= tilde_expand (filename
);
97 make_cleanup (free
, filename
);
99 scratch_chan
= openp (getenv ("PATH"), 1, filename
,
100 write_files
? O_RDWR
: O_RDONLY
, 0,
102 if (scratch_chan
< 0)
103 perror_with_name (filename
);
105 exec_bfd
= bfd_fdopenr (scratch_pathname
, NULL
, scratch_chan
);
107 error ("Could not open `%s' as an executable file: %s",
108 scratch_pathname
, bfd_errmsg (bfd_error
));
109 if (!bfd_check_format (exec_bfd
, bfd_object
))
110 error ("\"%s\": not in executable format: %s.",
111 scratch_pathname
, bfd_errmsg (bfd_error
));
114 /* This code needs to be incorporated into BFD */
115 #ifdef COFF_ENCAPSULATE
116 /* If we have a coff header, it can give us better values for
117 text_start and exec_data_start. This is particularly useful
118 for remote debugging of embedded systems. */
119 if (N_FLAGS(exec_aouthdr
) & N_FLAGS_COFF_ENCAPSULATE
)
121 struct coffheader ch
;
123 val
= lseek (execchan
, -(sizeof (AOUTHDR
) + sizeof (ch
)), 1);
125 perror_with_name (filename
);
126 val
= myread (execchan
, &ch
, sizeof (ch
));
128 perror_with_name (filename
);
129 text_start
= ch
.text_start
;
130 exec_data_start
= ch
.data_start
;
135 IS_OBJECT_FILE (exec_aouthdr
) ? 0 : N_TXTADDR (exec_aouthdr
);
136 exec_data_start
= IS_OBJECT_FILE (exec_aouthdr
)
137 ? exec_aouthdr
.a_text
: N_DATADDR (exec_aouthdr
);
141 if (build_section_table (exec_bfd
, &exec_ops
.sections
,
142 &exec_ops
.sections_end
))
143 error ("Can't find the file sections in `%s': %s",
144 exec_bfd
->filename
, bfd_errmsg (bfd_error
));
148 push_target (&exec_ops
);
150 /* Tell display code (if any) about the changed file name. */
151 if (exec_file_display_hook
)
152 (*exec_file_display_hook
) (filename
);
155 printf ("No exec file now.\n");
158 /* Set both the exec file and the symbol file, in one command.
159 What a novelty. Why did GDB go through four major releases before this
160 command was added? */
163 file_command (arg
, from_tty
)
167 /* FIXME, if we lose on reading the symbol file, we should revert
168 the exec file, but that's rough. */
169 exec_file_command (arg
, from_tty
);
170 symbol_file_command (arg
, from_tty
);
174 /* Locate all mappable sections of a BFD file.
175 table_pp_char is a char * to get it through bfd_map_over_sections;
176 we cast it back to its proper type. */
179 add_to_section_table (abfd
, asect
, table_pp_char
)
184 struct section_table
**table_pp
= (struct section_table
**)table_pp_char
;
187 aflag
= bfd_get_section_flags (abfd
, asect
);
188 /* FIXME, we need to handle BSS segment here...it alloc's but doesn't load */
189 if (!(aflag
& SEC_LOAD
))
191 (*table_pp
)->bfd
= abfd
;
192 (*table_pp
)->sec_ptr
= asect
;
193 (*table_pp
)->addr
= bfd_section_vma (abfd
, asect
);
194 (*table_pp
)->endaddr
= (*table_pp
)->addr
+ bfd_section_size (abfd
, asect
);
199 build_section_table (some_bfd
, start
, end
)
201 struct section_table
**start
, **end
;
205 count
= bfd_count_sections (some_bfd
);
207 abort(); /* return 1? */
210 *start
= (struct section_table
*) xmalloc (count
* sizeof (**start
));
212 bfd_map_over_sections (some_bfd
, add_to_section_table
, (char *)end
);
213 if (*end
> *start
+ count
)
215 /* We could realloc the table, but it probably loses for most files. */
219 /* Read or write the exec file.
221 Args are address within a BFD file, address within gdb address-space,
222 length, and a flag indicating whether to read or write.
226 0: We cannot handle this address and length.
227 > 0: We have handled N bytes starting at this address.
228 (If N == length, we did it all.) We might be able
229 to handle more bytes beyond this length, but no
231 < 0: We cannot handle this address, but if somebody
232 else handles (-N) bytes, we can start from there.
234 The same routine is used to handle both core and exec files;
235 we just tail-call it with more arguments to select between them. */
238 xfer_memory (memaddr
, myaddr
, len
, write
, target
)
243 struct target_ops
*target
;
246 struct section_table
*p
;
247 CORE_ADDR nextsectaddr
, memend
;
248 boolean (*xfer_fn
) ();
253 memend
= memaddr
+ len
;
254 xfer_fn
= write
? bfd_set_section_contents
: bfd_get_section_contents
;
255 nextsectaddr
= memend
;
257 for (p
= target
->sections
; p
< target
->sections_end
; p
++)
259 if (p
->addr
<= memaddr
)
260 if (p
->endaddr
>= memend
)
262 /* Entire transfer is within this section. */
263 res
= xfer_fn (p
->bfd
, p
->sec_ptr
, myaddr
, memaddr
- p
->addr
, len
);
264 return (res
!= false)? len
: 0;
266 else if (p
->endaddr
<= memaddr
)
268 /* This section ends before the transfer starts. */
273 /* This section overlaps the transfer. Just do half. */
274 len
= p
->endaddr
- memaddr
;
275 res
= xfer_fn (p
->bfd
, p
->sec_ptr
, myaddr
, memaddr
- p
->addr
, len
);
276 return (res
!= false)? len
: 0;
278 else if (p
->addr
< nextsectaddr
)
279 nextsectaddr
= p
->addr
;
282 if (nextsectaddr
>= memend
)
283 return 0; /* We can't help */
285 return - (nextsectaddr
- memaddr
); /* Next boundary where we can help */
289 #ifdef REG_STACK_SEGMENT
291 /* Pyramids and AM29000s have an extra segment in the virtual address space
292 for the (control) stack of register-window frames. The AM29000 folk
293 call it the "register stack" rather than the "memory stack". */
294 else if (memaddr
>= reg_stack_start
&& memaddr
< reg_stack_end
)
296 i
= min (len
, reg_stack_end
- memaddr
);
297 fileptr
= memaddr
- reg_stack_start
+ reg_stack_offset
;
298 wanna_xfer
= coredata
;
300 #endif /* REG_STACK_SEGMENT */
306 struct section_table
*p
;
308 printf ("\tExecutable file `%s'.\n", bfd_get_filename(exec_bfd
));
310 for (p
= exec_ops
.sections
; p
< exec_ops
.sections_end
; p
++)
311 printf("\texecutable from 0x%08x to 0x%08x is %s\n",
313 bfd_section_name (exec_bfd
, p
->sec_ptr
));
317 set_section_command (args
, from_tty
)
321 struct section_table
*p
;
324 unsigned long secaddr
;
329 error ("Must specify section name and its virtual address");
331 /* Parse out section name */
332 for (secname
= args
; !isspace(*args
); args
++) ;
333 seclen
= args
- secname
;
335 /* Parse out new virtual address */
336 secaddr
= parse_and_eval_address (args
);
338 for (p
= exec_ops
.sections
; p
< exec_ops
.sections_end
; p
++) {
339 if (!strncmp (secname
, bfd_section_name (exec_bfd
, p
->sec_ptr
), seclen
)
340 && bfd_section_name (exec_bfd
, p
->sec_ptr
)[seclen
] == '\0') {
341 offset
= secaddr
- p
->addr
;
343 p
->endaddr
+= offset
;
348 if (seclen
>= sizeof (secprint
))
349 seclen
= sizeof (secprint
) - 1;
350 strncpy (secprint
, secname
, seclen
);
351 secprint
[seclen
] = '\0';
352 error ("Section %s not found", secprint
);
355 struct target_ops exec_ops
= {
356 "exec", "Local exec file",
357 "Use an executable file as a target.\n\
358 Specify the filename of the executable file.",
359 exec_file_command
, exec_close
, /* open, close */
360 child_attach
, 0, 0, 0, /* attach, detach, resume, wait, */
361 0, 0, /* fetch_registers, store_registers, */
362 0, 0, 0, /* prepare_to_store, conv_to, conv_from, */
363 xfer_memory
, exec_files_info
,
364 0, 0, /* insert_breakpoint, remove_breakpoint, */
365 0, 0, 0, 0, 0, /* terminal stuff */
366 0, 0, /* kill, load */
367 0, 0, /* call fn, lookup sym */
368 child_create_inferior
,
369 0, /* mourn_inferior */
370 file_stratum
, 0, /* next */
371 0, 1, 0, 0, 0, /* all mem, mem, stack, regs, exec */
372 0, 0, /* section pointers */
373 OPS_MAGIC
, /* Always the last thing */
380 add_com ("file", class_files
, file_command
,
381 "Use FILE as program to be debugged.\n\
382 It is read for its symbols, for getting the contents of pure memory,\n\
383 and it is the program executed when you use the `run' command.\n\
384 If FILE cannot be found as specified, your execution directory path\n\
385 ($PATH) is searched for a command of that name.\n\
386 No arg means to have no executable file and no symbols.");
388 add_com ("exec-file", class_files
, exec_file_command
,
389 "Use FILE as program for getting contents of pure memory.\n\
390 If FILE cannot be found as specified, your execution directory path\n\
391 is searched for a command of that name.\n\
392 No arg means have no executable file.");
394 add_com ("section", class_files
, set_section_command
,
395 "Change the base address of section SECTION of the exec file to ADDR.\n\
396 This can be used if the exec file does not contain section addresses,\n\
397 (such as in the a.out format), or when the addresses specified in the\n\
398 file itself are wrong. Each section must be changed separately. The\n\
399 ``info files'' command lists all the sections and their addresses.");
402 (add_set_cmd ("write", class_support
, var_boolean
, (char *)&write_files
,
403 "Set writing into executable and core files.",
407 add_target (&exec_ops
);
This page took 0.038429 seconds and 4 git commands to generate.