dbx Command

The dbx command starts dbx.

Native Mode Syntax

dbx options program-name [core | process-ID]

Debug program-name.

If core is specified, debug program-name with corefile core.

If process-ID is specified, debug program-name with process ID process-ID.

dbx options - {process-ID|core}

If process ID is specified, debug process ID process-ID; dbx finds the program using /proc.

If core is specified, debug with corefile core.

dbx options - core

Debug using corefile core.

dbx options –r program-name arguments

Run program-name with arguments arguments. If abnormal termination, start debugging program-name, else just exit.

where:

program-name is the name of the program to be debugged.

process-ID is the process ID of a running process.

arguments are the arguments to be passed to the program.

options are the options listed in Options.

Java Mode Syntax

dbx options program-name{.class | .jar}

Debug program-name.

dbx options program-name{.class | .jar} process-ID

Debug program-name with process ID process ID.

dbx options - process-ID

Debug process ID process ID; dbx finds the program using /proc.

dbx options { –r | –a} program-name{.class | .jar} arguments

Run program-name with arguments arguments. If abnormal termination, start debugging program-name, else, just exit.

where:

program-name is the name of the program to be debugged.

process-id is the process ID of a running process.

arguments are the arguments to be passed to the program (not to the JVM software).

options are the options listed in Options.

Options

The following table lists the options of the dbx command for both native mode and Java mode :

–a arguments Load program with program arguments arguments. –B Suppress all messages; return with exit code of program being debugged. -c commands Execute commands before prompting for input. -C Preload the Runtime Checking library (see check Command). -d Used with -s, removes file after reading. -e Echo input commands. -f Force loading of core file, even if it does not match. -h Print the usage help on dbx. -I dir Add dir to pathmap set (see pathmap Command). -k Save and restore keyboard translation state. -q Suppress messages about reading stabs. -Q Equivalent to setting dbxenv run_quick to 'on'. See help dbxenv. Overrides any values set in .dbxrc. -r Run program; if program exits normally, exit. -R Print the README file on dbx. -s file Use file instead of /current-dir/.dbxrc or $HOME/.dbxrc as the startup file -S Suppress reading of initialization file /install-dir/lib/dbxrc. -V Print the version of dbx. -w n Skip n frames on where command. -x exec32 Run the 32-bit dbx binary instead of the 64-bit dbx binary that runs by default on systems running a 64-bit OS. -- Marks the end of the option list; use this if the program name starts with a dash.