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 |
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)
|
-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. |