DBX mode options

The following table describes the DBX command options and parameters:

Options and Parameters

Mode

Description

-args file

DBX

Specifies arguments to send to the debuggee. The first argument represents an executable file. All arguments that follow the filename are command line arguments.

-batch

DBX

Causes the debugger to exit with status 0 after processing the initialization files and all the command files specified with `-x' (if not inhibited with `-n'). The debugger exits with a nonzero status if an error occurs in executing debugger's commands from command files.

-c file 
-
command
file

DBX

Specifies an initialization command file. The default initialization file is .dbxinit. 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

DBX

Specifies a new working directory.

-clomp launcher launcher_args

DBX

Starts a debugging session on a Cluster OpenMP* application created by launcher with the arguments launcher_args.

-core file

DBX

Specifies the core dump file.

-echo

DBX

Causes the debugger to print the prompt when running in a non-interactive session.

-gdb DBX Causes the debugger to use GDB compatibility mode and the gdb_options options set.
-gui DBX Activates the debugger's graphical user interface (GUI). The GUI does not work on Mac OS* X.
-emacs 
-
fullname
DBX Output file and line number markers for Emacs*.
-help DBX Print help message and exit.
-i file DBX Specifies a pre-initialization command file. The 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 DBX 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 DBX 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.

-interpreter mode

DBX

Select a mode interpreter interface.

-maxruntime minutes

DBX

Specifies the maximum allowable runtime in minutes for the debugging session.

-nosharedobjs DBX 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 DBX 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.

-parallelattach launcher

DBX

Attach to an existing MPI-1 job.

-p[id] pid

DBX

Specifies the process ID of the process to be debugged.

-prompt string DBX

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

DBX Mode

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

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

newPrompt>>

GDB  Mode (default)

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

DBX

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

-remote [[protocol:]address:]port

DBX

Address of a remote agent.

-tty terminal_device

DBX

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

-V

-version

DBX

Displays the banner, including the version.
executable_file

ALL

Specifies the program executable file.
core_file

ALL

Specifies the core file.