Details Pane

Event List Box

Using the Event List Box, you can set where and when you want to pause program execution.

In Function Stops or pauses program execution at the beginning of the first source line in the selected procedure or function.
At Location Stops or pauses program execution at the specified line number. If the line number is not a line of executable code, program execution stops at the next line of executable code.
In Member Stops program execution in each member function of the specified name, across C<esc>++<\esc> classes.
In Class Stops program execution in all member functions belonging to the specified class.
In Object Stops program execution in all non-static functions of the object's class when called from the object.
On Modify Stops program execution when the specified address range has been modified. This field accepts any expression that can be evaluated to produce an address.
On Value Change Stops program execution if the value of the specified variable changes.
On Condition Stops program execution when an arbitrary integer expression evaluates to nonzero (\Q\Qtrue'').
On Exit Stops program execution when the process has exited, or exited with a specified value.
On Return From Stops program execution on return from the specified function.
On Signal Stops program execution when the specified signal is delivered to the process. This field accepts a decimal number or the signal name in either upper or lower case, with the SIG prefix optional.
On Exception Stops program execution when a C++ throw is executed with an expression of the specified type.
On Access Stops program execution when the specified address range is accessed by either a read or a write statement. This field accepts any expression that can be evaluated to produce an address. On Access is available only with the Solaris 2.6 and Solaris 7 operating environments.
CUSTOM Any event specifier dbx accepts. For a complete list of event specifiers, open the Dbx Commands window and type help event specification.(Equivalent to the dbx when command.)

Action List Box

In the Action list box, you can set breakpoint actions such as stopping and tracing.

Stop Stops program execution. The program cannot resume until issued another debugging command. This action is typically referred to as a breakpoint.
Trace Prints event-specific trace information in the Dbx Commands window, including function calls and returns.
CUSTOM Executes one or more debugging commands. A text field allows you to enter your own debugging commands. The program continues unless one of the commands is stop.

Option List Box

With the Option list box, you can place additional restrictions on a breakpoint or tracepoint.

NONE No options set.
If Stops program execution if the event occurs and the specified condition evaluates to nonzero.
While in Stops program execution if the event occurs within the scope of the specified function, or within any function called from the specified function.
Thread Stops program execution if the thread that caused the event matches the specified thread ID.
Count Counts up from 0. Stops program execution when the specified umber is reached.
CUSTOM Stops program execution on a customized basis. Enter any modifier dbx accepts. For a complete list of event specification modifiers, open the Dbx Commands window and type help event specification.

Buttons

Add Adds a breakpoint or tracepoint with the specified action, event, and option to the source code. In the editor window, a stop sign glyph appears to the left of the source line where the breakpoint or tracepoint appears, and the line is highlighted in red. The breakpoint or tracepoint also appears in the Breakpoints scrolling list.
Change Updates the event, action, and option of the selected breakpoint or tracepoint.
Clear Removes all entries from the Event, Action, and Option text fields.

In Function	Stops or pauses program execution at the beginning of the first source line in the selected procedure or function.
At Location	Stops or pauses program execution at the specified line number. If the line number is not a line of executable code, program execution stops at the next line of executable code.
In Member	Stops program execution in each member function of the specified name, across C<esc>++<\esc> classes.
In Class	Stops program execution in all member functions belonging to the specified class.
In Object	Stops program execution in all non-static functions of the object's class when called from the object.
On Modify	Stops program execution when the specified address range has been modified. This field accepts any expression that can be evaluated to produce an address.
On Value Change	Stops program execution if the value of the specified variable changes.
On Condition	Stops program execution when an arbitrary integer expression evaluates to nonzero (\Q\Qtrue'').
On Exit	Stops program execution when the process has exited, or exited with a specified value.
On Return From	Stops program execution on return from the specified function.
On Signal	Stops program execution when the specified signal is delivered to the process. This field accepts a decimal number or the signal name in either upper or lower case, with the SIG prefix optional.
On Exception	Stops program execution when a C++ `throw` is executed with an expression of the specified type.
On Access	Stops program execution when the specified address range is accessed by either a read or a write statement. This field accepts any expression that can be evaluated to produce an address. On Access is available only with the Solaris 2.6 and Solaris 7 operating environments.
CUSTOM	Any event specifier `dbx` accepts. For a complete list of event specifiers, open the Dbx Commands window and type `help event specification`.(Equivalent to the `dbx when` command.)

Stop	Stops program execution. The program cannot resume until issued another debugging command. This action is typically referred to as a breakpoint.
Trace	Prints event-specific trace information in the Dbx Commands window, including function calls and returns.
CUSTOM	Executes one or more debugging commands. A text field allows you to enter your own debugging commands. The program continues unless one of the commands is `stop`.

NONE	No options set.
If	Stops program execution if the event occurs and the specified condition evaluates to nonzero.
While in	Stops program execution if the event occurs within the scope of the specified function, or within any function called from the specified function.
Thread	Stops program execution if the thread that caused the event matches the specified thread ID.
Count	Counts up from 0. Stops program execution when the specified umber is reached.
CUSTOM	Stops program execution on a customized basis. Enter any modifier `dbx` accepts. For a complete list of event specification modifiers, open the Dbx Commands window and type `help event specification`.

Add	Adds a breakpoint or tracepoint with the specified action, event, and option to the source code. In the editor window, a stop sign glyph appears to the left of the source line where the breakpoint or tracepoint appears, and the line is highlighted in red. The breakpoint or tracepoint also appears in the Breakpoints scrolling list.
Change	Updates the event, action, and option of the selected breakpoint or tracepoint.
Clear	Removes all entries from the Event, Action, and Option text fields.