DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
dbXtra and dbxtra

eXecute menu: executing the program being debugged

The eXecute menu controls the execution of your program.

Run

[dbxtra command: run arguments]
Starts execution of the program being debugged, clearing the current stack and all variables from memory. The syntax is:

run [args] [< filename] [>[>] filename]

args is always treated as a new list of arguments, replacing any that came before. If < filename is present, then it directs input from a file to the program. > filename directs output from the program to a file, while >> filename appends the output to a file.

Rerun

[dbxtra command: rerun arguments]
Restarts a program that was executed with run. Its syntax is:

rerun [args] [< filename] [>[>] filename]

If any arguments args are passed to rerun, they are appended to the arguments passed to run before being passed on to the program being restarted. If < filename is present, then it directs input from a file to the program. > filename directs output from the program to a file, while >> filename appends the output to a file.

Continue

[dbxtra command: cont [number | signal-name]]
Restarts execution of the program being debugged from where it was suspended (from the current breakpoint or event). You can optionally specify that a signal be sent to the program upon resumption of execution. If a signal is specified, the function continues as though it received the signal. Otherwise, the execution of the function is resumed as though it had not been stopped.

Skip

[dbxtra command: skip [number-of-events]]
Resumes execution and ignores a specified number of breakpoints; the target program and ignores n, a given number of breakpoints (default is 1).

Next

[dbxtra command: next [n]]
Executes one or more source lines (default is 1), then stops. More than one program statement can be in a source line. When a function call is encountered, it is treated as a single statement. Execution of the function is only stopped if there is a breakpoint set at a statement executed by the function or by any function that it calls. next does not follow function calls but stops after a function call. Use Step to follow execution into called functions.

Step

[dbxtra command: step [n]]
Executes one or more source lines (default is 1) then stops. step follows the execution into called functions. Unlike next, the step command does not treat functions as single statements. Instead, each statement in a function is treated as a separate statement.

Goto

[dbxtra command: goto line-number]
Inserts a temporary breakpoint at the selected source line, then continues execution of the program until it reaches that line. The goto command resumes execution of the program from where it was suspended until a specified line is reached. As intervening breakpoints are encountered, you may need to issue several goto commands before the specified line is reached.

Jump

[dbxtra command: jump line-number]
Continues execution of the target program at <line-number>, skipping (not executing) the intervening lines in the process. If a breakpoint is present at that point, it is ignored. The <line-number> must be in the function at the top of the call stack.

Return

[dbxtra command: return [function]]
Continues execution of the program being debugged from where it was stopped until control returns to a specified function. The source window displays the line from which the original function was called. If function is not specified, the calling function is assumed.

Instruction

Submenu provides access to single-stepping by machine instructions.


Next
[dbxtra command: nexti [n]]
Executes one or more machine instructions (default is 1), then stops. If a call to a function is encountered, the call instruction as well as all the instructions until the return statement represent one instruction.

Step
[dbxtra command: stepi [n]]
Executes one or more machine instructions (default is 1) then stops. stepi follows the execution into called functions.

Next topic: Source menu: accessing source files
Previous topic: Dbxtra

© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003