Exception Point Debugger Commands¶

epset: sets a new exception point
epclear: clears a specific exception point or all exception points
epdisable: disables a specific exception point or all exception points
epenable: enables a specific exception point or all exception points
eplist: lists exception points

Exception points halt execution and activate the debugger when a CPU raises a particular exception number.

epset¶

ep[set] <type>[,<condition>[,<action>]]

Sets a new exception point for exceptions of type <type>. The optional <condition> parameter lets you specify an expression that will be evaluated each time the exception point is hit. If the result of the expression is true (non-zero), the exception point will actually halt execution at the start of the exception handler; otherwise, execution will continue with no notification. The optional <action> parameter provides a command that is executed whenever the exception point is hit and the <condition> is true. Note that you may need to embed the action within braces { } in order to prevent commas and semicolons from being interpreted as applying to the epset command itself.

The numbering of exceptions depends upon the CPU type. Causes of exceptions may include internally or externally vectored interrupts, errors occurring within instructions and system calls.

Each exception point that is set is assigned an index which can be used in other exception point commands to reference this exception point.

Examples:

ep 2: Set an exception that will halt execution whenever the visible CPU raises exception number 2.

Back to Exception Point Debugger Commands

epclear¶

epclear [<epnum>[,…]]

The epclear command clears exception points. If <epnum> is specified, only the requested exception points are cleared, otherwise all exception points are cleared.

Examples:

epclear 3: Clear exception point index 3.
epclear: Clear all exception points.

Back to Exception Point Debugger Commands

epdisable¶

epdisable [<epnum>[,…]]

The epdisable command disables exception points. If <epnum> is specified, only the requested exception points are disabled, otherwise all exception points are disabled. Note that disabling an exception point does not delete it, it just temporarily marks the exception point as inactive.

Examples:

epdisable 3: Disable exception point index 3.
epdisable: Disable all exception points.

Back to Exception Point Debugger Commands

epenable¶

epenable [<epnum>[,…]]

The epenable command enables exception points. If <epnum> is specified, only the requested exception points are enabled, otherwise all exception points are enabled.

Examples:

epenable 3: Enable exception point index 3.
epenable: Enable all exception points.

Back to Exception Point Debugger Commands

eplist¶

eplist

The eplist command lists all the current exception points, along with their index and any conditions or actions attached to them.

Back to Exception Point Debugger Commands