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