DBX mode options

The following table describes the dbx command options and parameters:

Options and Parameters

Mode

Description

-c file
-
command
file
Default Specifies an initialization command file. The default initialization file is .dbxinitidbsetup.idb. During startup, the debugger searches for this file in the current directory. If it is not there, the debugger searches your home directory. This file is processed after the target process has been loaded or attached to.
-cd dir Default Specifies a new working directory.
-echo Default Causes the debugger to print the prompt when running in a non-interactive session.
-gdb Default Causes the debugger to use GDB compatibility mode and the gdb_options options set.
-gui Default Activates the debugger's graphical user interface (GUI).
-emacs
-
fullname
Default Output file and line number markers for Emacs*.
-help Default Print help message and exit.
-i file Default Specifies a pre-initialization command file. The default pre-initialization file is .idbrc. The debugger searches for this file during startup, first in the current directory and then in your home directory. This file is processed before the debugger has connected to the application being debugged, so that commands such as set $stoponattach = 1 will have taken effect when the connection is made.
-I dir Default Specifies the directory containing the source code for the target program, in a manner similar to the use command. Use multiple -I options to specify more than one directory. The debugger searches directories in the order in which they were specified on the command line.
-interactive Default Causes the debugger to act as though stdin is isatty(), regardless of whether or not it is. This flag is sometimes useful when using rsh to run the debugger. Currently, the only effect is to cause the debugger to output the prompt to stdout when it is ready for the next line of input.
-maxruntime minutes Default Specifies the maximum allowable runtime in minutes for the debugging session.
-nosharedobjs Default Prevents the reading of symbol table information for any shared objects loaded when the process executes. Later in the debug session, you can enter the readsharedobj command to read the symbol table information for a specified object.
-parallel launcher launcher_args Default Starts a debugging session on a parallel application created by launcher with arguments launcher_args. See Debugging Parallel Applications for details on using the parallel debugging feature.
-pid pid Default Specifies the process ID of the process to be debugged.
-prompt string Default

Specifies a debugger prompt. If the prompt argument contains spaces or special characters, enclose the argument in quotes (""). You can specify a debugger prompt when you start the debugger from a shell with the -prompt option. The default debugger prompt is (idb).

% idb -prompt ">> "

>> quit

Default Mode

You can also change the prompt by setting the $prompt debugger variable. For example:

(idb) set $prompt = "newPrompt>> "

newPrompt>>

GDB Mode

Use set prompt prompt to specify a new prompt to use henceforth. To see the prompt used by the debugger, type the show prompt command.

(idb) set prompt (gdb mode)

(gdb mode) show prompt

idb's prompt is "(gdb mode) ".

(gdb mode)

Note:

There is a space at the end of the first line of the example above. If the space is missed, the result will be as follows:

(idb) set prompt (gdb mode)

(gdb mode)show prompt

idb's prompt is "(gdb mode)".

(gdb mode)

-quiet

Default

Causes the debugger to start but not to print sign-on message.

-tty terminal_device

Default

Specifies the input/output tty device for the user program.

-V
-
version
Default Displays the banner, including the version.
executable_file ALL Specifies the program executable file.
core_file ALL Specifies the core file.