Commit | Line | Data |
---|---|---|
ee0613d1 JG |
1 | /* Memory-access and commands for "inferior" (child) process, for GDB. |
2 | Copyright 1986, 1987, 1988, 1989, 1991, 1992 Free Software Foundation, Inc. | |
bd5635a1 RP |
3 | |
4 | This file is part of GDB. | |
5 | ||
ee0613d1 | 6 | This program is free software; you can redistribute it and/or modify |
bd5635a1 | 7 | it under the terms of the GNU General Public License as published by |
ee0613d1 JG |
8 | the Free Software Foundation; either version 2 of the License, or |
9 | (at your option) any later version. | |
bd5635a1 | 10 | |
ee0613d1 | 11 | This program is distributed in the hope that it will be useful, |
bd5635a1 RP |
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. | |
15 | ||
16 | You should have received a copy of the GNU General Public License | |
ee0613d1 JG |
17 | along with this program; if not, write to the Free Software |
18 | Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ | |
bd5635a1 | 19 | |
1304f099 | 20 | #include "defs.h" |
bd5635a1 RP |
21 | #include <signal.h> |
22 | #include <sys/param.h> | |
23 | #include <string.h> | |
bd5635a1 | 24 | #include "symtab.h" |
1304f099 | 25 | #include "gdbtypes.h" |
bd5635a1 RP |
26 | #include "frame.h" |
27 | #include "inferior.h" | |
28 | #include "environ.h" | |
29 | #include "value.h" | |
30 | #include "gdbcmd.h" | |
31 | #include "gdbcore.h" | |
32 | #include "target.h" | |
33 | ||
1304f099 JG |
34 | static void |
35 | continue_command PARAMS ((char *, int)); | |
36 | ||
37 | static void | |
38 | until_next_command PARAMS ((int)); | |
39 | ||
40 | static void | |
41 | until_command PARAMS ((char *, int)); | |
42 | ||
43 | static void | |
44 | path_info PARAMS ((char *, int)); | |
45 | ||
46 | static void | |
47 | path_command PARAMS ((char *, int)); | |
48 | ||
49 | static void | |
50 | unset_command PARAMS ((char *, int)); | |
51 | ||
52 | static void | |
53 | float_info PARAMS ((char *, int)); | |
54 | ||
55 | static void | |
56 | detach_command PARAMS ((char *, int)); | |
57 | ||
58 | static void | |
59 | nofp_registers_info PARAMS ((char *, int)); | |
60 | ||
61 | static void | |
62 | all_registers_info PARAMS ((char *, int)); | |
63 | ||
64 | static void | |
65 | registers_info PARAMS ((char *, int)); | |
66 | ||
67 | static void | |
68 | do_registers_info PARAMS ((int, int)); | |
69 | ||
70 | static void | |
71 | unset_environment_command PARAMS ((char *, int)); | |
72 | ||
73 | static void | |
74 | set_environment_command PARAMS ((char *, int)); | |
75 | ||
76 | static void | |
77 | environment_info PARAMS ((char *, int)); | |
78 | ||
79 | static void | |
80 | program_info PARAMS ((char *, int)); | |
81 | ||
82 | static void | |
83 | finish_command PARAMS ((char *, int)); | |
84 | ||
85 | static void | |
86 | signal_command PARAMS ((char *, int)); | |
87 | ||
88 | static void | |
89 | jump_command PARAMS ((char *, int)); | |
90 | ||
91 | static void | |
92 | step_1 PARAMS ((int, int, char *)); | |
93 | ||
94 | static void | |
95 | nexti_command PARAMS ((char *, int)); | |
bd5635a1 | 96 | |
1304f099 JG |
97 | static void |
98 | stepi_command PARAMS ((char *, int)); | |
99 | ||
100 | static void | |
101 | next_command PARAMS ((char *, int)); | |
102 | ||
103 | static void | |
104 | step_command PARAMS ((char *, int)); | |
105 | ||
106 | static void | |
107 | run_command PARAMS ((char *, int)); | |
bd5635a1 RP |
108 | |
109 | #define ERROR_NO_INFERIOR \ | |
110 | if (!target_has_execution) error ("The program is not being run."); | |
111 | ||
112 | /* String containing arguments to give to the program, separated by spaces. | |
113 | Empty string (pointer to '\0') means no args. */ | |
114 | ||
115 | static char *inferior_args; | |
116 | ||
117 | /* File name for default use for standard in/out in the inferior. */ | |
118 | ||
119 | char *inferior_io_terminal; | |
120 | ||
121 | /* Pid of our debugged inferior, or 0 if no inferior now. | |
122 | Since various parts of infrun.c test this to see whether there is a program | |
123 | being debugged it should be nonzero (currently 3 is used) for remote | |
124 | debugging. */ | |
125 | ||
126 | int inferior_pid; | |
127 | ||
128 | /* Last signal that the inferior received (why it stopped). */ | |
129 | ||
130 | int stop_signal; | |
131 | ||
132 | /* Address at which inferior stopped. */ | |
133 | ||
134 | CORE_ADDR stop_pc; | |
135 | ||
136 | /* Stack frame when program stopped. */ | |
137 | ||
138 | FRAME_ADDR stop_frame_address; | |
139 | ||
140 | /* Chain containing status of breakpoint(s) that we have stopped at. */ | |
141 | ||
142 | bpstat stop_bpstat; | |
143 | ||
144 | /* Flag indicating that a command has proceeded the inferior past the | |
145 | current breakpoint. */ | |
146 | ||
147 | int breakpoint_proceeded; | |
148 | ||
149 | /* Nonzero if stopped due to a step command. */ | |
150 | ||
151 | int stop_step; | |
152 | ||
153 | /* Nonzero if stopped due to completion of a stack dummy routine. */ | |
154 | ||
155 | int stop_stack_dummy; | |
156 | ||
157 | /* Nonzero if stopped due to a random (unexpected) signal in inferior | |
158 | process. */ | |
159 | ||
160 | int stopped_by_random_signal; | |
161 | ||
162 | /* Range to single step within. | |
163 | If this is nonzero, respond to a single-step signal | |
164 | by continuing to step if the pc is in this range. */ | |
165 | ||
166 | CORE_ADDR step_range_start; /* Inclusive */ | |
167 | CORE_ADDR step_range_end; /* Exclusive */ | |
168 | ||
169 | /* Stack frame address as of when stepping command was issued. | |
170 | This is how we know when we step into a subroutine call, | |
171 | and how to set the frame for the breakpoint used to step out. */ | |
172 | ||
173 | FRAME_ADDR step_frame_address; | |
174 | ||
175 | /* 1 means step over all subroutine calls. | |
b5a3d2aa | 176 | 0 means don't step over calls (used by stepi). |
bd5635a1 RP |
177 | -1 means step over calls to undebuggable functions. */ |
178 | ||
179 | int step_over_calls; | |
180 | ||
181 | /* If stepping, nonzero means step count is > 1 | |
182 | so don't print frame next time inferior stops | |
183 | if it stops due to stepping. */ | |
184 | ||
185 | int step_multi; | |
186 | ||
187 | /* Environment to use for running inferior, | |
188 | in format described in environ.h. */ | |
189 | ||
190 | struct environ *inferior_environ; | |
191 | ||
bd5635a1 | 192 | \f |
e1ce8aa5 | 193 | /* ARGSUSED */ |
bd5635a1 RP |
194 | void |
195 | tty_command (file, from_tty) | |
196 | char *file; | |
197 | int from_tty; | |
198 | { | |
199 | if (file == 0) | |
200 | error_no_arg ("terminal name for running target process"); | |
201 | ||
202 | inferior_io_terminal = savestring (file, strlen (file)); | |
203 | } | |
204 | ||
205 | static void | |
206 | run_command (args, from_tty) | |
207 | char *args; | |
208 | int from_tty; | |
209 | { | |
210 | char *exec_file; | |
211 | ||
212 | dont_repeat (); | |
213 | ||
214 | if (inferior_pid) | |
215 | { | |
216 | if ( | |
217 | !query ("The program being debugged has been started already.\n\ | |
218 | Start it from the beginning? ")) | |
219 | error ("Program not restarted."); | |
ee0613d1 | 220 | target_kill (); |
bd5635a1 RP |
221 | } |
222 | ||
223 | exec_file = (char *) get_exec_file (0); | |
224 | ||
1304f099 | 225 | /* The exec file is re-read every time we do a generic_mourn_inferior, so |
bd5635a1 RP |
226 | we just have to worry about the symbol file. */ |
227 | reread_symbols (); | |
228 | ||
229 | if (args) | |
230 | { | |
231 | char *cmd; | |
ee0613d1 | 232 | cmd = concat ("set args ", args, NULL); |
bd5635a1 RP |
233 | make_cleanup (free, cmd); |
234 | execute_command (cmd, from_tty); | |
235 | } | |
236 | ||
237 | if (from_tty) | |
238 | { | |
b5a3d2aa SG |
239 | puts_filtered("Starting program: "); |
240 | if (exec_file) | |
241 | puts_filtered(exec_file); | |
242 | puts_filtered(" "); | |
243 | puts_filtered(inferior_args); | |
244 | puts_filtered("\n"); | |
bd5635a1 RP |
245 | fflush (stdout); |
246 | } | |
247 | ||
248 | target_create_inferior (exec_file, inferior_args, | |
249 | environ_vector (inferior_environ)); | |
250 | } | |
251 | \f | |
1304f099 | 252 | static void |
bd5635a1 RP |
253 | continue_command (proc_count_exp, from_tty) |
254 | char *proc_count_exp; | |
255 | int from_tty; | |
256 | { | |
257 | ERROR_NO_INFERIOR; | |
258 | ||
259 | /* If have argument, set proceed count of breakpoint we stopped at. */ | |
260 | ||
261 | if (proc_count_exp != NULL) | |
262 | { | |
263 | bpstat bs = stop_bpstat; | |
264 | int num = bpstat_num (&bs); | |
265 | if (num == 0 && from_tty) | |
266 | { | |
267 | printf_filtered | |
268 | ("Not stopped at any breakpoint; argument ignored.\n"); | |
269 | } | |
270 | while (num != 0) | |
271 | { | |
272 | set_ignore_count (num, | |
273 | parse_and_eval_address (proc_count_exp) - 1, | |
274 | from_tty); | |
275 | /* set_ignore_count prints a message ending with a period. | |
276 | So print two spaces before "Continuing.". */ | |
277 | if (from_tty) | |
1304f099 | 278 | printf_filtered (" "); |
bd5635a1 RP |
279 | num = bpstat_num (&bs); |
280 | } | |
281 | } | |
282 | ||
283 | if (from_tty) | |
1304f099 | 284 | printf_filtered ("Continuing.\n"); |
bd5635a1 RP |
285 | |
286 | clear_proceed_status (); | |
287 | ||
288 | proceed ((CORE_ADDR) -1, -1, 0); | |
289 | } | |
290 | \f | |
291 | /* Step until outside of current statement. */ | |
bd5635a1 | 292 | |
e1ce8aa5 | 293 | /* ARGSUSED */ |
bd5635a1 RP |
294 | static void |
295 | step_command (count_string, from_tty) | |
1304f099 | 296 | char *count_string; |
bd5635a1 RP |
297 | int from_tty; |
298 | { | |
299 | step_1 (0, 0, count_string); | |
300 | } | |
301 | ||
302 | /* Likewise, but skip over subroutine calls as if single instructions. */ | |
303 | ||
e1ce8aa5 | 304 | /* ARGSUSED */ |
bd5635a1 RP |
305 | static void |
306 | next_command (count_string, from_tty) | |
1304f099 | 307 | char *count_string; |
bd5635a1 RP |
308 | int from_tty; |
309 | { | |
310 | step_1 (1, 0, count_string); | |
311 | } | |
312 | ||
313 | /* Likewise, but step only one instruction. */ | |
314 | ||
e1ce8aa5 | 315 | /* ARGSUSED */ |
bd5635a1 RP |
316 | static void |
317 | stepi_command (count_string, from_tty) | |
1304f099 | 318 | char *count_string; |
bd5635a1 RP |
319 | int from_tty; |
320 | { | |
321 | step_1 (0, 1, count_string); | |
322 | } | |
323 | ||
e1ce8aa5 | 324 | /* ARGSUSED */ |
bd5635a1 RP |
325 | static void |
326 | nexti_command (count_string, from_tty) | |
1304f099 | 327 | char *count_string; |
bd5635a1 RP |
328 | int from_tty; |
329 | { | |
330 | step_1 (1, 1, count_string); | |
331 | } | |
332 | ||
333 | static void | |
334 | step_1 (skip_subroutines, single_inst, count_string) | |
335 | int skip_subroutines; | |
336 | int single_inst; | |
337 | char *count_string; | |
338 | { | |
339 | register int count = 1; | |
340 | FRAME fr; | |
1304f099 | 341 | struct cleanup *cleanups = 0; |
bd5635a1 RP |
342 | |
343 | ERROR_NO_INFERIOR; | |
344 | count = count_string ? parse_and_eval_address (count_string) : 1; | |
345 | ||
1304f099 JG |
346 | if (!single_inst || skip_subroutines) /* leave si command alone */ |
347 | { | |
348 | enable_longjmp_breakpoint(); | |
349 | cleanups = make_cleanup(disable_longjmp_breakpoint, 0); | |
350 | } | |
351 | ||
bd5635a1 RP |
352 | for (; count > 0; count--) |
353 | { | |
354 | clear_proceed_status (); | |
355 | ||
bd5635a1 RP |
356 | fr = get_current_frame (); |
357 | if (!fr) /* Avoid coredump here. Why tho? */ | |
358 | error ("No current frame"); | |
359 | step_frame_address = FRAME_FP (fr); | |
360 | ||
361 | if (! single_inst) | |
362 | { | |
363 | find_pc_line_pc_range (stop_pc, &step_range_start, &step_range_end); | |
364 | if (step_range_end == 0) | |
365 | { | |
1304f099 | 366 | struct minimal_symbol *msymbol; |
bd5635a1 | 367 | |
1304f099 | 368 | msymbol = lookup_minimal_symbol_by_pc (stop_pc); |
bd5635a1 | 369 | target_terminal_ours (); |
1304f099 | 370 | printf_filtered ("Current function has no line number information.\n"); |
bd5635a1 RP |
371 | fflush (stdout); |
372 | ||
373 | /* No info or after _etext ("Can't happen") */ | |
1304f099 | 374 | if (msymbol == NULL || (msymbol + 1) -> name == NULL) |
bd5635a1 RP |
375 | error ("No data available on pc function."); |
376 | ||
1304f099 | 377 | printf_filtered ("Single stepping until function exit.\n"); |
bd5635a1 RP |
378 | fflush (stdout); |
379 | ||
1304f099 JG |
380 | step_range_start = msymbol -> address; |
381 | step_range_end = (msymbol + 1) -> address; | |
bd5635a1 RP |
382 | } |
383 | } | |
384 | else | |
385 | { | |
386 | /* Say we are stepping, but stop after one insn whatever it does. | |
387 | Don't step through subroutine calls even to undebuggable | |
388 | functions. */ | |
389 | step_range_start = step_range_end = 1; | |
390 | if (!skip_subroutines) | |
391 | step_over_calls = 0; | |
392 | } | |
393 | ||
394 | if (skip_subroutines) | |
395 | step_over_calls = 1; | |
396 | ||
397 | step_multi = (count > 1); | |
398 | proceed ((CORE_ADDR) -1, -1, 1); | |
399 | if (! stop_step) | |
400 | break; | |
401 | #if defined (SHIFT_INST_REGS) | |
402 | write_register (NNPC_REGNUM, read_register (NPC_REGNUM)); | |
403 | write_register (NPC_REGNUM, read_register (PC_REGNUM)); | |
404 | #endif | |
405 | } | |
1304f099 JG |
406 | |
407 | if (!single_inst || skip_subroutines) | |
408 | do_cleanups(cleanups); | |
bd5635a1 RP |
409 | } |
410 | \f | |
411 | /* Continue program at specified address. */ | |
412 | ||
413 | static void | |
414 | jump_command (arg, from_tty) | |
415 | char *arg; | |
416 | int from_tty; | |
417 | { | |
418 | register CORE_ADDR addr; | |
419 | struct symtabs_and_lines sals; | |
420 | struct symtab_and_line sal; | |
b4fde6fa FF |
421 | struct symbol *fn; |
422 | struct symbol *sfn; | |
423 | char *fname; | |
424 | struct cleanup *back_to; | |
bd5635a1 RP |
425 | |
426 | ERROR_NO_INFERIOR; | |
427 | ||
428 | if (!arg) | |
429 | error_no_arg ("starting address"); | |
430 | ||
431 | sals = decode_line_spec_1 (arg, 1); | |
432 | if (sals.nelts != 1) | |
433 | { | |
434 | error ("Unreasonable jump request"); | |
435 | } | |
436 | ||
437 | sal = sals.sals[0]; | |
1304f099 | 438 | free ((PTR)sals.sals); |
bd5635a1 RP |
439 | |
440 | if (sal.symtab == 0 && sal.pc == 0) | |
441 | error ("No source file has been specified."); | |
442 | ||
ee0613d1 | 443 | resolve_sal_pc (&sal); /* May error out */ |
bd5635a1 | 444 | |
b4fde6fa FF |
445 | /* See if we are trying to jump to another function. */ |
446 | fn = get_frame_function (get_current_frame ()); | |
447 | sfn = find_pc_function (sal.pc); | |
448 | if (fn != NULL && sfn != fn) | |
449 | { | |
450 | fname = strdup_demangled (SYMBOL_NAME (fn)); | |
451 | back_to = make_cleanup (free, fname); | |
452 | if (!query ("Line %d is not in `%s'. Jump anyway? ", sal.line, fname)) | |
453 | { | |
454 | error ("Not confirmed."); | |
455 | /* NOTREACHED */ | |
456 | } | |
457 | do_cleanups (back_to); | |
458 | } | |
bd5635a1 | 459 | |
bd5635a1 RP |
460 | addr = ADDR_BITS_SET (sal.pc); |
461 | ||
462 | if (from_tty) | |
1304f099 | 463 | printf_filtered ("Continuing at %s.\n", local_hex_string(addr)); |
bd5635a1 RP |
464 | |
465 | clear_proceed_status (); | |
466 | proceed (addr, 0, 0); | |
467 | } | |
468 | ||
469 | /* Continue program giving it specified signal. */ | |
470 | ||
471 | static void | |
472 | signal_command (signum_exp, from_tty) | |
473 | char *signum_exp; | |
474 | int from_tty; | |
475 | { | |
476 | register int signum; | |
477 | ||
478 | dont_repeat (); /* Too dangerous. */ | |
479 | ERROR_NO_INFERIOR; | |
480 | ||
481 | if (!signum_exp) | |
482 | error_no_arg ("signal number"); | |
483 | ||
484 | signum = parse_and_eval_address (signum_exp); | |
485 | ||
486 | if (from_tty) | |
1304f099 | 487 | printf_filtered ("Continuing with signal %d.\n", signum); |
bd5635a1 RP |
488 | |
489 | clear_proceed_status (); | |
490 | proceed (stop_pc, signum, 0); | |
491 | } | |
492 | ||
493 | /* Execute a "stack dummy", a piece of code stored in the stack | |
494 | by the debugger to be executed in the inferior. | |
495 | ||
496 | To call: first, do PUSH_DUMMY_FRAME. | |
497 | Then push the contents of the dummy. It should end with a breakpoint insn. | |
498 | Then call here, passing address at which to start the dummy. | |
499 | ||
500 | The contents of all registers are saved before the dummy frame is popped | |
501 | and copied into the buffer BUFFER. | |
502 | ||
503 | The dummy's frame is automatically popped whenever that break is hit. | |
504 | If that is the first time the program stops, run_stack_dummy | |
505 | returns to its caller with that frame already gone. | |
506 | Otherwise, the caller never gets returned to. */ | |
507 | ||
ee0613d1 | 508 | /* DEBUG HOOK: 4 => return instead of letting the stack dummy run. */ |
bd5635a1 RP |
509 | |
510 | static int stack_dummy_testing = 0; | |
511 | ||
512 | void | |
513 | run_stack_dummy (addr, buffer) | |
514 | CORE_ADDR addr; | |
515 | char buffer[REGISTER_BYTES]; | |
516 | { | |
517 | /* Now proceed, having reached the desired place. */ | |
518 | clear_proceed_status (); | |
519 | if (stack_dummy_testing & 4) | |
520 | { | |
521 | POP_FRAME; | |
522 | return; | |
523 | } | |
524 | proceed_to_finish = 1; /* We want stop_registers, please... */ | |
525 | proceed (addr, 0, 0); | |
526 | ||
527 | if (!stop_stack_dummy) | |
528 | /* This used to say | |
529 | "Cannot continue previously requested operation". */ | |
530 | error ("\ | |
531 | The program being debugged stopped while in a function called from GDB.\n\ | |
532 | The expression which contained the function call has been discarded."); | |
533 | ||
534 | /* On return, the stack dummy has been popped already. */ | |
535 | ||
4ed3a9ea | 536 | memcpy (buffer, stop_registers, sizeof stop_registers); |
bd5635a1 RP |
537 | } |
538 | \f | |
539 | /* Proceed until we reach a different source line with pc greater than | |
540 | our current one or exit the function. We skip calls in both cases. | |
541 | ||
542 | Note that eventually this command should probably be changed so | |
543 | that only source lines are printed out when we hit the breakpoint | |
544 | we set. I'm going to postpone this until after a hopeful rewrite | |
545 | of wait_for_inferior and the proceed status code. -- randy */ | |
546 | ||
e1ce8aa5 | 547 | /* ARGSUSED */ |
1304f099 | 548 | static void |
bd5635a1 RP |
549 | until_next_command (from_tty) |
550 | int from_tty; | |
551 | { | |
552 | FRAME frame; | |
553 | CORE_ADDR pc; | |
554 | struct symbol *func; | |
555 | struct symtab_and_line sal; | |
556 | ||
557 | clear_proceed_status (); | |
558 | ||
559 | frame = get_current_frame (); | |
560 | ||
561 | /* Step until either exited from this function or greater | |
562 | than the current line (if in symbolic section) or pc (if | |
563 | not). */ | |
564 | ||
565 | pc = read_pc (); | |
566 | func = find_pc_function (pc); | |
567 | ||
568 | if (!func) | |
569 | { | |
1304f099 | 570 | struct minimal_symbol *msymbol = lookup_minimal_symbol_by_pc (pc); |
bd5635a1 | 571 | |
1304f099 | 572 | if (msymbol == NULL) |
bd5635a1 RP |
573 | error ("Execution is not within a known function."); |
574 | ||
1304f099 | 575 | step_range_start = msymbol -> address; |
bd5635a1 RP |
576 | step_range_end = pc; |
577 | } | |
578 | else | |
579 | { | |
580 | sal = find_pc_line (pc, 0); | |
581 | ||
582 | step_range_start = BLOCK_START (SYMBOL_BLOCK_VALUE (func)); | |
583 | step_range_end = sal.end; | |
584 | } | |
585 | ||
586 | step_over_calls = 1; | |
587 | step_frame_address = FRAME_FP (frame); | |
588 | ||
589 | step_multi = 0; /* Only one call to proceed */ | |
590 | ||
591 | proceed ((CORE_ADDR) -1, -1, 1); | |
592 | } | |
593 | ||
1304f099 | 594 | static void |
bd5635a1 RP |
595 | until_command (arg, from_tty) |
596 | char *arg; | |
597 | int from_tty; | |
598 | { | |
599 | if (!target_has_execution) | |
600 | error ("The program is not running."); | |
601 | if (arg) | |
602 | until_break_command (arg, from_tty); | |
603 | else | |
604 | until_next_command (from_tty); | |
605 | } | |
606 | \f | |
607 | /* "finish": Set a temporary breakpoint at the place | |
608 | the selected frame will return to, then continue. */ | |
609 | ||
610 | static void | |
611 | finish_command (arg, from_tty) | |
612 | char *arg; | |
613 | int from_tty; | |
614 | { | |
615 | struct symtab_and_line sal; | |
616 | register FRAME frame; | |
617 | struct frame_info *fi; | |
618 | register struct symbol *function; | |
1304f099 JG |
619 | struct breakpoint *breakpoint; |
620 | struct cleanup *old_chain; | |
bd5635a1 RP |
621 | |
622 | if (arg) | |
623 | error ("The \"finish\" command does not take any arguments."); | |
624 | if (!target_has_execution) | |
625 | error ("The program is not running."); | |
777bef06 JK |
626 | if (selected_frame == NULL) |
627 | error ("No selected frame."); | |
bd5635a1 RP |
628 | |
629 | frame = get_prev_frame (selected_frame); | |
630 | if (frame == 0) | |
631 | error ("\"finish\" not meaningful in the outermost frame."); | |
632 | ||
633 | clear_proceed_status (); | |
634 | ||
635 | fi = get_frame_info (frame); | |
636 | sal = find_pc_line (fi->pc, 0); | |
637 | sal.pc = fi->pc; | |
1304f099 JG |
638 | |
639 | breakpoint = set_momentary_breakpoint (sal, frame, bp_finish); | |
640 | ||
641 | old_chain = make_cleanup(delete_breakpoint, breakpoint); | |
bd5635a1 RP |
642 | |
643 | /* Find the function we will return from. */ | |
644 | ||
645 | fi = get_frame_info (selected_frame); | |
646 | function = find_pc_function (fi->pc); | |
647 | ||
ee0613d1 JG |
648 | /* Print info on the selected frame, including level number |
649 | but not source. */ | |
bd5635a1 RP |
650 | if (from_tty) |
651 | { | |
ee0613d1 JG |
652 | printf_filtered ("Run till exit from "); |
653 | print_stack_frame (selected_frame, selected_frame_level, 0); | |
bd5635a1 RP |
654 | } |
655 | ||
656 | proceed_to_finish = 1; /* We want stop_registers, please... */ | |
657 | proceed ((CORE_ADDR) -1, -1, 0); | |
658 | ||
1304f099 JG |
659 | /* Did we stop at our breakpoint? */ |
660 | if (bpstat_find_breakpoint(stop_bpstat, breakpoint) != NULL | |
661 | && function != 0) | |
bd5635a1 RP |
662 | { |
663 | struct type *value_type; | |
664 | register value val; | |
665 | CORE_ADDR funcaddr; | |
666 | ||
667 | value_type = TYPE_TARGET_TYPE (SYMBOL_TYPE (function)); | |
668 | if (!value_type) | |
669 | fatal ("internal: finish_command: function has no target type"); | |
670 | ||
671 | if (TYPE_CODE (value_type) == TYPE_CODE_VOID) | |
672 | return; | |
673 | ||
674 | funcaddr = BLOCK_START (SYMBOL_BLOCK_VALUE (function)); | |
675 | ||
676 | val = value_being_returned (value_type, stop_registers, | |
677 | using_struct_return (value_of_variable (function), | |
678 | funcaddr, | |
679 | value_type, | |
680 | BLOCK_GCC_COMPILED (SYMBOL_BLOCK_VALUE (function)))); | |
681 | ||
ee0613d1 | 682 | printf_filtered ("Value returned is $%d = ", record_latest_value (val)); |
bd5635a1 | 683 | value_print (val, stdout, 0, Val_no_prettyprint); |
ee0613d1 | 684 | printf_filtered ("\n"); |
bd5635a1 | 685 | } |
1304f099 | 686 | do_cleanups(old_chain); |
bd5635a1 RP |
687 | } |
688 | \f | |
e1ce8aa5 | 689 | /* ARGSUSED */ |
bd5635a1 RP |
690 | static void |
691 | program_info (args, from_tty) | |
692 | char *args; | |
693 | int from_tty; | |
694 | { | |
695 | bpstat bs = stop_bpstat; | |
696 | int num = bpstat_num (&bs); | |
697 | ||
698 | if (!target_has_execution) | |
699 | { | |
1304f099 | 700 | printf_filtered ("The program being debugged is not being run.\n"); |
bd5635a1 RP |
701 | return; |
702 | } | |
703 | ||
704 | target_files_info (); | |
1304f099 | 705 | printf_filtered ("Program stopped at %s.\n", local_hex_string(stop_pc)); |
bd5635a1 | 706 | if (stop_step) |
1304f099 | 707 | printf_filtered ("It stopped after being stepped.\n"); |
bd5635a1 RP |
708 | else if (num != 0) |
709 | { | |
710 | /* There may be several breakpoints in the same place, so this | |
711 | isn't as strange as it seems. */ | |
712 | while (num != 0) | |
713 | { | |
714 | if (num < 0) | |
1304f099 | 715 | printf_filtered ("It stopped at a breakpoint that has since been deleted.\n"); |
bd5635a1 | 716 | else |
1304f099 | 717 | printf_filtered ("It stopped at breakpoint %d.\n", num); |
bd5635a1 RP |
718 | num = bpstat_num (&bs); |
719 | } | |
720 | } | |
721 | else if (stop_signal) { | |
722 | #ifdef PRINT_RANDOM_SIGNAL | |
723 | PRINT_RANDOM_SIGNAL (stop_signal); | |
724 | #else | |
1304f099 JG |
725 | printf_filtered ("It stopped with signal %d (%s).\n", |
726 | stop_signal, safe_strsignal (stop_signal)); | |
bd5635a1 RP |
727 | #endif |
728 | } | |
729 | ||
730 | if (!from_tty) | |
1304f099 | 731 | printf_filtered ("Type \"info stack\" or \"info registers\" for more information.\n"); |
bd5635a1 RP |
732 | } |
733 | \f | |
734 | static void | |
1304f099 | 735 | environment_info (var, from_tty) |
bd5635a1 | 736 | char *var; |
1304f099 | 737 | int from_tty; |
bd5635a1 RP |
738 | { |
739 | if (var) | |
740 | { | |
741 | register char *val = get_in_environ (inferior_environ, var); | |
742 | if (val) | |
631f7a9f JG |
743 | { |
744 | puts_filtered (var); | |
745 | puts_filtered (" = "); | |
746 | puts_filtered (val); | |
747 | puts_filtered ("\n"); | |
748 | } | |
bd5635a1 | 749 | else |
631f7a9f JG |
750 | { |
751 | puts_filtered ("Environment variable \""); | |
752 | puts_filtered (var); | |
753 | puts_filtered ("\" not defined.\n"); | |
754 | } | |
bd5635a1 RP |
755 | } |
756 | else | |
757 | { | |
758 | register char **vector = environ_vector (inferior_environ); | |
759 | while (*vector) | |
631f7a9f JG |
760 | { |
761 | puts_filtered (*vector++); | |
762 | puts_filtered ("\n"); | |
763 | } | |
bd5635a1 RP |
764 | } |
765 | } | |
766 | ||
767 | static void | |
1304f099 | 768 | set_environment_command (arg, from_tty) |
bd5635a1 | 769 | char *arg; |
1304f099 | 770 | int from_tty; |
bd5635a1 RP |
771 | { |
772 | register char *p, *val, *var; | |
773 | int nullset = 0; | |
774 | ||
775 | if (arg == 0) | |
776 | error_no_arg ("environment variable and value"); | |
777 | ||
778 | /* Find seperation between variable name and value */ | |
779 | p = (char *) strchr (arg, '='); | |
780 | val = (char *) strchr (arg, ' '); | |
781 | ||
782 | if (p != 0 && val != 0) | |
783 | { | |
784 | /* We have both a space and an equals. If the space is before the | |
631f7a9f JG |
785 | equals, walk forward over the spaces til we see a nonspace |
786 | (possibly the equals). */ | |
bd5635a1 RP |
787 | if (p > val) |
788 | while (*val == ' ') | |
789 | val++; | |
790 | ||
631f7a9f JG |
791 | /* Now if the = is after the char following the spaces, |
792 | take the char following the spaces. */ | |
793 | if (p > val) | |
b5a3d2aa | 794 | p = val - 1; |
bd5635a1 RP |
795 | } |
796 | else if (val != 0 && p == 0) | |
797 | p = val; | |
798 | ||
799 | if (p == arg) | |
800 | error_no_arg ("environment variable to set"); | |
801 | ||
802 | if (p == 0 || p[1] == 0) | |
803 | { | |
804 | nullset = 1; | |
805 | if (p == 0) | |
806 | p = arg + strlen (arg); /* So that savestring below will work */ | |
807 | } | |
808 | else | |
809 | { | |
810 | /* Not setting variable value to null */ | |
811 | val = p + 1; | |
812 | while (*val == ' ' || *val == '\t') | |
813 | val++; | |
814 | } | |
815 | ||
816 | while (p != arg && (p[-1] == ' ' || p[-1] == '\t')) p--; | |
817 | ||
818 | var = savestring (arg, p - arg); | |
819 | if (nullset) | |
820 | { | |
1304f099 | 821 | printf_filtered ("Setting environment variable \"%s\" to null value.\n", var); |
bd5635a1 RP |
822 | set_in_environ (inferior_environ, var, ""); |
823 | } | |
824 | else | |
825 | set_in_environ (inferior_environ, var, val); | |
826 | free (var); | |
827 | } | |
828 | ||
829 | static void | |
830 | unset_environment_command (var, from_tty) | |
831 | char *var; | |
832 | int from_tty; | |
833 | { | |
834 | if (var == 0) | |
835 | { | |
836 | /* If there is no argument, delete all environment variables. | |
837 | Ask for confirmation if reading from the terminal. */ | |
838 | if (!from_tty || query ("Delete all environment variables? ")) | |
839 | { | |
840 | free_environ (inferior_environ); | |
841 | inferior_environ = make_environ (); | |
842 | } | |
843 | } | |
844 | else | |
845 | unset_in_environ (inferior_environ, var); | |
846 | } | |
847 | ||
848 | /* Handle the execution path (PATH variable) */ | |
849 | ||
a8a69e63 | 850 | static const char path_var_name[] = "PATH"; |
bd5635a1 | 851 | |
e1ce8aa5 | 852 | /* ARGSUSED */ |
1304f099 | 853 | static void |
bd5635a1 RP |
854 | path_info (args, from_tty) |
855 | char *args; | |
856 | int from_tty; | |
857 | { | |
b5a3d2aa SG |
858 | puts_filtered ("Executable and object file path: "); |
859 | puts_filtered (get_in_environ (inferior_environ, path_var_name)); | |
860 | puts_filtered ("\n"); | |
bd5635a1 RP |
861 | } |
862 | ||
863 | /* Add zero or more directories to the front of the execution path. */ | |
864 | ||
1304f099 | 865 | static void |
bd5635a1 RP |
866 | path_command (dirname, from_tty) |
867 | char *dirname; | |
868 | int from_tty; | |
869 | { | |
870 | char *exec_path; | |
871 | ||
872 | dont_repeat (); | |
873 | exec_path = strsave (get_in_environ (inferior_environ, path_var_name)); | |
e1ce8aa5 | 874 | mod_path (dirname, &exec_path); |
bd5635a1 RP |
875 | set_in_environ (inferior_environ, path_var_name, exec_path); |
876 | free (exec_path); | |
877 | if (from_tty) | |
e1ce8aa5 | 878 | path_info ((char *)NULL, from_tty); |
bd5635a1 RP |
879 | } |
880 | \f | |
881 | CORE_ADDR | |
882 | read_pc () | |
883 | { | |
884 | return ADDR_BITS_REMOVE ((CORE_ADDR) read_register (PC_REGNUM)); | |
885 | } | |
886 | ||
887 | void | |
888 | write_pc (val) | |
889 | CORE_ADDR val; | |
890 | { | |
891 | write_register (PC_REGNUM, (long) val); | |
892 | #ifdef NPC_REGNUM | |
893 | write_register (NPC_REGNUM, (long) val+4); | |
894 | #endif | |
895 | pc_changed = 0; | |
896 | } | |
897 | ||
1304f099 | 898 | const char * const reg_names[] = REGISTER_NAMES; |
bd5635a1 RP |
899 | |
900 | /* Print out the machine register regnum. If regnum is -1, | |
ee0613d1 JG |
901 | print all registers (fpregs == 1) or all non-float registers |
902 | (fpregs == 0). | |
903 | ||
bd5635a1 RP |
904 | For most machines, having all_registers_info() print the |
905 | register(s) one per line is good enough. If a different format | |
ee0613d1 | 906 | is required, (eg, for MIPS or Pyramid 90x, which both have |
bd5635a1 | 907 | lots of regs), or there is an existing convention for showing |
ee0613d1 | 908 | all the registers, define the macro DO_REGISTERS_INFO(regnum, fp) |
bd5635a1 | 909 | to provide that format. */ |
ee0613d1 | 910 | |
bd5635a1 | 911 | #if !defined (DO_REGISTERS_INFO) |
ee0613d1 JG |
912 | #define DO_REGISTERS_INFO(regnum, fp) do_registers_info(regnum, fp) |
913 | static void | |
914 | do_registers_info (regnum, fpregs) | |
bd5635a1 | 915 | int regnum; |
ee0613d1 | 916 | int fpregs; |
bd5635a1 RP |
917 | { |
918 | register int i; | |
919 | ||
bd5635a1 RP |
920 | for (i = 0; i < NUM_REGS; i++) |
921 | { | |
922 | char raw_buffer[MAX_REGISTER_RAW_SIZE]; | |
923 | char virtual_buffer[MAX_REGISTER_VIRTUAL_SIZE]; | |
924 | ||
ee0613d1 JG |
925 | /* Decide between printing all regs, nonfloat regs, or specific reg. */ |
926 | if (regnum == -1) { | |
927 | if (TYPE_CODE (REGISTER_VIRTUAL_TYPE (i)) == TYPE_CODE_FLT && !fpregs) | |
928 | continue; | |
929 | } else { | |
930 | if (i != regnum) | |
931 | continue; | |
932 | } | |
bd5635a1 RP |
933 | |
934 | fputs_filtered (reg_names[i], stdout); | |
935 | print_spaces_filtered (15 - strlen (reg_names[i]), stdout); | |
936 | ||
937 | /* Get the data in raw format, then convert also to virtual format. */ | |
938 | if (read_relative_register_raw_bytes (i, raw_buffer)) | |
939 | { | |
940 | printf_filtered ("Invalid register contents\n"); | |
941 | continue; | |
942 | } | |
943 | ||
b5a3d2aa | 944 | REGISTER_CONVERT_TO_VIRTUAL (i, raw_buffer, virtual_buffer); |
bd5635a1 RP |
945 | |
946 | /* If virtual format is floating, print it that way, and in raw hex. */ | |
947 | if (TYPE_CODE (REGISTER_VIRTUAL_TYPE (i)) == TYPE_CODE_FLT | |
948 | && ! INVALID_FLOAT (virtual_buffer, REGISTER_VIRTUAL_SIZE (i))) | |
949 | { | |
950 | register int j; | |
951 | ||
952 | val_print (REGISTER_VIRTUAL_TYPE (i), virtual_buffer, 0, | |
953 | stdout, 0, 1, 0, Val_pretty_default); | |
954 | ||
955 | printf_filtered ("\t(raw 0x"); | |
956 | for (j = 0; j < REGISTER_RAW_SIZE (i); j++) | |
957 | printf_filtered ("%02x", (unsigned char)raw_buffer[j]); | |
958 | printf_filtered (")"); | |
959 | } | |
960 | ||
961 | /* FIXME! val_print probably can handle all of these cases now... */ | |
962 | ||
963 | /* Else if virtual format is too long for printf, | |
964 | print in hex a byte at a time. */ | |
965 | else if (REGISTER_VIRTUAL_SIZE (i) > sizeof (long)) | |
966 | { | |
967 | register int j; | |
968 | printf_filtered ("0x"); | |
969 | for (j = 0; j < REGISTER_VIRTUAL_SIZE (i); j++) | |
970 | printf_filtered ("%02x", (unsigned char)virtual_buffer[j]); | |
971 | } | |
972 | /* Else print as integer in hex and in decimal. */ | |
973 | else | |
974 | { | |
975 | val_print (REGISTER_VIRTUAL_TYPE (i), raw_buffer, 0, | |
976 | stdout, 'x', 1, 0, Val_pretty_default); | |
977 | printf_filtered ("\t"); | |
978 | val_print (REGISTER_VIRTUAL_TYPE (i), raw_buffer, 0, | |
979 | stdout, 0, 1, 0, Val_pretty_default); | |
980 | } | |
981 | ||
982 | /* The SPARC wants to print even-numbered float regs as doubles | |
983 | in addition to printing them as floats. */ | |
984 | #ifdef PRINT_REGISTER_HOOK | |
985 | PRINT_REGISTER_HOOK (i); | |
986 | #endif | |
987 | ||
988 | printf_filtered ("\n"); | |
989 | } | |
990 | } | |
991 | #endif /* no DO_REGISTERS_INFO. */ | |
992 | ||
993 | static void | |
ee0613d1 | 994 | registers_info (addr_exp, fpregs) |
bd5635a1 | 995 | char *addr_exp; |
ee0613d1 | 996 | int fpregs; |
bd5635a1 RP |
997 | { |
998 | int regnum; | |
b5a3d2aa | 999 | register char *end; |
bd5635a1 RP |
1000 | |
1001 | if (!target_has_registers) | |
1002 | error ("The program has no registers now."); | |
1003 | ||
b5a3d2aa | 1004 | if (!addr_exp) |
bd5635a1 | 1005 | { |
b5a3d2aa SG |
1006 | DO_REGISTERS_INFO(-1, fpregs); |
1007 | return; | |
bd5635a1 | 1008 | } |
bd5635a1 | 1009 | |
b5a3d2aa SG |
1010 | do |
1011 | { | |
1012 | if (addr_exp[0] == '$') | |
1013 | addr_exp++; | |
1014 | end = addr_exp; | |
1015 | while (*end != '\0' && *end != ' ' && *end != '\t') | |
1016 | ++end; | |
1017 | for (regnum = 0; regnum < NUM_REGS; regnum++) | |
1018 | if (!strncmp (addr_exp, reg_names[regnum], end - addr_exp) | |
1019 | && strlen (reg_names[regnum]) == end - addr_exp) | |
1020 | goto found; | |
1021 | if (*addr_exp >= '0' && *addr_exp <= '9') | |
1022 | regnum = atoi (addr_exp); /* Take a number */ | |
1023 | if (regnum >= NUM_REGS) /* Bad name, or bad number */ | |
1024 | error ("%.*s: invalid register", end - addr_exp, addr_exp); | |
1025 | ||
1026 | found: | |
1027 | DO_REGISTERS_INFO(regnum, fpregs); | |
1028 | ||
1029 | addr_exp = end; | |
1030 | while (*addr_exp == ' ' || *addr_exp == '\t') | |
1031 | ++addr_exp; | |
1032 | } while (*addr_exp != '\0'); | |
ee0613d1 JG |
1033 | } |
1034 | ||
1035 | static void | |
1304f099 | 1036 | all_registers_info (addr_exp, from_tty) |
ee0613d1 | 1037 | char *addr_exp; |
1304f099 | 1038 | int from_tty; |
ee0613d1 JG |
1039 | { |
1040 | registers_info (addr_exp, 1); | |
1041 | } | |
1042 | ||
1043 | static void | |
1304f099 | 1044 | nofp_registers_info (addr_exp, from_tty) |
ee0613d1 | 1045 | char *addr_exp; |
1304f099 | 1046 | int from_tty; |
ee0613d1 JG |
1047 | { |
1048 | registers_info (addr_exp, 0); | |
bd5635a1 RP |
1049 | } |
1050 | \f | |
1051 | /* | |
1052 | * TODO: | |
1053 | * Should save/restore the tty state since it might be that the | |
1054 | * program to be debugged was started on this tty and it wants | |
1055 | * the tty in some state other than what we want. If it's running | |
1056 | * on another terminal or without a terminal, then saving and | |
1057 | * restoring the tty state is a harmless no-op. | |
1058 | * This only needs to be done if we are attaching to a process. | |
1059 | */ | |
1060 | ||
1061 | /* | |
b5a3d2aa SG |
1062 | attach_command -- |
1063 | takes a program started up outside of gdb and ``attaches'' to it. | |
1064 | This stops it cold in its tracks and allows us to start debugging it. | |
1065 | and wait for the trace-trap that results from attaching. */ | |
1066 | ||
bd5635a1 RP |
1067 | void |
1068 | attach_command (args, from_tty) | |
1069 | char *args; | |
1070 | int from_tty; | |
1071 | { | |
f266e564 | 1072 | dont_repeat (); /* Not for the faint of heart */ |
b5a3d2aa SG |
1073 | |
1074 | if (target_has_execution) | |
1075 | { | |
1076 | if (query ("A program is being debugged already. Kill it? ")) | |
1077 | target_kill (); | |
1078 | else | |
1079 | error ("Inferior not killed."); | |
1080 | } | |
1081 | ||
bd5635a1 | 1082 | target_attach (args, from_tty); |
b5a3d2aa SG |
1083 | |
1084 | /* Set up the "saved terminal modes" of the inferior | |
1085 | based on what modes we are starting it with. */ | |
1086 | target_terminal_init (); | |
1087 | ||
1088 | /* Install inferior's terminal modes. */ | |
1089 | target_terminal_inferior (); | |
1090 | ||
1091 | /* Set up execution context to know that we should return from | |
1092 | wait_for_inferior as soon as the target reports a stop. */ | |
1093 | init_wait_for_inferior (); | |
1094 | clear_proceed_status (); | |
1095 | stop_soon_quietly = 1; | |
1096 | ||
1097 | wait_for_inferior (); | |
1098 | ||
1099 | #ifdef SOLIB_ADD | |
1100 | /* Add shared library symbols from the newly attached process, if any. */ | |
1101 | SOLIB_ADD ((char *)0, from_tty, (struct target_ops *)0); | |
1102 | #endif | |
1103 | ||
1104 | normal_stop (); | |
bd5635a1 RP |
1105 | } |
1106 | ||
1107 | /* | |
1108 | * detach_command -- | |
1109 | * takes a program previously attached to and detaches it. | |
1110 | * The program resumes execution and will no longer stop | |
1111 | * on signals, etc. We better not have left any breakpoints | |
1112 | * in the program or it'll die when it hits one. For this | |
1113 | * to work, it may be necessary for the process to have been | |
1114 | * previously attached. It *might* work if the program was | |
1115 | * started via the normal ptrace (PTRACE_TRACEME). | |
1116 | */ | |
1117 | ||
1118 | static void | |
1119 | detach_command (args, from_tty) | |
1120 | char *args; | |
1121 | int from_tty; | |
1122 | { | |
f266e564 | 1123 | dont_repeat (); /* Not for the faint of heart */ |
bd5635a1 RP |
1124 | target_detach (args, from_tty); |
1125 | } | |
1126 | ||
1127 | /* ARGSUSED */ | |
1128 | static void | |
1304f099 | 1129 | float_info (addr_exp, from_tty) |
bd5635a1 | 1130 | char *addr_exp; |
1304f099 | 1131 | int from_tty; |
bd5635a1 RP |
1132 | { |
1133 | #ifdef FLOAT_INFO | |
1134 | FLOAT_INFO; | |
1135 | #else | |
1304f099 | 1136 | printf_filtered ("No floating point info available for this processor.\n"); |
bd5635a1 RP |
1137 | #endif |
1138 | } | |
1139 | \f | |
f266e564 JK |
1140 | /* ARGSUSED */ |
1141 | static void | |
1142 | unset_command (args, from_tty) | |
1143 | char *args; | |
1144 | int from_tty; | |
1145 | { | |
1304f099 | 1146 | printf_filtered ("\"unset\" must be followed by the name of an unset subcommand.\n"); |
f266e564 JK |
1147 | help_list (unsetlist, "unset ", -1, stdout); |
1148 | } | |
1149 | ||
bd5635a1 RP |
1150 | void |
1151 | _initialize_infcmd () | |
1152 | { | |
1153 | struct cmd_list_element *c; | |
1154 | ||
1155 | add_com ("tty", class_run, tty_command, | |
1156 | "Set terminal for future runs of program being debugged."); | |
1157 | ||
1158 | add_show_from_set | |
1159 | (add_set_cmd ("args", class_run, var_string_noescape, (char *)&inferior_args, | |
1160 | ||
1161 | "Set arguments to give program being debugged when it is started.\n\ | |
1162 | Follow this command with any number of args, to be passed to the program.", | |
1163 | &setlist), | |
1164 | &showlist); | |
1165 | ||
1166 | c = add_cmd | |
1167 | ("environment", no_class, environment_info, | |
1168 | "The environment to give the program, or one variable's value.\n\ | |
1169 | With an argument VAR, prints the value of environment variable VAR to\n\ | |
1170 | give the program being debugged. With no arguments, prints the entire\n\ | |
1171 | environment to be given to the program.", &showlist); | |
1172 | c->completer = noop_completer; | |
1173 | ||
f266e564 JK |
1174 | add_prefix_cmd ("unset", no_class, unset_command, |
1175 | "Complement to certain \"set\" commands", | |
1176 | &unsetlist, "unset ", 0, &cmdlist); | |
1177 | ||
bd5635a1 RP |
1178 | c = add_cmd ("environment", class_run, unset_environment_command, |
1179 | "Cancel environment variable VAR for the program.\n\ | |
1180 | This does not affect the program until the next \"run\" command.", | |
f266e564 | 1181 | &unsetlist); |
bd5635a1 RP |
1182 | c->completer = noop_completer; |
1183 | ||
1184 | c = add_cmd ("environment", class_run, set_environment_command, | |
1185 | "Set environment variable value to give the program.\n\ | |
1186 | Arguments are VAR VALUE where VAR is variable name and VALUE is value.\n\ | |
1187 | VALUES of environment variables are uninterpreted strings.\n\ | |
1188 | This does not affect the program until the next \"run\" command.", | |
1189 | &setlist); | |
1190 | c->completer = noop_completer; | |
1191 | ||
1192 | add_com ("path", class_files, path_command, | |
1193 | "Add directory DIR(s) to beginning of search path for object files.\n\ | |
1194 | $cwd in the path means the current working directory.\n\ | |
1195 | This path is equivalent to the $PATH shell variable. It is a list of\n\ | |
1196 | directories, separated by colons. These directories are searched to find\n\ | |
1197 | fully linked executable files and separately compiled object files as needed."); | |
1198 | ||
ee0613d1 | 1199 | c = add_cmd ("paths", no_class, path_info, |
bd5635a1 RP |
1200 | "Current search path for finding object files.\n\ |
1201 | $cwd in the path means the current working directory.\n\ | |
1202 | This path is equivalent to the $PATH shell variable. It is a list of\n\ | |
1203 | directories, separated by colons. These directories are searched to find\n\ | |
ee0613d1 JG |
1204 | fully linked executable files and separately compiled object files as needed.", &showlist); |
1205 | c->completer = noop_completer; | |
bd5635a1 RP |
1206 | |
1207 | add_com ("attach", class_run, attach_command, | |
1208 | "Attach to a process or file outside of GDB.\n\ | |
1209 | This command attaches to another target, of the same type as your last\n\ | |
1210 | `target' command (`info files' will show your target stack).\n\ | |
1211 | The command may take as argument a process id or a device file.\n\ | |
1212 | For a process id, you must have permission to send the process a signal,\n\ | |
1213 | and it must have the same effective uid as the debugger.\n\ | |
1214 | When using \"attach\", you should use the \"file\" command to specify\n\ | |
1215 | the program running in the process, and to load its symbol table."); | |
1216 | ||
1217 | add_com ("detach", class_run, detach_command, | |
1218 | "Detach a process or file previously attached.\n\ | |
1219 | If a process, it is no longer traced, and it continues its execution. If you\n\ | |
1220 | were debugging a file, the file is closed and gdb no longer accesses it."); | |
1221 | ||
1222 | add_com ("signal", class_run, signal_command, | |
1223 | "Continue program giving it signal number SIGNUMBER."); | |
1224 | ||
1225 | add_com ("stepi", class_run, stepi_command, | |
1226 | "Step one instruction exactly.\n\ | |
1227 | Argument N means do this N times (or till program stops for another reason)."); | |
1228 | add_com_alias ("si", "stepi", class_alias, 0); | |
1229 | ||
1230 | add_com ("nexti", class_run, nexti_command, | |
1231 | "Step one instruction, but proceed through subroutine calls.\n\ | |
1232 | Argument N means do this N times (or till program stops for another reason)."); | |
1233 | add_com_alias ("ni", "nexti", class_alias, 0); | |
1234 | ||
1235 | add_com ("finish", class_run, finish_command, | |
1236 | "Execute until selected stack frame returns.\n\ | |
1237 | Upon return, the value returned is printed and put in the value history."); | |
1238 | ||
1239 | add_com ("next", class_run, next_command, | |
1240 | "Step program, proceeding through subroutine calls.\n\ | |
1241 | Like the \"step\" command as long as subroutine calls do not happen;\n\ | |
1242 | when they do, the call is treated as one instruction.\n\ | |
1243 | Argument N means do this N times (or till program stops for another reason)."); | |
1244 | add_com_alias ("n", "next", class_run, 1); | |
1245 | ||
1246 | add_com ("step", class_run, step_command, | |
1247 | "Step program until it reaches a different source line.\n\ | |
1248 | Argument N means do this N times (or till program stops for another reason)."); | |
1249 | add_com_alias ("s", "step", class_run, 1); | |
1250 | ||
1251 | add_com ("until", class_run, until_command, | |
1252 | "Execute until the program reaches a source line greater than the current\n\ | |
1253 | or a specified line or address or function (same args as break command).\n\ | |
1254 | Execution will also stop upon exit from the current stack frame."); | |
1255 | add_com_alias ("u", "until", class_run, 1); | |
1256 | ||
1257 | add_com ("jump", class_run, jump_command, | |
1258 | "Continue program being debugged at specified line or address.\n\ | |
1259 | Give as argument either LINENUM or *ADDR, where ADDR is an expression\n\ | |
1260 | for an address to start at."); | |
1261 | ||
1262 | add_com ("continue", class_run, continue_command, | |
1263 | "Continue program being debugged, after signal or breakpoint.\n\ | |
1264 | If proceeding from breakpoint, a number N may be used as an argument:\n\ | |
1265 | then the same breakpoint won't break until the Nth time it is reached."); | |
1266 | add_com_alias ("c", "cont", class_run, 1); | |
1267 | add_com_alias ("fg", "cont", class_run, 1); | |
1268 | ||
1269 | add_com ("run", class_run, run_command, | |
1270 | "Start debugged program. You may specify arguments to give it.\n\ | |
1271 | Args may include \"*\", or \"[...]\"; they are expanded using \"sh\".\n\ | |
1272 | Input and output redirection with \">\", \"<\", or \">>\" are also allowed.\n\n\ | |
b4fde6fa | 1273 | With no arguments, uses arguments last specified (with \"run\" or \"set args\").\n\ |
bd5635a1 RP |
1274 | To cancel previous arguments and run with no arguments,\n\ |
1275 | use \"set args\" without arguments."); | |
1276 | add_com_alias ("r", "run", class_run, 1); | |
1277 | ||
ee0613d1 JG |
1278 | add_info ("registers", nofp_registers_info, |
1279 | "List of integer registers and their contents, for selected stack frame.\n\ | |
1280 | Register name as argument means describe only that register."); | |
1281 | ||
1282 | add_info ("all-registers", all_registers_info, | |
1283 | "List of all registers and their contents, for selected stack frame.\n\ | |
bd5635a1 RP |
1284 | Register name as argument means describe only that register."); |
1285 | ||
1286 | add_info ("program", program_info, | |
1287 | "Execution status of the program."); | |
1288 | ||
1289 | add_info ("float", float_info, | |
1290 | "Print the status of the floating point unit\n"); | |
1291 | ||
1292 | inferior_args = savestring ("", 1); /* Initially no args */ | |
1293 | inferior_environ = make_environ (); | |
1294 | init_environ (inferior_environ); | |
1295 | } |